@cuylabs/agent-core 4.8.1 → 4.10.0

package/dist/execution/workflow/planner/plan.d.ts

@@ -0,0 +1,7 @@
+import type { AgentWorkflowOperationPlan } from "./types.js";
+import type { AgentWorkflowTurnState } from "../state.js";
+/**
+ * Decide which deterministic workflow operation should run next.
+ */
+export declare function planNextAgentWorkflowOperation(state: AgentWorkflowTurnState): AgentWorkflowOperationPlan | undefined;
+//# sourceMappingURL=plan.d.ts.map

package/dist/execution/workflow/planner/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../../src/execution/workflow/planner/plan.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,sBAAsB,GAC5B,0BAA0B,GAAG,SAAS,CAmGxC"}

package/dist/execution/workflow/planner/types.d.ts

@@ -0,0 +1,49 @@
+import type { TokenUsage } from "../../../types/messages.js";
+import type { ModelContextCompactionReport } from "../../../context/assembly/types.js";
+import type { AgentTurnStepCommitSnapshot, AgentTurnStepCommitToolCall } from "../../turn/engine/index.js";
+import type { AgentWorkflowMessageSnapshot, AgentWorkflowReplayDecision, AgentWorkflowTurnState } from "../state.js";
+export interface AgentWorkflowInputCommitPlan {
+    kind: "input-commit";
+    sessionId: string;
+    messages: AgentWorkflowMessageSnapshot[];
+}
+export interface AgentWorkflowModelStepPlan {
+    kind: "model-step";
+    sessionId: string;
+    turnId: string;
+    step: number;
+    maxSteps: number;
+    systemPrompts: string[];
+    messages: AgentWorkflowMessageSnapshot[];
+    contextCompaction?: ModelContextCompactionReport;
+}
+export interface AgentWorkflowStepCommitPlan {
+    kind: "step-commit";
+    sessionId: string;
+    step: number;
+    snapshot: AgentTurnStepCommitSnapshot;
+}
+export interface AgentWorkflowToolCallPlan {
+    kind: "tool-call";
+    step: number;
+    sessionId: string;
+    toolCall: AgentTurnStepCommitToolCall;
+    turnState: AgentWorkflowTurnState["turnState"];
+    replayDecision?: AgentWorkflowReplayDecision;
+}
+export interface AgentWorkflowToolBatchPlan {
+    kind: "tool-batch";
+    step: number;
+    sessionId: string;
+    toolCalls: AgentTurnStepCommitToolCall[];
+    turnState: AgentWorkflowTurnState["turnState"];
+    replayDecisions: Record<string, AgentWorkflowReplayDecision>;
+}
+export interface AgentWorkflowOutputCommitPlan {
+    kind: "output-commit";
+    sessionId: string;
+    text: string;
+    usage?: TokenUsage;
+}
+export type AgentWorkflowOperationPlan = AgentWorkflowInputCommitPlan | AgentWorkflowModelStepPlan | AgentWorkflowToolCallPlan | AgentWorkflowToolBatchPlan | AgentWorkflowStepCommitPlan | AgentWorkflowOutputCommitPlan;
+//# sourceMappingURL=types.d.ts.map

package/dist/execution/workflow/planner/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/execution/workflow/planner/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,KAAK,EACV,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,4BAA4B,EAC5B,2BAA2B,EAC3B,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,4BAA4B,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,4BAA4B,EAAE,CAAC;IACzC,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;CAClD;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,2BAA2B,CAAC;CACvC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,2BAA2B,CAAC;IACtC,SAAS,EAAE,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC/C,cAAc,CAAC,EAAE,2BAA2B,CAAC;CAC9C;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,2BAA2B,EAAE,CAAC;IACzC,SAAS,EAAE,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC/C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,MAAM,0BAA0B,GAClC,4BAA4B,GAC5B,0BAA0B,GAC1B,yBAAyB,GACzB,0BAA0B,GAC1B,2BAA2B,GAC3B,6BAA6B,CAAC"}

package/dist/execution/workflow/snapshot.d.ts

