@theokit/sdk 4.29.0 → 4.30.0

package/dist/internal/plugins/types.d.cts

@@ -11,7 +11,7 @@
  * @public
  */
 import type { Plugin as PluginType } from "../../types/plugin.js";
-export type { CommandHandler, CommandOptions, HookHandler, HookName, LlmCallContext, PluginContext, PostAssistantReplyContext, PostToolCallContext, PreToolCallContext, PreToolCallDecision, PreUserSendContext, PreUserSendResult, SessionLifecycleContext, ToolContext, TransformContext, } from "../../types/plugin.js";
+export type { CommandHandler, CommandOptions, HookHandler, HookName, LlmCallContext, PluginContext, PostAssistantReplyContext, PostToolCallContext, PreToolCallContext, PreToolCallDecision, PreUserSendContext, PreUserSendResult, SessionLifecycleContext, ToolCallSummary, ToolContext, ToolResultTransformContext, TransformContext, } from "../../types/plugin.js";
 export type Plugin = PluginType;
 /**
  * Identity helper for plugin authors. TS-only convenience — preserves

package/dist/internal/plugins/types.d.ts

@@ -11,7 +11,7 @@
  * @public
  */
 import type { Plugin as PluginType } from "../../types/plugin.js";
-export type { CommandHandler, CommandOptions, HookHandler, HookName, LlmCallContext, PluginContext, PostAssistantReplyContext, PostToolCallContext, PreToolCallContext, PreToolCallDecision, PreUserSendContext, PreUserSendResult, SessionLifecycleContext, ToolContext, TransformContext, } from "../../types/plugin.js";
+export type { CommandHandler, CommandOptions, HookHandler, HookName, LlmCallContext, PluginContext, PostAssistantReplyContext, PostToolCallContext, PreToolCallContext, PreToolCallDecision, PreUserSendContext, PreUserSendResult, SessionLifecycleContext, ToolCallSummary, ToolContext, ToolResultTransformContext, TransformContext, } from "../../types/plugin.js";
 export type Plugin = PluginType;
 /**
  * Identity helper for plugin authors. TS-only convenience — preserves

package/dist/subagents-loader.d.cts

@@ -1,4 +1,4 @@
-import { a as AgentDefinition } from './agent-CdjSCbYz.cjs';
+import { a as AgentDefinition } from './agent-Bzg2_uGr.cjs';
 import './run-OJbGyweZ.cjs';
 import 'zod';
 

package/dist/subagents-loader.d.ts

@@ -1,4 +1,4 @@
-import { a as AgentDefinition } from './agent-BZz4X8ZM.js';
+import { a as AgentDefinition } from './agent-Ekv8y7_c.js';
 import './run-OJbGyweZ.js';
 import 'zod';
 

package/dist/types/plugin.d.ts

@@ -77,6 +77,38 @@ export interface TransformContext {
     agentId: string;
     runId: string;
 }
+/**
+ * M82 — one tool call of the turn, as seen by `transform_tool_result`. `id` is the correlation key
+ * back into the batch: it equals the `toolUseId` of the matching `tool_result` part.
+ *
+ * @public
+ */
+export interface ToolCallSummary {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+/**
+ * M82 — context for `transform_tool_result`, the only tool-stage hook whose return value the SDK
+ * actually applies (`#runTransform` folds it; `#runFireAndForget` discards `post_tool_call`'s).
+ *
+ * Before M82 this seam knew only `{agentId, runId}`, so a hook could transform results but could not
+ * tell WHICH tool produced which one. A policy scoped to a tool name — the common case — therefore
+ * had to live on `post_tool_call`, whose return is discarded, and silently degraded to observation.
+ *
+ * `toolCalls` is PLURAL because the seam is batch-shaped: `dispatchTools` runs every tool call of the
+ * turn and the hook receives all results together. A singular `name` would have to lie in any
+ * multi-tool turn. Correlate with `LlmToolResultPart.toolUseId === ToolCallSummary.id`.
+ *
+ * Kept separate from {@link TransformContext} on purpose: that type is shared with
+ * `transform_llm_output`, which has no tool call at all, and an optional field there would be
+ * permanently `undefined` for half its consumers.
+ *
+ * @public
+ */
+export interface ToolResultTransformContext extends TransformContext {
+    toolCalls: readonly ToolCallSummary[];
+}
 /**
  * Context passed to `pre_user_send` hook handlers (ADR D145).
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "4.29.0",
+  "version": "4.30.0",
   "description": "TypeScript SDK for the Theo agent harness — same surface, local or cloud.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/usetheodev/theokit-sdk#readme",