@theokit/sdk 2.29.0 → 3.0.0

package/dist/index.js

@@ -19433,6 +19433,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();
@@ -19870,6 +19877,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) {
@@ -19885,19 +19906,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 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 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 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);
@@ -19915,6 +19959,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() {
@@ -20105,7 +20180,6 @@ function estimateNextRunAt(_cron, _timezone) {
 }
 
 // src/cron.ts
-init_registry();
 var Cron = class {
   constructor() {
   }
@@ -20172,7 +20246,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
    */
@@ -20189,30 +20264,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();
   }
@@ -20236,17 +20288,7 @@ var Cron = class {
   }
 };
 async function createCronJob(options) {
-  if (options.agent !== void 0 && options.agentId !== void 0) {
-    throw new 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 ConfigurationError("Cron job requires either agent or agentId", {
-      code: "cron_missing_agent"
-    });
-  }
+  validateCronTarget(options);
   validateCronExpression(options.cron);
   const timezone = options.timezone ?? "UTC";
   validateTimezone(timezone);
@@ -20257,20 +20299,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 ConfigurationError(
+      "agent, agentId, and workflow are mutually exclusive \u2014 pass exactly one target.",
+      { code: "cron_ambiguous_target" }
+    );
+  }
+  if (targets === 0) {
+    throw new 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 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 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";
   }
@@ -20308,6 +20381,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();
@@ -20348,6 +20428,13 @@ function defineSkillReadTool(skills) {
     }
   };
 }
+var SkillReadTool = class {
+  constructor() {
+  }
+  static create(skills) {
+    return defineSkillReadTool(skills);
+  }
+};
 
 // src/define-tool.ts
 init_to_json_schema();
@@ -20356,6 +20443,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"
@@ -20539,6 +20633,7 @@ init_cwd_mutex();
 function definePlugin(p) {
   return p;
 }
+var Plugin = { create: definePlugin };
 
 // src/internal/runtime/budget/budget-tracker-counter.ts
 function createCounterBudgetTracker(options = {}) {
@@ -20697,6 +20792,13 @@ function createNoopMemoryProvider() {
     }
   };
 }
+var NoopMemoryProvider = class {
+  constructor() {
+  }
+  static create() {
+    return createNoopMemoryProvider();
+  }
+};
 var JobQueue = class {
   jobs = /* @__PURE__ */ new Map();
   controllers = /* @__PURE__ */ new Map();
@@ -21353,6 +21455,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();
@@ -21542,6 +21651,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) {
@@ -21899,6 +22015,13 @@ function createSquad(options) {
     }
   };
 }
+var Squad = class {
+  constructor() {
+  }
+  static create(options) {
+    return createSquad(options);
+  }
+};
 
 // src/index.ts
 init_stream_object();
@@ -22346,6 +22469,6 @@ function safeStringify2(v) {
   }
 }
 
-export { Agent, AgentBuilder, AgentDisposedError, AgentRunError, AuthenticationError, Budget, BudgetExceededError, ConfigurationError, Cron, EventBus, FileSystemConversationStorage, GenerateObjectError, InMemoryConversationStorage, IntegrationNotConnectedError, InvalidTaskIdError, JobQueue, Memory, MemoryAdapterError, NetworkError, PermissionEngine, RateLimitError, Security, StreamObjectError, Task, TaskNotFoundError, Theokit, TheokitAgentError, ToolError, UnknownAgentError, UnsupportedBudgetOperationError, UnsupportedRunOperationError, UnsupportedTaskOperationError, UsageAccumulator, applyMode, buildReplayHistory, chargeAndCheckThresholds, computeCost, createAgentFactory, createCounterBudgetTracker, createNoopMemoryProvider, createPermissionPlugin, createSessionManager, createSkill, createSquad, createTokenLimiter, createUnicodeNormalizer, definePlugin, defineProvider, defineSkillReadTool, defineTool, emitRunEvent, estimateTokens, extractRawId, getPricingEntry, inferApiMode, isTransientError, migrateSqliteToLance2 as migrateSqliteToLance, mkMemoryId, normalizeSchema, normalizeUsage, preflightCheck, scopedConversationId, sessionScopePrefix, toShareGptTrajectory, withCwdMutex };
+export { Agent, AgentBuilder, AgentDisposedError, AgentFactory, AgentRunError, AuthenticationError, Budget, BudgetExceededError, ConfigurationError, Cron, EventBus, FileSystemConversationStorage, GenerateObjectError, InMemoryConversationStorage, IntegrationNotConnectedError, InvalidTaskIdError, JobQueue, Memory, MemoryAdapterError, NetworkError, NoopMemoryProvider, PermissionEngine, PermissionPlugin, Plugin, Provider, RateLimitError, Security, Session, Skill, SkillReadTool, Squad, StreamObjectError, Task, TaskNotFoundError, Theokit, TheokitAgentError, TokenLimiter, Tool, ToolError, UnicodeNormalizer, UnknownAgentError, UnsupportedBudgetOperationError, UnsupportedRunOperationError, UnsupportedTaskOperationError, UsageAccumulator, applyMode, buildReplayHistory, chargeAndCheckThresholds, computeCost, createCounterBudgetTracker, emitRunEvent, estimateTokens, extractRawId, getPricingEntry, inferApiMode, isTransientError, migrateSqliteToLance2 as migrateSqliteToLance, mkMemoryId, normalizeSchema, normalizeUsage, preflightCheck, scopedConversationId, sessionScopePrefix, toShareGptTrajectory, withCwdMutex };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map