@xopcai/xopc 0.0.123 → 0.0.125

package/dist/src/agent/coding/turn-diff-tracker.js

@@ -0,0 +1,233 @@
+//#region src/agent/coding/turn-diff-tracker.ts
+const DEFAULT_TURN_ID = "default";
+function createState(sessionKey, turnId = DEFAULT_TURN_ID) {
+	return {
+		sessionKey,
+		turnId,
+		changedFiles: [],
+		changes: [],
+		cumulativeDiff: "",
+		added: 0,
+		removed: 0,
+		dirty: false,
+		diffReviewed: false,
+		verificationAttempted: false
+	};
+}
+function readRecord(value) {
+	return value && typeof value === "object" ? value : null;
+}
+function readDetails(result) {
+	return readRecord(readRecord(result)?.details);
+}
+function readString(value) {
+	return typeof value === "string" && value.trim() ? value : void 0;
+}
+function readNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function readExitCode(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (value === null) return null;
+}
+function readStringArray(value) {
+	return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.trim().length > 0) : [];
+}
+function uniqueSorted(values) {
+	return Array.from(new Set(Array.from(values).filter(Boolean))).sort();
+}
+function extractExecCommand(args, result) {
+	const argRec = readRecord(args);
+	const fromArgs = readString(argRec?.cmd) ?? readString(argRec?.command);
+	if (fromArgs) return fromArgs;
+	return readString(readDetails(result)?.command) ?? "";
+}
+function isDiffReviewCommand(command) {
+	return /\bgit\s+(diff|status)\b/i.test(command);
+}
+function isVerificationCommand(command) {
+	return /\b(test|vitest|jest|mocha|ava|playwright|typecheck|type-check|tsc|build|lint)\b/i.test(command);
+}
+function commandMayMutateWorkspace(command) {
+	return /\b(sed\s+-i|perl\s+-pi|rm\s+|mv\s+|cp\s+|git\s+(checkout|reset|clean|apply|merge|rebase)|writeFile|write\(|open\([^)]*['"]w['"])/i.test(command);
+}
+function execSuccess(isError, result) {
+	if (isError) return false;
+	const details = readDetails(result);
+	if (!details) return false;
+	if (details.timedOut === true) return false;
+	if (details.status === "success") return true;
+	return details.exitCode === 0;
+}
+function appendSection(lines, title, body) {
+	if (body.length === 0) return;
+	lines.push(title, ...body);
+}
+var TurnDiffTracker = class {
+	states = /* @__PURE__ */ new Map();
+	beginTurn(sessionKey, turnId = `${Date.now()}`) {
+		this.states.set(sessionKey, createState(sessionKey, turnId));
+	}
+	getState(sessionKey) {
+		const state = this.states.get(sessionKey) ?? createState(sessionKey);
+		return {
+			...state,
+			changedFiles: [...state.changedFiles],
+			changes: state.changes.map((change) => ({ ...change })),
+			lastVerification: state.lastVerification ? { ...state.lastVerification } : void 0
+		};
+	}
+	reset(sessionKey) {
+		this.states.delete(sessionKey);
+	}
+	recordToolResult(input) {
+		if (input.isError) return;
+		const name = input.toolName.toLowerCase();
+		if (name === "apply_patch") {
+			this.recordApplyPatch(input.sessionKey, input.toolName, input.result);
+			return;
+		}
+		if (name === "write_file") {
+			this.recordWriteFile(input.sessionKey, input.toolName, input.args, input.result);
+			return;
+		}
+		if (name === "exec_command") this.recordExecCommand(input.sessionKey, input.toolName, input.args, input.result, input.isError);
+	}
+	recordMutation(input) {
+		const state = this.mutableState(input.sessionKey);
+		for (const change of input.changes) {
+			state.changes.push({
+				...change,
+				toolName: input.toolName
+			});
+			state.added += change.added ?? 0;
+			state.removed += change.removed ?? 0;
+			if (change.diff) state.cumulativeDiff = [state.cumulativeDiff.trimEnd(), change.diff.trimEnd()].filter(Boolean).join("\n");
+		}
+		state.changedFiles = uniqueSorted([...state.changedFiles, ...input.changes.flatMap((change) => [change.path, change.moveTo].filter(Boolean))]);
+	}
+	recordDiffReviewed(sessionKey) {
+		this.mutableState(sessionKey).diffReviewed = true;
+	}
+	recordVerification(input) {
+		const state = this.mutableState(input.sessionKey);
+		state.verificationAttempted = true;
+		state.lastVerification = {
+			toolName: input.toolName,
+			command: input.command,
+			success: input.success,
+			status: input.status,
+			exitCode: input.exitCode,
+			timedOut: input.timedOut
+		};
+	}
+	markDirty(sessionKey, reason) {
+		const state = this.mutableState(sessionKey);
+		state.dirty = true;
+		state.dirtyReason = reason;
+	}
+	buildFinalGuardContext(sessionKey) {
+		const state = this.states.get(sessionKey);
+		if (!state) return "";
+		if (!(state.changedFiles.length > 0 || state.changes.length > 0 || state.dirty)) return "";
+		const needsDiff = !state.diffReviewed;
+		const needsVerification = !state.verificationAttempted;
+		const failedVerification = state.lastVerification && !state.lastVerification.success;
+		if (!needsDiff && !needsVerification && !failedVerification) return "";
+		const lines = ["## Coding final check reminder"];
+		if (state.changedFiles.length > 0) appendSection(lines, "This turn changed workspace files:", state.changedFiles.map((file) => `- ${file}`));
+		if (state.dirty && needsDiff) lines.push(`A command may have modified the workspace${state.dirtyReason ? `: ${state.dirtyReason}` : "."}`);
+		const actions = [];
+		if (needsDiff) actions.push("- Inspect the diff/status with `git_status` before final response.");
+		if (needsVerification) actions.push("- Run the smallest meaningful verification command if feasible.");
+		if (failedVerification) {
+			const v = state.lastVerification;
+			actions.push(`- Last verification failed${v.command ? `: ${v.command}` : ""}. Do not claim success until fixed or clearly report the blocker.`);
+		}
+		actions.push("- If skipping verification, say why in the final answer.");
+		appendSection(lines, "Before final response:", actions);
+		return lines.join("\n");
+	}
+	mutableState(sessionKey) {
+		let state = this.states.get(sessionKey);
+		if (!state) {
+			state = createState(sessionKey);
+			this.states.set(sessionKey, state);
+		}
+		return state;
+	}
+	recordApplyPatch(sessionKey, toolName, result) {
+		const details = readDetails(result);
+		if (!details) return;
+		const now = Date.now();
+		const changes = (Array.isArray(details.changes) ? details.changes : []).flatMap((raw) => {
+			const rec = readRecord(raw);
+			const path = readString(rec?.path);
+			if (!path) return [];
+			return [{
+				kind: readString(rec?.kind) ?? "update",
+				path,
+				moveTo: readString(rec?.moveTo),
+				added: readNumber(rec?.added),
+				removed: readNumber(rec?.removed),
+				diff: readString(rec?.diff),
+				toolName,
+				at: now
+			}];
+		});
+		if (changes.length === 0) {
+			const files = readStringArray(details.files);
+			for (const file of files) changes.push({
+				kind: "unknown",
+				path: file,
+				toolName,
+				at: now
+			});
+		}
+		this.recordMutation({
+			sessionKey,
+			toolName,
+			changes
+		});
+		const state = this.mutableState(sessionKey);
+		state.added = readNumber(details.added) ?? state.added;
+		state.removed = readNumber(details.removed) ?? state.removed;
+		const diff = readString(details.diff);
+		if (diff && !state.cumulativeDiff.includes(diff.trim())) state.cumulativeDiff = [state.cumulativeDiff.trimEnd(), diff.trimEnd()].filter(Boolean).join("\n");
+	}
+	recordWriteFile(sessionKey, toolName, args, result) {
+		if (typeof readDetails(result)?.size !== "number") return;
+		const path = readString(readRecord(args)?.path);
+		if (!path) return;
+		this.recordMutation({
+			sessionKey,
+			toolName,
+			changes: [{
+				kind: "rewrite",
+				path,
+				toolName,
+				at: Date.now()
+			}]
+		});
+		this.markDirty(sessionKey, "`write_file` rewrote file content without a captured unified diff");
+	}
+	recordExecCommand(sessionKey, toolName, args, result, isError) {
+		const command = extractExecCommand(args, result);
+		const details = readDetails(result);
+		if (command && isDiffReviewCommand(command)) this.recordDiffReviewed(sessionKey);
+		if (command && isVerificationCommand(command)) this.recordVerification({
+			sessionKey,
+			toolName,
+			command,
+			success: execSuccess(isError, result),
+			status: readString(details?.status),
+			exitCode: readExitCode(details?.exitCode),
+			timedOut: details?.timedOut === true
+		});
+		if (command && commandMayMutateWorkspace(command)) this.markDirty(sessionKey, `exec_command may have changed files: ${command.slice(0, 120)}`);
+	}
+};
+//#endregion
+export { TurnDiffTracker };
+
+//# sourceMappingURL=turn-diff-tracker.js.map

package/dist/src/agent/coding/turn-diff-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-diff-tracker.js","names":[],"sources":["../../../../src/agent/coding/turn-diff-tracker.ts"],"sourcesContent":["export type WorkspaceMutationKind = 'add' | 'update' | 'delete' | 'move' | 'rewrite' | 'unknown';\n\nexport interface TurnFileChange {\n  kind: WorkspaceMutationKind;\n  path: string;\n  moveTo?: string;\n  added?: number;\n  removed?: number;\n  diff?: string;\n  toolName: string;\n  at: number;\n}\n\nexport interface TurnVerificationRecord {\n  toolName: string;\n  command?: string;\n  success: boolean;\n  status?: string;\n  exitCode?: number | null;\n  timedOut?: boolean;\n}\n\nexport interface TurnDiffState {\n  sessionKey: string;\n  turnId: string;\n  changedFiles: string[];\n  changes: TurnFileChange[];\n  cumulativeDiff: string;\n  added: number;\n  removed: number;\n  dirty: boolean;\n  dirtyReason?: string;\n  diffReviewed: boolean;\n  verificationAttempted: boolean;\n  lastVerification?: TurnVerificationRecord;\n}\n\nconst DEFAULT_TURN_ID = 'default';\n\nfunction createState(sessionKey: string, turnId = DEFAULT_TURN_ID): TurnDiffState {\n  return {\n    sessionKey,\n    turnId,\n    changedFiles: [],\n    changes: [],\n    cumulativeDiff: '',\n    added: 0,\n    removed: 0,\n    dirty: false,\n    diffReviewed: false,\n    verificationAttempted: false,\n  };\n}\n\nfunction readRecord(value: unknown): Record<string, unknown> | null {\n  return value && typeof value === 'object' ? (value as Record<string, unknown>) : null;\n}\n\nfunction readDetails(result: unknown): Record<string, unknown> | null {\n  const rec = readRecord(result);\n  return readRecord(rec?.details);\n}\n\nfunction readString(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() ? value : undefined;\n}\n\nfunction readNumber(value: unknown): number | undefined {\n  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;\n}\n\nfunction readExitCode(value: unknown): number | null | undefined {\n  if (typeof value === 'number' && Number.isFinite(value)) return value;\n  if (value === null) return null;\n  return undefined;\n}\n\nfunction readStringArray(value: unknown): string[] {\n  return Array.isArray(value) ? value.filter((item): item is string => typeof item === 'string' && item.trim().length > 0) : [];\n}\n\nfunction uniqueSorted(values: Iterable<string>): string[] {\n  return Array.from(new Set(Array.from(values).filter(Boolean))).sort();\n}\n\nfunction extractExecCommand(args?: unknown, result?: unknown): string {\n  const argRec = readRecord(args);\n  const fromArgs = readString(argRec?.cmd) ?? readString(argRec?.command);\n  if (fromArgs) return fromArgs;\n  const details = readDetails(result);\n  return readString(details?.command) ?? '';\n}\n\nfunction isDiffReviewCommand(command: string): boolean {\n  return /\\bgit\\s+(diff|status)\\b/i.test(command);\n}\n\nfunction isVerificationCommand(command: string): boolean {\n  return /\\b(test|vitest|jest|mocha|ava|playwright|typecheck|type-check|tsc|build|lint)\\b/i.test(command);\n}\n\nfunction commandMayMutateWorkspace(command: string): boolean {\n  return /\\b(sed\\s+-i|perl\\s+-pi|rm\\s+|mv\\s+|cp\\s+|git\\s+(checkout|reset|clean|apply|merge|rebase)|writeFile|write\\(|open\\([^)]*['\"]w['\"])/i.test(command);\n}\n\nfunction execSuccess(isError: boolean | undefined, result: unknown): boolean {\n  if (isError) return false;\n  const details = readDetails(result);\n  if (!details) return false;\n  if (details.timedOut === true) return false;\n  if (details.status === 'success') return true;\n  return details.exitCode === 0;\n}\n\nfunction appendSection(lines: string[], title: string, body: string[]): void {\n  if (body.length === 0) return;\n  lines.push(title, ...body);\n}\n\nexport class TurnDiffTracker {\n  private readonly states = new Map<string, TurnDiffState>();\n\n  beginTurn(sessionKey: string, turnId = `${Date.now()}`): void {\n    this.states.set(sessionKey, createState(sessionKey, turnId));\n  }\n\n  getState(sessionKey: string): TurnDiffState {\n    const state = this.states.get(sessionKey) ?? createState(sessionKey);\n    return {\n      ...state,\n      changedFiles: [...state.changedFiles],\n      changes: state.changes.map((change) => ({ ...change })),\n      lastVerification: state.lastVerification ? { ...state.lastVerification } : undefined,\n    };\n  }\n\n  reset(sessionKey: string): void {\n    this.states.delete(sessionKey);\n  }\n\n  recordToolResult(input: {\n    sessionKey: string;\n    toolName: string;\n    args?: unknown;\n    result?: unknown;\n    isError?: boolean;\n  }): void {\n    if (input.isError) return;\n    const name = input.toolName.toLowerCase();\n    if (name === 'apply_patch') {\n      this.recordApplyPatch(input.sessionKey, input.toolName, input.result);\n      return;\n    }\n    if (name === 'write_file') {\n      this.recordWriteFile(input.sessionKey, input.toolName, input.args, input.result);\n      return;\n    }\n    if (name === 'exec_command') {\n      this.recordExecCommand(input.sessionKey, input.toolName, input.args, input.result, input.isError);\n    }\n  }\n\n  recordMutation(input: { sessionKey: string; toolName: string; changes: TurnFileChange[] }): void {\n    const state = this.mutableState(input.sessionKey);\n    for (const change of input.changes) {\n      state.changes.push({ ...change, toolName: input.toolName });\n      state.added += change.added ?? 0;\n      state.removed += change.removed ?? 0;\n      if (change.diff) {\n        state.cumulativeDiff = [state.cumulativeDiff.trimEnd(), change.diff.trimEnd()]\n          .filter(Boolean)\n          .join('\\n');\n      }\n    }\n    state.changedFiles = uniqueSorted([\n      ...state.changedFiles,\n      ...input.changes.flatMap((change) => [change.path, change.moveTo].filter(Boolean) as string[]),\n    ]);\n  }\n\n  recordDiffReviewed(sessionKey: string): void {\n    this.mutableState(sessionKey).diffReviewed = true;\n  }\n\n  recordVerification(input: {\n    sessionKey: string;\n    toolName: string;\n    command?: string;\n    success: boolean;\n    status?: string;\n    exitCode?: number | null;\n    timedOut?: boolean;\n  }): void {\n    const state = this.mutableState(input.sessionKey);\n    state.verificationAttempted = true;\n    state.lastVerification = {\n      toolName: input.toolName,\n      command: input.command,\n      success: input.success,\n      status: input.status,\n      exitCode: input.exitCode,\n      timedOut: input.timedOut,\n    };\n  }\n\n  markDirty(sessionKey: string, reason: string): void {\n    const state = this.mutableState(sessionKey);\n    state.dirty = true;\n    state.dirtyReason = reason;\n  }\n\n  buildFinalGuardContext(sessionKey: string): string {\n    const state = this.states.get(sessionKey);\n    if (!state) return '';\n    const hasChanges = state.changedFiles.length > 0 || state.changes.length > 0 || state.dirty;\n    if (!hasChanges) return '';\n\n    const needsDiff = !state.diffReviewed;\n    const needsVerification = !state.verificationAttempted;\n    const failedVerification = state.lastVerification && !state.lastVerification.success;\n    if (!needsDiff && !needsVerification && !failedVerification) return '';\n\n    const lines: string[] = ['## Coding final check reminder'];\n    if (state.changedFiles.length > 0) {\n      appendSection(lines, 'This turn changed workspace files:', state.changedFiles.map((file) => `- ${file}`));\n    }\n    if (state.dirty && needsDiff) {\n      lines.push(`A command may have modified the workspace${state.dirtyReason ? `: ${state.dirtyReason}` : '.'}`);\n    }\n    const actions: string[] = [];\n    if (needsDiff) actions.push('- Inspect the diff/status with `git_status` before final response.');\n    if (needsVerification) actions.push('- Run the smallest meaningful verification command if feasible.');\n    if (failedVerification) {\n      const v = state.lastVerification!;\n      actions.push(`- Last verification failed${v.command ? `: ${v.command}` : ''}. Do not claim success until fixed or clearly report the blocker.`);\n    }\n    actions.push('- If skipping verification, say why in the final answer.');\n    appendSection(lines, 'Before final response:', actions);\n    return lines.join('\\n');\n  }\n\n  private mutableState(sessionKey: string): TurnDiffState {\n    let state = this.states.get(sessionKey);\n    if (!state) {\n      state = createState(sessionKey);\n      this.states.set(sessionKey, state);\n    }\n    return state;\n  }\n\n  private recordApplyPatch(sessionKey: string, toolName: string, result: unknown): void {\n    const details = readDetails(result);\n    if (!details) return;\n    const now = Date.now();\n    const rawChanges = Array.isArray(details.changes) ? details.changes : [];\n    const changes: TurnFileChange[] = rawChanges.flatMap((raw) => {\n      const rec = readRecord(raw);\n      const path = readString(rec?.path);\n      if (!path) return [];\n      return [{\n        kind: (readString(rec?.kind) as WorkspaceMutationKind | undefined) ?? 'update',\n        path,\n        moveTo: readString(rec?.moveTo),\n        added: readNumber(rec?.added),\n        removed: readNumber(rec?.removed),\n        diff: readString(rec?.diff),\n        toolName,\n        at: now,\n      }];\n    });\n    if (changes.length === 0) {\n      const files = readStringArray(details.files);\n      for (const file of files) {\n        changes.push({ kind: 'unknown', path: file, toolName, at: now });\n      }\n    }\n    this.recordMutation({ sessionKey, toolName, changes });\n    const state = this.mutableState(sessionKey);\n    state.added = readNumber(details.added) ?? state.added;\n    state.removed = readNumber(details.removed) ?? state.removed;\n    const diff = readString(details.diff);\n    if (diff && !state.cumulativeDiff.includes(diff.trim())) {\n      state.cumulativeDiff = [state.cumulativeDiff.trimEnd(), diff.trimEnd()].filter(Boolean).join('\\n');\n    }\n  }\n\n  private recordWriteFile(sessionKey: string, toolName: string, args: unknown, result: unknown): void {\n    const details = readDetails(result);\n    if (typeof details?.size !== 'number') return;\n    const path = readString(readRecord(args)?.path);\n    if (!path) return;\n    this.recordMutation({\n      sessionKey,\n      toolName,\n      changes: [{ kind: 'rewrite', path, toolName, at: Date.now() }],\n    });\n    this.markDirty(sessionKey, '`write_file` rewrote file content without a captured unified diff');\n  }\n\n  private recordExecCommand(sessionKey: string, toolName: string, args: unknown, result: unknown, isError?: boolean): void {\n    const command = extractExecCommand(args, result);\n    const details = readDetails(result);\n    if (command && isDiffReviewCommand(command)) {\n      this.recordDiffReviewed(sessionKey);\n    }\n    if (command && isVerificationCommand(command)) {\n      this.recordVerification({\n        sessionKey,\n        toolName,\n        command,\n        success: execSuccess(isError, result),\n        status: readString(details?.status),\n        exitCode: readExitCode(details?.exitCode),\n        timedOut: details?.timedOut === true,\n      });\n    }\n    if (command && commandMayMutateWorkspace(command)) {\n      this.markDirty(sessionKey, `exec_command may have changed files: ${command.slice(0, 120)}`);\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/context/workspace-templates/AGENTS.md

@@ -31,7 +31,7 @@ Do not manually reread startup files unless:
 
 - Read before writing.
 - Prefer narrow file edits over broad rewrites.
-- Use shell commands only when they are necessary and safe.
+- Use exec_command only when commands are necessary and safe.
 - Ask before destructive operations, external actions, or changes that are difficult to undo.
 - Keep local environment notes in `TOOLS.md`.
 

package/dist/src/agent/embedded/xopc-tools-bridge.js

@@ -4,17 +4,21 @@ const TOOL_PROMPT_HINTS = {
 		promptSnippet: "Read targeted file contents",
 		promptGuidelines: ["Use read_file to inspect source files before editing."]
 	},
-	edit_file: {
-		promptSnippet: "Make precise, minimal edits to existing files",
-		promptGuidelines: ["Use edit_file for small source changes instead of rewriting whole files."]
-	},
 	write_file: {
 		promptSnippet: "Create new files or intentional complete rewrites",
-		promptGuidelines: ["Use write_file only for new files or deliberate full-file rewrites."]
+		promptGuidelines: ["Prefer apply_patch for code changes. Use write_file only for non-code artifacts or deliberate full-file rewrites."]
+	},
+	apply_patch: {
+		promptSnippet: "Apply strict multi-file patches for code edits",
+		promptGuidelines: ["Use apply_patch for all source edits. Keep patches small and verify with exec_command."]
 	},
-	shell: {
+	exec_command: {
 		promptSnippet: "Run tests, type checks, builds, package scripts, and safe inspection commands",
-		promptGuidelines: ["Use shell for verification and safe inspection, not routine file editing."]
+		promptGuidelines: ["Use exec_command for verification and safe inspection, not routine file editing."]
+	},
+	update_plan: {
+		promptSnippet: "Update the visible multi-step coding plan",
+		promptGuidelines: ["Use update_plan for multi-step coding work and keep the active step current."]
 	},
 	grep: { promptSnippet: "Search file contents for literals, errors, config values, and docs" },
 	find: { promptSnippet: "Find files by glob pattern" }

package/dist/src/agent/embedded/xopc-tools-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"xopc-tools-bridge.js","names":[],"sources":["../../../../src/agent/embedded/xopc-tools-bridge.ts"],"sourcesContent":["import type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nconst TOOL_PROMPT_HINTS: Record<string, { promptSnippet?: string; promptGuidelines?: string[] }> = {\n  read_file: {\n    promptSnippet: 'Read targeted file contents',\n    promptGuidelines: ['Use read_file to inspect source files before editing.'],\n  },\n  edit_file: {\n    promptSnippet: 'Make precise, minimal edits to existing files',\n    promptGuidelines: ['Use edit_file for small source changes instead of rewriting whole files.'],\n  },\n  write_file: {\n    promptSnippet: 'Create new files or intentional complete rewrites',\n    promptGuidelines: ['Use write_file only for new files or deliberate full-file rewrites.'],\n  },\n  shell: {\n    promptSnippet: 'Run tests, type checks, builds, package scripts, and safe inspection commands',\n    promptGuidelines: ['Use shell for verification and safe inspection, not routine file editing.'],\n  },\n  grep: {\n    promptSnippet: 'Search file contents for literals, errors, config values, and docs',\n  },\n  find: {\n    promptSnippet: 'Find files by glob pattern',\n  },\n};\n\n/** Map xopc {@link AgentTool} instances to pi-coding-agent {@link ToolDefinition}s for `createAgentSession`. */\nexport function xopcToolsToDefinitions(tools: AgentTool[]): ToolDefinition[] {\n  return tools.map((tool) => {\n    const promptHints = TOOL_PROMPT_HINTS[tool.name];\n    const def = {\n      name: tool.name,\n      label: tool.label ?? tool.name,\n      description: tool.description ?? tool.name,\n      ...(promptHints?.promptSnippet ? { promptSnippet: promptHints.promptSnippet } : {}),\n      ...(promptHints?.promptGuidelines ? { promptGuidelines: promptHints.promptGuidelines } : {}),\n      parameters: tool.parameters,\n      async execute(\n        toolCallId: string,\n        params: unknown,\n        signal: AbortSignal | undefined,\n        onUpdate: unknown,\n      ) {\n        return (tool as { execute: (...a: never[]) => unknown }).execute(\n          toolCallId as never,\n          params as never,\n          signal as never,\n          onUpdate as never,\n        ) as never;\n      },\n    };\n    return def as unknown as ToolDefinition;\n  });\n}\n"],"mappings":";AAGA,MAAM,oBAA6F;CACjG,WAAW;EACT,eAAe;EACf,kBAAkB,CAAC,wDAAwD;EAC5E;CACD,WAAW;EACT,eAAe;EACf,kBAAkB,CAAC,2EAA2E;EAC/F;CACD,YAAY;EACV,eAAe;EACf,kBAAkB,CAAC,sEAAsE;EAC1F;CACD,OAAO;EACL,eAAe;EACf,kBAAkB,CAAC,4EAA4E;EAChG;CACD,MAAM,EACJ,eAAe,sEAChB;CACD,MAAM,EACJ,eAAe,8BAChB;CACF;;AAGD,SAAgB,uBAAuB,OAAsC;AAC3E,QAAO,MAAM,KAAK,SAAS;EACzB,MAAM,cAAc,kBAAkB,KAAK;AAsB3C,SAAO;GApBL,MAAM,KAAK;GACX,OAAO,KAAK,SAAS,KAAK;GAC1B,aAAa,KAAK,eAAe,KAAK;GACtC,GAAI,aAAa,gBAAgB,EAAE,eAAe,YAAY,eAAe,GAAG,EAAE;GAClF,GAAI,aAAa,mBAAmB,EAAE,kBAAkB,YAAY,kBAAkB,GAAG,EAAE;GAC3F,YAAY,KAAK;GACjB,MAAM,QACJ,YACA,QACA,QACA,UACA;AACA,WAAQ,KAAiD,QACvD,YACA,QACA,QACA,SACD;;GAGK;GACV"}
+{"version":3,"file":"xopc-tools-bridge.js","names":[],"sources":["../../../../src/agent/embedded/xopc-tools-bridge.ts"],"sourcesContent":["import type { AgentTool } from '@earendil-works/pi-agent-core';\nimport type { ToolDefinition } from '@earendil-works/pi-coding-agent';\n\nconst TOOL_PROMPT_HINTS: Record<string, { promptSnippet?: string; promptGuidelines?: string[] }> = {\n  read_file: {\n    promptSnippet: 'Read targeted file contents',\n    promptGuidelines: ['Use read_file to inspect source files before editing.'],\n  },\n  write_file: {\n    promptSnippet: 'Create new files or intentional complete rewrites',\n    promptGuidelines: ['Prefer apply_patch for code changes. Use write_file only for non-code artifacts or deliberate full-file rewrites.'],\n  },\n  apply_patch: {\n    promptSnippet: 'Apply strict multi-file patches for code edits',\n    promptGuidelines: ['Use apply_patch for all source edits. Keep patches small and verify with exec_command.'],\n  },\n  exec_command: {\n    promptSnippet: 'Run tests, type checks, builds, package scripts, and safe inspection commands',\n    promptGuidelines: ['Use exec_command for verification and safe inspection, not routine file editing.'],\n  },\n  update_plan: {\n    promptSnippet: 'Update the visible multi-step coding plan',\n    promptGuidelines: ['Use update_plan for multi-step coding work and keep the active step current.'],\n  },\n  grep: {\n    promptSnippet: 'Search file contents for literals, errors, config values, and docs',\n  },\n  find: {\n    promptSnippet: 'Find files by glob pattern',\n  },\n};\n\n/** Map xopc {@link AgentTool} instances to pi-coding-agent {@link ToolDefinition}s for `createAgentSession`. */\nexport function xopcToolsToDefinitions(tools: AgentTool[]): ToolDefinition[] {\n  return tools.map((tool) => {\n    const promptHints = TOOL_PROMPT_HINTS[tool.name];\n    const def = {\n      name: tool.name,\n      label: tool.label ?? tool.name,\n      description: tool.description ?? tool.name,\n      ...(promptHints?.promptSnippet ? { promptSnippet: promptHints.promptSnippet } : {}),\n      ...(promptHints?.promptGuidelines ? { promptGuidelines: promptHints.promptGuidelines } : {}),\n      parameters: tool.parameters,\n      async execute(\n        toolCallId: string,\n        params: unknown,\n        signal: AbortSignal | undefined,\n        onUpdate: unknown,\n      ) {\n        return (tool as { execute: (...a: never[]) => unknown }).execute(\n          toolCallId as never,\n          params as never,\n          signal as never,\n          onUpdate as never,\n        ) as never;\n      },\n    };\n    return def as unknown as ToolDefinition;\n  });\n}\n"],"mappings":";AAGA,MAAM,oBAA6F;CACjG,WAAW;EACT,eAAe;EACf,kBAAkB,CAAC,wDAAwD;EAC5E;CACD,YAAY;EACV,eAAe;EACf,kBAAkB,CAAC,oHAAoH;EACxI;CACD,aAAa;EACX,eAAe;EACf,kBAAkB,CAAC,yFAAyF;EAC7G;CACD,cAAc;EACZ,eAAe;EACf,kBAAkB,CAAC,mFAAmF;EACvG;CACD,aAAa;EACX,eAAe;EACf,kBAAkB,CAAC,+EAA+E;EACnG;CACD,MAAM,EACJ,eAAe,sEAChB;CACD,MAAM,EACJ,eAAe,8BAChB;CACF;;AAGD,SAAgB,uBAAuB,OAAsC;AAC3E,QAAO,MAAM,KAAK,SAAS;EACzB,MAAM,cAAc,kBAAkB,KAAK;AAsB3C,SAAO;GApBL,MAAM,KAAK;GACX,OAAO,KAAK,SAAS,KAAK;GAC1B,aAAa,KAAK,eAAe,KAAK;GACtC,GAAI,aAAa,gBAAgB,EAAE,eAAe,YAAY,eAAe,GAAG,EAAE;GAClF,GAAI,aAAa,mBAAmB,EAAE,kBAAkB,YAAY,kBAAkB,GAAG,EAAE;GAC3F,YAAY,KAAK;GACjB,MAAM,QACJ,YACA,QACA,QACA,UACA;AACA,WAAQ,KAAiD,QACvD,YACA,QACA,QACA,SACD;;GAGK;GACV"}

package/dist/src/agent/lifecycle/progress.js

@@ -37,13 +37,15 @@ const TOOL_STAGE_MAP = {
 	"write_file": "writing",
 	"write_multiple": "writing",
 	"edit": "writing",
+	"apply_patch": "writing",
 	"patch": "writing",
 	"create": "writing",
 	"mkdir": "writing",
 	"delete": "writing",
 	"remove": "writing",
 	"bash": "executing",
-	"shell": "executing",
+	"exec_command": "executing",
+	"update_plan": "thinking",
 	"exec": "executing",
 	"run": "executing",
 	"command": "executing",

package/dist/src/agent/lifecycle/progress.js.map

@@ -1 +1 @@
-{"version":3,"file":"progress.js","names":[],"sources":["../../../../src/agent/lifecycle/progress.ts"],"sourcesContent":["/**\n * Progress Feedback Manager\n * \n * Manages real-time progress feedback for long-running agent tasks.\n * Provides:\n * - Tool/end notifications execution start\n * - Thinking indicators\n * - Progress stage updates\n * - Stream integration for real-time display\n */\n\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('ProgressFeedback');\n\n// Progress stages for different operations\nexport type ProgressStage = \n  | 'thinking'      // AI is thinking/reasoning\n  | 'searching'     // Web search\n  | 'reading'      // Reading files\n  | 'writing'       // Writing files  \n  | 'executing'     // Running shell commands\n  | 'analyzing'     // Analyzing data\n  | 'idle';         // No active operation\n\nexport interface ProgressUpdate {\n  stage: ProgressStage;\n  detail?: string;\n  toolName?: string;\n  toolArgs?: Record<string, unknown>;\n  timestamp: number;\n}\n\nexport interface ProgressFeedbackConfig {\n  // Feedback level: minimal (errors only), normal (key events), verbose (all updates)\n  level: 'minimal' | 'normal' | 'verbose';\n  // Whether to show thinking indicators\n  showThinking: boolean;\n  // Whether to stream tool progress updates\n  streamToolProgress: boolean;\n  // Whether to send periodic heartbeats for long tasks\n  heartbeatEnabled: boolean;\n  // Heartbeat interval in ms\n  heartbeatIntervalMs: number;\n  // Threshold for long-running task in ms\n  longTaskThresholdMs: number;\n  // Enhanced feedback options\n  showErrorAccumulation: boolean;    // Show tool error accumulation (default: true)\n  showRequestLimitWarning: boolean;  // Show request limit warnings (default: true)\n}\n\nconst DEFAULT_CONFIG: ProgressFeedbackConfig = {\n  level: 'normal',\n  showThinking: true,\n  streamToolProgress: true,\n  heartbeatEnabled: true,\n  heartbeatIntervalMs: 20000, // 20 seconds\n  longTaskThresholdMs: 30000, // 30 seconds\n  showErrorAccumulation: true,\n  showRequestLimitWarning: true,\n};\n\n// Tool category mapping for better feedback\nconst TOOL_STAGE_MAP: Record<string, ProgressStage> = {\n  // Reading tools\n  'read': 'reading',\n  'read_file': 'reading',\n  'read_multiple': 'reading',\n  'glob': 'reading',\n  'find': 'reading',\n  'list_dir': 'reading',\n  'ls': 'reading',\n  'memory_get': 'reading',\n  'curated_memory': 'writing',\n\n  // Searching tools\n  'grep': 'searching',\n  'web_search': 'searching',\n  'search': 'searching',\n  'memory_search': 'searching',\n  'session_search': 'searching',\n  'find_files': 'searching',\n  \n  // Web fetching\n  'web_fetch': 'reading',\n  'fetch': 'reading',\n  'curl': 'reading',\n  'wget': 'reading',\n  \n  // Writing tools\n  'write': 'writing',\n  'write_file': 'writing',\n  'write_multiple': 'writing',\n  'edit': 'writing',\n  'patch': 'writing',\n  'create': 'writing',\n  'mkdir': 'writing',\n  'delete': 'writing',\n  'remove': 'writing',\n  \n  // Executing tools\n  'bash': 'executing',\n  'shell': 'executing',\n  'exec': 'executing',\n  'run': 'executing',\n  'command': 'executing',\n  'node': 'executing',\n  'python': 'executing',\n  'npm': 'executing',\n  'pnpm': 'executing',\n  'git': 'executing',\n  'docker': 'executing',\n  'kubectl': 'executing',\n  \n  // Message/communication\n  'message': 'idle',\n  'send': 'idle',\n  'reply': 'idle',\n  \n  // Analysis tools\n  'analyze': 'analyzing',\n  'compare': 'analyzing',\n  'diff': 'analyzing',\n  'summarize': 'analyzing',\n};\n\n// Emoji mapping for stages\nconst STAGE_EMOJI: Record<ProgressStage, string> = {\n  'thinking': '🤔',\n  'searching': '🔍',\n  'reading': '📖',\n  'writing': '✍️',\n  'executing': '⚙️',\n  'analyzing': '📊',\n  'idle': '💬',\n};\n\n// Stage labels in English\nconst STAGE_LABEL: Record<ProgressStage, string> = {\n  'thinking': 'Thinking',\n  'searching': 'Searching',\n  'reading': 'Reading',\n  'writing': 'Writing',\n  'executing': 'Executing',\n  'analyzing': 'Analyzing',\n  'idle': 'Ready',\n};\n\nexport interface ProgressMessage {\n  type: 'start' | 'update' | 'complete' | 'error' | 'warning' | 'thinking';\n  stage: ProgressStage;\n  message: string;\n  detail?: string;\n  toolName?: string;\n  toolArgs?: Record<string, unknown>;\n}\n\nexport interface ProgressCallbacks {\n  onProgress?: (msg: ProgressMessage) => void;\n  onStreamStart?: (toolName: string, toolArgs: Record<string, unknown>) => void;\n  onStreamUpdate?: (toolName: string, partialResult: string) => void;\n  onStreamEnd?: (toolName: string, result: string, isError: boolean) => void;\n  onThinking?: (thinking: string) => void;\n  onHeartbeat?: (elapsedMs: number, currentStage: ProgressStage) => void;\n}\n\nexport class ProgressFeedbackManager {\n  private config: ProgressFeedbackConfig;\n  private callbacks: ProgressCallbacks = {};\n  private currentStage: ProgressStage = 'idle';\n  private currentTool: string | null = null;\n  private taskStartTime: number = 0;\n  private heartbeatTimer?: ReturnType<typeof setInterval>;\n  private streamActive: boolean = false;\n\n  constructor(config: Partial<ProgressFeedbackConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  setCallbacks(callbacks: ProgressCallbacks): void {\n    this.callbacks = { ...this.callbacks, ...callbacks };\n  }\n\n  startTask(): void {\n    this.taskStartTime = Date.now();\n    \n    if (this.config.heartbeatEnabled) {\n      this.startHeartbeat();\n    }\n  }\n\n  endTask(): void {\n    this.stopHeartbeat();\n    this.currentStage = 'idle';\n    this.currentTool = null;\n    this.taskStartTime = 0;\n    this.streamActive = false;\n  }\n\n  private startHeartbeat(): void {\n    this.stopHeartbeat();\n    this.heartbeatTimer = setInterval(() => {\n      const elapsed = Date.now() - this.taskStartTime;\n      if (elapsed >= this.config.longTaskThresholdMs) {\n        this.callbacks.onHeartbeat?.(elapsed, this.currentStage);\n      }\n    }, this.config.heartbeatIntervalMs);\n  }\n\n  private stopHeartbeat(): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer);\n      this.heartbeatTimer = undefined;\n    }\n  }\n\n  private mapToolToStage(toolName: string): ProgressStage {\n    const normalizedName = toolName.toLowerCase();\n    const normalizedNoUnderscore = normalizedName.replace(/_/g, '');\n    \n    // Try both versions: with and without underscores\n    const toCheck = [normalizedName, normalizedNoUnderscore];\n    \n    // Sort keys by length (longest first) to match more specific keys first\n    const sortedKeys = Object.keys(TOOL_STAGE_MAP).sort((a, b) => b.length - a.length);\n    \n    for (const name of toCheck) {\n      for (const key of sortedKeys) {\n        if (name.includes(key)) {\n          return TOOL_STAGE_MAP[key];\n        }\n      }\n    }\n    return 'executing';\n  }\n\n  private formatToolName(toolName: string): string {\n    // Convert snake_case to Title Case\n    return toolName\n      .replace(/_/g, ' ')\n      .replace(/\\b\\w/g, c => c.toUpperCase());\n  }\n\n  // Handle tool execution start\n  onToolStart(toolName: string, toolArgs: Record<string, unknown> = {}): void {\n    if (this.config.level === 'minimal') return;\n\n    this.currentTool = toolName;\n    this.currentStage = this.mapToolToStage(toolName);\n    this.streamActive = true;\n\n    const formattedName = this.formatToolName(toolName);\n    const emoji = STAGE_EMOJI[this.currentStage];\n    const label = STAGE_LABEL[this.currentStage];\n\n    // Build detail message\n    let detail = '';\n    if (toolArgs.path) {\n      detail = `📁 ${toolArgs.path}`;\n    } else if (toolArgs.query) {\n      detail = `🔎 ${toolArgs.query}`;\n    } else if (toolArgs.command) {\n      const cmd = String(toolArgs.command);\n      detail = `⚡ ${cmd.length > 50 ? cmd.slice(0, 50) + '...' : cmd}`;\n    }\n\n    const message: ProgressMessage = {\n      type: 'start',\n      stage: this.currentStage,\n      message: `${emoji} ${label}: ${formattedName}`,\n      detail: detail || undefined,\n      toolName,\n      toolArgs,\n    };\n\n    if (this.config.level === 'verbose' || this.config.streamToolProgress) {\n      this.callbacks.onProgress?.(message);\n    }\n    this.callbacks.onStreamStart?.(toolName, toolArgs);\n\n    log.debug({ toolName, stage: this.currentStage }, 'Tool execution started');\n  }\n\n  // Handle tool execution update (streaming)\n  onToolUpdate(toolName: string, partialResult: unknown): void {\n    if (this.config.level === 'minimal') return;\n    if (!this.streamActive || !this.config.streamToolProgress) return;\n\n    // Format partial result for display\n    let displayResult = '';\n    if (typeof partialResult === 'string') {\n      displayResult = partialResult.slice(0, 200); // Truncate for display\n    } else if (partialResult && typeof partialResult === 'object') {\n      const result = partialResult as Record<string, unknown>;\n      if (result.output) {\n        displayResult = String(result.output).slice(0, 200);\n      } else if (result.content) {\n        displayResult = String(result.content).slice(0, 200);\n      } else if (result.text) {\n        displayResult = String(result.text).slice(0, 200);\n      }\n    }\n\n    this.callbacks.onStreamUpdate?.(toolName, displayResult);\n  }\n\n  // Handle tool execution end\n  onToolEnd(toolName: string, result: unknown, isError: boolean = false): void {\n    if (this.config.level === 'minimal' && !isError) return;\n\n    const wasActive = this.streamActive;\n    this.streamActive = false;\n\n    // Extract result summary\n    let resultSummary = '';\n    if (result && typeof result === 'object') {\n      const res = result as Record<string, unknown>;\n      if (res.content && Array.isArray(res.content)) {\n        const textContent = res.content.find((c: unknown) => \n          typeof c === 'object' && c !== null && (c as Record<string, unknown>).type === 'text'\n        );\n        if (textContent) {\n          resultSummary = String((textContent as Record<string, unknown>).text || '').slice(0, 100);\n        }\n      }\n    }\n\n    const message: ProgressMessage = {\n      type: isError ? 'error' : 'complete',\n      stage: this.currentStage,\n      message: isError \n        ? `❌ Tool failed: ${this.formatToolName(toolName)}`\n        : `✅ Done: ${this.formatToolName(toolName)}`,\n      toolName,\n    };\n\n    if (wasActive) {\n      this.callbacks.onStreamEnd?.(toolName, resultSummary, isError);\n    }\n    \n    if (isError || this.config.level !== 'minimal') {\n      this.callbacks.onProgress?.(message);\n    }\n\n    // Reset current tool if it matches\n    if (this.currentTool === toolName) {\n      this.currentTool = null;\n      this.currentStage = 'idle';\n    }\n\n    log.debug({ toolName, isError }, 'Tool execution ended');\n  }\n\n  // Handle thinking/reasoning\n  onThinking(thinking: string): void {\n    if (!this.config.showThinking || this.config.level === 'minimal') return;\n\n    const displayThinking = thinking.length > 100 \n      ? thinking.slice(0, 100) + '...'\n      : thinking;\n\n    this.callbacks.onThinking?.(displayThinking);\n  }\n\n  // Handle turn start\n  onTurnStart(): void {\n    if (this.config.level === 'minimal') return;\n    \n    this.currentStage = 'thinking';\n    this.taskStartTime = Date.now();\n    \n    if (this.config.heartbeatEnabled && !this.heartbeatTimer) {\n      this.startHeartbeat();\n    }\n  }\n\n  // Handle message/response start\n  onMessageStart(): void {\n    // Could be used to show \"AI is typing...\" indicator\n  }\n\n  // Handle message/response update (streaming tokens)\n  onMessageUpdate(_content: string): void {\n    // Could be used to show live response\n  }\n\n  // Handle agent end\n  onAgentEnd(): void {\n    this.endTask();\n  }\n\n  // Get current state\n  getCurrentState(): { stage: ProgressStage; tool: string | null; elapsedMs: number } {\n    return {\n      stage: this.currentStage,\n      tool: this.currentTool,\n      elapsedMs: this.taskStartTime ? Date.now() - this.taskStartTime : 0,\n    };\n  }\n\n  // Update config\n  setConfig(config: Partial<ProgressFeedbackConfig>): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  // Get stage emoji\n  getStageEmoji(stage: ProgressStage): string {\n    return STAGE_EMOJI[stage] || '💬';\n  }\n\n  // Get stage label\n  getStageLabel(stage: ProgressStage): string {\n    return STAGE_LABEL[stage] || 'Unknown';\n  }\n\n  /**\n   * Notify about accumulated tool errors\n   * Enhanced feedback for tool failures\n   */\n  onToolErrorAccumulated(\n    toolName: string,\n    failureCount: number,\n    maxFailures: number,\n    remainingAttempts?: number\n  ): void {\n    if (!this.config.showErrorAccumulation) return;\n    if (this.config.level === 'minimal') return;\n\n    const remaining = remainingAttempts ?? (maxFailures - failureCount);\n    const percentage = (failureCount / maxFailures) * 100;\n    \n    let message: string;\n    let type: 'warning' | 'error' = percentage >= 100 ? 'error' : 'warning';\n\n    if (percentage >= 100) {\n      message = `❌ ${this.formatToolName(toolName)} has reached maximum failures (${maxFailures}/${maxFailures})`;\n    } else if (percentage >= 50) {\n      message = `⚠️ ${this.formatToolName(toolName)} failed ${failureCount}/${maxFailures} times`;\n    } else {\n      message = `⚠️ ${this.formatToolName(toolName)} failed ${failureCount} time${failureCount > 1 ? 's' : ''}`;\n    }\n\n    const progressMsg: ProgressMessage = {\n      type,\n      stage: 'executing',\n      message,\n      detail: remaining > 0 \n        ? `Remaining attempts: ${remaining}` \n        : 'Stopping tool execution',\n      toolName,\n    };\n\n    this.callbacks.onProgress?.(progressMsg);\n\n    const atCap = maxFailures > 0 && failureCount >= maxFailures;\n    const summary = atCap\n      ? `Tool \"${toolName}\" reached max failures (${failureCount}/${maxFailures})`\n      : `Tool \"${toolName}\" failures ${failureCount}/${maxFailures} (${remaining} attempt(s) left)`;\n    if (atCap) {\n      log.error({ toolName, failureCount, maxFailures, remaining }, summary);\n    } else {\n      log.warn({ toolName, failureCount, maxFailures, remaining }, summary);\n    }\n  }\n\n  /**\n   * Notify about request limit status\n   * Enhanced feedback for approaching/ reaching request limits\n   */\n  onRequestLimitStatus(\n    count: number,\n    limit: number,\n    remaining: number,\n    isWarning: boolean,\n    shouldStop: boolean\n  ): void {\n    if (!this.config.showRequestLimitWarning) return;\n    if (this.config.level === 'minimal') return;\n    if (!isWarning && !shouldStop) return;\n\n    const percentage = (count / limit) * 100;\n    \n    let message: string;\n    let type: 'warning' | 'error' = shouldStop ? 'error' : 'warning';\n\n    if (shouldStop) {\n      message = `❌ Request limit reached (${count}/${limit})`;\n    } else if (percentage >= 90) {\n      message = `⚠️ Request limit warning (${count}/${limit})`;\n    } else {\n      message = `⚠️ Approaching request limit (${count}/${limit})`;\n    }\n\n    const progressMsg: ProgressMessage = {\n      type,\n      stage: 'thinking',\n      message,\n      detail: remaining > 0 \n        ? `Remaining requests: ${remaining}` \n        : 'Stopping execution',\n    };\n\n    this.callbacks.onProgress?.(progressMsg);\n\n    const summary = shouldStop\n      ? `LLM request limit reached (${count}/${limit}); stopping turn`\n      : `LLM request budget ${count}/${limit} (${remaining} left)`;\n    if (shouldStop) {\n      log.error({ count, limit, remaining, shouldStop }, summary);\n    } else {\n      log.warn({ count, limit, remaining, shouldStop }, summary);\n    }\n  }\n}\n\n// Singleton instance with default config\nexport const progressFeedbackManager = new ProgressFeedbackManager();\n\n// Utility function to format progress messages for Telegram\nexport function formatProgressMessage(msg: ProgressMessage, parseMode: 'Markdown' | 'HTML' = 'HTML'): string {\n  const emoji = STAGE_EMOJI[msg.stage];\n  \n  if (parseMode === 'HTML') {\n    let html = `<b>${emoji} ${msg.message}</b>`;\n    if (msg.detail) {\n      html += `\\n${msg.detail}`;\n    }\n    return html;\n  } else {\n    let md = `**${emoji} ${msg.message}**`;\n    if (msg.detail) {\n      md += `\\n${msg.detail}`;\n    }\n    return md;\n  }\n}\n\n// Utility function to format heartbeat message\nexport function formatHeartbeatMessage(elapsedMs: number, stage: ProgressStage, detail?: string): string {\n  const seconds = Math.floor(elapsedMs / 1000);\n  const emoji = STAGE_EMOJI[stage];\n  const label = STAGE_LABEL[stage];\n  \n  let message = `${emoji} Still ${label.toLowerCase()}...`;\n  if (detail) {\n    message += `\\n${detail}`;\n  }\n  message += `\\n⏱️ ${seconds}s elapsed`;\n  \n  return message;\n}\n"],"mappings":"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"}
+{"version":3,"file":"progress.js","names":[],"sources":["../../../../src/agent/lifecycle/progress.ts"],"sourcesContent":["/**\n * Progress Feedback Manager\n * \n * Manages real-time progress feedback for long-running agent tasks.\n * Provides:\n * - Tool/end notifications execution start\n * - Thinking indicators\n * - Progress stage updates\n * - Stream integration for real-time display\n */\n\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('ProgressFeedback');\n\n// Progress stages for different operations\nexport type ProgressStage = \n  | 'thinking'      // AI is thinking/reasoning\n  | 'searching'     // Web search\n  | 'reading'      // Reading files\n  | 'writing'       // Writing files  \n  | 'executing'     // Running commands\n  | 'analyzing'     // Analyzing data\n  | 'idle';         // No active operation\n\nexport interface ProgressUpdate {\n  stage: ProgressStage;\n  detail?: string;\n  toolName?: string;\n  toolArgs?: Record<string, unknown>;\n  timestamp: number;\n}\n\nexport interface ProgressFeedbackConfig {\n  // Feedback level: minimal (errors only), normal (key events), verbose (all updates)\n  level: 'minimal' | 'normal' | 'verbose';\n  // Whether to show thinking indicators\n  showThinking: boolean;\n  // Whether to stream tool progress updates\n  streamToolProgress: boolean;\n  // Whether to send periodic heartbeats for long tasks\n  heartbeatEnabled: boolean;\n  // Heartbeat interval in ms\n  heartbeatIntervalMs: number;\n  // Threshold for long-running task in ms\n  longTaskThresholdMs: number;\n  // Enhanced feedback options\n  showErrorAccumulation: boolean;    // Show tool error accumulation (default: true)\n  showRequestLimitWarning: boolean;  // Show request limit warnings (default: true)\n}\n\nconst DEFAULT_CONFIG: ProgressFeedbackConfig = {\n  level: 'normal',\n  showThinking: true,\n  streamToolProgress: true,\n  heartbeatEnabled: true,\n  heartbeatIntervalMs: 20000, // 20 seconds\n  longTaskThresholdMs: 30000, // 30 seconds\n  showErrorAccumulation: true,\n  showRequestLimitWarning: true,\n};\n\n// Tool category mapping for better feedback\nconst TOOL_STAGE_MAP: Record<string, ProgressStage> = {\n  // Reading tools\n  'read': 'reading',\n  'read_file': 'reading',\n  'read_multiple': 'reading',\n  'glob': 'reading',\n  'find': 'reading',\n  'list_dir': 'reading',\n  'ls': 'reading',\n  'memory_get': 'reading',\n  'curated_memory': 'writing',\n\n  // Searching tools\n  'grep': 'searching',\n  'web_search': 'searching',\n  'search': 'searching',\n  'memory_search': 'searching',\n  'session_search': 'searching',\n  'find_files': 'searching',\n  \n  // Web fetching\n  'web_fetch': 'reading',\n  'fetch': 'reading',\n  'curl': 'reading',\n  'wget': 'reading',\n  \n  // Writing tools\n  'write': 'writing',\n  'write_file': 'writing',\n  'write_multiple': 'writing',\n  'edit': 'writing',\n  'apply_patch': 'writing',\n  'patch': 'writing',\n  'create': 'writing',\n  'mkdir': 'writing',\n  'delete': 'writing',\n  'remove': 'writing',\n  \n  // Executing tools\n  'bash': 'executing',\n  'exec_command': 'executing',\n  'update_plan': 'thinking',\n  'exec': 'executing',\n  'run': 'executing',\n  'command': 'executing',\n  'node': 'executing',\n  'python': 'executing',\n  'npm': 'executing',\n  'pnpm': 'executing',\n  'git': 'executing',\n  'docker': 'executing',\n  'kubectl': 'executing',\n  \n  // Message/communication\n  'message': 'idle',\n  'send': 'idle',\n  'reply': 'idle',\n  \n  // Analysis tools\n  'analyze': 'analyzing',\n  'compare': 'analyzing',\n  'diff': 'analyzing',\n  'summarize': 'analyzing',\n};\n\n// Emoji mapping for stages\nconst STAGE_EMOJI: Record<ProgressStage, string> = {\n  'thinking': '🤔',\n  'searching': '🔍',\n  'reading': '📖',\n  'writing': '✍️',\n  'executing': '⚙️',\n  'analyzing': '📊',\n  'idle': '💬',\n};\n\n// Stage labels in English\nconst STAGE_LABEL: Record<ProgressStage, string> = {\n  'thinking': 'Thinking',\n  'searching': 'Searching',\n  'reading': 'Reading',\n  'writing': 'Writing',\n  'executing': 'Executing',\n  'analyzing': 'Analyzing',\n  'idle': 'Ready',\n};\n\nexport interface ProgressMessage {\n  type: 'start' | 'update' | 'complete' | 'error' | 'warning' | 'thinking';\n  stage: ProgressStage;\n  message: string;\n  detail?: string;\n  toolName?: string;\n  toolArgs?: Record<string, unknown>;\n}\n\nexport interface ProgressCallbacks {\n  onProgress?: (msg: ProgressMessage) => void;\n  onStreamStart?: (toolName: string, toolArgs: Record<string, unknown>) => void;\n  onStreamUpdate?: (toolName: string, partialResult: string) => void;\n  onStreamEnd?: (toolName: string, result: string, isError: boolean) => void;\n  onThinking?: (thinking: string) => void;\n  onHeartbeat?: (elapsedMs: number, currentStage: ProgressStage) => void;\n}\n\nexport class ProgressFeedbackManager {\n  private config: ProgressFeedbackConfig;\n  private callbacks: ProgressCallbacks = {};\n  private currentStage: ProgressStage = 'idle';\n  private currentTool: string | null = null;\n  private taskStartTime: number = 0;\n  private heartbeatTimer?: ReturnType<typeof setInterval>;\n  private streamActive: boolean = false;\n\n  constructor(config: Partial<ProgressFeedbackConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n  }\n\n  setCallbacks(callbacks: ProgressCallbacks): void {\n    this.callbacks = { ...this.callbacks, ...callbacks };\n  }\n\n  startTask(): void {\n    this.taskStartTime = Date.now();\n    \n    if (this.config.heartbeatEnabled) {\n      this.startHeartbeat();\n    }\n  }\n\n  endTask(): void {\n    this.stopHeartbeat();\n    this.currentStage = 'idle';\n    this.currentTool = null;\n    this.taskStartTime = 0;\n    this.streamActive = false;\n  }\n\n  private startHeartbeat(): void {\n    this.stopHeartbeat();\n    this.heartbeatTimer = setInterval(() => {\n      const elapsed = Date.now() - this.taskStartTime;\n      if (elapsed >= this.config.longTaskThresholdMs) {\n        this.callbacks.onHeartbeat?.(elapsed, this.currentStage);\n      }\n    }, this.config.heartbeatIntervalMs);\n  }\n\n  private stopHeartbeat(): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer);\n      this.heartbeatTimer = undefined;\n    }\n  }\n\n  private mapToolToStage(toolName: string): ProgressStage {\n    const normalizedName = toolName.toLowerCase();\n    const normalizedNoUnderscore = normalizedName.replace(/_/g, '');\n    \n    // Try both versions: with and without underscores\n    const toCheck = [normalizedName, normalizedNoUnderscore];\n    \n    // Sort keys by length (longest first) to match more specific keys first\n    const sortedKeys = Object.keys(TOOL_STAGE_MAP).sort((a, b) => b.length - a.length);\n    \n    for (const name of toCheck) {\n      for (const key of sortedKeys) {\n        if (name.includes(key)) {\n          return TOOL_STAGE_MAP[key];\n        }\n      }\n    }\n    return 'executing';\n  }\n\n  private formatToolName(toolName: string): string {\n    // Convert snake_case to Title Case\n    return toolName\n      .replace(/_/g, ' ')\n      .replace(/\\b\\w/g, c => c.toUpperCase());\n  }\n\n  // Handle tool execution start\n  onToolStart(toolName: string, toolArgs: Record<string, unknown> = {}): void {\n    if (this.config.level === 'minimal') return;\n\n    this.currentTool = toolName;\n    this.currentStage = this.mapToolToStage(toolName);\n    this.streamActive = true;\n\n    const formattedName = this.formatToolName(toolName);\n    const emoji = STAGE_EMOJI[this.currentStage];\n    const label = STAGE_LABEL[this.currentStage];\n\n    // Build detail message\n    let detail = '';\n    if (toolArgs.path) {\n      detail = `📁 ${toolArgs.path}`;\n    } else if (toolArgs.query) {\n      detail = `🔎 ${toolArgs.query}`;\n    } else if (toolArgs.command) {\n      const cmd = String(toolArgs.command);\n      detail = `⚡ ${cmd.length > 50 ? cmd.slice(0, 50) + '...' : cmd}`;\n    }\n\n    const message: ProgressMessage = {\n      type: 'start',\n      stage: this.currentStage,\n      message: `${emoji} ${label}: ${formattedName}`,\n      detail: detail || undefined,\n      toolName,\n      toolArgs,\n    };\n\n    if (this.config.level === 'verbose' || this.config.streamToolProgress) {\n      this.callbacks.onProgress?.(message);\n    }\n    this.callbacks.onStreamStart?.(toolName, toolArgs);\n\n    log.debug({ toolName, stage: this.currentStage }, 'Tool execution started');\n  }\n\n  // Handle tool execution update (streaming)\n  onToolUpdate(toolName: string, partialResult: unknown): void {\n    if (this.config.level === 'minimal') return;\n    if (!this.streamActive || !this.config.streamToolProgress) return;\n\n    // Format partial result for display\n    let displayResult = '';\n    if (typeof partialResult === 'string') {\n      displayResult = partialResult.slice(0, 200); // Truncate for display\n    } else if (partialResult && typeof partialResult === 'object') {\n      const result = partialResult as Record<string, unknown>;\n      if (result.output) {\n        displayResult = String(result.output).slice(0, 200);\n      } else if (result.content) {\n        displayResult = String(result.content).slice(0, 200);\n      } else if (result.text) {\n        displayResult = String(result.text).slice(0, 200);\n      }\n    }\n\n    this.callbacks.onStreamUpdate?.(toolName, displayResult);\n  }\n\n  // Handle tool execution end\n  onToolEnd(toolName: string, result: unknown, isError: boolean = false): void {\n    if (this.config.level === 'minimal' && !isError) return;\n\n    const wasActive = this.streamActive;\n    this.streamActive = false;\n\n    // Extract result summary\n    let resultSummary = '';\n    if (result && typeof result === 'object') {\n      const res = result as Record<string, unknown>;\n      if (res.content && Array.isArray(res.content)) {\n        const textContent = res.content.find((c: unknown) => \n          typeof c === 'object' && c !== null && (c as Record<string, unknown>).type === 'text'\n        );\n        if (textContent) {\n          resultSummary = String((textContent as Record<string, unknown>).text || '').slice(0, 100);\n        }\n      }\n    }\n\n    const message: ProgressMessage = {\n      type: isError ? 'error' : 'complete',\n      stage: this.currentStage,\n      message: isError \n        ? `❌ Tool failed: ${this.formatToolName(toolName)}`\n        : `✅ Done: ${this.formatToolName(toolName)}`,\n      toolName,\n    };\n\n    if (wasActive) {\n      this.callbacks.onStreamEnd?.(toolName, resultSummary, isError);\n    }\n    \n    if (isError || this.config.level !== 'minimal') {\n      this.callbacks.onProgress?.(message);\n    }\n\n    // Reset current tool if it matches\n    if (this.currentTool === toolName) {\n      this.currentTool = null;\n      this.currentStage = 'idle';\n    }\n\n    log.debug({ toolName, isError }, 'Tool execution ended');\n  }\n\n  // Handle thinking/reasoning\n  onThinking(thinking: string): void {\n    if (!this.config.showThinking || this.config.level === 'minimal') return;\n\n    const displayThinking = thinking.length > 100 \n      ? thinking.slice(0, 100) + '...'\n      : thinking;\n\n    this.callbacks.onThinking?.(displayThinking);\n  }\n\n  // Handle turn start\n  onTurnStart(): void {\n    if (this.config.level === 'minimal') return;\n    \n    this.currentStage = 'thinking';\n    this.taskStartTime = Date.now();\n    \n    if (this.config.heartbeatEnabled && !this.heartbeatTimer) {\n      this.startHeartbeat();\n    }\n  }\n\n  // Handle message/response start\n  onMessageStart(): void {\n    // Could be used to show \"AI is typing...\" indicator\n  }\n\n  // Handle message/response update (streaming tokens)\n  onMessageUpdate(_content: string): void {\n    // Could be used to show live response\n  }\n\n  // Handle agent end\n  onAgentEnd(): void {\n    this.endTask();\n  }\n\n  // Get current state\n  getCurrentState(): { stage: ProgressStage; tool: string | null; elapsedMs: number } {\n    return {\n      stage: this.currentStage,\n      tool: this.currentTool,\n      elapsedMs: this.taskStartTime ? Date.now() - this.taskStartTime : 0,\n    };\n  }\n\n  // Update config\n  setConfig(config: Partial<ProgressFeedbackConfig>): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  // Get stage emoji\n  getStageEmoji(stage: ProgressStage): string {\n    return STAGE_EMOJI[stage] || '💬';\n  }\n\n  // Get stage label\n  getStageLabel(stage: ProgressStage): string {\n    return STAGE_LABEL[stage] || 'Unknown';\n  }\n\n  /**\n   * Notify about accumulated tool errors\n   * Enhanced feedback for tool failures\n   */\n  onToolErrorAccumulated(\n    toolName: string,\n    failureCount: number,\n    maxFailures: number,\n    remainingAttempts?: number\n  ): void {\n    if (!this.config.showErrorAccumulation) return;\n    if (this.config.level === 'minimal') return;\n\n    const remaining = remainingAttempts ?? (maxFailures - failureCount);\n    const percentage = (failureCount / maxFailures) * 100;\n    \n    let message: string;\n    let type: 'warning' | 'error' = percentage >= 100 ? 'error' : 'warning';\n\n    if (percentage >= 100) {\n      message = `❌ ${this.formatToolName(toolName)} has reached maximum failures (${maxFailures}/${maxFailures})`;\n    } else if (percentage >= 50) {\n      message = `⚠️ ${this.formatToolName(toolName)} failed ${failureCount}/${maxFailures} times`;\n    } else {\n      message = `⚠️ ${this.formatToolName(toolName)} failed ${failureCount} time${failureCount > 1 ? 's' : ''}`;\n    }\n\n    const progressMsg: ProgressMessage = {\n      type,\n      stage: 'executing',\n      message,\n      detail: remaining > 0 \n        ? `Remaining attempts: ${remaining}` \n        : 'Stopping tool execution',\n      toolName,\n    };\n\n    this.callbacks.onProgress?.(progressMsg);\n\n    const atCap = maxFailures > 0 && failureCount >= maxFailures;\n    const summary = atCap\n      ? `Tool \"${toolName}\" reached max failures (${failureCount}/${maxFailures})`\n      : `Tool \"${toolName}\" failures ${failureCount}/${maxFailures} (${remaining} attempt(s) left)`;\n    if (atCap) {\n      log.error({ toolName, failureCount, maxFailures, remaining }, summary);\n    } else {\n      log.warn({ toolName, failureCount, maxFailures, remaining }, summary);\n    }\n  }\n\n  /**\n   * Notify about request limit status\n   * Enhanced feedback for approaching/ reaching request limits\n   */\n  onRequestLimitStatus(\n    count: number,\n    limit: number,\n    remaining: number,\n    isWarning: boolean,\n    shouldStop: boolean\n  ): void {\n    if (!this.config.showRequestLimitWarning) return;\n    if (this.config.level === 'minimal') return;\n    if (!isWarning && !shouldStop) return;\n\n    const percentage = (count / limit) * 100;\n    \n    let message: string;\n    let type: 'warning' | 'error' = shouldStop ? 'error' : 'warning';\n\n    if (shouldStop) {\n      message = `❌ Request limit reached (${count}/${limit})`;\n    } else if (percentage >= 90) {\n      message = `⚠️ Request limit warning (${count}/${limit})`;\n    } else {\n      message = `⚠️ Approaching request limit (${count}/${limit})`;\n    }\n\n    const progressMsg: ProgressMessage = {\n      type,\n      stage: 'thinking',\n      message,\n      detail: remaining > 0 \n        ? `Remaining requests: ${remaining}` \n        : 'Stopping execution',\n    };\n\n    this.callbacks.onProgress?.(progressMsg);\n\n    const summary = shouldStop\n      ? `LLM request limit reached (${count}/${limit}); stopping turn`\n      : `LLM request budget ${count}/${limit} (${remaining} left)`;\n    if (shouldStop) {\n      log.error({ count, limit, remaining, shouldStop }, summary);\n    } else {\n      log.warn({ count, limit, remaining, shouldStop }, summary);\n    }\n  }\n}\n\n// Singleton instance with default config\nexport const progressFeedbackManager = new ProgressFeedbackManager();\n\n// Utility function to format progress messages for Telegram\nexport function formatProgressMessage(msg: ProgressMessage, parseMode: 'Markdown' | 'HTML' = 'HTML'): string {\n  const emoji = STAGE_EMOJI[msg.stage];\n  \n  if (parseMode === 'HTML') {\n    let html = `<b>${emoji} ${msg.message}</b>`;\n    if (msg.detail) {\n      html += `\\n${msg.detail}`;\n    }\n    return html;\n  } else {\n    let md = `**${emoji} ${msg.message}**`;\n    if (msg.detail) {\n      md += `\\n${msg.detail}`;\n    }\n    return md;\n  }\n}\n\n// Utility function to format heartbeat message\nexport function formatHeartbeatMessage(elapsedMs: number, stage: ProgressStage, detail?: string): string {\n  const seconds = Math.floor(elapsedMs / 1000);\n  const emoji = STAGE_EMOJI[stage];\n  const label = STAGE_LABEL[stage];\n  \n  let message = `${emoji} Still ${label.toLowerCase()}...`;\n  if (detail) {\n    message += `\\n${detail}`;\n  }\n  message += `\\n⏱️ ${seconds}s elapsed`;\n  \n  return message;\n}\n"],"mappings":"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"}

package/dist/src/agent/lifecycle/timeout-wrapper.d.ts

@@ -33,8 +33,8 @@ export interface ToolTimeoutConfig {
  * @example
  * ```typescript
  * const result = await executeWithTimeout(
- *   () => shell.exec('long-running-command'),
- *   { toolName: 'shell', timeoutMs: 60000 }
+ *   () => execCommand('long-running-command'),
+ *   { toolName: 'exec_command', timeoutMs: 60000 }
  * );
  * ```
  */

package/dist/src/agent/lifecycle/timeout-wrapper.js

@@ -16,7 +16,7 @@ const DEFAULT_CONFIG = {
 */
 function getTimeoutForTool(toolName, config) {
 	const toolLower = toolName.toLowerCase();
-	if (toolLower.includes("shell") || toolLower.includes("exec")) return config.shellTimeoutMs;
+	if (toolLower.includes("exec") || toolLower.includes("command")) return config.shellTimeoutMs;
 	if (toolLower.includes("read") || toolLower.includes("view")) return config.readTimeoutMs;
 	if (toolLower.includes("write") || toolLower.includes("edit")) return config.writeTimeoutMs;
 	if (toolLower.includes("web") || toolLower.includes("http") || toolLower.includes("fetch")) return config.networkTimeoutMs;
@@ -28,8 +28,8 @@ function getTimeoutForTool(toolName, config) {
 * @example
 * ```typescript
 * const result = await executeWithTimeout(
-*   () => shell.exec('long-running-command'),
-*   { toolName: 'shell', timeoutMs: 60000 }
+*   () => execCommand('long-running-command'),
+*   { toolName: 'exec_command', timeoutMs: 60000 }
 * );
 * ```
 */
@@ -123,7 +123,7 @@ var TimeoutError = class TimeoutError extends Error {
 	*/
 	getUserMessage() {
 		const suggestions = [];
-		if (this.toolName.toLowerCase().includes("shell")) {
+		if (this.toolName.toLowerCase().includes("exec") || this.toolName.toLowerCase().includes("command")) {
 			suggestions.push("Break the command into smaller steps");
 			suggestions.push("Add timeouts to individual commands");
 			suggestions.push("Check for infinite loops or waiting for input");

package/dist/src/agent/lifecycle/timeout-wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeout-wrapper.js","names":[],"sources":["../../../../src/agent/lifecycle/timeout-wrapper.ts"],"sourcesContent":["/**\n * Timeout Wrapper - Protects tool execution from hanging\n *\n * Wraps tool execution with timeout protection to prevent:\n * - Infinite loops in shell commands\n * - Network requests hanging forever\n * - Resource exhaustion\n */\n\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('TimeoutWrapper');\n\nexport interface TimeoutConfig {\n  defaultTimeoutMs: number;      // Default timeout in ms (default: 300000 = 5 min)\n  shellTimeoutMs: number;        // Shell command timeout (default: 300000 = 5 min)\n  readTimeoutMs: number;         // File read timeout (default: 30000 = 30 sec)\n  writeTimeoutMs: number;        // File write timeout (default: 60000 = 1 min)\n  networkTimeoutMs: number;      // Network request timeout (default: 60000 = 1 min)\n  gracefulShutdownMs: number;    // Time to wait for graceful shutdown (default: 5000)\n}\n\nconst DEFAULT_CONFIG: TimeoutConfig = {\n  defaultTimeoutMs: 5 * 60 * 1000,      // 5 minutes\n  shellTimeoutMs: 5 * 60 * 1000,        // 5 minutes\n  readTimeoutMs: 30 * 1000,             // 30 seconds\n  writeTimeoutMs: 60 * 1000,            // 1 minute\n  networkTimeoutMs: 60 * 1000,          // 1 minute\n  gracefulShutdownMs: 5000,             // 5 seconds\n};\n\nexport interface TimeoutResult<T> {\n  success: boolean;\n  result?: T;\n  error?: Error;\n  timedOut: boolean;\n  executionTimeMs: number;\n}\n\nexport interface ToolTimeoutConfig {\n  toolName: string;\n  timeoutMs?: number;\n  description?: string;\n}\n\n/**\n * Get timeout for specific tool type\n */\nfunction getTimeoutForTool(toolName: string, config: TimeoutConfig): number {\n  const toolLower = toolName.toLowerCase();\n\n  if (toolLower.includes('shell') || toolLower.includes('exec')) {\n    return config.shellTimeoutMs;\n  }\n  if (toolLower.includes('read') || toolLower.includes('view')) {\n    return config.readTimeoutMs;\n  }\n  if (toolLower.includes('write') || toolLower.includes('edit')) {\n    return config.writeTimeoutMs;\n  }\n  if (toolLower.includes('web') || toolLower.includes('http') || toolLower.includes('fetch')) {\n    return config.networkTimeoutMs;\n  }\n\n  return config.defaultTimeoutMs;\n}\n\n/**\n * Execute function with timeout protection\n *\n * @example\n * ```typescript\n * const result = await executeWithTimeout(\n *   () => shell.exec('long-running-command'),\n *   { toolName: 'shell', timeoutMs: 60000 }\n * );\n * ```\n */\nexport async function executeWithTimeout<T>(\n  operation: () => Promise<T>,\n  config: ToolTimeoutConfig\n): Promise<T> {\n  const fullConfig = { ...DEFAULT_CONFIG };\n  const timeoutMs = config.timeoutMs || getTimeoutForTool(config.toolName, fullConfig);\n\n  const startTime = Date.now();\n  let timeoutId: NodeJS.Timeout | null = null;\n  let isSettled = false;\n\n  return new Promise((resolve, reject) => {\n    // Set up timeout\n    timeoutId = setTimeout(() => {\n      if (isSettled) return;\n      isSettled = true;\n      \n      const executionTime = Date.now() - startTime;\n      const desc = config.description ? ` (${config.description})` : '';\n      log.error(\n        {\n          toolName: config.toolName,\n          timeoutMs,\n          executionTimeMs: executionTime,\n          description: config.description,\n        },\n        `Tool \"${config.toolName}\" timed out after ${timeoutMs}ms (elapsed ${executionTime}ms)${desc}`,\n      );\n\n      reject(\n        new TimeoutError(\n          config.toolName,\n          timeoutMs,\n          config.description,\n          executionTime\n        )\n      );\n    }, timeoutMs);\n\n    // Execute operation\n    operation()\n      .then(result => {\n        if (isSettled) return;\n        isSettled = true;\n        \n        if (timeoutId) {\n          clearTimeout(timeoutId);\n          timeoutId = null;\n        }\n        const executionTime = Date.now() - startTime;\n\n        log.debug(\n          {\n            toolName: config.toolName,\n            executionTimeMs: executionTime,\n          },\n          'Tool execution completed within timeout'\n        );\n\n        resolve(result);\n      })\n      .catch(error => {\n        if (isSettled) return;\n        isSettled = true;\n        \n        if (timeoutId) {\n          clearTimeout(timeoutId);\n          timeoutId = null;\n        }\n        reject(error);\n      });\n  });\n}\n\n/**\n * Execute with timeout and return detailed result\n */\nexport async function executeWithTimeoutResult<T>(\n  operation: () => Promise<T>,\n  config: ToolTimeoutConfig\n): Promise<TimeoutResult<T>> {\n  const startTime = Date.now();\n\n  try {\n    const result = await executeWithTimeout(operation, config);\n    return {\n      success: true,\n      result,\n      timedOut: false,\n      executionTimeMs: Date.now() - startTime,\n    };\n  } catch (error) {\n    const isTimeout = error instanceof TimeoutError;\n    return {\n      success: false,\n      error: error instanceof Error ? error : new Error(String(error)),\n      timedOut: isTimeout,\n      executionTimeMs: Date.now() - startTime,\n    };\n  }\n}\n\n/**\n * Custom timeout error\n */\nexport class TimeoutError extends Error {\n  public readonly toolName: string;\n  public readonly timeoutMs: number;\n  public readonly executionTimeMs: number;\n  public readonly description?: string;\n\n  constructor(\n    toolName: string,\n    timeoutMs: number,\n    description?: string,\n    executionTimeMs: number = timeoutMs\n  ) {\n    const timeoutSec = Math.round(timeoutMs / 1000);\n    const message = description\n      ? `Tool '${toolName}' timed out after ${timeoutSec}s: ${description}`\n      : `Tool '${toolName}' timed out after ${timeoutSec}s. Consider breaking the operation into smaller steps.`;\n\n    super(message);\n    this.name = 'TimeoutError';\n    this.toolName = toolName;\n    this.timeoutMs = timeoutMs;\n    this.description = description;\n    this.executionTimeMs = executionTimeMs;\n\n    // Maintain proper stack trace\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, TimeoutError);\n    }\n  }\n\n  /**\n   * Get user-friendly error message with suggestions\n   */\n  getUserMessage(): string {\n    const suggestions: string[] = [];\n\n    if (this.toolName.toLowerCase().includes('shell')) {\n      suggestions.push('Break the command into smaller steps');\n      suggestions.push('Add timeouts to individual commands');\n      suggestions.push('Check for infinite loops or waiting for input');\n    } else if (this.toolName.toLowerCase().includes('read')) {\n      suggestions.push('Read the file in smaller chunks');\n      suggestions.push('Use grep to find specific content first');\n    } else if (this.toolName.toLowerCase().includes('write')) {\n      suggestions.push('Write content in smaller batches');\n    } else if (this.toolName.toLowerCase().includes('web')) {\n      suggestions.push('Check network connectivity');\n      suggestions.push('Try again later');\n    }\n\n    let message = `⚠️ ${this.message}`;\n    if (suggestions.length > 0) {\n      message += '\\n\\nSuggestions:\\n' + suggestions.map(s => `• ${s}`).join('\\n');\n    }\n\n    return message;\n  }\n}\n\n/**\n * Wrap a function with timeout protection\n */\nexport function withTimeout<T extends (...args: any[]) => Promise<any>>(\n  fn: T,\n  config: Omit<ToolTimeoutConfig, 'description'> & { description?: string | ((...args: Parameters<T>) => string) }\n): (...args: Parameters<T>) => Promise<ReturnType<T>> {\n  return async (...args: Parameters<T>): Promise<ReturnType<T>> => {\n    const description = typeof config.description === 'function'\n      ? config.description(...args)\n      : config.description;\n\n    return executeWithTimeout(() => fn(...args), {\n      toolName: config.toolName,\n      timeoutMs: config.timeoutMs,\n      description,\n    });\n  };\n}\n\n/**\n * Timeout manager for tracking execution statistics\n */\nexport class TimeoutManager {\n  private executions: Array<{\n    toolName: string;\n    executionTimeMs: number;\n    timedOut: boolean;\n    timestamp: number;\n  }> = [];\n\n  constructor(_config: Partial<TimeoutConfig> = {}) {}\n\n  /**\n   * Execute with timeout and track statistics\n   */\n  async execute<T>(\n    operation: () => Promise<T>,\n    toolConfig: ToolTimeoutConfig\n  ): Promise<T> {\n    const startTime = Date.now();\n    let timedOut = false;\n\n    try {\n      const result = await executeWithTimeout(operation, toolConfig);\n      this.executions.push({\n        toolName: toolConfig.toolName,\n        executionTimeMs: Date.now() - startTime,\n        timedOut: false,\n        timestamp: Date.now(),\n      });\n      return result;\n    } catch (error) {\n      if (error instanceof TimeoutError) {\n        timedOut = true;\n      }\n      this.executions.push({\n        toolName: toolConfig.toolName,\n        executionTimeMs: Date.now() - startTime,\n        timedOut,\n        timestamp: Date.now(),\n      });\n      throw error;\n    }\n  }\n\n  /**\n   * Get execution statistics\n   */\n  getStats(): {\n    totalExecutions: number;\n    timeoutCount: number;\n    timeoutRate: number;\n    averageExecutionTimeMs: number;\n    byTool: Record<string, {\n      count: number;\n      timeouts: number;\n      avgExecutionTimeMs: number;\n    }>;\n  } {\n    const byTool: Record<string, { count: number; timeouts: number; totalTime: number }> = {};\n\n    for (const exec of this.executions) {\n      if (!byTool[exec.toolName]) {\n        byTool[exec.toolName] = { count: 0, timeouts: 0, totalTime: 0 };\n      }\n      byTool[exec.toolName].count++;\n      if (exec.timedOut) {\n        byTool[exec.toolName].timeouts++;\n      }\n      byTool[exec.toolName].totalTime += exec.executionTimeMs;\n    }\n\n    const totalExecutions = this.executions.length;\n    const timeoutCount = this.executions.filter(e => e.timedOut).length;\n    const totalTime = this.executions.reduce((sum, e) => sum + e.executionTimeMs, 0);\n\n    return {\n      totalExecutions,\n      timeoutCount,\n      timeoutRate: totalExecutions > 0 ? timeoutCount / totalExecutions : 0,\n      averageExecutionTimeMs: totalExecutions > 0 ? totalTime / totalExecutions : 0,\n      byTool: Object.fromEntries(\n        Object.entries(byTool).map(([name, stats]) => [\n          name,\n          {\n            count: stats.count,\n            timeouts: stats.timeouts,\n            avgExecutionTimeMs: stats.count > 0 ? stats.totalTime / stats.count : 0,\n          },\n        ])\n      ),\n    };\n  }\n\n  /**\n   * Clean up old execution records\n   */\n  cleanup(maxAgeMs: number = 24 * 60 * 60 * 1000): void {\n    const cutoff = Date.now() - maxAgeMs;\n    this.executions = this.executions.filter(e => e.timestamp > cutoff);\n  }\n}\n\n// Convenience exports\nexport { DEFAULT_CONFIG as DEFAULT_TIMEOUT_CONFIG };\n"],"mappings":"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"}
+{"version":3,"file":"timeout-wrapper.js","names":[],"sources":["../../../../src/agent/lifecycle/timeout-wrapper.ts"],"sourcesContent":["/**\n * Timeout Wrapper - Protects tool execution from hanging\n *\n * Wraps tool execution with timeout protection to prevent:\n * - Infinite loops in shell commands\n * - Network requests hanging forever\n * - Resource exhaustion\n */\n\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('TimeoutWrapper');\n\nexport interface TimeoutConfig {\n  defaultTimeoutMs: number;      // Default timeout in ms (default: 300000 = 5 min)\n  shellTimeoutMs: number;        // Shell command timeout (default: 300000 = 5 min)\n  readTimeoutMs: number;         // File read timeout (default: 30000 = 30 sec)\n  writeTimeoutMs: number;        // File write timeout (default: 60000 = 1 min)\n  networkTimeoutMs: number;      // Network request timeout (default: 60000 = 1 min)\n  gracefulShutdownMs: number;    // Time to wait for graceful shutdown (default: 5000)\n}\n\nconst DEFAULT_CONFIG: TimeoutConfig = {\n  defaultTimeoutMs: 5 * 60 * 1000,      // 5 minutes\n  shellTimeoutMs: 5 * 60 * 1000,        // 5 minutes\n  readTimeoutMs: 30 * 1000,             // 30 seconds\n  writeTimeoutMs: 60 * 1000,            // 1 minute\n  networkTimeoutMs: 60 * 1000,          // 1 minute\n  gracefulShutdownMs: 5000,             // 5 seconds\n};\n\nexport interface TimeoutResult<T> {\n  success: boolean;\n  result?: T;\n  error?: Error;\n  timedOut: boolean;\n  executionTimeMs: number;\n}\n\nexport interface ToolTimeoutConfig {\n  toolName: string;\n  timeoutMs?: number;\n  description?: string;\n}\n\n/**\n * Get timeout for specific tool type\n */\nfunction getTimeoutForTool(toolName: string, config: TimeoutConfig): number {\n  const toolLower = toolName.toLowerCase();\n\n  if (toolLower.includes('exec') || toolLower.includes('command')) {\n    return config.shellTimeoutMs;\n  }\n  if (toolLower.includes('read') || toolLower.includes('view')) {\n    return config.readTimeoutMs;\n  }\n  if (toolLower.includes('write') || toolLower.includes('edit')) {\n    return config.writeTimeoutMs;\n  }\n  if (toolLower.includes('web') || toolLower.includes('http') || toolLower.includes('fetch')) {\n    return config.networkTimeoutMs;\n  }\n\n  return config.defaultTimeoutMs;\n}\n\n/**\n * Execute function with timeout protection\n *\n * @example\n * ```typescript\n * const result = await executeWithTimeout(\n *   () => execCommand('long-running-command'),\n *   { toolName: 'exec_command', timeoutMs: 60000 }\n * );\n * ```\n */\nexport async function executeWithTimeout<T>(\n  operation: () => Promise<T>,\n  config: ToolTimeoutConfig\n): Promise<T> {\n  const fullConfig = { ...DEFAULT_CONFIG };\n  const timeoutMs = config.timeoutMs || getTimeoutForTool(config.toolName, fullConfig);\n\n  const startTime = Date.now();\n  let timeoutId: NodeJS.Timeout | null = null;\n  let isSettled = false;\n\n  return new Promise((resolve, reject) => {\n    // Set up timeout\n    timeoutId = setTimeout(() => {\n      if (isSettled) return;\n      isSettled = true;\n      \n      const executionTime = Date.now() - startTime;\n      const desc = config.description ? ` (${config.description})` : '';\n      log.error(\n        {\n          toolName: config.toolName,\n          timeoutMs,\n          executionTimeMs: executionTime,\n          description: config.description,\n        },\n        `Tool \"${config.toolName}\" timed out after ${timeoutMs}ms (elapsed ${executionTime}ms)${desc}`,\n      );\n\n      reject(\n        new TimeoutError(\n          config.toolName,\n          timeoutMs,\n          config.description,\n          executionTime\n        )\n      );\n    }, timeoutMs);\n\n    // Execute operation\n    operation()\n      .then(result => {\n        if (isSettled) return;\n        isSettled = true;\n        \n        if (timeoutId) {\n          clearTimeout(timeoutId);\n          timeoutId = null;\n        }\n        const executionTime = Date.now() - startTime;\n\n        log.debug(\n          {\n            toolName: config.toolName,\n            executionTimeMs: executionTime,\n          },\n          'Tool execution completed within timeout'\n        );\n\n        resolve(result);\n      })\n      .catch(error => {\n        if (isSettled) return;\n        isSettled = true;\n        \n        if (timeoutId) {\n          clearTimeout(timeoutId);\n          timeoutId = null;\n        }\n        reject(error);\n      });\n  });\n}\n\n/**\n * Execute with timeout and return detailed result\n */\nexport async function executeWithTimeoutResult<T>(\n  operation: () => Promise<T>,\n  config: ToolTimeoutConfig\n): Promise<TimeoutResult<T>> {\n  const startTime = Date.now();\n\n  try {\n    const result = await executeWithTimeout(operation, config);\n    return {\n      success: true,\n      result,\n      timedOut: false,\n      executionTimeMs: Date.now() - startTime,\n    };\n  } catch (error) {\n    const isTimeout = error instanceof TimeoutError;\n    return {\n      success: false,\n      error: error instanceof Error ? error : new Error(String(error)),\n      timedOut: isTimeout,\n      executionTimeMs: Date.now() - startTime,\n    };\n  }\n}\n\n/**\n * Custom timeout error\n */\nexport class TimeoutError extends Error {\n  public readonly toolName: string;\n  public readonly timeoutMs: number;\n  public readonly executionTimeMs: number;\n  public readonly description?: string;\n\n  constructor(\n    toolName: string,\n    timeoutMs: number,\n    description?: string,\n    executionTimeMs: number = timeoutMs\n  ) {\n    const timeoutSec = Math.round(timeoutMs / 1000);\n    const message = description\n      ? `Tool '${toolName}' timed out after ${timeoutSec}s: ${description}`\n      : `Tool '${toolName}' timed out after ${timeoutSec}s. Consider breaking the operation into smaller steps.`;\n\n    super(message);\n    this.name = 'TimeoutError';\n    this.toolName = toolName;\n    this.timeoutMs = timeoutMs;\n    this.description = description;\n    this.executionTimeMs = executionTimeMs;\n\n    // Maintain proper stack trace\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, TimeoutError);\n    }\n  }\n\n  /**\n   * Get user-friendly error message with suggestions\n   */\n  getUserMessage(): string {\n    const suggestions: string[] = [];\n\n    if (this.toolName.toLowerCase().includes('exec') || this.toolName.toLowerCase().includes('command')) {\n      suggestions.push('Break the command into smaller steps');\n      suggestions.push('Add timeouts to individual commands');\n      suggestions.push('Check for infinite loops or waiting for input');\n    } else if (this.toolName.toLowerCase().includes('read')) {\n      suggestions.push('Read the file in smaller chunks');\n      suggestions.push('Use grep to find specific content first');\n    } else if (this.toolName.toLowerCase().includes('write')) {\n      suggestions.push('Write content in smaller batches');\n    } else if (this.toolName.toLowerCase().includes('web')) {\n      suggestions.push('Check network connectivity');\n      suggestions.push('Try again later');\n    }\n\n    let message = `⚠️ ${this.message}`;\n    if (suggestions.length > 0) {\n      message += '\\n\\nSuggestions:\\n' + suggestions.map(s => `• ${s}`).join('\\n');\n    }\n\n    return message;\n  }\n}\n\n/**\n * Wrap a function with timeout protection\n */\nexport function withTimeout<T extends (...args: any[]) => Promise<any>>(\n  fn: T,\n  config: Omit<ToolTimeoutConfig, 'description'> & { description?: string | ((...args: Parameters<T>) => string) }\n): (...args: Parameters<T>) => Promise<ReturnType<T>> {\n  return async (...args: Parameters<T>): Promise<ReturnType<T>> => {\n    const description = typeof config.description === 'function'\n      ? config.description(...args)\n      : config.description;\n\n    return executeWithTimeout(() => fn(...args), {\n      toolName: config.toolName,\n      timeoutMs: config.timeoutMs,\n      description,\n    });\n  };\n}\n\n/**\n * Timeout manager for tracking execution statistics\n */\nexport class TimeoutManager {\n  private executions: Array<{\n    toolName: string;\n    executionTimeMs: number;\n    timedOut: boolean;\n    timestamp: number;\n  }> = [];\n\n  constructor(_config: Partial<TimeoutConfig> = {}) {}\n\n  /**\n   * Execute with timeout and track statistics\n   */\n  async execute<T>(\n    operation: () => Promise<T>,\n    toolConfig: ToolTimeoutConfig\n  ): Promise<T> {\n    const startTime = Date.now();\n    let timedOut = false;\n\n    try {\n      const result = await executeWithTimeout(operation, toolConfig);\n      this.executions.push({\n        toolName: toolConfig.toolName,\n        executionTimeMs: Date.now() - startTime,\n        timedOut: false,\n        timestamp: Date.now(),\n      });\n      return result;\n    } catch (error) {\n      if (error instanceof TimeoutError) {\n        timedOut = true;\n      }\n      this.executions.push({\n        toolName: toolConfig.toolName,\n        executionTimeMs: Date.now() - startTime,\n        timedOut,\n        timestamp: Date.now(),\n      });\n      throw error;\n    }\n  }\n\n  /**\n   * Get execution statistics\n   */\n  getStats(): {\n    totalExecutions: number;\n    timeoutCount: number;\n    timeoutRate: number;\n    averageExecutionTimeMs: number;\n    byTool: Record<string, {\n      count: number;\n      timeouts: number;\n      avgExecutionTimeMs: number;\n    }>;\n  } {\n    const byTool: Record<string, { count: number; timeouts: number; totalTime: number }> = {};\n\n    for (const exec of this.executions) {\n      if (!byTool[exec.toolName]) {\n        byTool[exec.toolName] = { count: 0, timeouts: 0, totalTime: 0 };\n      }\n      byTool[exec.toolName].count++;\n      if (exec.timedOut) {\n        byTool[exec.toolName].timeouts++;\n      }\n      byTool[exec.toolName].totalTime += exec.executionTimeMs;\n    }\n\n    const totalExecutions = this.executions.length;\n    const timeoutCount = this.executions.filter(e => e.timedOut).length;\n    const totalTime = this.executions.reduce((sum, e) => sum + e.executionTimeMs, 0);\n\n    return {\n      totalExecutions,\n      timeoutCount,\n      timeoutRate: totalExecutions > 0 ? timeoutCount / totalExecutions : 0,\n      averageExecutionTimeMs: totalExecutions > 0 ? totalTime / totalExecutions : 0,\n      byTool: Object.fromEntries(\n        Object.entries(byTool).map(([name, stats]) => [\n          name,\n          {\n            count: stats.count,\n            timeouts: stats.timeouts,\n            avgExecutionTimeMs: stats.count > 0 ? stats.totalTime / stats.count : 0,\n          },\n        ])\n      ),\n    };\n  }\n\n  /**\n   * Clean up old execution records\n   */\n  cleanup(maxAgeMs: number = 24 * 60 * 60 * 1000): void {\n    const cutoff = Date.now() - maxAgeMs;\n    this.executions = this.executions.filter(e => e.timestamp > cutoff);\n  }\n}\n\n// Convenience exports\nexport { DEFAULT_CONFIG as DEFAULT_TIMEOUT_CONFIG };\n"],"mappings":";;;aASqD;AAErD,MAAM,MAAM,aAAa,iBAAiB;AAW1C,MAAM,iBAAgC;CACpC,kBAAkB,MAAS;CAC3B,gBAAgB,MAAS;CACzB,eAAe,KAAK;CACpB,gBAAgB,KAAK;CACrB,kBAAkB,KAAK;CACvB,oBAAoB;CACrB;;;;AAmBD,SAAS,kBAAkB,UAAkB,QAA+B;CAC1E,MAAM,YAAY,SAAS,aAAa;AAExC,KAAI,UAAU,SAAS,OAAO,IAAI,UAAU,SAAS,UAAU,CAC7D,QAAO,OAAO;AAEhB,KAAI,UAAU,SAAS,OAAO,IAAI,UAAU,SAAS,OAAO,CAC1D,QAAO,OAAO;AAEhB,KAAI,UAAU,SAAS,QAAQ,IAAI,UAAU,SAAS,OAAO,CAC3D,QAAO,OAAO;AAEhB,KAAI,UAAU,SAAS,MAAM,IAAI,UAAU,SAAS,OAAO,IAAI,UAAU,SAAS,QAAQ,CACxF,QAAO,OAAO;AAGhB,QAAO,OAAO;;;;;;;;;;;;;AAchB,eAAsB,mBACpB,WACA,QACY;CACZ,MAAM,aAAa,EAAE,GAAG,gBAAgB;CACxC,MAAM,YAAY,OAAO,aAAa,kBAAkB,OAAO,UAAU,WAAW;CAEpF,MAAM,YAAY,KAAK,KAAK;CAC5B,IAAI,YAAmC;CACvC,IAAI,YAAY;AAEhB,QAAO,IAAI,SAAS,SAAS,WAAW;AAEtC,cAAY,iBAAiB;AAC3B,OAAI,UAAW;AACf,eAAY;GAEZ,MAAM,gBAAgB,KAAK,KAAK,GAAG;GACnC,MAAM,OAAO,OAAO,cAAc,KAAK,OAAO,YAAY,KAAK;AAC/D,OAAI,MACF;IACE,UAAU,OAAO;IACjB;IACA,iBAAiB;IACjB,aAAa,OAAO;IACrB,EACD,SAAS,OAAO,SAAS,oBAAoB,UAAU,cAAc,cAAc,KAAK,OACzF;AAED,UACE,IAAI,aACF,OAAO,UACP,WACA,OAAO,aACP,cACD,CACF;KACA,UAAU;AAGb,aAAW,CACR,MAAK,WAAU;AACd,OAAI,UAAW;AACf,eAAY;AAEZ,OAAI,WAAW;AACb,iBAAa,UAAU;AACvB,gBAAY;;GAEd,MAAM,gBAAgB,KAAK,KAAK,GAAG;AAEnC,OAAI,MACF;IACE,UAAU,OAAO;IACjB,iBAAiB;IAClB,EACD,0CACD;AAED,WAAQ,OAAO;IACf,CACD,OAAM,UAAS;AACd,OAAI,UAAW;AACf,eAAY;AAEZ,OAAI,WAAW;AACb,iBAAa,UAAU;AACvB,gBAAY;;AAEd,UAAO,MAAM;IACb;GACJ;;;;;AAMJ,eAAsB,yBACpB,WACA,QAC2B;CAC3B,MAAM,YAAY,KAAK,KAAK;AAE5B,KAAI;AAEF,SAAO;GACL,SAAS;GACT,QAAA,MAHmB,mBAAmB,WAAW,OAAO;GAIxD,UAAU;GACV,iBAAiB,KAAK,KAAK,GAAG;GAC/B;UACM,OAAO;EACd,MAAM,YAAY,iBAAiB;AACnC,SAAO;GACL,SAAS;GACT,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;GAChE,UAAU;GACV,iBAAiB,KAAK,KAAK,GAAG;GAC/B;;;;;;AAOL,IAAa,eAAb,MAAa,qBAAqB,MAAM;CACtC;CACA;CACA;CACA;CAEA,YACE,UACA,WACA,aACA,kBAA0B,WAC1B;EACA,MAAM,aAAa,KAAK,MAAM,YAAY,IAAK;EAC/C,MAAM,UAAU,cACZ,SAAS,SAAS,oBAAoB,WAAW,KAAK,gBACtD,SAAS,SAAS,oBAAoB,WAAW;AAErD,QAAM,QAAQ;AACd,OAAK,OAAO;AACZ,OAAK,WAAW;AAChB,OAAK,YAAY;AACjB,OAAK,cAAc;AACnB,OAAK,kBAAkB;AAGvB,MAAI,MAAM,kBACR,OAAM,kBAAkB,MAAM,aAAa;;;;;CAO/C,iBAAyB;EACvB,MAAM,cAAwB,EAAE;AAEhC,MAAI,KAAK,SAAS,aAAa,CAAC,SAAS,OAAO,IAAI,KAAK,SAAS,aAAa,CAAC,SAAS,UAAU,EAAE;AACnG,eAAY,KAAK,uCAAuC;AACxD,eAAY,KAAK,sCAAsC;AACvD,eAAY,KAAK,gDAAgD;aACxD,KAAK,SAAS,aAAa,CAAC,SAAS,OAAO,EAAE;AACvD,eAAY,KAAK,kCAAkC;AACnD,eAAY,KAAK,0CAA0C;aAClD,KAAK,SAAS,aAAa,CAAC,SAAS,QAAQ,CACtD,aAAY,KAAK,mCAAmC;WAC3C,KAAK,SAAS,aAAa,CAAC,SAAS,MAAM,EAAE;AACtD,eAAY,KAAK,6BAA6B;AAC9C,eAAY,KAAK,kBAAkB;;EAGrC,IAAI,UAAU,MAAM,KAAK;AACzB,MAAI,YAAY,SAAS,EACvB,YAAW,uBAAuB,YAAY,KAAI,MAAK,KAAK,IAAI,CAAC,KAAK,KAAK;AAG7E,SAAO;;;;;;AAOX,SAAgB,YACd,IACA,QACoD;AACpD,QAAO,OAAO,GAAG,SAAgD;EAC/D,MAAM,cAAc,OAAO,OAAO,gBAAgB,aAC9C,OAAO,YAAY,GAAG,KAAK,GAC3B,OAAO;AAEX,SAAO,yBAAyB,GAAG,GAAG,KAAK,EAAE;GAC3C,UAAU,OAAO;GACjB,WAAW,OAAO;GAClB;GACD,CAAC;;;;;;AAON,IAAa,iBAAb,MAA4B;CAC1B,aAKK,EAAE;CAEP,YAAY,UAAkC,EAAE,EAAE;;;;CAKlD,MAAM,QACJ,WACA,YACY;EACZ,MAAM,YAAY,KAAK,KAAK;EAC5B,IAAI,WAAW;AAEf,MAAI;GACF,MAAM,SAAS,MAAM,mBAAmB,WAAW,WAAW;AAC9D,QAAK,WAAW,KAAK;IACnB,UAAU,WAAW;IACrB,iBAAiB,KAAK,KAAK,GAAG;IAC9B,UAAU;IACV,WAAW,KAAK,KAAK;IACtB,CAAC;AACF,UAAO;WACA,OAAO;AACd,OAAI,iBAAiB,aACnB,YAAW;AAEb,QAAK,WAAW,KAAK;IACnB,UAAU,WAAW;IACrB,iBAAiB,KAAK,KAAK,GAAG;IAC9B;IACA,WAAW,KAAK,KAAK;IACtB,CAAC;AACF,SAAM;;;;;;CAOV,WAUE;EACA,MAAM,SAAiF,EAAE;AAEzF,OAAK,MAAM,QAAQ,KAAK,YAAY;AAClC,OAAI,CAAC,OAAO,KAAK,UACf,QAAO,KAAK,YAAY;IAAE,OAAO;IAAG,UAAU;IAAG,WAAW;IAAG;AAEjE,UAAO,KAAK,UAAU;AACtB,OAAI,KAAK,SACP,QAAO,KAAK,UAAU;AAExB,UAAO,KAAK,UAAU,aAAa,KAAK;;EAG1C,MAAM,kBAAkB,KAAK,WAAW;EACxC,MAAM,eAAe,KAAK,WAAW,QAAO,MAAK,EAAE,SAAS,CAAC;EAC7D,MAAM,YAAY,KAAK,WAAW,QAAQ,KAAK,MAAM,MAAM,EAAE,iBAAiB,EAAE;AAEhF,SAAO;GACL;GACA;GACA,aAAa,kBAAkB,IAAI,eAAe,kBAAkB;GACpE,wBAAwB,kBAAkB,IAAI,YAAY,kBAAkB;GAC5E,QAAQ,OAAO,YACb,OAAO,QAAQ,OAAO,CAAC,KAAK,CAAC,MAAM,WAAW,CAC5C,MACA;IACE,OAAO,MAAM;IACb,UAAU,MAAM;IAChB,oBAAoB,MAAM,QAAQ,IAAI,MAAM,YAAY,MAAM,QAAQ;IACvE,CACF,CAAC,CACH;GACF;;;;;CAMH,QAAQ,WAAmB,OAAU,KAAK,KAAY;EACpD,MAAM,SAAS,KAAK,KAAK,GAAG;AAC5B,OAAK,aAAa,KAAK,WAAW,QAAO,MAAK,EAAE,YAAY,OAAO"}

package/dist/src/agent/memory/dreaming/config.d.ts

@@ -35,8 +35,8 @@ export type DreamingResolvedConfig = {
     };
     deep: DreamingDeepConfig;
 };
-/** Resolve the full three-phase dreaming config from the default agent manifest. */
-export declare function resolveDreamingConfig(cfg: Config | undefined): DreamingResolvedConfig;
+/** Resolve the full three-phase dreaming config from an agent manifest. */
+export declare function resolveDreamingConfig(cfg: Config | undefined, requestedAgentId?: string | null): DreamingResolvedConfig;
 /** Get the cron expression for a specific phase from resolved config. */
 export declare function getPhaseCron(config: DreamingResolvedConfig, phase: DreamingPhaseId): string;
 /** Check if a specific phase is enabled (global + phase-level). */

package/dist/src/agent/memory/dreaming/config.js

@@ -25,9 +25,9 @@ function trimmedStringOr(value, fallback) {
 function optionalTrimmedString(value) {
 	return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
-/** Resolve the full three-phase dreaming config from the default agent manifest. */
-function resolveDreamingConfig(cfg) {
-	const agentId = cfg ? resolveDefaultAgentId(cfg) : void 0;
+/** Resolve the full three-phase dreaming config from an agent manifest. */
+function resolveDreamingConfig(cfg, requestedAgentId) {
+	const agentId = cfg ? requestedAgentId?.trim() || resolveDefaultAgentId(cfg) : void 0;
 	const manifest = cfg && agentId ? resolveEffectiveAgentManifestForAgent(cfg, agentId) : void 0;
 	const dreaming = manifest?.memory.dreaming;
 	const enabled = dreaming?.enabled === true && manifest?.memory.mode !== "off";