@vinhnt-sdk/core 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -4,6 +4,10 @@ export { RunStateMachine } from "@vinhnt-sdk/step-executor";
 export type { AgentKernelConfig, RunHandle, AgentRunHandle, AgentRunResult } from "./kernel/kernel-types.js";
 export { createAgent } from "./agent/agent-factory.js";
 export type { CreateAgentParams } from "./agent/agent-factory.js";
+export { agentAsTool, createHandoffTool } from "./kernel/agent-as-tool.js";
+export type { AgentAsToolOptions } from "./kernel/agent-as-tool.js";
+export { createUpdatePlanTool, createGetPlanTool } from "./tools/update-plan.js";
+export type { Plan, PlanStep } from "./tools/update-plan.js";
 export { InMemoryEventBus } from "@vinhnt-sdk/event";
 export type { EventBus, EventHandler, Unsubscribe } from "@vinhnt-sdk/event";
 export { InMemorySessionState } from "@vinhnt-sdk/session";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -9,6 +9,10 @@ export { canTransitionRun, terminalRunStatuses } from "./kernel/state-machine.js
 export { RunStateMachine } from "@vinhnt-sdk/step-executor";
 // === Agent system ===
 export { createAgent } from "./agent/agent-factory.js";
+// === Agent-as-Tool ===
+export { agentAsTool, createHandoffTool } from "./kernel/agent-as-tool.js";
+// === Plan tracking ===
+export { createUpdatePlanTool, createGetPlanTool } from "./tools/update-plan.js";
 // === Event bus ===
 export { InMemoryEventBus } from "@vinhnt-sdk/event";
 // === Session management ===

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,kDAAkD;AAClD,EAAE;AACF,6CAA6C;AAC7C,iDAAiD;AAEjD,gCAAgC;AAEhC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAI5D,uBAAuB;AAEvB,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,oBAAoB;AAEpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGrD,6BAA6B;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAGrE,yBAAyB;AAEzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,yBAAyB;AAEzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,4BAA4B;AAE5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,oBAAoB;AAEpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,uBAAuB;AAEvB,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,kBAAkB;AAElB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,iBAAiB;AAEjB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAMhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAI/C,uBAAuB;AAEvB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,mBAAmB;AAEnB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGzE,qBAAqB;AAErB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAYzH,OAAO,EACL,QAAQ,EACR,kBAAkB,EAAE,oBAAoB,EAAE,qBAAqB,EAC/D,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAC3D,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAClD,uBAAuB,EAAE,cAAc,EACvC,qBAAqB,EAAE,eAAe,EAAE,YAAY,EACpD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EACjD,kBAAkB,EAAE,WAAW,GAChC,MAAM,oBAAoB,CAAC;AAI5B,+BAA+B;AAE/B,OAAO,EACL,UAAU,EAAE,gBAAgB,EAAE,2BAA2B,EACzD,YAAY,EAAE,gBAAgB,GAC/B,MAAM,mBAAmB,CAAC;AAM3B,oCAAoC;AAEpC,OAAO,EACL,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAC3D,eAAe,EAAE,mBAAmB,EAAE,mBAAmB,EACzD,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,oBAAoB;AAEpB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAGzE,wDAAwD;AAExD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,kDAAkD;AAClD,EAAE;AACF,6CAA6C;AAC7C,iDAAiD;AAEjD,gCAAgC;AAEhC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAI5D,uBAAuB;AAEvB,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,wBAAwB;AAExB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG3E,wBAAwB;AAExB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGjF,oBAAoB;AAEpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGrD,6BAA6B;AAE7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAGrE,yBAAyB;AAEzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,yBAAyB;AAEzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,4BAA4B;AAE5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,oBAAoB;AAEpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,uBAAuB;AAEvB,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,kBAAkB;AAElB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,iBAAiB;AAEjB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAMhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAI/C,uBAAuB;AAEvB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,mBAAmB;AAEnB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGzE,qBAAqB;AAErB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAYzH,OAAO,EACL,QAAQ,EACR,kBAAkB,EAAE,oBAAoB,EAAE,qBAAqB,EAC/D,iBAAiB,EAAE,kBAAkB,EAAE,oBAAoB,EAC3D,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAClD,uBAAuB,EAAE,cAAc,EACvC,qBAAqB,EAAE,eAAe,EAAE,YAAY,EACpD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EACjD,kBAAkB,EAAE,WAAW,GAChC,MAAM,oBAAoB,CAAC;AAI5B,+BAA+B;AAE/B,OAAO,EACL,UAAU,EAAE,gBAAgB,EAAE,2BAA2B,EACzD,YAAY,EAAE,gBAAgB,GAC/B,MAAM,mBAAmB,CAAC;AAM3B,oCAAoC;AAEpC,OAAO,EACL,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAC3D,eAAe,EAAE,mBAAmB,EAAE,mBAAmB,EACzD,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,oBAAoB;AAEpB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAGzE,wDAAwD;AAExD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/kernel/agent-as-tool.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Agent-as-Tool pattern — wrap a sub-agent as a tool definition.
+ *
+ * Allows a manager agent to delegate tasks to specialist agents
+ * without losing control of the conversation.
+ *
+ * @module kernel/agent-as-tool
+ */
+import type { AgentId } from "@vinhnt-sdk/schema";
+import { type ToolDefinition } from "@vinhnt-sdk/tools";
+export interface AgentAsToolOptions {
+    /** The agent ID to delegate to */
+    readonly agentId: AgentId;
+    /** Tool name (default: "delegate_to_{agentId}") */
+    readonly toolName?: string;
+    /** Tool description for the LLM */
+    readonly toolDescription: string;
+    /** Max output length to return to parent (default: 4096) */
+    readonly maxOutputLength?: number;
+}
+/**
+ * Create a tool that delegates to a sub-agent.
+ *
+ * The tool runs the sub-agent in an isolated context and returns
+ * its output to the parent agent. The parent stays in control.
+ *
+ * @example
+ * ```typescript
+ * const reviewer = createAgent({
+ *   id: "code-reviewer",
+ *   profile: { name: "Code Reviewer", description: "Reviews code for issues" },
+ *   systemPrompt: "You are a code reviewer.",
+ *   capabilities: { tools: ["read_file", "grep_files"] },
+ * });
+ *
+ * registry.register(reviewer);
+ *
+ * const tool = agentAsTool({
+ *   agentId: "code-reviewer" as AgentId,
+ *   toolDescription: "Delegate code review to specialist",
+ * });
+ *
+ * // Register as tool for manager agent
+ * toolRegistry.register(tool);
+ * ```
+ */
+export declare function agentAsTool(options: AgentAsToolOptions): ToolDefinition;
+/**
+ * Create a handoff tool — transfers control to another agent.
+ *
+ * Unlike agent-as-tool, handoff gives full control to the target agent.
+ * The original agent pauses until the target agent completes or transfers back.
+ *
+ * @example
+ * ```typescript
+ * const handoffTool = createHandoffTool({
+ *   agentId: "billing" as AgentId,
+ *   toolDescription: "Transfer to billing specialist",
+ *   onHandoff: (reason) => console.log("Handing off:", reason),
+ * });
+ * ```
+ */
+export declare function createHandoffTool(options: {
+    readonly agentId: AgentId;
+    readonly toolName?: string;
+    readonly toolDescription: string;
+    readonly onHandoff?: (reason: string) => void | Promise<void>;
+}): ToolDefinition;
+//# sourceMappingURL=agent-as-tool.d.ts.map

