@openwop/openwop 1.8.0 → 2.0.0

package/dist/index.js

@@ -1,65 +1,38 @@
 /**
- * @openwop/openwop — TypeScript reference SDK for OpenWOP-compliant servers.
+ * @openwop/openwop 2.x — TypeScript reference SDK for OpenWOP v2 hosts.
  *
  * Public surface:
- *   - OpenwopClient (auth + endpoint methods)
- *   - WopError (typed error wrapping ErrorEnvelope)
- *   - All request/response types mirroring the OpenAPI spec
- *   - streamEvents helper for advanced SSE use cases
+ *   - OpenwopClient (auth + one method per `spec/v2/path-manifest.json` operation)
+ *   - WopError (typed error wrapping the v2 ErrorEnvelope)
+ *   - Generated ERROR_CODES / ErrorCode + capability-key unions (`generated.ts`)
+ *   - All request/response types mirroring `api/v2/openapi.yaml` + `schemas/v2/`
+ *   - streamEvents / streamHostEvents SSE helpers
  *
  * See README.md for usage examples.
  */
-export { OpenwopClient } from './client.js';
+export { OpenwopClient, SDK_PROTOCOL_MAJOR, protocolVersionHeader } from './client.js';
 export { WopError } from './types.js';
-export { streamEvents } from './sse.js';
-// RFC 0002 + RFC 0024 typed event helpers — type guards over `RunEventDoc`
-// plus a high-level streaming-reasoning subscription helper.
+export { streamEvents, streamHostEvents } from './sse.js';
+// Generated from spec/v2/errors.json + schemas/v2/capabilities.schema.json.
+export { ERROR_CODES, ERROR_CODE_HTTP_STATUS, RETRIABLE_ERROR_CODES, VENDOR_ERROR_CODE_PATTERN, CAPABILITY_FAMILY_KEYS, CAPABILITY_METADATA_KEYS, } from './generated.js';
+// Typed event helpers — type guards over `RunEventDoc` plus a high-level
+// streaming-reasoning subscription helper.
 export { isAgentReasoned, isAgentReasoningDelta, isAgentToolCalled, isAgentToolReturned, isAgentHandoff, isAgentDecided, isMemoryWritten, isOutputChunk, isVoiceSpeechStart, isVoiceTranscript, isVoiceEndpointCandidate, isVoiceTurnCommit, isVoiceSynthesisChunk, isVoiceBargeIn, isVoiceCancelled, isChannelPresence, isDispatchFanOut, isDispatchJoin, isContextSummarized, subscribeToAgentReasoning, } from './event-helpers.js';
-// Run-status + run-error helpers (added in 1). Forward-compat predicates
-// over the wire-format unions declared above; full design + rationale in
-// `run-helpers.ts`.
-export { ACTIVE_RUN_STATUSES, TERMINAL_RUN_STATUSES, isTerminalRunStatus, HTTP_ERROR_CODES, isHttpErrorCode, RUN_ERROR_CODES, isRunErrorCode, } from './run-helpers.js';
-// Cost-attribution allowlist + sanitizer helpers
-// (`spec/v1/observability.md §"Cost attribution attributes"`). Single
-// source of truth for the canonical attribute names so independent
-// hosts share one list instead of each re-deriving it.
+// Run-status + error-code helpers. `HTTP_ERROR_CODES` is the generated
+// registry; `isErrorCode` narrows to it, `isRetriableErrorCode` to the
+// `retriable: true` rows.
+export { ACTIVE_RUN_STATUSES, TERMINAL_RUN_STATUSES, isTerminalRunStatus, HTTP_ERROR_CODES, isHttpErrorCode, isErrorCode, isRetriableErrorCode, isVendorErrorCode, RUN_ERROR_CODES, isRunErrorCode, } from './run-helpers.js';
+// Cost-attribution allowlist + sanitizer helpers.
 export { OPENWOP_COST_ATTRIBUTE_NAMES, sanitizeCostAttributes, } from './cost-attribution.js';
