@relayflows/sdk 2.0.44 → 2.0.46

package/dist/flow-tool-adapters.js

@@ -0,0 +1,42 @@
+import { canonicalize } from './canonical.js';
+import { flowToolFunctionDefinition } from './flow-tool-definitions.js';
+import { FLOW_TOOL_RUN_SCHEMA } from './flow-tool-contract.js';
+import { parseFlowToolEntry } from './flow-tool-wire.js';
+/**
+ * One selected, authorized revision; no alternate execution path. Host/session
+ * code supplies stable operation metadata separately from model tool arguments.
+ * Register only after discovery with this same authenticated client. The server
+ * MUST reauthorize; possession of this object is not an authorization token.
+ */
+export function createFlowToolAdapters(client, selected) {
+    const entry = parseFlowToolEntry(selected);
+    const invoke = (input, operation) => client.invoke(entry, input, operation);
+    return Object.freeze({
+        native: Object.freeze({ definition: flowToolFunctionDefinition(entry.manifest), call: invoke }),
+        mcp: Object.freeze({
+            // Do not reuse the legacy business-result-only metadata descriptor here:
+            // tools/call returns an async run envelope, not the eventual result object.
+            definition: Object.freeze({
+                name: entry.manifest.name, description: entry.manifest.description,
+                inputSchema: entry.manifest.inputSchema, outputSchema: FLOW_TOOL_RUN_SCHEMA,
+            }),
+            async call(input, operation) {
+                const run = await invoke(input, operation);
+                return {
+                    structuredContent: Object.freeze({ ...run }),
+                    content: [{ type: 'text', text: canonicalize(run) }],
+                };
+            },
+        }),
+        // Relay action registration can use this schema/handler. An action dispatch
+        // acknowledgment is not this return value and must never become completion.
+        action: Object.freeze({
+            definition: Object.freeze({
+                name: entry.manifest.name, description: entry.manifest.description,
+                inputSchema: entry.manifest.inputSchema, outputSchema: FLOW_TOOL_RUN_SCHEMA,
+            }),
+            invoke,
+        }),
+    });
+}
+//# sourceMappingURL=flow-tool-adapters.js.map

package/dist/flow-tool-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-tool-adapters.js","sourceRoot":"","sources":["../src/flow-tool-adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAA+B,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAsB,EAAE,QAAgC;IAC7F,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,SAAoC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAChH,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,0BAA0B,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC/F,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC;YACjB,yEAAyE;YACzE,4EAA4E;YAC5E,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;gBACxB,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW;gBAClE,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,EAAE,oBAAoB;aAC5E,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,KAAc,EAAE,SAAoC;gBAC7D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBAC3C,OAAO;oBACL,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;oBAC5C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;iBAC9D,CAAC;YACJ,CAAC;SACF,CAAC;QACF,4EAA4E;QAC5E,4EAA4E;QAC5E,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;gBACxB,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW;gBAClE,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,EAAE,oBAAoB;aAC5E,CAAC;YACF,MAAM;SACP,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/flow-tool-client.d.ts

@@ -0,0 +1,38 @@
+import { type FlowToolCatalogEntryV1, type FlowToolRunV1, type FlowToolEventV1 } from './flow-tool-contract.js';
+export interface FlowToolRequest {
+    readonly method: 'GET' | 'POST';
+    readonly path: string;
+    readonly body?: unknown;
+    readonly idempotencyKey?: string;
+}
+/**
+ * Authenticated control-plane boundary. Implementations must authorize every
+ * operation and durably admit/deduplicate runs; the client owns no run ledger.
+ * A test transport is not a hosted implementation. No source-submission fallback.
+ */
+export interface FlowToolTransport {
+    request(request: FlowToolRequest): Promise<unknown>;
+    events(path: string, after: number): AsyncIterable<unknown>;
+}
+export interface FlowToolInvocationOptions {
+    /** Host-owned operation identity; preserve across reconnect/retry, never generate per retry. */
+    readonly idempotencyKey: string;
+    readonly mode?: 'async' | 'sync';
+    /** Server-side observation bound only, not an execution timeout or cancellation. */
+    readonly waitMs?: number;
+}
+export declare function flowToolOperationKey(value: unknown): asserts value is string;
+export declare class FlowToolClient {
+    private readonly transport;
+    constructor(transport: FlowToolTransport);
+    discover(): Promise<import("./flow-tool-contract.js").FlowToolCatalogV1>;
+    invoke(selected: FlowToolCatalogEntryV1, input: unknown, options: FlowToolInvocationOptions): Promise<FlowToolRunV1>;
+    status(selected: FlowToolCatalogEntryV1, receipt: FlowToolRunV1): Promise<FlowToolRunV1>;
+    events(selected: FlowToolCatalogEntryV1, receipt: FlowToolRunV1, after?: number): AsyncIterable<FlowToolEventV1>;
+    evidence(selected: FlowToolCatalogEntryV1, receipt: FlowToolRunV1): Promise<import("./flow-tool-contract.js").FlowToolEvidenceV1>;
+    cancel(selected: FlowToolCatalogEntryV1, receipt: FlowToolRunV1, key: string): Promise<FlowToolRunV1>;
+    resume(selected: FlowToolCatalogEntryV1, receipt: FlowToolRunV1, key: string): Promise<FlowToolRunV1>;
+    answer(selected: FlowToolCatalogEntryV1, receipt: FlowToolRunV1, waitId: string, approved: boolean, key: string): Promise<FlowToolRunV1>;
+    private command;
+}
+//# sourceMappingURL=flow-tool-client.d.ts.map

