@theokit/agents 0.28.0 → 0.30.0

package/dist/{skills-FcUdNDbn.d.ts → skills-Dx_KJ6Eg.d.ts}

@@ -104,6 +104,32 @@ type PolicyHandler = (user: {
     roles: string[];
 }) => boolean;
 
+type CheckpointStrategy = 'after-tool-call' | 'after-iteration' | 'manual';
+type CheckpointStorage = 'memory' | 'filesystem' | 'drizzle' | 'redis';
+interface CheckpointOptions {
+    /** Where to persist checkpoints. */
+    storage?: CheckpointStorage;
+    /** When to auto-checkpoint (default: 'after-tool-call'). */
+    strategy?: CheckpointStrategy;
+    /** Maximum checkpoints to retain per run (rolling window). */
+    maxCheckpoints?: number;
+    /** Time-to-live in ms before checkpoints expire (default: 3_600_000 = 1h). */
+    ttl?: number;
+}
+/** Serializable checkpoint state. */
+interface CheckpointState {
+    id: string;
+    runId: string;
+    agentName: string;
+    step: number;
+    messages: unknown[];
+    toolResults: unknown[];
+    createdAt: number;
+    resumeToken: string;
+}
+declare function Checkpoint(options?: CheckpointOptions): ClassDecorator;
+declare function getCheckpointConfig(target: Function): CheckpointOptions | undefined;
+
 /** Stored `@Compaction` declaration (resolved + validated at `AgentRunner.build()`). */
 interface CompactionDecoratorConfig {
     /** Strategy name (e.g. `'token-budget'`). Validated at resolve time. */
@@ -158,6 +184,20 @@ declare function resolveSessionId(strategy: SessionStrategy, platform: string, s
     topicId?: string;
 }): string;
 
+type TimeoutAction = 'abort' | 'proceed' | 'retry';
+interface HumanInTheLoopOptions {
+    /** Question shown to the human approver. */
+    question: string;
+    /** Timeout in milliseconds before onTimeout fires (default: 300_000 = 5 min). */
+    timeout?: number;
+    /** Action when timeout expires (default: 'abort'). */
+    onTimeout?: TimeoutAction;
+    /** Show the tool input to the approver (default: true). */
+    showInput?: boolean;
+}
+declare function HumanInTheLoop(options: HumanInTheLoopOptions): MethodDecorator;
+declare function getHumanInTheLoopConfig(target: Function, propertyKey: string | symbol): HumanInTheLoopOptions | undefined;
+
 interface McpServerConfig {
     /** Command to start the MCP server. */
     command: string;
@@ -217,4 +257,4 @@ interface SkillsOptions {
 declare function Skills(namesOrOptions: string[] | SkillsOptions): ClassDecorator;
 declare function getSkillsConfig(target: Function): SkillsOptions | undefined;
 
-export { type AgentOptions as A, type BudgetOptions as B, Compaction as C, getProjectContextConfig as D, getSkillsConfig as E, resolveSessionId as F, Gateway as G, type IndexStrategy as I, MCP as M, type PlatformName as P, type ReasoningEffort as R, type SessionStrategy as S, type ToolOptions as T, type ApprovalOptions as a, type CompactionDecoratorConfig as b, type ContextCompactionStrategy as c, ContextWindow as d, type ContextWindowOptions as e, type GatewayOptions as f, type MainLoopMeta as g, type MainLoopOptions as h, type McpServerConfig as i, type McpServersMap as j, Memory as k, type MemoryOptions as l, type MemoryProvider as m, type MemoryScope as n, type PolicyHandler as o, ProjectContext as p, type ProjectContextOptions as q, type RelevanceStrategy as r, Skills as s, type SkillsOptions as t, type ToolboxOptions as u, getCompactionConfig as v, getContextWindowConfig as w, getGatewayConfig as x, getMcpConfig as y, getMemoryConfig as z };
+export { type AgentOptions as A, type BudgetOptions as B, Checkpoint as C, type ToolOptions as D, type ToolboxOptions as E, getCheckpointConfig as F, Gateway as G, HumanInTheLoop as H, type IndexStrategy as I, getCompactionConfig as J, getContextWindowConfig as K, getGatewayConfig as L, MCP as M, getHumanInTheLoopConfig as N, getMcpConfig as O, type PlatformName as P, getMemoryConfig as Q, type ReasoningEffort as R, type SessionStrategy as S, type TimeoutAction as T, getProjectContextConfig as U, getSkillsConfig as V, resolveSessionId as W, type ApprovalOptions as a, type CheckpointOptions as b, type CheckpointState as c, type CheckpointStorage as d, type CheckpointStrategy as e, Compaction as f, type CompactionDecoratorConfig as g, type ContextCompactionStrategy as h, ContextWindow as i, type ContextWindowOptions as j, type GatewayOptions as k, type HumanInTheLoopOptions as l, type MainLoopMeta as m, type MainLoopOptions as n, type McpServerConfig as o, type McpServersMap as p, Memory as q, type MemoryOptions as r, type MemoryProvider as s, type MemoryScope as t, type PolicyHandler as u, ProjectContext as v, type ProjectContextOptions as w, type RelevanceStrategy as x, Skills as y, type SkillsOptions as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/agents",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "description": "Unified decorator runtime — AI agents as first-class citizens of the TheoKit pipeline. @Agent() compiles to SDK Agent.create(), @Tool() compiles to defineTool().",
   "type": "module",
   "sideEffects": false,