footprintjs 0.2.2 → 0.3.0

package/dist/esm/types/lib/builder/FlowChartBuilder.d.ts

@@ -28,13 +28,12 @@ export declare class DeciderList<TOut = any, TScope = any> {
     private readonly deciderDescription?;
     private readonly branchDescInfo;
     constructor(builder: FlowChartBuilder<TOut, TScope>, curNode: StageNode<TOut, TScope>, curSpec: SerializedPipelineStructure, parentDescriptionParts?: string[], parentStageDescriptions?: Map<string, string>, reservedStepNumber?: number, deciderDescription?: string);
-    addFunctionBranch(id: string, name: string, fn?: PipelineStageFunction<TOut, TScope>, displayName?: string, description?: string): DeciderList<TOut, TScope>;
+    addFunctionBranch(id: string, name: string, fn?: PipelineStageFunction<TOut, TScope>, description?: string): DeciderList<TOut, TScope>;
     addSubFlowChartBranch(id: string, subflow: FlowChart<TOut, TScope>, mountName?: string, options?: SubflowMountOptions): DeciderList<TOut, TScope>;
     addBranchList(branches: Array<{
         id: string;
         name: string;
         fn?: PipelineStageFunction<TOut, TScope>;
-        displayName?: string;
     }>): DeciderList<TOut, TScope>;
     setDefault(id: string): DeciderList<TOut, TScope>;
     end(): FlowChartBuilder<TOut, TScope>;
@@ -50,13 +49,12 @@ export declare class SelectorFnList<TOut = any, TScope = any> {
     private readonly selectorDescription?;
     private readonly branchDescInfo;
     constructor(builder: FlowChartBuilder<TOut, TScope>, curNode: StageNode<TOut, TScope>, curSpec: SerializedPipelineStructure, parentDescriptionParts?: string[], parentStageDescriptions?: Map<string, string>, reservedStepNumber?: number, selectorDescription?: string);
-    addFunctionBranch(id: string, name: string, fn?: PipelineStageFunction<TOut, TScope>, displayName?: string, description?: string): SelectorFnList<TOut, TScope>;
+    addFunctionBranch(id: string, name: string, fn?: PipelineStageFunction<TOut, TScope>, description?: string): SelectorFnList<TOut, TScope>;
     addSubFlowChartBranch(id: string, subflow: FlowChart<TOut, TScope>, mountName?: string, options?: SubflowMountOptions): SelectorFnList<TOut, TScope>;
     addBranchList(branches: Array<{
         id: string;
         name: string;
         fn?: PipelineStageFunction<TOut, TScope>;
-        displayName?: string;
     }>): SelectorFnList<TOut, TScope>;
     end(): FlowChartBuilder<TOut, TScope>;
 }
@@ -79,16 +77,25 @@ export declare class FlowChartBuilder<TOut = any, TScope = any> {
     private _stepCounter;
     private _stageDescriptions;
     private _stageStepMap;
+    private _inputSchema?;
+    private _outputSchema?;
+    private _outputMapper?;
     constructor(buildTimeExtractor?: BuildTimeExtractor<any>);
     private _appendDescriptionLine;
     private _appendSubflowDescription;
     setEnableNarrative(): this;
     setLogger(logger: ILogger): this;
-    start(name: string, fn?: PipelineStageFunction<TOut, TScope>, id?: string, displayName?: string, description?: string): this;
-    addFunction(name: string, fn?: PipelineStageFunction<TOut, TScope>, id?: string, displayName?: string, description?: string): this;
-    addStreamingFunction(name: string, streamId?: string, fn?: PipelineStageFunction<TOut, TScope>, id?: string, displayName?: string, description?: string): this;
-    addDeciderFunction(name: string, fn: PipelineStageFunction<TOut, TScope>, id?: string, displayName?: string, description?: string): DeciderList<TOut, TScope>;
-    addSelectorFunction(name: string, fn: PipelineStageFunction<TOut, TScope>, id?: string, displayName?: string, description?: string): SelectorFnList<TOut, TScope>;
+    /** Declare the input schema (readOnlyContext shape). Accepts Zod schema or JSON Schema. */
+    setInputSchema(schema: unknown): this;
+    /** Declare the output schema (response shape). Accepts Zod schema or JSON Schema. */
+    setOutputSchema(schema: unknown): this;
+    /** Set the output mapper that extracts the response from final scope. */
+    setOutputMapper(mapper: (finalScope: Record<string, unknown>) => unknown): this;
+    start(name: string, fn?: PipelineStageFunction<TOut, TScope>, id?: string, description?: string): this;
+    addFunction(name: string, fn?: PipelineStageFunction<TOut, TScope>, id?: string, description?: string): this;
+    addStreamingFunction(name: string, streamId?: string, fn?: PipelineStageFunction<TOut, TScope>, id?: string, description?: string): this;
+    addDeciderFunction(name: string, fn: PipelineStageFunction<TOut, TScope>, id?: string, description?: string): DeciderList<TOut, TScope>;
+    addSelectorFunction(name: string, fn: PipelineStageFunction<TOut, TScope>, id?: string, description?: string): SelectorFnList<TOut, TScope>;
     addListOfFunction(children: SimplifiedParallelSpec<TOut, TScope>[], options?: {
         failFast?: boolean;
     }): this;
@@ -117,5 +124,5 @@ export declare class FlowChartBuilder<TOut = any, TScope = any> {
         root: StageNode<TOut, TScope>;
     }> | undefined, prefix: string): void;
 }