package/dist/flow-tool-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-tool-client.d.ts","sourceRoot":"","sources":["../src/flow-tool-client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,sBAAsB,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG/H,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AACD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;CAC7D;AACD,MAAM,WAAW,yBAAyB;IACxC,gGAAgG;IAChG,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC,oFAAoF;IACpF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AACD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAE5E;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,iBAAiB;IAEnD,QAAQ;IAIR,MAAM,CAAC,QAAQ,EAAE,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IAwBpH,MAAM,CAAC,QAAQ,EAAE,sBAAsB,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAKvF,MAAM,CAAC,QAAQ,EAAE,sBAAsB,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,SAAI,GAAG,aAAa,CAAC,eAAe,CAAC;IAY5G,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,EAAE,OAAO,EAAE,aAAa;IAcvE,MAAM,CAAC,QAAQ,EAAE,sBAAsB,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM;IAG5E,MAAM,CAAC,QAAQ,EAAE,sBAAsB,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM;IAG5E,MAAM,CAAC,QAAQ,EAAE,sBAAsB,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM;YAMjG,OAAO;CAOtB"}

package/dist/flow-tool-client.js

@@ -0,0 +1,105 @@
+import { canonicalize } from './canonical.js';
+import { snapshotJsonValue } from './json-value.js';
+import { FLOW_TOOL_LIMITS } from './flow-tool-schema.js';
+import { validateFlowToolInput } from './flow-tool-manifest.js';
+import { FlowToolError } from './flow-tool-contract.js';
+import { parseFlowToolCatalog, parseFlowToolEntry, parseFlowToolRun, parseFlowToolEvent, parseFlowToolEvidence, flowToolInputDigest, toolId } from './flow-tool-wire.js';
+export function flowToolOperationKey(value) {
+    if (typeof value !== 'string' || !/^[A-Za-z0-9_-][A-Za-z0-9_.:-]{0,127}$/.test(value))
+        throw new FlowToolError('invalid_contract');
+}
+export class FlowToolClient {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async discover() {
+        return parseFlowToolCatalog(await this.transport.request({ method: 'GET', path: '/api/v1/flow-tools' }));
+    }
+    async invoke(selected, input, options) {
+        const entry = parseFlowToolEntry(selected);
+        // Schema validation precedes ALL transport calls, including credential access.
+        let validated;
+        try {
+            validated = validateFlowToolInput(entry.manifest, input);
+        }
+        catch {
+            throw new FlowToolError('invalid_contract');
+        }
+        flowToolOperationKey(options.idempotencyKey);
+        const mode = options.mode ?? 'async';
+        const waitMs = options.waitMs ?? 0;
+        if (!['async', 'sync'].includes(mode) || !Number.isSafeInteger(waitMs) || waitMs < 0 || waitMs > 25_000
+            || (mode === 'async' && waitMs !== 0))
+            throw new FlowToolError('invalid_contract');
+        const inputDigest = flowToolInputDigest(validated);
+        const body = {
+            api_version: 1, flow: `${entry.manifest.flow.name}@${entry.manifest.flow.digest}`,
+            deployment_id: entry.deployment_id, manifest_digest: entry.manifest.digest,
+            input: validated, input_digest: inputDigest, mode, wait_ms: waitMs,
+        };
+        const run = parseFlowToolRun(await this.transport.request({
+            method: 'POST', path: `/api/v1/flow-tools/${entry.manifest.name}/invoke`, body, idempotencyKey: options.idempotencyKey,
+        }), entry);
+        if (run.input_digest !== inputDigest)
+            throw new FlowToolError('invalid_contract');
+        return run;
+    }
+    async status(selected, receipt) {
+        const entry = parseFlowToolEntry(selected), run = parseFlowToolRun(receipt, entry);
+        return parseFlowToolRun(await this.transport.request({ method: 'GET', path: run.status_url }), entry, run);
+    }
+    async *events(selected, receipt, after = 0) {
+        const run = parseFlowToolRun(receipt, parseFlowToolEntry(selected));
+        if (!Number.isSafeInteger(after) || after < 0)
+            throw new FlowToolError('invalid_contract');
+        let cursor = after;
+        for await (const raw of this.transport.events(run.events_url, after)) {
+            const event = parseFlowToolEvent(raw, run, cursor);
+            cursor = event.sequence;
+            yield event;
+            if (event.type === 'run.terminal')
+                return;
+        }
+    }
+    async evidence(selected, receipt) {
+        const run = parseFlowToolRun(receipt, parseFlowToolEntry(selected));
+        const response = await this.transport.request({ method: 'GET', path: run.evidence_url });
+        let raw;
+        try {
+            raw = snapshotJsonValue(response, 'flow tool evidence', FLOW_TOOL_LIMITS);
+        }
+        catch {
+            throw new FlowToolError('invalid_contract');
+        }
+        if (raw === null || typeof raw !== 'object' || Array.isArray(raw)
+            || Object.keys(raw).sort().join(',') !== 'api_version,evidence,run_id'
+            || raw.api_version !== 1 || raw.run_id !== run.run_id)
+            throw new FlowToolError('invalid_contract');
+        const evidence = parseFlowToolEvidence(raw.evidence, run.flow_digest);
+        if (run.terminal !== null && canonicalize(evidence) !== canonicalize(run.terminal.evidence))
+            throw new FlowToolError('invalid_contract');
+        return evidence;
+    }
+    cancel(selected, receipt, key) {
+        return this.command(selected, receipt, '/cancel', key, { api_version: 1 });
+    }
+    resume(selected, receipt, key) {
+        return this.command(selected, receipt, '/resume', key, { api_version: 1 });
+    }
+    answer(selected, receipt, waitId, approved, key) {
+        toolId(waitId);
+        if (typeof approved !== 'boolean')
+            throw new FlowToolError('invalid_contract');
+        // No answered_by claim: the server derives/audits the authenticated human actor.
+        return this.command(selected, receipt, `/human/${waitId}/answer`, key, { api_version: 1, input: { approved } });
+    }
+    async command(selected, receipt, suffix, key, body) {
+        const entry = parseFlowToolEntry(selected), run = parseFlowToolRun(receipt, entry);
+        flowToolOperationKey(key);
+        return parseFlowToolRun(await this.transport.request({
+            method: 'POST', path: `${run.status_url}${suffix}`, idempotencyKey: key, body,
+        }), entry, run);
+    }
+}
+//# sourceMappingURL=flow-tool-client.js.map

