@theokit/sdk 2.29.0 → 3.0.0

package/dist/define-tool.d.ts

@@ -60,5 +60,16 @@ export interface DefineToolSpec<T extends ZodType, O extends ZodType = never> {
      */
     sanitize?: boolean | SanitizeOptions;
 }
-export declare function defineTool<T extends ZodType, O extends ZodType = never>(spec: DefineToolSpec<T, O>): CustomTool;
+/**
+ * SE36 — the uniform `X.create()` namespace API. `Tool.create(spec)` is the sole public
+ * constructor for a {@link CustomTool}; it wraps the internal builder so behavior is identical
+ * (ADR 0015). A `private constructor` makes `Tool` a namespace, not an instantiable value —
+ * `new Tool()` is a compile error. Mirrors `Agent.create` / `Cron.create`.
+ *
+ * @public
+ */
+export declare class Tool {
+    private constructor();
+    static create<T extends ZodType, O extends ZodType = never>(spec: DefineToolSpec<T, O>): CustomTool;
+}
 export {};

package/dist/{errors-tP-8O-hR.d.cts → errors-DZpCGlYv.d.cts}

@@ -1,4 +1,4 @@
-import { H as RunOperation } from './run-q_P0vHlY.cjs';
+import { H as RunOperation } from './run-CLXKMRgq.cjs';
 
 /**
  * Public type contract for the Budget enforcement primitive

package/dist/{errors-BxMIlgLP.d.ts → errors-D_Bfo30u.d.ts}

@@ -1,4 +1,4 @@
-import { H as RunOperation } from './run-q_P0vHlY.js';
+import { H as RunOperation } from './run-CLXKMRgq.js';
 
 /**
  * Public type contract for the Budget enforcement primitive

package/dist/errors.d.cts

@@ -1,3 +1,3 @@
-export { A as AgentDisposedError, c as AgentRunError, d as AgentRunErrorCode, e as AuthenticationError, g as BudgetExceededError, C as ConfigurationError, u as CredentialPoolExhaustedError, m as ErrorCode, E as ErrorMetadata, I as IntegrationNotConnectedError, n as InvalidTaskIdError, K as KnownAgentRunErrorCode, M as MemoryAdapterError, o as MemoryAdapterErrorCode, N as NetworkError, R as RateLimitError, p as TaskNotFoundError, T as TheokitAgentError, U as UnknownAgentError, q as UnsupportedBudgetOperationError, r as UnsupportedRunOperationError, s as UnsupportedTaskOperationError, t as isTransientError } from './errors-tP-8O-hR.cjs';
-import './run-q_P0vHlY.cjs';
+export { A as AgentDisposedError, c as AgentRunError, d as AgentRunErrorCode, e as AuthenticationError, g as BudgetExceededError, C as ConfigurationError, u as CredentialPoolExhaustedError, m as ErrorCode, E as ErrorMetadata, I as IntegrationNotConnectedError, n as InvalidTaskIdError, K as KnownAgentRunErrorCode, M as MemoryAdapterError, o as MemoryAdapterErrorCode, N as NetworkError, R as RateLimitError, p as TaskNotFoundError, T as TheokitAgentError, U as UnknownAgentError, q as UnsupportedBudgetOperationError, r as UnsupportedRunOperationError, s as UnsupportedTaskOperationError, t as isTransientError } from './errors-DZpCGlYv.cjs';
+import './run-CLXKMRgq.cjs';
 import 'zod';

package/dist/index.cjs

@@ -19436,6 +19436,13 @@ function deepMergeCloud(base, top) {
   if (base === void 0 && top === void 0) return void 0;
   return { ...base ?? {}, ...top ?? {} };
 }
+var AgentFactory = class {
+  constructor() {
+  }
+  static create(common) {
+    return createAgentFactory(common);
+  }
+};
 
 // src/internal/budget/enforcement.ts
 init_errors();
@@ -19873,6 +19880,20 @@ function createTokenLimiter(opts) {
     processOutput: (ctx) => cap2(ctx.text, ctx)
   };
 }
+var TokenLimiter = class {
+  constructor() {
+  }
+  static create(opts) {
+    return createTokenLimiter(opts);
+  }
+};
+var UnicodeNormalizer = class {
+  constructor() {
+  }
+  static create(opts = {}) {
+    return createUnicodeNormalizer(opts);
+  }
+};
 
 // src/create-skill.ts
 function createSkill(spec) {
@@ -19888,19 +19909,42 @@ function createSkill(spec) {
     ...spec.references !== void 0 ? { references: spec.references } : {}
   };
 }
+var Skill = class {
+  constructor() {
+  }
+  static create(spec) {
+    return createSkill(spec);
+  }
+};
 
 // src/cron.ts
 init_errors();
 
+// src/internal/cron/fire-handler.ts
+init_registry();
+
 // src/internal/cron/run-job.ts
 init_errors();
 init_agent_factory_registry();
 async function runCronJob(job) {
-  if (job.agent !== void 0) return runWithEphemeralAgent(job.agent, job.message);
-  if (job.agentId !== void 0) return runWithExistingAgent(job.agentId, job.message);
-  throw new exports.ConfigurationError(`Cron job ${job.id} has neither agent nor agentId \u2014 cannot run.`, {
-    code: "cron_no_target"
-  });
+  if (job.workflow !== void 0) return job.workflow.run(job.inputData);
+  if (job.agent !== void 0) return runWithEphemeralAgent(job.agent, requireMessage(job));
+  if (job.agentId !== void 0) return runWithExistingAgent(job.agentId, requireMessage(job));
+  throw new exports.ConfigurationError(
+    `Cron job ${job.id} has no target (agent, agentId, or workflow) \u2014 cannot run.`,
+    { code: "cron_no_target" }
+  );
+}
+function isAgentRun(outcome) {
+  return typeof outcome.wait === "function";
+}
+function requireMessage(job) {
+  if (job.message === void 0) {
+    throw new exports.ConfigurationError(`Cron job ${job.id} is an agent target but has no message.`, {
+      code: "cron_missing_message"
+    });
+  }
+  return job.message;
 }
 async function runWithExistingAgent(agentId, message) {
   const info = await getAgentFacade().get(agentId).catch(() => void 0);
@@ -19918,6 +19962,37 @@ async function runWithEphemeralAgent(baseOptions, message) {
   return agent.send(message);
 }
 
+// src/internal/cron/fire-handler.ts
+async function fireCronJobAsTask(job) {
+  const fireTs = Date.now();
+  const taskId = `cron-${job.id}-${fireTs}`;
+  try {
+    await submit({
+      kind: "cron",
+      id: taskId,
+      allowReservedPrefix: true,
+      meta: { jobId: job.id, jobName: job.name, schedule: job.cron, firedAt: fireTs },
+      work: async (ctx) => {
+        const outcome = await runCronJob(job);
+        if (isAgentRun(outcome)) {
+          ctx.signal.addEventListener("abort", () => void outcome.cancel().catch(() => {
+          }), {
+            once: true
+          });
+          const result = await outcome.wait();
+          ctx.emit({ status: result.status, runId: outcome.id });
+          return { status: result.status, runId: outcome.id };
+        }
+        ctx.emit({ status: outcome.status, runId: outcome.id });
+        return { status: outcome.status, runId: outcome.id };
+      }
+    });
+  } catch {
+    const outcome = await runCronJob(job);
+    if (isAgentRun(outcome)) await outcome.wait();
+  }
+}
+
 // src/internal/cron/store.ts
 var jobs = /* @__PURE__ */ new Map();
 function listJobs() {
@@ -20108,7 +20183,6 @@ function estimateNextRunAt(_cron, _timezone) {
 }
 
 // src/cron.ts
-init_registry();
 var Cron = class {
   constructor() {
   }
@@ -20175,7 +20249,8 @@ var Cron = class {
     return updateJobStatus(jobId, false);
   }
   /**
-   * Manually trigger a cron job off-schedule. Returns the resulting `Run`.
+   * Manually trigger a cron job off-schedule. Returns the resulting `Run`
+   * (agent target) or `WorkflowRun` (workflow target — SE35).
    *
    * @public
    */
@@ -20192,30 +20267,7 @@ var Cron = class {
    * @public
    */
   static start(options = {}) {
-    setCronFireHandler(async (job) => {
-      const fireTs = Date.now();
-      const taskId = `cron-${job.id}-${fireTs}`;
-      try {
-        await submit({
-          kind: "cron",
-          id: taskId,
-          allowReservedPrefix: true,
-          meta: { jobId: job.id, jobName: job.name, schedule: job.cron, firedAt: fireTs },
-          work: async (ctx) => {
-            const run = await runCronJob(job);
-            ctx.signal.addEventListener("abort", () => void run.cancel().catch(() => {
-            }), {
-              once: true
-            });
-            const result = await run.wait();
-            ctx.emit({ status: result.status, runId: run.id });
-            return { status: result.status, runId: run.id };
-          }
-        });
-      } catch {
-        await runCronJob(job).then((run) => run.wait());
-      }
-    });
+    setCronFireHandler(fireCronJobAsTask);
     startScheduler(options.cwd);
     return Promise.resolve();
   }
@@ -20239,17 +20291,7 @@ var Cron = class {
   }
 };
 async function createCronJob(options) {
-  if (options.agent !== void 0 && options.agentId !== void 0) {
-    throw new exports.ConfigurationError(
-      "agent and agentId are mutually exclusive \u2014 pass either agent (ephemeral) or agentId (reuse).",
-      { code: "cron_agent_exclusive" }
-    );
-  }
-  if (options.agent === void 0 && options.agentId === void 0) {
-    throw new exports.ConfigurationError("Cron job requires either agent or agentId", {
-      code: "cron_missing_agent"
-    });
-  }
+  validateCronTarget(options);
   validateCronExpression(options.cron);
   const timezone = options.timezone ?? "UTC";
   validateTimezone(timezone);
@@ -20260,20 +20302,51 @@ async function createCronJob(options) {
     id: generateCronId(),
     cron: options.cron,
     timezone,
-    message: options.message,
     enabled: options.enabled ?? true,
     status: options.enabled === false ? "paused" : "scheduled",
     runtime,
     createdAt: now,
     nextRunAt: estimateNextRunAt(options.cron),
     ...options.name !== void 0 ? { name: options.name } : {},
+    ...options.message !== void 0 ? { message: options.message } : {},
     ...options.agent !== void 0 ? { agent: options.agent } : {},
-    ...options.agentId !== void 0 ? { agentId: options.agentId } : {}
+    ...options.agentId !== void 0 ? { agentId: options.agentId } : {},
+    ...options.workflow !== void 0 ? { workflow: options.workflow } : {},
+    ...options.inputData !== void 0 ? { inputData: options.inputData } : {}
   };
   upsertJob(job);
   return job;
 }
+function validateCronTarget(options) {
+  const targets = [options.agent, options.agentId, options.workflow].filter(
+    (t) => t !== void 0
+  ).length;
+  if (targets > 1) {
+    throw new exports.ConfigurationError(
+      "agent, agentId, and workflow are mutually exclusive \u2014 pass exactly one target.",
+      { code: "cron_ambiguous_target" }
+    );
+  }
+  if (targets === 0) {
+    throw new exports.ConfigurationError(
+      "Cron job requires exactly one target: agent, agentId, or workflow.",
+      { code: "cron_no_target" }
+    );
+  }
+  if (options.workflow !== void 0 && options.message !== void 0) {
+    throw new exports.ConfigurationError(
+      "A workflow cron target takes inputData, not a message \u2014 remove `message`.",
+      { code: "cron_workflow_message" }
+    );
+  }
+  if (options.workflow === void 0 && options.message === void 0) {
+    throw new exports.ConfigurationError("An agent cron target requires a message.", {
+      code: "cron_missing_message"
+    });
+  }
+}
 function detectRuntime(options) {
+  if (options.workflow !== void 0) return "local";
   if (options.agentId !== void 0) {
     return options.agentId.startsWith("bc-") ? "cloud" : "local";
   }
@@ -20311,6 +20384,13 @@ function defineProvider(profile, opts) {
     profile
   };
 }
+var Provider = class {
+  constructor() {
+  }
+  static create(profile, opts) {
+    return defineProvider(profile, opts);
+  }
+};
 
 // src/define-skill-read-tool.ts
 init_to_json_schema();
@@ -20351,6 +20431,13 @@ function defineSkillReadTool(skills) {
     }
   };
 }
