@anvia/core 1.11.1 → 1.13.0

package/dist/internal/agent-runtime/execution.js

@@ -1,6 +1,6 @@
 import {
   AGENT_RUN_EXECUTION_VERSION
-} from "../../chunk-SHSSCEGO.js";
+} from "../../chunk-MG7JYQN2.js";
 export {
   AGENT_RUN_EXECUTION_VERSION
 };

package/dist/internal/agent-runtime/tool-execution.js

@@ -1,10 +1,10 @@
 import {
   ToolCallExecutor
-} from "../../chunk-DRSKZVC6.js";
+} from "../../chunk-ED7RKQHE.js";
 import "../../chunk-5IURMWFN.js";
 import "../../chunk-2NLINXRF.js";
 import "../../chunk-JMJFK3A4.js";
-import "../../chunk-MNBKSRS5.js";
+import "../../chunk-IRXAEVEQ.js";
 import "../../chunk-CASF2TDK.js";
 import "../../chunk-4AW2633B.js";
 import "../../chunk-OJF67RNM.js";

package/dist/internal/agent.d.ts

@@ -1,5 +1,5 @@
 import { R as ResolvedAgentOptions, A as Agent } from '../agent-BuX5AXsO.js';
-import { d as CompletionModel, P as ProviderTool, M as Message, U as Usage, k as CompletionResponse, j as CompletionRequest, y as ToolCallPart, G as ToolResultContentPart } from '../types-DYqZKDA8.js';
+import { d as CompletionModel, P as ProviderTool, M as Message, U as Usage, k as CompletionResponse, O as UserMessage, j as CompletionRequest, y as ToolCallPart, G as ToolResultContentPart } from '../types-DYqZKDA8.js';
 import { T as ToolIndex } from '../dynamic-tools-B3OjYyhC.js';
 import { A as AnyTool, c as ToolCallContext, N as NormalizedToolOutput } from '../tool-W1cAPuRF.js';
 import { e as MemoryCompactionInfo, G as MemoryTokenCounter, o as MemoryCompactor, B as MemoryScope } from '../types-CWh9AQrq.js';
@@ -65,7 +65,7 @@ declare function finishLoopContext(plan: LoopContextPlan, result: {
 }, counter?: MemoryTokenCounter, signal?: AbortSignal, attempts?: number): Promise<PreparedLoopContext>;
 
 /** Runtime capability marker: older core versions must fail before accepting durable work. */
-declare const AGENT_RUN_EXECUTION_VERSION = 3;
+declare const AGENT_RUN_EXECUTION_VERSION = 4;
 /** Normalized generation progress; never includes raw provider responses. */
 type AgentCompletionStreamEvent = Extract<AgentStreamEvent<unknown, unknown>, {
     type: "text_delta" | "reasoning_delta" | "tool_call_delta" | "tool_call" | "source" | "provider_tool_call";
@@ -81,6 +81,11 @@ type AgentToolExecutionResult = {
 };
 /** Internal persistence boundary used by execution runtimes. Callbacks own external effects. */
 interface AgentRunExecution {
+    /** Synchronously checkpoint queued input at a safe boundary, including empty/closing drains. */
+    drainSteering?(turn: number, closing: boolean): {
+        id: string;
+        messages: UserMessage[];
+    }[];
     /** Persist the context selected before each model call, including skipped compaction decisions. */
     prepareMessages?(turn: number, messages: readonly Message[], checkpoint?: LoopContextCheckpoint): Promise<PreparedLoopContext>;
     completion(turn: number, request: CompletionRequest, execute: () => Promise<CompletionResponse>): Promise<CompletionResponse>;

package/dist/internal/agent.js

@@ -1,16 +1,16 @@
 import {
   AGENT_RUN_EXECUTION_VERSION
-} from "../chunk-SHSSCEGO.js";
+} from "../chunk-MG7JYQN2.js";
 import {
   createResolvedAgent,
   getResolvedAgentOptions
-} from "../chunk-7XDM7A3W.js";
+} from "../chunk-22E25UM7.js";
 import {
   Agent
-} from "../chunk-TXWNIEZU.js";
-import "../chunk-WU4ODZKR.js";
+} from "../chunk-HF5SX5BQ.js";
+import "../chunk-OZ2GZHWH.js";
 import "../chunk-SXE4J43E.js";