package/dist/flow-tool-client.js.map

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

package/dist/flow-tool-contract.d.ts

@@ -0,0 +1,103 @@
+import type { FlowToolDigest, FlowToolManifestV1 } from './flow-tool-manifest.js';
+import type { FlowToolJson, FlowToolObjectSchema } from './flow-tool-schema.js';
+import type { Spend } from './run-state.js';
+export declare const FLOW_TOOL_API_VERSION: 1;
+export declare const FLOW_TOOL_TERMINAL_REASONS: readonly ["success", "gate_failed", "model_failed", "agent_failed", "budget_exceeded", "human_rejected", "human_timeout", "canceled", "execution_failed"];
+export type FlowToolTerminalReason = typeof FLOW_TOOL_TERMINAL_REASONS[number];
+export type FlowToolRunState = 'accepted' | 'running' | 'parked' | 'cancelling' | 'completed' | 'failed' | 'cancelled';
+/** Operator-owned, server-authorized read-only revision; never generated from run input. */
+export interface FlowToolCatalogEntryV1 {
+    readonly manifest: FlowToolManifestV1;
+    readonly deployment_id: string;
+    readonly read_only: true;
+    readonly effects: readonly string[];
+    readonly requires_human: readonly string[];
+    readonly business_verdicts: readonly string[];
+    readonly budget: Readonly<{
+        max_tokens: number;
+        max_dollars: string | null;
+        max_wallclock_ms: number;
+    }>;
+}
+export interface FlowToolCatalogV1 {
+    readonly api_version: 1;
+    readonly tools: readonly FlowToolCatalogEntryV1[];
+}
+export interface FlowToolEvidenceV1 {
+    readonly journal_digest: FlowToolDigest;
+    readonly flow_digest: FlowToolDigest;
+    readonly artifacts: readonly Readonly<{
+        name: string;
+        ref: string;
+        media_type: string;
+    }>[];
+    readonly redacted_transcript_refs: readonly string[];
+}
+export interface FlowToolTerminalV1 {
+    readonly terminal_reason: FlowToolTerminalReason;
+    readonly business_verdict: string | null;
+    readonly result: Readonly<Record<string, FlowToolJson>> | null;
+    readonly gates: readonly Readonly<{
+        name: string;
+        status: 'pass' | 'fail' | 'skipped';
+        evidence_ref: string;
+    }>[];
+    readonly evidence: FlowToolEvidenceV1;
+    readonly spend: Readonly<Spend>;
+}
+/** Accepted is durable admission, never successful execution; terminal is null until finished. */
+export interface FlowToolRunV1 {
+    readonly api_version: 1;
+    readonly accepted: true;
+    readonly run_id: string;
+    readonly tool_name: string;
+    readonly deployment_id: string;
+    readonly manifest_digest: FlowToolDigest;
+    readonly flow_digest: FlowToolDigest;
+    readonly input_digest: FlowToolDigest;
+    readonly state: FlowToolRunState;
+    readonly sequence: number;
+    readonly status_url: string;
+    readonly events_url: string;
+    readonly evidence_url: string;
+    readonly cancel_url: string;
+    readonly resume_url: string;
+    readonly terminal: FlowToolTerminalV1 | null;
+}
+export interface FlowToolEventV1 {
+    readonly api_version: 1;
+    readonly run_id: string;
+    readonly flow_digest: FlowToolDigest;
+    readonly sequence: number;
+    readonly type: 'run.accepted' | 'run.state_changed' | 'step.completed' | 'human.required' | 'run.terminal';
+    readonly state: FlowToolRunState;
+    readonly step_id?: string;
+    readonly wait_id?: string;
+    readonly terminal_reason?: FlowToolTerminalReason;
+}
+export interface FlowToolInvokeRequestV1 {
+    readonly api_version: 1;
+    readonly flow: string;
+    readonly deployment_id: string;
+    readonly manifest_digest: FlowToolDigest;
+    readonly input: Readonly<Record<string, FlowToolJson>>;
+    /** Assertion only: admission MUST recompute this from schema-validated canonical input. */
+    readonly input_digest: FlowToolDigest;
+    readonly mode: 'async' | 'sync';
+    readonly wait_ms: number;
+}
+export type FlowToolFailureCode = 'invalid_contract' | 'not_authorized' | 'not_found' | 'idempotency_conflict' | 'unsupported' | 'unavailable' | 'transport_error';
+export declare class FlowToolError extends Error {
+    readonly code: FlowToolFailureCode;
+    constructor(code: FlowToolFailureCode);
+}
+export declare const FLOW_TOOL_EVIDENCE_SCHEMA: FlowToolObjectSchema;
+/** Async adapters return this envelope, NOT the flow's eventual business-result schema. */
+export declare const FLOW_TOOL_RUN_SCHEMA: FlowToolObjectSchema;
+export declare const FLOW_TOOL_CATALOG_SCHEMA: FlowToolObjectSchema;
+export declare const FLOW_TOOL_EVENT_SCHEMA: FlowToolObjectSchema;
+export declare const FLOW_TOOL_INVOKE_SCHEMA: FlowToolObjectSchema;
+export declare const FLOW_TOOL_COMMAND_SCHEMA: FlowToolObjectSchema;
+export declare const FLOW_TOOL_ANSWER_SCHEMA: FlowToolObjectSchema;
+export declare const FLOW_TOOL_ERROR_SCHEMA: FlowToolObjectSchema;
+//# sourceMappingURL=flow-tool-contract.d.ts.map