@@ -0,0 +1,11 @@
+import type { AssistantMessage, Message, SystemMessage, ToolMessage, UserMessage } from "../../types/messages.js";
+import type { AgentWorkflowAssistantMessageSnapshot, AgentWorkflowMessageSnapshot, AgentWorkflowSystemMessageSnapshot, AgentWorkflowToolMessageSnapshot, AgentWorkflowUserMessageSnapshot } from "./state.js";
+export declare function snapshotAgentWorkflowMessage(message: UserMessage): AgentWorkflowUserMessageSnapshot;
+export declare function snapshotAgentWorkflowMessage(message: AssistantMessage): AgentWorkflowAssistantMessageSnapshot;
+export declare function snapshotAgentWorkflowMessage(message: ToolMessage): AgentWorkflowToolMessageSnapshot;
+export declare function snapshotAgentWorkflowMessage(message: SystemMessage): AgentWorkflowSystemMessageSnapshot;
+export declare function snapshotAgentWorkflowMessage(message: Message): AgentWorkflowMessageSnapshot;
+export declare function snapshotAgentWorkflowMessages(messages: Message[]): AgentWorkflowMessageSnapshot[];
+export declare function restoreAgentWorkflowMessage(snapshot: AgentWorkflowMessageSnapshot): Message;
+export declare function restoreAgentWorkflowMessages(snapshots: AgentWorkflowMessageSnapshot[]): Message[];
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/execution/workflow/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/execution/workflow/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,OAAO,EACP,aAAa,EACb,WAAW,EACX,WAAW,EACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,qCAAqC,EACrC,4BAA4B,EAC5B,kCAAkC,EAClC,gCAAgC,EAChC,gCAAgC,EACjC,MAAM,YAAY,CAAC;AAIpB,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,WAAW,GACnB,gCAAgC,CAAC;AACpC,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,gBAAgB,GACxB,qCAAqC,CAAC;AACzC,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,WAAW,GACnB,gCAAgC,CAAC;AACpC,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,aAAa,GACrB,kCAAkC,CAAC;AACtC,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,OAAO,GACf,4BAA4B,CAAC;AAiEhC,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,OAAO,EAAE,GAClB,4BAA4B,EAAE,CAEhC;AAID,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,4BAA4B,GACrC,OAAO,CA8DT;AAED,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,4BAA4B,EAAE,GACxC,OAAO,EAAE,CAEX"}

package/dist/execution/workflow/state.d.ts