-import "../chunk-DRSKZVC6.js";
+import "../chunk-ED7RKQHE.js";
 import "../chunk-LAIATEUB.js";
 import "../chunk-3F6ZY63S.js";
 import {
@@ -29,7 +29,7 @@ import "../chunk-5ZM5DB3O.js";
 import "../chunk-5IURMWFN.js";
 import "../chunk-2NLINXRF.js";
 import "../chunk-JMJFK3A4.js";
-import "../chunk-MNBKSRS5.js";
+import "../chunk-IRXAEVEQ.js";
 import "../chunk-CASF2TDK.js";
 import "../chunk-4AW2633B.js";
 import "../chunk-YNA3UR42.js";

package/dist/internal/team-runtime/run.js

@@ -1,15 +1,15 @@
 import {
   TeamRun
-} from "../../chunk-PLJQ4274.js";
+} from "../../chunk-CKWIXVXM.js";
 import "../../chunk-PIMD4DYG.js";
 import "../../chunk-FSBDE6RF.js";
 import "../../chunk-X35O3AQG.js";
 import "../../chunk-ENZ2XX27.js";
-import "../../chunk-7XDM7A3W.js";
-import "../../chunk-TXWNIEZU.js";
-import "../../chunk-WU4ODZKR.js";
+import "../../chunk-22E25UM7.js";
+import "../../chunk-HF5SX5BQ.js";
+import "../../chunk-OZ2GZHWH.js";
 import "../../chunk-SXE4J43E.js";
-import "../../chunk-DRSKZVC6.js";
+import "../../chunk-ED7RKQHE.js";
 import "../../chunk-LAIATEUB.js";
 import "../../chunk-3F6ZY63S.js";
 import "../../chunk-ZWYMXBGB.js";
@@ -21,7 +21,7 @@ import "../../chunk-5ZM5DB3O.js";
 import "../../chunk-5IURMWFN.js";
 import "../../chunk-2NLINXRF.js";
 import "../../chunk-JMJFK3A4.js";
-import "../../chunk-MNBKSRS5.js";
+import "../../chunk-IRXAEVEQ.js";
 import "../../chunk-CASF2TDK.js";
 import "../../chunk-4AW2633B.js";
 import "../../chunk-YNA3UR42.js";

package/dist/skills/index.js

@@ -6,14 +6,14 @@ import "../chunk-JBQNCUXA.js";
 import {
   skill
 } from "../chunk-ZUFS6R7L.js";
+import "../chunk-5G4NMOTJ.js";
 import {
   SkillValidationError
 } from "../chunk-B5JQDR33.js";
-import "../chunk-5G4NMOTJ.js";
 import "../chunk-V4OZ7ISA.js";
 import "../chunk-2NLINXRF.js";
 import "../chunk-JMJFK3A4.js";
-import "../chunk-MNBKSRS5.js";
+import "../chunk-IRXAEVEQ.js";
 import "../chunk-CASF2TDK.js";
 import "../chunk-4AW2633B.js";
 import "../chunk-VUY2C2QD.js";

package/dist/skills/load.js

@@ -5,7 +5,7 @@ import "../chunk-JBQNCUXA.js";
 import "../chunk-5G4NMOTJ.js";
 import "../chunk-2NLINXRF.js";
 import "../chunk-JMJFK3A4.js";
-import "../chunk-MNBKSRS5.js";
+import "../chunk-IRXAEVEQ.js";
 import "../chunk-CASF2TDK.js";
 import "../chunk-4AW2633B.js";
 import "../chunk-VUY2C2QD.js";

package/dist/skills/tools.js

@@ -3,7 +3,7 @@ import {
 } from "../chunk-5G4NMOTJ.js";
 import "../chunk-2NLINXRF.js";
 import "../chunk-JMJFK3A4.js";
