@theokit/agents 0.44.5 → 0.44.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  import { ExecutionContext } from '@theokit/http';
2
2
  import { A as AgentOptions, g as ToolOptions, M as MainLoopMeta, a as ApprovalOptions, B as BudgetOptions, H as HumanInTheLoopOptions, t as GatewayOptions, z as MemoryOptions, O as SkillsOptions, r as ContextWindowOptions, K as ProjectContextOptions, x as McpServersMap, G as Guardrail, o as CompactionDecoratorConfig, j as CheckpointOptions, R as ReasoningEffort } from './types-DVA4LQsA.js';
3
- import { InlineSkill, SystemPromptResolver, SettingSource, SkillsSettings, ContextSettings, CustomTool, PluginsSettings, Plugin, ProviderRoutingSettings, AgentDefinition as AgentDefinition$1, BudgetTracker, ModelSelection } from '@theokit/sdk';
3
+ import { InlineSkill, SystemPromptResolver, SettingSource, MemorySettings, SkillsSettings, ContextSettings, CustomTool, PluginsSettings, Plugin, ProviderRoutingSettings, AgentDefinition as AgentDefinition$1, BudgetTracker, ModelSelection } from '@theokit/sdk';
4
4
  import { z } from 'zod';
5
5
  import { UIMessageChunk } from 'ai';
6
6
  import { RetryOptions } from '@theokit/sdk/retry';