@@ -0,0 +1,161 @@
+import type { TokenUsage } from "../../types/messages.js";
+import type { ToolMetadata } from "../../types/tool.js";
+import type { CompactionCutReason, CompactionEffectiveness } from "../../types/compaction.js";
+import type { AgentContextFragmentMessageMetadata } from "../../context/fragments/types.js";
+import type { ModelContextAssemblyReport, ModelContextCompactionReport } from "../../context/assembly/types.js";
+import type { ContextCompactionDecision } from "../../context/window/decision.js";
+import type { AgentTurnStepCommitSnapshot, AgentTurnStepCommitToolResult } from "../turn/engine/index.js";
+import type { AgentTurnState } from "../turn/state.js";
+export interface AgentWorkflowToolCallSnapshot {
+    toolCallId: string;
+    toolName: string;
+    args: unknown;
+}
+export interface AgentWorkflowUserMessageSnapshot {
+    id: string;
+    role: "user";
+    createdAt: string;
+    content: string;
+    contextFragment?: AgentContextFragmentMessageMetadata;
+    system?: string;
+}
+export interface AgentWorkflowAssistantMessageSnapshot {
+    id: string;
+    role: "assistant";
+    createdAt: string;
+    content: string;
+    finish?: "stop" | "length" | "tool-calls" | "content-filter" | "error" | "unknown";
+    tokens?: TokenUsage;
+    cost?: number;
+    error?: {
+        name: string;
+        message: string;
+        code?: string;
+        status?: number;
+    };
+    toolCalls?: AgentWorkflowToolCallSnapshot[];
+}
+export interface AgentWorkflowToolMessageSnapshot {
+    id: string;
+    role: "tool";
+    createdAt: string;
+    content: string;
+    toolCallId: string;
+    toolName: string;
+    result: unknown;
+    metadata?: ToolMetadata;
+    compactedAt?: number;
+}
+export interface AgentWorkflowSystemMessageSnapshot {
+    id: string;
+    role: "system";
+    createdAt: string;
+    content: string;
+    contextFragment?: AgentContextFragmentMessageMetadata;
+}
+export type AgentWorkflowMessageSnapshot = AgentWorkflowUserMessageSnapshot | AgentWorkflowAssistantMessageSnapshot | AgentWorkflowToolMessageSnapshot | AgentWorkflowSystemMessageSnapshot;
+export type AgentWorkflowTurnPhase = "input-commit" | "model-step" | "tool-batch" | "step-commit" | "output-commit" | "completed" | "failed";
+export interface AgentWorkflowReplayDecision {
+    toolCallId: string;
+    toolName: string;
+    action: "replay" | "skip";
+    source: "policy" | "runtime" | "operator";
+    decidedAt: string;
+    reason?: string;
+}
+export interface AgentWorkflowModelStepResult {
+    text: string;
+    usage?: TokenUsage;
+    finishReason?: string;
+    contextReport?: ModelContextAssemblyReport;
+    turnState: AgentTurnState;
+    stepCommit?: AgentTurnStepCommitSnapshot;
+}
+export interface AgentWorkflowCommitResult {
+    messages: AgentWorkflowMessageSnapshot[];
+}
+export interface AgentWorkflowContextCompactionResult {
+    compacted: boolean;
+    messages: AgentWorkflowMessageSnapshot[];
+    inputTokens: number;
+    limit: number;
+    decision: ContextCompactionDecision;
+    effectiveness: CompactionEffectiveness;
+    removedCount: number;
+    tokensRemoved: number;
+    summarized: boolean;
+    summary?: string;
+    cutIndex?: number;
+    cutReason?: CompactionCutReason;
+}
+export interface AgentWorkflowToolBatchResult {
+    stepCommit: AgentTurnStepCommitSnapshot;
+    turnState?: AgentTurnState;
+}
+export interface AgentWorkflowToolCallResult {
+    toolResult: AgentTurnStepCommitToolResult;
+    turnState?: AgentTurnState;
+}
+export interface AgentWorkflowInterventionSnapshot {
+    id: string;
+    message: string;
+    createdAt: string;
+}
+export interface AgentWorkflowTurnState {
+    sessionId: string;
+    turnId: string;
+    systemPrompts: string[];
+    messages: AgentWorkflowMessageSnapshot[];
+    phase: AgentWorkflowTurnPhase;
+    pendingInput?: AgentWorkflowUserMessageSnapshot;
+    step: number;
+    maxSteps: number;
+    usage?: TokenUsage;
+    turnState?: AgentTurnState;
+    lastModelStep?: AgentWorkflowModelStepResult;
+    lastContextCompaction?: ModelContextCompactionReport;
+    replayDecisions: Record<string, AgentWorkflowReplayDecision>;
+    finalResponse?: string;
+    error?: string;
+    startedAt: string;
+    updatedAt: string;
+    /**
+     * Pending steering messages injected by an external client.
+     * In direct execution, the `InterventionController` handles this.
+     * In durable execution, pending messages are drained at each
+     * model-step boundary and injected as user messages.
+     */
+    pendingInterventions?: AgentWorkflowInterventionSnapshot[];
+    /**
+     * Deferred follow-up messages queued by an external client.
+     * These are held until the current turn completes and can then be
+     * surfaced by the host as candidate next-turn messages.
+     */
+    queuedFollowUps?: AgentWorkflowInterventionSnapshot[];
+}
+export interface CreateAgentWorkflowTurnStateOptions {
+    sessionId: string;
+    turnId: string;
+    startedAt: string;
+    maxSteps: number;
+    systemPrompts?: string[];
+    initialMessages?: AgentWorkflowMessageSnapshot[];
+    initialInput?: AgentWorkflowUserMessageSnapshot;
+    initialStep?: number;
+}
+export declare function createAgentWorkflowTurnState(options: CreateAgentWorkflowTurnStateOptions): AgentWorkflowTurnState;
+export declare function cloneAgentWorkflowTurnState(state: AgentWorkflowTurnState): AgentWorkflowTurnState;
+export declare function applyWorkflowInterventions(state: AgentWorkflowTurnState, interventions: readonly AgentWorkflowInterventionSnapshot[], updatedAt: string): AgentWorkflowTurnState;
+/**
+ * Drain pending intervention messages from the workflow state,
+ * injecting each as a user message into `state.messages`.
+ *
+ * Returns the updated state with `pendingInterventions` cleared.
+ * If there are no pending interventions, returns the state unchanged.
+ *
+ * This is the durable-execution equivalent of
+ * `InterventionController.drainImmediate()` in the direct path.
+ */
+export declare function drainWorkflowInterventions(state: AgentWorkflowTurnState, updatedAt: string): AgentWorkflowTurnState;
+export declare function queueWorkflowFollowUps(state: AgentWorkflowTurnState, followUps: readonly AgentWorkflowInterventionSnapshot[], updatedAt: string): AgentWorkflowTurnState;
+//# sourceMappingURL=state.d.ts.map

