@theokit/agents 4.3.1 → 4.5.0

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.
package/dist/index.d.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  import { G as Guardrail, L as LoopStrategy, R as ReflectionStrategy, C as CompiledAgentOptions, M as MainLoopMeta, a as CompiledTool, b as ReasoningEffort, c as RoundStreamFactory, S as StreamEvent, D as DelegationResult, d as ContextWindowOptions, e as SkillsOptions, T as ToolOptions, A as ApprovalOptions, H as HumanInTheLoopOptions, f as AgentManifestEntry } from './bridge-entry-Ddu3Ug_3.js';
2
2
  export { g as AGENT_BRAND, h as AfterToolCallContext, i as AgentBuilder, j as AgentDefinition, k as AgentDefinitionError, l as AgentExecutionContext, m as AgentManifest, n as AgentManifestSource, o as AgentManifestTool, p as AgentOptions, q as AgentRoute, r as AgentRouteContext, s as AgentRunInfo, t as AgentStreamEvent, u as AgentTurnMetadata, v as AgentsPluginOptions, w as ApiErrorContext, x as ApiErrorDecision, y as ApiErrorPolicy, z as ApprovalRequiredEvent, B as ArtifactChunkEvent, E as ArtifactStartEvent, F as BackgroundDelegation, I as BeforeToolCallContext, J as BudgetExceededError, K as BudgetOptions, N as CheckpointSavedEvent, O as CompiledContextWindow, P as ContextualTool, Q as CostBudgetExceededError, U as DEFAULT_MAX_ITERATIONS, V as DefineAgentConfig, W as DelegateFn, X as DelegateOptions, Y as DelegationError, Z as DoneEvent, _ as ErrorEvent, $ as FileEditEvent, a0 as GuardrailAction, a1 as GuardrailPhase, a2 as GuardrailResult, a3 as GuardrailViolationError, a4 as HitlDecision, a5 as InferAgentInput, a6 as InferAgentToolNames, a7 as IterationEvent, a8 as LLMCallContext, a9 as LoopFinishReason, aa as LoopOutcome, ab as LoopStrategyConfig, ac as MainLoopOptions, ad as McpApprovalSpec, ae as McpRegistryConfig, af as McpRequestContext, ag as McpSelection, ah as PartialToolCallEvent, ai as PolicyHandler, aj as ProcessInputContext, ak as ReflectionContext, al as ReflectionResult, am as ReflectionStrategyConfig, an as RunStartedEvent, ao as ScoreVerdict, ap as ScoredDelegation, aq as Scorer, ar as SdkAgentHandle, as as SdkMessage, at as Segment, au as SkillsRequestContext, av as SkillsSelection, aw as StateUpdateEvent, ax as TextDeltaEvent, ay as ThinkingEvent, az as TimeoutAction, aA as ToolCallEvent, aB as ToolCallVeto, aC as ToolHooks, aD as ToolHooksPlugin, aE as ToolResultEvent, aF as ToolWalkResult, aG as ToolboxOptions, aH as ToolboxWalkResult, aI as agentsPlugin, aJ as buildModelSelection, aK as compileAgentDefinition, aL as compileAgentModule, aM as compileContextWindow, aN as compileProjectContext, aO as compileSkills, aP as compileTools, aQ as createAgentExecutionContext, aR as createApiErrorHandler, aS as createSdkAgentStream, aT as createThinkTagExtractor, aU as createToolHooksPlugin, aV as delegate, aW as delegateBackground, aX as delegateWithScoring, aY as extractThinkTagStream, aZ as generateAgentManifest, a_ as generateAgentRoutes, a$ as isAgentContext, b0 as isAgentDefinition, b1 as isApprovalRequired, b2 as isDone, b3 as isError, b4 as isPartialToolCall, b5 as isTextDelta, b6 as isToolCall, b7 as isToolResult, b8 as ladderReflectionStrategy, b9 as loopStrategyConfigSchema, ba as mcpRegistry, bb as mcpToolApprovals, bc as noopReflectionStrategy, bd as presentUIMessageStream, be as projectContextMetadataOnlyKnobs, bf as reflectionStrategyConfigSchema, bg as resolveEnabledSkills, bh as resolveLoopStrategy, bi as resolveMcpServers, bj as runWithApiErrorHandling, bk as streamAgentResponse, bl as streamAgentUIMessages, bm as toAgentFactory, bn as translateSdkEvent } from './bridge-entry-Ddu3Ug_3.js';
3
+ export { ConfigurationError } from '@theokit/sdk/errors';
3
4
  import { PluginsSettings, Plugin, ProviderRoutingSettings, AgentDefinition, BudgetTracker, CustomTool, GoalLoopAgent, GoalOptions, runGoalLoop, GoalEvent, GoalResult, InlineSkill } from '@theokit/sdk';