+var SkillReadTool = class {
+  constructor() {
+  }
+  static create(skills) {
+    return defineSkillReadTool(skills);
+  }
+};
 
 // src/define-tool.ts
 init_to_json_schema();
@@ -20359,6 +20446,13 @@ function shapeToolResult(spec, out) {
   if (spec.toModelOutput !== void 0) return spec.toModelOutput(validated);
   return typeof validated === "string" ? validated : JSON.stringify(validated);
 }
+var Tool = class {
+  constructor() {
+  }
+  static create(spec) {
+    return defineTool(spec);
+  }
+};
 function defineTool(spec) {
   const inputSchema = toJsonSchema(spec.inputSchema, {
     unrepresentable: "any"
@@ -20542,6 +20636,7 @@ init_cwd_mutex();
 function definePlugin(p) {
   return p;
 }
+var Plugin = { create: definePlugin };
 
 // src/internal/runtime/budget/budget-tracker-counter.ts
 function createCounterBudgetTracker(options = {}) {
@@ -20700,6 +20795,13 @@ function createNoopMemoryProvider() {
     }
   };
 }
+var NoopMemoryProvider = class {
+  constructor() {
+  }
+  static create() {
+    return createNoopMemoryProvider();
+  }
+};
 var JobQueue = class {
   jobs = /* @__PURE__ */ new Map();
   controllers = /* @__PURE__ */ new Map();
@@ -21356,6 +21458,13 @@ function createPermissionPlugin(engine, opts = {}) {
     }
   });
 }