-// Webhook-delivery verification helpers (SDK-3 close-out 2026-05-15).
-// HMAC-SHA256 + timestamp freshness window verification per
-// spec/v1/webhooks.md §"Signature recipe". Receivers MUST verify both
-// the HMAC AND the timestamp to defeat replay attacks.
-//
-// DEPRECATED ON THE BARREL (openwop-sdks#30). These re-exports are why a
-// browser consumer importing anything at all from `@openwop/openwop` dragged
-// in `node:crypto` and failed the build. Import them from
-// `@openwop/openwop/webhooks` instead; the barrel re-export is retained for
-// compatibility and will be removed in the next major.
-//
-// Until then the `browser` field in package.json substitutes a stub that
-// throws with an explanatory message, so a browser build succeeds and only a
-// browser CALL fails — which is the correct outcome either way, since the
-// subscription secret must never reach a browser.
-/** @deprecated Import from `@openwop/openwop/webhooks` — server-only; removed from the barrel in the next major. */
-export { DEFAULT_WEBHOOK_FRESHNESS_WINDOW_SECONDS, verifyWebhookSignature, signWebhookDelivery, } from './webhook-helpers.js';
-// Public-registry read helpers (SDK-5 close-out 2026-05-15). Read-only
-// typed client for the public node-pack registry at packs.openwop.dev
-// per spec/v1/registry-operations.md.
-export { RegistryClient } from './registry-helpers.js';
-// RFC 0030 §A `reasoning` field prompt-directive helper. Hosts that
-// advertise `capabilities.envelopes.reasoning.supported: true` use this
-// to synthesize the system-prompt fragment that instructs the model to
-// populate the OPTIONAL `reasoning` field. See `envelope-directive.ts`
-// for the operational note on `"mandatory"` strength (provider-side
-// refusal risk per the 2026-05-21 RFC 0030 amendment).
+// Webhook verification is server-only (`node:crypto`) and lives on the
+// `@openwop/openwop/webhooks` subpath — it is no longer re-exported from the
+// barrel (the 1.x deprecation, removed in this major). The browser-safe
+// header-family readers stay here.
+export { WEBHOOK_HEADER_FAMILIES, WEBHOOK_SIGNATURE_ALGORITHMS, parseSignatureValue, readWebhookHeaders, } from './webhook-header-families.js';
+// RFC 0030 §A `reasoning` field prompt-directive helper.
 export { buildReasoningDirective } from './envelope-directive.js';
-// RFC 0032 §B.3 + RFC 0033 §D refusal detection helper. Normalizes
-// per-provider safety-stop signals (Anthropic `stop_reason: "refusal"`,
-// OpenAI `message.refusal` + `finish_reason: "content_filter"`, Gemini
-// `finishReason: "SAFETY"` + `promptFeedback.blockReason: "SAFETY"`)
-// to a canonical `{ refusalText, safetyCategory?, provider }` shape.
-// Hosts route the non-null return through `envelope.refusal` emission
-// + the `envelope_refusal` terminal error code (RFC 0033 §F).
-// **SECURITY:** Pass `refusalText` through the BYOK redaction harness
-// BEFORE persistence — this helper does NOT redact.
+// RFC 0032 §B.3 + RFC 0033 §D refusal detection helper. **SECURITY:** pass
+// `refusalText` through the BYOK redaction harness BEFORE persistence — this
+// helper does NOT redact.
 export { parseRefusal } from './parse-refusal.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA8GtC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,2EAA2E;AAC3E,6DAA6D;AAC7D,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAM5B,yEAAyE;AACzE,yEAAyE;AACzE,oBAAoB;AACpB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,kBAAkB,CAAC;AAS1B,iDAAiD;AACjD,sEAAsE;AACtE,mEAAmE;AACnE,uDAAuD;AACvD,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,sEAAsE;AACtE,4DAA4D;AAC5D,sEAAsE;AACtE,uDAAuD;AACvD,EAAE;AACF,yEAAyE;AACzE,6EAA6E;AAC7E,0DAA0D;AAC1D,4EAA4E;AAC5E,uDAAuD;AACvD,EAAE;AACF,yEAAyE;AACzE,6EAA6E;AAC7E,0EAA0E;AAC1E,kDAAkD;AAClD,oHAAoH;AACpH,OAAO,EACL,wCAAwC,EACxC,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAM9B,uEAAuE;AACvE,sEAAsE;AACtE,sCAAsC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA0CvD,oEAAoE;AACpE,wEAAwE;AACxE,uEAAuE;AACvE,uEAAuE;AACvE,oEAAoE;AACpE,uDAAuD;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,mEAAmE;AACnE,wEAAwE;AACxE,uEAAuE;AACvE,qEAAqE;AACrE,qEAAqE;AACrE,sEAAsE;AACtE,8DAA8D;AAC9D,sEAAsE;AACtE,oDAAoD;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEvF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA8GtC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG1D,4EAA4E;AAC5E,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAGxB,yEAAyE;AACzE,2CAA2C;AAC3C,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAM5B,uEAAuE;AACvE,uEAAuE;AACvE,0BAA0B;AAC1B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,cAAc,GACf,MAAM,kBAAkB,CAAC;AAS1B,kDAAkD;AAClD,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,uEAAuE;AACvE,6EAA6E;AAC7E,wEAAwE;AACxE,mCAAmC;AACnC,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAkCtC,yDAAyD;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,2EAA2E;AAC3E,6EAA6E;AAC7E,0BAA0B;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/run-helpers.d.ts

@@ -4,7 +4,7 @@
  * declared in `types.ts`.
  *
  * **Why these live here.** `types.ts` declares the canonical wire shapes
- * (mirroring `api/openapi.yaml` + `schemas/run-snapshot.schema.json`).
+ * (mirroring `api/v2/openapi.yaml` + `schemas/v2/run-snapshot.schema.json`).
  * This module adds the constants + predicates SDK consumers need to act
  * on those shapes without redefining them locally. Pulling them into the
  * SDK makes the protocol vocabulary single-sourced for application,
@@ -27,7 +27,8 @@
  *
  * @module @openwop/openwop/run-helpers
  */