-export declare function flowChart<TOut = any, TScope = any>(name: string, fn?: PipelineStageFunction<TOut, TScope>, id?: string, displayName?: string, buildTimeExtractor?: BuildTimeExtractor<any>, description?: string): FlowChartBuilder<TOut, TScope>;
+export declare function flowChart<TOut = any, TScope = any>(name: string, fn?: PipelineStageFunction<TOut, TScope>, id?: string, buildTimeExtractor?: BuildTimeExtractor<any>, description?: string): FlowChartBuilder<TOut, TScope>;
 export declare function specToStageNode(spec: FlowChartSpec): StageNode<any, any>;

package/dist/esm/types/lib/builder/types.d.ts

@@ -40,8 +40,6 @@ export type StageNode<TOut = any, TScope = any> = {
     name: string;
     /** Optional stable id (required by decider/fork aggregation). */
     id?: string;
-    /** Human-readable display name for UI. */
-    displayName?: string;
     /** Human-readable description of what this stage does. */
     description?: string;
     /** Linear continuation. */
@@ -77,7 +75,6 @@ export interface SerializedPipelineStructure {
     name: string;
     id?: string;
     type: 'stage' | 'decider' | 'fork' | 'streaming';
-    displayName?: string;
     description?: string;
     children?: SerializedPipelineStructure[];
     next?: SerializedPipelineStructure;
@@ -98,7 +95,6 @@ export interface SerializedPipelineStructure {
 export interface FlowChartSpec {
     name: string;
     id?: string;
-    displayName?: string;
     description?: string;
     children?: FlowChartSpec[];
     next?: FlowChartSpec;
@@ -130,11 +126,16 @@ export type FlowChart<TOut = any, TScope = any> = {
     logger?: ILogger;
     description: string;
     stageDescriptions: Map<string, string>;
+    /** Input schema (Zod or JSON Schema) — declared via setInputSchema(). */
+    inputSchema?: unknown;
+    /** Output schema (Zod or JSON Schema) — declared via setOutputSchema(). */
+    outputSchema?: unknown;
+    /** Output mapper — extracts response from final scope. */
+    outputMapper?: (finalScope: Record<string, unknown>) => unknown;
 };
 export type SimplifiedParallelSpec<TOut = any, TScope = any> = {
     id: string;
     name: string;
-    displayName?: string;
     fn?: PipelineStageFunction<TOut, TScope>;
 };
 export type ExecOptions = {
@@ -148,5 +149,4 @@ export type ExecOptions = {
 export interface SubflowRef {
     $ref: string;
     mountId: string;
-    displayName?: string;
 }

package/dist/esm/types/lib/contract/defineContract.d.ts

@@ -0,0 +1,18 @@
+/**
+ * contract/defineContract.ts — Factory for creating a FlowChartContract.
+ *
+ * Wraps a compiled FlowChart with I/O schemas and an output mapper,
+ * using the same pattern as SubflowMountOptions (inputMapper/outputMapper).
+ *
+ * Usage:
+ *   const contract = defineContract(chart, {
+ *     inputSchema: z.object({ name: z.string() }),
+ *     outputSchema: z.object({ greeting: z.string() }),
+ *     outputMapper: (scope) => ({ greeting: scope.message as string }),
+ *   });
+ *
+ *   const openapi = contract.toOpenAPI();
+ */
+import type { FlowChart } from '../builder/types';
+import type { FlowChartContract, FlowChartContractOptions } from './types';
+export declare function defineContract<TInput = unknown, TOutput = unknown>(chart: FlowChart, options: FlowChartContractOptions<TInput, TOutput>): FlowChartContract<TInput, TOutput>;

package/dist/esm/types/lib/contract/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * contract/ — FlowChart I/O contract and OpenAPI generation layer.
+ *
+ * Standalone library: wraps a compiled FlowChart with input/output schemas
+ * and generates OpenAPI 3.1 specs. Uses the same inputMapper/outputMapper
+ * pattern as subflow mounting.
+ *
+ * Zero runtime deps on Zod — Zod schemas detected via duck-typing and
+ * converted to JSON Schema at contract creation time.
+ */
+export { defineContract } from './defineContract';
+export { isZodSchema, normalizeSchema, zodToJsonSchema } from './schema';
+export { generateOpenAPI } from './openapi';
+export type { FlowChartContract, FlowChartContractOptions, JsonSchema, OpenAPIOptions, OpenAPISpec, SchemaInput, } from './types';

package/dist/esm/types/lib/contract/openapi.d.ts

@@ -0,0 +1,12 @@
+/**
+ * contract/openapi.ts — OpenAPI 3.1 spec generator.
+ *
+ * Generates an OpenAPI spec from a FlowChartContract by combining:
+ * - chart.description → operation description
+ * - chart.stageDescriptions → step-by-step detail
+ * - inputSchema → requestBody
+ * - outputSchema → response
+ * - chart.buildTimeStructure → operation metadata (branches, forks, etc.)
+ */
+import type { FlowChartContract, OpenAPIOptions, OpenAPISpec } from './types';
+export declare function generateOpenAPI(contract: FlowChartContract, options?: OpenAPIOptions): OpenAPISpec;

package/dist/esm/types/lib/contract/schema.d.ts

@@ -0,0 +1,14 @@
+/**
+ * contract/schema.ts — Schema normalization utilities.
+ *
+ * Converts Zod schemas or raw JSON Schema objects into a normalized
+ * JsonSchema format. Zod detection uses duck-typing (checks for `_def`).
+ *
+ * Standalone: no dependency on Zod at import time.
+ * Compatible with Zod v4 internals.
+ */
+import type { JsonSchema, SchemaInput } from './types';
+export declare function isZodSchema(input: unknown): boolean;
+/** Convert a Zod schema object to JSON Schema. */
+export declare function zodToJsonSchema(zodSchema: Record<string, unknown>): JsonSchema;
+export declare function normalizeSchema(input: SchemaInput): JsonSchema;

package/dist/esm/types/lib/contract/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * contract/types.ts — Types for the FlowChart contract layer.
+ *
+ * Defines the I/O boundary for a flowchart: input schema, output schema,
+ * and output mapper. Uses the same pattern as SubflowMountOptions
+ * (inputMapper/outputMapper) but at the top-level flowchart boundary.
+ */
+import type { FlowChart } from '../builder/types';
+export type JsonSchema = {
+    type?: string | string[];
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    enum?: unknown[];
+    description?: string;
+    default?: unknown;
+    format?: string;
+    additionalProperties?: boolean | JsonSchema;
+    oneOf?: JsonSchema[];
+    anyOf?: JsonSchema[];
+    allOf?: JsonSchema[];
+    $ref?: string;
+    [key: string]: unknown;
+};
+/** Anything with a `def` (Zod v4) or `_def` (Zod v3) property is treated as a Zod schema. */
+export type SchemaInput = JsonSchema | {
+    def: unknown;
+    [key: string]: unknown;
+};
+export interface FlowChartContractOptions<TInput = unknown, TOutput = unknown> {
+    /** Schema describing the input (readOnlyContext) shape. Zod or JSON Schema. */
+    inputSchema?: SchemaInput;
+    /** Schema describing the output shape. Zod or JSON Schema. */
+    outputSchema?: SchemaInput;
+    /** Maps the final scope state into the response shape. */
+    outputMapper?: (finalScope: Record<string, unknown>) => TOutput;
+}
+export interface FlowChartContract<TInput = unknown, TOutput = unknown> {
+    /** The compiled flowchart. */
+    chart: FlowChart;
+    /** JSON Schema for the input (normalized from Zod or raw). */
+    inputSchema?: JsonSchema;
+    /** JSON Schema for the output (normalized from Zod or raw). */
+    outputSchema?: JsonSchema;
+    /** Maps the final scope state into the response shape. */
+    outputMapper?: (finalScope: Record<string, unknown>) => TOutput;
+    /** Auto-generated OpenAPI spec. */
+    toOpenAPI(options?: OpenAPIOptions): OpenAPISpec;
+}
+export interface OpenAPIOptions {
+    /** API version string (default: "1.0.0"). */
+    version?: string;
+    /** Base path prefix (default: "/"). */
+    basePath?: string;
+    /** HTTP method for the execute endpoint (default: "post"). */
+    method?: string;
+}
+export interface OpenAPISpec {
+    openapi: '3.1.0';
+    info: {
+        title: string;
+        description: string;
+        version: string;
+    };
+    paths: Record<string, Record<string, OpenAPIOperation>>;
+    components?: {
+        schemas?: Record<string, JsonSchema>;
+    };
+}
+export interface OpenAPIOperation {
+    operationId: string;
+    summary: string;
+    description: string;
+    requestBody?: {
+        required: boolean;
+        content: {
+            'application/json': {
+                schema: JsonSchema | {
+                    $ref: string;
+                };
+            };
+        };
+    };
+    responses: Record<string, {
+        description: string;
+        content?: {
+            'application/json': {
+                schema: JsonSchema | {
+                    $ref: string;
+                };
+            };
+        };
+    }>;
+}

package/dist/esm/types/lib/engine/graph/StageNode.d.ts

@@ -23,8 +23,6 @@ export type StageNode<TOut = any, TScope = any> = {
     name: string;
     /** Optional stable id (required by decider/fork aggregation) */
     id?: string;
-    /** Human-readable display name for UI */
-    displayName?: string;
     /** Description of what this stage does. Used for narrative and tool descriptions. */
     description?: string;
     /** Linear continuation (linked list next pointer) */

package/dist/esm/types/lib/engine/narrative/ControlFlowNarrativeGenerator.d.ts

@@ -14,16 +14,16 @@ import type { IControlFlowNarrative } from './types';
 export declare class ControlFlowNarrativeGenerator implements IControlFlowNarrative {
     private sentences;
     private isFirstStage;
-    onStageExecuted(stageName: string, displayName?: string, description?: string): void;
-    onNext(fromStage: string, toStage: string, toDisplayName?: string, description?: string): void;
-    onDecision(deciderName: string, chosenBranch: string, chosenDisplayName?: string, rationale?: string, deciderDescription?: string): void;
+    onStageExecuted(stageName: string, description?: string): void;
+    onNext(fromStage: string, toStage: string, description?: string): void;
+    onDecision(deciderName: string, chosenBranch: string, rationale?: string, deciderDescription?: string): void;
     onFork(parentStage: string, childNames: string[]): void;
     onSelected(parentStage: string, selectedNames: string[], totalCount: number): void;
     onSubflowEntry(subflowName: string): void;
     onSubflowExit(subflowName: string): void;
-    onLoop(targetStage: string, targetDisplayName: string | undefined, iteration: number, description?: string): void;
-    onBreak(stageName: string, displayName?: string): void;
-    onError(stageName: string, errorMessage: string, displayName?: string): void;
+    onLoop(targetStage: string, iteration: number, description?: string): void;
+    onBreak(stageName: string): void;
+    onError(stageName: string, errorMessage: string): void;
     /** Returns a defensive copy of accumulated sentences. */
     getSentences(): string[];
 }

package/dist/esm/types/lib/engine/narrative/types.d.ts

@@ -9,11 +9,11 @@
  */
 export interface IControlFlowNarrative {
     /** Called when a stage executes. First stage uses distinct opening pattern. */
-    onStageExecuted(stageName: string, displayName?: string, description?: string): void;
+    onStageExecuted(stageName: string, description?: string): void;
     /** Called on linear continuation from one stage to the next. */
-    onNext(fromStage: string, toStage: string, toDisplayName?: string, description?: string): void;
+    onNext(fromStage: string, toStage: string, description?: string): void;
     /** Called when a decider selects a branch. Most valuable for LLM context. */
-    onDecision(deciderName: string, chosenBranch: string, chosenDisplayName?: string, rationale?: string, deciderDescription?: string): void;
+    onDecision(deciderName: string, chosenBranch: string, rationale?: string, deciderDescription?: string): void;
     /** Called when a fork executes all children in parallel. */
     onFork(parentStage: string, childNames: string[]): void;
     /** Called when a selector picks a subset of children. */
@@ -23,11 +23,11 @@ export interface IControlFlowNarrative {
     /** Called when exiting a subflow. */
     onSubflowExit(subflowName: string): void;
     /** Called on loop iteration (back-edge traversal). */
-    onLoop(targetStage: string, targetDisplayName: string | undefined, iteration: number, description?: string): void;
+    onLoop(targetStage: string, iteration: number, description?: string): void;
     /** Called when a stage triggers break (early termination). */
-    onBreak(stageName: string, displayName?: string): void;
+    onBreak(stageName: string): void;
     /** Called when a stage throws an error. */
-    onError(stageName: string, errorMessage: string, displayName?: string): void;
+    onError(stageName: string, errorMessage: string): void;
     /** Returns accumulated narrative sentences in execution order. */
     getSentences(): string[];
 }

package/dist/esm/types/lib/engine/types.d.ts

@@ -169,7 +169,6 @@ export interface SerializedPipelineNode {
     name: string;
     id?: string;
     type?: 'stage' | 'decider' | 'fork' | 'streaming' | 'loop' | 'user' | 'tool' | 'function' | 'sequence';
-    displayName?: string;
     description?: string;
     children?: SerializedPipelineNode[];
     next?: SerializedPipelineNode;

package/dist/esm/types/lib/runner/ExecutionRuntime.d.ts

@@ -16,7 +16,6 @@ import type { CommitBundle, FlowMessage, StageSnapshot } from '../memory/types';
 export interface NarrativeEntry {
     stageId: string;
     stageName: string;
-    displayName?: string;
     stageMessages: string[];
     flowMessage?: FlowMessage;
     timeIndex: number;

package/dist/index.js

@@ -10,7 +10,7 @@
  * import from 'footprint/advanced'.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CombinedNarrativeBuilder = exports.defineScopeFromZod = exports.NarrativeRecorder = exports.DebugRecorder = exports.MetricRecorder = exports.ScopeFacade = exports.FlowChartExecutor = exports.FlowChartBuilder = exports.flowChart = void 0;
+exports.generateOpenAPI = exports.zodToJsonSchema = exports.normalizeSchema = exports.defineContract = exports.CombinedNarrativeBuilder = exports.defineScopeFromZod = exports.NarrativeRecorder = exports.DebugRecorder = exports.MetricRecorder = exports.ScopeFacade = exports.FlowChartExecutor = exports.FlowChartBuilder = exports.flowChart = void 0;
 var builder_1 = require("./lib/builder");
 Object.defineProperty(exports, "flowChart", { enumerable: true, get: function () { return builder_1.flowChart; } });
 Object.defineProperty(exports, "FlowChartBuilder", { enumerable: true, get: function () { return builder_1.FlowChartBuilder; } });
@@ -36,4 +36,14 @@ var scope_5 = require("./lib/scope");
 Object.defineProperty(exports, "defineScopeFromZod", { enumerable: true, get: function () { return scope_5.defineScopeFromZod; } });
 var engine_1 = require("./lib/engine");
 Object.defineProperty(exports, "CombinedNarrativeBuilder", { enumerable: true, get: function () { return engine_1.CombinedNarrativeBuilder; } });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7Ozs7Ozs7R0FTRzs7O0FBT0gseUNBQTREO0FBQW5ELG9HQUFBLFNBQVMsT0FBQTtBQUFFLDJHQUFBLGdCQUFnQixPQUFBO0FBRXBDLCtFQUErRTtBQUMvRSx1Q0FBdUM7QUFDdkMsK0VBQStFO0FBRS9FLHVDQUFpRDtBQUF4QywyR0FBQSxpQkFBaUIsT0FBQTtBQUUxQiwrRUFBK0U7QUFDL0UsMENBQTBDO0FBQzFDLCtFQUErRTtBQUUvRSxxQ0FBMEM7QUFBakMsb0dBQUEsV0FBVyxPQUFBO0FBRXBCLFlBQVk7QUFDWixxQ0FBNkM7QUFBcEMsdUdBQUEsY0FBYyxPQUFBO0FBQ3ZCLHFDQUE0QztBQUFuQyxzR0FBQSxhQUFhLE9BQUE7QUFDdEIscUNBQWdEO0FBQXZDLDBHQUFBLGlCQUFpQixPQUFBO0FBSzFCLDhCQUE4QjtBQUM5QixxQ0FBaUQ7QUFBeEMsMkdBQUEsa0JBQWtCLE9BQUE7QUFPM0IsdUNBQXdEO0FBQS9DLGtIQUFBLHdCQUF3QixPQUFBIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBGb290UHJpbnQg4oCUIFB1YmxpYyBBUElcbiAqXG4gKiBDb25uZWN0ZWQgY2F1c2FsIHRyYWNlIGxpYnJhcnkgZm9yIExMTSBwaXBlbGluZXMuXG4gKiBCdWlsZHMgZmxvd2NoYXJ0cywgZXhlY3V0ZXMgdGhlbSB2aWEgREZTIHRyYXZlcnNhbCwgYW5kIGNhcHR1cmVzXG4gKiBldmVyeSBzdGFnZSdzIGNvbnRleHQgKHN0YXRlLCBkZWNpc2lvbnMsIGVycm9ycykgaW4gYW4gYXVkaXRhYmxlIHRyYWNlLlxuICpcbiAqIEZvciBhZHZhbmNlZC9pbnRlcm5hbCBBUElzIChtZW1vcnkgcHJpbWl0aXZlcywgZW5naW5lIGhhbmRsZXJzLCBwcm92aWRlcnMpLFxuICogaW1wb3J0IGZyb20gJ2Zvb3RwcmludC9hZHZhbmNlZCcuXG4gKi9cblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gQnVpbGRlciDigJQgRmxvd2NoYXJ0IGNvbnN0cnVjdGlvblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgdHlwZSB7IEZsb3dDaGFydCwgUGlwZWxpbmVTdGFnZUZ1bmN0aW9uIGFzIFN0YWdlSGFuZGxlciwgU3RyZWFtSGFuZGxlcnMgfSBmcm9tICcuL2xpYi9idWlsZGVyJztcbmV4cG9ydCB7IGZsb3dDaGFydCwgRmxvd0NoYXJ0QnVpbGRlciB9IGZyb20gJy4vbGliL2J1aWxkZXInO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBSdW5uZXIg4oCUIEV4ZWN1dGlvbiBjb252ZW5pZW5jZSBsYXllclxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgeyBGbG93Q2hhcnRFeGVjdXRvciB9IGZyb20gJy4vbGliL3J1bm5lcic7XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIFNjb3BlIOKAlCBQZXItc3RhZ2UgZmFjYWRlcyBhbmQgcmVjb3JkZXJzXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCB7IFNjb3BlRmFjYWRlIH0gZnJvbSAnLi9saWIvc2NvcGUnO1xuXG4vLyBSZWNvcmRlcnNcbmV4cG9ydCB7IE1ldHJpY1JlY29yZGVyIH0gZnJvbSAnLi9saWIvc2NvcGUnO1xuZXhwb3J0IHsgRGVidWdSZWNvcmRlciB9IGZyb20gJy4vbGliL3Njb3BlJztcbmV4cG9ydCB7IE5hcnJhdGl2ZVJlY29yZGVyIH0gZnJvbSAnLi9saWIvc2NvcGUnO1xuXG4vLyBSZWNvcmRlciBpbnRlcmZhY2UgYW5kIGNvcmUgZXZlbnQgdHlwZXMgKG5lZWRlZCB0byBpbXBsZW1lbnQgY3VzdG9tIFJlY29yZGVyKVxuZXhwb3J0IHR5cGUgeyBDb21taXRFdmVudCwgRXJyb3JFdmVudCwgUmVhZEV2ZW50LCBSZWNvcmRlciwgV3JpdGVFdmVudCB9IGZyb20gJy4vbGliL3Njb3BlJztcblxuLy8gWm9kLWJhc2VkIHNjb3BlIGRlZmluaXRpb25zXG5leHBvcnQgeyBkZWZpbmVTY29wZUZyb21ab2QgfSBmcm9tICcuL2xpYi9zY29wZSc7XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIEVuZ2luZSDigJQgTmFycmF0aXZlIChjb21tb25seSB1c2VkKVxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgdHlwZSB7IENvbWJpbmVkTmFycmF0aXZlRW50cnkgfSBmcm9tICcuL2xpYi9lbmdpbmUnO1xuZXhwb3J0IHsgQ29tYmluZWROYXJyYXRpdmVCdWlsZGVyIH0gZnJvbSAnLi9saWIvZW5naW5lJztcblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gTWVtb3J5IOKAlCBTY29wZUZhY3RvcnkgdHlwZSAobmVlZGVkIGZvciBGbG93Q2hhcnRFeGVjdXRvciBjb25zdHJ1Y3Rvcilcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuZXhwb3J0IHR5cGUgeyBSdW5PcHRpb25zIH0gZnJvbSAnLi9saWIvZW5naW5lJztcbmV4cG9ydCB0eXBlIHsgU2NvcGVGYWN0b3J5IH0gZnJvbSAnLi9saWIvbWVtb3J5JztcbiJdfQ==
+// ============================================================================
+// Contract — I/O boundary, schemas, and OpenAPI generation
+// ============================================================================
+var contract_1 = require("./lib/contract");
+Object.defineProperty(exports, "defineContract", { enumerable: true, get: function () { return contract_1.defineContract; } });
+var contract_2 = require("./lib/contract");
+Object.defineProperty(exports, "normalizeSchema", { enumerable: true, get: function () { return contract_2.normalizeSchema; } });
+Object.defineProperty(exports, "zodToJsonSchema", { enumerable: true, get: function () { return contract_2.zodToJsonSchema; } });
+var contract_3 = require("./lib/contract");
+Object.defineProperty(exports, "generateOpenAPI", { enumerable: true, get: function () { return contract_3.generateOpenAPI; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7Ozs7Ozs7R0FTRzs7O0FBT0gseUNBQTREO0FBQW5ELG9HQUFBLFNBQVMsT0FBQTtBQUFFLDJHQUFBLGdCQUFnQixPQUFBO0FBRXBDLCtFQUErRTtBQUMvRSx1Q0FBdUM7QUFDdkMsK0VBQStFO0FBRS9FLHVDQUFpRDtBQUF4QywyR0FBQSxpQkFBaUIsT0FBQTtBQUUxQiwrRUFBK0U7QUFDL0UsMENBQTBDO0FBQzFDLCtFQUErRTtBQUUvRSxxQ0FBMEM7QUFBakMsb0dBQUEsV0FBVyxPQUFBO0FBRXBCLFlBQVk7QUFDWixxQ0FBNkM7QUFBcEMsdUdBQUEsY0FBYyxPQUFBO0FBQ3ZCLHFDQUE0QztBQUFuQyxzR0FBQSxhQUFhLE9BQUE7QUFDdEIscUNBQWdEO0FBQXZDLDBHQUFBLGlCQUFpQixPQUFBO0FBSzFCLDhCQUE4QjtBQUM5QixxQ0FBaUQ7QUFBeEMsMkdBQUEsa0JBQWtCLE9BQUE7QUFPM0IsdUNBQXdEO0FBQS9DLGtIQUFBLHdCQUF3QixPQUFBO0FBU2pDLCtFQUErRTtBQUMvRSwyREFBMkQ7QUFDM0QsK0VBQStFO0FBRS9FLDJDQUFnRDtBQUF2QywwR0FBQSxjQUFjLE9BQUE7QUFDdkIsMkNBQWtFO0FBQXpELDJHQUFBLGVBQWUsT0FBQTtBQUFFLDJHQUFBLGVBQWUsT0FBQTtBQUN6QywyQ0FBaUQ7QUFBeEMsMkdBQUEsZUFBZSxPQUFBIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBGb290UHJpbnQg4oCUIFB1YmxpYyBBUElcbiAqXG4gKiBDb25uZWN0ZWQgY2F1c2FsIHRyYWNlIGxpYnJhcnkgZm9yIExMTSBwaXBlbGluZXMuXG4gKiBCdWlsZHMgZmxvd2NoYXJ0cywgZXhlY3V0ZXMgdGhlbSB2aWEgREZTIHRyYXZlcnNhbCwgYW5kIGNhcHR1cmVzXG4gKiBldmVyeSBzdGFnZSdzIGNvbnRleHQgKHN0YXRlLCBkZWNpc2lvbnMsIGVycm9ycykgaW4gYW4gYXVkaXRhYmxlIHRyYWNlLlxuICpcbiAqIEZvciBhZHZhbmNlZC9pbnRlcm5hbCBBUElzIChtZW1vcnkgcHJpbWl0aXZlcywgZW5naW5lIGhhbmRsZXJzLCBwcm92aWRlcnMpLFxuICogaW1wb3J0IGZyb20gJ2Zvb3RwcmludC9hZHZhbmNlZCcuXG4gKi9cblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gQnVpbGRlciDigJQgRmxvd2NoYXJ0IGNvbnN0cnVjdGlvblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgdHlwZSB7IEZsb3dDaGFydCwgUGlwZWxpbmVTdGFnZUZ1bmN0aW9uIGFzIFN0YWdlSGFuZGxlciwgU3RyZWFtSGFuZGxlcnMgfSBmcm9tICcuL2xpYi9idWlsZGVyJztcbmV4cG9ydCB7IGZsb3dDaGFydCwgRmxvd0NoYXJ0QnVpbGRlciB9IGZyb20gJy4vbGliL2J1aWxkZXInO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBSdW5uZXIg4oCUIEV4ZWN1dGlvbiBjb252ZW5pZW5jZSBsYXllclxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgeyBGbG93Q2hhcnRFeGVjdXRvciB9IGZyb20gJy4vbGliL3J1bm5lcic7XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIFNjb3BlIOKAlCBQZXItc3RhZ2UgZmFjYWRlcyBhbmQgcmVjb3JkZXJzXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCB7IFNjb3BlRmFjYWRlIH0gZnJvbSAnLi9saWIvc2NvcGUnO1xuXG4vLyBSZWNvcmRlcnNcbmV4cG9ydCB7IE1ldHJpY1JlY29yZGVyIH0gZnJvbSAnLi9saWIvc2NvcGUnO1xuZXhwb3J0IHsgRGVidWdSZWNvcmRlciB9IGZyb20gJy4vbGliL3Njb3BlJztcbmV4cG9ydCB7IE5hcnJhdGl2ZVJlY29yZGVyIH0gZnJvbSAnLi9saWIvc2NvcGUnO1xuXG4vLyBSZWNvcmRlciBpbnRlcmZhY2UgYW5kIGNvcmUgZXZlbnQgdHlwZXMgKG5lZWRlZCB0byBpbXBsZW1lbnQgY3VzdG9tIFJlY29yZGVyKVxuZXhwb3J0IHR5cGUgeyBDb21taXRFdmVudCwgRXJyb3JFdmVudCwgUmVhZEV2ZW50LCBSZWNvcmRlciwgV3JpdGVFdmVudCB9IGZyb20gJy4vbGliL3Njb3BlJztcblxuLy8gWm9kLWJhc2VkIHNjb3BlIGRlZmluaXRpb25zXG5leHBvcnQgeyBkZWZpbmVTY29wZUZyb21ab2QgfSBmcm9tICcuL2xpYi9zY29wZSc7XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIEVuZ2luZSDigJQgTmFycmF0aXZlIChjb21tb25seSB1c2VkKVxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgdHlwZSB7IENvbWJpbmVkTmFycmF0aXZlRW50cnkgfSBmcm9tICcuL2xpYi9lbmdpbmUnO1xuZXhwb3J0IHsgQ29tYmluZWROYXJyYXRpdmVCdWlsZGVyIH0gZnJvbSAnLi9saWIvZW5naW5lJztcblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gTWVtb3J5IOKAlCBTY29wZUZhY3RvcnkgdHlwZSAobmVlZGVkIGZvciBGbG93Q2hhcnRFeGVjdXRvciBjb25zdHJ1Y3Rvcilcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuZXhwb3J0IHR5cGUgeyBSdW5PcHRpb25zIH0gZnJvbSAnLi9saWIvZW5naW5lJztcbmV4cG9ydCB0eXBlIHsgU2NvcGVGYWN0b3J5IH0gZnJvbSAnLi9saWIvbWVtb3J5JztcblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gQ29udHJhY3Qg4oCUIEkvTyBib3VuZGFyeSwgc2NoZW1hcywgYW5kIE9wZW5BUEkgZ2VuZXJhdGlvblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgeyBkZWZpbmVDb250cmFjdCB9IGZyb20gJy4vbGliL2NvbnRyYWN0JztcbmV4cG9ydCB7IG5vcm1hbGl6ZVNjaGVtYSwgem9kVG9Kc29uU2NoZW1hIH0gZnJvbSAnLi9saWIvY29udHJhY3QnO1xuZXhwb3J0IHsgZ2VuZXJhdGVPcGVuQVBJIH0gZnJvbSAnLi9saWIvY29udHJhY3QnO1xuZXhwb3J0IHR5cGUge1xuICBGbG93Q2hhcnRDb250cmFjdCxcbiAgRmxvd0NoYXJ0Q29udHJhY3RPcHRpb25zLFxuICBKc29uU2NoZW1hLFxuICBPcGVuQVBJT3B0aW9ucyxcbiAgT3BlbkFQSVNwZWMsXG59IGZyb20gJy4vbGliL2NvbnRyYWN0JztcbiJdfQ==