@mondaydotcomorg/atp-runtime 0.17.14

package/dist/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/metadata/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../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/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/metadata/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../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/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/metadata/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../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/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/metadata/types.js.map

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

package/dist/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/pause/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../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/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/pause/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../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/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/pause/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../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/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/pause/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../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/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/progress/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../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/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/progress/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../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/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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/progress/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC"}

package/dist/progress/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/progress/types.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Runtime API Registry
+ *
+ */
+import type { RuntimeAPIMetadata } from './metadata/index.js';
+/**
+ * Get all registered runtime APIs metadata
+ *
+ * This is generated at BUILD TIME by ts-morph, not at runtime
+ */
+export declare function getAllAPIs(): RuntimeAPIMetadata[];
+/**
+ * Get metadata for a specific API by name
+ */
+export declare function getAPI(name: string): RuntimeAPIMetadata | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,kBAAkB,EAAE,CAEjD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEnE"}

package/dist/registry.js

@@ -0,0 +1,16 @@
+import { GENERATED_METADATA } from './metadata/generated.js';
+/**
+ * Get all registered runtime APIs metadata
+ *
+ * This is generated at BUILD TIME by ts-morph, not at runtime
+ */
+export function getAllAPIs() {
+    return GENERATED_METADATA;
+}
+/**
+ * Get metadata for a specific API by name
+ */
+export function getAPI(name) {
+    return GENERATED_METADATA.find((api) => api.name === name);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACzB,OAAO,kBAAkB,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY;IAClC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC5D,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,11 @@
+export interface RetryOptions {
+    maxAttempts: number;
+    delayMs: number;
+}
+export declare const utils: {
+    sleep(ms: number): Promise<void>;
+    retry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
+    parallel<T>(tasks: Array<() => Promise<T>>): Promise<T[]>;
+    sequence<T>(tasks: Array<() => Promise<T>>): Promise<T[]>;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,KAAK;cACD,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;UAI1B,CAAC,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC,WAAW,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC;aAexD,CAAC,SAAS,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;aAIhD,CAAC,SAAS,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;CAO/D,CAAC"}

package/dist/utils.js

@@ -0,0 +1,31 @@
+export const utils = {
+    async sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    },
+    async retry(fn, options) {
+        let lastError;
+        for (let attempt = 1; attempt <= options.maxAttempts; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt < options.maxAttempts) {
+                    await this.sleep(options.delayMs);
+                }
+            }
+        }
+        throw lastError;
+    },
+    async parallel(tasks) {
+        return Promise.all(tasks.map((task) => task()));
+    },
+    async sequence(tasks) {
+        const results = [];
+        for (const task of tasks) {
+            results.push(await task());
+        }
+        return results;
+    },
+};
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,KAAK,GAAG;IACpB,KAAK,CAAC,KAAK,CAAC,EAAU;QACrB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,KAAK,CAAI,EAAoB,EAAE,OAAqB;QACzD,IAAI,SAA4B,CAAC;QACjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACjE,IAAI,CAAC;gBACJ,OAAO,MAAM,EAAE,EAAE,CAAC;YACnB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,SAAS,GAAG,KAAc,CAAC;gBAC3B,IAAI,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;oBACnC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACnC,CAAC;YACF,CAAC;QACF,CAAC;QACD,MAAM,SAAS,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAI,KAA8B;QAC/C,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAI,KAA8B;QAC/C,MAAM,OAAO,GAAQ,EAAE,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,OAAO,CAAC;IAChB,CAAC;CACD,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+	"name": "@mondaydotcomorg/atp-runtime",
+	"version": "0.17.14",
+	"description": "Runtime SDK injected into sandbox for Agent Tool Protocol",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"src"
+	],
+	"scripts": {
+		"build": "npm run generate:metadata && tsc -p tsconfig.json",
+		"generate:metadata": "tsx scripts/generate-metadata.ts",
+		"dev": "tsc -p tsconfig.json --watch",
+		"clean": "rm -rf dist *.tsbuildinfo src/metadata/generated.ts",
+		"test": "vitest run",
+		"lint": "tsc --noEmit"
+	},
+	"keywords": [
+		"agent",
+		"protocol",
+		"runtime",
+		"sdk",
+		"ai",
+		"llm"
+	],
+	"license": "MIT",
+	"dependencies": {
+		"ioredis": "^5.8.0",
+		"node-cache": "*",
+		"pino": "*",
+		"pino-pretty": "*",
+		"reflect-metadata": "^0.2.1",
+		"undici": "*"
+	},
+	"devDependencies": {
+		"@types/node": "^20.11.5",
+		"ts-json-schema-generator": "^2.4.0",
+		"ts-morph": "^21.0.1",
+		"tsx": "^4.7.0",
+		"typescript": "^5.3.3",
+		"vitest": "^1.2.1"
+	}
+}