-import type { RunStatus } from './types.js';
+import type { RunStatus, VendorErrorCode } from './types.js';
+import { RETRIABLE_ERROR_CODES, type ErrorCode } from './generated.js';
 /**
  * Run statuses considered active — the run MAY still transition. A reader
  * who does not recognize a status string MUST treat it as terminal-unknown
@@ -59,22 +60,21 @@ export type TerminalRunStatus = (typeof TERMINAL_RUN_STATUSES)[number];
  */
 export declare function isTerminalRunStatus(status: RunStatus | string): boolean;
 /**
- * Canonical REST/MCP error-envelope codes from `auth.md`,
- * `rest-endpoints.md`, and adjacent v1 specs. The HTTP envelope's `error`
- * field remains string-typed for forward compatibility, but this list
- * gives SDK consumers a stable set for common branching.
- *
- * Codes here describe request/transport failures. Run execution failures
- * live in `RUN_ERROR_CODES` below as `RunSnapshot.error.code`.
- */
-export declare const HTTP_ERROR_CODES: readonly ["unauthenticated", "forbidden", "key_expired", "key_revoked", "validation_error", "not_found", "rate_limited", "run_already_active", "idempotency_in_flight", "idempotency_key_mismatch", "unsupported_stream_mode", "force_engine_version_forbidden", "mock_provider_forbidden", "capability_not_provided", "capability_required", "credential_required", "credential_forbidden", "credential_unavailable", "pack_integrity_mismatch", "pack_signature_invalid", "pack_peer_dependency_missing", "pack_lockfile_incomplete", "pack_version_not_found", "interrupt_not_found", "approval_token_invalid", "approval_token_expired", "approval_token_consumed", "provider_policy_denied", "mcp_server_not_configured", "mcp_timeout", "mcp_network_error", "mcp_server_error", "mcp_protocol_error", "mcp_tool_error", "http_url_rejected", "http_timeout", "http_network_error", "http_unexpected_status", "webhook_url_rejected", "subscription_not_found", "internal_error"];
-export type HttpErrorCode = (typeof HTTP_ERROR_CODES)[number];
-/**
- * Type guard that narrows a string to a known canonical HTTP error code.
- * Returns false for host extensions and future spec additions; callers
- * should still render a fallback from the envelope's `message`.
+ * The v2 error registry (`spec/v2/errors.json`, errors.md): every code a v2
+ * host may return in `ErrorEnvelope.error`, generated into `generated.ts`.
+ * Kept under the 1.x name for call-site parity; `ERROR_CODES` is the same
+ * array.
  */
-export declare function isHttpErrorCode(value: unknown): value is HttpErrorCode;
+export declare const HTTP_ERROR_CODES: readonly ["audience_mismatch", "capability_not_provided", "capability_required", "client_version_unsupported", "connection_provider_conflict", "connection_provider_unresolved", "connector_action_unresolved", "connector_auth_expired", "credential_forbidden", "credential_not_found", "credential_required", "credential_revoked", "credential_scope_unsupported", "credential_unavailable", "delegation_chain_cyclic", "delegation_chain_too_long", "delegation_expired", "delegation_scope_amplified", "envelope_correlation_conflict", "envelope_invalid", "envelope_refusal", "envelope_truncation_unrecoverable", "event_type_unmapped", "forbidden", "force_engine_version_forbidden", "fork_point_invalid", "id_tenant_mismatch", "idempotency_in_flight", "idempotency_key_invalid", "idempotency_key_mismatch", "identity_unresolvable", "identity_unverified", "internal_error", "interop_version_unsupported", "interrupt_already_resolved", "interrupt_cancelled", "interrupt_expired", "interrupt_not_found", "interrupt_token_invalid", "key_revoked", "loop_limit_exceeded", "mcp_mrtr_rounds_exceeded", "mock_provider_forbidden", "not_found", "oauth_provider_unsupported", "oauth_scope_unsupported", "pack_dependency_conflict", "pack_dependency_cycle", "pack_engine_unsupported", "pack_integrity_failure", "pack_integrity_mismatch", "pack_kind_invalid", "pack_load_failure", "pack_lockfile_incomplete", "pack_namespace_unauthorized", "pack_peer_dependency_missing", "pack_peer_dependency_undefined", "pack_registry_unreachable", "pack_runtime_requirement_unmet", "pack_signature_invalid", "pack_validation_failed", "pack_version_not_found", "payload_too_large", "protocol_version_mismatch", "protocol_version_unsupported", "rate_limited", "recursion_limit_exceeded", "replay_diverged_at_refusal", "replay_memory_snapshot_unavailable", "replay_source_missing", "residency_unavailable", "run_already_active", "run_forbidden", "run_state_conflict", "run_terminal", "run_timeout", "runner_unavailable", "sandbox_capability_denied", "sandbox_escape_attempt", "sandbox_memory_exceeded", "sandbox_timeout", "schedule_horizon_exceeded", "sender_constraint_missing", "signature_not_available", "sub_chain_cycle", "sub_chain_depth_exceeded", "token_budget_exceeded", "unauthenticated", "unsupported_media_type", "unsupported_stream_mode", "until_in_past", "validation_error", "version_conflict", "webhook_url_rejected", "workspace_conflict", "workspace_membership_required", "workspace_too_large"];
+export type HttpErrorCode = ErrorCode;
+/** Type guard that narrows a string to a registered protocol {@link ErrorCode}. */
+export declare function isErrorCode(value: unknown): value is ErrorCode;
+/** 1.x name for {@link isErrorCode}. */
+export declare const isHttpErrorCode: typeof isErrorCode;
+/** True for the registry rows marked `retriable: true`; retry timing lives in `Retry-After` only (RFC 0171 §B.2). */
+export declare function isRetriableErrorCode(value: unknown): value is (typeof RETRIABLE_ERROR_CODES)[number];
+/** True for a well-formed vendor code (`<org>.<name>`, `openwop.` reserved); does not check org registration. */
+export declare function isVendorErrorCode(value: unknown): value is VendorErrorCode;
 /**
  * Run-document error codes — stable identifiers used in
  * `RunSnapshot.error.code` when a run reaches `failed`. These are distinct
@@ -92,7 +92,7 @@ export declare function isHttpErrorCode(value: unknown): value is HttpErrorCode;
  * unrecognized values. Until that lands, drift between this list + the
  * engine's actual emission set is detectable only by manual review.
  */
