@mondaydotcomorg/atp-compiler 0.17.14

package/dist/runtime/src/metadata/generated.js

@@ -0,0 +1,290 @@
+/**
+ * AUTO-GENERATED - DO NOT EDIT
+ * Generated by scripts/generate-metadata.ts
+ *
+ * Hybrid approach:
+ * - ts-json-schema-generator (OSS) for most types
+ * - ts-morph fallback for types OSS can't handle (generics)
+ */
+export const GENERATED_METADATA = [
+    {
+        "name": "approval",
+        "description": "Approval API - Request explicit human approval for sensitive operations",
+        "methods": [
+            {
+                "name": "request",
+                "description": "Request approval from a human",
+                "params": [
+                    {
+                        "name": "message",
+                        "type": "string",
+                        "description": "The message to display to the user",
+                        "optional": false
+                    },
+                    {
+                        "name": "context",
+                        "type": "Record<string, unknown>",
+                        "description": "Optional context information about what needs approval",
+                        "optional": true
+                    }
+                ],
+                "returns": "Promise<ApprovalResponse>"
+            }
+        ]
+    },
+    {
+        "name": "cache",
+        "description": "Cache API - Store and retrieve data with optional TTL",
+        "methods": [
+            {
+                "name": "get",
+                "description": "Get a value from cache by key",
+                "params": [
+                    {
+                        "name": "key",
+                        "type": "string",
+                        "description": "Cache key",
+                        "optional": false
+                    }
+                ],
+                "returns": "Promise<T | null>"
+            },
+            {
+                "name": "set",
+                "description": "Set a value in cache with optional TTL",
+                "params": [
+                    {
+                        "name": "key",
+                        "type": "string",
+                        "description": "Cache key",
+                        "optional": false
+                    },
+                    {
+                        "name": "value",
+                        "type": "unknown",
+                        "description": "Value to cache",
+                        "optional": false
+                    },
+                    {
+                        "name": "ttl",
+                        "type": "number",
+                        "description": "Time to live in seconds",
+                        "optional": true
+                    }
+                ],
+                "returns": "Promise<void>"
+            },
+            {
+                "name": "delete",
+                "description": "Delete a value from cache",
+                "params": [
+                    {
+                        "name": "key",
+                        "type": "string",
+                        "description": "Cache key to delete",
+                        "optional": false
+                    }
+                ],
+                "returns": "Promise<void>"
+            },
+            {
+                "name": "has",
+                "description": "Check if a key exists in cache",
+                "params": [
+                    {
+                        "name": "key",
+                        "type": "string",
+                        "description": "Cache key to check",
+                        "optional": false
+                    }
+                ],
+                "returns": "Promise<boolean>"
+            },
+            {
+                "name": "clear",
+                "description": "Clear all cache entries",
+                "params": [],
+                "returns": "Promise<void>"
+            }
+        ]
+    },
+    {
+        "name": "embedding",
+        "description": "Embedding API - Client-side embedding with server-side vector storage",
+        "methods": [
+            {
+                "name": "embed",
+                "description": "Request client to generate and store embeddings",
+                "params": [
+                    {
+                        "name": "input",
+                        "type": "string | string[]",
+                        "description": "Text(s) to embed",
+                        "optional": false
+                    },
+                    {
+                        "name": "metadata",
+                        "type": "Record<string, unknown>",
+                        "description": "Optional metadata to store with embeddings",
+                        "optional": true
+                    }
+                ],
+                "returns": "Promise<string | string[]>"
+            },
+            {
+                "name": "search",
+                "description": "Search stored embeddings by similarity",
+                "params": [
+                    {
+                        "name": "query",
+                        "type": "string",
+                        "description": "Search query text (will be embedded by client)",
+                        "optional": false
+                    },
+                    {
+                        "name": "options",
+                        "type": "Omit<SearchOptions, 'query'>",
+                        "description": "Search options (topK, minSimilarity, filter)",
+                        "optional": true
+                    }
+                ],
+                "returns": "Promise<SearchResult[]>"
+            },
+            {
+                "name": "similarity",
+                "description": "Calculate cosine similarity between two embedding vectors",
+                "params": [
+                    {
+                        "name": "embedding1",
+                        "type": "number[]",
+                        "description": "First embedding vector",
+                        "optional": false
+                    },
+                    {
+                        "name": "embedding2",
+                        "type": "number[]",
+                        "description": "Second embedding vector",
+                        "optional": false
+                    }
+                ],
+                "returns": "number"
+            },
+            {
+                "name": "getAll",
+                "description": "Get all stored embeddings",
+                "params": [],
+                "returns": "EmbeddingRecord[]"
+            },
+            {
+                "name": "count",
+                "description": "Get count of stored embeddings",
+                "params": [],
+                "returns": "number"
+            }
+        ]
+    },
+    {
+        "name": "llm",
+        "description": "LLM API - Large Language Model calls using client-provided LLM (requires client.provideLLM())",
+        "methods": [
+            {
+                "name": "call",
+                "description": "Make an LLM call with a prompt",
+                "params": [
+                    {
+                        "name": "options",
+                        "type": "LLMCallOptions",
+                        "description": "LLM call options including prompt",
+                        "optional": false
+                    }
+                ],
+                "returns": "Promise<string>"
+            },
+            {
+                "name": "extract",
+                "description": "Extract structured data from text using an LLM",
+                "params": [
+                    {
+                        "name": "options",
+                        "type": "LLMExtractOptions",
+                        "description": "Extraction options with JSON schema",
+                        "optional": false
+                    }
+                ],
+                "returns": "Promise<T>"
+            },
+            {
+                "name": "classify",
+                "description": "Classify text into one of the provided categories",
+                "params": [
+                    {
+                        "name": "options",
+                        "type": "LLMClassifyOptions",
+                        "description": "Classification options with categories",
+                        "optional": false
+                    }
+                ],
+                "returns": "Promise<string>"
+            }
+        ]
+    },
+    {
+        "name": "progress",
+        "description": "Progress API - Report execution progress to clients",
+        "methods": [
+            {
+                "name": "report",
+                "description": "Report progress with message and completion fraction",
+                "params": [
+                    {
+                        "name": "message",
+                        "type": "string",
+                        "description": "Progress message",
+                        "optional": false
+                    },
+                    {
+                        "name": "fraction",
+                        "type": "number",
+                        "description": "Completion fraction (0-1)",
+                        "optional": false
+                    }
+                ],
+                "returns": "void"
+            }
+        ]
+    }
+];
+/**
+ * Type definitions extracted using ts-json-schema-generator
+ */
+export const TYPE_REGISTRY = [
+    {
+        "name": "ApprovalResponse",
+        "definition": "export interface ApprovalResponse<T = unknown> {\n\tapproved: boolean;\n\tresponse?: T;\n\ttimestamp: number;\n}"
+    },
+    {
+        "name": "SearchOptions",
+        "definition": "interface SearchOptions {\n  query: string;\n  topK?: number;\n  minSimilarity?: number;\n  filter?: Record<string, unknown>;\n}"
+    },
+    {
+        "name": "SearchResult",
+        "definition": "interface SearchResult {\n  id: string;\n  text: string;\n  similarity: number;\n  metadata?: Record<string, unknown>;\n}"
+    },
+    {
+        "name": "EmbeddingRecord",
+        "definition": "interface EmbeddingRecord {\n  id: string;\n  text: string;\n  embedding: number[];\n  metadata?: Record<string, unknown>;\n}"
+    },
+    {
+        "name": "LLMCallOptions",
+        "definition": "interface LLMCallOptions {\n  prompt: string;\n  context?: Record<string, unknown>;\n  model?: string;\n  maxTokens?: number;\n  temperature?: number;\n  systemPrompt?: string;\n}"
+    },
+    {
+        "name": "LLMExtractOptions",
+        "definition": "interface LLMExtractOptions {\n  prompt: string;\n  context?: Record<string, unknown>;\n  schema: unknown;\n}"
+    },
+    {
+        "name": "LLMClassifyOptions",
+        "definition": "interface LLMClassifyOptions {\n  text: string;\n  categories: string[];\n  context?: Record<string, unknown>;\n}"
+    }
+];
+//# sourceMappingURL=generated.js.map