package/dist/flow-tool-contract.d.ts.map

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

package/dist/flow-tool-contract.js

@@ -0,0 +1,75 @@
+import { snapshotJsonValue } from './json-value.js';
+import { FLOW_TOOL_LIMITS } from './flow-tool-schema.js';
+export const FLOW_TOOL_API_VERSION = 1;
+export const FLOW_TOOL_TERMINAL_REASONS = [
+    'success', 'gate_failed', 'model_failed', 'agent_failed', 'budget_exceeded',
+    'human_rejected', 'human_timeout', 'canceled', 'execution_failed',
+];
+export class FlowToolError extends Error {
+    code;
+    constructor(code) {
+        // Never interpolate remote bodies, model input, bearer tokens or transport errors.
+        super(`Flow Tool ${code}${code === 'transport_error' ? ': admission or command outcome may be unknown; observation failure does not cancel a run' : ''}`);
+        this.code = code;
+        this.name = 'FlowToolError';
+    }
+}
+const text = { type: 'string', minLength: 1, maxLength: 128 };
+const digest = { type: 'string', minLength: 71, maxLength: 71 };
+const integer = { type: 'integer', minimum: 0, maximum: Number.MAX_SAFE_INTEGER };
+const positive = { ...integer, minimum: 1 };
+const strings = { type: 'array', items: text, maxItems: 64, uniqueItems: true };
+const state = { enum: ['accepted', 'running', 'parked', 'cancelling', 'completed', 'failed', 'cancelled'] };
+function object(properties, required = Object.keys(properties)) {
+    return snapshotJsonValue({ type: 'object', properties, required, additionalProperties: false }, 'flow tool protocol schema', FLOW_TOOL_LIMITS);
+}
+export const FLOW_TOOL_EVIDENCE_SCHEMA = object({
+    journal_digest: digest, flow_digest: digest,
+    artifacts: { type: 'array', maxItems: 128, items: object({ name: text, ref: text, media_type: text }) },
+    redacted_transcript_refs: strings,
+});
+const terminal = object({
+    terminal_reason: { enum: FLOW_TOOL_TERMINAL_REASONS },
+    business_verdict: { type: ['string', 'null'], minLength: 1, maxLength: 128 },
+    result: { type: ['object', 'null'] },
+    gates: { type: 'array', maxItems: 128, items: object({ name: text, status: { enum: ['pass', 'fail', 'skipped'] }, evidence_ref: text }) },
+    evidence: FLOW_TOOL_EVIDENCE_SCHEMA,
+    spend: object({ tokens_in: integer, tokens_out: integer, dollars: text, dollars_unmetered: { type: 'boolean' } }),
+});
+/** Async adapters return this envelope, NOT the flow's eventual business-result schema. */
+export const FLOW_TOOL_RUN_SCHEMA = object({
+    api_version: { const: 1 }, accepted: { const: true }, run_id: text, tool_name: text,
+    deployment_id: text, manifest_digest: digest, flow_digest: digest, input_digest: digest,
+    state, sequence: integer,
+    status_url: { type: 'string' }, events_url: { type: 'string' }, evidence_url: { type: 'string' },
+    cancel_url: { type: 'string' }, resume_url: { type: 'string' },
+    terminal: { anyOf: [{ type: 'null' }, terminal] },
+});
+export const FLOW_TOOL_CATALOG_SCHEMA = object({
+    api_version: { const: 1 },
+    tools: { type: 'array', maxItems: 64, items: object({
+            manifest: { type: 'object' }, deployment_id: text, read_only: { const: true },
+            effects: strings, requires_human: strings,
+            business_verdicts: { ...strings, minItems: 1 },
+            budget: object({ max_tokens: positive, max_dollars: { type: ['string', 'null'] }, max_wallclock_ms: positive }),
+        }) },
+});
+export const FLOW_TOOL_EVENT_SCHEMA = object({
+    api_version: { const: 1 }, run_id: text, flow_digest: digest, sequence: positive,
+    type: { enum: ['run.accepted', 'run.state_changed', 'step.completed', 'human.required', 'run.terminal'] },
+    state, step_id: text, wait_id: text, terminal_reason: { enum: FLOW_TOOL_TERMINAL_REASONS },
+}, ['api_version', 'run_id', 'flow_digest', 'sequence', 'type', 'state']);
+export const FLOW_TOOL_INVOKE_SCHEMA = object({
+    api_version: { const: 1 }, flow: { type: 'string', minLength: 73, maxLength: 200 },
+    deployment_id: text, manifest_digest: digest, input_digest: digest,
+    input: { type: 'object' }, mode: { enum: ['async', 'sync'] },
+    wait_ms: { type: 'integer', minimum: 0, maximum: 25000 },
+});
+export const FLOW_TOOL_COMMAND_SCHEMA = object({ api_version: { const: 1 } });
+export const FLOW_TOOL_ANSWER_SCHEMA = object({
+    api_version: { const: 1 }, input: object({ approved: { type: 'boolean' } }),
+});
+export const FLOW_TOOL_ERROR_SCHEMA = object({
+    api_version: { const: 1 }, code: { enum: ['invalid_contract', 'not_authorized', 'not_found', 'idempotency_conflict', 'unsupported', 'unavailable'] },
+});
+//# sourceMappingURL=flow-tool-contract.js.map