package/src/approval/handler.ts

@@ -0,0 +1,26 @@
+/**
+ */
+import type { ApprovalRequest, ApprovalResponse } from './types';
+
+/**
+ * Global approval handler that must be set by the execution context
+ */
+let approvalHandler: ((request: ApprovalRequest) => Promise<ApprovalResponse>) | null = null;
+
+/**
+ * Initialize the approval system with a custom handler
+ */
+export function initializeApproval(
+	handler: (request: ApprovalRequest) => Promise<ApprovalResponse>
+): void {
+	approvalHandler = handler;
+}
+
+/**
+ * Get the current approval handler
+ */
+export function getApprovalHandler():
+	| ((request: ApprovalRequest) => Promise<ApprovalResponse>)
+	| null {
+	return approvalHandler;
+}

package/src/approval/index.ts

@@ -0,0 +1,95 @@
+/**
+ * Approval API - Clean refactored version with decorators and extracted modules
+ *
+ * Benefits:
+ * - No duplication between implementation and metadata
+ * - Types auto-detected from TypeScript signatures
+ * - Clean separation of concerns (handler, API)
+ */
+import { RuntimeAPI, RuntimeMethod } from '../metadata/decorators.js';
+import { getApprovalHandler } from './handler.js';
+import { pauseForCallback, CallbackType, ApprovalOperation } from '../pause/index.js';
+import type { ApprovalRequest, ApprovalResponse } from './types';
+import { nextSequenceNumber, getCachedResult, shouldPauseForClient } from '../llm/replay.js';
+
+export type { ApprovalRequest, ApprovalResponse, ApprovalSchema } from './types';
+export { initializeApproval } from './handler.js';
+
+/**
+ * Approval Runtime API
+ *
+ * Allows agents to request explicit human approval before proceeding with sensitive operations.
+ * This integrates with MCP's elicitation feature to request structured input from users.
+ */
+@RuntimeAPI('approval', 'Approval API - Request explicit human approval for sensitive operations')
+class ApprovalAPI {
+	/**
+	 * Request approval from a human
+	 */
+	@RuntimeMethod('Request approval from a human', {
+		message: {
+			description: 'The message to display to the user',
+		},
+		context: {
+			description: 'Optional context information about what needs approval',
+			optional: true,
+			type: 'Record<string, unknown>',
+		},
+	})
+	async request(message: string, context?: Record<string, unknown>): Promise<ApprovalResponse> {
+		const currentSequence = nextSequenceNumber();
+
+		const cachedResult = getCachedResult(currentSequence);
+		if (cachedResult !== undefined) {
+			return cachedResult as ApprovalResponse;
+		}
+
+		if (shouldPauseForClient()) {
+			pauseForCallback(CallbackType.APPROVAL, ApprovalOperation.REQUEST, {
+				message,
+				context,
+				sequenceNumber: currentSequence,
+			});
+		}
+
+		const handler = getApprovalHandler();
+
+		if (!handler) {
+			throw new Error(
+				'Approval handler not configured. Human approval is required but no handler is set.'
+			);
+		}
+
+		const approvalRequest: ApprovalRequest = {
+			message,
+			context,
+			timeout: 300000,
+		};
+
+		let timeoutId: NodeJS.Timeout | null = null;
+		const timeoutPromise = new Promise<ApprovalResponse>((_, reject) => {
+			timeoutId = setTimeout(
+				() => reject(new Error('Approval request timed out')),
+				approvalRequest.timeout!
+			);
+		});
+
+		try {
+			const response = await Promise.race([handler(approvalRequest), timeoutPromise]);
+
+			if (timeoutId) clearTimeout(timeoutId);
+
+			return {
+				...response,
+				timestamp: Date.now(),
+			};
+		} catch (error) {
+			if (timeoutId) clearTimeout(timeoutId);
+			throw new Error(
+				`Approval request failed: ${error instanceof Error ? error.message : 'Unknown error'}`
+			);
+		}
+	}
+}
+
+export const approval = new ApprovalAPI();