package/dist/runtime/src/metadata/generated.js.map

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

package/dist/runtime/src/metadata/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Metadata and Type Generation Utilities
+ */
+export type { RuntimeAPIParam, RuntimeAPIMethod, RuntimeAPIMetadata } from './types.js';
+export { RuntimeAPI, RuntimeMethod } from './decorators.js';
+import type { RuntimeAPIMetadata } from './types.js';
+/**
+ * Generates TypeScript definitions from runtime API metadata
+ */
+export declare function generateRuntimeTypes(apis: RuntimeAPIMetadata[]): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/src/metadata/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../runtime/src/metadata/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAgDvE"}

package/dist/runtime/src/metadata/index.js

@@ -0,0 +1,45 @@
+/**
+ * Metadata and Type Generation Utilities
+ */
+export { RuntimeAPI, RuntimeMethod } from './decorators.js';
+/**
+ * Generates TypeScript definitions from runtime API metadata
+ */
+export function generateRuntimeTypes(apis) {
+    let typescript = '// Runtime SDK\ndeclare const atp: {\n';
+    for (const api of apis) {
+        typescript += `  /**\n`;
+        for (const line of api.description.split('\n')) {
+            typescript += `   * ${line}\n`;
+        }
+        typescript += `   */\n`;
+        typescript += `  ${api.name}: {\n`;
+        for (const method of api.methods) {
+            typescript += `    /**\n`;
+            typescript += `     * ${method.description}\n`;
+            for (const param of method.params) {
+                if (param.description) {
+                    typescript += `     * @param ${param.name} - ${param.description}\n`;
+                }
+            }
+            if (method.returns !== 'void') {
+                const returnDesc = method.returns.startsWith('Promise')
+                    ? 'Promise resolving to result'
+                    : 'Result value';
+                typescript += `     * @returns ${returnDesc}\n`;
+            }
+            typescript += `     */\n`;
+            const paramStrings = method.params.map((p) => {
+                const optional = p.optional ? '?' : '';
+                const type = p.type.includes('\n') ? p.type.replace(/\n/g, '\n      ') : p.type;
+                return `${p.name}${optional}: ${type}`;
+            });
+            typescript += `    ${method.name}(${paramStrings.join(', ')}): ${method.returns};\n`;
+            typescript += `\n`;
+        }
+        typescript += `  };\n\n`;
+    }
+    typescript += '};\n\n';
+    return typescript;
+}
+//# sourceMappingURL=index.js.map

