@zarel-ai/sdk 0.6.0

package/dist/types/state-machine.d.ts

@@ -0,0 +1,100 @@
+export interface StateMachineInstance {
+    id: string;
+    entity_name: string;
+    record_id: number;
+    field_name: string;
+    current_state: string;
+    created_at: string;
+    updated_at?: string;
+}
+export interface StateMachineInstanceListResponse {
+    count: number;
+    instances: StateMachineInstance[];
+}
+export type StateMachineInstanceResponse = StateMachineInstance;
+export interface StateMachineEventListParams {
+    entity_name?: string;
+    instance_id?: string;
+}
+export interface StateMachineEvent {
+    id: string;
+    instance_id: string;
+    from_state: string;
+    to_state: string;
+    actor?: string;
+    actor_role?: string | null;
+    payload?: Record<string, unknown>;
+    rule_evaluations?: unknown;
+    created_at: string;
+}
+export interface StateMachineEventListResponse {
+    count: number;
+    events: StateMachineEvent[];
+}
+export type StateMachineEventResponse = StateMachineEvent;
+export type TransitionRequestStatus = 'pending' | 'approved' | 'rejected';
+export interface TransitionRequestListParams {
+    status?: TransitionRequestStatus;
+    /**
+     * Filter to requests whose `required_roles` intersect with any of the
+     * supplied roles. Serialized as repeated query parameters.
+     */
+    roles?: string[];
+}
+export interface TransitionRequestItem {
+    transition_request_id: string;
+    entity_name: string;
+    record_id: number;
+    current_state: string;
+    target_state: string;
+    field_name?: string;
+    required_roles: string[];
+    reason?: string;
+    status?: TransitionRequestStatus;
+    created_at: string;
+}
+export interface TransitionRequestListResponse {
+    count: number;
+    transition_requests: TransitionRequestItem[];
+}
+export type TransitionRequestResponse = TransitionRequestItem;
+export interface TransitionRequestCreateBody {
+    instance_id: string;
+    entity_name: string;
+    record_id: number;
+    field_name: string;
+    current_state: string;
+    requested_transition: string;
+    /**
+     * Server derives `required_roles` from the contract's matching transition
+     * edges (`allowed_roles` union). Clients should normally omit this field;
+     * supplied values are used only when the server has no contract context
+     * (e.g., test stubs) and are otherwise ignored.
+     */
+    required_roles?: string[];
+    reason?: string;
+}
+export interface TransitionRequestPatchBody {
+    decision: 'approved' | 'rejected';
+    role?: string;
+    field_name?: string;
+    decision_notes?: string;
+}
+export interface TransitionRequestPatchResponse {
+    mode?: string;
+    entity_name?: string;
+    record_id?: number;
+    transition_request?: {
+        transition_request_id: string;
+        status: 'approved' | 'rejected';
+        resolved_by: string;
+        entity_name: string;
+        record_id: number;
+    };
+    state_machine_event?: {
+        id: string;
+        from_state: string;
+        to_state: string;
+    } | null;
+}
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/types/state-machine.d.ts.map

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

package/dist/types/state-machine.js

@@ -0,0 +1,9 @@
+"use strict";
+// ── State Machine ────────────────────────────────────────────────────────
+//
+// Canonical runtime-scope state-machine types. Backing tables:
+//   runtime."state_machine/instances"          (readonly)
+//   runtime."state_machine/events"             (readonly; was exposed as /workflows/timeline pre-P10)
+//   runtime."state_machine/transition_requests" (mutable)
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=state-machine.js.map

package/dist/types/state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../../src/types/state-machine.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,EAAE;AACF,+DAA+D;AAC/D,0DAA0D;AAC1D,sGAAsG;AACtG,0DAA0D"}

package/dist/types/system.d.ts

@@ -0,0 +1,28 @@
+export interface HealthResponse {
+    status: 'healthy';
+    timestamp: string;
+}
+export type MetricsResponse = Record<string, unknown>;
+export interface ApiKeyCreateRequest {
+    name: string;
+    scopes?: string[];
+}
+export interface ApiKeyCreateResponse {
+    id: string;
+    name: string;
+    key: string;
+    scopes?: string[];
+    created_at?: string;
+}
+export interface ApiKeyListItem {
+    id: string;
+    name: string;
+    key_prefix: string;
+    scopes?: string[];
+    created_at?: string;
+}
+export type ApiKeyListResponse = ApiKeyListItem[];
+export interface ApiKeyDeleteResponse {
+    success: true;
+}
+//# sourceMappingURL=system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/types/system.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,kBAAkB,GAAG,cAAc,EAAE,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,IAAI,CAAC;CACjB"}