-export declare const RUN_ERROR_CODES: readonly ["auth_required", "forbidden", "workspace_not_found", "run_already_active", "run_not_found", "run_terminal", "engine_version_mismatch", "invalid_workflow_definition", "invalid_trigger_input", "node_type_not_found", "config_validation_failed", "token_budget_exceeded", "concurrent_run_limit_reached", "rate_limited", "node_timeout", "global_timeout", "node_execution_failed", "external_call_failed", "recursion_limit_exceeded", "capability_not_provided", "approval_timeout", "approval_token_invalid", "approval_token_expired", "approval_token_consumed", "persistence_failed", "doc_budget_exceeded"];
+export declare const RUN_ERROR_CODES: readonly ["auth_required", "forbidden", "workspace_not_found", "run_already_active", "run_not_found", "run_terminal", "engine_version_mismatch", "invalid_workflow_definition", "invalid_trigger_input", "node_type_not_found", "config_validation_failed", "token_budget_exceeded", "concurrent_run_limit_reached", "rate_limited", "node_timeout", "global_timeout", "node_execution_failed", "external_call_failed", "recursion_limit_exceeded", "run_timeout", "loop_limit_exceeded", "envelope_refusal", "capability_not_provided", "approval_timeout", "approval_token_invalid", "approval_token_expired", "approval_token_consumed", "persistence_failed", "doc_budget_exceeded"];
 export type RunErrorCode = (typeof RUN_ERROR_CODES)[number];
 /**
  * Type guard that narrows a string to a known {@link RunErrorCode}.
@@ -108,9 +108,8 @@ export declare function isRunErrorCode(value: unknown): value is RunErrorCode;
  *   - `RunError` lives on the run document; describes WHY the run failed.
  *     `code` is from the typed {@link RunErrorCode} vocabulary.
  *   - `ErrorEnvelope` lives on HTTP error responses; describes WHY the
- *     request failed. `error` is a free string code (often from
- *     {@link HTTP_ERROR_CODES}, but not type-pinned, to permit host
- *     extensions and future protocol additions).
+ *     request failed. `error` is a registered {@link ErrorCode} or a vendor
+ *     code (`<org>.<name>`).
  *
  * The shapes share `message` and `details` but diverge on the code field
  * name (`code` vs `error`) by design — they represent different layers.

package/dist/run-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-helpers.d.ts","sourceRoot":"","sources":["../src/run-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,kHAUtB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,+CAIxB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AACnE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAEvE;AAID;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,y7BAmEnB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,gmBAwClB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}
+{"version":3,"file":"run-helpers.d.ts","sourceRoot":"","sources":["../src/run-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAe,qBAAqB,EAA6B,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAI/G;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,kHAUtB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,+CAIxB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AACnE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAEvE;AAID;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,s6EAAc,CAAC;AAE5C,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC;AAEtC,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED,wCAAwC;AACxC,eAAO,MAAM,eAAe,oBAAc,CAAC;AAE3C,qHAAqH;AACrH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAEpG;AAED,iHAAiH;AACjH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,0pBA2ClB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/dist/run-helpers.js

@@ -4,7 +4,7 @@
  * declared in `types.ts`.
  *
  * **Why these live here.** `types.ts` declares the canonical wire shapes
- * (mirroring `api/openapi.yaml` + `schemas/run-snapshot.schema.json`).
+ * (mirroring `api/v2/openapi.yaml` + `schemas/v2/run-snapshot.schema.json`).
  * This module adds the constants + predicates SDK consumers need to act
  * on those shapes without redefining them locally. Pulling them into the
  * SDK makes the protocol vocabulary single-sourced for application,
@@ -27,6 +27,7 @@
  *
  * @module @openwop/openwop/run-helpers
  */