-import "../chunk-MNBKSRS5.js";
+import "../chunk-IRXAEVEQ.js";
 import "../chunk-CASF2TDK.js";
 import "../chunk-4AW2633B.js";
 import "../chunk-VUY2C2QD.js";

package/dist/think-tool-CTuagAtn.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { Z as ZodSchema } from './zod-schema-C7F4clpm.js';
+import { e as ToolRequiresApproval, c as ToolCallContext, T as Tool } from './tool-W1cAPuRF.js';
+import { AgentQuestionPrompt, AgentQuestionAnswer } from './agent/interactions/index.js';
+
+type CreateToolOptions<InputSchema extends ZodSchema, OutputSchema extends ZodSchema | undefined = undefined, Output = unknown> = {
+    name: string;
+    description: string;
+    inputSchema: InputSchema;
+    outputSchema?: OutputSchema;
+    requiresApproval?: ToolRequiresApproval<z.output<InputSchema>>;
+    execute(args: z.output<InputSchema>, context: ToolCallContext): OutputSchema extends ZodSchema ? z.input<OutputSchema> | Promise<z.input<OutputSchema>> : Output | Promise<Output>;
+};
+declare function createTool<InputSchema extends ZodSchema, Output = unknown>(options: CreateToolOptions<InputSchema, undefined, Output> & {
+    outputSchema?: undefined;
+}): Tool<z.output<InputSchema>, Output>;
+declare function createTool<InputSchema extends ZodSchema, OutputSchema extends ZodSchema>(options: CreateToolOptions<InputSchema, OutputSchema>): Tool<z.output<InputSchema>, z.output<OutputSchema>>;
+
+declare const DEFAULT_QUESTION_TOOL_NAME = "ask_user";
+declare const DEFAULT_QUESTION_TOOL_DESCRIPTION = "Ask the user questions and wait for their answers before continuing.\n\nUse this tool only when you cannot continue without the user's input:\n- The request is ambiguous, and different readings would lead to clearly different results.\n- A decision belongs to the user: a preference, a tradeoff, or something that is hard to undo.\n- Information you need is missing and you cannot find it with your other tools or work it out from the conversation.\n\nDo not use it:\n- For facts you can look up with your other tools, or work out from the conversation.\n- To ask permission for routine steps the user has already asked for.\n- To check whether your answer or plan is good. Finish the work and let the user react.\n- For choices with a sensible default. Pick it, and mention the choice in your reply.\n\nHow to ask:\n- Put every question you need into one call instead of calling the tool repeatedly. Ask no more than 4 questions per call.\n- Give each question a short, unique `id` in snake_case.\n- Write `text` as one complete, self-contained question that ends with a question mark.\n- When there is a known set of reasonable answers, give 2\u20134 `choices` with a short `label` and a stable `value`. Make the choices mutually exclusive. If you recommend one, list it first and add \" (recommended)\" to its label.\n- Set `allowCustom: true` when the user might want an answer outside the list. Leave out `choices` for open-ended questions. Do not add an \"Other\" choice.\n\nAfter you get the answers:\n- Each answer has a `questionId` and a `value` (the chosen value or the user's free text).\n- Follow the answers. Do not ask the same question again unless an answer is unclear or contradicts another one.";
+type QuestionToolInput = {
+    questions: readonly AgentQuestionPrompt[];
+};
+type QuestionToolOutput = {
+    answers: readonly AgentQuestionAnswer[];
+};
+type CreateQuestionToolOptions = {
+    /** Defaults when omitted. Supply a nonblank name; explicit strings are preserved. */
+    name?: string;
+    /** Defaults when omitted. Supply nonblank instructions; explicit strings are preserved. */
+    description?: string;
+};
+declare function createQuestionTool(options?: CreateQuestionToolOptions): Tool<QuestionToolInput, QuestionToolOutput>;
+declare function isQuestionTool(tool: unknown): tool is Tool<QuestionToolInput, QuestionToolOutput>;
+
+type CreateThinkToolOptions = {
+    name?: string;
+    description?: string;
+};
+declare function createThinkTool(options?: CreateThinkToolOptions): Tool<{
+    thought: string;
+}, string>;
+
+export { type CreateToolOptions as C, DEFAULT_QUESTION_TOOL_DESCRIPTION as D, type QuestionToolInput as Q, DEFAULT_QUESTION_TOOL_NAME as a, createThinkTool as b, createQuestionTool as c, createTool as d, type CreateQuestionToolOptions as e, type CreateThinkToolOptions as f, type QuestionToolOutput as g, isQuestionTool as i };

