@sema-agent/sdk 0.1.8 → 0.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/events.d.ts CHANGED
@@ -7,14 +7,16 @@
7
7
  * - live token stream `POST /v1/tasks/stream`: per-token `text_delta`/`reasoning_delta` (delta = the string
8
8
  * fragment, core-native) + tool_start, tool_end, turn_end, compacted, status, workspace_changed, done.
9
9
  * - durable resumable stream `GET /v1/runs/:id/events`: turn-AGGREGATED `text`/`reasoning` (no deltas) +
10
- * tool_start, tool_end, turn_end, compacted, suspended, done, failed.
10
+ * tool_start, tool_end, turn_end, compacted, status (server ≥1.317; `brain_status` on older durable rows —
11
+ * see the `status`/`brain_status` arms below), suspended, done, failed.
11
12
  *
12
13
  * design/99 §E1/§E2/§E3/§E10/§E13 (core 1.121.0+, service) — three additive enrichments now ride
13
14
  * the wire and are bound here (all verified against core `TaskEvent` types.ts:1027-1108 + the service projections):
14
15
  * - §E1: `tool_end` carries the model-facing `output` (+ `truncated`) — the action-card BODY.
15
16
  * - §E2: every CONTENT event carries `eventId` (+ `parentToolCallId` for sub-agent attribution) — the
16
17
  * dedup/resume anchor. NOT on the lifecycle arms (turn_end/compacted/suspended/done/failed), matching core.