package/dist/execution/workflow/state.d.ts.map

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

package/dist/human/controller.d.ts

@@ -0,0 +1,24 @@
+import type { AgentEvent } from "../types/events.js";
+import type { HumanInputConfig, HumanInputRequestListOptions, HumanInputRequestRecord, HumanInputResponse, HumanInputToolArgs } from "./types.js";
+export declare class HumanInputTimeoutError extends Error {
+    constructor(timeoutMs: number);
+}
+export declare class HumanInputUnavailableError extends Error {
+    constructor();
+}
+export interface HumanInputEventContext {
+    emitEvent?: (event: AgentEvent) => Promise<void> | void;
+}
+export interface HumanInputController {
+    readonly hasPendingRequests: boolean;
+    request(sessionId: string, input: HumanInputToolArgs & {
+        toolCallId?: string;
+    }, context?: HumanInputEventContext): Promise<HumanInputResponse>;
+    respondToRequest(requestId: string, response: HumanInputResponse, context?: HumanInputEventContext): Promise<HumanInputRequestRecord>;
+    getRequest(requestId: string): HumanInputRequestRecord | undefined;
+    listRequests(options?: HumanInputRequestListOptions): HumanInputRequestRecord[];
+    cancelAll(reason?: string): void;
+}
+export declare function isHumanInputController(value: unknown): value is HumanInputController;
+export declare function createHumanInputController(config?: HumanInputConfig): HumanInputController;
+//# sourceMappingURL=controller.d.ts.map

package/dist/human/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/human/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EACV,gBAAgB,EAEhB,4BAA4B,EAC5B,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,SAAS,EAAE,MAAM;CAI9B;AAED,qBAAa,0BAA2B,SAAQ,KAAK;;CAKpD;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kBAAkB,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EACnD,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/B,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAAC;IACnE,YAAY,CACV,OAAO,CAAC,EAAE,4BAA4B,GACrC,uBAAuB,EAAE,CAAC;IAC7B,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAkCD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,oBAAoB,CAa/B;AASD,wBAAgB,0BAA0B,CACxC,MAAM,GAAE,gBAAqB,GAC5B,oBAAoB,CAuOtB"}

package/dist/human/handler.d.ts

@@ -0,0 +1,15 @@
+import type { HumanInputConfig } from "./types.js";
+import { type HumanInputController } from "./controller.js";
+/**
+ * Backward-compatible alias for the controller-backed human input primitive.
+ *
+ * Prefer `createHumanInputController(...)` in new code.
+ */
+export type HumanInputHandler = HumanInputController;
+/**
+ * Backward-compatible alias for `createHumanInputController(...)`.
+ *
+ * Prefer `createHumanInputController(...)` in new code.
+ */
+export declare function createHumanInputHandler(config?: HumanInputConfig): HumanInputHandler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/human/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/human/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAC;AAEzB;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,GAAE,gBAAqB,GAC5B,iBAAiB,CAEnB"}

package/dist/human/index.d.ts

@@ -0,0 +1,5 @@
+export type { HumanInputConfig, HumanInputOption, HumanInputRequest, HumanInputRequestListOptions, HumanInputRequestRecord, HumanInputRequestKind, HumanInputRequestStatus, HumanInputResponse, HumanInputToolArgs, } from "./types.js";
+export { HumanInputTimeoutError, HumanInputUnavailableError, createHumanInputController, isHumanInputController, type HumanInputController, type HumanInputEventContext, } from "./controller.js";
+export { createHumanInputHandler, type HumanInputHandler } from "./handler.js";
+export { createHumanInputTool, createHumanInputToolWithController, createHumanInputToolWithHandler, type CreateHumanInputToolOptions, } from "./tool.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/human/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/human/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,4BAA4B,EAC5B,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,0BAA0B,EAC1B,sBAAsB,EACtB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,uBAAuB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EACL,oBAAoB,EACpB,kCAAkC,EAClC,+BAA+B,EAC/B,KAAK,2BAA2B,GACjC,MAAM,WAAW,CAAC"}