package/dist/tool/index.d.ts

@@ -1,4 +1,4 @@
-export { d as CreateQuestionToolOptions, e as CreateThinkToolOptions, C as CreateToolOptions, Q as QuestionToolInput, f as QuestionToolOutput, c as createQuestionTool, a as createThinkTool, b as createTool, i as isQuestionTool } from '../think-tool-DJbtUDZm.js';
+export { e as CreateQuestionToolOptions, f as CreateThinkToolOptions, C as CreateToolOptions, D as DEFAULT_QUESTION_TOOL_DESCRIPTION, a as DEFAULT_QUESTION_TOOL_NAME, Q as QuestionToolInput, g as QuestionToolOutput, c as createQuestionTool, b as createThinkTool, d as createTool, i as isQuestionTool } from '../think-tool-CTuagAtn.js';
 export { C as CreateToolIndexOptions, E as EmbedToolsOptions, T as ToolIndex, a as ToolSearchDocument, c as createToolIndex, e as embedTools, i as isToolIndex } from '../dynamic-tools-B3OjYyhC.js';
 export { k as AgentMiddleware, C as CompletionRequestMiddlewareArgs, z as CompletionRequestMiddlewareResult, B as CompletionResponseMiddlewareArgs, D as CompletionResponseMiddlewareResult, T as ToolInputMiddlewareArgs, E as ToolInputMiddlewareResult, F as ToolOutputMiddlewareArgs, G as ToolOutputMiddlewareResult, H as ToolResultMiddlewareArgs, I as createMiddleware } from '../middleware-D_kNSjzW.js';
 export { A as AnyTool, N as NormalizedToolOutput, R as RichToolOutput, T as Tool, a as ToolApprovalContext, b as ToolApprovalRequirement, f as ToolApprovalRunContext, c as ToolCallContext, d as ToolCallStreamEvent, g as ToolOutput, e as ToolRequiresApproval, h as ToolResultSerializationError, n as normalizeToolResultOutput, p as parseToolArgs, t as toolResultContentToText } from '../tool-W1cAPuRF.js';

package/dist/tool/index.js

@@ -1,8 +1,10 @@
 import "../chunk-JMJFK3A4.js";
 import {
+  DEFAULT_QUESTION_TOOL_DESCRIPTION,
+  DEFAULT_QUESTION_TOOL_NAME,
   createQuestionTool,
   isQuestionTool
-} from "../chunk-MNBKSRS5.js";
+} from "../chunk-IRXAEVEQ.js";
 import {
   createThinkTool
 } from "../chunk-CASF2TDK.js";
@@ -51,6 +53,8 @@ import "../chunk-SQAAVYJG.js";
 import "../chunk-POXHJF3H.js";
 import "../chunk-USRKPEQN.js";
 export {
+  DEFAULT_QUESTION_TOOL_DESCRIPTION,
+  DEFAULT_QUESTION_TOOL_NAME,
   ToolCallError,
   ToolJsonError,
   ToolNotFoundError,

package/dist/tool/question-tool.js

@@ -1,7 +1,9 @@
 import {
+  DEFAULT_QUESTION_TOOL_DESCRIPTION,
+  DEFAULT_QUESTION_TOOL_NAME,
   createQuestionTool,
   isQuestionTool
-} from "../chunk-MNBKSRS5.js";
+} from "../chunk-IRXAEVEQ.js";
 import "../chunk-MEFGXAKJ.js";
 import "../chunk-27MBNR47.js";
 import "../chunk-YZVFIW5D.js";