@@ -200,7 +200,7 @@ interface CompiledAgentOptions {
200
200
  plugins?: readonly unknown[];
201
201
  tools: CompiledTool[];
202
202
  agents: Record<string, CompiledSubAgent>;
203
- memory?: MemoryOptions;
203
+ memory?: MemoryOptions | MemorySettings;
204
204
  skills?: SkillsSettings;
205
205
  context?: ContextSettings;
206
206
  /**
@@ -587,6 +587,13 @@ interface DefineAgentConfig<TInput extends z.ZodType = z.ZodType> {
587
587
  * + execution (G2 / ADR-0040); theokit only wires this into `Agent.create({ local.settingSources })`.
588
588
  */
589
589
  settingSources?: readonly SettingSource[];
590
+ /**
591
+ * M49 — durable memory (the SDK's `.theokit/memory/` subsystem: `Remember:` capture, MEMORY.md
592
+ * store, auto-injected `<memory>` block, `memory_search`/`memory_get` tools). The shape is the
593
+ * SDK's own `MemorySettings` — the canonical runtime contract. Projected into
594
+ * `Agent.create({ memory })` by `assembleM8CreateOptions`.
595
+ */
596
+ memory?: MemorySettings;
590
597
  /**
591
598
  * Code `Plugin` objects forwarded to `Agent.create({ plugins })` — EXTENSION units (tools,
592
599
  * commands, model providers, memory adapters). For lifecycle interception use {@link hooks}.
@@ -956,6 +963,12 @@ interface AgentBuilder<TInput extends z.ZodType | UnsetMarker = UnsetMarker, TMo
956
963
  * shell-executing hooks from `.theokit/hooks.json` — opt-in because `.theokit/` is your own repo.
957
964
  */
958
965
  settingSources(sources: readonly SettingSource[]): AgentBuilder<TInput, TModel, TContext, TTools>;
966
+ /**
967
+ * M49 — enable the SDK's durable memory for this agent (`.theokit/memory/` in the run cwd:
968
+ * `Remember:` capture with secret redaction, auto-injected recall, memory tools). Takes the SDK's
969
+ * `MemorySettings` verbatim — `{ enabled: true }` is the minimal opt-in.
970
+ */
971
+ memory(settings: MemorySettings): AgentBuilder<TInput, TModel, TContext, TTools>;
959
972
  /**
960
973
  * Attach LIFECYCLE HOOKS in code, keyed by `HookName` — the builder-chain seam for intercepting
961
974
  * the agent loop. `pre_tool_call` may VETO a tool by returning `{ block: true, message }` before
package/dist/bridge.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- export { c as AGENT_BRAND, d as AfterToolCallContext, e as AgentBuilder, f as AgentDefinition, g as AgentDefinitionError, h as AgentExecutionContext, i as AgentManifest, A as AgentManifestEntry, j as AgentManifestTool, k as AgentRoute, l as AgentRouteContext, m as AgentRunInfo, n as AgentStreamEvent, o as AgentTurnMetadata, p as AgentWalkResult, q as AgentWarningCode, r as AgentsPluginOptions, s as ApiErrorContext, t as ApiErrorDecision, u as ApiErrorPolicy, v as ApprovalRequiredEvent, w as ArtifactChunkEvent, x as ArtifactStartEvent, B as BackgroundDelegation, y as BeforeToolCallContext, z as BudgetExceededError, E as CheckpointSavedEvent, C as CompiledAgentOptions, F as CompiledContextWindow, a as CompiledTool, G as ContextualTool, I as DefineAgentConfig, J as DelegateFn, K as DelegateOptions, M as DelegationError, D as DelegationResult, N as DoneEvent, O as ErrorEvent, P as FileEditEvent, T as InferAgentInput, U as InferAgentToolNames, V as IterationEvent, W as LLMCallContext, _ as McpApprovalSpec, $ as McpRegistryConfig, a0 as McpRequestContext, a1 as McpSelection, a2 as PartialToolCallEvent, a3 as ProcessInputContext, a7 as RunStartedEvent, a8 as ScoreVerdict, a9 as ScoredDelegation, aa as Scorer, ab as SdkAgentHandle, ac as SdkMessage, ad as Segment, ag as StateUpdateEvent, S as StreamEvent, ah as TextDeltaEvent, ai as ThinkingEvent, aj as ToolCallEvent, ak as ToolCallVeto, al as ToolHooks, am as ToolHooksPlugin, an as ToolResultEvent, ao as ToolWalkResult, ap as ToolboxWalkResult, aq as agent, ar as agentsPlugin, as as buildModelSelection, at as compileAgent, au as compileAgentDefinition, av as compileAgentModule, aw as compileContextWindow, ax as compileProjectContext, ay as compileSkills, az as compileTools, aA as contextualTool, aB as createAgentExecutionContext, aC as createApiErrorHandler, aD as createSdkAgentStream, aE as createThinkTagExtractor, aF as createToolHooksPlugin, aG as delegate, aH as delegateBackground, aI as delegateWithScoring, aJ as extractThinkTagStream, aK as generateAgentManifest, aL as generateAgentRoutes, aM as isAgentContext, aN as isAgentDefinition, aO as isApprovalRequired, aP as isDone, aQ as isError, aR as isPartialToolCall, aS as isTextDelta, aT as isToolCall, aU as isToolResult, aX as mcpRegistry, aY as mcpToolApprovals, a_ as projectContextMetadataOnlyKnobs, b2 as resolveMcpServers, b3 as runWithApiErrorHandling, b4 as streamAgentResponse, b5 as streamAgentUIMessages, b6 as toAgentFactory, b7 as translateSdkEvent, b8 as translateToUIMessageStream, b9 as validateUniqueRoutes, ba as walkAgentMetadata } from './bridge-entry-CBq4_kja.js';
1
+ export { c as AGENT_BRAND, d as AfterToolCallContext, e as AgentBuilder, f as AgentDefinition, g as AgentDefinitionError, h as AgentExecutionContext, i as AgentManifest, A as AgentManifestEntry, j as AgentManifestTool, k as AgentRoute, l as AgentRouteContext, m as AgentRunInfo, n as AgentStreamEvent, o as AgentTurnMetadata, p as AgentWalkResult, q as AgentWarningCode, r as AgentsPluginOptions, s as ApiErrorContext, t as ApiErrorDecision, u as ApiErrorPolicy, v as ApprovalRequiredEvent, w as ArtifactChunkEvent, x as ArtifactStartEvent, B as BackgroundDelegation, y as BeforeToolCallContext, z as BudgetExceededError, E as CheckpointSavedEvent, C as CompiledAgentOptions, F as CompiledContextWindow, a as CompiledTool, G as ContextualTool, I as DefineAgentConfig, J as DelegateFn, K as DelegateOptions, M as DelegationError, D as DelegationResult, N as DoneEvent, O as ErrorEvent, P as FileEditEvent, T as InferAgentInput, U as InferAgentToolNames, V as IterationEvent, W as LLMCallContext, _ as McpApprovalSpec, $ as McpRegistryConfig, a0 as McpRequestContext, a1 as McpSelection, a2 as PartialToolCallEvent, a3 as ProcessInputContext, a7 as RunStartedEvent, a8 as ScoreVerdict, a9 as ScoredDelegation, aa as Scorer, ab as SdkAgentHandle, ac as SdkMessage, ad as Segment, ag as StateUpdateEvent, S as StreamEvent, ah as TextDeltaEvent, ai as ThinkingEvent, aj as ToolCallEvent, ak as ToolCallVeto, al as ToolHooks, am as ToolHooksPlugin, an as ToolResultEvent, ao as ToolWalkResult, ap as ToolboxWalkResult, aq as agent, ar as agentsPlugin, as as buildModelSelection, at as compileAgent, au as compileAgentDefinition, av as compileAgentModule, aw as compileContextWindow, ax as compileProjectContext, ay as compileSkills, az as compileTools, aA as contextualTool, aB as createAgentExecutionContext, aC as createApiErrorHandler, aD as createSdkAgentStream, aE as createThinkTagExtractor, aF as createToolHooksPlugin, aG as delegate, aH as delegateBackground, aI as delegateWithScoring, aJ as extractThinkTagStream, aK as generateAgentManifest, aL as generateAgentRoutes, aM as isAgentContext, aN as isAgentDefinition, aO as isApprovalRequired, aP as isDone, aQ as isError, aR as isPartialToolCall, aS as isTextDelta, aT as isToolCall, aU as isToolResult, aX as mcpRegistry, aY as mcpToolApprovals, a_ as projectContextMetadataOnlyKnobs, b2 as resolveMcpServers, b3 as runWithApiErrorHandling, b4 as streamAgentResponse, b5 as streamAgentUIMessages, b6 as toAgentFactory, b7 as translateSdkEvent, b8 as translateToUIMessageStream, b9 as validateUniqueRoutes, ba as walkAgentMetadata } from './bridge-entry-D2u56i8T.js';
2
2
  import '@theokit/http';
3
3
  import './types-DVA4LQsA.js';
4
4
  import '@theokit/sdk';
package/dist/bridge.js CHANGED
@@ -47,7 +47,7 @@ import {
47
47
  translateToUIMessageStream,
48
48
  validateUniqueRoutes,
49
49
  walkAgentMetadata
50
- } from "./chunk-6A7SXMKX.js";
50
+ } from "./chunk-52ZKPX3G.js";
51
51
  import "./chunk-NERDIS45.js";
52
52
  import "./chunk-7QVYU63E.js";
53
53
  export {
@@ -562,6 +562,10 @@ function compileAgentDefinition(def) {
562
562
  ...def.settingSources !== void 0 ? {
563
563
  settingSources: def.settingSources
564
564
  } : {},
565
+ // M49 — memory flows to the projection layer; `assembleM8CreateOptions` forwards it to Agent.create.
566
+ ...def.memory !== void 0 ? {
567
+ memory: def.memory
568
+ } : {},
565
569
  // Hooks are converted here — the layer EVERY path converges on — rather than on the builder, so
566
570
  // `defineAgent({ hooks })` cannot type-check and silently no-op. A lifecycle hook that is
567
571
  // declared but never registered is a security gate that does not gate.
@@ -980,6 +984,21 @@ function assembleM8CreateOptions(compiled) {
980
984
  options.mcpServers = compiled.mcpServers;
981
985
  applied.push("mcpServers");
982
986
  }
987
+ if (compiled.memory !== void 0) {
988
+ if ("enabled" in compiled.memory) {
989
+ options.memory = compiled.memory;
990
+ } else {
991
+ const dropped = Object.keys(compiled.memory);
992
+ if (dropped.length > 0) {
993
+ process.stderr.write(`[theokit-agents] @Memory decorator options not yet mapped to the SDK (${dropped.join(", ")}) \u2014 memory enabled with defaults
994
+ `);
995
+ }
996
+ options.memory = {
997
+ enabled: true
998
+ };
999
+ }
1000
+ applied.push("memory");
1001
+ }
983
1002
  return {
984
1003
  options,
985
1004
  applied
@@ -1733,6 +1752,10 @@ function makeBuilder(config) {
1733
1752
  ...config,
1734
1753
  settingSources: sources
1735
1754
  }), "settingSources"),
1755
+ memory: /* @__PURE__ */ __name((settings) => makeBuilder({
1756
+ ...config,
1757
+ memory: settings
1758
+ }), "memory"),
1736
1759
  hooks: /* @__PURE__ */ __name((map) => makeBuilder({
1737
1760
  ...config,
1738
1761
  hooks: map
@@ -3122,4 +3145,4 @@ export {
3122
3145
  generateAgentManifest,
3123
3146
  agentsPlugin
3124
3147
  };
3125
- //# sourceMappingURL=chunk-6A7SXMKX.js.map
3148
+ //# sourceMappingURL=chunk-52ZKPX3G.js.map