+import { ERROR_CODES, RETRIABLE_ERROR_CODES, VENDOR_ERROR_CODE_PATTERN } from './generated.js';
 // ─── Run statuses ────────────────────────────────────────────────────────
 /**
  * Run statuses considered active — the run MAY still transition. A reader
@@ -74,78 +75,25 @@ export function isTerminalRunStatus(status) {
 }
 // ─── HTTP error-envelope codes ───────────────────────────────────────────
 /**
- * Canonical REST/MCP error-envelope codes from `auth.md`,
- * `rest-endpoints.md`, and adjacent v1 specs. The HTTP envelope's `error`
- * field remains string-typed for forward compatibility, but this list
- * gives SDK consumers a stable set for common branching.
- *
- * Codes here describe request/transport failures. Run execution failures
- * live in `RUN_ERROR_CODES` below as `RunSnapshot.error.code`.
+ * The v2 error registry (`spec/v2/errors.json`, errors.md): every code a v2
+ * host may return in `ErrorEnvelope.error`, generated into `generated.ts`.
+ * Kept under the 1.x name for call-site parity; `ERROR_CODES` is the same
+ * array.
  */
-export const HTTP_ERROR_CODES = [
-    // Auth / access
-    'unauthenticated',
-    'forbidden',
-    'key_expired',
-    'key_revoked',
-    // Request / routing
-    'validation_error',
-    'not_found',
-    'rate_limited',
-    // Idempotency / run creation conflicts
-    'run_already_active',
-    'idempotency_in_flight',
-    'idempotency_key_mismatch',
-    // Streaming / protocol negotiation
-    'unsupported_stream_mode',
-    'force_engine_version_forbidden',
-    'mock_provider_forbidden',
-    // Capability / credential negotiation
-    'capability_not_provided',
-    'capability_required',
-    'credential_required',
-    'credential_forbidden',
-    'credential_unavailable',
-    // Node-pack lifecycle (registry + lockfile) per node-packs.md §"Dependency resolution + lockfile"
-    'pack_integrity_mismatch',
-    'pack_signature_invalid',
-    'pack_peer_dependency_missing',
-    'pack_lockfile_incomplete',
-    'pack_version_not_found',
-    // HITL / interrupt callbacks
-    'interrupt_not_found',
-    'approval_token_invalid',
-    'approval_token_expired',
-    'approval_token_consumed',
-    // Phase H.1″ — AI provider policy enforcement per
-    // capabilities.md §"aiProviders.policies".
-    'provider_policy_denied',
-    // Phase H.2 — MCP client error codes.
-    'mcp_server_not_configured',
-    'mcp_timeout',
-    'mcp_network_error',
-    'mcp_server_error',
-    'mcp_protocol_error',
-    'mcp_tool_error',
-    // Phase H.3 — HTTP client error codes.
-    'http_url_rejected',
-    'http_timeout',
-    'http_network_error',
-    'http_unexpected_status',
-    // Phase H webhook codes (restored to spec-de-facto per Python host
-    // close-out and conformance webhook-negative.test.ts).
-    'webhook_url_rejected',
-    'subscription_not_found',
-    // Generic server failure
-    'internal_error',
-];
-/**
- * Type guard that narrows a string to a known canonical HTTP error code.
- * Returns false for host extensions and future spec additions; callers
- * should still render a fallback from the envelope's `message`.
- */
-export function isHttpErrorCode(value) {
-    return typeof value === 'string' && HTTP_ERROR_CODES.includes(value);
+export const HTTP_ERROR_CODES = ERROR_CODES;
+/** Type guard that narrows a string to a registered protocol {@link ErrorCode}. */
+export function isErrorCode(value) {
+    return typeof value === 'string' && ERROR_CODES.includes(value);
+}
+/** 1.x name for {@link isErrorCode}. */
+export const isHttpErrorCode = isErrorCode;
+/** True for the registry rows marked `retriable: true`; retry timing lives in `Retry-After` only (RFC 0171 §B.2). */
+export function isRetriableErrorCode(value) {
+    return typeof value === 'string' && RETRIABLE_ERROR_CODES.includes(value);
+}
+/** True for a well-formed vendor code (`<org>.<name>`, `openwop.` reserved); does not check org registration. */
+export function isVendorErrorCode(value) {
+    return typeof value === 'string' && VENDOR_ERROR_CODE_PATTERN.test(value);
 }
 // ─── Run error codes ─────────────────────────────────────────────────────
 /**
@@ -190,6 +138,9 @@ export const RUN_ERROR_CODES = [
     'node_execution_failed',
     'external_call_failed',
     'recursion_limit_exceeded',
+    'run_timeout',
+    'loop_limit_exceeded',
+    'envelope_refusal',
     'capability_not_provided',
     // Approval
     'approval_timeout',

package/dist/run-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-helpers.js","sourceRoot":"","sources":["../src/run-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,4EAA4E;AAE5E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS;IACT,SAAS;IACT,QAAQ;IACR,kBAAkB;IAClB,eAAe;IACf,kBAAkB;IAClB,sEAAsE;IACtE,oEAAoE;IACpE,YAAY;CACJ,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,WAAW;IACX,QAAQ;IACR,WAAW;CACH,CAAC;AAKX;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA0B;IAC5D,OAAO,CAAE,mBAAyC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACtE,CAAC;AAED,4EAA4E;AAE5E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,gBAAgB;IAChB,iBAAiB;IACjB,WAAW;IACX,aAAa;IACb,aAAa;IAEb,oBAAoB;IACpB,kBAAkB;IAClB,WAAW;IACX,cAAc;IAEd,uCAAuC;IACvC,oBAAoB;IACpB,uBAAuB;IACvB,0BAA0B;IAE1B,mCAAmC;IACnC,yBAAyB;IACzB,gCAAgC;IAChC,yBAAyB;IAEzB,sCAAsC;IACtC,yBAAyB;IACzB,qBAAqB;IACrB,qBAAqB;IACrB,sBAAsB;IACtB,wBAAwB;IAExB,kGAAkG;IAClG,yBAAyB;IACzB,wBAAwB;IACxB,8BAA8B;IAC9B,0BAA0B;IAC1B,wBAAwB;IAExB,6BAA6B;IAC7B,qBAAqB;IACrB,wBAAwB;IACxB,wBAAwB;IACxB,yBAAyB;IAEzB,kDAAkD;IAClD,2CAA2C;IAC3C,wBAAwB;IAExB,sCAAsC;IACtC,2BAA2B;IAC3B,aAAa;IACb,mBAAmB;IACnB,kBAAkB;IAClB,oBAAoB;IACpB,gBAAgB;IAEhB,uCAAuC;IACvC,mBAAmB;IACnB,cAAc;IACd,oBAAoB;IACpB,wBAAwB;IAExB,mEAAmE;IACnE,uDAAuD;IACvD,sBAAsB;IACtB,wBAAwB;IAExB,yBAAyB;IACzB,gBAAgB;CACR,CAAC;AAIX;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,gBAAsC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9F,CAAC;AAED,4EAA4E;AAE5E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,yBAAyB;IACzB,eAAe;IACf,WAAW;IACX,qBAAqB;IAErB,sBAAsB;IACtB,oBAAoB;IACpB,eAAe;IACf,cAAc;IACd,yBAAyB;IAEzB,aAAa;IACb,6BAA6B;IAC7B,uBAAuB;IACvB,qBAAqB;IACrB,0BAA0B;IAE1B,iBAAiB;IACjB,uBAAuB;IACvB,8BAA8B;IAC9B,cAAc;IAEd,YAAY;IACZ,cAAc;IACd,gBAAgB;IAChB,uBAAuB;IACvB,sBAAsB;IACtB,0BAA0B;IAC1B,yBAAyB;IAEzB,WAAW;IACX,kBAAkB;IAClB,wBAAwB;IACxB,wBAAwB;IACxB,yBAAyB;IAEzB,cAAc;IACd,oBAAoB;IACpB,qBAAqB;CACb,CAAC;AAIX;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,eAAqC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7F,CAAC"}
+{"version":3,"file":"run-helpers.js","sourceRoot":"","sources":["../src/run-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,yBAAyB,EAAkB,MAAM,gBAAgB,CAAC;AAE/G,4EAA4E;AAE5E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS;IACT,SAAS;IACT,QAAQ;IACR,kBAAkB;IAClB,eAAe;IACf,kBAAkB;IAClB,sEAAsE;IACtE,oEAAoE;IACpE,YAAY;CACJ,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,WAAW;IACX,QAAQ;IACR,WAAW;CACH,CAAC;AAKX;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA0B;IAC5D,OAAO,CAAE,mBAAyC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACtE,CAAC;AAED,4EAA4E;AAE5E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAI5C,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,WAAiC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzF,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAE3C,qHAAqH;AACrH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,qBAA2C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnG,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5E,CAAC;AAED,4EAA4E;AAE5E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,yBAAyB;IACzB,eAAe;IACf,WAAW;IACX,qBAAqB;IAErB,sBAAsB;IACtB,oBAAoB;IACpB,eAAe;IACf,cAAc;IACd,yBAAyB;IAEzB,aAAa;IACb,6BAA6B;IAC7B,uBAAuB;IACvB,qBAAqB;IACrB,0BAA0B;IAE1B,iBAAiB;IACjB,uBAAuB;IACvB,8BAA8B;IAC9B,cAAc;IAEd,YAAY;IACZ,cAAc;IACd,gBAAgB;IAChB,uBAAuB;IACvB,sBAAsB;IACtB,0BAA0B;IAC1B,aAAa;IACb,qBAAqB;IACrB,kBAAkB;IAClB,yBAAyB;IAEzB,WAAW;IACX,kBAAkB;IAClB,wBAAwB;IACxB,wBAAwB;IACxB,yBAAyB;IAEzB,cAAc;IACd,oBAAoB;IACpB,qBAAqB;CACb,CAAC;AAIX;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,eAAqC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7F,CAAC"}

package/dist/sse.d.ts

@@ -1,35 +1,53 @@
 /**
- * SSE consumer for `GET /v1/runs/{runId}/events`. Async-iterable shape so
- * consumers can write `for await (const event of client.runs.events(...))`.
+ * SSE consumers for `GET /runs/{runId}/events` (the `runEvents` channel) and
+ * `GET /host/events` (the `hostEvents` channel) — events.md §SSE frames.
+ * Async-iterable shape so consumers can write
+ * `for await (const event of client.runs.events(...))`.
  *
- * Implementation parses event:/data:/id: lines per RFC 8895. Native fetch +
- * ReadableStream — zero third-party deps.
+ * Parses `event:` / `data:` / `id:` lines per the WHATWG EventSource
+ * grammar. Native fetch + ReadableStream — zero third-party deps.
  *
- * Designed to be cancellable: pass an AbortSignal via options, or break out
- * of the for-await loop and the underlying connection is torn down on the
- * next tick.
+ * Cancellable: pass an AbortSignal via options, or break out of the
+ * for-await loop and the underlying connection is torn down.
  */
-import type { RunEventDoc, StreamMode } from './types.js';
+import type { HostEventDoc, RunEventDoc, StreamMode } from './types.js';
 export interface EventsStreamOptions {
     /**
-     * Single mode (e.g., 'updates') OR array of modes (S4 mixed-mode,
-     * e.g., ['updates', 'messages']). Arrays serialize to a comma-
-     * separated `?streamMode=updates,messages` query.
+     * Single mode (e.g., 'updates') OR array of modes (mixed mode, e.g.,
+     * ['updates', 'messages']). Arrays serialize to a comma-separated
+     * `?streamMode=updates,messages` query (events.md §The events channel).
      */
     readonly streamMode?: StreamMode | readonly StreamMode[];
+    /** `Last-Event-ID` — the host resumes at the next sequence and never re-emits the resumption point. */
     readonly lastEventId?: string;
     readonly signal?: AbortSignal;
     /**
-     * S3 batching hint. When set, server batches events for up to N ms;
-     * the SDK transparently flattens batched arrays back into individual
-     * RunEventDoc yields, so consumers see the same per-event surface as
-     * unbuffered streams. Range 0..5000.
+     * Batching hint (0..5000). The host accumulates events into one
+     * `event: batch` frame whose `data:` is an array of `RunEventDoc`; the SDK
+     * flattens the batch back into individual yields.
      */
     readonly bufferMs?: number;
 }
+export interface HostEventsStreamOptions {
+    /** `Last-Event-ID` for resumption. */
+    readonly lastEventId?: string;
+    readonly signal?: AbortSignal;
+    /**
+     * The channel address. Default `/host/events`; a host MAY declare another
+     * under `heartbeat.deliveryChannel` (capabilities.md).
+     */
+    readonly path?: string;
+}
 export interface EventsStreamContext {
     readonly baseUrl: string;
     readonly apiKey: string;
+    /** The `OpenWOP-Version` value sent on the subscribe request (RFC 0172 §A.3). */
+    readonly protocolVersion: string;
+    /** Optional fetch implementation override. Defaults to global `fetch`. */
+    readonly fetch?: typeof fetch;
 }
+/** Subscribe to a run's event stream. Yields each `RunEventDoc` until the host closes after the terminal event. */
 export declare function streamEvents(ctx: EventsStreamContext, runId: string, opts?: EventsStreamOptions): AsyncGenerator<RunEventDoc, void, void>;
+/** Subscribe to the host events channel (heartbeat messages; content-free of run data). */
+export declare function streamHostEvents(ctx: EventsStreamContext, opts?: HostEventsStreamOptions): AsyncGenerator<HostEventDoc, void, void>;
 //# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAAC;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAuB,YAAY,CACjC,GAAG,EAAE,mBAAmB,EACxB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,mBAAwB,GAC7B,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CA6HzC"}
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAAC;IACzD,uGAAuG;IACvG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,sCAAsC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CAC/B;AAED,mHAAmH;AACnH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,mBAAmB,EACxB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,mBAAwB,GAC7B,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAazC;AAED,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,mBAAmB,EACxB,IAAI,GAAE,uBAA4B,GACjC,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,CAE1C"}

package/dist/sse.js

@@ -1,15 +1,17 @@
 /**
- * SSE consumer for `GET /v1/runs/{runId}/events`. Async-iterable shape so
- * consumers can write `for await (const event of client.runs.events(...))`.
+ * SSE consumers for `GET /runs/{runId}/events` (the `runEvents` channel) and
+ * `GET /host/events` (the `hostEvents` channel) — events.md §SSE frames.
+ * Async-iterable shape so consumers can write
+ * `for await (const event of client.runs.events(...))`.
  *
- * Implementation parses event:/data:/id: lines per RFC 8895. Native fetch +
- * ReadableStream — zero third-party deps.
+ * Parses `event:` / `data:` / `id:` lines per the WHATWG EventSource
+ * grammar. Native fetch + ReadableStream — zero third-party deps.
  *
- * Designed to be cancellable: pass an AbortSignal via options, or break out
- * of the for-await loop and the underlying connection is torn down on the
- * next tick.
+ * Cancellable: pass an AbortSignal via options, or break out of the
+ * for-await loop and the underlying connection is torn down.
  */
-export async function* streamEvents(ctx, runId, opts = {}) {
+/** Subscribe to a run's event stream. Yields each `RunEventDoc` until the host closes after the terminal event. */
+export function streamEvents(ctx, runId, opts = {}) {
     const params = new URLSearchParams();
     if (opts.streamMode) {
         const modeParam = typeof opts.streamMode === 'string' ? opts.streamMode : opts.streamMode.join(',');
@@ -19,11 +21,20 @@ export async function* streamEvents(ctx, runId, opts = {}) {
         params.set('bufferMs', String(opts.bufferMs));
     }
     const qs = params.toString();
-    const url = `${ctx.baseUrl}/v1/runs/${encodeURIComponent(runId)}/events${qs ? `?${qs}` : ''}`;
+    const path = `/runs/${encodeURIComponent(runId)}/events${qs ? `?${qs}` : ''}`;
+    return streamSse(ctx, path, opts);
+}
+/** Subscribe to the host events channel (heartbeat messages; content-free of run data). */
+export function streamHostEvents(ctx, opts = {}) {
+    return streamSse(ctx, opts.path ?? '/host/events', opts);
+}
+async function* streamSse(ctx, path, opts) {
+    const url = `${ctx.baseUrl}${path}`;
     const headers = {
         Accept: 'text/event-stream',
         Authorization: `Bearer ${ctx.apiKey}`,
         'Cache-Control': 'no-cache',
+        'OpenWOP-Version': ctx.protocolVersion,
     };
     if (opts.lastEventId) {
         headers['Last-Event-ID'] = opts.lastEventId;
@@ -36,7 +47,8 @@ export async function* streamEvents(ctx, runId, opts = {}) {
         else
             externalSignal.addEventListener('abort', () => internalAbort.abort(), { once: true });
     }
-    const res = await fetch(url, { method: 'GET', headers, signal: internalAbort.signal });
+    const doFetch = ctx.fetch ?? fetch;
+    const res = await doFetch(url, { method: 'GET', headers, signal: internalAbort.signal });
     if (!res.ok || res.body === null) {
         throw new Error(`SSE subscribe failed: HTTP ${res.status}`);
     }
@@ -45,36 +57,29 @@ export async function* streamEvents(ctx, runId, opts = {}) {
     let buffer = '';
     let pendingEvent = 'message';
     let pendingData = [];
-    let pendingId = null;
     /**
-     * Flush the buffered event. Returns an array of RunEventDoc:
-     *   - 0 elements when the buffer is empty or non-JSON (skip).
-     *   - 1 element for a normal `event: <type>` event.
-     *   - N elements when the server batched per S3 — `event: batch` with
-     *     `data:` as a JSON array of RunEventDoc.
+     * Flush the buffered frame. Returns 0 elements when the buffer is empty or
+     * non-JSON (skip), 1 element for a normal `event: <type>` frame, N for an
+     * `event: batch` frame whose `data:` is a JSON array.
      */
     const flushAndYield = () => {
         if (pendingData.length === 0) {
             pendingEvent = 'message';
-            pendingId = null;
             return [];
         }
         const dataStr = pendingData.join('\n');
         const eventType = pendingEvent;
         pendingEvent = 'message';
         pendingData = [];
-        pendingId = null;
         try {
             const parsed = JSON.parse(dataStr);
-            // S3 batched envelope — `event: batch` carries an array of events.
             if (eventType === 'batch' && Array.isArray(parsed)) {
                 return parsed;
             }
-            // Normal single-event payload.
             return [parsed];
         }
         catch {
-            // Skip non-JSON events (keep-alive payloads, vendor extensions).
+            // Skip non-JSON frames (keep-alive payloads, vendor extensions).
             return [];
         }
     };
@@ -106,15 +111,13 @@ export async function* streamEvents(ctx, runId, opts = {}) {
                     case 'data':
                         pendingData.push(fieldValue);
                         break;
-                    case 'id':
-                        pendingId = fieldValue;
-                        break;
                     default:
+                        // `id:` is the sequence; the consumer reads it from the document itself.
                         break;
                 }
             }
         }
-        // Flush any final unterminated event.
+        // Flush any final unterminated frame.
         for (const final of flushAndYield())
             yield final;
     }
@@ -128,10 +131,5 @@ export async function* streamEvents(ctx, runId, opts = {}) {
         if (!internalAbort.signal.aborted)
             internalAbort.abort();
     }
-    // Reference pendingEvent/pendingId so the linter doesn't flag them as
-    // unused; they're consumed via flushAndYield's closure but TS can't see
-    // that across a generator boundary.
-    void pendingEvent;
-    void pendingId;
 }
 //# sourceMappingURL=sse.js.map

package/dist/sse.js.map

@@ -1 +1 @@
-{"version":3,"file":"sse.js","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"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"}