@@ -11,6 +13,8 @@ import "../chunk-BONQTXRQ.js";
 import "../chunk-4C7AXYOM.js";
 import "../chunk-SQAAVYJG.js";
 export {
+  DEFAULT_QUESTION_TOOL_DESCRIPTION,
+  DEFAULT_QUESTION_TOOL_NAME,
   createQuestionTool,
   isQuestionTool
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anvia/core",
-  "version": "1.11.1",
+  "version": "1.13.0",
   "description": "Core runtime primitives for context-aware Anvia agents.",
   "author": "anvia",
   "license": "MIT",

package/dist/chunk-MNBKSRS5.js

@@ -1,47 +0,0 @@
-import {
-  createTool
-} from "./chunk-MEFGXAKJ.js";
-
-// src/tool/question-tool.ts
-import { z } from "zod";
-var questionToolMarker = /* @__PURE__ */ Symbol("anvia.question-tool");
-function createQuestionTool(options) {
-  const tool = createTool({
-    name: options.name,
-    description: options.description,
-    inputSchema: z.object({
-      questions: z.array(
-        z.object({
-          id: z.string().trim().min(1),
-          text: z.string().trim().min(1),
-          choices: z.array(
-            z.object({
-              label: z.string().trim().min(1),
-              value: z.string().trim().min(1)
-            }).strict()
-          ).min(1).optional(),
-          allowCustom: z.boolean().optional()
-        }).strict()
-      ).min(1)
-    }).strict(),
-    execute() {
-      throw new Error("Question tools can only be resolved through an Agent interaction.");
-    }
-  });
-  Object.defineProperty(tool, questionToolMarker, {
-    configurable: false,
-    enumerable: false,
-    value: true,
-    writable: false
-  });
-  return tool;
-}
-function isQuestionTool(tool) {
-  return typeof tool === "object" && tool !== null && questionToolMarker in tool;
-}
-
-export {
-  createQuestionTool,
-  isQuestionTool
-};
-//# sourceMappingURL=chunk-MNBKSRS5.js.map

package/dist/chunk-MNBKSRS5.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/tool/question-tool.ts"],"sourcesContent":["import { z } from \"zod\";\nimport type { AgentQuestionAnswer, AgentQuestionPrompt } from \"../agent/interactions\";\nimport { createTool } from \"./create-tool\";\nimport type { Tool } from \"./tool\";\n\nconst questionToolMarker = Symbol(\"anvia.question-tool\");\n\nexport type QuestionToolInput = {\n  questions: readonly AgentQuestionPrompt[];\n};\n\nexport type QuestionToolOutput = {\n  answers: readonly AgentQuestionAnswer[];\n};\n\nexport type CreateQuestionToolOptions = {\n  name: string;\n  description: string;\n};\n\ntype MarkedQuestionTool = Tool<QuestionToolInput, QuestionToolOutput> & {\n  readonly [questionToolMarker]: true;\n};\n\nexport function createQuestionTool(\n  options: CreateQuestionToolOptions,\n): Tool<QuestionToolInput, QuestionToolOutput> {\n  const tool = createTool({\n    name: options.name,\n    description: options.description,\n    inputSchema: z\n      .object({\n        questions: z\n          .array(\n            z\n              .object({\n                id: z.string().trim().min(1),\n                text: z.string().trim().min(1),\n                choices: z\n                  .array(\n                    z\n                      .object({\n                        label: z.string().trim().min(1),\n                        value: z.string().trim().min(1),\n                      })\n                      .strict(),\n                  )\n                  .min(1)\n                  .optional(),\n                allowCustom: z.boolean().optional(),\n              })\n              .strict(),\n          )\n          .min(1),\n      })\n      .strict(),\n    execute(): never {\n      throw new Error(\"Question tools can only be resolved through an Agent interaction.\");\n    },\n  }) as unknown as MarkedQuestionTool;\n  Object.defineProperty(tool, questionToolMarker, {\n    configurable: false,\n    enumerable: false,\n    value: true,\n    writable: false,\n  });\n  return tool;\n}\n\nexport function isQuestionTool(tool: unknown): tool is Tool<QuestionToolInput, QuestionToolOutput> {\n  return typeof tool === \"object\" && tool !== null && questionToolMarker in tool;\n}\n"],"mappings":";;;;;AAAA,SAAS,SAAS;AAKlB,IAAM,qBAAqB,uBAAO,qBAAqB;AAmBhD,SAAS,mBACd,SAC6C;AAC7C,QAAM,OAAO,WAAW;AAAA,IACtB,MAAM,QAAQ;AAAA,IACd,aAAa,QAAQ;AAAA,IACrB,aAAa,EACV,OAAO;AAAA,MACN,WAAW,EACR;AAAA,QACC,EACG,OAAO;AAAA,UACN,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC;AAAA,UAC3B,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC;AAAA,UAC7B,SAAS,EACN;AAAA,YACC,EACG,OAAO;AAAA,cACN,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC;AAAA,cAC9B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC;AAAA,YAChC,CAAC,EACA,OAAO;AAAA,UACZ,EACC,IAAI,CAAC,EACL,SAAS;AAAA,UACZ,aAAa,EAAE,QAAQ,EAAE,SAAS;AAAA,QACpC,CAAC,EACA,OAAO;AAAA,MACZ,EACC,IAAI,CAAC;AAAA,IACV,CAAC,EACA,OAAO;AAAA,IACV,UAAiB;AACf,YAAM,IAAI,MAAM,mEAAmE;AAAA,IACrF;AAAA,EACF,CAAC;AACD,SAAO,eAAe,MAAM,oBAAoB;AAAA,IAC9C,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,OAAO;AAAA,IACP,UAAU;AAAA,EACZ,CAAC;AACD,SAAO;AACT;AAEO,SAAS,eAAe,MAAoE;AACjG,SAAO,OAAO,SAAS,YAAY,SAAS,QAAQ,sBAAsB;AAC5E;","names":[]}

