Skip to content

notification: document pull over SSE#34

Merged
acoshift merged 1 commit into
mainfrom
notification-sse
Jun 20, 2026
Merged

notification: document pull over SSE#34
acoshift merged 1 commit into
mainfrom
notification-sse

Conversation

@acoshift

Copy link
Copy Markdown
Member

Summary

Documents the new Server-Sent Events transport for pull notification channels (apiserver#167 / api#93 / deploys#32), in the existing Pull (agent subscription) section of automation/notification-channels:

  • A new Live streaming (SSE) paragraph: --follow opens an SSE stream and the server pushes each change live, one event per line; --output selects the line format (json → NDJSON for agents, yaml, or the tab-separated default); the stream auto-reconnects and resumes; --poll falls back to RPC polling.
  • The raw GET /notification/pull/sse?project=…&name=… endpoint for non-CLI consumers, including auth (a Bearer token, ideally a scoped me.generateToken limited to notification.pull) and the ack model (the change event's SSE id, echoed back via the ack query param or the Last-Event-ID header).
  • Tidies the example commands (one-shot vs --follow).

hugo --gc --minify builds clean.

Rollout

PR 4 of 4 (final). Follows apiserver#167 → api#93 → deploys#32.

🤖 Generated with Claude Code

Document the new --follow-over-SSE streaming for pull channels: live push with
per-line output (NDJSON via -ojson, YAML, or a tab-separated default),
auto-reconnect/resume, and the -poll fallback. Also document the raw
GET /notification/pull/sse endpoint and its ack token (the change event's SSE id,
echoed back via the ack query param or Last-Event-ID) for non-CLI consumers.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011d4bVuGLnCbcJD9ZvastPH
@deploys-app deploys-app Bot temporarily deployed to pr-34 June 20, 2026 10:48 Destroyed
@deploys-app

deploys-app Bot commented Jun 20, 2026

Copy link
Copy Markdown

Preview deleted (PR closed).

@acoshift acoshift merged commit 3d8285b into main Jun 20, 2026
1 check passed
@acoshift acoshift deleted the notification-sse branch June 20, 2026 11:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant