@theokit/agents 4.23.0 → 4.23.1

package/dist/{bridge-entry-DMh--RZ5.d.ts → bridge-entry-_RN_53jC.d.ts}

@@ -1,5 +1,5 @@
 import { ExecutionContext } from '@theokit/http';
-import { SystemPromptResolver, InlineSkill, SettingSource, MemorySettings, SkillsSettings, ContextSettings, CustomTool, PluginsSettings, Plugin, ProviderRoutingSettings, AgentDefinition as AgentDefinition$1, BudgetTracker, ModelSelection, PreToolCallContext, PreToolCallDecision, PostToolCallContext, ToolResultTransformContext, TransformContext, SessionLifecycleContext, PreUserSendContext, PreUserSendResult, PostAssistantReplyContext } from '@theokit/sdk';
+import { SystemPromptResolver, InlineSkill, SettingSource, MemorySettings, SkillsSettings, ContextSettings, PreToolCallContext, PreToolCallDecision, PostToolCallContext, ToolResultTransformContext, TransformContext, SessionLifecycleContext, PreUserSendContext, PreUserSendResult, PostAssistantReplyContext, CustomTool, PluginsSettings, Plugin, ProviderRoutingSettings, AgentDefinition as AgentDefinition$1, BudgetTracker, ModelSelection } from '@theokit/sdk';
 import { z } from 'zod';
 import { UIMessageChunk } from 'ai';
 import { RetryOptions } from '@theokit/sdk/retry';
