actoviq-agent-sdk 0.4.6 → 0.4.7

package/dist/src/runtime-v2/tools.js

@@ -0,0 +1,185 @@
+export class ToolExecutionError extends Error {
+    failure;
+    constructor(failure, options) {
+        super(failure.message, options);
+        this.failure = failure;
+        this.name = 'ToolExecutionError';
+    }
+}
+export class ToolInterruptionRequiredError extends Error {
+    decision;
+    toolName;
+    callId;
+    constructor(decision, toolName, callId) {
+        super(decision.reason);
+        this.decision = decision;
+        this.toolName = toolName;
+        this.callId = callId;
+        this.name = 'ToolInterruptionRequiredError';
+    }
+}
+export class ToolRegistry {
+    tools = new Map();
+    constructor(tools = []) {
+        for (const tool of tools)
+            this.register(tool);
+    }
+    register(tool) {
+        const name = tool.descriptor.name.trim();
+        if (!name)
+            throw new TypeError('Tool name must not be empty.');
+        if (this.tools.has(name))
+            throw new Error(`Tool "${name}" is already registered.`);
+        if (typeof tool.execute !== 'function')
+            throw new TypeError(`Tool "${name}" must provide execute().`);
+        this.tools.set(name, tool);
+    }
+    has(name) {
+        return this.tools.has(name);
+    }
+    resolve(name) {
+        return this.tools.get(name);
+    }
+    list() {
+        return Object.freeze([...this.tools.values()]
+            .map(tool => tool.descriptor)
+            .sort((left, right) => left.name.localeCompare(right.name)));
+    }
+}
+/**
+ * Applies invariant validation, policy and cancellation around one execution.
+ * It never retries: a runtime may only retry with explicit effect/idempotency rules.
+ */
+export class ToolRunner {
+    registry;
+    policy;
+    errorFormatter;
+    constructor(options) {
+        this.registry = options.registry;
+        this.policy = options.policy;
+        this.errorFormatter = options.errorFormatter ?? DEFAULT_TOOL_ERROR_FORMATTER;
+    }
+    async execute(name, input, context) {
+        const tool = this.registry.resolve(name);
+        if (!tool)
+            throw this.failure('not_found', name, context, `Unknown tool "${name}".`, false);
+        let parsedInput;
+        try {
+            parsedInput = tool.descriptor.input.parse(input);
+        }
+        catch (cause) {
+            throw this.failure('validation', name, context, `Invalid input for tool "${name}".`, false, cause);
+        }
+        const requiresApproval = tool.descriptor.behavior?.requiresApproval === true;
+        const decision = this.policy
+            ? await this.authorize(tool.descriptor, parsedInput, context, requiresApproval)
+            : requiresApproval && context.approval?.outcome === 'approve'
+                ? { type: 'allow' }
+                : await this.authorize(tool.descriptor, parsedInput, context, requiresApproval);
+        if (decision.type === 'deny') {
+            throw this.failure('denied', name, context, decision.reason, false);
+        }
+        if (decision.type === 'interrupt') {
+            throw new ToolInterruptionRequiredError(decision, name, context.callId);
+        }
+        const execution = deriveExecutionBoundary(context, tool.descriptor.behavior?.timeoutMs);
+        try {
+            const raw = await raceWithSignal(Promise.resolve(tool.execute({ ...context, signal: execution.signal }, parsedInput)), execution.signal);
+            const normalized = isToolOutput(raw) ? raw : { value: raw };
+            if (!tool.descriptor.output)
+                return normalized;
+            try {
+                return { ...normalized, value: tool.descriptor.output.parse(normalized.value) };
+            }
+            catch (cause) {
+                throw this.failure('validation', name, context, `Invalid output from tool "${name}".`, false, cause);
+            }
+        }
+        catch (error) {
+            if (error instanceof ToolExecutionError || error instanceof ToolInterruptionRequiredError)
+                throw error;
+            if (execution.timedOut()) {
+                throw this.failure('timeout', name, context, `Tool "${name}" exceeded its deadline.`, false, error);
+            }
+            if (context.signal.aborted || execution.signal.aborted) {
+                throw this.failure('cancelled', name, context, `Tool "${name}" was cancelled.`, false, error);
+            }
+            throw this.failure('execution', name, context, `Tool "${name}" failed.`, false, error);
+        }
+        finally {
+            execution.dispose();
+        }
+    }
+    formatFailure(error) {
+        return this.errorFormatter.format(error.failure);
+    }
+    async authorize(tool, input, context, requiresApproval) {
+        if (this.policy)
+            return this.policy.authorize({ tool, input, context });
+        if (requiresApproval) {
+            return {
+                type: 'interrupt',
+                interruptionId: `${context.runId}:${context.callId}`,
+                reason: `Tool "${tool.name}" requires approval.`,
+            };
+        }
+        return { type: 'allow' };
+    }
+    failure(kind, toolName, context, message, retryable, cause) {
+        return new ToolExecutionError({ kind, toolName, callId: context.callId, message, retryable, cause }, cause === undefined ? undefined : { cause });
+    }
+}
+export function toolEffect(descriptor) {
+    return descriptor.behavior?.effect ?? 'side-effect';
+}
+const DEFAULT_TOOL_ERROR_FORMATTER = Object.freeze({
+    format: (failure) => `${failure.kind}: ${failure.message}`,
+});
+function isToolOutput(value) {
+    return typeof value === 'object' && value !== null && 'value' in value;
+}
+function deriveExecutionBoundary(context, timeoutMs) {
+    if (timeoutMs !== undefined && (!Number.isFinite(timeoutMs) || timeoutMs <= 0)) {
+        throw new RangeError('Tool timeoutMs must be a positive finite number.');
+    }
+    const now = Date.now();
+    const expiresAt = Math.min(context.deadline ?? Number.POSITIVE_INFINITY, timeoutMs === undefined ? Number.POSITIVE_INFINITY : now + timeoutMs);
+    if (!Number.isFinite(expiresAt)) {
+        return { signal: context.signal, timedOut: () => false, dispose: () => undefined };
+    }
+    const controller = new AbortController();
+    let timedOut = expiresAt <= now;
+    const onParentAbort = () => controller.abort(context.signal.reason);
+    context.signal.addEventListener('abort', onParentAbort, { once: true });
+    const timer = setTimeout(() => {
+        timedOut = true;
+        controller.abort(new Error('Tool deadline exceeded.'));
+    }, Math.max(0, expiresAt - now));
+    timer.unref?.();
+    if (context.signal.aborted)
+        onParentAbort();
+    return {
+        signal: controller.signal,
+        timedOut: () => timedOut,
+        dispose: () => {
+            clearTimeout(timer);
+            context.signal.removeEventListener('abort', onParentAbort);
+        },
+    };
+}
+function raceWithSignal(operation, signal) {
+    if (signal.aborted)
+        return Promise.reject(signal.reason ?? new Error('Operation aborted.'));
+    return new Promise((resolve, reject) => {
+        const onAbort = () => reject(signal.reason ?? new Error('Operation aborted.'));
+        signal.addEventListener('abort', onAbort, { once: true });
+        operation.then(value => {
+            signal.removeEventListener('abort', onAbort);
+            resolve(value);
+        }, error => {
+            signal.removeEventListener('abort', onAbort);
+            reject(error);
+        });
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/src/runtime-v2/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/runtime-v2/tools.ts"],"names":[],"mappings":"AA+FA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACtB;IAArB,YAAqB,OAAoB,EAAE,OAAsB;QAC/D,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QADb,YAAO,GAAP,OAAO,CAAa;QAEvC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAE3C;IACA;IACA;IAHX,YACW,QAA4D,EAC5D,QAAgB,EAChB,MAAc;QAEvB,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAJd,aAAQ,GAAR,QAAQ,CAAoD;QAC5D,aAAQ,GAAR,QAAQ,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAQ;QAGvB,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED,MAAM,OAAO,YAAY;IACN,KAAK,GAAG,IAAI,GAAG,EAAsC,CAAC;IAEvE,YAAY,QAA8C,EAAE;QAC1D,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,QAAQ,CAA4B,IAA4C;QAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAC;QAC/D,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,0BAA0B,CAAC,CAAC;QACnF,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU;YAAE,MAAM,IAAI,SAAS,CAAC,SAAS,IAAI,2BAA2B,CAAC,CAAC;QACtG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,CACL,IAAY;QAEZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAuD,CAAC;IACpF,CAAC;IAED,IAAI;QACF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;aAC1C,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC;aAC5B,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;CACF;AAQD;;;GAGG;AACH,MAAM,OAAO,UAAU;IACJ,QAAQ,CAAe;IACvB,MAAM,CAAwB;IAC9B,cAAc,CAAqB;IAEpD,YAAY,OAAoC;QAC9C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,4BAA4B,CAAC;IAC/E,CAAC;IAED,KAAK,CAAC,OAAO,CACX,IAAY,EACZ,KAAc,EACd,OAAuC;QAEvC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAA6B,IAAI,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC;QAE5F,IAAI,WAAoB,CAAC;QACzB,IAAI,CAAC;YACH,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,2BAA2B,IAAI,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACrG,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;QAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM;YAC1B,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,CAAC;YAC/E,CAAC,CAAC,gBAAgB,IAAI,OAAO,CAAC,QAAQ,EAAE,OAAO,KAAK,SAAS;gBAC3D,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAW;gBAC5B,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC;QACpF,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,IAAI,6BAA6B,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,SAAS,GAAG,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACxF,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,cAAc,CAC9B,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC,EACpF,SAAS,CAAC,MAAM,CACjB,CAAC;YACF,MAAM,UAAU,GAAG,YAAY,CAAU,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAc,EAAE,CAAC;YAChF,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM;gBAAE,OAAO,UAAU,CAAC;YAC/C,IAAI,CAAC;gBACH,OAAO,EAAE,GAAG,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAClF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,CAAC,OAAO,CAChB,YAAY,EACZ,IAAI,EACJ,OAAO,EACP,6BAA6B,IAAI,IAAI,EACrC,KAAK,EACL,KAAK,CACN,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,kBAAkB,IAAI,KAAK,YAAY,6BAA6B;gBAAE,MAAM,KAAK,CAAC;YACvG,IAAI,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACzB,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,IAAI,0BAA0B,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACtG,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACvD,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,IAAI,kBAAkB,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAChG,CAAC;YACD,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACzF,CAAC;gBAAS,CAAC;YACT,SAAS,CAAC,OAAO,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAED,aAAa,CAAC,KAAyB;QACrC,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAEO,KAAK,CAAC,SAAS,CACrB,IAAoB,EACpB,KAAc,EACd,OAAuC,EACvC,gBAAyB;QAEzB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACxE,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO;gBACL,IAAI,EAAE,WAAW;gBACjB,cAAc,EAAE,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE;gBACpD,MAAM,EAAE,SAAS,IAAI,CAAC,IAAI,sBAAsB;aACjD,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IAEO,OAAO,CACb,IAAyB,EACzB,QAAgB,EAChB,OAAuC,EACvC,OAAe,EACf,SAAkB,EAClB,KAAe;QAEf,OAAO,IAAI,kBAAkB,CAC3B,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EACrE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAC5C,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,UAAU,CAAC,UAAoC;IAC7D,OAAO,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,aAAa,CAAC;AACtD,CAAC;AAED,MAAM,4BAA4B,GAAuB,MAAM,CAAC,MAAM,CAAC;IACrE,MAAM,EAAE,CAAC,OAAoB,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE;CACxE,CAAC,CAAC;AAEH,SAAS,YAAY,CAAI,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,CAAC;AACzE,CAAC;AAQD,SAAS,uBAAuB,CAC9B,OAA6B,EAC7B,SAA6B;IAE7B,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC;QAC/E,MAAM,IAAI,UAAU,CAAC,kDAAkD,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,iBAAiB,EAC5C,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,GAAG,SAAS,CACrE,CAAC;IACF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;IACrF,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,QAAQ,GAAG,SAAS,IAAI,GAAG,CAAC;IAChC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpE,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,QAAQ,GAAG,IAAI,CAAC;QAChB,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACzD,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC;IACjC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAChB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO;QAAE,aAAa,EAAE,CAAC;IAC5C,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ;QACxB,OAAO,EAAE,GAAG,EAAE;YACZ,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAI,SAAqB,EAAE,MAAmB;IACnE,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC5F,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAC/E,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,SAAS,CAAC,IAAI,CACZ,KAAK,CAAC,EAAE;YACN,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,EACD,KAAK,CAAC,EAAE;YACN,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/scheduling/durableAgentScheduler.d.ts

@@ -0,0 +1,46 @@
+import type { AgentSpec, JsonValue } from '../core/index.js';
+import type { DurableChildHandle, DurableChildRecord, DurableFailurePolicy, SpawnBackgroundRequest } from '../orchestration/background.js';
+import type { OrchestrationInput, OrchestrationScope } from '../orchestration/contracts.js';
+import type { CronSchedule, ScheduledTaskContext, ScheduledTaskRecord, ScheduledTaskStore } from '../types.js';
+export interface DurableBackgroundSpawner {
+    spawn(request: SpawnBackgroundRequest): Promise<DurableChildHandle>;
+    handle(childId: string): DurableChildHandle;
+    query(childId: string): Promise<DurableChildRecord>;
+}
+export interface DurableScheduledAgentTask {
+    readonly id: string;
+    readonly schedule: CronSchedule;
+    readonly agent: AgentSpec<JsonValue | undefined, JsonValue>;
+    readonly input: OrchestrationInput | ((context: ScheduledTaskContext) => OrchestrationInput);
+    readonly parent: OrchestrationScope | ((context: ScheduledTaskContext) => OrchestrationScope);
+    readonly context?: JsonValue | ((context: ScheduledTaskContext) => JsonValue | undefined);
+    readonly description?: string;
+    readonly enabled?: boolean;
+    readonly effect?: DurableChildRecord['effect'];
+    readonly idempotencyKey?: string | ((context: ScheduledTaskContext) => string | undefined);
+    readonly failurePolicy?: DurableFailurePolicy;
+    /** Defaults to true. False leaves a durable queued child for a worker process. */
+    readonly autoStart?: boolean;
+    /** Defaults to false; scheduling success normally means the durable record was committed. */
+    readonly waitForResult?: boolean;
+}
+export interface DurableAgentSchedulerOptions {
+    readonly manager: DurableBackgroundSpawner;
+    readonly store?: ScheduledTaskStore;
+}
+/** Bridges cron scheduling to durable spawn without scheduler-level run replay. */
+export declare class DurableAgentScheduler {
+    private readonly scheduler;
+    private readonly manager;
+    constructor(options: DurableAgentSchedulerOptions);
+    schedule(definition: DurableScheduledAgentTask): Promise<ScheduledTaskRecord>;
+    start(): void;
+    stop(): void;
+    dispose(): Promise<void>;
+    trigger(id: string): Promise<void>;
+    remove(id: string): Promise<void>;
+    get(id: string): Promise<ScheduledTaskRecord | undefined>;
+    list(): Promise<ScheduledTaskRecord[]>;
+    private spawnInvocation;
+}
+//# sourceMappingURL=durableAgentScheduler.d.ts.map

package/dist/src/scheduling/durableAgentScheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durableAgentScheduler.d.ts","sourceRoot":"","sources":["../../../src/scheduling/durableAgentScheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpE,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,GAAG,SAAS,EAAE,SAAS,CAAC,CAAC;IAC5D,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,CAAC,CAAC,OAAO,EAAE,oBAAoB,KAAK,kBAAkB,CAAC,CAAC;IAC7F,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,CAAC,CAAC,OAAO,EAAE,oBAAoB,KAAK,kBAAkB,CAAC,CAAC;IAC9F,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,OAAO,EAAE,oBAAoB,KAAK,SAAS,GAAG,SAAS,CAAC,CAAC;IAC1F,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC/C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,oBAAoB,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3F,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAC9C,kFAAkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,6FAA6F;IAC7F,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED,mFAAmF;AACnF,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;gBAEvC,OAAO,EAAE,4BAA4B;IAKjD,QAAQ,CAAC,UAAU,EAAE,yBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAc7E,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IACZ,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IACzD,IAAI,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;YAExB,eAAe;CAyC9B"}

package/dist/src/scheduling/durableAgentScheduler.js

@@ -0,0 +1,97 @@
+import { TaskScheduler } from './scheduler.js';
+/** Bridges cron scheduling to durable spawn without scheduler-level run replay. */
+export class DurableAgentScheduler {
+    scheduler;
+    manager;
+    constructor(options) {
+        this.manager = options.manager;
+        this.scheduler = new TaskScheduler({ store: options.store, defaultMaxRetries: 0 });
+    }
+    schedule(definition) {
+        validateDefinition(definition);
+        return this.scheduler.schedule({
+            id: definition.id,
+            schedule: definition.schedule,
+            description: definition.description,
+            enabled: definition.enabled,
+            // A scheduler retry could replay spawn after a lost response. Durable child
+            // identity and ChildRunner failure policy own retry semantics instead.
+            maxRetries: 0,
+            task: context => this.spawnInvocation(definition, context),
+        });
+    }
+    start() { this.scheduler.start(); }
+    stop() { this.scheduler.stop(); }
+    dispose() { return this.scheduler.dispose(); }
+    trigger(id) { return this.scheduler.trigger(id); }
+    remove(id) { return this.scheduler.remove(id); }
+    get(id) { return this.scheduler.get(id); }
+    list() { return this.scheduler.list(); }
+    async spawnInvocation(definition, context) {
+        const childId = scheduledChildId(context);
+        const existing = await this.manager.query(childId).catch(error => {
+            if (error instanceof Error && /Unknown durable child/.test(error.message))
+                return undefined;
+            throw error;
+        });
+        let handle;
+        if (existing) {
+            handle = this.manager.handle(childId);
+        }
+        else {
+            try {
+                handle = await this.manager.spawn({
+                    parent: resolveValue(definition.parent, context),
+                    agent: definition.agent,
+                    input: resolveValue(definition.input, context),
+                    context: resolveOptionalValue(definition.context, context),
+                    childId,
+                    effect: definition.effect,
+                    idempotencyKey: resolveOptionalValue(definition.idempotencyKey, context),
+                    failurePolicy: definition.failurePolicy,
+                    autoStart: definition.autoStart,
+                    metadata: {
+                        schedulerTaskId: context.taskId,
+                        scheduledAt: context.scheduledAt,
+                        invocationCount: context.invocationCount,
+                    },
+                });
+            }
+            catch (error) {
+                // Handles the cross-process query/create race without creating another id.
+                const raced = await this.manager.query(childId).catch(() => undefined);
+                if (!raced)
+                    throw error;
+                handle = this.manager.handle(childId);
+            }
+        }
+        if (definition.waitForResult)
+            await handle.result();
+        const record = await handle.query();
+        return { childId, status: record.status };
+    }
+}
+function scheduledChildId(context) {
+    return `scheduled:${encodeURIComponent(context.taskId)}:${encodeURIComponent(context.scheduledAt)}:${context.invocationCount}`;
+}
+function resolveValue(value, context) {
+    return typeof value === 'function'
+        ? value(context)
+        : value;
+}
+function resolveOptionalValue(value, context) {
+    return value === undefined ? undefined : resolveValue(value, context);
+}
+function validateDefinition(definition) {
+    if (!definition.id.trim())
+        throw new TypeError('Scheduled agent task id must not be empty.');
+    if (definition.failurePolicy?.mode === 'retry-safe') {
+        if (definition.effect === 'side-effect' || definition.effect === undefined) {
+            throw new Error('retry-safe scheduled children must be read or idempotent-write.');
+        }
+        if (definition.effect === 'idempotent-write' && definition.idempotencyKey === undefined) {
+            throw new Error('retry-safe idempotent-write scheduled children require an idempotencyKey.');
+        }
+    }
+}
+//# sourceMappingURL=durableAgentScheduler.js.map

package/dist/src/scheduling/durableAgentScheduler.js.map

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

package/dist/src/scheduling/index.d.ts

@@ -1,3 +1,6 @@
 export { parseCron, nextCronTime, msUntilNextCron } from './cron.js';
 export { TaskScheduler, InMemoryTaskStore } from './scheduler.js';
+export { DurableAgentScheduler } from './durableAgentScheduler.js';
+export type { DurableAgentSchedulerOptions, DurableBackgroundSpawner, DurableScheduledAgentTask, } from './durableAgentScheduler.js';
+export { deleteScheduledAutomationTask, getScheduledAutomationTask, listScheduledAutomationTasks, recordScheduledAutomationRun, scheduledAutomationFilePath, setScheduledAutomationEnabled, upsertScheduledAutomationTask, } from './taskPersistence.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/scheduling/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scheduling/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scheduling/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EACV,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAC5B,2BAA2B,EAC3B,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC"}

package/dist/src/scheduling/index.js

@@ -1,3 +1,5 @@
 export { parseCron, nextCronTime, msUntilNextCron } from './cron.js';
 export { TaskScheduler, InMemoryTaskStore } from './scheduler.js';
+export { DurableAgentScheduler } from './durableAgentScheduler.js';
+export { deleteScheduledAutomationTask, getScheduledAutomationTask, listScheduledAutomationTasks, recordScheduledAutomationRun, scheduledAutomationFilePath, setScheduledAutomationEnabled, upsertScheduledAutomationTask, } from './taskPersistence.js';
 //# sourceMappingURL=index.js.map

package/dist/src/scheduling/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scheduling/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scheduling/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAMnE,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAC5B,2BAA2B,EAC3B,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC"}

package/dist/src/scheduling/taskPersistence.d.ts

@@ -0,0 +1,9 @@
+import type { ScheduledAutomationTask, ScheduledAutomationTaskInput, ScheduledTaskRecord } from '../types.js';
+export declare function scheduledAutomationFilePath(workDir: string): string;
+export declare function listScheduledAutomationTasks(workDir: string): Promise<ScheduledAutomationTask[]>;
+export declare function getScheduledAutomationTask(workDir: string, id: string): Promise<ScheduledAutomationTask | undefined>;
+export declare function upsertScheduledAutomationTask(workDir: string, input: ScheduledAutomationTaskInput): Promise<ScheduledAutomationTask>;
+export declare function deleteScheduledAutomationTask(workDir: string, id: string): Promise<boolean>;
+export declare function setScheduledAutomationEnabled(workDir: string, id: string, enabled: boolean): Promise<ScheduledAutomationTask | undefined>;
+export declare function recordScheduledAutomationRun(workDir: string, id: string, result: ScheduledTaskRecord['lastResult'], error?: string): Promise<ScheduledAutomationTask | undefined>;
+//# sourceMappingURL=taskPersistence.d.ts.map

package/dist/src/scheduling/taskPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskPersistence.d.ts","sourceRoot":"","sources":["../../../src/scheduling/taskPersistence.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAGV,uBAAuB,EACvB,4BAA4B,EAC5B,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAoBrB,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAsB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAEtG;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAE9C;AAED,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,uBAAuB,CAAC,CAUlC;AAED,wBAAsB,6BAA6B,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAMjG;AAED,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAS9C;AAED,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,mBAAmB,CAAC,YAAY,CAAC,EACzC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAc9C"}

package/dist/src/scheduling/taskPersistence.js

@@ -0,0 +1,238 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { nowIso } from '../runtime/helpers.js';
+import { nextCronTime } from './cron.js';
+/** A task fires on cron unless its trigger is explicitly 'webhook'. */
+function isScheduleTrigger(task) {
+    return (task.trigger ?? 'schedule') === 'schedule';
+}
+/** nextRunAt for a task: cron-derived for schedule tasks, empty for webhook. */
+function computeNextRunAt(task, from) {
+    if (!isScheduleTrigger(task))
+        return '';
+    const cron = task.cron || '0 9 * * *';
+    return nextCronTime(cron, from).toISOString();
+}
+export function scheduledAutomationFilePath(workDir) {
+    return path.join(path.resolve(workDir), '.actoviq', 'scheduled-tasks.json');
+}
+export async function listScheduledAutomationTasks(workDir) {
+    return (await readScheduledAutomationFile(workDir)).tasks;
+}
+export async function getScheduledAutomationTask(workDir, id) {
+    return (await listScheduledAutomationTasks(workDir)).find(task => task.id === id);
+}
+export async function upsertScheduledAutomationTask(workDir, input) {
+    const file = await readScheduledAutomationFile(workDir);
+    const existing = input.id ? file.tasks.find(task => task.id === input.id) : undefined;
+    const task = normalizeScheduledAutomationTask(input, existing);
+    file.tasks = [
+        ...file.tasks.filter(item => item.id !== task.id),
+        task,
+    ].sort(compareScheduledAutomationTasks);
+    await writeScheduledAutomationFile(workDir, file);
+    return task;
+}
+export async function deleteScheduledAutomationTask(workDir, id) {
+    const file = await readScheduledAutomationFile(workDir);
+    const nextTasks = file.tasks.filter(task => task.id !== id);
+    if (nextTasks.length === file.tasks.length)
+        return false;
+    await writeScheduledAutomationFile(workDir, { version: 1, tasks: nextTasks });
+    return true;
+}
+export async function setScheduledAutomationEnabled(workDir, id, enabled) {
+    const file = await readScheduledAutomationFile(workDir);
+    const task = file.tasks.find(item => item.id === id);
+    if (!task)
+        return undefined;
+    task.enabled = enabled;
+    task.updatedAt = nowIso();
+    if (enabled)
+        task.nextRunAt = computeNextRunAt(task);
+    await writeScheduledAutomationFile(workDir, file);
+    return { ...task };
+}
+export async function recordScheduledAutomationRun(workDir, id, result, error) {
+    const file = await readScheduledAutomationFile(workDir);
+    const task = file.tasks.find(item => item.id === id);
+    if (!task)
+        return undefined;
+    const completedAt = nowIso();
+    task.lastRunAt = completedAt;
+    task.lastResult = result;
+    if (error)
+        task.lastError = error;
+    else
+        delete task.lastError;
+    task.invocationCount += 1;
+    task.nextRunAt = computeNextRunAt(task, new Date(completedAt));
+    task.updatedAt = completedAt;
+    await writeScheduledAutomationFile(workDir, file);
+    return { ...task };
+}
+function normalizeScheduledAutomationTask(input, existing) {
+    const now = nowIso();
+    const kind = input.kind ?? existing?.kind ?? 'workflow';
+    const trigger = input.trigger ?? existing?.trigger ?? 'schedule';
+    const cron = trigger === 'webhook'
+        ? ''
+        : (normalizeText(input.cron) || existing?.cron || '0 9 * * *');
+    const nextRunAt = computeNextRunAt({ trigger, cron });
+    const workflowName = kind === 'workflow'
+        ? normalizeText(input.workflowName) || existing?.workflowName
+        : undefined;
+    const prompt = kind === 'prompt'
+        ? normalizeText(input.prompt) || existing?.prompt
+        : undefined;
+    const name = normalizeText(input.name)
+        || existing?.name
+        || workflowName
+        || (prompt ? prompt.slice(0, 48) : undefined)
+        || (kind === 'manager' ? 'Manager progress update' : undefined)
+        || 'Scheduled task';
+    if (kind === 'workflow' && !workflowName) {
+        throw new Error('Workflow tasks require workflowName');
+    }
+    if (kind === 'prompt' && !prompt) {
+        throw new Error('Prompt tasks require prompt');
+    }
+    if (trigger === 'webhook' && !(normalizeText(input.webhookId) || existing?.webhookId)) {
+        throw new Error('Webhook tasks require webhookId');
+    }
+    return {
+        id: normalizeText(input.id) || existing?.id || createTaskId(name),
+        name,
+        kind,
+        trigger,
+        cron,
+        enabled: input.enabled ?? existing?.enabled ?? true,
+        ...(normalizeText(input.description) || existing?.description
+            ? { description: normalizeText(input.description) || existing?.description }
+            : {}),
+        ...(workflowName ? { workflowName } : {}),
+        ...((kind === 'workflow' || kind === 'manager') && input.input !== undefined
+            ? { input: String(input.input) }
+            : (kind === 'workflow' || kind === 'manager') && existing?.input !== undefined
+                ? { input: existing.input }
+                : {}),
+        ...(prompt ? { prompt } : {}),
+        ...(trigger === 'webhook'
+            ? {
+                webhookId: normalizeText(input.webhookId) || existing?.webhookId,
+                ...(normalizeText(input.webhookSecret) || existing?.webhookSecret
+                    ? { webhookSecret: normalizeText(input.webhookSecret) || existing?.webhookSecret }
+                    : {}),
+                ...(normalizeText(input.webhookFilter) || existing?.webhookFilter
+                    ? { webhookFilter: normalizeText(input.webhookFilter) || existing?.webhookFilter }
+                    : {}),
+            }
+            : {}),
+        ...(normalizeText(input.scope) || existing?.scope
+            ? { scope: normalizeText(input.scope) || existing?.scope }
+            : {}),
+        ...(existing?.lastRunAt ? { lastRunAt: existing.lastRunAt } : {}),
+        ...(existing?.lastResult ? { lastResult: existing.lastResult } : {}),
+        ...(existing?.lastError ? { lastError: existing.lastError } : {}),
+        nextRunAt,
+        invocationCount: existing?.invocationCount ?? 0,
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now,
+    };
+}
+async function readScheduledAutomationFile(workDir) {
+    const filePath = scheduledAutomationFilePath(workDir);
+    try {
+        const raw = JSON.parse(await readFile(filePath, 'utf8'));
+        if (!isRecord(raw) || !Array.isArray(raw.tasks))
+            return { version: 1, tasks: [] };
+        return {
+            version: 1,
+            tasks: raw.tasks
+                .map(coerceTask)
+                .filter((task) => Boolean(task))
+                .sort(compareScheduledAutomationTasks),
+        };
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'ENOENT')
+            return { version: 1, tasks: [] };
+        throw error;
+    }
+}
+async function writeScheduledAutomationFile(workDir, file) {
+    const filePath = scheduledAutomationFilePath(workDir);
+    await mkdir(path.dirname(filePath), { recursive: true });
+    const tempPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+    await writeFile(tempPath, `${JSON.stringify({ version: 1, tasks: file.tasks }, null, 2)}\n`, 'utf8');
+    await rename(tempPath, filePath);
+}
+function coerceTask(value) {
+    if (!isRecord(value))
+        return undefined;
+    const id = normalizeText(value.id);
+    const name = normalizeText(value.name);
+    const kind = value.kind === 'prompt' || value.kind === 'workflow' || value.kind === 'manager' ? value.kind : undefined;
+    const trigger = value.trigger === 'webhook' ? 'webhook' : 'schedule';
+    const cron = normalizeText(value.cron);
+    if (!id || !name || !kind)
+        return undefined;
+    // Schedule tasks need a valid cron; webhook tasks don't.
+    if (trigger === 'schedule') {
+        if (!cron)
+            return undefined;
+        try {
+            nextCronTime(cron);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return {
+        id,
+        name,
+        kind,
+        trigger,
+        cron: trigger === 'webhook' ? '' : cron,
+        enabled: value.enabled !== false,
+        ...(normalizeText(value.description) ? { description: normalizeText(value.description) } : {}),
+        ...(normalizeText(value.workflowName) ? { workflowName: normalizeText(value.workflowName) } : {}),
+        ...(typeof value.input === 'string' ? { input: value.input } : {}),
+        ...(normalizeText(value.prompt) ? { prompt: normalizeText(value.prompt) } : {}),
+        ...(trigger === 'webhook' && normalizeText(value.webhookId)
+            ? {
+                webhookId: normalizeText(value.webhookId),
+                ...(normalizeText(value.webhookSecret) ? { webhookSecret: normalizeText(value.webhookSecret) } : {}),
+                ...(normalizeText(value.webhookFilter) ? { webhookFilter: normalizeText(value.webhookFilter) } : {}),
+            }
+            : {}),
+        ...(normalizeText(value.scope) ? { scope: normalizeText(value.scope) } : {}),
+        ...(normalizeText(value.lastRunAt) ? { lastRunAt: normalizeText(value.lastRunAt) } : {}),
+        ...(value.lastResult === 'success' || value.lastResult === 'failure' || value.lastResult === 'timeout'
+            ? { lastResult: value.lastResult }
+            : {}),
+        ...(normalizeText(value.lastError) ? { lastError: normalizeText(value.lastError) } : {}),
+        nextRunAt: normalizeText(value.nextRunAt) || computeNextRunAt({ trigger, cron }),
+        invocationCount: typeof value.invocationCount === 'number' && Number.isFinite(value.invocationCount)
+            ? Math.max(0, Math.floor(value.invocationCount))
+            : 0,
+        createdAt: normalizeText(value.createdAt) || nowIso(),
+        updatedAt: normalizeText(value.updatedAt) || nowIso(),
+    };
+}
+function createTaskId(name) {
+    const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '').slice(0, 42);
+    return `${slug || 'task'}-${randomUUID().slice(0, 8)}`;
+}
+function normalizeText(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function compareScheduledAutomationTasks(a, b) {
+    return a.name.localeCompare(b.name) || a.id.localeCompare(b.id);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=taskPersistence.js.map