@consciousclouds/conductor-sdk 0.1.0

package/dist/generated/types.d.ts

@@ -0,0 +1,208 @@
+/** A capability string in the `<primitive>.<verb>` vocabulary, e.g. canvas.read. */
+export type Capability = string;
+/** Request body for POST /api/v1/conductor/turn/stream. The caller supplies a prompt and an optional personality id; when omitted the server selects its default personality. */
+export interface TurnRequest {
+    /** Id of the registered personality to drive the turn. Optional; defaults server-side. */
+    personality_id?: string;
+    /** The user prompt for this turn. */
+    prompt: string;
+}
+/** Request body for POST /api/v1/conductor/approvals/:id/resolve. Approves or rejects a pending approval surfaced by an approval_required SSE event. */
+export interface ResolveRequest {
+    /** The operator's decision for the pending approval. */
+    decision: "approve" | "reject";
+}
+/** Response body for POST /api/v1/conductor/approvals/:id/resolve. */
+export interface ResolveResult {
+    /** Id of the approval that was resolved. */
+    approval_id: string;
+    /** Resolution status of the approval. */
+    status: string;
+    /** Name of the tool the approval gated. */
+    tool: string;
+    /** Result of executing the gated tool (null when rejected). */
+    result: Record<string, unknown> | null;
+    /** Outcome of the resolution (e.g. executed, rejected). */
+    outcome: string;
+}
+/** Declaration of a tool the Conductor may invoke. Governance metadata (category, required capabilities, approval, idempotency) travels with the tool so callers and the runtime agree on its blast radius. */
+export interface ToolDeclaration {
+    /** Unique tool name. */
+    name: string;
+    /** Human-readable description of what the tool does. */
+    description: string;
+    /** JSON Schema describing the tool's input arguments. */
+    input_schema: Record<string, unknown>;
+    /** Blast-radius category of the tool. */
+    category: "read" | "write" | "destructive";
+    /** Capabilities the caller must hold to invoke the tool. */
+    required_capabilities: string[];
+    /** Whether the tool call must be approved before it executes. */
+    requires_approval: boolean;
+    /** Whether repeating the tool call is safe. */
+    idempotent: boolean;
+}
+/** BEHAVIOR-ONLY surface config. Styling/branding/appearance stays in the product. */
+export interface PersonalityDeclarationAssistantSurfaceConfig {
+    mode?: "overlay" | "inflow";
+    dismissible?: boolean;
+    modal?: boolean;
+}
+/** May only TIGHTEN tool approval, never loosen. */
+export interface PersonalityDeclarationApprovalPolicy {
+    /** Additional allowed tools to force approval for. */
+    require_approval_tools?: string[];
+}
+/** Narrows platform usage defaults (0 = inherit). Binds to the Usage Meter (Contract 9). */
+export interface PersonalityDeclarationUsagePolicy {
+    max_output_tokens?: number;
+    max_turn_iterations?: number;
+}
+/** Audit posture (declared now, enforced as auditing matures). */
+export interface PersonalityDeclarationAuditPolicy {
+    level?: string;
+}
+/** Declaration of a registered Conductor personality — the five-section Personality Package (Identity, Runtime, Access, UX, Governance). A personality is configuration, not a fork; every field is narrowing-only. Amends/supersedes the original seven-field personality declaration (see docs/design/personality-package-contract.md). */
+export interface PersonalityDeclaration {
+    /** Unique personality id (the registry key; opaque, never a product noun). */
+    id: string;
+    /** Human display name. */
+    name: string;
+    /** One-line purpose. */
+    description: string;
+    /** The vertical this personality ships in (Business Package Contract link). */
+    business_package: string;
+    /** Coarse operator archetype (optional, narrowing). For discovery/defaults; changes no runtime behavior. */
+    classification?: "operator" | "consumer" | "developer" | "administrator" | "analyst" | "educator";
+    /** System instructions / persona; opaque to the engine. */
+    instructions: string;
+    /** Model-tier hint; never a vendor/model id. */
+    tier: "fast" | "deep" | "local";
+    /** Abstract, provider-blind selection policy (e.g. cost/latency/residency preference). Conductor resolves tier+policy to a concrete provider/model; never names a vendor. */
+    provider_policy?: string;
+    /** The consul-bound entitlement envelope (<primitive>.<verb>). Every allowed tool's capability must be within it. */
+    capabilities: string[];
+    /** Tool names the personality may invoke (subset of registered tools). */
+    allowed_tools: string[];
+    /** Adapter ids the personality may read context from (present-day context-assembly boundary). */
+    allowed_adapters: string[];
+    /** Canvas types the personality may emit (subset of approved types). */
+    allowed_canvases: string[];
+    /** Graph scopes the personality may read. Forward-declared; firmed up by the Graph SDK lock. */
+    allowed_graph_scopes?: string[];
+    /** Memory scopes the personality may read/write. Forward-declared; firmed up by the Memory SDK lock; project_id-gated. */
+    allowed_memory_scopes?: string[];
+    /** BEHAVIOR-ONLY surface config. Styling/branding/appearance stays in the product. */
+    assistant_surface_config?: PersonalityDeclarationAssistantSurfaceConfig;
+    /** Presentation posture (behavior-only): chat-first or canvas-first. The AI Client arranges the surface accordingly. Default chat-first. */
+    primary_surface?: "chat-first" | "canvas-first";
+    /** Canvas types opened by default (subset of allowed_canvases). */
+    default_canvas_types?: string[];
+    /** Starter prompts / quick actions (behavioral, not visual). */
+    suggested_actions?: string[];
+    /** May only TIGHTEN tool approval, never loosen. */
+    approval_policy?: PersonalityDeclarationApprovalPolicy;
+    /** Narrows platform usage defaults (0 = inherit). Binds to the Usage Meter (Contract 9). */
+    usage_policy?: PersonalityDeclarationUsagePolicy;
+    /** Audit posture (declared now, enforced as auditing matures). */
+    audit_policy?: PersonalityDeclarationAuditPolicy;
+}
+/** The pending tool call awaiting approval. */
+export interface ApprovalRequiredEventDataPending {
+    /** Id of the paused tool call. */
+    tool_call_id: string;
+    /** Name of the tool awaiting approval. */
+    tool: string;
+}
+/** data payload of the `approval_required` SSE event — a tool call is paused awaiting an operator decision. */
+export interface ApprovalRequiredEventData {
+    /** Id of the turn awaiting approval. */
+    turn_id: string;
+    /** Id used to resolve the approval. */
+    approval_id: string;
+    /** The pending tool call awaiting approval. */
+    pending: ApprovalRequiredEventDataPending;
+}
+/** data payload of the `completed` SSE event — emitted once when the turn finishes, with usage accounting. */
+export interface CompletedEventData {
+    /** Id of the completed turn. */
+    turn_id: string;
+    /** Number of model calls made during the turn. */
+    calls: number;
+    /** Number of tool calls made during the turn. */
+    tool_calls: number;
+    /** Input tokens consumed. */
+    input_tokens: number;
+    /** Output tokens produced. */
+    output_tokens: number;
+    /** Total cost of the turn in USD. */
+    cost_usd: number;
+}
+/** data payload of the `delta` SSE event — an incremental chunk of assistant text. */
+export interface DeltaEventData {
+    /** The incremental text chunk. */
+    text: string;
+}
+/** data payload of the `error` SSE event — the turn terminated with an error. */
+export interface ErrorEventData {
+    /** Machine-readable error code. */
+    code: string;
+    /** Human-readable error message. */
+    message: string;
+}
+/** data payload of the `routed` SSE event — a TERMINAL event (a peer of `completed`) emitted when the deterministic Response Decision / Presentation Routing stage resolves a turn to a navigation/action with NO model call (zero tokens). It carries a destination directive the product's surface performs; the directive is opaque to Universal. */
+export interface RoutedEventData {
+    /** `navigation` (move the surface) or `action` (a surface-level action). */
+    kind: "navigation" | "action";
+    /** The destination — an app route or deep-link URI. Opaque to Universal; the product's router interprets it. */
+    target: string;
+    /** `navigate` (go to route) · `open-view` (open a view in place) · `load-source` (load a data source/panel). */
+    mode: "navigate" | "open-view" | "load-source";
+    /** Optional flat parameters for the target. */
+    params?: Record<string, unknown>;
+    /** Optional id tying the directive back to the originating request. */
+    correlation_id?: string;
+}
+/** data payload of the `started` SSE event — emitted once at the start of a turn. */
+export interface StartedEventData {
+    /** Id of the turn that just started. */
+    turn_id: string;
+    /** Id of the resolved personality. */
+    personality: string;
+    /** Service tier the turn runs under. */
+    tier: string;
+}
+/** data payload of the `tool_done` SSE event — a tool call has finished. */
+export interface ToolDoneEventData {
+    /** Name of the tool that finished. */
+    tool: string;
+    /** Optional status string for the tool call. */
+    status?: string;
+    /** Optional human-readable message. */
+    message?: string;
+    /** The tool's raw output content (the same content fed back to the model), surfaced for the UI to render — e.g. a JSON string the product parses into a canvas block. Present on success. */
+    result?: string;
+}
+/** data payload of the `tool_start` SSE event — a tool call has begun. */
+export interface ToolStartEventData {
+    /** Name of the tool being invoked. */
+    tool: string;
+    /** Optional status string for the tool call. */
+    status?: string;
+    /** Optional human-readable message. */
+    message?: string;
+}
+/** The frozen SSE event names. */
+export type ConductorEventName = "started" | "delta" | "tool_start" | "tool_done" | "approval_required" | "completed" | "error" | "routed";
+/** Map of event name → its data payload type. */
+export interface ConductorEventDataMap {
+    started: StartedEventData;
+    delta: DeltaEventData;
+    tool_start: ToolStartEventData;
+    tool_done: ToolDoneEventData;
+    approval_required: ApprovalRequiredEventData;
+    completed: CompletedEventData;
+    error: ErrorEventData;
+    routed: RoutedEventData;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/generated/types.js

@@ -0,0 +1,3 @@
+// AUTO-GENERATED — DO NOT EDIT. Run `python platform/codegen/conductor/generate.py` to regenerate. Source: platform/contracts/conductor/v1/
+export {};
+//# sourceMappingURL=types.js.map

package/dist/generated/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export type { Capability, TurnRequest, ResolveRequest, ResolveResult, ToolDeclaration, PersonalityDeclaration, StartedEventData, DeltaEventData, ToolStartEventData, ToolDoneEventData, ApprovalRequiredEventData, ApprovalRequiredEventDataPending, CompletedEventData, ErrorEventData, ConductorEventName, ConductorEventDataMap, ApprovalDecision, ConductorEventHandler, CompletedResult, } from './types/index.js';
+export type { ToolCategory } from './tools.js';
+export { TOOL_CATEGORIES } from './tools.js';
+export type { PersonalityTier } from './personalities.js';
+export { PERSONALITY_TIERS } from './personalities.js';
+export { CAPABILITY_PATTERN, isCapability } from './capabilities.js';
+export type { ValidationResult } from './validate/index.js';
+export { EVENT_NAMES, EVENT_DATA_SCHEMAS, capabilitySchema, turnRequestSchema, resolveRequestSchema, resolveResultSchema, sseEventSchema, validateTurnRequest, validateResolveRequest, validateSseEvent, } from './validate/index.js';
+export type { ConductorClient, ConductorClientOptions, ConductorStreamOptions, } from './client/conductor-client.js';
+export { createConductorClient, ConductorClientError, parseSseFrames, } from './client/conductor-client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,gCAAgC,EAChC,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGrE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,GACf,MAAM,8BAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { TOOL_CATEGORIES } from './tools.js';
+export { PERSONALITY_TIERS } from './personalities.js';
+// Capability vocabulary
+export { CAPABILITY_PATTERN, isCapability } from './capabilities.js';
+export { EVENT_NAMES, EVENT_DATA_SCHEMAS, capabilitySchema, turnRequestSchema, resolveRequestSchema, resolveResultSchema, sseEventSchema, validateTurnRequest, validateResolveRequest, validateSseEvent, } from './validate/index.js';
+export { createConductorClient, ConductorClientError, parseSseFrames, } from './client/conductor-client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,wBAAwB;AACxB,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIrE,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,GACf,MAAM,8BAA8B,CAAC"}

package/dist/personalities.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Personality declaration types. Re-exported from the generated contract types.
+ * A personality is configuration (instructions + tier + allowlists), not a fork.
+ *
+ * @packageDocumentation
+ */
+export type { PersonalityDeclaration } from './generated/index.js';
+/** The service tiers a personality may run under. */
+export declare const PERSONALITY_TIERS: readonly ["fast", "deep", "local"];
+/** A personality's service tier. */
+export type PersonalityTier = (typeof PERSONALITY_TIERS)[number];
+//# sourceMappingURL=personalities.d.ts.map

package/dist/personalities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personalities.d.ts","sourceRoot":"","sources":["../src/personalities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,oCAAqC,CAAC;AAEpE,oCAAoC;AACpC,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/personalities.js

@@ -0,0 +1,9 @@
+/**
+ * Personality declaration types. Re-exported from the generated contract types.
+ * A personality is configuration (instructions + tier + allowlists), not a fork.
+ *
+ * @packageDocumentation
+ */
+/** The service tiers a personality may run under. */
+export const PERSONALITY_TIERS = ['fast', 'deep', 'local'];
+//# sourceMappingURL=personalities.js.map

package/dist/personalities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personalities.js","sourceRoot":"","sources":["../src/personalities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,qDAAqD;AACrD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tool declaration types. Re-exported from the generated contract types so
+ * tool authors and the runtime share one definition of a tool's shape and
+ * governance metadata (category, required capabilities, approval, idempotency).
+ *
+ * @packageDocumentation
+ */
+export type { ToolDeclaration } from './generated/index.js';
+/** The blast-radius categories a tool may declare. */
+export declare const TOOL_CATEGORIES: readonly ["read", "write", "destructive"];
+/** A tool's blast-radius category. */
+export type ToolCategory = (typeof TOOL_CATEGORIES)[number];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,sDAAsD;AACtD,eAAO,MAAM,eAAe,2CAA4C,CAAC;AAEzE,sCAAsC;AACtC,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/tools.js

@@ -0,0 +1,10 @@
+/**
+ * Tool declaration types. Re-exported from the generated contract types so
+ * tool authors and the runtime share one definition of a tool's shape and
+ * governance metadata (category, required capabilities, approval, idempotency).
+ *
+ * @packageDocumentation
+ */
+/** The blast-radius categories a tool may declare. */
+export const TOOL_CATEGORIES = ['read', 'write', 'destructive'];
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,sDAAsD;AACtD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAU,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Conductor wire types.
+ *
+ * The generated types (re-exported below) mirror the authoritative JSON Schema
+ * at platform/contracts/conductor/v1/. This module adds the few hand-written
+ * convenience types the client surfaces — none of which change the wire shape.
+ *
+ * @packageDocumentation
+ */
+export type { Capability, TurnRequest, ResolveRequest, ResolveResult, ToolDeclaration, PersonalityDeclaration, StartedEventData, DeltaEventData, ToolStartEventData, ToolDoneEventData, ApprovalRequiredEventData, ApprovalRequiredEventDataPending, CompletedEventData, ErrorEventData, ConductorEventName, ConductorEventDataMap, } from '../generated/index.js';
+import type { ConductorEventName, ConductorEventDataMap, CompletedEventData } from '../generated/index.js';
+/** The decision a caller may make on a pending approval. */
+export type ApprovalDecision = 'approve' | 'reject';
+/**
+ * Callback invoked for each parsed SSE frame. `data` is the event-specific
+ * payload (typed per name when the caller narrows on `name`).
+ */
+export type ConductorEventHandler = (name: ConductorEventName, data: ConductorEventDataMap[ConductorEventName]) => void;
+/**
+ * Result of the `turn()` convenience method: the `completed` event payload plus
+ * the assistant text accumulated from all `delta` events during the turn.
+ */
+export interface CompletedResult extends CompletedEventData {
+    /** Concatenation of every `delta` event's `text`, in arrival order. */
+    text: string;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,gCAAgC,EAChC,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,IAAI,EAAE,kBAAkB,EACxB,IAAI,EAAE,qBAAqB,CAAC,kBAAkB,CAAC,KAC5C,IAAI,CAAC;AAEV;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,kBAAkB;IACzD,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/types/index.js

@@ -0,0 +1,11 @@
+/**
+ * Conductor wire types.
+ *
+ * The generated types (re-exported below) mirror the authoritative JSON Schema
+ * at platform/contracts/conductor/v1/. This module adds the few hand-written
+ * convenience types the client surfaces — none of which change the wire shape.
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/validate/index.d.ts

@@ -0,0 +1,219 @@
+/**
+ * Runtime validation of the Conductor wire shapes (zod mirror of the JSON
+ * Schema).
+ *
+ * The JSON Schema under platform/contracts/conductor/v1/ is authoritative; this
+ * zod schema mirrors it for ergonomic in-process validation. Request envelopes
+ * and the SSE envelope are closed (`.strict()`); each event's `data` object is
+ * open (`.passthrough()`) so consumers ignore fields they don't know.
+ *
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+import type { TurnRequest, ResolveRequest } from '../generated/index.js';
+/** The frozen SSE event names, in contract order. */
+export declare const EVENT_NAMES: readonly ["started", "delta", "tool_start", "tool_done", "approval_required", "completed", "error", "routed"];
+/** The capability string pattern, mirroring capability.schema.json. */
+export declare const capabilitySchema: z.ZodString;
+export declare const turnRequestSchema: z.ZodObject<{
+    personality_id: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    prompt: string;
+    personality_id?: string | undefined;
+}, {
+    prompt: string;
+    personality_id?: string | undefined;
+}>;
+export declare const resolveRequestSchema: z.ZodObject<{
+    decision: z.ZodEnum<["approve", "reject"]>;
+}, "strict", z.ZodTypeAny, {
+    decision: "approve" | "reject";
+}, {
+    decision: "approve" | "reject";
+}>;
+export declare const resolveResultSchema: z.ZodObject<{
+    approval_id: z.ZodString;
+    status: z.ZodString;
+    tool: z.ZodString;
+    result: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    outcome: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    status: string;
+    approval_id: string;
+    tool: string;
+    result: Record<string, unknown> | null;
+    outcome: string;
+}, {
+    status: string;
+    approval_id: string;
+    tool: string;
+    result: Record<string, unknown> | null;
+    outcome: string;
+}>;
+/** data payload schema keyed by event name. */
+export declare const EVENT_DATA_SCHEMAS: {
+    readonly started: z.ZodObject<{
+        turn_id: z.ZodString;
+        personality: z.ZodString;
+        tier: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        turn_id: z.ZodString;
+        personality: z.ZodString;
+        tier: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        turn_id: z.ZodString;
+        personality: z.ZodString;
+        tier: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>;
+    readonly delta: z.ZodObject<{
+        text: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        text: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        text: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>;
+    readonly tool_start: z.ZodObject<{
+        tool: z.ZodString;
+        status: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        tool: z.ZodString;
+        status: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        tool: z.ZodString;
+        status: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    readonly tool_done: z.ZodObject<{
+        tool: z.ZodString;
+        status: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        tool: z.ZodString;
+        status: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        tool: z.ZodString;
+        status: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    readonly approval_required: z.ZodObject<{
+        turn_id: z.ZodString;
+        approval_id: z.ZodString;
+        pending: z.ZodObject<{
+            tool_call_id: z.ZodString;
+            tool: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            tool_call_id: z.ZodString;
+            tool: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            tool_call_id: z.ZodString;
+            tool: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        turn_id: z.ZodString;
+        approval_id: z.ZodString;
+        pending: z.ZodObject<{
+            tool_call_id: z.ZodString;
+            tool: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            tool_call_id: z.ZodString;
+            tool: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            tool_call_id: z.ZodString;
+            tool: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        turn_id: z.ZodString;
+        approval_id: z.ZodString;
+        pending: z.ZodObject<{
+            tool_call_id: z.ZodString;
+            tool: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            tool_call_id: z.ZodString;
+            tool: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            tool_call_id: z.ZodString;
+            tool: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>;
+    }, z.ZodTypeAny, "passthrough">>;
+    readonly completed: z.ZodObject<{
+        turn_id: z.ZodString;
+        calls: z.ZodNumber;
+        tool_calls: z.ZodNumber;
+        input_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        cost_usd: z.ZodNumber;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        turn_id: z.ZodString;
+        calls: z.ZodNumber;
+        tool_calls: z.ZodNumber;
+        input_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        cost_usd: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        turn_id: z.ZodString;
+        calls: z.ZodNumber;
+        tool_calls: z.ZodNumber;
+        input_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        cost_usd: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">>;
+    readonly error: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>;
+    readonly routed: z.ZodObject<{
+        kind: z.ZodEnum<["navigation", "action"]>;
+        target: z.ZodString;
+        mode: z.ZodEnum<["navigate", "open-view", "load-source"]>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        correlation_id: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        kind: z.ZodEnum<["navigation", "action"]>;
+        target: z.ZodString;
+        mode: z.ZodEnum<["navigate", "open-view", "load-source"]>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        correlation_id: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        kind: z.ZodEnum<["navigation", "action"]>;
+        target: z.ZodString;
+        mode: z.ZodEnum<["navigate", "open-view", "load-source"]>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        correlation_id: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+};
+/** The SSE envelope: a frozen event name plus its matching data payload. */
+export declare const sseEventSchema: z.ZodObject<{
+    event: z.ZodEnum<["started", "delta", "tool_start", "tool_done", "approval_required", "completed", "error", "routed"]>;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strict", z.ZodTypeAny, {
+    event: "started" | "delta" | "tool_start" | "tool_done" | "approval_required" | "completed" | "error" | "routed";
+    data: Record<string, unknown>;
+}, {
+    event: "started" | "delta" | "tool_start" | "tool_done" | "approval_required" | "completed" | "error" | "routed";
+    data: Record<string, unknown>;
+}>;
+export interface ValidationResult<T> {
+    ok: boolean;
+    data?: T;
+    errors?: string[];
+}
+/** Validate an unknown value as a TurnRequest. */
+export declare function validateTurnRequest(input: unknown): ValidationResult<TurnRequest>;
+/** Validate an unknown value as a ResolveRequest. */
+export declare function validateResolveRequest(input: unknown): ValidationResult<ResolveRequest>;
+/**
+ * Validate an SSE event's name + data. Returns ok=false when the name is not in
+ * the frozen set or the data does not match that event's payload schema.
+ */
+export declare function validateSseEvent(name: string, data: unknown): ValidationResult<unknown>;
+//# sourceMappingURL=index.d.ts.map

package/dist/validate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validate/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EAEf,MAAM,uBAAuB,CAAC;AAE/B,qDAAqD;AACrD,eAAO,MAAM,WAAW,+GASd,CAAC;AAEX,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,aAAyC,CAAC;AAEvE,eAAO,MAAM,iBAAiB;;;;;;;;;EAKnB,CAAC;AAEZ,eAAO,MAAM,oBAAoB;;;;;;EAItB,CAAC;AAEZ,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAQrB,CAAC;AAmDZ,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CASrB,CAAC;AAEX,4EAA4E;AAC5E,eAAO,MAAM,cAAc;;;;;;;;;EAKhB,CAAC;AAEZ,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAUD,kDAAkD;AAClD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAEjF;AAED,qDAAqD;AACrD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAIvF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAMvF"}