@mappies/miniwat-agent 0.4.0 → 0.8.0

package/dist/index.d.cts

@@ -1,7 +1,42 @@
-import { Instruction, Model, Message, ModelOption, ResponseMessage } from '@mappies/miniwat-agent-core';
+import { TokenUsage, Message, Instruction, Model, ModelEvent, ModelOption, ResponseMessage } from '@mappies/miniwat-agent-core';
 import { ToolDispatcher } from '@mappies/miniwat-mcp-core';
 import { Readable } from 'stream';
 
+type TaskStatus = 'pending' | 'running' | 'completed' | 'failed';
+
+declare class Task {
+    id?: number;
+    description?: string;
+    status?: TaskStatus;
+    executionLogs?: string[];
+    constructor(task: Partial<Task>);
+}
+
+declare class Plan {
+    id?: string;
+    userGoal?: string;
+    tasks?: Task[];
+    directAnswer?: {
+        content: string;
+        tokenUsage: TokenUsage;
+    };
+    createdAt?: string;
+    constructor(plan?: Partial<Plan>);
+    getInstruction(currentTask: Task): string;
+    getExecutionContext(currentTaskId: number): string;
+    getLastCompletedOutput(): string;
+    getNextPendingTask(): Task | undefined;
+    updateTaskStatus(taskId: number, status: TaskStatus): void;
+    appendLogToTask(taskId: number, log: string): void;
+    insertTask(afterStepId: number, description: string): void;
+}
+
+interface IPlanner {
+    createPlan(userGoal: string, conversationHistory?: Message[]): Promise<Plan>;
+    reflect(task: Task, executionOutput: string): Promise<boolean>;
+    replan(plan: Plan, failedTask: Task, failureOutput: string): Promise<void>;
+}
+
 declare class AgentConfig {
     /**
      * Agent instruction
@@ -15,23 +50,68 @@ declare class AgentConfig {
      * Tool dispatcher for tools.
      */
     toolDispatcher?: ToolDispatcher;
+    /**
+     * Optional planner.
+     *
+     * When omitted, the agent executes prompts directly using the configured model.
+     * When provided, the planner determines whether to return a direct answer or
+     * execute a multi-step plan.
+     */
+    planner?: IPlanner;
+    /**
+     * Maximum number of tool calls allowed per model execution.
+     */
+    maxToolCalls?: number;
     constructor(data: AgentConfig);
 }
 
 declare class Session {
-    readonly id: string;
+    id: string;
     name?: string;
-    messages: Message[];
+    messages?: Message[];
+    createdTimestamp?: string;
     constructor(data?: Partial<Session>);
 }
 
+interface AgentEvent extends ModelEvent {
+    onPlanUpdated?(plan: Plan): Promise<void>;
+}
+
+interface AgentOption extends Omit<ModelOption, "event"> {
+    event?: AgentEvent;
+}
+
 declare class Agent {
     readonly instruction?: Instruction;
     readonly model: Model;
     readonly toolDispatcher?: ToolDispatcher;
+    readonly planner?: IPlanner;
+    readonly maxToolCalls?: number;
     constructor(config: AgentConfig);
-    invoke(prompt: string, session: Session, option?: Omit<ModelOption, 'instruction'>): Promise<ResponseMessage>;
-    stream(prompt: string, session: Session, option?: Omit<ModelOption, "instruction">): Promise<Readable>;
+    invoke(prompt: string, session: Session, option?: Omit<AgentOption, 'instruction'>): Promise<ResponseMessage>;
+    stream(prompt: string, session: Session, option?: Omit<AgentOption, "instruction">): Promise<Readable>;
+    private invokeDirect;
+    private invokeWithPlanner;
+    private streamDirect;
+    private streamWithPlanner;
+    private executePlan;
+}
+
+declare class DefaultPlanner {
+    private model;
+    constructor(model: Model);
+    private callLLM;
+    createPlan(userGoal: string, conversationHistory?: Message[]): Promise<Plan>;
+    /**
+     * PURE CRITIC INTERFACE
+     * Cross-references an execution string block against the target task expectations.
+     */
+    reflect(task: Task, executionOutput: string): Promise<boolean>;
+    /**
+     * CONTEXTUAL WORKFLOW PATCHING
+     * Invokes an LLM strategy session to formulate an actionable patch, injecting it into the state array.
+     */
+    replan(plan: Plan, failedTask: Task, failureOutput: string): Promise<void>;
 }
 
-export { Agent, AgentConfig, Session };
+export { Agent, AgentConfig, DefaultPlanner, type IPlanner, Plan, Session, Task, type TaskStatus };