package/dist/runtime/src/metadata/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../runtime/src/metadata/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAI5D;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAA0B;IAC9D,IAAI,UAAU,GAAG,wCAAwC,CAAC;IAE1D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,UAAU,IAAI,SAAS,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,UAAU,IAAI,QAAQ,IAAI,IAAI,CAAC;QAChC,CAAC;QACD,UAAU,IAAI,SAAS,CAAC;QAExB,UAAU,IAAI,KAAK,GAAG,CAAC,IAAI,OAAO,CAAC;QAEnC,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAClC,UAAU,IAAI,WAAW,CAAC;YAC1B,UAAU,IAAI,UAAU,MAAM,CAAC,WAAW,IAAI,CAAC;YAE/C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;oBACvB,UAAU,IAAI,iBAAiB,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,WAAW,IAAI,CAAC;gBACtE,CAAC;YACF,CAAC;YAED,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;gBAC/B,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC;oBACtD,CAAC,CAAC,6BAA6B;oBAC/B,CAAC,CAAC,cAAc,CAAC;gBAClB,UAAU,IAAI,mBAAmB,UAAU,IAAI,CAAC;YACjD,CAAC;YAED,UAAU,IAAI,WAAW,CAAC;YAE1B,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC5C,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBAChF,OAAO,GAAG,CAAC,CAAC,IAAI,GAAG,QAAQ,KAAK,IAAI,EAAE,CAAC;YACxC,CAAC,CAAC,CAAC;YAEH,UAAU,IAAI,OAAO,MAAM,CAAC,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,OAAO,KAAK,CAAC;YAErF,UAAU,IAAI,IAAI,CAAC;QACpB,CAAC;QAED,UAAU,IAAI,UAAU,CAAC;IAC1B,CAAC;IAED,UAAU,IAAI,QAAQ,CAAC;IAEvB,OAAO,UAAU,CAAC;AACnB,CAAC"}