package/dist/chunk-SHSSCEGO.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/internal/agent-runtime/execution.ts"],"sourcesContent":["import type { PreparedLoopContext, LoopContextCheckpoint } from \"./loop-context\";\nimport type {\n  CompletionRequest,\n  CompletionResponse,\n  ToolCallPart,\n  Message,\n} from \"../../completion\";\nimport type { NormalizedToolOutput, ToolCallContext } from \"../../tool\";\nimport type { AgentStreamEvent } from \"../../agent/run-types\";\n\n/** Runtime capability marker: older core versions must fail before accepting durable work. */\nexport const AGENT_RUN_EXECUTION_VERSION = 3;\n\n/** Normalized generation progress; never includes raw provider responses. */\nexport type AgentCompletionStreamEvent = Extract<\n  AgentStreamEvent<unknown, unknown>,\n  {\n    type:\n      | \"text_delta\"\n      | \"reasoning_delta\"\n      | \"tool_call_delta\"\n      | \"tool_call\"\n      | \"source\"\n      | \"provider_tool_call\";\n  }\n>;\n\nexport type AgentCompletionStream = AsyncGenerator<AgentCompletionStreamEvent, CompletionResponse>;\n\nexport type AgentToolExecutionResult =\n  | { output: NormalizedToolOutput; failed: false }\n  | { output: NormalizedToolOutput; failed: true; error: unknown };\n\n/** Internal persistence boundary used by execution runtimes. Callbacks own external effects. */\nexport interface AgentRunExecution {\n  /** Persist the context selected before each model call, including skipped compaction decisions. */\n  prepareMessages?(\n    turn: number,\n    messages: readonly Message[],\n    checkpoint?: LoopContextCheckpoint,\n  ): Promise<PreparedLoopContext>;\n  completion(\n    turn: number,\n    request: CompletionRequest,\n    execute: () => Promise<CompletionResponse>,\n  ): Promise<CompletionResponse>;\n  streamCompletion?(\n    turn: number,\n    request: CompletionRequest,\n    execute: () => AgentCompletionStream,\n  ): AgentCompletionStream;\n  tool(\n    call: { turn: number; toolCall: ToolCallPart; args: string },\n    execute: (context?: Pick<ToolCallContext, \"operationId\">) => Promise<AgentToolExecutionResult>,\n  ): Promise<AgentToolExecutionResult>;\n}\n"],"mappings":";AAWO,IAAM,8BAA8B;","names":[]}