package/dist/types/system.js

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

package/dist/types/system.js.map

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

package/dist/types/tools.d.ts

@@ -0,0 +1,188 @@
+export interface UserVisibleAction {
+    action: 'create' | 'read' | 'list' | 'update' | 'delete';
+    owned_only: boolean;
+}
+export interface FieldToolDefinition {
+    name: string;
+    type: string;
+    required: boolean;
+    label?: string;
+    description?: string;
+    config?: Record<string, unknown>;
+    options?: string[];
+    /**
+     * Enum value → localized display label, resolved from the field's i18n
+     * sidecar at projection time. Present only for enum fields; options with no
+     * authored label are omitted, so consumers MUST fall back to the raw
+     * `options` code when a key is absent. (Mirror of the contract-side
+     * `FieldToolDefinition` — kept in lockstep.)
+     */
+    values?: Record<string, string>;
+    default?: unknown;
+    references?: string;
+    /**
+     * The effective display field of the *referenced* entity for a
+     * reference/reference[] field — the field a client labels/searches the target
+     * by (ADR-0134 T007). Resolved server-side; omitted when unresolvable.
+     * (Mirror of the contract-side `FieldToolDefinition` — kept in lockstep.)
+     */
+    display_field?: string;
+    constraints?: Record<string, unknown>;
+    compute?: {
+        expression?: string;
+        strategy?: 'write' | 'read';
+        cache?: boolean;
+    };
+    binding?: {
+        bind: string;
+    } | {
+        assert: string;
+    } | {
+        immutable_after_set: true;
+    };
+}
+export interface UserVisibleEntityTool {
+    entity_name: string;
+    entity_label: string;
+    description?: string;
+    actions: UserVisibleAction[];
+    fields: FieldToolDefinition[];
+    tool_names: string[];
+}
+/**
+ * Per-edge projection of a `StateMachineTransition` exposed to UIs through
+ * the catalog (spec 015 / M4). `requires_reason` is omitted when the
+ * underlying flag is `false` or absent.
+ */
+export interface TransitionEdge {
+    from: string;
+    to: string;
+    requires_reason?: boolean;
+}
+/**
+ * Per-user projection of a state-machine `(entity, field)` transition tool
+ * trio (ADR-0081). Carries the rendering inputs needed by the M4 UI surfaces
+ * (`<FieldTransitions>`, `<TransitionRequestQueue>`).
+ */
+export interface UserVisibleTransitionTool {
+    entity_name: string;
+    field_name: string;
+    request_tool_name: string;
+    resolve_tool_name: string;
+    list_pending_tool_name: string;
+    target_states: readonly string[];
+    transitions: readonly TransitionEdge[];
+    field_label?: string;
+    field_description?: string;
+    inspect: boolean;
+}
+/**
+ * Per-user projection of a YAML-declared `action` (ADR-0085) the user is
+ * authorized to dispatch. Carries the rendering inputs needed by the M5 UI
+ * surfaces (`<EntityActions>`, `<EntityRecordActions>`).
+ *
+ * Emitted only when the action-surface-resolver returns `kind: 'action'` for
+ * the underlying `(entity, verb)` pair under the user's capabilities. Hidden
+ * and entity-fallback decisions are NOT projected.
+ */
+export interface UserVisibleActionTool {
+    /** Action name from YAML — unique within the tenant. */
+    name: string;
+    /** Underlying entity the action operates on. */
+    entity: string;
+    /** CRUD verb the action invokes server-side. */
+    verb: 'create' | 'read' | 'update' | 'delete' | 'list';
+    /** Human-readable description (from YAML `action.description`). */
+    description?: string;
+    /** Dispatcher-recognised intent string — `action.<name>` or `external.<ns>.<tool>`. */
+    intent_type: string;
+    /** Whether the action is native (declared in tenant YAML) or external (ADR-0076). */
+    provenance: 'native' | 'external';
+}
+/**
+ * Per-tenant role declaration. Always projected for every caller — read-only
+ * metadata used by UIs to render role pickers and label other catalog
+ * references. Editing is gated separately by the `roles` contract-section
+ * policy (W3: surfaced to UIs via {@link UserToolCatalog.admin_sections}).
+ */
+export interface UserVisibleRole {
+    name: string;
+    label?: string;
+    description?: string;
+}
+/**
+ * Per-tenant flow declaration projected for users with `inspect` policy on the
+ * flow (open-by-default per ADR-0065). Only carries the rendering inputs the
+ * dashboard sidebar needs — full editable shape is fetched elsewhere.
+ */
+export interface UserVisibleFlow {
+    name: string;
+    description?: string;
+}
+/**
+ * Per-tenant skill declaration projected for users whose role set satisfies
+ * the skill's YAML `constraints[]`.
+ */
+export interface UserVisibleSkill {
+    name: string;
+    label?: string;
+    description?: string;
+}
+/**
+ * W3 — mirror of `@zarel-ai/contract`'s `CONTRACT_SECTION_NAMES`. The closed set
+ * of contract sections; `UserToolCatalog.admin_sections` is a subset (the
+ * sections the user can `update`). The SDK is published standalone and cannot
+ * import the contract package, so this is a hand-maintained mirror — and it
+ * DRIFTED: it named two roots that no longer exist and none of the nine that a
+ * dissolution had created. The ADR-0136 QI-001 gate compared seven mirrors and
+ * did not compare this one, which is why nothing said so. It does now.
+ */
+export declare const CONTRACT_SECTION_NAMES: readonly ["metadata", "entities", "roles", "skills", "actions", "schemas", "capabilities", "flows", "constraints", "events", "llm", "embeddings", "treatment", "channels", "channels/credentials", "mcp_servers", "quotas", "timezone", "process_model", "authorization"];
+export type ContractSectionName = typeof CONTRACT_SECTION_NAMES[number];
+export interface UserToolCatalog {
+    tenant_name: string;
+    user_name: string;
+    user_roles: string[];
+    entities: UserVisibleEntityTool[];
+    /** M4 / ADR-0081 trio-coupled state-machine projection. */
+    transitions?: UserVisibleTransitionTool[];
+    /** M5 / ADR-0085 per-user authorized action projection. */
+    actions?: UserVisibleActionTool[];
+    /** Spec-042: declared roles in the tenant contract (read-only metadata). */
+    roles: UserVisibleRole[];
+    /** Spec-042: flows the user can `inspect` (ADR-0065 open-by-default). */
+    flows: UserVisibleFlow[];
+    /** Spec-042: skills whose YAML `constraints` evaluate true for the user. */
+    skills: UserVisibleSkill[];
+    /**
+     * W3 (ADR-0102 §3 closure): contract sections the user can `update`. The
+     * dashboard derives admin **mutation** pages (Roles, Skills, Flows,
+     * Authorization/Policies, State-machines, Settings) and the admin-tier
+     * pages (Imports, API-keys) from this, replacing the retired `edit_*` /
+     * `manage_imports` / `manage_api_keys` capability codes.
+     */
+    admin_sections: ContractSectionName[];
+}
+export interface ToolCatalogResponse {
+    success: true;
+    catalog: UserToolCatalog;
+}
+export interface McpToolDefinition {
+    name: string;
+    title?: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+export interface McpToolsResponse {
+    success: true;
+    tools: McpToolDefinition[];
+}
+export interface ToolCallRequest {
+    tool: string;
+    parameters: Record<string, unknown>;
+}
+export interface ToolCallResponse {
+    success: boolean;
+    result?: unknown;
+}
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACzD,UAAU,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;QAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IAGF,OAAO,CAAC,EACF;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAChB;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAClB;QAAE,mBAAmB,EAAE,IAAI,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IAClC,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvD,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,UAAU,EAAE,QAAQ,GAAG,UAAU,CAAC;CACrC;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,2QAOzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAC1C,2DAA2D;IAC3D,OAAO,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAClC,4EAA4E;IAC5E,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,yEAAyE;IACzE,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,4EAA4E;IAC5E,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B;;;;;;OAMG;IACH,cAAc,EAAE,mBAAmB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,IAAI,CAAC;IACd,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/types/tools.js

@@ -0,0 +1,22 @@
+"use strict";
+// ── Tools ────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONTRACT_SECTION_NAMES = void 0;
+/**
+ * W3 — mirror of `@zarel-ai/contract`'s `CONTRACT_SECTION_NAMES`. The closed set
+ * of contract sections; `UserToolCatalog.admin_sections` is a subset (the
+ * sections the user can `update`). The SDK is published standalone and cannot
+ * import the contract package, so this is a hand-maintained mirror — and it
+ * DRIFTED: it named two roots that no longer exist and none of the nine that a
+ * dissolution had created. The ADR-0136 QI-001 gate compared seven mirrors and
+ * did not compare this one, which is why nothing said so. It does now.
+ */
+exports.CONTRACT_SECTION_NAMES = [
+    'metadata', 'entities', 'roles', 'skills', 'actions', 'schemas',
+    'capabilities', 'flows', 'constraints', 'events',
+    'llm', 'embeddings', 'treatment',
+    'channels', 'channels/credentials',
+    'mcp_servers', 'quotas', 'timezone',
+    'process_model', 'authorization',
+];
+//# sourceMappingURL=tools.js.map

package/dist/types/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":";AAAA,4EAA4E;;;AA4I5E;;;;;;;;GAQG;AACU,QAAA,sBAAsB,GAAG;IAClC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS;IAC/D,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ;IAChD,KAAK,EAAE,YAAY,EAAE,WAAW;IAChC,UAAU,EAAE,sBAAsB;IAClC,aAAa,EAAE,QAAQ,EAAE,UAAU;IACnC,eAAe,EAAE,eAAe;CAC1B,CAAC"}

package/dist/types/traces.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Trace observability types (Spec-020 US1).
+ *
+ * Wire shapes mirror the runtime contract module's `Trace` / `TraceSummary`
+ * (see authoring/packages/contract/src/domain/types/trace.ts). Keeping the
+ * canonical-with-runtime surface here as plain interfaces avoids forcing
+ * SDK consumers to depend on the runtime contract package.
+ */
+/**
+ * WHICH WINDOW a trace's timing fields were measured over.
+ *
+ * The listing and the single-trace read answer different questions about the same trace
+ * and used to answer them silently: a conversation answered in 6 s whose webhook retry
+ * settled at 40 s reported 6 s in the list and 40 s when opened. Both true; neither said
+ * so. Each surface now declares its own.
+ */
+export type TraceDurationBasis = 'anchor_evidence' | 'all_evidence';
+export type TraceOutcome = 'executed' | 'refused' | 'awaiting_human_decision' | 'failed';
+export type TraceStage = 'topic_gate' | 'intent_scoring' | 'envelope' | 'gatekeeper' | 'preconditions' | 'hitl' | 'execution' | 'audit';
+export interface TraceEventError {
+    readonly code: string;
+    readonly message: string;
+}
+export interface TraceEvent {
+    readonly type: string;
+    readonly timestamp: string;
+    readonly stage: TraceStage;
+    readonly data: Record<string, unknown>;
+    readonly error?: TraceEventError | null;
+}
+export interface TraceUserRef {
+    readonly user_name: string;
+    readonly roles: ReadonlyArray<string>;
+}
+export interface Trace {
+    readonly trace_id: string;
+    readonly tenant: string;
+    readonly session_key: string | null;
+    readonly parent_trace_id: string | null;
+    readonly spec_version: string;
+    readonly spec_hash: string;
+    readonly user: TraceUserRef | null;
+    readonly flow: string | null;
+    readonly started_at: string;
+    readonly completed_at: string | null;
+    readonly duration_ms: number | null;
+    /** Always `all_evidence`: this view lists every event, so its window covers them. */
+    readonly duration_basis: TraceDurationBasis;
+    readonly outcome: TraceOutcome;
+    readonly events: ReadonlyArray<TraceEvent>;
+}
+export interface TraceSummary {
+    readonly trace_id: string;
+    readonly started_at: string;
+    readonly completed_at: string | null;
+    readonly flow: string | null;
+    readonly user_name: string | null;
+    readonly duration_ms: number | null;
+    /** Always `anchor_evidence`: the anchoring evidence's span, so one late delivery
+     *  cannot make a fast conversation look slow in a scanned page. */
+    readonly duration_basis: TraceDurationBasis;
+    readonly outcome: TraceOutcome;
+}
+export interface TraceListParams {
+    readonly flow?: string;
+    readonly user?: string;
+    readonly from?: string;
+    readonly to?: string;
+    readonly outcome?: TraceOutcome;
+    readonly limit?: number;
+    readonly cursor?: string;
+}
+export interface TraceListResponse {
+    readonly traces: ReadonlyArray<TraceSummary>;
+    readonly next_cursor: string | null;
+}
+//# sourceMappingURL=traces.d.ts.map

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

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

package/dist/types/traces.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Trace observability types (Spec-020 US1).
+ *
+ * Wire shapes mirror the runtime contract module's `Trace` / `TraceSummary`
+ * (see authoring/packages/contract/src/domain/types/trace.ts). Keeping the
+ * canonical-with-runtime surface here as plain interfaces avoids forcing
+ * SDK consumers to depend on the runtime contract package.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=traces.js.map

package/dist/types/traces.js.map

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

package/dist/types/workflows.d.ts

@@ -0,0 +1,42 @@
+export interface WorkflowTransitionRule {
+    condition: string;
+    description: string;
+}
+export interface WorkflowTransitionConfig {
+    from: string;
+    to: string;
+    allowed_roles?: string[];
+    rules?: WorkflowTransitionRule[];
+}
+export interface WorkflowStateMachineConfig {
+    field: string;
+    initial: string;
+    transitions: WorkflowTransitionConfig[];
+}
+export interface WorkflowReplayRequest {
+    instance_id: string;
+    new_config: WorkflowStateMachineConfig;
+}
+export interface WorkflowReplayEventResult {
+    event_id: string;
+    from_state: string;
+    to_state: string;
+    original_passed: boolean;
+    replay_passed: boolean;
+    diverged: boolean;
+    reason?: string;
+}
+export interface WorkflowReplayResult {
+    instance_id: string;
+    total_events: number;
+    diverged_count: number;
+    events: WorkflowReplayEventResult[];
+}
+export interface WorkflowReplayEmptyResult {
+    message: string;
+    total_events: 0;
+    diverged_count: 0;
+    events: [];
+}
+export type WorkflowReplayResponse = WorkflowReplayResult | WorkflowReplayEmptyResult;
+//# sourceMappingURL=workflows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/types/workflows.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,sBAAsB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,0BAA0B;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,wBAAwB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,0BAA0B,CAAC;CAC1C;AAED,MAAM,WAAW,yBAAyB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,yBAAyB,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,yBAAyB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,CAAC,CAAC;IAChB,cAAc,EAAE,CAAC,CAAC;IAClB,MAAM,EAAE,EAAE,CAAC;CACd;AAED,MAAM,MAAM,sBAAsB,GAAG,oBAAoB,GAAG,yBAAyB,CAAC"}

package/dist/types/workflows.js

@@ -0,0 +1,11 @@
+"use strict";
+// ── Workflows (service-endpoint only) ────────────────────────────────────
+//
+// `POST /workflows/replay` is a permanent Service endpoint per ADR-0077
+// FR-4#3 (Q3 resolution). Types below describe its request/response shapes.
+// All other types that used to live here moved in P12:
+//   - timeline/event types  → ./state-machine.ts
+//   - transition-request types → ./state-machine.ts
+//   - flow instance/step types → ./flows.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=workflows.js.map

package/dist/types/workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../../src/types/workflows.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,EAAE;AACF,wEAAwE;AACxE,4EAA4E;AAC5E,uDAAuD;AACvD,iDAAiD;AACjD,oDAAoD;AACpD,4CAA4C"}

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@zarel-ai/sdk",
+  "version": "0.6.0",
+  "description": "TypeScript SDK for the Zarel API",
+  "license": "MIT",
+  "author": "Zarel AI",
+  "homepage": "https://zarel.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Zarel-AI/platform.git",
+    "directory": "sdk/packages/sdk"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "require": "./dist/client.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.js",
+      "require": "./dist/errors.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js",
+      "require": "./dist/types/index.js"
+    },
+    "./resources": {
+      "types": "./dist/resources/index.d.ts",
+      "import": "./dist/resources/index.js",
+      "require": "./dist/resources/index.js"
+    },
+    "./resources/*": {
+      "types": "./dist/resources/*.d.ts",
+      "import": "./dist/resources/*.js",
+      "require": "./dist/resources/*.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "client": [
+        "dist/client.d.ts"
+      ],
+      "errors": [
+        "dist/errors.d.ts"
+      ],
+      "types": [
+        "dist/types/index.d.ts"
+      ],
+      "resources": [
+        "dist/resources/index.d.ts"
+      ],
+      "resources/*": [
+        "dist/resources/*.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "prepack": "npm run build",
+    "build": "tsc",
+    "test": "jest",
+    "lint": "eslint src/ tests/",
+    "gen:sdk-types": "openapi-typescript ../../../docs/api/runtime-openapi-v1.yaml -o src/generated/runtime.ts && openapi-typescript ../../../docs/api/contract-openapi-v1.yaml -o src/generated/contract.ts",
+    "gen:sdk-unwrap-map": "tsx ../../../scripts/toolchain/gen-sdk-unwrap-map.ts src/generated/unwrap-map.ts",
+    "gen:sdk": "npm run gen:sdk-types && npm run gen:sdk-unwrap-map"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.0",
+    "jest": "^29.7.0",
+    "openapi-typescript": "7.13.0",
+    "ts-jest": "^29.1.2",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "yaml": "2.8.2"
+  },
+  "keywords": [
+    "zarel",
+    "zarel-ai",
+    "sdk",
+    "api-client"
+  ]
+}