17
- * - §E3/§E10: a `status` arm (BrainStatus — rate-limit/retry/reconnect liveness, LIVE-only, never persisted).
18
+ * - §E3/§E10: a `status` arm (BrainStatus — rate-limit/retry/reconnect liveness). Persisted on BOTH legs
19
+ * (design/158 B2 corrected the earlier "LIVE-only, never persisted" claim here — see the arm's own doc).
18
20
  * - §E13: a `workspace_changed` arm (a `cd` moved the tracked cwd — LIVE-only, for the shell's path display).
19
21
  */
20
22
  import type { TaskResult, CheckpointGate, ModelUsageDelta } from "./types.js";
@@ -153,10 +155,18 @@ export type AgentEvent =
153
155
  type: "suggestions";
154
156
  suggestions: string[];
155
157
  }
156
- /** design/99 §E3/§E10 (LIVE-only) — a brain-layer liveness status the brain would otherwise absorb silently
157
- * (a 429 rate-limit / a 5xx-or-network retry / a reconnect / an open circuit breaker). EPHEMERAL: a pure
158
- * liveness signal, never persisted or replayed on resume; provider-neutral (no HTTP status/stop_reason). Lets
159
- * a UI show "rate limited, retrying in Ns". core `BrainStatus` types.ts:1001-1007 + the `status` arm :1081-1093. */
158
+ /** design/99 §E3/§E10 — a brain-layer liveness status the brain would otherwise absorb silently (a 429
159
+ * rate-limit / a 5xx-or-network retry / a reconnect / an open circuit breaker), provider-neutral (no HTTP
160
+ * status/stop_reason). Lets a UI show "rate limited, retrying in Ns". core `BrainStatus` types.ts:1001-1007 +
161
+ * the `status` arm :1081-1093.
162
+ *
163
+ * 🔴 WIRE NOTE (design/158 B2, corrects the prior "never persisted or replayed on resume" claim on this arm):
164
+ * the durable/replay leg (`GET /v1/runs/:id/events`) DOES persist this observation — it is the service's own
165
+ * liveness record, not a core event replay. Server ≥1.317 uses the SAME frame name on both legs (this arm),
166
+ * and its read boundary also normalizes PRE-upgrade durable rows (written under the literal `"brain_status"`)
167
+ * to `"status"` on replay — stored bytes are untouched (no migration), but a ≥1.317 server never DELIVERS the
168
+ * old literal. The old literal still reaches a consumer talking to a server <1.317 (see the deprecated
169
+ * `brain_status` arm below); during that compat window, treat both literals as the same logical frame. */
160
170
  | ({
161
171
  type: "status";
162
172
  phase: BrainStatusPhase | (string & {});
@@ -165,6 +175,19 @@ export type AgentEvent =
165
175
  /** Seconds until the brain's next retry attempt (from the honored backoff / Retry-After), when known. */
166
176
  retryInSec?: number;
167
177
  } & EventIdentity)
178
+ /** @deprecated design/158 B2 — historical durable-leg alias for the arm above. Server <1.317 wrote (and on
179
+ * replay delivers) the brain-layer liveness-observation row under the literal type `"brain_status"` instead of
180
+ * `"status"` (same field shape — see the `status` arm's doc for the full semantics). Server ≥1.317 never
181
+ * writes this literal AND normalizes pre-upgrade rows to `"status"` at the read boundary, so this literal only
182
+ * ever reaches a consumer whose server is <1.317 — kept in the union so that consumer can still type-check
183
+ * the frame without an `as any` escape hatch. Never emitted on the live leg (`POST /v1/tasks/stream`) at any
184
+ * server version. */
185
+ | ({
186
+ type: "brain_status";
187
+ phase: BrainStatusPhase | (string & {});
188
+ detail?: string;
189
+ retryInSec?: number;
190
+ } & EventIdentity)
168
191
  /** design/99 MF-10 (core 1.147+, `task_progress` arm types.ts:1104-1118) — a SUBAGENT PROGRESS TICK: a delegated
169
192
  * sub-run's usage ACCRUING over time, emitted at each turn boundary WHILE it runs, so a parent UI animates the
170
193
  * Task card's rollup (tokens / tool-uses climbing). Emitted ONLY for a subagent (a task carrying a
@@ -1 +1 @@
1
- {"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AA+RA;;;;8GAI8G;AAC9G,MAAM,UAAU,WAAW,CAAC,CAAQ;IAClC,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAChE,CAAC"}
1
+ {"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAsTA;;;;8GAI8G;AAC9G,MAAM,UAAU,WAAW,CAAC,CAAQ;IAClC,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAChE,CAAC"}
package/openapi.yaml CHANGED
@@ -5700,6 +5700,8 @@ components:
5700
5700
  - $ref: '#/components/schemas/Event_steering_injected'
5701
5701
  - $ref: '#/components/schemas/Event_done'
5702
5702
  - $ref: '#/components/schemas/Event_failed'
5703
+ # design/158 B2: deprecated durable-leg alias — see Event_brain_status's own description.
5704
+ - $ref: '#/components/schemas/Event_brain_status'
5703
5705
  discriminator:
5704
5706
  propertyName: type
5705
5707
  mapping:
@@ -5725,6 +5727,7 @@ components:
5725
5727
  steering_injected: '#/components/schemas/Event_steering_injected'
5726
5728
  done: '#/components/schemas/Event_done'
5727
5729
  failed: '#/components/schemas/Event_failed'
5730
+ brain_status: '#/components/schemas/Event_brain_status'
5728
5731
 
5729
5732
  # design/99 §E2 (SHIPPED, core TaskEventIdentity) — additive per-event identity on every CONTENT event (NOT on
5730
5733
  # the lifecycle arms turn_end/compacted/suspended/done/failed). eventId = uuidv7 dedup/resume handle (the durable
@@ -5839,10 +5842,16 @@ components:
5839
5842
  Event_status:
5840
5843
  type: object
5841
5844
  description: >
5842
- design/99 §E3/§E10 (SHIPPED, LIVE-only) — a brain-layer liveness status the brain would otherwise absorb
5843
- silently (429 rate-limit / 5xx-or-network retry / reconnect / open circuit breaker). EPHEMERAL — never
5844
- persisted/replayed on resume; provider-neutral (NO HTTP status / stop_reason). `phase` is core's closed
5845
- BrainStatusPhase but render open (a deployment may add a phase on its own channel).
5845
+ design/99 §E3/§E10 (SHIPPED) — a brain-layer liveness status the brain would otherwise absorb silently
5846
+ (429 rate-limit / 5xx-or-network retry / reconnect / open circuit breaker). Provider-neutral (NO HTTP
5847
+ status / stop_reason). `phase` is core's closed BrainStatusPhase but render open (a deployment may add a
5848
+ phase on its own channel). 🔴 WIRE NOTE (design/158 B2, corrects the prior "EPHEMERAL — never
5849
+ persisted/replayed on resume" claim): the durable/replay leg (GET /v1/runs/:id/events) DOES persist this
5850
+ as its own liveness observation row. Server >=1.317 uses this SAME arm name on both legs AND normalizes
5851
+ pre-upgrade rows (stored under the literal `brain_status`) to `status` at the read boundary — stored
5852
+ bytes untouched, but a >=1.317 server never delivers the old literal; it only reaches consumers of a
5853
+ server <1.317 (see Event_brain_status below — same shape, deprecated alias, additive-only, never emitted
5854
+ on the live leg at any version).
5846
5855
  allOf: [{ $ref: '#/components/schemas/EventIdentity' }]
5847
5856
  required: [type, phase]
5848
5857
  properties:
@@ -5850,6 +5859,23 @@ components:
5850
5859
  phase: { type: string, description: "rate_limited | retrying | reconnecting | circuit_open (open set)" }
5851
5860
  detail: { type: string, description: "neutral human hint (NO provider/HTTP detail)" }
5852
5861
  retryInSec: { type: number }
5862
+ Event_brain_status:
5863
+ type: object
5864
+ deprecated: true
5865
+ description: >
5866
+ design/158 B2 — DEPRECATED historical durable-leg alias for Event_status (same field shape). Server
5867
+ <1.317 wrote (and on replay delivers) the liveness-observation row under the literal type `brain_status`
5868
+ instead of `status`. Server >=1.317 never writes this literal AND normalizes pre-upgrade rows to `status`
5869
+ at the read boundary, so this literal only ever reaches a consumer whose server is <1.317 — kept in the
5870
+ spec/SDK union only so that consumer can still type-check the frame. Never emitted on the live leg
5871
+ (POST /v1/tasks/stream) at any server version.
5872
+ allOf: [{ $ref: '#/components/schemas/EventIdentity' }]
5873
+ required: [type, phase]
5874
+ properties:
5875
+ type: { const: brain_status }
5876
+ phase: { type: string, description: "rate_limited | retrying | reconnecting | circuit_open (open set)" }
5877
+ detail: { type: string, description: "neutral human hint (NO provider/HTTP detail)" }
5878
+ retryInSec: { type: number }
5853
5879
  Event_task_progress:
5854
5880
  type: object
5855
5881
  description: >
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sema-agent/sdk",
3
- "version": "0.1.8",
3
+ "version": "0.1.9",
4
4
  "description": "Typed, zero-runtime-dependency SDK for the Sema agent fleet usage plane. The shared substrate for all doors (CC/Codex MCP façade + web). Server-side only — tokens never enter the browser.",
5
5
  "type": "module",
6
6
  "license": "BUSL-1.1",