package/dist/flow-tool-contract.js.map

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

package/dist/flow-tool-definitions.d.ts

@@ -0,0 +1,19 @@
+import { type FlowToolManifestV1 } from './flow-tool-manifest.js';
+import type { FlowToolObjectSchema } from './flow-tool-schema.js';
+export interface FlowToolFunctionDefinition {
+    readonly type: 'function';
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: FlowToolObjectSchema;
+}
+export interface FlowToolMcpDefinition {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: FlowToolObjectSchema;
+    readonly outputSchema: FlowToolObjectSchema;
+}
+/** Plain function-call descriptor. Provider-specific strict-mode translation is not implied. */
+export declare function flowToolFunctionDefinition(value: FlowToolManifestV1): FlowToolFunctionDefinition;
+/** MCP tools/list metadata only: no server, call handler, authority, or idempotency claim. */
+export declare function flowToolMcpDefinition(value: FlowToolManifestV1): FlowToolMcpDefinition;
+//# sourceMappingURL=flow-tool-definitions.d.ts.map

package/dist/flow-tool-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-tool-definitions.d.ts","sourceRoot":"","sources":["../src/flow-tool-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;CAC3C;AACD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;CAC7C;AAED,gGAAgG;AAChG,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,kBAAkB,GAAG,0BAA0B,CAGhG;AAED,8FAA8F;AAC9F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,qBAAqB,CAGtF"}