package/dist/kernel/agent-as-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-as-tool.d.ts","sourceRoot":"","sources":["../../src/kernel/agent-as-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,mCAAmC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,4DAA4D;IAC5D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,cAAc,CAwBvE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D,GAAG,cAAc,CAuBjB"}

package/dist/kernel/agent-as-tool.js

@@ -0,0 +1,88 @@
+/**
+ * Agent-as-Tool pattern — wrap a sub-agent as a tool definition.
+ *
+ * Allows a manager agent to delegate tasks to specialist agents
+ * without losing control of the conversation.
+ *
+ * @module kernel/agent-as-tool
+ */
+import { z } from "zod";
+import { defineTool } from "@vinhnt-sdk/tools";
+/**
+ * Create a tool that delegates to a sub-agent.
+ *
+ * The tool runs the sub-agent in an isolated context and returns
+ * its output to the parent agent. The parent stays in control.
+ *
+ * @example
+ * ```typescript
+ * const reviewer = createAgent({
+ *   id: "code-reviewer",
+ *   profile: { name: "Code Reviewer", description: "Reviews code for issues" },
+ *   systemPrompt: "You are a code reviewer.",
+ *   capabilities: { tools: ["read_file", "grep_files"] },
+ * });
+ *
+ * registry.register(reviewer);
+ *
+ * const tool = agentAsTool({
+ *   agentId: "code-reviewer" as AgentId,
+ *   toolDescription: "Delegate code review to specialist",
+ * });
+ *
+ * // Register as tool for manager agent
+ * toolRegistry.register(tool);
+ * ```
+ */
+export function agentAsTool(options) {
+    const { agentId, toolName = `delegate_to_${agentId}`, toolDescription, maxOutputLength = 4096, } = options;
+    return defineTool({
+        name: toolName,
+        description: toolDescription,
+        risk: "write",
+        input: z.object({
+            prompt: z.string().describe("The task or question to delegate to the specialist agent"),
+            context: z.string().optional().describe("Additional context for the specialist"),
+        }),
+        execute: async (input, ctx) => {
+            const fullPrompt = input.context
+                ? `${input.prompt}\n\nAdditional context:\n${input.context}`
+                : input.prompt;
+            return `[DELEGATE:${agentId}] ${fullPrompt}`;
+        },
+    }).toDefinition();
+}
+/**
+ * Create a handoff tool — transfers control to another agent.
+ *
+ * Unlike agent-as-tool, handoff gives full control to the target agent.
+ * The original agent pauses until the target agent completes or transfers back.
+ *
+ * @example
+ * ```typescript
+ * const handoffTool = createHandoffTool({
+ *   agentId: "billing" as AgentId,
+ *   toolDescription: "Transfer to billing specialist",
+ *   onHandoff: (reason) => console.log("Handing off:", reason),
+ * });
+ * ```
+ */
+export function createHandoffTool(options) {
+    const { agentId, toolName = `transfer_to_${agentId}`, toolDescription, onHandoff, } = options;
+    return defineTool({
+        name: toolName,
+        description: toolDescription,
+        risk: "write",
+        input: z.object({
+            reason: z.string().describe("Reason for the handoff"),
+            summary: z.string().optional().describe("Summary of conversation so far"),
+        }),
+        execute: async (input, ctx) => {
+            if (onHandoff) {
+                await onHandoff(input.reason);
+            }
+            return `[HANDOFF:${agentId}] reason=${input.reason}${input.summary ? ` summary=${input.summary}` : ""}`;
+        },
+    }).toDefinition();
+}
+//# sourceMappingURL=agent-as-tool.js.map

