@theokit/sdk 4.53.1 → 4.55.0

package/dist/context-VMIE4BMD.cjs

@@ -0,0 +1,23 @@
+'use strict';
+
+var chunk53CBTBWO_cjs = require('./chunk-53CBTBWO.cjs');
+require('./chunk-K3FW2XZD.cjs');
+require('./chunk-JTB5Q42C.cjs');
+require('./chunk-NUKRL3I6.cjs');
+
+
+
+Object.defineProperty(exports, "currentPersonalityContext", {
+  enumerable: true,
+  get: function () { return chunk53CBTBWO_cjs.currentPersonalityContext; }
+});
+Object.defineProperty(exports, "warnPersonalitySwitchInsideFork", {
+  enumerable: true,
+  get: function () { return chunk53CBTBWO_cjs.warnPersonalitySwitchInsideFork; }
+});
+Object.defineProperty(exports, "withPersonalityContext", {
+  enumerable: true,
+  get: function () { return chunk53CBTBWO_cjs.withPersonalityContext; }
+});
+//# sourceMappingURL=context-VMIE4BMD.cjs.map
+//# sourceMappingURL=context-VMIE4BMD.cjs.map

package/dist/{context-7USNN6LP.cjs.map → context-VMIE4BMD.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"context-7USNN6LP.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"context-VMIE4BMD.cjs"}

package/dist/cron-BcWmzWzT.d.cts

@@ -0,0 +1,240 @@
+import { Workflow, WorkflowRun } from './workflow.cjs';
+import { ad as SDKUserMessage, b as Run } from './run-BYSHf58D.cjs';
+import { A as AgentOptions, d as ListResult } from './agent-D3Xr_-6Z.cjs';
+
+/**
+ * Runtime hosting a cron job. Mirrors the agent runtime split.
+ *
+ * - `local` — the in-process scheduler activated via `Cron.start()` fires the
+ *   job while the host process is alive.
+ * - `cloud` — Theo PaaS schedules the job server-side; fires independent of
+ *   any SDK process.
+ *
+ * @public
+ */
+type CronRuntime = "local" | "cloud";
+/**
+ * Lifecycle state reported by `Cron.list()` / `Cron.get()`.
+ *
+ * @public
+ */
+type CronJobStatus = "scheduled" | "running" | "paused" | "errored";
+/**
+ * Persistent cron-scheduled invocation of the Theo agent or a workflow.
+ *
+ * Exactly one target is set: {@link CronJob.agent} (ephemeral agent created on
+ * each fire), {@link CronJob.agentId} (bound to an existing agent for context
+ * continuity), or {@link CronJob.workflow} (a committed workflow run per fire;
+ * SE35). Agent targets carry a `message`; a workflow target carries `inputData`.
+ *
+ * @public
+ */
+interface CronJob {
+    id: string;
+    name?: string;
+    /** Standard 5-field POSIX cron expression or shorthand (`@hourly`, `@daily`, ...). */
+    cron: string;
+    /** IANA timezone identifier. Defaults to `"UTC"`. */
+    timezone?: string;
+    /** Message sent to the agent on each fire. Present for agent targets; absent for a workflow target. */
+    message?: string | SDKUserMessage;
+    /** Ephemeral agent options. Mutually exclusive with `agentId`/`workflow`. */
+    agent?: AgentOptions;
+    /** ID of an existing agent to reuse for context continuity. Mutually exclusive with `agent`/`workflow`. */
+    agentId?: string;
+    /**
+     * SE35 — a committed {@link Workflow} run on each fire (`workflow.run(inputData)`).
+     * Mutually exclusive with `agent`/`agentId`. Held in-memory (local runtime only —
+     * a workflow instance cannot cross the cloud process boundary). ADR 0014.
+     */
+    workflow?: Workflow;
+    /** SE35 — input passed to `workflow.run(inputData)` on each fire. Workflow targets only. */
+    inputData?: unknown;
+    /** Whether the scheduler will fire this job on schedule. */
+    enabled: boolean;
+    /** Current status. */
+    status: CronJobStatus;
+    /** Runtime that hosts this job. Inferred from `agent`/`agentId`/`workflow` at create time (a `workflow` target is always `local`). */
+    runtime: CronRuntime;
+    /** Unix ms of the last successful fire, if any. */
+    lastRunAt?: number;
+    /** Unix ms of the next scheduled fire, computed by the scheduler. */
+    nextRunAt?: number;
+    /** Unix ms when the job was created. */
+    createdAt: number;
+}
+/**
+ * Options for `Cron.create()`.
+ *
+ * Pass exactly ONE target: `agent` (ephemeral agent fresh per fire), `agentId`
+ * (reuse an existing agent — preserves conversation context), or `workflow`
+ * (SE35 — run a committed workflow per fire). Agent targets REQUIRE `message`;
+ * a workflow target takes `inputData` and MUST NOT set `message`. Violations are
+ * a `ConfigurationError`.
+ *
+ * @public
+ */
+interface CronCreateOptions {
+    cron: string;
+    /** Message for an agent target. Required with `agent`/`agentId`; forbidden with `workflow`. */
+    message?: string | SDKUserMessage;
+    agent?: AgentOptions;
+    agentId?: string;
+    /** SE35 — a committed {@link Workflow} to run per fire. Mutually exclusive with `agent`/`agentId`. */
+    workflow?: Workflow;
+    /** SE35 — input for `workflow.run(inputData)`. Workflow targets only. */
+    inputData?: unknown;
+    name?: string;
+    timezone?: string;
+    /** Defaults to `true`. */
+    enabled?: boolean;
+    /** Falls back to `THEOKIT_API_KEY`. */
+    apiKey?: string;
+}
+/**
+ * Options for `Cron.list()`.
+ *
+ * @public
+ */
+type CronListOptions = {
+    limit?: number;
+    cursor?: string;
+} & ({
+    runtime?: undefined;
+} | {
+    runtime: "local";
+    cwd?: string;
+} | {
+    runtime: "cloud";
+    apiKey?: string;
+});
+/**
+ * Options for `Cron.get()`.
+ *
+ * @public
+ */
+interface CronGetOptions {
+    cwd?: string;
+    apiKey?: string;
+}
+/**
+ * Options for `Cron.delete()` / `Cron.enable()` / `Cron.disable()`.
+ *
+ * @public
+ */
+interface CronOperationOptions {
+    cwd?: string;
+    apiKey?: string;
+}
+/**
+ * Options for `Cron.run()` — manually trigger a job off-schedule.
+ *
+ * @public
+ */
+interface CronRunOptions {
+    cwd?: string;
+    apiKey?: string;
+}
+/**
+ * Options for `Cron.start()` — activates the in-process scheduler for local
+ * jobs.
+ *
+ * @public
+ */
+interface CronStartOptions {
+    /** Local workspace whose `.theokit/cron/jobs.json` to load. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** Override the env API key. */
+    apiKey?: string;
+}
+/**
+ * Snapshot of the local scheduler returned by `Cron.status()`.
+ *
+ * @public
+ */
+interface CronSchedulerStatus {
+    /** Whether the in-process scheduler is currently running. */
+    running: boolean;
+    /** Number of jobs loaded into the scheduler. */
+    jobCount: number;
+    /** Unix ms of the next scheduled fire across all jobs, if any. */
+    nextFireAt?: number;
+    /** Last error observed in the scheduler, if any. */
+    lastError?: {
+        jobId: string;
+        message: string;
+        at: number;
+    };
+}
+
+/**
+ * Static façade for scheduling Theo agent runs on a cron expression.
+ *
+ * @public
+ */
+declare class Cron {
+    private constructor();
+    /**
+     * Create and persist a cron job.
+     *
+     * @public
+     */
+    static create(options: CronCreateOptions): Promise<CronJob>;
+    /**
+     * List cron jobs (local, cloud, or both).
+     *
+     * @public
+     */
+    static list(options?: CronListOptions): Promise<ListResult<CronJob>>;
+    /**
+     * Get a single cron job by ID.
+     *
+     * @public
+     */
+    static get(jobId: string, _options?: CronGetOptions): Promise<CronJob>;
+    /**
+     * Delete a cron job permanently.
+     *
+     * @public
+     */
+    static delete(jobId: string, _options?: CronOperationOptions): Promise<void>;
+    /**
+     * Re-enable a paused cron job.
+     *
+     * @public
+     */
+    static enable(jobId: string, _options?: CronOperationOptions): Promise<CronJob>;
+    /**
+     * Pause a cron job without deleting it.
+     *
+     * @public
+     */
+    static disable(jobId: string, _options?: CronOperationOptions): Promise<CronJob>;
+    /**
+     * Manually trigger a cron job off-schedule. Returns the resulting `Run`
+     * (agent target) or `WorkflowRun` (workflow target — SE35).
+     *
+     * @public
+     */
+    static run(jobId: string, _options?: CronRunOptions): Promise<Run | WorkflowRun>;
+    /**
+     * Activate the in-process scheduler for local cron jobs.
+     *
+     * @public
+     */
+    static start(options?: CronStartOptions): Promise<void>;
+    /**
+     * Stop the in-process scheduler. Jobs are preserved.
+     *
+     * @public
+     */
+    static stop(): Promise<void>;
+    /**
+     * Snapshot of the local scheduler.
+     *
+     * @public
+     */
+    static status(_options?: CronStartOptions): Promise<CronSchedulerStatus>;
+}
+
+export { Cron as C, type CronCreateOptions as a, type CronGetOptions as b, type CronJob as c, type CronJobStatus as d, type CronListOptions as e, type CronOperationOptions as f, type CronRunOptions as g, type CronRuntime as h, type CronSchedulerStatus as i, type CronStartOptions as j };

package/dist/cron-De6hzWCF.d.ts

@@ -0,0 +1,240 @@
+import { Workflow, WorkflowRun } from './workflow.js';
+import { ad as SDKUserMessage, b as Run } from './run-BYSHf58D.js';
+import { A as AgentOptions, d as ListResult } from './agent-DIu6FooJ.js';
+
+/**
+ * Runtime hosting a cron job. Mirrors the agent runtime split.
+ *
+ * - `local` — the in-process scheduler activated via `Cron.start()` fires the
+ *   job while the host process is alive.
+ * - `cloud` — Theo PaaS schedules the job server-side; fires independent of
+ *   any SDK process.
+ *
+ * @public
+ */
+type CronRuntime = "local" | "cloud";
+/**
+ * Lifecycle state reported by `Cron.list()` / `Cron.get()`.
+ *
+ * @public
+ */
+type CronJobStatus = "scheduled" | "running" | "paused" | "errored";
+/**
+ * Persistent cron-scheduled invocation of the Theo agent or a workflow.
+ *
+ * Exactly one target is set: {@link CronJob.agent} (ephemeral agent created on
+ * each fire), {@link CronJob.agentId} (bound to an existing agent for context
+ * continuity), or {@link CronJob.workflow} (a committed workflow run per fire;
+ * SE35). Agent targets carry a `message`; a workflow target carries `inputData`.
+ *
+ * @public
+ */
+interface CronJob {
+    id: string;
+    name?: string;
+    /** Standard 5-field POSIX cron expression or shorthand (`@hourly`, `@daily`, ...). */
+    cron: string;
+    /** IANA timezone identifier. Defaults to `"UTC"`. */
+    timezone?: string;
+    /** Message sent to the agent on each fire. Present for agent targets; absent for a workflow target. */
+    message?: string | SDKUserMessage;
+    /** Ephemeral agent options. Mutually exclusive with `agentId`/`workflow`. */
+    agent?: AgentOptions;
+    /** ID of an existing agent to reuse for context continuity. Mutually exclusive with `agent`/`workflow`. */
+    agentId?: string;
+    /**
+     * SE35 — a committed {@link Workflow} run on each fire (`workflow.run(inputData)`).
+     * Mutually exclusive with `agent`/`agentId`. Held in-memory (local runtime only —
+     * a workflow instance cannot cross the cloud process boundary). ADR 0014.
+     */
+    workflow?: Workflow;
+    /** SE35 — input passed to `workflow.run(inputData)` on each fire. Workflow targets only. */
+    inputData?: unknown;
+    /** Whether the scheduler will fire this job on schedule. */
+    enabled: boolean;
+    /** Current status. */
+    status: CronJobStatus;
+    /** Runtime that hosts this job. Inferred from `agent`/`agentId`/`workflow` at create time (a `workflow` target is always `local`). */
+    runtime: CronRuntime;
+    /** Unix ms of the last successful fire, if any. */
+    lastRunAt?: number;
+    /** Unix ms of the next scheduled fire, computed by the scheduler. */
+    nextRunAt?: number;
+    /** Unix ms when the job was created. */
+    createdAt: number;
+}
+/**
+ * Options for `Cron.create()`.
+ *
+ * Pass exactly ONE target: `agent` (ephemeral agent fresh per fire), `agentId`
+ * (reuse an existing agent — preserves conversation context), or `workflow`
+ * (SE35 — run a committed workflow per fire). Agent targets REQUIRE `message`;
+ * a workflow target takes `inputData` and MUST NOT set `message`. Violations are
+ * a `ConfigurationError`.
+ *
+ * @public
+ */
+interface CronCreateOptions {
+    cron: string;
+    /** Message for an agent target. Required with `agent`/`agentId`; forbidden with `workflow`. */
+    message?: string | SDKUserMessage;
+    agent?: AgentOptions;
+    agentId?: string;
+    /** SE35 — a committed {@link Workflow} to run per fire. Mutually exclusive with `agent`/`agentId`. */
+    workflow?: Workflow;
+    /** SE35 — input for `workflow.run(inputData)`. Workflow targets only. */
+    inputData?: unknown;
+    name?: string;
+    timezone?: string;
+    /** Defaults to `true`. */
+    enabled?: boolean;
+    /** Falls back to `THEOKIT_API_KEY`. */
+    apiKey?: string;
+}
+/**
+ * Options for `Cron.list()`.
+ *
+ * @public
+ */
+type CronListOptions = {
+    limit?: number;
+    cursor?: string;
+} & ({
+    runtime?: undefined;
+} | {
+    runtime: "local";
+    cwd?: string;
+} | {
+    runtime: "cloud";
+    apiKey?: string;
+});
+/**
+ * Options for `Cron.get()`.
+ *
+ * @public
+ */
+interface CronGetOptions {
+    cwd?: string;
+    apiKey?: string;
+}
+/**
+ * Options for `Cron.delete()` / `Cron.enable()` / `Cron.disable()`.
+ *
+ * @public
+ */
+interface CronOperationOptions {
+    cwd?: string;
+    apiKey?: string;
+}
+/**
+ * Options for `Cron.run()` — manually trigger a job off-schedule.
+ *
+ * @public
+ */
+interface CronRunOptions {
+    cwd?: string;
+    apiKey?: string;
+}
+/**
+ * Options for `Cron.start()` — activates the in-process scheduler for local
+ * jobs.
+ *
+ * @public
+ */
+interface CronStartOptions {
+    /** Local workspace whose `.theokit/cron/jobs.json` to load. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** Override the env API key. */
+    apiKey?: string;
+}
+/**
+ * Snapshot of the local scheduler returned by `Cron.status()`.
+ *
+ * @public
+ */
+interface CronSchedulerStatus {
+    /** Whether the in-process scheduler is currently running. */
+    running: boolean;
+    /** Number of jobs loaded into the scheduler. */
+    jobCount: number;
+    /** Unix ms of the next scheduled fire across all jobs, if any. */
+    nextFireAt?: number;
+    /** Last error observed in the scheduler, if any. */
+    lastError?: {
+        jobId: string;
+        message: string;
+        at: number;
+    };
+}
+
+/**
+ * Static façade for scheduling Theo agent runs on a cron expression.
+ *
+ * @public
+ */
+declare class Cron {
+    private constructor();
+    /**
+     * Create and persist a cron job.
+     *
+     * @public
+     */
+    static create(options: CronCreateOptions): Promise<CronJob>;
+    /**
+     * List cron jobs (local, cloud, or both).
+     *
+     * @public
+     */
+    static list(options?: CronListOptions): Promise<ListResult<CronJob>>;
+    /**
+     * Get a single cron job by ID.
+     *
+     * @public
+     */
+    static get(jobId: string, _options?: CronGetOptions): Promise<CronJob>;
+    /**
+     * Delete a cron job permanently.
+     *
+     * @public
+     */
+    static delete(jobId: string, _options?: CronOperationOptions): Promise<void>;
+    /**
+     * Re-enable a paused cron job.
+     *
+     * @public
+     */
+    static enable(jobId: string, _options?: CronOperationOptions): Promise<CronJob>;
+    /**
+     * Pause a cron job without deleting it.
+     *
+     * @public
+     */
+    static disable(jobId: string, _options?: CronOperationOptions): Promise<CronJob>;
+    /**
+     * Manually trigger a cron job off-schedule. Returns the resulting `Run`
+     * (agent target) or `WorkflowRun` (workflow target — SE35).
+     *
+     * @public
+     */
+    static run(jobId: string, _options?: CronRunOptions): Promise<Run | WorkflowRun>;
+    /**
+     * Activate the in-process scheduler for local cron jobs.
+     *
+     * @public
+     */
+    static start(options?: CronStartOptions): Promise<void>;
+    /**
+     * Stop the in-process scheduler. Jobs are preserved.
+     *
+     * @public
+     */
+    static stop(): Promise<void>;
+    /**
+     * Snapshot of the local scheduler.
+     *
+     * @public
+     */
+    static status(_options?: CronStartOptions): Promise<CronSchedulerStatus>;
+}
+
+export { Cron as C, type CronCreateOptions as a, type CronGetOptions as b, type CronJob as c, type CronJobStatus as d, type CronListOptions as e, type CronOperationOptions as f, type CronRunOptions as g, type CronRuntime as h, type CronSchedulerStatus as i, type CronStartOptions as j };

package/dist/cron.cjs

@@ -1,60 +1,62 @@
 'use strict';
 
-var chunkQBTVATSF_cjs = require('./chunk-QBTVATSF.cjs');
-require('./chunk-F77UENR6.cjs');
-require('./chunk-2D43RD5D.cjs');
-require('./chunk-665SFFFR.cjs');
+var chunkITSSOVOB_cjs = require('./chunk-ITSSOVOB.cjs');
+require('./chunk-F5WMX4EA.cjs');
+require('./chunk-V2UUGUY4.cjs');
+require('./chunk-5UOVYM3P.cjs');
+require('./chunk-53CBTBWO.cjs');
 require('./chunk-BV2MWEMV.cjs');
-require('./chunk-XPR366DL.cjs');
+require('./chunk-NGESVVJN.cjs');
 require('./chunk-BUUUWQMB.cjs');
-require('./chunk-OUOXM36O.cjs');
-require('./chunk-2FYEVT2B.cjs');
-require('./chunk-3X6PM7DU.cjs');
-require('./chunk-4JBHSLQO.cjs');
-require('./chunk-D75S2X6I.cjs');
-require('./chunk-BDTVFIPB.cjs');
+require('./chunk-EI2Q7SJ5.cjs');
+require('./chunk-GHX4P3V2.cjs');
+require('./chunk-YPJ5NH5N.cjs');
+require('./chunk-HLPSLDGL.cjs');
+require('./chunk-F3YZMOAU.cjs');
+require('./chunk-4OTIXDMU.cjs');
+require('./chunk-DQKERTND.cjs');
+require('./chunk-CTCGWIUD.cjs');
 require('./chunk-2ZPEDVLM.cjs');
-require('./chunk-OKLYRPKL.cjs');
-require('./chunk-HAWE74GQ.cjs');
-require('./chunk-RAHSWE5C.cjs');
-require('./chunk-SVO5WPZX.cjs');
-require('./chunk-2RW7K6FN.cjs');
+require('./chunk-Q47R5E2X.cjs');
+require('./chunk-U2AC6JUP.cjs');
 require('./chunk-MUUQ2WFJ.cjs');
+require('./chunk-WJVHMTKB.cjs');
 require('./chunk-6JSIEDKL.cjs');
 require('./chunk-FRITRLZQ.cjs');
-require('./chunk-B4YA6BRS.cjs');
+require('./chunk-4O5TGQBW.cjs');
 require('./chunk-NINIJCHU.cjs');
-require('./chunk-L5YO6PWL.cjs');
+require('./chunk-3YJNUKYN.cjs');
+require('./chunk-ZNW6V4Y6.cjs');
 require('./chunk-VJ26EKGJ.cjs');
-require('./chunk-WQ53UQL4.cjs');
-require('./chunk-C5DEO6OI.cjs');
-require('./chunk-3BK6YR5P.cjs');
-require('./chunk-Y4AXQOT4.cjs');
-require('./chunk-TTJ54H3E.cjs');
-require('./chunk-JIQRXKTA.cjs');
-require('./chunk-YLQQX5W2.cjs');
-require('./chunk-VGPXHHF3.cjs');
-require('./chunk-WJVHMTKB.cjs');
-require('./chunk-C4H6PB5J.cjs');
-require('./chunk-E7FJOO4G.cjs');
-require('./chunk-ADLLFY3H.cjs');
-require('./chunk-VYHJZVL5.cjs');
-require('./chunk-VUKQL3L2.cjs');
-require('./chunk-VF7X6HDR.cjs');
-require('./chunk-5YKNEMXR.cjs');
-require('./chunk-C6Y6CWYD.cjs');
-require('./chunk-ZN2DGEY3.cjs');
-require('./chunk-ZT57WTUJ.cjs');
+require('./chunk-R3UPQFKK.cjs');
 require('./chunk-VKJ7V7EB.cjs');
-require('./chunk-SZHU7A5B.cjs');
-require('./chunk-LPVIRJVF.cjs');
-require('./chunk-BM6N4KHO.cjs');
+require('./chunk-ILCGLTSA.cjs');
+require('./chunk-CQGYNZ3K.cjs');
+require('./chunk-4I55V454.cjs');
+require('./chunk-JHPGF3FP.cjs');
+require('./chunk-SKXBJ2NU.cjs');
+require('./chunk-2ADR2GSO.cjs');
+require('./chunk-ZF2LDKQQ.cjs');
+require('./chunk-2C72DXQF.cjs');
+require('./chunk-I6TGFUCO.cjs');
+require('./chunk-HJBMA5MB.cjs');
+require('./chunk-IWBGCBR6.cjs');
+require('./chunk-XSX2UU6Y.cjs');
+require('./chunk-3EE6LVWT.cjs');
+require('./chunk-6HTXPPHK.cjs');
+require('./chunk-NIRE5CNO.cjs');
+require('./chunk-5USCYPPI.cjs');
+require('./chunk-BVZW2B5V.cjs');
+require('./chunk-52NKC5HT.cjs');
+require('./chunk-K3FW2XZD.cjs');
+require('./chunk-JTB5Q42C.cjs');
+require('./chunk-NUKRL3I6.cjs');
 
 
 
 Object.defineProperty(exports, "Cron", {
   enumerable: true,
-  get: function () { return chunkQBTVATSF_cjs.Cron; }
+  get: function () { return chunkITSSOVOB_cjs.Cron; }
 });
 //# sourceMappingURL=cron.cjs.map
 //# sourceMappingURL=cron.cjs.map

package/dist/cron.d.cts

@@ -1,4 +1,6 @@
-export { C as Cron } from './cron-DFDdCdMM.cjs';
-import './run-C8FBAC8o.cjs';
-import './agent-nLqeXKIX.cjs';
+import './workflow.cjs';
+import './run-BYSHf58D.cjs';
+import './agent-D3Xr_-6Z.cjs';
+export { C as Cron } from './cron-BcWmzWzT.cjs';
 import 'zod';
+import './sdk-agent-DEoKhA8a.cjs';

package/dist/cron.d.ts

@@ -1,4 +1,6 @@
-export { C as Cron } from './cron-BMjgFH-_.js';
-import './run-C8FBAC8o.js';
-import './agent-B9HXlwID.js';
+import './workflow.js';
+import './run-BYSHf58D.js';
+import './agent-DIu6FooJ.js';
+export { C as Cron } from './cron-De6hzWCF.js';
 import 'zod';
+import './sdk-agent-D8qJVkuV.js';