package/dist/index.d.ts

@@ -1,7 +1,42 @@
-import { Instruction, Model, Message, ModelOption, ResponseMessage } from '@mappies/miniwat-agent-core';
+import { TokenUsage, Message, Instruction, Model, ModelEvent, ModelOption, ResponseMessage } from '@mappies/miniwat-agent-core';
 import { ToolDispatcher } from '@mappies/miniwat-mcp-core';
 import { Readable } from 'stream';
 
+type TaskStatus = 'pending' | 'running' | 'completed' | 'failed';
+
+declare class Task {
+    id?: number;
+    description?: string;
+    status?: TaskStatus;
+    executionLogs?: string[];
+    constructor(task: Partial<Task>);
+}
+
+declare class Plan {
+    id?: string;
+    userGoal?: string;
+    tasks?: Task[];
+    directAnswer?: {
+        content: string;
+        tokenUsage: TokenUsage;
+    };
+    createdAt?: string;
+    constructor(plan?: Partial<Plan>);
+    getInstruction(currentTask: Task): string;
+    getExecutionContext(currentTaskId: number): string;
+    getLastCompletedOutput(): string;
+    getNextPendingTask(): Task | undefined;
+    updateTaskStatus(taskId: number, status: TaskStatus): void;
+    appendLogToTask(taskId: number, log: string): void;
+    insertTask(afterStepId: number, description: string): void;
+}
+
+interface IPlanner {
+    createPlan(userGoal: string, conversationHistory?: Message[]): Promise<Plan>;
+    reflect(task: Task, executionOutput: string): Promise<boolean>;
+    replan(plan: Plan, failedTask: Task, failureOutput: string): Promise<void>;
+}
+
 declare class AgentConfig {
     /**
      * Agent instruction
@@ -15,23 +50,68 @@ declare class AgentConfig {
      * Tool dispatcher for tools.
      */
     toolDispatcher?: ToolDispatcher;
+    /**
+     * Optional planner.
+     *
+     * When omitted, the agent executes prompts directly using the configured model.
+     * When provided, the planner determines whether to return a direct answer or
+     * execute a multi-step plan.
+     */
+    planner?: IPlanner;
+    /**
+     * Maximum number of tool calls allowed per model execution.
+     */
+    maxToolCalls?: number;
     constructor(data: AgentConfig);
 }
 
 declare class Session {
-    readonly id: string;
+    id: string;
     name?: string;
-    messages: Message[];
+    messages?: Message[];
+    createdTimestamp?: string;
     constructor(data?: Partial<Session>);
 }
 
+interface AgentEvent extends ModelEvent {
+    onPlanUpdated?(plan: Plan): Promise<void>;
+}
+
+interface AgentOption extends Omit<ModelOption, "event"> {
+    event?: AgentEvent;
+}
+
 declare class Agent {
     readonly instruction?: Instruction;
     readonly model: Model;
     readonly toolDispatcher?: ToolDispatcher;
+    readonly planner?: IPlanner;
+    readonly maxToolCalls?: number;
     constructor(config: AgentConfig);
-    invoke(prompt: string, session: Session, option?: Omit<ModelOption, 'instruction'>): Promise<ResponseMessage>;
-    stream(prompt: string, session: Session, option?: Omit<ModelOption, "instruction">): Promise<Readable>;
+    invoke(prompt: string, session: Session, option?: Omit<AgentOption, 'instruction'>): Promise<ResponseMessage>;
+    stream(prompt: string, session: Session, option?: Omit<AgentOption, "instruction">): Promise<Readable>;
+    private invokeDirect;
+    private invokeWithPlanner;
+    private streamDirect;
+    private streamWithPlanner;
+    private executePlan;
+}
+
+declare class DefaultPlanner {
+    private model;
+    constructor(model: Model);
+    private callLLM;
+    createPlan(userGoal: string, conversationHistory?: Message[]): Promise<Plan>;
+    /**
+     * PURE CRITIC INTERFACE
+     * Cross-references an execution string block against the target task expectations.
+     */
+    reflect(task: Task, executionOutput: string): Promise<boolean>;
+    /**
+     * CONTEXTUAL WORKFLOW PATCHING
+     * Invokes an LLM strategy session to formulate an actionable patch, injecting it into the state array.
+     */
+    replan(plan: Plan, failedTask: Task, failureOutput: string): Promise<void>;
 }
 
-export { Agent, AgentConfig, Session };
+export { Agent, AgentConfig, DefaultPlanner, type IPlanner, Plan, Session, Task, type TaskStatus };