package/dist/kernel/agent-as-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-as-tool.js","sourceRoot":"","sources":["../../src/kernel/agent-as-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAuB,MAAM,mBAAmB,CAAC;AAapE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EACJ,OAAO,EACP,QAAQ,GAAG,eAAe,OAAO,EAAE,EACnC,eAAe,EACf,eAAe,GAAG,IAAI,GACvB,GAAG,OAAO,CAAC;IAEZ,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,eAAe;QAC5B,IAAI,EAAE,OAAgB;QACtB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;YACvF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;SACjF,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO;gBAC9B,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,4BAA4B,KAAK,CAAC,OAAO,EAAE;gBAC5D,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;YAEjB,OAAO,aAAa,OAAO,KAAK,UAAU,EAAE,CAAC;QAC/C,CAAC;KACF,CAAC,CAAC,YAAY,EAAE,CAAC;AACpB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAKjC;IACC,MAAM,EACJ,OAAO,EACP,QAAQ,GAAG,eAAe,OAAO,EAAE,EACnC,eAAe,EACf,SAAS,GACV,GAAG,OAAO,CAAC;IAEZ,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,eAAe;QAC5B,IAAI,EAAE,OAAgB;QACtB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YACrD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;SAC1E,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YACD,OAAO,YAAY,OAAO,YAAY,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1G,CAAC;KACF,CAAC,CAAC,YAAY,EAAE,CAAC;AACpB,CAAC"}

package/dist/tools/update-plan.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Plan tracking tool — allows agents to maintain structured task plans.
+ *
+ * @module tools/update-plan
+ */
+import { type ToolDefinition } from "@vinhnt-sdk/tools";
+export interface PlanStep {
+    readonly id: string;
+    readonly text: string;
+    readonly status: "pending" | "in_progress" | "completed" | "failed";
+    readonly createdAt: string;
+    readonly completedAt?: string | undefined;
+}
+export interface Plan {
+    readonly id: string;
+    readonly steps: PlanStep[];
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly explanation?: string | undefined;
+}
+/**
+ * Create an update_plan tool that lets agents track their task progress.
+ *
+ * The agent calls this tool to:
+ * 1. Create a plan with multiple steps
+ * 2. Mark steps as in_progress or completed
+ * 3. Add explanation for each update
+ *
+ * @example
+ * ```typescript
+ * const tool = createUpdatePlanTool();
+ * toolRegistry.register(tool);
+ *
+ * // Agent calls:
+ * // update_plan({ steps: [
+ *   // { text: "Read codebase", status: "completed" },
+ *   // { text: "Implement feature", status: "in_progress" },
+ *   // { text: "Write tests", status: "pending" },
+ * // ], explanation: "Starting implementation" })
+ * ```
+ */
+export declare function createUpdatePlanTool(): ToolDefinition;
+/**
+ * Create a get_plan tool — returns the current plan state.
+ */
+export declare function createGetPlanTool(): ToolDefinition;
+//# sourceMappingURL=update-plan.d.ts.map

package/dist/tools/update-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-plan.d.ts","sourceRoot":"","sources":["../../src/tools/update-plan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEpE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAsDrD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAUlD"}

