@zarel-ai/sdk 0.6.0

package/dist/types/contracts.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Spec-document types (spec-051 US2; renamed from Contract* prefix).
+ *
+ * Wire shapes mirror authoring/packages/contract/src/domain/types/spec-diff.ts.
+ * Kept as plain interfaces so SDK consumers do not depend on the runtime
+ * contract package.
+ */
+export type SpecSection = 'entities' | 'flows' | 'roles' | 'authorization' | 'mcp_servers' | 'llm_services' | 'policies';
+export type ChangeKind = 'added' | 'removed' | 'modified';
+export type ImpactClass = 'breaking' | 'behavioural' | 'additive';
+export type ReviewerRole = 'compliance' | 'ops-leadership' | 'engineering';
+export interface SpecHashes {
+    readonly version: string;
+    readonly hash: string;
+}
+export interface SpecChange {
+    readonly path: string;
+    readonly section: SpecSection;
+    readonly kind: ChangeKind;
+    readonly before: Record<string, unknown> | null;
+    readonly after: Record<string, unknown> | null;
+    readonly impact_class: ImpactClass;
+    readonly human_summary: string;
+}
+export interface ImpactSummary {
+    readonly flows_affected: ReadonlyArray<string>;
+    readonly roles_affected: ReadonlyArray<string>;
+    readonly has_breaking_changes: boolean;
+    readonly may_reject_previously_allowed: boolean;
+    readonly may_require_hitl_previously_not: boolean;
+    readonly recommended_reviewers: ReadonlyArray<ReviewerRole>;
+}
+export interface SpecDiff {
+    readonly tenant: string;
+    readonly current: SpecHashes;
+    readonly proposed: SpecHashes;
+    readonly changes: ReadonlyArray<SpecChange>;
+    readonly impact_summary: ImpactSummary;
+}
+export type SpecApplyMode = 'upsert' | 'replace';
+/**
+ * spec-039 — two-plane contract files. `structural` carries the legacy
+ * structural YAML (entities, fields, roles, policies, transitions, guards,
+ * flows — names/types/policies only). `semanticByLocale` carries the
+ * per-locale `.i18n.<locale>.yaml` content as a record keyed by locale code
+ * (e.g. `{ en: '...', es: '...' }`). The canonical locale (`en`) must
+ * validate atomically (FR-008a); other locales fail soft with warnings
+ * (FR-008b).
+ *
+ * The single-plane `{yaml: string}` shape was removed in spec-039 — lab
+ * phase, no back-compat. Callers shipping un-split YAML should send it as
+ * `files: { structural: yaml }` with no semantic siblings.
+ */
+export interface SpecFiles {
+    readonly structural: string;
+    readonly semanticByLocale?: Readonly<Record<string, string>>;
+}
+export interface SpecPublishRequest {
+    readonly files: SpecFiles;
+    readonly mode: SpecApplyMode;
+    readonly expected_hash?: string;
+    /**
+     * ADR-0102 §6 (S3b) — explicit consent to proceed when plan-as-ceiling
+     * enforcement would strip more than the server threshold (10) of
+     * over-budget grants; without it such a publish fails 422
+     * `strip_threshold_exceeded`.
+     */
+    readonly force?: boolean;
+}
+/** ADR-0102 §6 (S3b) — a grant removed by plan-as-ceiling enforcement. */
+export interface StrippedGrant {
+    readonly role: string;
+    readonly kind: 'section' | 'system';
+    readonly target: string | null;
+    readonly action: string;
+    readonly reason: 'envelope_exceeded' | 'owner_role_protected';
+}
+export interface SpecPublishResponse {
+    readonly tenant_name: string;
+    readonly applied_mode: SpecApplyMode;
+    readonly summary: {
+        readonly entities: number;
+        readonly roles: number;
+        readonly skills: number;
+        readonly actions: number;
+    };
+    /** ADR-0102 §6 (S3b) — grants stripped by this publish ([] when none). */
+    readonly stripped_grants: ReadonlyArray<StrippedGrant>;
+}
+export interface SpecDiffRequest {
+    readonly proposed_spec: string;
+}
+export interface SpecApplyGating {
+    readonly reject_breaking_changes?: boolean;
+    readonly max_changes?: number;
+}
+export interface SpecApplyRequest {
+    readonly files: SpecFiles;
+    readonly mode: SpecApplyMode;
+    readonly expected_hash?: string;
+    readonly gating?: SpecApplyGating;
+    /**
+     * ADR-0102 §6 (S3b) — same semantics as `SpecPublishRequest.force`:
+     * required to proceed when plan-as-ceiling enforcement would strip more
+     * than the server threshold (10) of over-budget grants (422
+     * `strip_threshold_exceeded` otherwise).
+     */
+    readonly force?: boolean;
+}
+export interface SpecApplyResponse {
+    readonly applied: true;
+    readonly diff: SpecDiff;
+    /** ADR-0102 §6 (S3b) — grants stripped by this apply ([] when none). */
+    readonly stripped_grants: ReadonlyArray<StrippedGrant>;
+}
+export interface SpecSnapshotV1Response {
+    readonly tenant_name: string;
+    readonly spec_version: string;
+    readonly contract_version: number;
+    readonly hash: string;
+    readonly contract: unknown;
+}
+export type SpecDryRunStatus = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+export type SpecDryRunOutcome = 'executed' | 'refused' | 'awaiting_human_decision' | 'failed';
+export type SpecDryRunUnknownCause = 'intent_classification_unreusable' | 'external_tool_result_uncached' | 'reference_to_removed_feature';
+export interface SpecDryRunReplayWindow {
+    readonly from: string;
+    readonly to: string;
+}
+export interface SpecDryRunFilter {
+    readonly flow?: string;
+    readonly user?: string;
+}
+export interface SpecDryRunSubmitRequest {
+    readonly proposed_spec: string;
+    readonly replay_window: SpecDryRunReplayWindow;
+    readonly filter?: SpecDryRunFilter;
+}
+export interface SpecDryRunSubmitResponse {
+    readonly report_id: string;
+    readonly status: 'queued' | 'running';
+}
+export interface SpecDryRunChangeBreakdown {
+    readonly from_outcome: SpecDryRunOutcome;
+    readonly to_outcome: SpecDryRunOutcome;
+    readonly count: number;
+    readonly cause: string;
+    readonly example_trace_ids: ReadonlyArray<string>;
+}
+export interface SpecDryRunUnknown {
+    readonly cause: SpecDryRunUnknownCause;
+    readonly count: number;
+    readonly example_trace_ids: ReadonlyArray<string>;
+}
+export interface SpecDryRunAffectedUser {
+    readonly user_name: string;
+    readonly sessions_affected: number;
+}
+export interface SpecDryRunOperationalImplications {
+    readonly estimated_additional_hitl_per_month: number;
+    readonly required_roles: ReadonlyArray<string>;
+}
+export interface SpecDryRunReport {
+    readonly tenant: string;
+    readonly spec_diff: SpecDiff;
+    readonly replay_window: SpecDryRunReplayWindow;
+    readonly sessions_evaluated: number;
+    readonly outcomes_unchanged: number;
+    readonly outcomes_changed: number;
+    readonly change_breakdown: ReadonlyArray<SpecDryRunChangeBreakdown>;
+    readonly affected_users: ReadonlyArray<SpecDryRunAffectedUser>;
+    readonly unknowns: ReadonlyArray<SpecDryRunUnknown>;
+    readonly operational_implications: SpecDryRunOperationalImplications;
+    readonly generated_at: string;
+}
+export interface SpecDryRunJobProgress {
+    readonly traces_processed: number;
+    readonly traces_total: number | null;
+}
+export interface SpecDryRunJobFailure {
+    readonly code: string;
+    readonly message: string;
+}
+export interface SpecDryRunJob {
+    readonly tenant: string;
+    readonly report_id: string;
+    readonly status: SpecDryRunStatus;
+    readonly progress: SpecDryRunJobProgress | null;
+    readonly result: SpecDryRunReport | null;
+    readonly failure: SpecDryRunJobFailure | null;
+    readonly started_at: string;
+    readonly completed_at: string | null;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/types/contracts.d.ts.map

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

package/dist/types/contracts.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Spec-document types (spec-051 US2; renamed from Contract* prefix).
+ *
+ * Wire shapes mirror authoring/packages/contract/src/domain/types/spec-diff.ts.
+ * Kept as plain interfaces so SDK consumers do not depend on the runtime
+ * contract package.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=contracts.js.map

package/dist/types/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/types/contracts.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/types/conversation-sessions.d.ts

@@ -0,0 +1,58 @@
+export type ConversationSessionStatus = 'active' | 'expired' | 'cleared';
+export interface ConversationSessionSummary {
+    tenant_name: string;
+    session_key: string;
+    user_name: string;
+    channel_name: string;
+    status: ConversationSessionStatus;
+    turn_count: number;
+    created_at: string;
+    last_activity: string;
+}
+export interface ConversationTurnRecord {
+    turn_number: number;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    intent_id?: string;
+    intent_type?: string;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+}
+export interface ConversationActionRecord {
+    id: string;
+    session_key: string;
+    turn_number: number;
+    action_type: string;
+    entity_name: string;
+    record_id: string;
+    action_data?: Record<string, unknown>;
+    changed_fields?: string[];
+    actor?: string;
+    created_at: string;
+}
+export interface ConversationSessionDetail {
+    session: ConversationSessionSummary & {
+        /**
+         * Session-level snapshot of the actor's roles (Spec-019 FR-A07). NOT
+         * a security gate — exposed for observability / UI display only.
+         */
+        roles_snapshot: string[];
+        metadata: Record<string, unknown>;
+        current_phase?: string;
+        updated_at: string;
+    };
+    turns: ConversationTurnRecord[];
+    actions: ConversationActionRecord[];
+}
+export interface ConversationSessionListParams {
+    channel_name?: string;
+    status?: ConversationSessionStatus;
+    from?: string;
+    to?: string;
+    limit?: number;
+    offset?: number;
+}
+export type ConversationSessionListResponse = ConversationSessionSummary[];
+export type ConversationSessionDetailResponse = ConversationSessionDetail;
+export type ConversationSessionActionsResponse = ConversationActionRecord[];
+//# sourceMappingURL=conversation-sessions.d.ts.map

package/dist/types/conversation-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-sessions.d.ts","sourceRoot":"","sources":["../../src/types/conversation-sessions.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,0BAA0B;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,yBAAyB,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,0BAA0B,GAAG;QAClC;;;WAGG;QACH,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,6BAA6B;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,+BAA+B,GAAG,0BAA0B,EAAE,CAAC;AAE3E,MAAM,MAAM,iCAAiC,GAAG,yBAAyB,CAAC;AAE1E,MAAM,MAAM,kCAAkC,GAAG,wBAAwB,EAAE,CAAC"}

package/dist/types/conversation-sessions.js

@@ -0,0 +1,6 @@
+"use strict";
+// ═══════════════════════════════════════════════════════════════════════════
+// Conversation session history types — derived from docs/api/openapi-v1.yaml
+// ═══════════════════════════════════════════════════════════════════════════
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=conversation-sessions.js.map

package/dist/types/conversation-sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-sessions.js","sourceRoot":"","sources":["../../src/types/conversation-sessions.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,8EAA8E"}

package/dist/types/conversation.d.ts

@@ -0,0 +1,96 @@
+import type { operations } from '../generated/runtime';
+export type Channel = NonNullable<NonNullable<operations['listConversationSessions']['parameters']['query']>['channel_name']>;
+export interface InteractionContext {
+    channel_name?: Channel;
+    audience?: 'human' | 'machine';
+    modality?: 'synchronous' | 'asynchronous';
+    platform?: string;
+}
+export interface ConversationRequest {
+    message: string;
+    role?: string;
+    interaction?: InteractionContext;
+    /** SpecKit 010 / FR-C07 (T077): explicit session lookup — sessions must be created first via `client.runtime.conversationSessions.create`. */
+    session_key?: string;
+    /** SpecKit 010 / FR-C04 (T077): per-turn LLM service override. Must be authorized for the actor in the session's scope. */
+    llm_service?: string;
+    /**
+     * ADR-0133 §B.4 / FR-C03: the inbound at-most-once dedupe token
+     * `deriveIdempotencyKey(channel, channel_message_id)` (a public sha256 hex).
+     * Set by a channel adapter's party turn so a redelivered provider message
+     * (a re-fired WhatsApp `wamid`) never creates a second turn; the runtime
+     * enforces it unique per `(tenant, channel)` — the channel is trust-rooted
+     * from the credential, never this body. Omit on ordinary tenant turns.
+     */
+    idempotency_key?: string;
+    /**
+     * ADR-0133 §B.7 / FR-E01: the edge-attestation of the inbound boundary crossing,
+     * from which the runtime builds the `channel.ingress` audit row — whether the
+     * adapter verified the provider signature, who attests the crossing (runtime vs
+     * channel_provider), the provider's clock, and the opaque provider message id (which
+     * MUST be hashed by the adapter if address-shaped, FR-E03). Set by a channel
+     * adapter's party turn; omit on ordinary tenant turns.
+     */
+    channel_attestation?: {
+        signature_verified: boolean;
+        attested_by: 'runtime' | 'channel_provider';
+        provider_timestamp?: string;
+        channel_message_id?: string;
+    };
+}
+export interface ConversationDebugInfo {
+    enabled?: boolean;
+    system_prompt?: string;
+    llm_raw_response?: unknown;
+    errors?: Array<{
+        source?: string;
+        message?: string;
+        metadata?: Record<string, unknown>;
+    }>;
+    flow?: Record<string, unknown>;
+    interaction?: {
+        channel_name?: string;
+        audience?: string;
+        modality?: string;
+        renderer_name?: string;
+        output_type?: string;
+    };
+}
+export interface ConversationResponse {
+    success: boolean;
+    message: string;
+    intent_type?: string;
+    intent_id?: string;
+    data?: unknown;
+    clarification_needed?: boolean;
+    options?: string[];
+    suggestions?: string[];
+    error?: string;
+    /** Desk Spec 3 (US2): the turn's correlation id, to tie it to its receipts. */
+    trace_id?: string;
+    /** ADR-0133 §B.7: the inbound turn's sequence number (present on channel party turns). */
+    conversation_turn_seq?: number;
+    _debug?: ConversationDebugInfo;
+}
+export interface ConversationTurn {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    timestamp: string;
+    intent_id?: string;
+    metadata?: {
+        intent_type?: string;
+        entity_name?: string;
+        data?: Record<string, unknown>;
+        interaction_context?: {
+            channel_name?: string;
+            audience?: string;
+            modality?: string;
+            renderer_name?: string;
+        };
+    };
+}
+export interface ConversationHistoryResponse {
+    success: true;
+    history: ConversationTurn[];
+}
+//# sourceMappingURL=conversation.d.ts.map

package/dist/types/conversation.d.ts.map

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

package/dist/types/conversation.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=conversation.js.map

package/dist/types/conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../../src/types/conversation.ts"],"names":[],"mappings":""}

package/dist/types/entities.d.ts

@@ -0,0 +1,22 @@
+export interface EntityInput {
+    name: string;
+    label?: string;
+    description?: string;
+}
+export interface FieldDefinitionInput {
+    name: string;
+    field_type: string;
+    label?: string;
+    description?: string;
+    is_required?: boolean;
+    config?: Record<string, unknown>;
+    options?: string[];
+    default_value?: unknown;
+    position?: number;
+}
+export interface ToolExecutionResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+//# sourceMappingURL=entities.d.ts.map

package/dist/types/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/types/entities.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAUD,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/entities.js

@@ -0,0 +1,4 @@
+"use strict";
+// ── Entities ─────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=entities.js.map

package/dist/types/entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/types/entities.ts"],"names":[],"mappings":";AAAA,4EAA4E"}

package/dist/types/events-stream.d.ts

@@ -0,0 +1,82 @@
+import type { SseConversationTurnCreatedData, SseConversationTurnCreatedPayload } from '../generated';
+/** Metadata-only payload of a `conversation.turn_created` event (ADR-0104). */
+export type ConversationTurnCreatedPayload = SseConversationTurnCreatedPayload;
+/** The SSE bridge wraps every event's data as `{entity, record_id, payload, timestamp}`. */
+export type ConversationTurnCreatedData = SseConversationTurnCreatedData;
+/** A typed `conversation.turn_created` event. `id` is the SSE frame id (correlation / Last-Event-ID anchor). */
+export interface ConversationTurnCreatedEvent {
+    event: 'conversation.turn_created';
+    id?: string;
+    data: ConversationTurnCreatedData;
+}
+/** Any other named runtime event — `data` is left unvalidated. */
+export interface GenericStreamEvent {
+    event: string;
+    id?: string;
+    data: unknown;
+}
+/**
+ * A typed runtime stream event. Narrow to the `conversation.turn_created` arm with the
+ * exported `isConversationTurnCreatedEvent` guard (a plain `event === '…'` check does NOT
+ * narrow, because the generic arm's `event: string` overlaps the literal).
+ */
+export type RuntimeStreamEvent = ConversationTurnCreatedEvent | GenericStreamEvent;
+/** Handlers for `events.stream`. Only `onEvent` is typically needed. */
+export interface EventStreamHandlers {
+    /** Each complete, parsed, typed frame. Heartbeats/comments never surface. */
+    onEvent?: (event: RuntimeStreamEvent) => void;
+    /** A terminal (non-reconnectable) error — invoked at most once. */
+    onError?: (err: unknown) => void;
+    /** Fired on each successful (re)connect. */
+    onOpen?: () => void;
+}
+/** Options for `events.stream`. */
+export interface EventStreamOptions {
+    /** Aborting this is equivalent to `handle.close()`. */
+    signal?: AbortSignal;
+    /** Reconnect on transient disconnects (default: true). */
+    reconnect?: boolean;
+    /** Seed `Last-Event-ID` on the initial connect (resume a known position). */
+    lastEventId?: string;
+}
+/** The teardown handle returned by `events.stream`. */
+export interface EventStreamHandle {
+    /** Idempotent teardown: abort the request, cancel the reader, stop reconnecting. */
+    close(): void;
+}
+/**
+ * Options for `events.iterate` — the async-iterable (pull) view over the same
+ * stream `events.stream` consumes via callbacks. Extends `EventStreamOptions`
+ * (`signal`/`reconnect`/`lastEventId` apply identically) with the pull-view's
+ * bounded-buffer controls. `onOpen` is intentionally absent: a per-connect
+ * signal has no meaning to a `for await` loop (use `events.stream` for that).
+ */
+export interface EventIterateOptions extends EventStreamOptions {
+    /**
+     * Capacity of the bounded FIFO buffer between the push producer (SSE frames)
+     * and the pull consumer (`for await`). Default 1024. Values below 1 clamp to 1.
+     * On overflow the OLDEST queued event is dropped (loss-tolerant, matching the
+     * stream leg), keeping memory bounded regardless of consumer speed.
+     */
+    bufferSize?: number;
+    /**
+     * Invoked once per overflow drop with the running total of dropped events,
+     * so a slow consumer can observe loss out-of-band (the iterator value type
+     * stays a clean `RuntimeStreamEvent`).
+     */
+    onDropped?: (totalDropped: number) => void;
+}
+/**
+ * Runtime type-guard for a `conversation.turn_created` event's `data` envelope (the
+ * single boundary-validation authority for the typed arm — QI-004, ADR-0038, no `as`).
+ */
+export declare function isConversationTurnCreatedData(data: unknown): data is ConversationTurnCreatedData;
+/** Narrowing guard so consumers get the typed `conversation.turn_created` `data` shape. */
+export declare function isConversationTurnCreatedEvent(event: RuntimeStreamEvent): event is ConversationTurnCreatedEvent;
+/**
+ * Map a raw SSE frame (event name + parsed `data` JSON + optional id) to a typed
+ * `RuntimeStreamEvent`. Returns `undefined` when a `conversation.turn_created` frame fails
+ * validation (drop, never throw). Other named events pass through as the generic arm.
+ */
+export declare function toRuntimeStreamEvent(eventName: string, data: unknown, id: string | undefined): RuntimeStreamEvent | undefined;
+//# sourceMappingURL=events-stream.d.ts.map

package/dist/types/events-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-stream.d.ts","sourceRoot":"","sources":["../../src/types/events-stream.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,8BAA8B,EAAE,iCAAiC,EAAE,MAAM,cAAc,CAAC;AAQtG,+EAA+E;AAC/E,MAAM,MAAM,8BAA8B,GAAG,iCAAiC,CAAC;AAE/E,4FAA4F;AAC5F,MAAM,MAAM,2BAA2B,GAAG,8BAA8B,CAAC;AAEzE,gHAAgH;AAChH,MAAM,WAAW,4BAA4B;IACzC,KAAK,EAAE,2BAA2B,CAAC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,2BAA2B,CAAC;CACrC;AAED,kEAAkE;AAClE,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,4BAA4B,GAAG,kBAAkB,CAAC;AAEnF,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAChC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9C,mEAAmE;IACnE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IAC/B,uDAAuD;IACvD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAC9B,oFAAoF;IACpF,KAAK,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC3D;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAQD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,2BAA2B,CAWhG;AAED,2FAA2F;AAC3F,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,kBAAkB,GAAG,KAAK,IAAI,4BAA4B,CAE/G;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAChC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,EACb,EAAE,EAAE,MAAM,GAAG,SAAS,GACvB,kBAAkB,GAAG,SAAS,CAQhC"}

package/dist/types/events-stream.js

@@ -0,0 +1,65 @@
+"use strict";
+// G3 — typed runtime SSE event map for `client.runtime.events.stream`.
+//
+// The runtime event stream (`GET /runtime/events/stream`, ADR-0104) emits NAMED
+// SSE frames. `conversation.turn_created` carries a fixed metadata-only envelope; all
+// other named events (record mutations, state transitions, …) pass through as
+// the generic arm with `data: unknown`.
+//
+// Boundary validation uses a HAND-WRITTEN runtime type-guard — NOT Zod: the SDK
+// ships ZERO runtime dependencies, so it follows the hand-written envelope-shape
+// guard precedent in `fetch-client.ts`. A frame whose JSON is malformed or whose shape
+// fails the guard is dropped (never thrown into `onEvent`) — the leg is
+// loss-tolerant, matching the dashboard's prior raw-EventSource behavior.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isConversationTurnCreatedData = isConversationTurnCreatedData;
+exports.isConversationTurnCreatedEvent = isConversationTurnCreatedEvent;
+exports.toRuntimeStreamEvent = toRuntimeStreamEvent;
+const CONVERSATION_TURN_CREATED = 'conversation.turn_created';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+/**
+ * Runtime type-guard for a `conversation.turn_created` event's `data` envelope (the
+ * single boundary-validation authority for the typed arm — QI-004, ADR-0038, no `as`).
+ */
+function isConversationTurnCreatedData(data) {
+    if (!isRecord(data))
+        return false;
+    if (typeof data.entity !== 'string')
+        return false;
+    if (typeof data.record_id !== 'string')
+        return false;
+    if (typeof data.timestamp !== 'string')
+        return false;
+    const payload = data.payload;
+    if (!isRecord(payload))
+        return false;
+    if (typeof payload.session_key !== 'string')
+        return false;
+    if (typeof payload.turn_number !== 'number')
+        return false;
+    if (typeof payload.role !== 'string')
+        return false;
+    return true;
+}
+/** Narrowing guard so consumers get the typed `conversation.turn_created` `data` shape. */
+function isConversationTurnCreatedEvent(event) {
+    return event.event === CONVERSATION_TURN_CREATED;
+}
+/**
+ * Map a raw SSE frame (event name + parsed `data` JSON + optional id) to a typed
+ * `RuntimeStreamEvent`. Returns `undefined` when a `conversation.turn_created` frame fails
+ * validation (drop, never throw). Other named events pass through as the generic arm.
+ */
+function toRuntimeStreamEvent(eventName, data, id) {
+    if (eventName === CONVERSATION_TURN_CREATED) {
+        if (!isConversationTurnCreatedData(data))
+            return undefined;
+        return id !== undefined
+            ? { event: CONVERSATION_TURN_CREATED, id, data }
+            : { event: CONVERSATION_TURN_CREATED, data };
+    }
+    return id !== undefined ? { event: eventName, id, data } : { event: eventName, data };
+}
+//# sourceMappingURL=events-stream.js.map

package/dist/types/events-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-stream.js","sourceRoot":"","sources":["../../src/types/events-stream.ts"],"names":[],"mappings":";AAAA,uEAAuE;AACvE,EAAE;AACF,gFAAgF;AAChF,sFAAsF;AACtF,8EAA8E;AAC9E,wCAAwC;AACxC,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,uFAAuF;AACvF,wEAAwE;AACxE,0EAA0E;;AAgG1E,sEAWC;AAGD,wEAEC;AAOD,oDAYC;AA7CD,MAAM,yBAAyB,GAAG,2BAA2B,CAAC;AAE9D,SAAS,QAAQ,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,SAAgB,6BAA6B,CAAC,IAAa;IACvD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACnD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,2FAA2F;AAC3F,SAAgB,8BAA8B,CAAC,KAAyB;IACpE,OAAO,KAAK,CAAC,KAAK,KAAK,yBAAyB,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB,CAChC,SAAiB,EACjB,IAAa,EACb,EAAsB;IAEtB,IAAI,SAAS,KAAK,yBAAyB,EAAE,CAAC;QAC1C,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3D,OAAO,EAAE,KAAK,SAAS;YACnB,CAAC,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,EAAE,EAAE,IAAI,EAAE;YAChD,CAAC,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,IAAI,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC1F,CAAC"}

package/dist/types/flows-contract.d.ts

@@ -0,0 +1,8 @@
+export interface ContractFlowListItem {
+    readonly name: string;
+    readonly version?: string;
+    readonly description?: string;
+    readonly [key: string]: unknown;
+}
+export type ContractFlowInput = Record<string, unknown>;
+//# sourceMappingURL=flows-contract.d.ts.map

package/dist/types/flows-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows-contract.d.ts","sourceRoot":"","sources":["../../src/types/flows-contract.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,oBAAoB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/types/flows-contract.js

@@ -0,0 +1,7 @@
+"use strict";
+// Types for the contract.flows resource (A4). Flow *definitions* live on the
+// contract plane (`contract.flows`); flow *instances/runs* are runtime-plane
+// and typed separately in `./flows`. Kept intentionally open (index signature)
+// pending the full flow-definition schema — broad typing is track G (NG-005).
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=flows-contract.js.map

package/dist/types/flows-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows-contract.js","sourceRoot":"","sources":["../../src/types/flows-contract.ts"],"names":[],"mappings":";AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,8EAA8E"}