@@ -721,6 +721,59 @@ interface AgentRouteContext {
 /** Generate HTTP routes for a single agent. Returns Web Standard handlers. */
 declare function generateAgentRoutes(ctx: AgentRouteContext): AgentRoute[];
 
+/**
+ * M82 — the typed shape of `AgentBuilder.create().hooks({...})`.
+ *
+ * ## Por que este tipo mora aqui
+ *
+ * Até o M82 a assinatura era `Readonly<Record<string, unknown>>`: qualquer chave era aceita e cada
+ * handler recebia `ctx: unknown`. O consumidor que quisesse tipo tinha de declarar o seu — e foi
+ * exatamente o que o agent-builder fez, com um alias local de cinco handlers, quatro deles com
+ * `ctx: unknown` porque não havia de onde importar os contextos.
+ *
+ * É a mesma classe que o M81 fechou com `discoverSubagents`: conhecimento do framework reimplementado
+ * no app porque o framework não o publicava. O tipo nasce onde o conhecimento mora.
+ *
+ * ## Sobre `transform_tool_result`
+ *
+ * Este é o ÚNICO canal de estágio-de-tool cujo retorno o SDK aplica — `#runTransform` dobra o valor
+ * devolvido; `#runFireAndForget`, usado por `post_tool_call`, descarta. Desde o M82 seu contexto
+ * carrega `toolCalls`, de modo que uma política com escopo (por nome de tool) possa AGIR sobre o
+ * resultado em vez de apenas observá-lo.
+ */
+
+/**
+ * Handlers de ciclo de vida chaveados por `HookName`.
+ *
+ * Cada campo é opcional: um agente registra só os eventos que lhe interessam. `.hooks()` aceita a
+ * UNIÃO deste tipo com o shape solto de antes (ADR-4 do M82), então não é preciso index signature
+ * implícita para o valor passar no call site — o estreitamento é gradual, não uma quebra.
+ */
+interface HookHandlers {
+    /**
+     * Roda ANTES da tool. Devolver `{ block: true, message }` VETA a chamada — é o único hook com
+     * poder de veto.
+     */
+    pre_tool_call?: (ctx: PreToolCallContext) => Promise<PreToolCallDecision | undefined> | PreToolCallDecision | undefined;
+    /**
+     * Roda DEPOIS da tool, com `{name, args, result}`. Fire-and-forget: o retorno é **descartado**
+     * pelo SDK. Para AGIR sobre o resultado use {@link transform_tool_result}.
+     */
+    post_tool_call?: (ctx: PostToolCallContext) => Promise<void> | void;
+    /**
+     * Dobra os resultados de tool do turn antes de eles subirem ao modelo. Desde o M82 o contexto traz
+     * `toolCalls` — plural, porque o seam recebe o LOTE do turn; correlacione por
+     * `toolUseId === id`.
+     */
+    transform_tool_result?: <T>(results: T, ctx: ToolResultTransformContext) => Promise<T> | T;
+    /** Dobra o texto do modelo antes de ele ser consumido. Sem tool call envolvida. */
+    transform_llm_output?: (output: string, ctx: TransformContext) => Promise<string> | string;
+    on_session_start?: (ctx: SessionLifecycleContext) => Promise<void> | void;
+    on_session_end?: (ctx: SessionLifecycleContext) => Promise<void> | void;
+    pre_user_send?: (ctx: PreUserSendContext) => Promise<PreUserSendResult | undefined> | PreUserSendResult | undefined;
+    post_assistant_reply?: (ctx: PostAssistantReplyContext) => Promise<void> | void;
+}
+
 /**
  * M2 (theokit-ai-first) — `defineAgent`, the zero-config imperative agent surface.
  *
@@ -810,7 +863,7 @@ interface DefineAgentConfig<TInput extends z.ZodType = z.ZodType> {
      * the builder's `hooks()`; converted into a code plugin at `build()` and never reaching the SDK
      * under this name — the plugin is the TRANSPORT, this is the contract callers write against.
      */
-    hooks?: Readonly<Record<string, unknown>>;
+    hooks?: HookHandlers | Readonly<Record<string, unknown>>;
     /**
      * MCP servers available to the agent — the builder-chain equivalent of the `@MCP` class
      * decorator. Each key is a server name; the value is the server configuration. Forwarded
@@ -1058,61 +1111,6 @@ declare function presentUIMessageStream(events: AsyncIterable<AgentStreamEvent>,
     textId: string;
 }): AsyncGenerator<UIMessageChunk, void, unknown>;
 
-/**
- * M82 — the typed shape of `AgentBuilder.create().hooks({...})`.
- *
- * ## Por que este tipo mora aqui
- *
- * Até o M82 a assinatura era `Readonly<Record<string, unknown>>`: qualquer chave era aceita e todo
- * handler recebia `ctx: unknown`. O consumidor que quisesse tipo tinha de declarar o seu — e foi
- * exatamente o que o agent-builder fez, com um alias local de cinco handlers, quatro deles com
- * `ctx: unknown` porque não havia de onde importar os contextos.
- *
- * É a mesma classe que o M81 fechou com `discoverSubagents`: conhecimento do framework reimplementado
- * no app porque o framework não o publicava. O tipo nasce onde o conhecimento mora.
- *
- * ## Sobre `transform_tool_result`
- *
- * Este é o ÚNICO canal de estágio-de-tool cujo retorno o SDK aplica — `#runTransform` dobra o valor
- * devolvido; `#runFireAndForget`, usado por `post_tool_call`, descarta. Desde o M82 seu contexto
- * carrega `toolCalls`, de modo que uma política com escopo (por nome de tool) possa AGIR sobre o
- * resultado em vez de apenas observá-lo.
- */
-
-/**
- * Handlers de ciclo de vida chaveados por `HookName`.
- *
- * TYPE ALIAS, não interface: só aliases ganham index signature implícita, e é isso que mantém o
- * valor atribuível ao parâmetro solto de `.hooks()` sem cast no call site (ADR-4 do M82 — o
- * estreitamento é gradual, não uma quebra).
- *
- * Todo campo é opcional: um agente registra só os eventos que lhe interessam.
- */
-type HookHandlers = {
-    /**
-     * Roda ANTES da tool. Devolver `{ block: true, message }` VETA a chamada — é o único hook com
-     * poder de veto.
-     */
-    pre_tool_call?: (ctx: PreToolCallContext) => Promise<PreToolCallDecision | undefined> | PreToolCallDecision | undefined;
-    /**
-     * Roda DEPOIS da tool, com `{name, args, result}`. Fire-and-forget: o retorno é **descartado**
-     * pelo SDK. Para AGIR sobre o resultado use {@link transform_tool_result}.
-     */
-    post_tool_call?: (ctx: PostToolCallContext) => Promise<void> | void;
-    /**
-     * Dobra os resultados de tool do turn antes de eles subirem ao modelo. Desde o M82 o contexto traz
-     * `toolCalls` — plural, porque o seam recebe o LOTE do turn; correlacione por
-     * `toolUseId === id`.
-     */
-    transform_tool_result?: <T>(results: T, ctx: ToolResultTransformContext) => Promise<T> | T;
-    /** Dobra o texto do modelo antes de ele ser consumido. Sem tool call envolvida. */
-    transform_llm_output?: (output: string, ctx: TransformContext) => Promise<string> | string;
-    on_session_start?: (ctx: SessionLifecycleContext) => Promise<void> | void;
-    on_session_end?: (ctx: SessionLifecycleContext) => Promise<void> | void;
-    pre_user_send?: (ctx: PreUserSendContext) => Promise<PreUserSendResult | undefined> | PreUserSendResult | undefined;
-    post_assistant_reply?: (ctx: PostAssistantReplyContext) => Promise<void> | void;
-};
-
 /**
  * M8 — `AgentBuilder.create()`, the fluent agent builder with accumulative **type-state**.
  *

package/dist/bridge.d.ts

@@ -1,4 +1,4 @@
-export { g as AGENT_BRAND, h as AfterToolCallContext, i as AgentBuilder, j as AgentDefinition, k as AgentDefinitionError, l as AgentExecutionContext, m as AgentManifest, f as AgentManifestEntry, n as AgentManifestSource, o as AgentManifestTool, 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, N as CheckpointSavedEvent, C as CompiledAgentOptions, O as CompiledContextWindow, a as CompiledTool, P as ContextualTool, V as DefineAgentConfig, W as DelegateFn, X as DelegateOptions, Y as DelegationError, D as DelegationResult, Z as DoneEvent, _ as ErrorEvent, $ as FileEditEvent, a6 as InferAgentInput, a7 as InferAgentToolNames, a8 as IterationEvent, a9 as LLMCallContext, ae as McpApprovalSpec, af as McpRegistryConfig, ag as McpRequestContext, ah as McpSelection, ai as PartialToolCallEvent, ak as ProcessInputContext, ao as RunStartedEvent, ap as ScoreVerdict, aq as ScoredDelegation, ar as Scorer, as as SdkAgentHandle, at as SdkMessage, au as Segment, ax as StateUpdateEvent, S as StreamEvent, ay as TextDeltaEvent, az as ThinkingEvent, aB as ToolCallEvent, aC as ToolCallVeto, aD as ToolHooks, aE as ToolHooksPlugin, aF as ToolResultEvent, aG as ToolWalkResult, aI as ToolboxWalkResult, aJ as agentsPlugin, aK as buildModelSelection, aL as compileAgentDefinition, aM as compileAgentModule, aN as compileContextWindow, aO as compileProjectContext, aP as compileSkills, aQ as compileTools, aR as createAgentExecutionContext, aS as createApiErrorHandler, aT as createSdkAgentStream, aU as createThinkTagExtractor, aV as createToolHooksPlugin, aW as delegate, aX as delegateBackground, aY as delegateWithScoring, aZ as extractThinkTagStream, a_ as generateAgentManifest, a$ as generateAgentRoutes, b0 as isAgentContext, b1 as isAgentDefinition, b2 as isApprovalRequired, b3 as isDone, b4 as isError, b5 as isPartialToolCall, b6 as isTextDelta, b7 as isToolCall, b8 as isToolResult, bb as mcpRegistry, bc as mcpToolApprovals, be as presentUIMessageStream, bf as projectContextMetadataOnlyKnobs, bj as resolveMcpServers, bk as runWithApiErrorHandling, bl as streamAgentResponse, bm as streamAgentUIMessages, bn as toAgentFactory, bo as translateSdkEvent } from './bridge-entry-DMh--RZ5.js';
+export { g as AGENT_BRAND, h as AfterToolCallContext, i as AgentBuilder, j as AgentDefinition, k as AgentDefinitionError, l as AgentExecutionContext, m as AgentManifest, f as AgentManifestEntry, n as AgentManifestSource, o as AgentManifestTool, 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, N as CheckpointSavedEvent, C as CompiledAgentOptions, O as CompiledContextWindow, a as CompiledTool, P as ContextualTool, V as DefineAgentConfig, W as DelegateFn, X as DelegateOptions, Y as DelegationError, D as DelegationResult, Z as DoneEvent, _ as ErrorEvent, $ as FileEditEvent, a6 as InferAgentInput, a7 as InferAgentToolNames, a8 as IterationEvent, a9 as LLMCallContext, ae as McpApprovalSpec, af as McpRegistryConfig, ag as McpRequestContext, ah as McpSelection, ai as PartialToolCallEvent, ak as ProcessInputContext, ao as RunStartedEvent, ap as ScoreVerdict, aq as ScoredDelegation, ar as Scorer, as as SdkAgentHandle, at as SdkMessage, au as Segment, ax as StateUpdateEvent, S as StreamEvent, ay as TextDeltaEvent, az as ThinkingEvent, aB as ToolCallEvent, aC as ToolCallVeto, aD as ToolHooks, aE as ToolHooksPlugin, aF as ToolResultEvent, aG as ToolWalkResult, aI as ToolboxWalkResult, aJ as agentsPlugin, aK as buildModelSelection, aL as compileAgentDefinition, aM as compileAgentModule, aN as compileContextWindow, aO as compileProjectContext, aP as compileSkills, aQ as compileTools, aR as createAgentExecutionContext, aS as createApiErrorHandler, aT as createSdkAgentStream, aU as createThinkTagExtractor, aV as createToolHooksPlugin, aW as delegate, aX as delegateBackground, aY as delegateWithScoring, aZ as extractThinkTagStream, a_ as generateAgentManifest, a$ as generateAgentRoutes, b0 as isAgentContext, b1 as isAgentDefinition, b2 as isApprovalRequired, b3 as isDone, b4 as isError, b5 as isPartialToolCall, b6 as isTextDelta, b7 as isToolCall, b8 as isToolResult, bb as mcpRegistry, bc as mcpToolApprovals, be as presentUIMessageStream, bf as projectContextMetadataOnlyKnobs, bj as resolveMcpServers, bk as runWithApiErrorHandling, bl as streamAgentResponse, bm as streamAgentUIMessages, bn as toAgentFactory, bo as translateSdkEvent } from './bridge-entry-_RN_53jC.js';
 import '@theokit/http';
 import '@theokit/sdk';
 import 'zod';

package/dist/bridge.js

@@ -43,7 +43,7 @@ import {
   streamAgentUIMessages,
   toAgentFactory,
   translateSdkEvent
-} from "./chunk-IB7I44PO.js";
+} from "./chunk-SDJLIKOH.js";
 import "./chunk-7QVYU63E.js";
 export {
   AGENT_BRAND,

package/dist/{chunk-IB7I44PO.js → chunk-SDJLIKOH.js}

@@ -3508,4 +3508,4 @@ export {
   generateAgentManifest,
   agentsPlugin
 };
-//# sourceMappingURL=chunk-IB7I44PO.js.map
+//# sourceMappingURL=chunk-SDJLIKOH.js.map