package/dist/tools/update-plan.js

@@ -0,0 +1,93 @@
+/**
+ * Plan tracking tool — allows agents to maintain structured task plans.
+ *
+ * @module tools/update-plan
+ */
+import { z } from "zod";
+import { defineTool } from "@vinhnt-sdk/tools";
+/**
+ * Create an update_plan tool that lets agents track their task progress.
+ *
+ * The agent calls this tool to:
+ * 1. Create a plan with multiple steps
+ * 2. Mark steps as in_progress or completed
+ * 3. Add explanation for each update
+ *
+ * @example
+ * ```typescript
+ * const tool = createUpdatePlanTool();
+ * toolRegistry.register(tool);
+ *
+ * // Agent calls:
+ * // update_plan({ steps: [
+ *   // { text: "Read codebase", status: "completed" },
+ *   // { text: "Implement feature", status: "in_progress" },
+ *   // { text: "Write tests", status: "pending" },
+ * // ], explanation: "Starting implementation" })
+ * ```
+ */
+export function createUpdatePlanTool() {
+    return defineTool({
+        name: "update_plan",
+        description: "Update the task plan with steps and their status. Use this to track your progress on multi-step tasks.",
+        risk: "none",
+        input: z.object({
+            steps: z.array(z.object({
+                text: z.string().describe("Description of the step"),
+                status: z.enum(["pending", "in_progress", "completed", "failed"]).describe("Current status"),
+            })).describe("Updated list of plan steps"),
+            explanation: z.string().optional().describe("Explanation for this plan update"),
+        }),
+        execute: async (input, ctx) => {
+            const now = new Date().toISOString();
+            const inProgressCount = input.steps.filter((s) => s.status === "in_progress").length;
+            if (inProgressCount > 1) {
+                return `Error: Only one step can be in_progress at a time. Found ${inProgressCount}.`;
+            }
+            const plan = {
+                id: crypto.randomUUID(),
+                steps: input.steps.map((s, i) => ({
+                    id: `step_${i}`,
+                    text: s.text,
+                    status: s.status,
+                    createdAt: now,
+                    ...(s.status === "completed" ? { completedAt: now } : {}),
+                })),
+                createdAt: now,
+                updatedAt: now,
+                explanation: input.explanation,
+            };
+            const lines = plan.steps.map((s, i) => {
+                const icon = s.status === "completed" ? "✅"
+                    : s.status === "in_progress" ? "🔄"
+                        : s.status === "failed" ? "❌"
+                            : "⏳";
+                return `${icon} ${i + 1}. ${s.text}`;
+            });
+            const completed = plan.steps.filter((s) => s.status === "completed").length;
+            const total = plan.steps.length;
+            return [
+                `Plan (${completed}/${total} completed):`,
+                "",
+                ...lines,
+                "",
+                plan.explanation ? `Note: ${plan.explanation}` : "",
+            ].filter(Boolean).join("\n");
+        },
+    }).toDefinition();
+}
+/**
+ * Create a get_plan tool — returns the current plan state.
+ */
+export function createGetPlanTool() {
+    return defineTool({
+        name: "get_plan",
+        description: "Get the current task plan and its progress.",
+        risk: "none",
+        input: z.object({}),
+        execute: async () => {
+            return "No active plan. Use update_plan to create one.";
+        },
+    }).toDefinition();
+}
+//# sourceMappingURL=update-plan.js.map

package/dist/tools/update-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-plan.js","sourceRoot":"","sources":["../../src/tools/update-plan.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vinhnt-sdk/core",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Core agent engine for VNT Agent — kernel, tools, sessions, plugins, permissions, and knowledge",
   "license": "MIT",
   "type": "module",
@@ -47,16 +47,16 @@
   "dependencies": {
     "zod": "^4.4.3",
     "@vinhnt-sdk/event": "0.4.0",
-    "@vinhnt-sdk/llm": "0.4.0",
     "@vinhnt-sdk/sandbox": "0.4.0",
+    "@vinhnt-sdk/schema": "0.4.0",
+    "@vinhnt-sdk/llm": "0.4.0",
     "@vinhnt-sdk/permission": "0.4.0",
     "@vinhnt-sdk/guard": "0.4.0",
     "@vinhnt-sdk/guardrails": "0.4.0",
-    "@vinhnt-sdk/schema": "0.4.0",
-    "@vinhnt-sdk/session": "0.4.0",
-    "@vinhnt-sdk/workflow": "0.4.0",
     "@vinhnt-sdk/knowledge": "0.4.0",
+    "@vinhnt-sdk/workflow": "0.4.0",
     "@vinhnt-sdk/tools": "0.4.0",
+    "@vinhnt-sdk/session": "0.4.0",
     "@vinhnt-sdk/step-executor": "0.4.0"
   },
   "scripts": {