package/dist/runtime/src/metadata/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Common metadata interface for runtime APIs
+ * Each runtime module exports its metadata for the type generator
+ */
+export interface RuntimeAPIParam {
+    name: string;
+    type: string;
+    description?: string;
+    optional?: boolean;
+}
+export interface RuntimeAPIMethod {
+    name: string;
+    description: string;
+    params: RuntimeAPIParam[];
+    returns: string;
+}
+export interface RuntimeAPIMetadata {
+    name: string;
+    description: string;
+    methods: RuntimeAPIMethod[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/src/metadata/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../runtime/src/metadata/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC5B"}

package/dist/runtime/src/metadata/types.js

@@ -0,0 +1,6 @@
+/**
+ * Common metadata interface for runtime APIs
+ * Each runtime module exports its metadata for the type generator
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/runtime/src/metadata/types.js.map

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

package/dist/runtime/src/pause/index.d.ts

@@ -0,0 +1,11 @@
+import { PauseExecutionError, CallbackType } from './types.js';
+export { PauseExecutionError, CallbackType, LLMOperation, EmbeddingOperation, ApprovalOperation, ToolOperation, } from './types.js';
+/**
+ * Helper to create pause error
+ */
+export declare function pauseForCallback(type: CallbackType, operation: string, payload: Record<string, unknown>): never;
+/**
+ * Check if error is a pause request
+ */
+export declare function isPauseError(error: unknown): error is PauseExecutionError;
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/src/pause/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../runtime/src/pause/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,EACN,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,GACb,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,KAAK,CAEP;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAEzE"}

package/dist/runtime/src/pause/index.js

@@ -0,0 +1,15 @@
+import { PauseExecutionError } from './types.js';
+export { PauseExecutionError, CallbackType, LLMOperation, EmbeddingOperation, ApprovalOperation, ToolOperation, } from './types.js';
+/**
+ * Helper to create pause error
+ */
+export function pauseForCallback(type, operation, payload) {
+    throw new PauseExecutionError(type, operation, payload);
+}
+/**
+ * Check if error is a pause request
+ */
+export function isPauseError(error) {
+    return error instanceof PauseExecutionError;
+}
+//# sourceMappingURL=index.js.map

package/dist/runtime/src/pause/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../runtime/src/pause/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAgB,MAAM,YAAY,CAAC;AAE/D,OAAO,EACN,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,GACb,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC/B,IAAkB,EAClB,SAAiB,EACjB,OAAgC;IAEhC,MAAM,IAAI,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,mBAAmB,CAAC;AAC7C,CAAC"}

package/dist/runtime/src/pause/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Callback types that can pause execution
+ */
+export declare enum CallbackType {
+    LLM = "llm",
+    APPROVAL = "approval",
+    EMBEDDING = "embedding",
+    TOOL = "tool"
+}
+/**
+ * LLM callback operations
+ */
+export declare enum LLMOperation {
+    CALL = "call",
+    EXTRACT = "extract",
+    CLASSIFY = "classify"
+}
+/**
+ * Embedding callback operations
+ */
+export declare enum EmbeddingOperation {
+    EMBED = "embed",
+    SEARCH = "search"
+}
+/**
+ * Approval callback operations
+ */
+export declare enum ApprovalOperation {
+    REQUEST = "request"
+}
+/**
+ * Tool callback operations
+ */
+export declare enum ToolOperation {
+    CALL = "call"
+}
+/**
+ * Thrown when execution needs to pause for client callback
+ */
+export declare class PauseExecutionError extends Error {
+    readonly type: CallbackType;
+    readonly operation: string;
+    readonly payload: Record<string, unknown>;
+    constructor(type: CallbackType, operation: string, payload: Record<string, unknown>);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/src/pause/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../runtime/src/pause/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,YAAY;IACvB,GAAG,QAAQ;IACX,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,IAAI,SAAS;CACb;AAED;;GAEG;AACH,oBAAY,YAAY;IACvB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,QAAQ,aAAa;CACrB;AAED;;GAEG;AACH,oBAAY,kBAAkB;IAC7B,KAAK,UAAU;IACf,MAAM,WAAW;CACjB;AAED;;GAEG;AACH,oBAAY,iBAAiB;IAC5B,OAAO,YAAY;CACnB;AAED;;GAEG;AACH,oBAAY,aAAa;IACxB,IAAI,SAAS;CACb;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,SAAgB,IAAI,EAAE,YAAY,CAAC;IACnC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAErC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOnF"}

package/dist/runtime/src/pause/types.js

@@ -0,0 +1,57 @@
+/**
+ * Callback types that can pause execution
+ */
+export var CallbackType;
+(function (CallbackType) {
+    CallbackType["LLM"] = "llm";
+    CallbackType["APPROVAL"] = "approval";
+    CallbackType["EMBEDDING"] = "embedding";
+    CallbackType["TOOL"] = "tool";
+})(CallbackType || (CallbackType = {}));
+/**
+ * LLM callback operations
+ */
+export var LLMOperation;
+(function (LLMOperation) {
+    LLMOperation["CALL"] = "call";
+    LLMOperation["EXTRACT"] = "extract";
+    LLMOperation["CLASSIFY"] = "classify";
+})(LLMOperation || (LLMOperation = {}));
+/**
+ * Embedding callback operations
+ */
+export var EmbeddingOperation;
+(function (EmbeddingOperation) {
+    EmbeddingOperation["EMBED"] = "embed";
+    EmbeddingOperation["SEARCH"] = "search";
+})(EmbeddingOperation || (EmbeddingOperation = {}));
+/**
+ * Approval callback operations
+ */
+export var ApprovalOperation;
+(function (ApprovalOperation) {
+    ApprovalOperation["REQUEST"] = "request";
+})(ApprovalOperation || (ApprovalOperation = {}));
+/**
+ * Tool callback operations
+ */
+export var ToolOperation;
+(function (ToolOperation) {
+    ToolOperation["CALL"] = "call";
+})(ToolOperation || (ToolOperation = {}));
+/**
+ * Thrown when execution needs to pause for client callback
+ */
+export class PauseExecutionError extends Error {
+    type;
+    operation;
+    payload;
+    constructor(type, operation, payload) {
+        super(`Execution paused: waiting for ${type}.${operation}`);
+        this.name = 'PauseExecutionError';
+        this.type = type;
+        this.operation = operation;
+        this.payload = payload;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/runtime/src/pause/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../runtime/src/pause/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACvB,2BAAW,CAAA;IACX,qCAAqB,CAAA;IACrB,uCAAuB,CAAA;IACvB,6BAAa,CAAA;AACd,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACvB,6BAAa,CAAA;IACb,mCAAmB,CAAA;IACnB,qCAAqB,CAAA;AACtB,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAC7B,qCAAe,CAAA;IACf,uCAAiB,CAAA;AAClB,CAAC,EAHW,kBAAkB,KAAlB,kBAAkB,QAG7B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,iBAEX;AAFD,WAAY,iBAAiB;IAC5B,wCAAmB,CAAA;AACpB,CAAC,EAFW,iBAAiB,KAAjB,iBAAiB,QAE5B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,aAEX;AAFD,WAAY,aAAa;IACxB,8BAAa,CAAA;AACd,CAAC,EAFW,aAAa,KAAb,aAAa,QAExB;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC7B,IAAI,CAAe;IACnB,SAAS,CAAS;IAClB,OAAO,CAA0B;IAEjD,YAAY,IAAkB,EAAE,SAAiB,EAAE,OAAgC;QAClF,KAAK,CAAC,iCAAiC,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;CACD"}

package/dist/runtime/src/progress/index.d.ts

@@ -0,0 +1,19 @@
+import type { ProgressCallback } from './types.js';
+export type { ProgressCallback } from './types.js';
+/**
+ * Set the progress callback handler
+ */
+export declare function setProgressCallback(callback: ProgressCallback | null): void;
+/**
+ * Progress Runtime API
+ *
+ * Allows reporting execution progress to clients
+ */
+declare class ProgressAPI {
+    /**
+     * Report progress with message and completion fraction
+     */
+    report(message: string, fraction: number): void;
+}
+export declare const progress: ProgressAPI;
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/src/progress/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../runtime/src/progress/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAOnD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAE3E;AAED;;;;GAIG;AACH,cACM,WAAW;IAChB;;OAEG;IAKH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAS/C;AAED,eAAO,MAAM,QAAQ,aAAoB,CAAC"}

package/dist/runtime/src/progress/index.js

@@ -0,0 +1,61 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+/**
+ * Progress API - Clean refactored version with decorators
+ *
+ * Benefits:
+ * - No duplication between implementation and metadata
+ * - Types auto-detected from TypeScript signatures
+ */
+import { RuntimeAPI, RuntimeMethod } from '../metadata/decorators.js';
+/**
+ * Global progress callback (set by executor)
+ */
+let progressCallback = null;
+/**
+ * Set the progress callback handler
+ */
+export function setProgressCallback(callback) {
+    progressCallback = callback;
+}
+/**
+ * Progress Runtime API
+ *
+ * Allows reporting execution progress to clients
+ */
+let ProgressAPI = class ProgressAPI {
+    /**
+     * Report progress with message and completion fraction
+     */
+    report(message, fraction) {
+        if (progressCallback) {
+            try {
+                progressCallback(message, fraction);
+            }
+            catch (error) {
+                console.error('Progress callback error:', error);
+            }
+        }
+    }
+};
+__decorate([
+    RuntimeMethod('Report progress with message and completion fraction', {
+        message: { description: 'Progress message' },
+        fraction: { description: 'Completion fraction (0-1)' },
+    }),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Number]),
+    __metadata("design:returntype", void 0)
+], ProgressAPI.prototype, "report", null);
+ProgressAPI = __decorate([
+    RuntimeAPI('progress', 'Progress API - Report execution progress to clients')
+], ProgressAPI);
+export const progress = new ProgressAPI();
+//# sourceMappingURL=index.js.map

package/dist/runtime/src/progress/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../runtime/src/progress/index.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAKtE;;GAEG;AACH,IAAI,gBAAgB,GAA4B,IAAI,CAAC;AAErD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAiC;IACpE,gBAAgB,GAAG,QAAQ,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AAEH,IAAM,WAAW,GAAjB,MAAM,WAAW;IAChB;;OAEG;IAKH,MAAM,CAAC,OAAe,EAAE,QAAgB;QACvC,IAAI,gBAAgB,EAAE,CAAC;YACtB,IAAI,CAAC;gBACJ,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;YAClD,CAAC;QACF,CAAC;IACF,CAAC;CACD,CAAA;AATA;IAJC,aAAa,CAAC,sDAAsD,EAAE;QACtE,OAAO,EAAE,EAAE,WAAW,EAAE,kBAAkB,EAAE;QAC5C,QAAQ,EAAE,EAAE,WAAW,EAAE,2BAA2B,EAAE;KACtD,CAAC;;;;yCASD;AAhBI,WAAW;IADhB,UAAU,CAAC,UAAU,EAAE,qDAAqD,CAAC;GACxE,WAAW,CAiBhB;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC"}

package/dist/runtime/src/progress/types.d.ts

@@ -0,0 +1,7 @@
+/**
+
+/**
+ * Progress callback function type
+ */
+export type ProgressCallback = (message: string, fraction: number) => void;
+//# sourceMappingURL=types.d.ts.map