@elaraai/e3-api-server 1.0.4 → 1.0.6

package/README.md

@@ -258,8 +258,9 @@ BSL 1.1. See [LICENSE.md](./LICENSE.md).
   - [@elaraai/east-node-io](https://www.npmjs.com/package/@elaraai/east-node-io): SQLite, PostgreSQL, MySQL, MongoDB, Redis, S3, FTP, SFTP, XLSX, XML, compression
   - [@elaraai/east-node-cli](https://www.npmjs.com/package/@elaraai/east-node-cli): CLI for running East IR programs in Node.js
 
-- **[East C](https://github.com/elaraai/east-workspace/tree/main/libs/east-c)**: C11 native runtime for executing East IR. Tarballed for `linux-x64` and `linux-arm64`, attached to each GitHub Release.
-  - `east-c`: Core runtime — type system, IR interpreter, 200+ builtins, serialization (Beast2, JSON, CSV, East text)
+- **[East C](https://github.com/elaraai/east-workspace/tree/main/libs/east-c)**: C11 native runtime for executing East IR. Distributed via npm (launcher + per-platform optional dependencies) and as tarballs on each GitHub Release.
+  - [@elaraai/east-c-cli](https://www.npmjs.com/package/@elaraai/east-c-cli): npm launcher — installs the matching native binary as an optional dependency
+  - `east-c`: Core runtime — type system, IR interpreter, builtins, serialization (Beast2, JSON, CSV, East text)
   - `east-c-std`: Console, FileSystem, Fetch, Crypto, Time, Path, Random
   - `east-c-cli`: CLI for running East IR programs natively
 

package/bin/e3-api-server.mjs

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ *
+ * Static bin shim — exists in fresh checkout so pnpm install can create
+ * the bin symlink BEFORE the package is built. Dynamic-imports the
+ * built CLI entrypoint; argv flows through via process.argv.
+ */
+await import('../dist/src/cli.js');

package/dist/src/function-call-state.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { ExecuteResult, CallStatusResult } from './types.js';
+/**
+ * Create a new function call and return its ID plus the AbortController
+ * that cancels it.
+ */
+export declare function createFunctionCall(): {
+    callId: string;
+    abort: AbortController;
+};
+/**
+ * Mark a call as succeeded with its terminal ExecuteResult.
+ *
+ * "Succeeded" means the call ran to a terminal result — the result itself
+ * may still carry a `failed`/`too_large`/`timed_out` outcome.
+ */
+export declare function completeFunctionCall(callId: string, result: ExecuteResult): void;
+/**
+ * Mark a call as failed with an infrastructure error message.
+ */
+export declare function failFunctionCall(callId: string, error: string): void;
+/**
+ * Get the status of a call as a wire CallStatusResult.
+ * Returns null if the call doesn't exist (or was evicted).
+ */
+export declare function getFunctionCall(callId: string): CallStatusResult | null;
+/**
+ * Cancel an in-flight call: abort its process and mark it cancelled.
+ * Returns false if the call doesn't exist; true otherwise (idempotent for
+ * already-terminal calls).
+ */
+export declare function cancelFunctionCall(callId: string): boolean;
+/**
+ * Clear all call state. Useful for cleanup in tests.
+ */
+export declare function clearAllFunctionCalls(): void;
+//# sourceMappingURL=function-call-state.d.ts.map

package/dist/src/function-call-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-call-state.d.ts","sourceRoot":"","sources":["../../src/function-call-state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA+BlE;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAU/E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAQhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA4BvE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAY1D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/src/function-call-state.js

@@ -0,0 +1,132 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * In-memory state storage for async function / one-shot calls.
+ *
+ * Modelled on async-operation-state.ts (the GC pattern), with the eviction
+ * gap fixed: terminal entries are evicted after a TTL on a lazy sweep at
+ * each read/write, so the registry can't grow without bound. The finished
+ * result is held only transiently until polled — never in the durable
+ * object store.
+ *
+ * This serves as a development/test mock for the short-TTL DynamoDB record
+ * used by the cloud (ComputeResultStore pattern).
+ */
+import { randomUUID } from 'crypto';
+import { variant, some, none } from '@elaraai/east';
+/** How long a terminal call entry survives un-polled. */
+const CALL_TTL_MS = 5 * 60 * 1000;
+// Key: callId (UUID)
+const calls = new Map();
+/**
+ * Evict terminal entries older than the TTL. Called lazily on every
+ * read/write — no timers to leak.
+ */
+function sweep() {
+    const now = Date.now();
+    for (const [id, call] of calls) {
+        if (call.completedAt !== undefined && now - call.completedAt > CALL_TTL_MS) {
+            calls.delete(id);
+        }
+    }
+}
+/**
+ * Create a new function call and return its ID plus the AbortController
+ * that cancels it.
+ */
+export function createFunctionCall() {
+    sweep();
+    const callId = randomUUID();
+    const abort = new AbortController();
+    calls.set(callId, {
+        status: 'running',
+        startedAt: Date.now(),
+        abort,
+    });
+    return { callId, abort };
+}
+/**
+ * Mark a call as succeeded with its terminal ExecuteResult.
+ *
+ * "Succeeded" means the call ran to a terminal result — the result itself
+ * may still carry a `failed`/`too_large`/`timed_out` outcome.
+ */
+export function completeFunctionCall(callId, result) {
+    sweep();
+    const call = calls.get(callId);
+    if (call && call.status === 'running') {
+        call.status = 'succeeded';
+        call.completedAt = Date.now();
+        call.result = result;
+    }
+}
+/**
+ * Mark a call as failed with an infrastructure error message.
+ */
+export function failFunctionCall(callId, error) {
+    sweep();
+    const call = calls.get(callId);
+    if (call && call.status === 'running') {
+        call.status = 'failed';
+        call.completedAt = Date.now();
+        call.error = error;
+    }
+}
+/**
+ * Get the status of a call as a wire CallStatusResult.
+ * Returns null if the call doesn't exist (or was evicted).
+ */
+export function getFunctionCall(callId) {
+    sweep();
+    const call = calls.get(callId);
+    if (!call) {
+        return null;
+    }
+    let status;
+    switch (call.status) {
+        case 'running':
+            status = variant('running', null);
+            break;
+        case 'succeeded':
+            status = variant('succeeded', null);
+            break;
+        case 'failed':
+            status = variant('failed', null);
+            break;
+        case 'cancelled':
+            status = variant('cancelled', null);
+            break;
+    }
+    return {
+        status,
+        result: call.result ? some(call.result) : none,
+        error: call.error ? some(call.error) : none,
+    };
+}
+/**
+ * Cancel an in-flight call: abort its process and mark it cancelled.
+ * Returns false if the call doesn't exist; true otherwise (idempotent for
+ * already-terminal calls).
+ */
+export function cancelFunctionCall(callId) {
+    sweep();
+    const call = calls.get(callId);
+    if (!call) {
+        return false;
+    }
+    if (call.status === 'running') {
+        call.status = 'cancelled';
+        call.completedAt = Date.now();
+        call.abort.abort();
+    }
+    return true;
+}
+/**
+ * Clear all call state. Useful for cleanup in tests.
+ */
+export function clearAllFunctionCalls() {
+    calls.clear();
+}
+//# sourceMappingURL=function-call-state.js.map

package/dist/src/function-call-state.js.map

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

package/dist/src/handlers/functions.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { StorageBackend, TaskRunner } from '@elaraai/e3-core';
+import { type FunctionCallRequest, type OneShotRequest } from '../types.js';
+/**
+ * List a package's functions with their signatures.
+ */
+export declare function listPackageFunctions(storage: StorageBackend, repoPath: string, pkgName: string, version: string): Promise<Response>;
+/**
+ * Describe a single function (signature) so dynamic callers can encode args.
+ */
+export declare function describePackageFunction(storage: StorageBackend, repoPath: string, pkgName: string, version: string, fnName: string): Promise<Response>;
+/**
+ * Call a named function synchronously: resolve → validate arity → run →
+ * 200 ExecuteResult. The sync path enforces a server-owned deadline so the
+ * caller gets a structured `timed_out` instead of a transport cut.
+ */
+export declare function callFunctionSync(storage: StorageBackend, repoPath: string, runner: TaskRunner, pkgName: string, version: string, fnName: string, req: FunctionCallRequest): Promise<Response>;
+/**
+ * Call a named function asynchronously: resolve up front (so a missing
+ * function is a request error, not a failed call), then fire the run
+ * detached and return 202 `{callId}` for polling.
+ */
+export declare function callFunctionAsync(storage: StorageBackend, repoPath: string, runner: TaskRunner, pkgName: string, version: string, fnName: string, req: FunctionCallRequest): Promise<Response>;
+/**
+ * Poll an async call's status (and result, once terminal).
+ */
+export declare function getCallStatus(callId: string): Response;
+/**
+ * Cancel an in-flight async call (kills the runner's process group).
+ */
+export declare function cancelCall(callId: string): Response;
+/**
+ * Run a one-shot synchronously. SECURITY: caller-supplied IR — the route
+ * layer gates this behind an elevated role.
+ */
+export declare function callOneShotSync(storage: StorageBackend, repoPath: string, runner: TaskRunner, workspace: string, req: OneShotRequest): Promise<Response>;
+/**
+ * Launch a one-shot asynchronously → 202 `{callId}`. Dataset args are
+ * resolved + pinned inside the detached run at launch time.
+ */
+export declare function callOneShotAsync(storage: StorageBackend, repoPath: string, runner: TaskRunner, workspace: string, req: OneShotRequest): Promise<Response>;
+//# sourceMappingURL=functions.d.ts.map

package/dist/src/handlers/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../../src/handlers/functions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsBH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAInF,OAAO,EAOL,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAkOrB;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,QAAQ,CAAC,CAkBnB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,QAAQ,CAAC,CAYnB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC,QAAQ,CAAC,CAQnB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,mBAAmB,GACvB,OAAO,CAAC,QAAQ,CAAC,CAkBnB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAMtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAMnD;AAMD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,QAAQ,CAAC,CASnB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,QAAQ,CAAC,CAkBnB"}

package/dist/src/handlers/functions.js

@@ -0,0 +1,321 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Handlers for named package functions and one-shot execution.
+ *
+ * Both reduce to the graph-free `runDetached` primitive: marshal inputs →
+ * run a body IR on a runner → return the result inline. Nothing durable is
+ * written — no output object, no execution record, no logs, no dataset ref.
+ *
+ * Named functions are author-published IR (same trust as a deployed task).
+ * One-shot evaluates CALLER-supplied IR — remote code execution with the
+ * server's authority — and must be gated by the route layer (see
+ * routes/functions.ts).
+ */
+import { ArrayType, NullType, decodeBeast2For, variant, none } from '@elaraai/east';
+import { packageRead, workspaceGetPackage, workspaceGetDatasetHash, TaskNotFoundError, } from '@elaraai/e3-core';
+import { FunctionObjectType } from '@elaraai/e3-types';
+import { sendSuccess, sendError, sendSuccessWithStatus } from '../beast2.js';
+import { errorToVariant } from '../errors.js';
+import { FunctionSignatureType, ExecuteResultType, CallStartResultType, CallStatusResultType, } from '../types.js';
+import { createFunctionCall, completeFunctionCall, failFunctionCall, getFunctionCall, cancelFunctionCall, } from '../function-call-state.js';
+// =============================================================================
+// Limits (server-owned, clamped)
+// =============================================================================
+/** Default per-call timeout when the request doesn't specify one. */
+const DEFAULT_TIMEOUT_MS = 60_000;
+/** Hard ceiling on any call's timeout (async included). */
+const MAX_TIMEOUT_MS = 10 * 60_000;
+/** Sync calls additionally respect a server-owned wall-clock deadline so the
+ *  caller gets a structured `timed_out` instead of a transport cut. (The
+ *  cloud sets this below API Gateway's 29 s; locally we can be generous.) */
+const SERVER_SYNC_DEADLINE_MS = 120_000;
+/** Default + ceiling for the inline result size (see design §9: 1 MB leaves
+ *  3-4x headroom under the base64-inflated Lambda ceiling and still allows
+ *  multi-thousand-row tables inline). Requests may lower it, never raise it. */
+const MAX_RESULT_BYTES = 1024 * 1024;
+/** Default + ceiling for each captured log stream's tail. */
+const MAX_LOG_BYTES = 256 * 1024;
+const DEFAULT_LOG_BYTES = 64 * 1024;
+function resolveLimits(limits, sync) {
+    const req = limits.type === 'some' ? limits.value : undefined;
+    let timeoutMs = req && req.timeoutMs.type === 'some'
+        ? Number(req.timeoutMs.value)
+        : DEFAULT_TIMEOUT_MS;
+    timeoutMs = Math.min(Math.max(1, timeoutMs), MAX_TIMEOUT_MS);
+    if (sync)
+        timeoutMs = Math.min(timeoutMs, SERVER_SYNC_DEADLINE_MS);
+    let maxResultBytes = req && req.maxResultBytes.type === 'some'
+        ? Number(req.maxResultBytes.value)
+        : MAX_RESULT_BYTES;
+    maxResultBytes = Math.min(Math.max(1, maxResultBytes), MAX_RESULT_BYTES);
+    let maxLogBytes = req && req.maxLogBytes.type === 'some'
+        ? Number(req.maxLogBytes.value)
+        : DEFAULT_LOG_BYTES;
+    maxLogBytes = Math.min(Math.max(0, maxLogBytes), MAX_LOG_BYTES);
+    return { timeoutMs, maxResultBytes, maxLogBytes };
+}
+// =============================================================================
+// Shared helpers
+// =============================================================================
+const decodeFunctionObject = decodeBeast2For(FunctionObjectType);
+/**
+ * Resolve a named function in a package to its FunctionObject.
+ *
+ * @throws {TaskNotFoundError} If the function doesn't exist (functions are
+ *   named callables; the wire format has no separate function_not_found tag —
+ *   adding one would reorder ErrorType's sorted variant tags, a breaking
+ *   wire change).
+ */
+async function resolveFunction(storage, repoPath, pkgName, version, fnName) {
+    const pkg = await packageRead(storage, repoPath, pkgName, version);
+    const fnHash = pkg.functions.get(fnName);
+    if (!fnHash) {
+        throw new TaskNotFoundError(`function '${fnName}' in ${pkgName}@${version}`);
+    }
+    const fnData = await storage.objects.read(repoPath, fnHash);
+    return decodeFunctionObject(Buffer.from(fnData));
+}
+/** Map a DetachedResult to the wire ExecuteResult. */
+function detachedToExecuteResult(result) {
+    const streams = {
+        stdout: result.stdout,
+        stderr: result.stderr,
+        stdoutTruncated: result.stdoutTruncated,
+        stderrTruncated: result.stderrTruncated,
+    };
+    switch (result.kind) {
+        case 'success':
+            return { outcome: variant('success', { value: result.value }), ...streams };
+        case 'failed':
+            return { outcome: variant('failed', { exitCode: BigInt(result.exitCode) }), ...streams };
+        case 'too_large':
+            return { outcome: variant('too_large', { bytes: BigInt(result.bytes), limit: BigInt(result.limit) }), ...streams };
+        case 'timed_out':
+            return { outcome: variant('timed_out', { ms: BigInt(result.ms) }), ...streams };
+    }
+}
+/** Build an `invalid` ExecuteResult (signature/IR error; nothing ran). */
+function invalidResult(message) {
+    return {
+        outcome: variant('invalid', {
+            diagnostics: [{ message, filename: none, line: none, column: none }],
+        }),
+        stdout: '',
+        stderr: '',
+        stdoutTruncated: false,
+        stderrTruncated: false,
+    };
+}
+/**
+ * Execute a resolved named function: arity check → read bodyIr → runDetached.
+ * Never throws for execution outcomes — only for storage/infra errors.
+ */
+async function executeFunction(storage, repoPath, runner, fnObj, req, sync, signal) {
+    // Signature validation: arity is checked here, before anything runs.
+    // Per-element type errors surface as a runtime decode failure (`failed`)
+    // from the runner.
+    if (req.args.length !== fnObj.inputTypes.length) {
+        return invalidResult(`Expected ${fnObj.inputTypes.length} argument(s), got ${req.args.length}`);
+    }
+    const bodyIr = await storage.objects.read(repoPath, fnObj.bodyIr);
+    const runnerValue = req.runner.type === 'some' ? req.runner.value : fnObj.runner;
+    const limits = resolveLimits(req.limits, sync);
+    const result = await runner.runDetached({
+        bodyIr,
+        args: req.args.map((a) => a),
+        runner: runnerValue,
+        limits,
+    }, { signal });
+    return detachedToExecuteResult(result);
+}
+/**
+ * Resolve one-shot args: inline values pass through; dataset paths are
+ * resolved + pinned by content hash at launch (objects are immutable, so no
+ * lock is needed — snapshot consistency).
+ *
+ * @returns The arg bytes, or an `invalid` ExecuteResult if a dataset arg is
+ *   unassigned.
+ */
+async function resolveOneShotArgs(storage, repoPath, workspace, args) {
+    const bytes = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.type === 'value') {
+            bytes.push(arg.value);
+        }
+        else {
+            const path = arg.value;
+            const { refType, hash } = await workspaceGetDatasetHash(storage, repoPath, workspace, path);
+            if (refType !== 'value' || hash === null) {
+                return {
+                    ok: false,
+                    invalid: invalidResult(`Dataset argument ${i} is not assigned (ref type: ${refType})`),
+                };
+            }
+            bytes.push(await storage.objects.read(repoPath, hash));
+        }
+    }
+    return { ok: true, bytes };
+}
+/** Execute a one-shot request (bodyIr from the request). */
+async function executeOneShot(storage, repoPath, workspace, runner, req, sync, signal) {
+    const resolved = await resolveOneShotArgs(storage, repoPath, workspace, req.args);
+    if (!resolved.ok) {
+        return resolved.invalid;
+    }
+    const limits = resolveLimits(req.limits, sync);
+    const result = await runner.runDetached({
+        bodyIr: req.bodyIr,
+        args: resolved.bytes,
+        runner: req.runner,
+        limits,
+    }, { signal });
+    return detachedToExecuteResult(result);
+}
+// =============================================================================
+// Named function handlers
+// =============================================================================
+/**
+ * List a package's functions with their signatures.
+ */
+export async function listPackageFunctions(storage, repoPath, pkgName, version) {
+    try {
+        const pkg = await packageRead(storage, repoPath, pkgName, version);
+        const signatures = [];
+        for (const [name, fnHash] of pkg.functions) {
+            const fnData = await storage.objects.read(repoPath, fnHash);
+            const fnObj = decodeFunctionObject(Buffer.from(fnData));
+            signatures.push({
+                name,
+                inputTypes: fnObj.inputTypes,
+                outputType: fnObj.outputType,
+                runner: fnObj.runner,
+            });
+        }
+        return sendSuccess(ArrayType(FunctionSignatureType), signatures);
+    }
+    catch (err) {
+        return sendError(ArrayType(FunctionSignatureType), errorToVariant(err));
+    }
+}
+/**
+ * Describe a single function (signature) so dynamic callers can encode args.
+ */
+export async function describePackageFunction(storage, repoPath, pkgName, version, fnName) {
+    try {
+        const fnObj = await resolveFunction(storage, repoPath, pkgName, version, fnName);
+        return sendSuccess(FunctionSignatureType, {
+            name: fnName,
+            inputTypes: fnObj.inputTypes,
+            outputType: fnObj.outputType,
+            runner: fnObj.runner,
+        });
+    }
+    catch (err) {
+        return sendError(FunctionSignatureType, errorToVariant(err));
+    }
+}
+/**
+ * Call a named function synchronously: resolve → validate arity → run →
+ * 200 ExecuteResult. The sync path enforces a server-owned deadline so the
+ * caller gets a structured `timed_out` instead of a transport cut.
+ */
+export async function callFunctionSync(storage, repoPath, runner, pkgName, version, fnName, req) {
+    try {
+        const fnObj = await resolveFunction(storage, repoPath, pkgName, version, fnName);
+        const result = await executeFunction(storage, repoPath, runner, fnObj, req, true);
+        return sendSuccess(ExecuteResultType, result);
+    }
+    catch (err) {
+        return sendError(ExecuteResultType, errorToVariant(err));
+    }
+}
+/**
+ * Call a named function asynchronously: resolve up front (so a missing
+ * function is a request error, not a failed call), then fire the run
+ * detached and return 202 `{callId}` for polling.
+ */
+export async function callFunctionAsync(storage, repoPath, runner, pkgName, version, fnName, req) {
+    try {
+        const fnObj = await resolveFunction(storage, repoPath, pkgName, version, fnName);
+        const { callId, abort } = createFunctionCall();
+        void (async () => {
+            try {
+                const result = await executeFunction(storage, repoPath, runner, fnObj, req, false, abort.signal);
+                completeFunctionCall(callId, result);
+            }
+            catch (err) {
+                failFunctionCall(callId, err instanceof Error ? err.message : String(err));
+            }
+        })();
+        return sendSuccessWithStatus(CallStartResultType, { callId }, 202);
+    }
+    catch (err) {
+        return sendError(CallStartResultType, errorToVariant(err));
+    }
+}
+/**
+ * Poll an async call's status (and result, once terminal).
+ */
+export function getCallStatus(callId) {
+    const status = getFunctionCall(callId);
+    if (!status) {
+        return sendError(CallStatusResultType, variant('execution_not_found', { task: callId }));
+    }
+    return sendSuccess(CallStatusResultType, status);
+}
+/**
+ * Cancel an in-flight async call (kills the runner's process group).
+ */
+export function cancelCall(callId) {
+    const found = cancelFunctionCall(callId);
+    if (!found) {
+        return sendError(NullType, variant('execution_not_found', { task: callId }));
+    }
+    return sendSuccess(NullType, null);
+}
+// =============================================================================
+// One-shot handlers (workspace-scoped; anonymous caller-supplied IR)
+// =============================================================================
+/**
+ * Run a one-shot synchronously. SECURITY: caller-supplied IR — the route
+ * layer gates this behind an elevated role.
+ */
+export async function callOneShotSync(storage, repoPath, runner, workspace, req) {
+    try {
+        // Validate the workspace exists / is deployed before running anything.
+        await workspaceGetPackage(storage, repoPath, workspace);
+        const result = await executeOneShot(storage, repoPath, workspace, runner, req, true);
+        return sendSuccess(ExecuteResultType, result);
+    }
+    catch (err) {
+        return sendError(ExecuteResultType, errorToVariant(err));
+    }
+}
+/**
+ * Launch a one-shot asynchronously → 202 `{callId}`. Dataset args are
+ * resolved + pinned inside the detached run at launch time.
+ */
+export async function callOneShotAsync(storage, repoPath, runner, workspace, req) {
+    try {
+        await workspaceGetPackage(storage, repoPath, workspace);
+        const { callId, abort } = createFunctionCall();
+        void (async () => {
+            try {
+                const result = await executeOneShot(storage, repoPath, workspace, runner, req, false, abort.signal);
+                completeFunctionCall(callId, result);
+            }
+            catch (err) {
+                failFunctionCall(callId, err instanceof Error ? err.message : String(err));
+            }
+        })();
+        return sendSuccessWithStatus(CallStartResultType, { callId }, 202);
+    }
+    catch (err) {
+        return sendError(CallStartResultType, errorToVariant(err));
+    }
+}
+//# sourceMappingURL=functions.js.map

package/dist/src/handlers/functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../../src/handlers/functions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAwD,MAAM,mBAAmB,CAAC;AAC7G,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,GAKrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,gFAAgF;AAChF,iCAAiC;AACjC,gFAAgF;AAEhF,qEAAqE;AACrE,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,2DAA2D;AAC3D,MAAM,cAAc,GAAG,EAAE,GAAG,MAAM,CAAC;AACnC;;6EAE6E;AAC7E,MAAM,uBAAuB,GAAG,OAAO,CAAC;AACxC;;gFAEgF;AAChF,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAC;AACrC,6DAA6D;AAC7D,MAAM,aAAa,GAAG,GAAG,GAAG,IAAI,CAAC;AACjC,MAAM,iBAAiB,GAAG,EAAE,GAAG,IAAI,CAAC;AAQpC,SAAS,aAAa,CACpB,MAA8E,EAC9E,IAAa;IAEb,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9D,IAAI,SAAS,GAAG,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM;QAClD,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC;QAC7B,CAAC,CAAC,kBAAkB,CAAC;IACvB,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,cAAc,CAAC,CAAC;IAC7D,IAAI,IAAI;QAAE,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC;IAEnE,IAAI,cAAc,GAAG,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,IAAI,KAAK,MAAM;QAC5D,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC;QAClC,CAAC,CAAC,gBAAgB,CAAC;IACrB,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAEzE,IAAI,WAAW,GAAG,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,MAAM;QACtD,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC;QAC/B,CAAC,CAAC,iBAAiB,CAAC;IACtB,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,aAAa,CAAC,CAAC;IAEhE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;AACpD,CAAC;AAED,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,MAAM,oBAAoB,GAAG,eAAe,CAAC,kBAAkB,CAAC,CAAC;AAEjE;;;;;;;GAOG;AACH,KAAK,UAAU,eAAe,CAC5B,OAAuB,EACvB,QAAgB,EAChB,OAAe,EACf,OAAe,EACf,MAAc;IAEd,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,iBAAiB,CAAC,aAAa,MAAM,QAAQ,OAAO,IAAI,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5D,OAAO,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,sDAAsD;AACtD,SAAS,uBAAuB,CAAC,MAAsB;IACrD,MAAM,OAAO,GAAG;QACd,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,eAAe,EAAE,MAAM,CAAC,eAAe;KACxC,CAAC;IACF,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;QAC9E,KAAK,QAAQ;YACX,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;QAC3F,KAAK,WAAW;YACd,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;QACrH,KAAK,WAAW;YACd,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;IACpF,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,SAAS,aAAa,CAAC,OAAe;IACpC,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE;YAC1B,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SACrE,CAAC;QACF,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,EAAE;QACV,eAAe,EAAE,KAAK;QACtB,eAAe,EAAE,KAAK;KACvB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,eAAe,CAC5B,OAAuB,EACvB,QAAgB,EAChB,MAAkB,EAClB,KAAqB,EACrB,GAAwB,EACxB,IAAa,EACb,MAAoB;IAEpB,qEAAqE;IACrE,yEAAyE;IACzE,mBAAmB;IACnB,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QAChD,OAAO,aAAa,CAClB,YAAY,KAAK,CAAC,UAAU,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAC1E,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,WAAW,GAAgB,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IAC9F,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE/C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CACrC;QACE,MAAM;QACN,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAe,CAAC;QAC1C,MAAM,EAAE,WAAW;QACnB,MAAM;KACP,EACD,EAAE,MAAM,EAAE,CACX,CAAC;IACF,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,kBAAkB,CAC/B,OAAuB,EACvB,QAAgB,EAChB,SAAiB,EACjB,IAA4B;IAE5B,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACrB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAmB,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,GAAG,CAAC,KAAiB,CAAC;YACnC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,uBAAuB,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;YAC5F,IAAI,OAAO,KAAK,OAAO,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBACzC,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,OAAO,EAAE,aAAa,CAAC,oBAAoB,CAAC,+BAA+B,OAAO,GAAG,CAAC;iBACvF,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,4DAA4D;AAC5D,KAAK,UAAU,cAAc,CAC3B,OAAuB,EACvB,QAAgB,EAChB,SAAiB,EACjB,MAAkB,EAClB,GAAmB,EACnB,IAAa,EACb,MAAoB;IAEpB,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IAClF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CACrC;QACE,MAAM,EAAE,GAAG,CAAC,MAAoB;QAChC,IAAI,EAAE,QAAQ,CAAC,KAAK;QACpB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,MAAM;KACP,EACD,EAAE,MAAM,EAAE,CACX,CAAC;IACF,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAuB,EACvB,QAAgB,EAChB,OAAe,EACf,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,EAAE,CAAC;QACtB,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YACxD,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI;gBACJ,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,WAAW,CAAC,SAAS,CAAC,qBAAqB,CAAC,EAAE,UAAU,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,SAAS,CAAC,SAAS,CAAC,qBAAqB,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAuB,EACvB,QAAgB,EAChB,OAAe,EACf,OAAe,EACf,MAAc;IAEd,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACjF,OAAO,WAAW,CAAC,qBAAqB,EAAE;YACxC,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,SAAS,CAAC,qBAAqB,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAuB,EACvB,QAAgB,EAChB,MAAkB,EAClB,OAAe,EACf,OAAe,EACf,MAAc,EACd,GAAwB;IAExB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAClF,OAAO,WAAW,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,SAAS,CAAC,iBAAiB,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAuB,EACvB,QAAgB,EAChB,MAAkB,EAClB,OAAe,EACf,OAAe,EACf,MAAc,EACd,GAAwB;IAExB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACjF,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,kBAAkB,EAAE,CAAC;QAE/C,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBACjG,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,gBAAgB,CAAC,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,qBAAqB,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC;IACrE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,SAAS,CAAC,mBAAmB,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC,oBAAoB,EAAE,OAAO,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,WAAW,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,gFAAgF;AAChF,qEAAqE;AACrE,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAuB,EACvB,QAAgB,EAChB,MAAkB,EAClB,SAAiB,EACjB,GAAmB;IAEnB,IAAI,CAAC;QACH,uEAAuE;QACvE,MAAM,mBAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACrF,OAAO,WAAW,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,SAAS,CAAC,iBAAiB,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAuB,EACvB,QAAgB,EAChB,MAAkB,EAClB,SAAiB,EACjB,GAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,mBAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACxD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,kBAAkB,EAAE,CAAC;QAE/C,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBACpG,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,gBAAgB,CAAC,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,qBAAqB,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC;IACrE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,SAAS,CAAC,mBAAmB,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC"}

package/dist/src/handlers/functions.spec.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+export {};
+//# sourceMappingURL=functions.spec.d.ts.map

package/dist/src/handlers/functions.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.spec.d.ts","sourceRoot":"","sources":["../../../src/handlers/functions.spec.ts"],"names":[],"mappings":"AAAA;;;GAGG"}