+var PermissionPlugin = class {
+  constructor() {
+  }
+  static create(engine, opts = {}) {
+    return createPermissionPlugin(engine, opts);
+  }
+};
 
 // src/schema-normalizer.ts
 init_to_json_schema();
@@ -21545,6 +21654,13 @@ function previewOf(text) {
   if (oneLine.length === 0) return void 0;
   return oneLine.length > SUMMARY_PREVIEW_MAX ? `${oneLine.slice(0, SUMMARY_PREVIEW_MAX - 1)}\u2026` : oneLine;
 }
+var Session = class {
+  constructor() {
+  }
+  static create(storage2) {
+    return createSessionManager(storage2);
+  }
+};
 
 // src/session-scope.ts
 function scopedConversationId(scope, id) {
@@ -21902,6 +22018,13 @@ function createSquad(options) {
     }
   };
 }
+var Squad = class {
+  constructor() {
+  }
+  static create(options) {
+    return createSquad(options);
+  }
+};
 
 // src/index.ts
 init_stream_object();
@@ -22351,35 +22474,35 @@ function safeStringify2(v) {
 
 exports.Agent = Agent;
 exports.AgentBuilder = AgentBuilder;
+exports.AgentFactory = AgentFactory;
 exports.Budget = Budget;
 exports.Cron = Cron;
 exports.EventBus = EventBus;
 exports.InMemoryConversationStorage = InMemoryConversationStorage;
 exports.JobQueue = JobQueue;
 exports.Memory = Memory;
+exports.NoopMemoryProvider = NoopMemoryProvider;
 exports.PermissionEngine = PermissionEngine;
+exports.PermissionPlugin = PermissionPlugin;
+exports.Plugin = Plugin;
+exports.Provider = Provider;
 exports.Security = Security;
+exports.Session = Session;
+exports.Skill = Skill;
+exports.SkillReadTool = SkillReadTool;
+exports.Squad = Squad;
 exports.Task = Task;
 exports.Theokit = Theokit;
+exports.TokenLimiter = TokenLimiter;
+exports.Tool = Tool;
 exports.ToolError = ToolError;
+exports.UnicodeNormalizer = UnicodeNormalizer;
 exports.UsageAccumulator = UsageAccumulator;
 exports.applyMode = applyMode;
 exports.buildReplayHistory = buildReplayHistory;
 exports.chargeAndCheckThresholds = chargeAndCheckThresholds;
 exports.computeCost = computeCost;
-exports.createAgentFactory = createAgentFactory;
 exports.createCounterBudgetTracker = createCounterBudgetTracker;
-exports.createNoopMemoryProvider = createNoopMemoryProvider;
-exports.createPermissionPlugin = createPermissionPlugin;
-exports.createSessionManager = createSessionManager;
-exports.createSkill = createSkill;
-exports.createSquad = createSquad;
-exports.createTokenLimiter = createTokenLimiter;
-exports.createUnicodeNormalizer = createUnicodeNormalizer;
-exports.definePlugin = definePlugin;
-exports.defineProvider = defineProvider;
-exports.defineSkillReadTool = defineSkillReadTool;
-exports.defineTool = defineTool;
 exports.emitRunEvent = emitRunEvent;
 exports.estimateTokens = estimateTokens;
 exports.extractRawId = extractRawId;