package/dist/flow-tool-definitions.js

@@ -0,0 +1,12 @@
+import { parseFlowToolManifest } from './flow-tool-manifest.js';
+/** Plain function-call descriptor. Provider-specific strict-mode translation is not implied. */
+export function flowToolFunctionDefinition(value) {
+    const manifest = parseFlowToolManifest(value);
+    return Object.freeze({ type: 'function', name: manifest.name, description: manifest.description, parameters: manifest.inputSchema });
+}
+/** MCP tools/list metadata only: no server, call handler, authority, or idempotency claim. */
+export function flowToolMcpDefinition(value) {
+    const manifest = parseFlowToolManifest(value);
+    return Object.freeze({ name: manifest.name, description: manifest.description, inputSchema: manifest.inputSchema, outputSchema: manifest.resultSchema });
+}
+//# sourceMappingURL=flow-tool-definitions.js.map

package/dist/flow-tool-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-tool-definitions.js","sourceRoot":"","sources":["../src/flow-tool-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAA2B,MAAM,yBAAyB,CAAC;AAgBzF,gGAAgG;AAChG,MAAM,UAAU,0BAA0B,CAAC,KAAyB;IAClE,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;AACvI,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,qBAAqB,CAAC,KAAyB;IAC7D,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;AAC3J,CAAC"}

package/dist/flow-tool-http.d.ts

@@ -0,0 +1,14 @@
+import { type FlowToolTransport } from './flow-tool-client.js';
+export interface FlowToolHttpOptions {
+    /** Explicit trusted HTTPS API origin/base path. No implicit production endpoint. */
+    readonly apiUrl: string;
+    /** Dedicated scoped bearer; never included in definitions, bodies, errors or persisted state. */
+    readonly token: string;
+    readonly requestTimeoutMs?: number;
+    readonly signal?: AbortSignal;
+    /** Test/integration seam; the default is the standard fetch implementation. */
+    readonly fetch?: typeof fetch;
+}
+/** No automatic retry; the owner can repeat the same operation key after an ambiguous failure. */
+export declare function createFlowToolHttpTransport(options: FlowToolHttpOptions): FlowToolTransport;
+//# sourceMappingURL=flow-tool-http.d.ts.map

package/dist/flow-tool-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-tool-http.d.ts","sourceRoot":"","sources":["../src/flow-tool-http.ts"],"names":[],"mappings":"AAGA,OAAO,EAA8C,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG3G,MAAM,WAAW,mBAAmB;IAClC,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iGAAiG;IACjG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CAC/B;AA+BD,kGAAkG;AAClG,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,mBAAmB,GAAG,iBAAiB,CA+D3F"}