4
5
  export { Agent, CustomTool, GoalEvent, GoalLoopAgent, GoalOptions, GoalResult, Provider, SDKAgent, SessionRecord, Squad, Tool } from '@theokit/sdk';
5
6
  import { RetryOptions } from '@theokit/sdk/retry';
@@ -445,24 +446,6 @@ declare class GoalRunner {
445
446
  run(goal: string, options?: GoalOptions, deps?: GoalRunnerDeps): AsyncGenerator<GoalEvent, GoalResult, void>;
446
447
  }
447
448
 
448
- /**
449
- * Typed authoring failures for `@theokit/agents`.
450
- *
451
- * This module lives at the package root and imports NOTHING — deliberately. `bridge/` and
452
- * `capability/` both need to throw the same typed error, and the class used to live inside
453
- * `capability/capabilities.ts`, which imports `bridge/agent-compiler.js`. Having `bridge/` import
454
- * it back from there would close an import cycle, so the error moved to a leaf module that neither
455
- * layer owns (`rules/architecture.md` § 2 — a shared contract belongs to neither side of a
456
- * boundary).
457
- *
458
- * M56 removed the compatibility re-export that `capability/capabilities.ts` carried: one class with
459
- * two import paths was a concession to not-breaking-consumers, not a design. Import it from here.
460
- */
461
- /** Typed authoring failure — surfaced at build time, never a silent bad agent. */
462
- declare class ConfigurationError extends Error {
463
- readonly name = "ConfigurationError";
464
- }
465
-
466
449
  /**
467
450
  * M52 — the capability layer: object-oriented, composable authoring that produces the EXISTING narrow
468
451
  * waist (`CompiledAgentOptions`), which `assembleM8CreateOptions` already turns into `Agent.create`
@@ -976,4 +959,4 @@ declare class AcpClient {
976
959
  private handleServerRequest;
977
960
  }
978
961
 
979
- export { type A2AAuth, type A2ACapabilities, type A2ASkill, type A2AToolConfig, AcpClient, AcpMessageDecoder, type AcpTransport, type AgentCard, type AgentConfig, AgentConfigCapability, AgentManifestEntry, AgentRunner, AgentRunnerBuilder, type AgentRunnerRunOptions, ApprovalOptions, type BuildAgentCardOptions, type Capability, CapabilityConflictError, CapabilityPreset, CapabilityRegistry, CheckpointCapability, type CompactionCallOptions, type CompactionStrategyConfig, CompiledAgentOptions, type CompiledAgentOptionsDraft, CompiledTool, ConfigurationError, ContextWindowCapability, type CostGuardOptions, DEFAULT_KEEP_TOKENS, DelegationResult, FieldCapability, type FinalizedDraft, GoalRunner, type GoalRunnerDeps, Guardrail, GuardrailsCapability, HumanInTheLoopCapability, HumanInTheLoopOptions, LoopStrategy, MCP_PROTOCOL_VERSION, MainLoopCapability, MainLoopMeta, type McpJsonSchema, type McpServerInfo, McpServersCapability, type McpToolDescriptor, MemoryCapability, ModelCapability, type OutputModerationOptions, type PiiOptions, PluginsCapability, ProjectContextCapability, type PromptInjectionOptions, type ProvenanceEntry, ReasoningEffort, ReflectionStrategy, RoundStreamFactory, RunContextCapability, SettingSourcesCapability, SkillsCapability, SkillsOptionsCapability, SkillsResolverCapability, StreamEvent, SubAgentsCapability, type Summarize, type ToolDeclaration, ToolOptions, ToolboxCapability, type ToolboxSource, ToolsCapability, type TranscriptCompactionStrategy, UnknownCapabilityError, applyCapabilities, buildAgentCard, buildMcpToolDescriptors, compactionStrategyConfigSchema, costGuard, createA2ATool, createDraft, deriveConversationId, encodeAcpMessage, estimateTokens, mcpServerInfo, moderateOutputStream, outputModeration, parseConversationId, piiDetector, promptInjectionDetector, resolveCompactionStrategy, runInputGuards, runOutputGuards, setOnce, tokenBudgetCompactionStrategy, unicodeNormalizer, wellKnownCardPath };
962
+ export { type A2AAuth, type A2ACapabilities, type A2ASkill, type A2AToolConfig, AcpClient, AcpMessageDecoder, type AcpTransport, type AgentCard, type AgentConfig, AgentConfigCapability, AgentManifestEntry, AgentRunner, AgentRunnerBuilder, type AgentRunnerRunOptions, ApprovalOptions, type BuildAgentCardOptions, type Capability, CapabilityConflictError, CapabilityPreset, CapabilityRegistry, CheckpointCapability, type CompactionCallOptions, type CompactionStrategyConfig, CompiledAgentOptions, type CompiledAgentOptionsDraft, CompiledTool, ContextWindowCapability, type CostGuardOptions, DEFAULT_KEEP_TOKENS, DelegationResult, FieldCapability, type FinalizedDraft, GoalRunner, type GoalRunnerDeps, Guardrail, GuardrailsCapability, HumanInTheLoopCapability, HumanInTheLoopOptions, LoopStrategy, MCP_PROTOCOL_VERSION, MainLoopCapability, MainLoopMeta, type McpJsonSchema, type McpServerInfo, McpServersCapability, type McpToolDescriptor, MemoryCapability, ModelCapability, type OutputModerationOptions, type PiiOptions, PluginsCapability, ProjectContextCapability, type PromptInjectionOptions, type ProvenanceEntry, ReasoningEffort, ReflectionStrategy, RoundStreamFactory, RunContextCapability, SettingSourcesCapability, SkillsCapability, SkillsOptionsCapability, SkillsResolverCapability, StreamEvent, SubAgentsCapability, type Summarize, type ToolDeclaration, ToolOptions, ToolboxCapability, type ToolboxSource, ToolsCapability, type TranscriptCompactionStrategy, UnknownCapabilityError, applyCapabilities, buildAgentCard, buildMcpToolDescriptors, compactionStrategyConfigSchema, costGuard, createA2ATool, createDraft, deriveConversationId, encodeAcpMessage, estimateTokens, mcpServerInfo, moderateOutputStream, outputModeration, parseConversationId, piiDetector, promptInjectionDetector, resolveCompactionStrategy, runInputGuards, runOutputGuards, setOnce, tokenBudgetCompactionStrategy, unicodeNormalizer, wellKnownCardPath };
package/dist/index.js CHANGED
@@ -71,7 +71,7 @@ import {
71
71
  toolRuntimeName,
72
72
  translateSdkEvent,
73
73
  unicodeNormalizer
74
- } from "./chunk-D7HE4PNY.js";
74
+ } from "./chunk-LIRSFEEJ.js";
75
75
  import {
76
76
  __name
77
77
  } from "./chunk-7QVYU63E.js";
@@ -2,3 +2,4 @@ export * from '@theokit/sdk/interactive';
2
2
  import '@theokit/sdk/persistence';
3
3
  import '@theokit/sdk-pty';
4
4
  import '@theokit/sdk/sandbox';
5
+ import '@theokit/sdk-tools';
@@ -0,0 +1 @@
1
+ export * from '@theokit/sdk-tools';
package/dist/tools.js ADDED
@@ -0,0 +1,3 @@
1
+ // src/tools-entry.ts
2
+ export * from "@theokit/sdk-tools";
3
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/tools-entry.ts"],"sourcesContent":["// M62 — `@theokit/agents/tools`: pass-through of `@theokit/sdk-tools`'s ready-made tool factories\n// (`createReadFileTool`, `createShellTool`, … + `withName`/`withDescription`). These are stateless\n// third-party factories — enriching them would be reinventing the SDK-tools' own sugar (blueprint Q5),\n// so this is a pure re-export (parsimony Rung 9). The consumer imports its built-in tools from the\n// Theokit layer, not from `@theokit/sdk-tools` directly. `@theokit/sdk-tools` is an OPTIONAL peer —\n// only consumers of this subpath need it installed.\nexport * from '@theokit/sdk-tools'\n"],"mappings":";AAMA,cAAc;","names":[]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@theokit/agents",
3
- "version": "4.3.1",
3
+ "version": "4.5.0",
4
4
  "description": "AI agents as first-class citizens of the TheoKit pipeline. The fluent agent()/tool() builders compile to SDK Agent.create() (M31 builder-only authoring API).",
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -38,6 +38,10 @@
38
38
  "./auth": {
39
39
  "types": "./dist/auth.d.ts",
40
40
  "import": "./dist/auth.js"
41
+ },
42
+ "./tools": {
43
+ "types": "./dist/tools.d.ts",
44
+ "import": "./dist/tools.js"
41
45
  }
42
46
  },
43
47
  "files": [
@@ -49,7 +53,7 @@
49
53
  "@theokit/http": ">=0.1.0-alpha.0",
50
54
  "@theokit/sdk": "^4.19.0",
51
55
  "@theokit/sdk-pty": ">=0.1.0 <1.0.0",
52
- "@theokit/sdk-tools": ">=0.11.0 <1.0.0",
56
+ "@theokit/sdk-tools": ">=0.20.0 <1.0.0",
53
57
  "ai": ">=7.0.0",
54
58
  "zod": "^4.0.0"
55
59
  },
@@ -67,7 +71,7 @@
67
71
  "devDependencies": {
68
72
  "@theokit/sdk": "^4.19.0",
69
73
  "@theokit/sdk-pty": "^0.1.0",
70
- "@theokit/sdk-tools": "^0.11.0",
74
+ "@theokit/sdk-tools": "^0.20.0",
71
75
  "ai": "^7.0.14",
72
76
  "tsup": "^8.5.1",
73
77
  "typescript": "^5.9.3",