package/dist/human/tool.d.ts

@@ -0,0 +1,17 @@
+import { Tool } from "../tool/index.js";
+import { type HumanInputController } from "./controller.js";
+import type { HumanInputConfig } from "./types.js";
+export interface CreateHumanInputToolOptions extends HumanInputConfig {
+    controller?: HumanInputController;
+    name?: string;
+    description?: string;
+}
+export declare function createHumanInputTool(options?: CreateHumanInputToolOptions): Tool.AnyInfo;
+export declare function createHumanInputToolWithController(controller?: HumanInputController, options?: Pick<CreateHumanInputToolOptions, "name" | "description">): Tool.AnyInfo;
+/**
+ * Backward-compatible alias for `createHumanInputToolWithController(...)`.
+ *
+ * Prefer the controller name in new code.
+ */
+export declare const createHumanInputToolWithHandler: typeof createHumanInputToolWithController;
+//# sourceMappingURL=tool.d.ts.map

package/dist/human/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/human/tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,2BAA4B,SAAQ,gBAAgB;IACnE,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,2BAAgC,GACxC,IAAI,CAAC,OAAO,CAad;AAED,wBAAgB,kCAAkC,CAChD,UAAU,CAAC,EAAE,oBAAoB,EACjC,OAAO,GAAE,IAAI,CAAC,2BAA2B,EAAE,MAAM,GAAG,aAAa,CAAM,GACtE,IAAI,CAAC,OAAO,CAyGd;AAED;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,2CACR,CAAC"}

package/dist/human/types.d.ts

@@ -0,0 +1,62 @@
+export type HumanInputRequestKind = "text" | "confirm" | "choice";
+export interface HumanInputOption {
+    label: string;
+    value?: string;
+    description?: string;
+}
+export interface HumanInputRequest {
+    id: string;
+    sessionId: string;
+    kind: HumanInputRequestKind;
+    title: string;
+    question: string;
+    options?: HumanInputOption[];
+    allowMultiple?: boolean;
+    placeholder?: string;
+    confirmLabel?: string;
+    denyLabel?: string;
+    toolCallId?: string;
+    timestamp: number;
+}
+export type HumanInputRequestStatus = "pending" | "answered" | "cancelled" | "timed-out";
+export type HumanInputResponse = {
+    kind: "text";
+    text: string;
+} | {
+    kind: "confirm";
+    confirmed: boolean;
+    text: string;
+} | {
+    kind: "choice";
+    selected: string[];
+    text: string;
+};
+export interface HumanInputConfig {
+    onRequest?: (request: HumanInputRequest) => Promise<HumanInputResponse>;
+    timeout?: number;
+}
+export interface HumanInputRequestRecord {
+    id: string;
+    sessionId: string;
+    request: HumanInputRequest;
+    status: HumanInputRequestStatus;
+    createdAt: number;
+    updatedAt: number;
+    respondedAt?: number;
+    response?: HumanInputResponse;
+}
+export interface HumanInputRequestListOptions {
+    sessionId?: string;
+    status?: HumanInputRequestStatus | HumanInputRequestStatus[];
+}
+export interface HumanInputToolArgs {
+    title: string;
+    question: string;
+    kind?: HumanInputRequestKind;
+    options?: HumanInputOption[];
+    allowMultiple?: boolean;
+    placeholder?: string;
+    confirmLabel?: string;
+    denyLabel?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/human/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/human/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,uBAAuB,GAC/B,SAAS,GACT,UAAU,GACV,WAAW,GACX,WAAW,CAAC;AAEhB,MAAM,MAAM,kBAAkB,GAC1B;IACE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,uBAAuB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,uBAAuB,GAAG,uBAAuB,EAAE,CAAC;CAC9D;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}