@xopcai/xopc 0.0.115 → 0.0.117

package/dist/src/agent/tools/memory-tool.d.ts

@@ -1,8 +1,8 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
+import type { MemoryManager } from '../memory/manager.js';
 export interface MemoryToolOptions {
     workspaceDir: string;
-    /** Agent home curated memories dir, e.g. ~/.xopc/agents/<id>/memories/ */
-    memoriesDir?: string;
+    getMemoryManager: () => MemoryManager;
 }
 export declare function createMemorySearchTool(options: MemoryToolOptions): AgentTool;
 export declare function createMemoryGetTool(options: MemoryToolOptions): AgentTool;

package/dist/src/agent/tools/memory-tool.js

@@ -1,4 +1,3 @@
-import { memoryGet, memorySearch } from "../prompt/memory/index.js";
 import { recordDreamingRecalls } from "../memory/dreaming/short-term-store.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/memory-tool.ts
@@ -8,7 +7,7 @@ const MemorySearchSchema = Type.Object({
 	minScore: Type.Optional(Type.Number())
 });
 function createMemorySearchTool(options) {
-	const { workspaceDir, memoriesDir } = options;
+	const { workspaceDir, getMemoryManager } = options;
 	return {
 		name: "memory_search",
 		label: "🔍 Memory Search",
@@ -17,27 +16,49 @@ function createMemorySearchTool(options) {
 		async execute(_toolCallId, params, _signal) {
 			const { query, maxResults, minScore } = params;
 			try {
-				const results = await memorySearch(workspaceDir, query, {
+				const results = await getMemoryManager().search({
+					query,
 					maxResults,
-					minScore,
-					memoriesDir
+					minScore
+				});
+				for (const result of results) getMemoryManager().recordSignal({
+					source: "search_recall",
+					recordId: result.record.id,
+					score: result.score,
+					content: result.snippet,
+					metadata: {
+						providerId: result.citation.providerId,
+						path: result.citation.path,
+						lineStart: result.citation.lineStart,
+						lineEnd: result.citation.lineEnd
+					}
 				});
 				recordDreamingRecalls({
 					workspaceDir,
 					query,
-					matches: results
+					matches: results.map((entry) => ({
+						file: entry.citation.path ?? entry.record.source.path ?? entry.record.id,
+						lines: entry.snippet,
+						score: entry.score,
+						lineNumbers: entry.citation.lineStart != null ? [entry.citation.lineStart, entry.citation.lineEnd ?? entry.citation.lineStart] : []
+					}))
 				}).catch(() => {});
 				const withCitations = results.map((entry) => ({
-					...entry,
-					citation: `${entry.file}#L${entry.lineNumbers[0]}${entry.lineNumbers.length > 1 ? `-L${entry.lineNumbers[entry.lineNumbers.length - 1]}` : ""}`,
-					snippet: `${entry.lines.trim()}\n\nSource: ${entry.file}#L${entry.lineNumbers[0]}${entry.lineNumbers.length > 1 ? `-L${entry.lineNumbers[entry.lineNumbers.length - 1]}` : ""}`
+					id: entry.record.id,
+					kind: entry.record.kind,
+					file: entry.citation.path ?? entry.record.source.path,
+					lines: entry.snippet,
+					score: entry.score,
+					lineNumbers: entry.citation.lineStart != null ? [entry.citation.lineStart, entry.citation.lineEnd ?? entry.citation.lineStart] : [],
+					citation: `${entry.citation.path ?? entry.record.id}${entry.citation.lineStart != null ? `#L${entry.citation.lineStart}${entry.citation.lineEnd && entry.citation.lineEnd !== entry.citation.lineStart ? `-L${entry.citation.lineEnd}` : ""}` : ""}`,
+					snippet: `${entry.snippet.trim()}\n\nSource: ${entry.citation.path ?? entry.record.id}${entry.citation.lineStart != null ? `#L${entry.citation.lineStart}${entry.citation.lineEnd && entry.citation.lineEnd !== entry.citation.lineStart ? `-L${entry.citation.lineEnd}` : ""}` : ""}`
 				}));
 				return {
 					content: [{
 						type: "text",
 						text: JSON.stringify({
 							results: withCitations,
-							provider: "simple"
+							provider: "memory-manager"
 						}, null, 2)
 					}],
 					details: { results: withCitations }
@@ -61,7 +82,7 @@ const MemoryGetSchema = Type.Object({
 	lines: Type.Optional(Type.Number())
 });
 function createMemoryGetTool(options) {
-	const { workspaceDir, memoriesDir } = options;
+	const { getMemoryManager } = options;
 	return {
 		name: "memory_get",
 		label: "📄 Memory Get",
@@ -70,7 +91,11 @@ function createMemoryGetTool(options) {
 		async execute(_toolCallId, params, _signal) {
 			const { path, from, lines } = params;
 			try {
-				const result = memoryGet(workspaceDir, path, from, lines, memoriesDir);
+				const result = await getMemoryManager().read({
+					path,
+					from,
+					lines
+				});
 				if (!result) return {
 					content: [{
 						type: "text",
@@ -84,11 +109,11 @@ function createMemoryGetTool(options) {
 				return {
 					content: [{
 						type: "text",
-						text: result.content
+						text: result.record.content
 					}],
 					details: {
 						path,
-						text: result.content,
+						text: result.record.content,
 						lineNumbers: result.lineNumbers
 					}
 				};

package/dist/src/agent/tools/memory-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-tool.js","names":[],"sources":["../../../../src/agent/tools/memory-tool.ts"],"sourcesContent":["// Memory search tools for xopc agent\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { memorySearch, memoryGet } from '../prompt/memory/index.js';\nimport { recordDreamingRecalls } from '../memory/dreaming/short-term-store.js';\n\n// =============================================================================\n// Memory Search Tool\n// =============================================================================\nconst MemorySearchSchema = Type.Object({\n  query: Type.String(),\n  maxResults: Type.Optional(Type.Number()),\n  minScore: Type.Optional(Type.Number()),\n});\n\ntype MemorySearchParams = { query: string; maxResults?: number; minScore?: number };\n\nexport interface MemoryToolOptions {\n  workspaceDir: string;\n  /** Agent home curated memories dir, e.g. ~/.xopc/agents/<id>/memories/ */\n  memoriesDir?: string;\n}\n\nexport function createMemorySearchTool(options: MemoryToolOptions): AgentTool {\n  const { workspaceDir, memoriesDir } = options;\n  return {\n    name: 'memory_search',\n    label: '🔍 Memory Search',\n    description:\n      'Mandatory recall step: semantically search profile MEMORY.md, agent-home `memories/*.md`, and workspace `memory/*.md` before answering questions about prior work, decisions, dates, people, preferences, or todos; returns top snippets with path + lines.',\n    parameters: MemorySearchSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const { query, maxResults, minScore } = params as MemorySearchParams;\n\n      try {\n        const results = await memorySearch(workspaceDir, query, { maxResults, minScore, memoriesDir });\n        // Dreaming: record short-term recall evidence from memory_search.\n        // Only records workspace daily notes (`memory/YYYY-MM-DD.md`) and ignores curated/long-term files.\n        void recordDreamingRecalls({ workspaceDir, query, matches: results }).catch(() => {});\n        const withCitations = results.map((entry) => ({\n          ...entry,\n          citation: `${entry.file}#L${entry.lineNumbers[0]}${entry.lineNumbers.length > 1 ? `-L${entry.lineNumbers[entry.lineNumbers.length - 1]}` : ''}`,\n          snippet: `${entry.lines.trim()}\\n\\nSource: ${entry.file}#L${entry.lineNumbers[0]}${entry.lineNumbers.length > 1 ? `-L${entry.lineNumbers[entry.lineNumbers.length - 1]}` : ''}`,\n        }));\n\n        return {\n          content: [{ type: 'text', text: JSON.stringify({ results: withCitations, provider: 'simple' }, null, 2) }],\n          details: { results: withCitations },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Search error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n\n// =============================================================================\n// Memory Get Tool\n// =============================================================================\nconst MemoryGetSchema = Type.Object({\n  path: Type.String(),\n  from: Type.Optional(Type.Number()),\n  lines: Type.Optional(Type.Number()),\n});\n\ntype MemoryGetParams = { path: string; from?: number; lines?: number };\n\nexport function createMemoryGetTool(options: MemoryToolOptions): AgentTool {\n  const { workspaceDir, memoriesDir } = options;\n  return {\n    name: 'memory_get',\n    label: '📄 Memory Get',\n    description: 'Safe snippet read from MEMORY.md or memory/*.md with optional from/lines; use after memory_search to pull only the needed lines and keep context small.',\n    parameters: MemoryGetSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const { path, from, lines } = params as MemoryGetParams;\n\n      try {\n        const result = memoryGet(workspaceDir, path, from, lines, memoriesDir);\n        if (!result) {\n          return {\n            content: [{ type: 'text', text: `File not found: ${path}` }],\n            details: { path, text: '' },\n          };\n        }\n        return {\n          content: [{ type: 'text', text: result.content }],\n          details: { path, text: result.content, lineNumbers: result.lineNumbers },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Read error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":";;;;AASA,MAAM,qBAAqB,KAAK,OAAO;CACrC,OAAO,KAAK,QAAQ;CACpB,YAAY,KAAK,SAAS,KAAK,QAAQ,CAAC;CACxC,UAAU,KAAK,SAAS,KAAK,QAAQ,CAAC;CACvC,CAAC;AAUF,SAAgB,uBAAuB,SAAuC;CAC5E,MAAM,EAAE,cAAc,gBAAgB;AACtC,QAAO;EACL,MAAM;EACN,OAAO;EACP,aACE;EACF,YAAY;EAEZ,MAAM,QACJ,aACA,QACA,SAC8B;GAC9B,MAAM,EAAE,OAAO,YAAY,aAAa;AAExC,OAAI;IACF,MAAM,UAAU,MAAM,aAAa,cAAc,OAAO;KAAE;KAAY;KAAU;KAAa,CAAC;AAGzF,0BAAsB;KAAE;KAAc;KAAO,SAAS;KAAS,CAAC,CAAC,YAAY,GAAG;IACrF,MAAM,gBAAgB,QAAQ,KAAK,WAAW;KAC5C,GAAG;KACH,UAAU,GAAG,MAAM,KAAK,IAAI,MAAM,YAAY,KAAK,MAAM,YAAY,SAAS,IAAI,KAAK,MAAM,YAAY,MAAM,YAAY,SAAS,OAAO;KAC3I,SAAS,GAAG,MAAM,MAAM,MAAM,CAAC,cAAc,MAAM,KAAK,IAAI,MAAM,YAAY,KAAK,MAAM,YAAY,SAAS,IAAI,KAAK,MAAM,YAAY,MAAM,YAAY,SAAS,OAAO;KAC5K,EAAE;AAEH,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,KAAK,UAAU;OAAE,SAAS;OAAe,UAAU;OAAU,EAAE,MAAM,EAAE;MAAE,CAAC;KAC1G,SAAS,EAAE,SAAS,eAAe;KACpC;YACM,KAAK;IACZ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAChE,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,iBAAiB;MAAW,CAAC;KAC7D,SAAS,EAAE,OAAO,SAAS;KAC5B;;;EAGN;;AAMH,MAAM,kBAAkB,KAAK,OAAO;CAClC,MAAM,KAAK,QAAQ;CACnB,MAAM,KAAK,SAAS,KAAK,QAAQ,CAAC;CAClC,OAAO,KAAK,SAAS,KAAK,QAAQ,CAAC;CACpC,CAAC;AAIF,SAAgB,oBAAoB,SAAuC;CACzE,MAAM,EAAE,cAAc,gBAAgB;AACtC,QAAO;EACL,MAAM;EACN,OAAO;EACP,aAAa;EACb,YAAY;EAEZ,MAAM,QACJ,aACA,QACA,SAC8B;GAC9B,MAAM,EAAE,MAAM,MAAM,UAAU;AAE9B,OAAI;IACF,MAAM,SAAS,UAAU,cAAc,MAAM,MAAM,OAAO,YAAY;AACtE,QAAI,CAAC,OACH,QAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,mBAAmB;MAAQ,CAAC;KAC5D,SAAS;MAAE;MAAM,MAAM;MAAI;KAC5B;AAEH,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,OAAO;MAAS,CAAC;KACjD,SAAS;MAAE;MAAM,MAAM,OAAO;MAAS,aAAa,OAAO;MAAa;KACzE;YACM,KAAK;IACZ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAChE,WAAO;KACL,SAAS,CAAC;MAAE,MAAM;MAAQ,MAAM,eAAe;MAAW,CAAC;KAC3D,SAAS,EAAE,OAAO,SAAS;KAC5B;;;EAGN"}
+{"version":3,"file":"memory-tool.js","names":[],"sources":["../../../../src/agent/tools/memory-tool.ts"],"sourcesContent":["// Memory search tools for xopc agent\nimport { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { recordDreamingRecalls } from '../memory/dreaming/short-term-store.js';\nimport type { MemoryManager } from '../memory/manager.js';\n\n// =============================================================================\n// Memory Search Tool\n// =============================================================================\nconst MemorySearchSchema = Type.Object({\n  query: Type.String(),\n  maxResults: Type.Optional(Type.Number()),\n  minScore: Type.Optional(Type.Number()),\n});\n\ntype MemorySearchParams = { query: string; maxResults?: number; minScore?: number };\n\nexport interface MemoryToolOptions {\n  workspaceDir: string;\n  getMemoryManager: () => MemoryManager;\n}\n\nexport function createMemorySearchTool(options: MemoryToolOptions): AgentTool {\n  const { workspaceDir, getMemoryManager } = options;\n  return {\n    name: 'memory_search',\n    label: '🔍 Memory Search',\n    description:\n      'Mandatory recall step: semantically search profile MEMORY.md, agent-home `memories/*.md`, and workspace `memory/*.md` before answering questions about prior work, decisions, dates, people, preferences, or todos; returns top snippets with path + lines.',\n    parameters: MemorySearchSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const { query, maxResults, minScore } = params as MemorySearchParams;\n\n      try {\n        const results = await getMemoryManager().search({ query, maxResults, minScore });\n        for (const result of results) {\n          getMemoryManager().recordSignal({\n            source: 'search_recall',\n            recordId: result.record.id,\n            score: result.score,\n            content: result.snippet,\n            metadata: {\n              providerId: result.citation.providerId,\n              path: result.citation.path,\n              lineStart: result.citation.lineStart,\n              lineEnd: result.citation.lineEnd,\n            },\n          });\n        }\n        // Dreaming: record short-term recall evidence from memory_search.\n        // Only records workspace daily notes (`memory/YYYY-MM-DD.md`) and ignores curated/long-term files.\n        void recordDreamingRecalls({\n          workspaceDir,\n          query,\n          matches: results.map((entry) => ({\n            file: entry.citation.path ?? entry.record.source.path ?? entry.record.id,\n            lines: entry.snippet,\n            score: entry.score,\n            lineNumbers:\n              entry.citation.lineStart != null\n                ? [entry.citation.lineStart, entry.citation.lineEnd ?? entry.citation.lineStart]\n                : [],\n          })),\n        }).catch(() => {});\n        const withCitations = results.map((entry) => ({\n          id: entry.record.id,\n          kind: entry.record.kind,\n          file: entry.citation.path ?? entry.record.source.path,\n          lines: entry.snippet,\n          score: entry.score,\n          lineNumbers:\n            entry.citation.lineStart != null\n              ? [entry.citation.lineStart, entry.citation.lineEnd ?? entry.citation.lineStart]\n              : [],\n          citation: `${entry.citation.path ?? entry.record.id}${entry.citation.lineStart != null ? `#L${entry.citation.lineStart}${entry.citation.lineEnd && entry.citation.lineEnd !== entry.citation.lineStart ? `-L${entry.citation.lineEnd}` : ''}` : ''}`,\n          snippet: `${entry.snippet.trim()}\\n\\nSource: ${entry.citation.path ?? entry.record.id}${entry.citation.lineStart != null ? `#L${entry.citation.lineStart}${entry.citation.lineEnd && entry.citation.lineEnd !== entry.citation.lineStart ? `-L${entry.citation.lineEnd}` : ''}` : ''}`,\n        }));\n\n        return {\n          content: [{ type: 'text', text: JSON.stringify({ results: withCitations, provider: 'memory-manager' }, null, 2) }],\n          details: { results: withCitations },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Search error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n\n// =============================================================================\n// Memory Get Tool\n// =============================================================================\nconst MemoryGetSchema = Type.Object({\n  path: Type.String(),\n  from: Type.Optional(Type.Number()),\n  lines: Type.Optional(Type.Number()),\n});\n\ntype MemoryGetParams = { path: string; from?: number; lines?: number };\n\nexport function createMemoryGetTool(options: MemoryToolOptions): AgentTool {\n  const { getMemoryManager } = options;\n  return {\n    name: 'memory_get',\n    label: '📄 Memory Get',\n    description: 'Safe snippet read from MEMORY.md or memory/*.md with optional from/lines; use after memory_search to pull only the needed lines and keep context small.',\n    parameters: MemoryGetSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const { path, from, lines } = params as MemoryGetParams;\n\n      try {\n        const result = await getMemoryManager().read({ path, from, lines });\n        if (!result) {\n          return {\n            content: [{ type: 'text', text: `File not found: ${path}` }],\n            details: { path, text: '' },\n          };\n        }\n        return {\n          content: [{ type: 'text', text: result.record.content }],\n          details: { path, text: result.record.content, lineNumbers: result.lineNumbers },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `Read error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}

package/dist/src/agent/tools/session-search-tool.js

@@ -10,9 +10,7 @@ init_logger();
 const log = createLogger("Agent:SessionSearch");
 const MAX_SUMMARY_CHARS = 2e4;
 function resolveSummaryModel(getConfig) {
-	const envRef = process.env.XOPC_SESSION_SEARCH_MODEL?.trim();
-	const configRef = getConfig?.()?.agents?.defaults?.sessionSearch?.summaryModel?.trim();
-	const ref = envRef || configRef;
+	const ref = process.env.XOPC_SESSION_SEARCH_MODEL?.trim();
 	if (ref) try {
 		return resolveModel(ref);
 	} catch (err) {

package/dist/src/agent/tools/session-search-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-search-tool.js","names":[],"sources":["../../../../src/agent/tools/session-search-tool.ts"],"sourcesContent":["// Cross-session transcript search + optional LLM summaries\nimport { Type } from '@sinclair/typebox';\nimport type { AgentMessage, AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { readAgentMessageContent } from '../memory/agent-message-access.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('Agent:SessionSearch');\n\nconst MAX_SUMMARY_CHARS = 20_000;\n\nfunction resolveSummaryModel(getConfig?: () => Config | undefined) {\n  const envRef = process.env.XOPC_SESSION_SEARCH_MODEL?.trim();\n  const configRef = getConfig?.()?.agents?.defaults?.sessionSearch?.summaryModel?.trim();\n  const ref = envRef || configRef;\n  if (ref) {\n    try {\n      return resolveModel(ref);\n    } catch (err) {\n      log.warn({ err, ref }, 'session_search: summary model resolve failed, using fallback');\n    }\n  }\n  try {\n    return resolveModel('openai/gpt-4o-mini');\n  } catch {\n    const d = getDefaultModelSync(getConfig?.());\n    return resolveModel(d);\n  }\n}\n\nfunction extractTextFromContent(content: unknown): string {\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return '';\n  }\n  const parts: string[] = [];\n  for (const item of content) {\n    if (typeof item !== 'object' || item === null || !('type' in item)) {\n      continue;\n    }\n    const c = item as { type?: string; text?: string };\n    if (c.type === 'text' && typeof c.text === 'string') {\n      parts.push(c.text);\n    }\n  }\n  return parts.join(' ');\n}\n\nfunction formatMessagesForSummary(messages: AgentMessage[]): string {\n  const lines: string[] = [];\n  let total = 0;\n  for (const msg of messages) {\n    const role = String(msg.role || 'unknown').toUpperCase();\n    const text = extractTextFromContent(readAgentMessageContent(msg));\n    const line = `${role}: ${text}`;\n    if (total + line.length > MAX_SUMMARY_CHARS) {\n      lines.push('… [truncated]');\n      break;\n    }\n    lines.push(line);\n    total += line.length + 1;\n  }\n  return lines.join('\\n\\n');\n}\n\nasync function summarizeSession(\n  messages: AgentMessage[],\n  query: string,\n  getConfig: (() => Config | undefined) | undefined,\n  signal: AbortSignal | undefined,\n  logMeta?: { summarizingSessionKey: string },\n): Promise<string> {\n  if (messages.length === 0) {\n    return 'No messages in session.';\n  }\n\n  const formatted = formatMessagesForSummary(messages);\n  const prompt = `Summarize this conversation for someone searching with: \"${query}\". Focus on facts, decisions, and names. Max 200 words. Use the same language as the conversation when possible.\n\nConversation:\n${formatted}`;\n\n  const userMsg: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n  const model = resolveSummaryModel(getConfig);\n\n  try {\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: 400,\n        temperature: 0.15,\n        signal: signal as AbortSignal,\n      },\n    );\n\n    let text = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          text += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n    return text.trim() || '[Empty summary]';\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    log.warn(\n      {\n        err,\n        summarizingSessionKey: logMeta?.summarizingSessionKey,\n        queryLength: query.length,\n        messageCount: messages.length,\n      },\n      `session_search LLM summarization failed${logMeta?.summarizingSessionKey ? ` (session ${logMeta.summarizingSessionKey})` : ''}: ${msg}`,\n    );\n    return `[Summarization failed: ${msg}]`;\n  }\n}\n\nconst SessionSearchSchema = Type.Object({\n  query: Type.Optional(\n    Type.String({ description: 'Keyword search over past sessions. Omit to list recent sessions.' }),\n  ),\n  roleFilter: Type.Optional(\n    Type.Union([\n      Type.Literal('user'),\n      Type.Literal('assistant'),\n      Type.Literal('system'),\n      Type.Literal('tool'),\n      Type.Literal('toolResult'),\n    ]),\n  ),\n  limit: Type.Optional(Type.Number({ minimum: 1, maximum: 15 })),\n  excludeSessionKey: Type.Optional(\n    Type.String({ description: 'Exclude this session key from keyword results (default: current chat).' }),\n  ),\n});\n\nexport interface SessionSearchToolDeps {\n  getSessionStore: () => SessionStore;\n  getConfig?: () => Config | undefined;\n  getCurrentSessionKey?: () => string | undefined;\n}\n\ntype SessionSearchParams = {\n  query?: string;\n  roleFilter?: 'user' | 'assistant' | 'system' | 'tool' | 'toolResult';\n  limit?: number;\n  excludeSessionKey?: string;\n};\n\nexport function createSessionSearchTool(deps: SessionSearchToolDeps): AgentTool {\n  return {\n    name: 'session_search',\n    label: 'Session search',\n    description:\n      'Search other chat sessions by keywords and get short summaries, or omit `query` to list recent sessions (no LLM cost). Uses the same session store as the gateway. Narrow with roleFilter if needed.',\n    parameters: SessionSearchSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const p = params as SessionSearchParams;\n      const store = deps.getSessionStore();\n      const limit = Math.min(15, Math.max(1, p.limit ?? 5));\n      const query = p.query?.trim() ?? '';\n\n      try {\n        if (!query) {\n          const listed = await store.list({\n            limit: limit + 5,\n            sortBy: 'updatedAt',\n            sortOrder: 'desc',\n          });\n          const items = listed.items.slice(0, limit).map((s) => ({\n            key: s.key,\n            name: s.name,\n            updatedAt: s.updatedAt,\n            messageCount: s.messageCount,\n            sourceChannel: s.sourceChannel,\n          }));\n\n          return {\n            content: [\n              {\n                type: 'text',\n                text: JSON.stringify(\n                  { success: true, mode: 'recent', results: items, total: listed.total },\n                  null,\n                  2,\n                ),\n              },\n            ],\n            details: { mode: 'recent', items },\n          };\n        }\n\n        const listed = await store.list({\n          search: query,\n          limit: limit + 10,\n          sortBy: 'updatedAt',\n          sortOrder: 'desc',\n        });\n        let matches = listed.items.map((item) => ({ key: item.key, score: 1 }));\n\n        const exclude = p.excludeSessionKey?.trim() || deps.getCurrentSessionKey?.() || '';\n        if (exclude) {\n          matches = matches.filter((m) => m.key !== exclude);\n        }\n\n        const top = matches.slice(0, limit);\n\n        const summaries = await Promise.all(\n          top.map(async ({ key, score }) => {\n            let messages = await store.load(key);\n\n            if (p.roleFilter) {\n              messages = messages.filter((m) => m.role === p.roleFilter);\n            }\n\n            const summary = await summarizeSession(messages, query, deps.getConfig, signal, {\n              summarizingSessionKey: key,\n            });\n            return { sessionKey: key, score, summary };\n          }),\n        );\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: JSON.stringify(\n                {\n                  success: true,\n                  mode: 'keyword',\n                  query,\n                  results: summaries,\n                  count: summaries.length,\n                },\n                null,\n                2,\n              ),\n            },\n          ],\n          details: { query, summaries },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `session_search error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}
+{"version":3,"file":"session-search-tool.js","names":[],"sources":["../../../../src/agent/tools/session-search-tool.ts"],"sourcesContent":["// Cross-session transcript search + optional LLM summaries\nimport { Type } from '@sinclair/typebox';\nimport type { AgentMessage, AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport { readAgentMessageContent } from '../memory/agent-message-access.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('Agent:SessionSearch');\n\nconst MAX_SUMMARY_CHARS = 20_000;\n\nfunction resolveSummaryModel(getConfig?: () => Config | undefined) {\n  const envRef = process.env.XOPC_SESSION_SEARCH_MODEL?.trim();\n  const ref = envRef;\n  if (ref) {\n    try {\n      return resolveModel(ref);\n    } catch (err) {\n      log.warn({ err, ref }, 'session_search: summary model resolve failed, using fallback');\n    }\n  }\n  try {\n    return resolveModel('openai/gpt-4o-mini');\n  } catch {\n    const d = getDefaultModelSync(getConfig?.());\n    return resolveModel(d);\n  }\n}\n\nfunction extractTextFromContent(content: unknown): string {\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return '';\n  }\n  const parts: string[] = [];\n  for (const item of content) {\n    if (typeof item !== 'object' || item === null || !('type' in item)) {\n      continue;\n    }\n    const c = item as { type?: string; text?: string };\n    if (c.type === 'text' && typeof c.text === 'string') {\n      parts.push(c.text);\n    }\n  }\n  return parts.join(' ');\n}\n\nfunction formatMessagesForSummary(messages: AgentMessage[]): string {\n  const lines: string[] = [];\n  let total = 0;\n  for (const msg of messages) {\n    const role = String(msg.role || 'unknown').toUpperCase();\n    const text = extractTextFromContent(readAgentMessageContent(msg));\n    const line = `${role}: ${text}`;\n    if (total + line.length > MAX_SUMMARY_CHARS) {\n      lines.push('… [truncated]');\n      break;\n    }\n    lines.push(line);\n    total += line.length + 1;\n  }\n  return lines.join('\\n\\n');\n}\n\nasync function summarizeSession(\n  messages: AgentMessage[],\n  query: string,\n  getConfig: (() => Config | undefined) | undefined,\n  signal: AbortSignal | undefined,\n  logMeta?: { summarizingSessionKey: string },\n): Promise<string> {\n  if (messages.length === 0) {\n    return 'No messages in session.';\n  }\n\n  const formatted = formatMessagesForSummary(messages);\n  const prompt = `Summarize this conversation for someone searching with: \"${query}\". Focus on facts, decisions, and names. Max 200 words. Use the same language as the conversation when possible.\n\nConversation:\n${formatted}`;\n\n  const userMsg: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n  const model = resolveSummaryModel(getConfig);\n\n  try {\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: 400,\n        temperature: 0.15,\n        signal: signal as AbortSignal,\n      },\n    );\n\n    let text = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          text += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n    return text.trim() || '[Empty summary]';\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    log.warn(\n      {\n        err,\n        summarizingSessionKey: logMeta?.summarizingSessionKey,\n        queryLength: query.length,\n        messageCount: messages.length,\n      },\n      `session_search LLM summarization failed${logMeta?.summarizingSessionKey ? ` (session ${logMeta.summarizingSessionKey})` : ''}: ${msg}`,\n    );\n    return `[Summarization failed: ${msg}]`;\n  }\n}\n\nconst SessionSearchSchema = Type.Object({\n  query: Type.Optional(\n    Type.String({ description: 'Keyword search over past sessions. Omit to list recent sessions.' }),\n  ),\n  roleFilter: Type.Optional(\n    Type.Union([\n      Type.Literal('user'),\n      Type.Literal('assistant'),\n      Type.Literal('system'),\n      Type.Literal('tool'),\n      Type.Literal('toolResult'),\n    ]),\n  ),\n  limit: Type.Optional(Type.Number({ minimum: 1, maximum: 15 })),\n  excludeSessionKey: Type.Optional(\n    Type.String({ description: 'Exclude this session key from keyword results (default: current chat).' }),\n  ),\n});\n\nexport interface SessionSearchToolDeps {\n  getSessionStore: () => SessionStore;\n  getConfig?: () => Config | undefined;\n  getCurrentSessionKey?: () => string | undefined;\n}\n\ntype SessionSearchParams = {\n  query?: string;\n  roleFilter?: 'user' | 'assistant' | 'system' | 'tool' | 'toolResult';\n  limit?: number;\n  excludeSessionKey?: string;\n};\n\nexport function createSessionSearchTool(deps: SessionSearchToolDeps): AgentTool {\n  return {\n    name: 'session_search',\n    label: 'Session search',\n    description:\n      'Search other chat sessions by keywords and get short summaries, or omit `query` to list recent sessions (no LLM cost). Uses the same session store as the gateway. Narrow with roleFilter if needed.',\n    parameters: SessionSearchSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      const p = params as SessionSearchParams;\n      const store = deps.getSessionStore();\n      const limit = Math.min(15, Math.max(1, p.limit ?? 5));\n      const query = p.query?.trim() ?? '';\n\n      try {\n        if (!query) {\n          const listed = await store.list({\n            limit: limit + 5,\n            sortBy: 'updatedAt',\n            sortOrder: 'desc',\n          });\n          const items = listed.items.slice(0, limit).map((s) => ({\n            key: s.key,\n            name: s.name,\n            updatedAt: s.updatedAt,\n            messageCount: s.messageCount,\n            sourceChannel: s.sourceChannel,\n          }));\n\n          return {\n            content: [\n              {\n                type: 'text',\n                text: JSON.stringify(\n                  { success: true, mode: 'recent', results: items, total: listed.total },\n                  null,\n                  2,\n                ),\n              },\n            ],\n            details: { mode: 'recent', items },\n          };\n        }\n\n        const listed = await store.list({\n          search: query,\n          limit: limit + 10,\n          sortBy: 'updatedAt',\n          sortOrder: 'desc',\n        });\n        let matches = listed.items.map((item) => ({ key: item.key, score: 1 }));\n\n        const exclude = p.excludeSessionKey?.trim() || deps.getCurrentSessionKey?.() || '';\n        if (exclude) {\n          matches = matches.filter((m) => m.key !== exclude);\n        }\n\n        const top = matches.slice(0, limit);\n\n        const summaries = await Promise.all(\n          top.map(async ({ key, score }) => {\n            let messages = await store.load(key);\n\n            if (p.roleFilter) {\n              messages = messages.filter((m) => m.role === p.roleFilter);\n            }\n\n            const summary = await summarizeSession(messages, query, deps.getConfig, signal, {\n              summarizingSessionKey: key,\n            });\n            return { sessionKey: key, score, summary };\n          }),\n        );\n\n        return {\n          content: [\n            {\n              type: 'text',\n              text: JSON.stringify(\n                {\n                  success: true,\n                  mode: 'keyword',\n                  query,\n                  results: summaries,\n                  count: summaries.length,\n                },\n                null,\n                2,\n              ),\n            },\n          ],\n          details: { query, summaries },\n        };\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        return {\n          content: [{ type: 'text', text: `session_search error: ${message}` }],\n          details: { error: message },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}

package/dist/src/agent/tools/web-extract.js

@@ -44,9 +44,7 @@ function stripHtmlBoilerplate(html, maxRaw = MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT)
 	return cleaned;
 }
 function resolveExtractionModel(config) {
-	const envRef = process.env.XOPC_WEB_EXTRACT_MODEL?.trim();
-	const configRef = typeof config?.agents?.defaults?.webExtract?.model === "string" ? config.agents.defaults.webExtract.model.trim() : "";
-	const ref = envRef || configRef;
+	const ref = process.env.XOPC_WEB_EXTRACT_MODEL?.trim();
 	if (ref) try {
 		return resolveModel(ref);
 	} catch {}
@@ -195,6 +193,10 @@ async function synthesizeChunkSummaries(summaries, url, instruction, maxLength,
 		return fallback.length > outputCap ? fallback.slice(0, outputCap) + "\n\n[...truncated due to synthesis failure]" : fallback;
 	}
 }
+function resolveConfiguredMaxLength(config) {
+	const value = (config?.agents)?.defaults?.webExtract?.maxLength;
+	return typeof value === "number" && Number.isFinite(value) && value > 0 ? Math.trunc(value) : DEFAULT_WEB_EXTRACT_MAX_LENGTH;
+}
 function createWebExtractTool(deps) {
 	return {
 		name: "web_extract",
@@ -204,8 +206,7 @@ function createWebExtractTool(deps) {
 		async execute(_toolCallId, params, signal) {
 			const { url, instruction } = params;
 			const cfg = deps.getConfig();
-			const configuredDefault = cfg?.agents?.defaults?.webExtract?.maxLength ?? 15e3;
-			const maxLength = params.maxLength ?? configuredDefault;
+			const maxLength = params.maxLength ?? resolveConfiguredMaxLength(cfg);
 			try {
 				const safety = checkUrlSafety(url);
 				if (!safety.safe) return {

package/dist/src/agent/tools/web-extract.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-extract.js","names":[],"sources":["../../../../src/agent/tools/web-extract.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { checkUrlSafety, checkWebsiteBlocklist, cleanBase64Images } from './url-safety.js';\n\nconst log = createLogger('web-extract');\n\nexport const DEFAULT_WEB_EXTRACT_MAX_LENGTH = 15_000;\nexport const MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT = 200_000;\nconst EXTRACTION_TIMEOUT_MS = 30_000;\n\n// Large-document chunked processing thresholds (inspired by hermes-agent)\nconst MAX_CONTENT_SIZE = 2_000_000;   // 2M chars — refuse entirely above this\nconst CHUNK_THRESHOLD = 500_000;      // 500k chars — use chunked processing above this\nconst CHUNK_SIZE = 100_000;           // 100k chars per chunk\nconst MAX_OUTPUT_SIZE = 15_000;       // Hard cap on final output size\n\nconst WebExtractSchema = Type.Object({\n  url: Type.String({ description: 'URL to extract content from' }),\n  instruction: Type.Optional(\n    Type.String({\n      description:\n        'What to extract or focus on. Examples: \"main article text\", ' +\n        '\"pricing table\", \"API documentation for the auth endpoint\". ' +\n        'If omitted, extracts the main content.',\n    }),\n  ),\n  maxLength: Type.Optional(\n    Type.Number({\n      description: 'Maximum characters in the extracted content (default: from config or 15000)',\n    }),\n  ),\n});\n\nexport interface WebExtractDeps {\n  getConfig: () => Config | undefined;\n}\n\nasync function fetchPageContent(url: string, signal?: AbortSignal): Promise<string> {\n  const response = await fetch(url, {\n    signal,\n    headers: {\n      'User-Agent': 'Mozilla/5.0 (compatible; xopc/1.0)',\n      Accept: 'text/html,application/xhtml+xml,text/plain,application/json',\n    },\n    redirect: 'follow',\n  });\n\n  if (!response.ok) {\n    throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n  }\n\n  const contentType = response.headers.get('content-type') ?? '';\n  if (contentType.includes('application/json')) {\n    const json: unknown = await response.json();\n    return JSON.stringify(json, null, 2);\n  }\n\n  return await response.text();\n}\n\nexport function stripHtmlBoilerplate(\n  html: string,\n  maxRaw = MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT,\n): string {\n  let cleaned = html\n    .replace(/<script[\\s\\S]*?<\\/script>/gi, '')\n    .replace(/<style[\\s\\S]*?<\\/style>/gi, '')\n    .replace(/<svg[\\s\\S]*?<\\/svg>/gi, '')\n    .replace(/<noscript[\\s\\S]*?<\\/noscript>/gi, '')\n    .replace(/<!--[\\s\\S]*?-->/g, '');\n\n  // Remove base64 images early to avoid wasting characters on them\n  cleaned = cleanBase64Images(cleaned);\n  cleaned = cleaned.replace(/\\s+/g, ' ').trim();\n\n  if (cleaned.length > maxRaw) {\n    cleaned = cleaned.slice(0, maxRaw) + '\\n\\n[...truncated]';\n  }\n\n  return cleaned;\n}\n\nfunction resolveExtractionModel(config?: Config) {\n  const envRef = process.env.XOPC_WEB_EXTRACT_MODEL?.trim();\n  const configRef =\n    typeof config?.agents?.defaults?.webExtract?.model === 'string'\n      ? config.agents.defaults.webExtract.model.trim()\n      : '';\n  const ref = envRef || configRef;\n\n  if (ref) {\n    try {\n      return resolveModel(ref);\n    } catch {\n      /* fall through */\n    }\n  }\n\n  for (const candidate of ['openai/gpt-4o-mini', 'google/gemini-2.0-flash']) {\n    try {\n      return resolveModel(candidate);\n    } catch {\n      /* next */\n    }\n  }\n\n  return resolveModel(getDefaultModelSync(config));\n}\n\nfunction buildExtractionSystemPrompt(maxLength: number): string {\n  return (\n    'You are a web content extractor. Given raw HTML/text from a web page, ' +\n    'extract the relevant content as clean, well-structured markdown.\\n\\n' +\n    'Rules:\\n' +\n    '- Remove navigation, headers, footers, ads, cookie banners, sidebars\\n' +\n    '- Preserve the main content structure (headings, lists, tables, code blocks)\\n' +\n    '- Keep URLs for important links\\n' +\n    '- If the page has structured data (tables, specs), preserve the structure\\n' +\n    `- Keep output under ${maxLength} characters\\n` +\n    '- If content is truncated, note what was cut\\n' +\n    '- Output ONLY the extracted content, no meta-commentary'\n  );\n}\n\n// ---------------------------------------------------------------------------\n// LLM call helper — shared by single-pass and chunked extraction\n// ---------------------------------------------------------------------------\n\nfunction buildTimeoutSignal(signal: AbortSignal | undefined): AbortSignal | undefined {\n  const timeoutSignal =\n    typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function'\n      ? AbortSignal.timeout(EXTRACTION_TIMEOUT_MS)\n      : undefined;\n  if (signal && timeoutSignal && typeof AbortSignal.any === 'function') {\n    return AbortSignal.any([signal, timeoutSignal]);\n  }\n  return signal ?? timeoutSignal;\n}\n\nfunction extractTextFromCompletion(result: { content?: unknown }): string {\n  let text = '';\n  if (Array.isArray(result.content)) {\n    for (const c of result.content) {\n      if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n        text += String((c as { text?: string }).text || '');\n      }\n    }\n  }\n  return text.trim();\n}\n\nasync function callExtractionLlm(\n  systemPrompt: string,\n  userPrompt: string,\n  maxTokens: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n): Promise<string> {\n  const model = resolveExtractionModel(config);\n  const userMsg: UserMessage = {\n    role: 'user',\n    content: `${systemPrompt}\\n\\n---\\n\\n${userPrompt}`,\n    timestamp: Date.now(),\n  };\n\n  const result = await complete(\n    model,\n    { messages: [userMsg] },\n    {\n      maxTokens,\n      temperature: 0.2,\n      signal: buildTimeoutSignal(signal) as AbortSignal,\n    },\n  );\n\n  return extractTextFromCompletion(result);\n}\n\n// ---------------------------------------------------------------------------\n// Single-pass extraction (content < CHUNK_THRESHOLD)\n// ---------------------------------------------------------------------------\n\nasync function extractWithLlm(\n  rawContent: string,\n  url: string,\n  instruction: string | undefined,\n  maxLength: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n): Promise<string> {\n  const contentLength = rawContent.length;\n\n  // Refuse absurdly large content\n  if (contentLength > MAX_CONTENT_SIZE) {\n    const sizeMb = (contentLength / 1_000_000).toFixed(1);\n    return (\n      `[Content too large to process: ${sizeMb}MB. ` +\n      'Try using web_fetch for raw text, or search for a more focused source.]'\n    );\n  }\n\n  // Route to chunked processing for large documents\n  if (contentLength > CHUNK_THRESHOLD) {\n    log.info(\n      { url, contentLength, chunkSize: CHUNK_SIZE },\n      'Large document detected, using chunked extraction',\n    );\n    return extractLargeDocumentChunked(rawContent, url, instruction, maxLength, config, signal);\n  }\n\n  // Standard single-pass extraction\n  const systemPrompt = buildExtractionSystemPrompt(maxLength);\n  const body = instruction\n    ? `Extract from this page (${url}):\\n\\nFOCUS: ${instruction}\\n\\n---\\n\\n${rawContent}`\n    : `Extract the main content from this page (${url}):\\n\\n---\\n\\n${rawContent}`;\n\n  const text = await callExtractionLlm(\n    systemPrompt,\n    body,\n    Math.min(Math.ceil(maxLength / 3), 8000),\n    config,\n    signal,\n  );\n\n  if (!text) return 'No content could be extracted.';\n\n  const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n  if (text.length > outputCap) {\n    return text.slice(0, outputCap) + '\\n\\n[...output truncated to maxLength]';\n  }\n\n  log.debug(\n    { url, originalChars: contentLength, extractedChars: text.length },\n    'Single-pass extraction complete',\n  );\n  return text;\n}\n\n// ---------------------------------------------------------------------------\n// Chunked extraction for large documents (inspired by hermes-agent)\n//\n// Flow: split → parallel chunk summaries → synthesis pass\n// ---------------------------------------------------------------------------\n\nasync function extractLargeDocumentChunked(\n  content: string,\n  url: string,\n  instruction: string | undefined,\n  maxLength: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n): Promise<string> {\n  // Split content into chunks\n  const chunks: string[] = [];\n  for (let offset = 0; offset < content.length; offset += CHUNK_SIZE) {\n    chunks.push(content.slice(offset, offset + CHUNK_SIZE));\n  }\n  log.info({ url, chunkCount: chunks.length, chunkSize: CHUNK_SIZE }, 'Split into chunks');\n\n  // Summarize each chunk in parallel\n  const chunkPromises = chunks.map(async (chunk, index) => {\n    const chunkLabel = `[Chunk ${index + 1}/${chunks.length}]`;\n    try {\n      const systemPrompt =\n        'You are an expert content analyst processing a SECTION of a larger document. ' +\n        'Extract and summarize the key information from THIS SECTION ONLY.\\n\\n' +\n        'Guidelines:\\n' +\n        '- Do NOT write introductions or conclusions — this is a partial document\\n' +\n        '- Extract ALL key facts, figures, data points, and insights\\n' +\n        '- Preserve important quotes, code snippets, and specific details verbatim\\n' +\n        '- Use bullet points and structured formatting\\n' +\n        '- Note references to other sections without trying to resolve them';\n\n      const focusLine = instruction ? `\\nFOCUS: ${instruction}\\n` : '';\n      const userPrompt =\n        `${chunkLabel} Extract key information from this section of ${url}:` +\n        `${focusLine}\\n\\n${chunk}`;\n\n      const summary = await callExtractionLlm(systemPrompt, userPrompt, 6000, config, signal);\n      if (summary) {\n        log.debug(\n          { url, chunk: index + 1, originalChars: chunk.length, summaryChars: summary.length },\n          'Chunk summarized',\n        );\n      }\n      return { index, summary: summary || null };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      log.warn({ url, chunk: index + 1, error: message }, 'Chunk summarization failed');\n      return { index, summary: null };\n    }\n  });\n\n  const chunkResults = await Promise.all(chunkPromises);\n\n  // Collect successful summaries in order\n  const summaries: string[] = [];\n  for (const { index, summary } of chunkResults.sort((a, b) => a.index - b.index)) {\n    if (summary) {\n      summaries.push(`## Section ${index + 1}\\n${summary}`);\n    }\n  }\n\n  if (summaries.length === 0) {\n    // All chunks failed — fall back to truncated raw content\n    const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n    const truncated = content.slice(0, outputCap);\n    return truncated + '\\n\\n[...all chunk summaries failed; showing truncated raw content]';\n  }\n\n  log.info(\n    { url, successfulChunks: summaries.length, totalChunks: chunks.length },\n    'Chunk summaries collected, synthesizing',\n  );\n\n  // Single chunk — return directly\n  if (summaries.length === 1) {\n    const result = summaries[0];\n    const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n    return result.length > outputCap\n      ? result.slice(0, outputCap) + '\\n\\n[...truncated]'\n      : result;\n  }\n\n  // Synthesize multiple chunk summaries into one cohesive summary\n  return synthesizeChunkSummaries(summaries, url, instruction, maxLength, config, signal, content.length);\n}\n\nasync function synthesizeChunkSummaries(\n  summaries: string[],\n  url: string,\n  instruction: string | undefined,\n  maxLength: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n  originalContentLength: number,\n): Promise<string> {\n  const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n\n  const systemPrompt =\n    'You synthesize multiple section summaries into one cohesive, comprehensive summary. ' +\n    'Remove redundancy, preserve all key facts and actionable information, ' +\n    'and organize with clear markdown structure.';\n\n  const focusLine = instruction ? `\\nFOCUS: ${instruction}\\n` : '';\n  const combined = summaries.join('\\n\\n---\\n\\n');\n  const userPrompt =\n    `Synthesize these section summaries from ${url} into ONE unified markdown summary ` +\n    `(under ${outputCap} characters):${focusLine}\\n\\n${combined}`;\n\n  try {\n    const synthesized = await callExtractionLlm(systemPrompt, userPrompt, 8000, config, signal);\n\n    if (!synthesized) {\n      // Synthesis LLM returned empty — fall back to concatenation\n      log.warn({ url }, 'Synthesis returned empty, concatenating chunk summaries');\n      const fallback = summaries.join('\\n\\n');\n      return fallback.length > outputCap\n        ? fallback.slice(0, outputCap) + '\\n\\n[...truncated]'\n        : fallback;\n    }\n\n    const finalOutput = synthesized.length > outputCap\n      ? synthesized.slice(0, outputCap) + '\\n\\n[...summary truncated for context management]'\n      : synthesized;\n\n    const compressionRatio = finalOutput.length / originalContentLength;\n    log.info(\n      {\n        url,\n        originalChars: originalContentLength,\n        extractedChars: finalOutput.length,\n        compressionPercent: `${(compressionRatio * 100).toFixed(1)}%`,\n      },\n      'Chunked extraction complete',\n    );\n\n    return finalOutput;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    log.warn({ url, error: message }, 'Synthesis failed, concatenating chunk summaries');\n    const fallback = summaries.join('\\n\\n');\n    return fallback.length > outputCap\n      ? fallback.slice(0, outputCap) + '\\n\\n[...truncated due to synthesis failure]'\n      : fallback;\n  }\n}\n\ntype WebExtractParams = { url: string; instruction?: string; maxLength?: number };\n\nexport function createWebExtractTool(deps: WebExtractDeps): AgentTool {\n  return {\n    name: 'web_extract',\n    label: '📄 Web Extract',\n    description:\n      'Extract and summarize content from a web page using LLM-powered extraction.\\n\\n' +\n      'Unlike web_fetch (which returns cleaned plain text from HTML), this tool uses a ' +\n      'dedicated model pass to produce focused markdown. Use when you need semantic extraction ' +\n      'or a specific focus (instruction), not just a single readability pass.\\n\\n' +\n      'WHEN TO USE:\\n' +\n      '- Reading articles, blog posts, documentation\\n' +\n      '- Extracting specific data (pricing, specs, API docs)\\n' +\n      '- Summarizing long pages to save context\\n\\n' +\n      'WHEN TO USE web_fetch INSTEAD:\\n' +\n      '- Inspecting raw-ish page text quickly without an extra LLM call\\n' +\n      '- Downloading JSON/API responses\\n' +\n      '- Debugging page rendering issues',\n    parameters: WebExtractSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      signal?: AbortSignal,\n    ): Promise<AgentToolResult<{ url: string; extractedLength: number }>> {\n      const { url, instruction } = params as WebExtractParams;\n      const cfg = deps.getConfig();\n      const configuredDefault =\n        cfg?.agents?.defaults?.webExtract?.maxLength ?? DEFAULT_WEB_EXTRACT_MAX_LENGTH;\n      const maxLength = (params as WebExtractParams).maxLength ?? configuredDefault;\n\n      try {\n        // SSRF protection\n        const safety = checkUrlSafety(url);\n        if (!safety.safe) {\n          return {\n            content: [{ type: 'text', text: `Blocked: ${safety.reason}` }],\n            details: { url, extractedLength: 0 },\n          };\n        }\n\n        // Website blocklist check\n        const blocked = checkWebsiteBlocklist(url, cfg?.tools?.web?.blocklist);\n        if (blocked) {\n          return {\n            content: [{ type: 'text', text: `Blocked: ${blocked.message}` }],\n            details: { url, extractedLength: 0 },\n          };\n        }\n\n        const rawContent = await fetchPageContent(url, signal);\n        const cleaned = stripHtmlBoilerplate(rawContent);\n        const trimmed = cleaned.trim();\n        const looksStructured = trimmed.startsWith('{') || trimmed.startsWith('[');\n        if (trimmed.length < 100 && !looksStructured) {\n          return {\n            content: [\n              { type: 'text', text: `Page at ${url} appears to have no extractable content.` },\n            ],\n            details: { url, extractedLength: 0 },\n          };\n        }\n\n        const extracted = await extractWithLlm(\n          cleaned,\n          url,\n          instruction,\n          maxLength,\n          cfg,\n          signal,\n        );\n\n        return {\n          content: [{ type: 'text', text: extracted }],\n          details: { url, extractedLength: extracted.length },\n        };\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        log.warn({ url, error: message }, 'web_extract failed');\n        return {\n          content: [{ type: 'text', text: `Failed to extract content from ${url}: ${message}` }],\n          details: { url, extractedLength: 0 },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}
+{"version":3,"file":"web-extract.js","names":[],"sources":["../../../../src/agent/tools/web-extract.ts"],"sourcesContent":["import { Type } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai';\n\nimport type { Config } from '../../config/schema.js';\nimport { getDefaultModelSync, resolveModel } from '../../providers/index.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { checkUrlSafety, checkWebsiteBlocklist, cleanBase64Images } from './url-safety.js';\n\nconst log = createLogger('web-extract');\n\nexport const DEFAULT_WEB_EXTRACT_MAX_LENGTH = 15_000;\nexport const MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT = 200_000;\nconst EXTRACTION_TIMEOUT_MS = 30_000;\n\n// Large-document chunked processing thresholds (inspired by hermes-agent)\nconst MAX_CONTENT_SIZE = 2_000_000;   // 2M chars — refuse entirely above this\nconst CHUNK_THRESHOLD = 500_000;      // 500k chars — use chunked processing above this\nconst CHUNK_SIZE = 100_000;           // 100k chars per chunk\nconst MAX_OUTPUT_SIZE = 15_000;       // Hard cap on final output size\n\nconst WebExtractSchema = Type.Object({\n  url: Type.String({ description: 'URL to extract content from' }),\n  instruction: Type.Optional(\n    Type.String({\n      description:\n        'What to extract or focus on. Examples: \"main article text\", ' +\n        '\"pricing table\", \"API documentation for the auth endpoint\". ' +\n        'If omitted, extracts the main content.',\n    }),\n  ),\n  maxLength: Type.Optional(\n    Type.Number({\n      description: 'Maximum characters in the extracted content (default: from config or 15000)',\n    }),\n  ),\n});\n\nexport interface WebExtractDeps {\n  getConfig: () => Config | undefined;\n}\n\nasync function fetchPageContent(url: string, signal?: AbortSignal): Promise<string> {\n  const response = await fetch(url, {\n    signal,\n    headers: {\n      'User-Agent': 'Mozilla/5.0 (compatible; xopc/1.0)',\n      Accept: 'text/html,application/xhtml+xml,text/plain,application/json',\n    },\n    redirect: 'follow',\n  });\n\n  if (!response.ok) {\n    throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n  }\n\n  const contentType = response.headers.get('content-type') ?? '';\n  if (contentType.includes('application/json')) {\n    const json: unknown = await response.json();\n    return JSON.stringify(json, null, 2);\n  }\n\n  return await response.text();\n}\n\nexport function stripHtmlBoilerplate(\n  html: string,\n  maxRaw = MAX_RAW_HTML_CHARS_FOR_WEB_EXTRACT,\n): string {\n  let cleaned = html\n    .replace(/<script[\\s\\S]*?<\\/script>/gi, '')\n    .replace(/<style[\\s\\S]*?<\\/style>/gi, '')\n    .replace(/<svg[\\s\\S]*?<\\/svg>/gi, '')\n    .replace(/<noscript[\\s\\S]*?<\\/noscript>/gi, '')\n    .replace(/<!--[\\s\\S]*?-->/g, '');\n\n  // Remove base64 images early to avoid wasting characters on them\n  cleaned = cleanBase64Images(cleaned);\n  cleaned = cleaned.replace(/\\s+/g, ' ').trim();\n\n  if (cleaned.length > maxRaw) {\n    cleaned = cleaned.slice(0, maxRaw) + '\\n\\n[...truncated]';\n  }\n\n  return cleaned;\n}\n\nfunction resolveExtractionModel(config?: Config) {\n  const envRef = process.env.XOPC_WEB_EXTRACT_MODEL?.trim();\n  const ref = envRef;\n\n  if (ref) {\n    try {\n      return resolveModel(ref);\n    } catch {\n      /* fall through */\n    }\n  }\n\n  for (const candidate of ['openai/gpt-4o-mini', 'google/gemini-2.0-flash']) {\n    try {\n      return resolveModel(candidate);\n    } catch {\n      /* next */\n    }\n  }\n\n  return resolveModel(getDefaultModelSync(config));\n}\n\nfunction buildExtractionSystemPrompt(maxLength: number): string {\n  return (\n    'You are a web content extractor. Given raw HTML/text from a web page, ' +\n    'extract the relevant content as clean, well-structured markdown.\\n\\n' +\n    'Rules:\\n' +\n    '- Remove navigation, headers, footers, ads, cookie banners, sidebars\\n' +\n    '- Preserve the main content structure (headings, lists, tables, code blocks)\\n' +\n    '- Keep URLs for important links\\n' +\n    '- If the page has structured data (tables, specs), preserve the structure\\n' +\n    `- Keep output under ${maxLength} characters\\n` +\n    '- If content is truncated, note what was cut\\n' +\n    '- Output ONLY the extracted content, no meta-commentary'\n  );\n}\n\n// ---------------------------------------------------------------------------\n// LLM call helper — shared by single-pass and chunked extraction\n// ---------------------------------------------------------------------------\n\nfunction buildTimeoutSignal(signal: AbortSignal | undefined): AbortSignal | undefined {\n  const timeoutSignal =\n    typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function'\n      ? AbortSignal.timeout(EXTRACTION_TIMEOUT_MS)\n      : undefined;\n  if (signal && timeoutSignal && typeof AbortSignal.any === 'function') {\n    return AbortSignal.any([signal, timeoutSignal]);\n  }\n  return signal ?? timeoutSignal;\n}\n\nfunction extractTextFromCompletion(result: { content?: unknown }): string {\n  let text = '';\n  if (Array.isArray(result.content)) {\n    for (const c of result.content) {\n      if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n        text += String((c as { text?: string }).text || '');\n      }\n    }\n  }\n  return text.trim();\n}\n\nasync function callExtractionLlm(\n  systemPrompt: string,\n  userPrompt: string,\n  maxTokens: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n): Promise<string> {\n  const model = resolveExtractionModel(config);\n  const userMsg: UserMessage = {\n    role: 'user',\n    content: `${systemPrompt}\\n\\n---\\n\\n${userPrompt}`,\n    timestamp: Date.now(),\n  };\n\n  const result = await complete(\n    model,\n    { messages: [userMsg] },\n    {\n      maxTokens,\n      temperature: 0.2,\n      signal: buildTimeoutSignal(signal) as AbortSignal,\n    },\n  );\n\n  return extractTextFromCompletion(result);\n}\n\n// ---------------------------------------------------------------------------\n// Single-pass extraction (content < CHUNK_THRESHOLD)\n// ---------------------------------------------------------------------------\n\nasync function extractWithLlm(\n  rawContent: string,\n  url: string,\n  instruction: string | undefined,\n  maxLength: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n): Promise<string> {\n  const contentLength = rawContent.length;\n\n  // Refuse absurdly large content\n  if (contentLength > MAX_CONTENT_SIZE) {\n    const sizeMb = (contentLength / 1_000_000).toFixed(1);\n    return (\n      `[Content too large to process: ${sizeMb}MB. ` +\n      'Try using web_fetch for raw text, or search for a more focused source.]'\n    );\n  }\n\n  // Route to chunked processing for large documents\n  if (contentLength > CHUNK_THRESHOLD) {\n    log.info(\n      { url, contentLength, chunkSize: CHUNK_SIZE },\n      'Large document detected, using chunked extraction',\n    );\n    return extractLargeDocumentChunked(rawContent, url, instruction, maxLength, config, signal);\n  }\n\n  // Standard single-pass extraction\n  const systemPrompt = buildExtractionSystemPrompt(maxLength);\n  const body = instruction\n    ? `Extract from this page (${url}):\\n\\nFOCUS: ${instruction}\\n\\n---\\n\\n${rawContent}`\n    : `Extract the main content from this page (${url}):\\n\\n---\\n\\n${rawContent}`;\n\n  const text = await callExtractionLlm(\n    systemPrompt,\n    body,\n    Math.min(Math.ceil(maxLength / 3), 8000),\n    config,\n    signal,\n  );\n\n  if (!text) return 'No content could be extracted.';\n\n  const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n  if (text.length > outputCap) {\n    return text.slice(0, outputCap) + '\\n\\n[...output truncated to maxLength]';\n  }\n\n  log.debug(\n    { url, originalChars: contentLength, extractedChars: text.length },\n    'Single-pass extraction complete',\n  );\n  return text;\n}\n\n// ---------------------------------------------------------------------------\n// Chunked extraction for large documents (inspired by hermes-agent)\n//\n// Flow: split → parallel chunk summaries → synthesis pass\n// ---------------------------------------------------------------------------\n\nasync function extractLargeDocumentChunked(\n  content: string,\n  url: string,\n  instruction: string | undefined,\n  maxLength: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n): Promise<string> {\n  // Split content into chunks\n  const chunks: string[] = [];\n  for (let offset = 0; offset < content.length; offset += CHUNK_SIZE) {\n    chunks.push(content.slice(offset, offset + CHUNK_SIZE));\n  }\n  log.info({ url, chunkCount: chunks.length, chunkSize: CHUNK_SIZE }, 'Split into chunks');\n\n  // Summarize each chunk in parallel\n  const chunkPromises = chunks.map(async (chunk, index) => {\n    const chunkLabel = `[Chunk ${index + 1}/${chunks.length}]`;\n    try {\n      const systemPrompt =\n        'You are an expert content analyst processing a SECTION of a larger document. ' +\n        'Extract and summarize the key information from THIS SECTION ONLY.\\n\\n' +\n        'Guidelines:\\n' +\n        '- Do NOT write introductions or conclusions — this is a partial document\\n' +\n        '- Extract ALL key facts, figures, data points, and insights\\n' +\n        '- Preserve important quotes, code snippets, and specific details verbatim\\n' +\n        '- Use bullet points and structured formatting\\n' +\n        '- Note references to other sections without trying to resolve them';\n\n      const focusLine = instruction ? `\\nFOCUS: ${instruction}\\n` : '';\n      const userPrompt =\n        `${chunkLabel} Extract key information from this section of ${url}:` +\n        `${focusLine}\\n\\n${chunk}`;\n\n      const summary = await callExtractionLlm(systemPrompt, userPrompt, 6000, config, signal);\n      if (summary) {\n        log.debug(\n          { url, chunk: index + 1, originalChars: chunk.length, summaryChars: summary.length },\n          'Chunk summarized',\n        );\n      }\n      return { index, summary: summary || null };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      log.warn({ url, chunk: index + 1, error: message }, 'Chunk summarization failed');\n      return { index, summary: null };\n    }\n  });\n\n  const chunkResults = await Promise.all(chunkPromises);\n\n  // Collect successful summaries in order\n  const summaries: string[] = [];\n  for (const { index, summary } of chunkResults.sort((a, b) => a.index - b.index)) {\n    if (summary) {\n      summaries.push(`## Section ${index + 1}\\n${summary}`);\n    }\n  }\n\n  if (summaries.length === 0) {\n    // All chunks failed — fall back to truncated raw content\n    const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n    const truncated = content.slice(0, outputCap);\n    return truncated + '\\n\\n[...all chunk summaries failed; showing truncated raw content]';\n  }\n\n  log.info(\n    { url, successfulChunks: summaries.length, totalChunks: chunks.length },\n    'Chunk summaries collected, synthesizing',\n  );\n\n  // Single chunk — return directly\n  if (summaries.length === 1) {\n    const result = summaries[0];\n    const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n    return result.length > outputCap\n      ? result.slice(0, outputCap) + '\\n\\n[...truncated]'\n      : result;\n  }\n\n  // Synthesize multiple chunk summaries into one cohesive summary\n  return synthesizeChunkSummaries(summaries, url, instruction, maxLength, config, signal, content.length);\n}\n\nasync function synthesizeChunkSummaries(\n  summaries: string[],\n  url: string,\n  instruction: string | undefined,\n  maxLength: number,\n  config: Config | undefined,\n  signal: AbortSignal | undefined,\n  originalContentLength: number,\n): Promise<string> {\n  const outputCap = Math.min(maxLength, MAX_OUTPUT_SIZE);\n\n  const systemPrompt =\n    'You synthesize multiple section summaries into one cohesive, comprehensive summary. ' +\n    'Remove redundancy, preserve all key facts and actionable information, ' +\n    'and organize with clear markdown structure.';\n\n  const focusLine = instruction ? `\\nFOCUS: ${instruction}\\n` : '';\n  const combined = summaries.join('\\n\\n---\\n\\n');\n  const userPrompt =\n    `Synthesize these section summaries from ${url} into ONE unified markdown summary ` +\n    `(under ${outputCap} characters):${focusLine}\\n\\n${combined}`;\n\n  try {\n    const synthesized = await callExtractionLlm(systemPrompt, userPrompt, 8000, config, signal);\n\n    if (!synthesized) {\n      // Synthesis LLM returned empty — fall back to concatenation\n      log.warn({ url }, 'Synthesis returned empty, concatenating chunk summaries');\n      const fallback = summaries.join('\\n\\n');\n      return fallback.length > outputCap\n        ? fallback.slice(0, outputCap) + '\\n\\n[...truncated]'\n        : fallback;\n    }\n\n    const finalOutput = synthesized.length > outputCap\n      ? synthesized.slice(0, outputCap) + '\\n\\n[...summary truncated for context management]'\n      : synthesized;\n\n    const compressionRatio = finalOutput.length / originalContentLength;\n    log.info(\n      {\n        url,\n        originalChars: originalContentLength,\n        extractedChars: finalOutput.length,\n        compressionPercent: `${(compressionRatio * 100).toFixed(1)}%`,\n      },\n      'Chunked extraction complete',\n    );\n\n    return finalOutput;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    log.warn({ url, error: message }, 'Synthesis failed, concatenating chunk summaries');\n    const fallback = summaries.join('\\n\\n');\n    return fallback.length > outputCap\n      ? fallback.slice(0, outputCap) + '\\n\\n[...truncated due to synthesis failure]'\n      : fallback;\n  }\n}\n\ntype WebExtractParams = { url: string; instruction?: string; maxLength?: number };\n\nfunction resolveConfiguredMaxLength(config: Config | undefined): number {\n  const value = (config?.agents as unknown as {\n    defaults?: { webExtract?: { maxLength?: unknown } };\n  } | undefined)?.defaults?.webExtract?.maxLength;\n  return typeof value === 'number' && Number.isFinite(value) && value > 0\n    ? Math.trunc(value)\n    : DEFAULT_WEB_EXTRACT_MAX_LENGTH;\n}\n\nexport function createWebExtractTool(deps: WebExtractDeps): AgentTool {\n  return {\n    name: 'web_extract',\n    label: '📄 Web Extract',\n    description:\n      'Extract and summarize content from a web page using LLM-powered extraction.\\n\\n' +\n      'Unlike web_fetch (which returns cleaned plain text from HTML), this tool uses a ' +\n      'dedicated model pass to produce focused markdown. Use when you need semantic extraction ' +\n      'or a specific focus (instruction), not just a single readability pass.\\n\\n' +\n      'WHEN TO USE:\\n' +\n      '- Reading articles, blog posts, documentation\\n' +\n      '- Extracting specific data (pricing, specs, API docs)\\n' +\n      '- Summarizing long pages to save context\\n\\n' +\n      'WHEN TO USE web_fetch INSTEAD:\\n' +\n      '- Inspecting raw-ish page text quickly without an extra LLM call\\n' +\n      '- Downloading JSON/API responses\\n' +\n      '- Debugging page rendering issues',\n    parameters: WebExtractSchema,\n\n    async execute(\n      _toolCallId: string,\n      params: any,\n      signal?: AbortSignal,\n    ): Promise<AgentToolResult<{ url: string; extractedLength: number }>> {\n      const { url, instruction } = params as WebExtractParams;\n      const cfg = deps.getConfig();\n      const maxLength = (params as WebExtractParams).maxLength ?? resolveConfiguredMaxLength(cfg);\n\n      try {\n        // SSRF protection\n        const safety = checkUrlSafety(url);\n        if (!safety.safe) {\n          return {\n            content: [{ type: 'text', text: `Blocked: ${safety.reason}` }],\n            details: { url, extractedLength: 0 },\n          };\n        }\n\n        // Website blocklist check\n        const blocked = checkWebsiteBlocklist(url, cfg?.tools?.web?.blocklist);\n        if (blocked) {\n          return {\n            content: [{ type: 'text', text: `Blocked: ${blocked.message}` }],\n            details: { url, extractedLength: 0 },\n          };\n        }\n\n        const rawContent = await fetchPageContent(url, signal);\n        const cleaned = stripHtmlBoilerplate(rawContent);\n        const trimmed = cleaned.trim();\n        const looksStructured = trimmed.startsWith('{') || trimmed.startsWith('[');\n        if (trimmed.length < 100 && !looksStructured) {\n          return {\n            content: [\n              { type: 'text', text: `Page at ${url} appears to have no extractable content.` },\n            ],\n            details: { url, extractedLength: 0 },\n          };\n        }\n\n        const extracted = await extractWithLlm(\n          cleaned,\n          url,\n          instruction,\n          maxLength,\n          cfg,\n          signal,\n        );\n\n        return {\n          content: [{ type: 'text', text: extracted }],\n          details: { url, extractedLength: extracted.length },\n        };\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        log.warn({ url, error: message }, 'web_extract failed');\n        return {\n          content: [{ type: 'text', text: `Failed to extract content from ${url}: ${message}` }],\n          details: { url, extractedLength: 0 },\n        };\n      }\n    },\n  } as any;\n}\n"],"mappings":"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"}

package/dist/src/agent/workflow/builtins/audit-repo.d.ts

@@ -10,4 +10,4 @@
  *   - scope: subdirectory to focus on (default '.')
  *   - dimensions: subset of dimension keys, e.g. ['security', 'bugs']
  */
-export declare const AUDIT_REPO_SCRIPT = "export const meta = {\n  name: 'audit_repo',\n  description: 'Fan-out repository audit across multiple dimensions, then synthesize a structured report.',\n  whenToUse: 'User asks for a thorough / multi-dimension code review of the whole repo or a major subsystem.',\n  examplePrompts: [\n    { field: 'goal', text: 'Run a thorough audit of this repository' },\n    { field: 'goal', text: 'Review code quality across the whole codebase' },\n  ],\n  i18n: {\n    zh: {\n      description: '\u591A\u7EF4\u5EA6\u5E76\u884C\u5BA1\u67E5\u6574\u4E2A\u4ED3\u5E93\uFF0C\u5E76\u6C47\u603B\u4E3A\u7ED3\u6784\u5316\u62A5\u544A\u3002',\n      whenToUse: '\u7528\u6237\u9700\u8981\u5BF9\u6574\u5E93\u6216\u4E3B\u8981\u5B50\u7CFB\u7EDF\u505A\u5168\u9762\u3001\u591A\u7EF4\u5EA6\u7684\u4EE3\u7801\u5BA1\u67E5\u65F6\u3002',\n      examplePrompts: [\n        { field: 'goal', text: '\u5BF9\u6574\u4E2A\u4ED3\u5E93\u505A\u4E00\u6B21\u5168\u9762\u5BA1\u67E5' },\n        { field: 'goal', text: '\u4ECE\u4EE3\u7801\u8D28\u91CF\u7EF4\u5EA6\u5BA1\u67E5\u6574\u4E2A\u4EE3\u7801\u5E93' },\n      ],\n    },\n  },\n  tags: ['code-review', 'audit'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Inventory' },\n    { title: 'Review' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst scope = args && typeof args === 'object' && args.scope\n  ? String(args.scope)\n  : '.'\n\nconst ALL_DIMENSIONS = [\n  { key: 'bugs', focus: 'Correctness bugs, null-safety, error handling, race conditions, off-by-one, dead code.' },\n  { key: 'perf', focus: 'Performance issues, hot paths, N+1 patterns, accidental quadratic loops, sync I/O, missing caching.' },\n  { key: 'security', focus: 'Auth/authz, input validation, secret handling, injection sinks, unsafe deserialization, SSRF.' },\n  { key: 'tests', focus: 'Test coverage gaps, brittle tests, integration vs unit gaps, missing regression cases.' },\n  { key: 'style', focus: 'Inconsistent conventions, naming, unused exports, duplication, layering violations.' },\n]\n\nlet dimensions = ALL_DIMENSIONS\nif (args && typeof args === 'object' && Array.isArray(args.dimensions) && args.dimensions.length) {\n  const keys = new Set(args.dimensions.map((d) => String(d)))\n  dimensions = ALL_DIMENSIONS.filter((d) => keys.has(d.key))\n  if (!dimensions.length) dimensions = ALL_DIMENSIONS\n}\n\nphase('Inventory')\nconst inventory = await agent(\n  'Produce a compact map of this repository scope: ' + scope + '. ' +\n    'Cover layout, main modules, the 5\u201310 most important files, and obvious entry points. Be terse and structured.',\n  { label: 'repo inventory', toolset: READ_ONLY_TOOLS },\n)\n\nphase('Review')\nconst findings = await parallel(\n  dimensions.map((d) => () =>\n    agent(\n      'Review scope \"' + scope + '\" through the ' + d.key + ' lens.\\n' +\n        'Focus: ' + d.focus + '\\n\\n' +\n        'Inventory for orientation:\\n' + inventory + '\\n\\n' +\n        'Return findings: file paths, line numbers when known, severity (low/med/high), a one-sentence why, a one-sentence fix.',\n      {\n        label: d.key + ' review',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  file: { type: 'string' },\n                  line: { type: ['number', 'string'] },\n                  severity: { type: 'string', enum: ['low', 'med', 'high'] },\n                  title: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['file', 'severity', 'title', 'fix'],\n              },\n            },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Synthesize')\nconst live = findings.filter(Boolean)\nif (!live.length) {\n  return { ok: true, scope, summary: 'No findings.', byDimension: {}, priorityActions: [] }\n}\nconst byDimension = {}\nfor (let i = 0; i < dimensions.length; i++) {\n  byDimension[dimensions[i].key] = live[i]?.findings ?? []\n}\n\nconst summary = await agent(\n  'Synthesize a compact report from these per-dimension findings. Deduplicate near-identical items. ' +\n    'Order by severity (high \u2192 low). Cap topFindings at 20. ' +\n    'Also return priorityActions: the top 5 fixes ranked by impact, each with effort (S|M|L).\\n\\n' +\n    JSON.stringify(byDimension, null, 2),\n  {\n    label: 'report synthesis',\n    schema: {\n      type: 'object',\n      properties: {\n        topFindings: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              dimension: { type: 'string' },\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              fix: { type: 'string' },\n            },\n            required: ['dimension', 'file', 'severity', 'title'],\n          },\n        },\n        priorityActions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              effort: { type: 'string', enum: ['S', 'M', 'L'] },\n            },\n            required: ['file', 'severity', 'title', 'effort'],\n          },\n        },\n        summary: { type: 'string' },\n      },\n      required: ['topFindings', 'priorityActions', 'summary'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  scope,\n  dimensions: dimensions.map((d) => d.key),\n  ...(summary ?? { topFindings: [], priorityActions: [], summary: 'synthesis failed' }),\n  byDimension,\n}\n";
+export declare const AUDIT_REPO_SCRIPT = "export const meta = {\n  name: 'audit_repo',\n  description: 'Fan-out repository audit across multiple dimensions, then synthesize a structured report.',\n  whenToUse: 'User asks for a thorough / multi-dimension code review of the whole repo or a major subsystem.',\n  examplePrompts: [\n    { field: 'goal', text: 'Run a thorough audit of this repository' },\n    { field: 'goal', text: 'Review code quality across the whole codebase' },\n  ],\n  i18n: {\n    zh: {\n      description: '\u591A\u7EF4\u5EA6\u5E76\u884C\u5BA1\u67E5\u6574\u4E2A\u4ED3\u5E93\uFF0C\u5E76\u6C47\u603B\u4E3A\u7ED3\u6784\u5316\u62A5\u544A\u3002',\n      whenToUse: '\u7528\u6237\u9700\u8981\u5BF9\u6574\u5E93\u6216\u4E3B\u8981\u5B50\u7CFB\u7EDF\u505A\u5168\u9762\u3001\u591A\u7EF4\u5EA6\u7684\u4EE3\u7801\u5BA1\u67E5\u65F6\u3002',\n      examplePrompts: [\n        { field: 'goal', text: '\u5BF9\u6574\u4E2A\u4ED3\u5E93\u505A\u4E00\u6B21\u5168\u9762\u5BA1\u67E5' },\n        { field: 'goal', text: '\u4ECE\u4EE3\u7801\u8D28\u91CF\u7EF4\u5EA6\u5BA1\u67E5\u6574\u4E2A\u4EE3\u7801\u5E93' },\n      ],\n    },\n  },\n  tags: ['code-review', 'audit'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Inventory' },\n    { title: 'Review' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst scope = args && typeof args === 'object' && args.scope\n  ? String(args.scope)\n  : '.'\n\nconst ALL_DIMENSIONS = [\n  { key: 'bugs', focus: 'Correctness bugs, null-safety, error handling, race conditions, off-by-one, dead code.' },\n  { key: 'perf', focus: 'Performance issues, hot paths, N+1 patterns, accidental quadratic loops, sync I/O, missing caching.' },\n  { key: 'security', focus: 'Auth/authz, input validation, secret handling, injection sinks, unsafe deserialization, SSRF.' },\n  { key: 'tests', focus: 'Test coverage gaps, brittle tests, integration vs unit gaps, missing regression cases.' },\n  { key: 'style', focus: 'Inconsistent conventions, naming, unused exports, duplication, layering violations.' },\n]\n\nlet dimensions = ALL_DIMENSIONS\nif (args && typeof args === 'object' && Array.isArray(args.dimensions) && args.dimensions.length) {\n  const keys = new Set(args.dimensions.map((d) => String(d)))\n  dimensions = ALL_DIMENSIONS.filter((d) => keys.has(d.key))\n  if (!dimensions.length) dimensions = ALL_DIMENSIONS\n}\n\nphase('Inventory')\nconst inventory = await agent(\n  'Produce a compact map of this repository scope: ' + scope + '. ' +\n    'Cover layout, main modules, the 5\u201310 most important files, and obvious entry points. Be terse and structured.',\n  { label: 'repo inventory', toolset: READ_ONLY_TOOLS },\n)\n\nphase('Review')\nconst findings = await parallel(\n  dimensions.map((d) => () =>\n    agent(\n      'Review scope \"' + scope + '\" through the ' + d.key + ' lens.\\n' +\n        'Focus: ' + d.focus + '\\n\\n' +\n        'Inventory for orientation:\\n' + inventory + '\\n\\n' +\n        'Return findings: file paths, line numbers when known, severity (low/med/high), a one-sentence why, a one-sentence fix.',\n      {\n        label: d.key + ' review',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  file: { type: 'string' },\n                  line: { type: ['number', 'string'] },\n                  severity: { type: 'string', enum: ['low', 'med', 'high'] },\n                  title: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['file', 'severity', 'title', 'fix'],\n              },\n            },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Synthesize')\nconst live = findings.filter(Boolean)\nif (!live.length) {\n  const output = { ok: true, scope, summary: 'No findings.', byDimension: {}, priorityActions: [] }\n  return {\n    summary: output.summary,\n    sections: [{ kind: 'json', title: 'Audit result', value: output }],\n    structuredOutput: output,\n  }\n}\nconst byDimension = {}\nfor (let i = 0; i < dimensions.length; i++) {\n  byDimension[dimensions[i].key] = live[i]?.findings ?? []\n}\n\nconst summary = await agent(\n  'Synthesize a compact report from these per-dimension findings. Deduplicate near-identical items. ' +\n    'Order by severity (high \u2192 low). Cap topFindings at 20. ' +\n    'Also return priorityActions: the top 5 fixes ranked by impact, each with effort (S|M|L).\\n\\n' +\n    JSON.stringify(byDimension, null, 2),\n  {\n    label: 'report synthesis',\n    schema: {\n      type: 'object',\n      properties: {\n        topFindings: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              dimension: { type: 'string' },\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              fix: { type: 'string' },\n            },\n            required: ['dimension', 'file', 'severity', 'title'],\n          },\n        },\n        priorityActions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              effort: { type: 'string', enum: ['S', 'M', 'L'] },\n            },\n            required: ['file', 'severity', 'title', 'effort'],\n          },\n        },\n        summary: { type: 'string' },\n      },\n      required: ['topFindings', 'priorityActions', 'summary'],\n    },\n  },\n)\n\nconst output = {\n  ok: true,\n  scope,\n  dimensions: dimensions.map((d) => d.key),\n  ...(summary ?? { topFindings: [], priorityActions: [], summary: 'synthesis failed' }),\n  byDimension,\n}\nreturn {\n  summary: output.summary,\n  sections: [\n    { kind: 'findings', title: 'Top findings', items: output.topFindings.map((item) => ({ title: item.title, severity: item.severity, file: item.file, detail: item.fix })) },\n    { kind: 'json', title: 'Priority actions', value: output.priorityActions },\n  ],\n  structuredOutput: output,\n}\n";

package/dist/src/agent/workflow/builtins/audit-repo.js

@@ -105,7 +105,12 @@ const findings = await parallel(
 phase('Synthesize')
 const live = findings.filter(Boolean)
 if (!live.length) {
-  return { ok: true, scope, summary: 'No findings.', byDimension: {}, priorityActions: [] }
+  const output = { ok: true, scope, summary: 'No findings.', byDimension: {}, priorityActions: [] }
+  return {
+    summary: output.summary,
+    sections: [{ kind: 'json', title: 'Audit result', value: output }],
+    structuredOutput: output,
+  }
 }
 const byDimension = {}
 for (let i = 0; i < dimensions.length; i++) {
@@ -156,13 +161,21 @@ const summary = await agent(
   },
 )
 
-return {
+const output = {
   ok: true,
   scope,
   dimensions: dimensions.map((d) => d.key),
   ...(summary ?? { topFindings: [], priorityActions: [], summary: 'synthesis failed' }),
   byDimension,
 }
+return {
+  summary: output.summary,
+  sections: [
+    { kind: 'findings', title: 'Top findings', items: output.topFindings.map((item) => ({ title: item.title, severity: item.severity, file: item.file, detail: item.fix })) },
+    { kind: 'json', title: 'Priority actions', value: output.priorityActions },
+  ],
+  structuredOutput: output,
+}
 `;
 //#endregion
 export { AUDIT_REPO_SCRIPT };

package/dist/src/agent/workflow/builtins/audit-repo.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit-repo.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/audit-repo.ts"],"sourcesContent":["/**\n * Built-in workflow: `audit_repo`\n *\n * Fan-out repo audit. Phase 1 inventories the repo; phase 2 spawns N reviewers\n * in parallel, one per dimension (bugs / perf / security / tests / style);\n * phase 3 synthesises into a structured report. The script is kept readable so\n * users can copy it into `~/.xopc/workflows/` as a starting point.\n *\n * Args:\n *   - scope: subdirectory to focus on (default '.')\n *   - dimensions: subset of dimension keys, e.g. ['security', 'bugs']\n */\n\nexport const AUDIT_REPO_SCRIPT = `export const meta = {\n  name: 'audit_repo',\n  description: 'Fan-out repository audit across multiple dimensions, then synthesize a structured report.',\n  whenToUse: 'User asks for a thorough / multi-dimension code review of the whole repo or a major subsystem.',\n  examplePrompts: [\n    { field: 'goal', text: 'Run a thorough audit of this repository' },\n    { field: 'goal', text: 'Review code quality across the whole codebase' },\n  ],\n  i18n: {\n    zh: {\n      description: '多维度并行审查整个仓库，并汇总为结构化报告。',\n      whenToUse: '用户需要对整库或主要子系统做全面、多维度的代码审查时。',\n      examplePrompts: [\n        { field: 'goal', text: '对整个仓库做一次全面审查' },\n        { field: 'goal', text: '从代码质量维度审查整个代码库' },\n      ],\n    },\n  },\n  tags: ['code-review', 'audit'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Inventory' },\n    { title: 'Review' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst scope = args && typeof args === 'object' && args.scope\n  ? String(args.scope)\n  : '.'\n\nconst ALL_DIMENSIONS = [\n  { key: 'bugs', focus: 'Correctness bugs, null-safety, error handling, race conditions, off-by-one, dead code.' },\n  { key: 'perf', focus: 'Performance issues, hot paths, N+1 patterns, accidental quadratic loops, sync I/O, missing caching.' },\n  { key: 'security', focus: 'Auth/authz, input validation, secret handling, injection sinks, unsafe deserialization, SSRF.' },\n  { key: 'tests', focus: 'Test coverage gaps, brittle tests, integration vs unit gaps, missing regression cases.' },\n  { key: 'style', focus: 'Inconsistent conventions, naming, unused exports, duplication, layering violations.' },\n]\n\nlet dimensions = ALL_DIMENSIONS\nif (args && typeof args === 'object' && Array.isArray(args.dimensions) && args.dimensions.length) {\n  const keys = new Set(args.dimensions.map((d) => String(d)))\n  dimensions = ALL_DIMENSIONS.filter((d) => keys.has(d.key))\n  if (!dimensions.length) dimensions = ALL_DIMENSIONS\n}\n\nphase('Inventory')\nconst inventory = await agent(\n  'Produce a compact map of this repository scope: ' + scope + '. ' +\n    'Cover layout, main modules, the 5–10 most important files, and obvious entry points. Be terse and structured.',\n  { label: 'repo inventory', toolset: READ_ONLY_TOOLS },\n)\n\nphase('Review')\nconst findings = await parallel(\n  dimensions.map((d) => () =>\n    agent(\n      'Review scope \"' + scope + '\" through the ' + d.key + ' lens.\\\\n' +\n        'Focus: ' + d.focus + '\\\\n\\\\n' +\n        'Inventory for orientation:\\\\n' + inventory + '\\\\n\\\\n' +\n        'Return findings: file paths, line numbers when known, severity (low/med/high), a one-sentence why, a one-sentence fix.',\n      {\n        label: d.key + ' review',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  file: { type: 'string' },\n                  line: { type: ['number', 'string'] },\n                  severity: { type: 'string', enum: ['low', 'med', 'high'] },\n                  title: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['file', 'severity', 'title', 'fix'],\n              },\n            },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Synthesize')\nconst live = findings.filter(Boolean)\nif (!live.length) {\n  return { ok: true, scope, summary: 'No findings.', byDimension: {}, priorityActions: [] }\n}\nconst byDimension = {}\nfor (let i = 0; i < dimensions.length; i++) {\n  byDimension[dimensions[i].key] = live[i]?.findings ?? []\n}\n\nconst summary = await agent(\n  'Synthesize a compact report from these per-dimension findings. Deduplicate near-identical items. ' +\n    'Order by severity (high → low). Cap topFindings at 20. ' +\n    'Also return priorityActions: the top 5 fixes ranked by impact, each with effort (S|M|L).\\\\n\\\\n' +\n    JSON.stringify(byDimension, null, 2),\n  {\n    label: 'report synthesis',\n    schema: {\n      type: 'object',\n      properties: {\n        topFindings: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              dimension: { type: 'string' },\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              fix: { type: 'string' },\n            },\n            required: ['dimension', 'file', 'severity', 'title'],\n          },\n        },\n        priorityActions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              effort: { type: 'string', enum: ['S', 'M', 'L'] },\n            },\n            required: ['file', 'severity', 'title', 'effort'],\n          },\n        },\n        summary: { type: 'string' },\n      },\n      required: ['topFindings', 'priorityActions', 'summary'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  scope,\n  dimensions: dimensions.map((d) => d.key),\n  ...(summary ?? { topFindings: [], priorityActions: [], summary: 'synthesis failed' }),\n  byDimension,\n}\n`\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,oBAAoB"}
+{"version":3,"file":"audit-repo.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/audit-repo.ts"],"sourcesContent":["/**\n * Built-in workflow: `audit_repo`\n *\n * Fan-out repo audit. Phase 1 inventories the repo; phase 2 spawns N reviewers\n * in parallel, one per dimension (bugs / perf / security / tests / style);\n * phase 3 synthesises into a structured report. The script is kept readable so\n * users can copy it into `~/.xopc/workflows/` as a starting point.\n *\n * Args:\n *   - scope: subdirectory to focus on (default '.')\n *   - dimensions: subset of dimension keys, e.g. ['security', 'bugs']\n */\n\nexport const AUDIT_REPO_SCRIPT = `export const meta = {\n  name: 'audit_repo',\n  description: 'Fan-out repository audit across multiple dimensions, then synthesize a structured report.',\n  whenToUse: 'User asks for a thorough / multi-dimension code review of the whole repo or a major subsystem.',\n  examplePrompts: [\n    { field: 'goal', text: 'Run a thorough audit of this repository' },\n    { field: 'goal', text: 'Review code quality across the whole codebase' },\n  ],\n  i18n: {\n    zh: {\n      description: '多维度并行审查整个仓库，并汇总为结构化报告。',\n      whenToUse: '用户需要对整库或主要子系统做全面、多维度的代码审查时。',\n      examplePrompts: [\n        { field: 'goal', text: '对整个仓库做一次全面审查' },\n        { field: 'goal', text: '从代码质量维度审查整个代码库' },\n      ],\n    },\n  },\n  tags: ['code-review', 'audit'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Inventory' },\n    { title: 'Review' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst scope = args && typeof args === 'object' && args.scope\n  ? String(args.scope)\n  : '.'\n\nconst ALL_DIMENSIONS = [\n  { key: 'bugs', focus: 'Correctness bugs, null-safety, error handling, race conditions, off-by-one, dead code.' },\n  { key: 'perf', focus: 'Performance issues, hot paths, N+1 patterns, accidental quadratic loops, sync I/O, missing caching.' },\n  { key: 'security', focus: 'Auth/authz, input validation, secret handling, injection sinks, unsafe deserialization, SSRF.' },\n  { key: 'tests', focus: 'Test coverage gaps, brittle tests, integration vs unit gaps, missing regression cases.' },\n  { key: 'style', focus: 'Inconsistent conventions, naming, unused exports, duplication, layering violations.' },\n]\n\nlet dimensions = ALL_DIMENSIONS\nif (args && typeof args === 'object' && Array.isArray(args.dimensions) && args.dimensions.length) {\n  const keys = new Set(args.dimensions.map((d) => String(d)))\n  dimensions = ALL_DIMENSIONS.filter((d) => keys.has(d.key))\n  if (!dimensions.length) dimensions = ALL_DIMENSIONS\n}\n\nphase('Inventory')\nconst inventory = await agent(\n  'Produce a compact map of this repository scope: ' + scope + '. ' +\n    'Cover layout, main modules, the 5–10 most important files, and obvious entry points. Be terse and structured.',\n  { label: 'repo inventory', toolset: READ_ONLY_TOOLS },\n)\n\nphase('Review')\nconst findings = await parallel(\n  dimensions.map((d) => () =>\n    agent(\n      'Review scope \"' + scope + '\" through the ' + d.key + ' lens.\\\\n' +\n        'Focus: ' + d.focus + '\\\\n\\\\n' +\n        'Inventory for orientation:\\\\n' + inventory + '\\\\n\\\\n' +\n        'Return findings: file paths, line numbers when known, severity (low/med/high), a one-sentence why, a one-sentence fix.',\n      {\n        label: d.key + ' review',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  file: { type: 'string' },\n                  line: { type: ['number', 'string'] },\n                  severity: { type: 'string', enum: ['low', 'med', 'high'] },\n                  title: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['file', 'severity', 'title', 'fix'],\n              },\n            },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Synthesize')\nconst live = findings.filter(Boolean)\nif (!live.length) {\n  const output = { ok: true, scope, summary: 'No findings.', byDimension: {}, priorityActions: [] }\n  return {\n    summary: output.summary,\n    sections: [{ kind: 'json', title: 'Audit result', value: output }],\n    structuredOutput: output,\n  }\n}\nconst byDimension = {}\nfor (let i = 0; i < dimensions.length; i++) {\n  byDimension[dimensions[i].key] = live[i]?.findings ?? []\n}\n\nconst summary = await agent(\n  'Synthesize a compact report from these per-dimension findings. Deduplicate near-identical items. ' +\n    'Order by severity (high → low). Cap topFindings at 20. ' +\n    'Also return priorityActions: the top 5 fixes ranked by impact, each with effort (S|M|L).\\\\n\\\\n' +\n    JSON.stringify(byDimension, null, 2),\n  {\n    label: 'report synthesis',\n    schema: {\n      type: 'object',\n      properties: {\n        topFindings: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              dimension: { type: 'string' },\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              fix: { type: 'string' },\n            },\n            required: ['dimension', 'file', 'severity', 'title'],\n          },\n        },\n        priorityActions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              effort: { type: 'string', enum: ['S', 'M', 'L'] },\n            },\n            required: ['file', 'severity', 'title', 'effort'],\n          },\n        },\n        summary: { type: 'string' },\n      },\n      required: ['topFindings', 'priorityActions', 'summary'],\n    },\n  },\n)\n\nconst output = {\n  ok: true,\n  scope,\n  dimensions: dimensions.map((d) => d.key),\n  ...(summary ?? { topFindings: [], priorityActions: [], summary: 'synthesis failed' }),\n  byDimension,\n}\nreturn {\n  summary: output.summary,\n  sections: [\n    { kind: 'findings', title: 'Top findings', items: output.topFindings.map((item) => ({ title: item.title, severity: item.severity, file: item.file, detail: item.fix })) },\n    { kind: 'json', title: 'Priority actions', value: output.priorityActions },\n  ],\n  structuredOutput: output,\n}\n`\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,oBAAoB"}

package/dist/src/agent/workflow/builtins/client-proposal.d.ts

@@ -9,4 +9,4 @@
  *   - offer: what you provide
  *   - budget_hint: budget range or constraints (optional)
  */
-export declare const CLIENT_PROPOSAL_SCRIPT = "export const meta = {\n  name: 'client_proposal',\n  description: 'Turn a client brief into a structured proposal with scope, timeline, pricing logic, and risks.',\n  whenToUse: 'Freelancer or solo consultant needs a client-ready proposal or SOW draft.',\n  examplePrompts: [\n    { field: 'client_brief', text: 'SaaS startup wants 3-month growth consulting, budget 50\u201380k CNY' },\n    { field: 'offer', text: 'Audit funnel, weekly strategy calls, async Slack support' },\n  ],\n  i18n: {\n    zh: {\n      description: '\u5C06\u5BA2\u6237\u9700\u6C42\u8F6C\u5316\u4E3A\u542B\u8303\u56F4\u3001\u65F6\u95F4\u7EBF\u3001\u62A5\u4EF7\u903B\u8F91\u4E0E\u98CE\u9669\u8BF4\u660E\u7684\u5BA2\u6237\u65B9\u6848\u3002',\n      whenToUse: '\u81EA\u7531\u804C\u4E1A\u8005\u6216\u72EC\u7ACB\u987E\u95EE\u9700\u8981\u8D77\u8349\u5BA2\u6237\u65B9\u6848 / SOW \u65F6\u3002',\n      examplePrompts: [\n        { field: 'client_brief', text: 'SaaS \u521B\u4E1A\u516C\u53F8\u8981 3 \u4E2A\u6708\u589E\u957F\u54A8\u8BE2\uFF0C\u9884\u7B97 5\u20138 \u4E07' },\n        { field: 'offer', text: '\u6F0F\u6597\u5BA1\u8BA1\u3001\u6BCF\u5468\u7B56\u7565\u4F1A\u3001Slack \u5F02\u6B65\u652F\u6301' },\n      ],\n    },\n  },\n  tags: ['writing', 'content', 'document'],\n  estimatedAgents: { min: 4, max: 5 },\n  phases: [\n    { title: 'Understand' },\n    { title: 'Structure' },\n    { title: 'Draft' },\n    { title: 'Polish' },\n  ],\n}\n\nconst clientBrief = args && typeof args === 'object' && args.client_brief\n  ? String(args.client_brief)\n  : 'Infer the client brief from the most recent user turn.'\n\nconst offer = args && typeof args === 'object' && args.offer\n  ? String(args.offer)\n  : 'Infer your offer from context.'\n\nconst budgetHint = args && typeof args === 'object' && args.budget_hint\n  ? String(args.budget_hint)\n  : ''\n\nphase('Understand')\nconst understanding = await agent(\n  'Extract client needs, implicit constraints, success criteria, red flags, and what is out of scope.\\n\\n' +\n    'CLIENT BRIEF:\\n' + clientBrief + '\\nYOUR OFFER:\\n' + offer +\n    (budgetHint ? '\\nBUDGET HINT:\\n' + budgetHint : ''),\n  {\n    label: 'understand',\n    schema: {\n      type: 'object',\n      properties: {\n        clientGoals: { type: 'array', items: { type: 'string' } },\n        constraints: { type: 'array', items: { type: 'string' } },\n        successCriteria: { type: 'array', items: { type: 'string' } },\n        redFlags: { type: 'array', items: { type: 'string' } },\n        outOfScope: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['clientGoals', 'successCriteria'],\n    },\n  },\n)\n\nphase('Structure')\nconst structure = await agent(\n  'Design proposal structure: deliverables, milestones, timeline, pricing tiers or logic, assumptions, and exclusions. Fit a solo operator capacity.\\n\\n' +\n    JSON.stringify({ clientBrief, offer, budgetHint, understanding }, null, 2),\n  {\n    label: 'structure',\n    schema: {\n      type: 'object',\n      properties: {\n        deliverables: { type: 'array', items: { type: 'string' } },\n        milestones: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              name: { type: 'string' },\n              duration: { type: 'string' },\n              output: { type: 'string' },\n            },\n            required: ['name', 'output'],\n          },\n        },\n        pricingApproach: { type: 'string' },\n        assumptions: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['deliverables', 'milestones', 'pricingApproach'],\n    },\n  },\n)\n\nphase('Draft')\nconst draft = await agent(\n  'Write a client-ready proposal draft in professional but warm tone. Include executive summary, scope, timeline, pricing section (with rationale), risks, and next steps.\\n\\n' +\n    JSON.stringify({ understanding, structure }, null, 2),\n  {\n    label: 'draft',\n    schema: {\n      type: 'object',\n      properties: {\n        title: { type: 'string' },\n        executiveSummary: { type: 'string' },\n        scope: { type: 'string' },\n        timeline: { type: 'string' },\n        pricing: { type: 'string' },\n        risks: { type: 'array', items: { type: 'string' } },\n        nextSteps: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['executiveSummary', 'scope', 'pricing', 'nextSteps'],\n    },\n  },\n)\n\nphase('Polish')\nconst polished = await agent(\n  'Polish the proposal: tighten language, add a one-line value prop, flag anything that could scare the client, and suggest 2 negotiation flex points.\\n\\n' +\n    JSON.stringify(draft, null, 2),\n  {\n    label: 'polish',\n    schema: {\n      type: 'object',\n      properties: {\n        valueProp: { type: 'string' },\n        fullProposal: { type: 'string' },\n        clientConcerns: { type: 'array', items: { type: 'string' } },\n        flexPoints: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['valueProp', 'fullProposal'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  understanding,\n  structure,\n  ...(polished ?? { valueProp: '', fullProposal: 'draft failed' }),\n}\n";
+export declare const CLIENT_PROPOSAL_SCRIPT = "export const meta = {\n  name: 'client_proposal',\n  description: 'Turn a client brief into a structured proposal with scope, timeline, pricing logic, and risks.',\n  whenToUse: 'Freelancer or solo consultant needs a client-ready proposal or SOW draft.',\n  examplePrompts: [\n    { field: 'client_brief', text: 'SaaS startup wants 3-month growth consulting, budget 50\u201380k CNY' },\n    { field: 'offer', text: 'Audit funnel, weekly strategy calls, async Slack support' },\n  ],\n  i18n: {\n    zh: {\n      description: '\u5C06\u5BA2\u6237\u9700\u6C42\u8F6C\u5316\u4E3A\u542B\u8303\u56F4\u3001\u65F6\u95F4\u7EBF\u3001\u62A5\u4EF7\u903B\u8F91\u4E0E\u98CE\u9669\u8BF4\u660E\u7684\u5BA2\u6237\u65B9\u6848\u3002',\n      whenToUse: '\u81EA\u7531\u804C\u4E1A\u8005\u6216\u72EC\u7ACB\u987E\u95EE\u9700\u8981\u8D77\u8349\u5BA2\u6237\u65B9\u6848 / SOW \u65F6\u3002',\n      examplePrompts: [\n        { field: 'client_brief', text: 'SaaS \u521B\u4E1A\u516C\u53F8\u8981 3 \u4E2A\u6708\u589E\u957F\u54A8\u8BE2\uFF0C\u9884\u7B97 5\u20138 \u4E07' },\n        { field: 'offer', text: '\u6F0F\u6597\u5BA1\u8BA1\u3001\u6BCF\u5468\u7B56\u7565\u4F1A\u3001Slack \u5F02\u6B65\u652F\u6301' },\n      ],\n    },\n  },\n  tags: ['writing', 'content', 'document'],\n  estimatedAgents: { min: 4, max: 5 },\n  phases: [\n    { title: 'Understand' },\n    { title: 'Structure' },\n    { title: 'Draft' },\n    { title: 'Polish' },\n  ],\n}\n\nconst clientBrief = args && typeof args === 'object' && args.client_brief\n  ? String(args.client_brief)\n  : 'Infer the client brief from the most recent user turn.'\n\nconst offer = args && typeof args === 'object' && args.offer\n  ? String(args.offer)\n  : 'Infer your offer from context.'\n\nconst budgetHint = args && typeof args === 'object' && args.budget_hint\n  ? String(args.budget_hint)\n  : ''\n\nphase('Understand')\nconst understanding = await agent(\n  'Extract client needs, implicit constraints, success criteria, red flags, and what is out of scope.\\n\\n' +\n    'CLIENT BRIEF:\\n' + clientBrief + '\\nYOUR OFFER:\\n' + offer +\n    (budgetHint ? '\\nBUDGET HINT:\\n' + budgetHint : ''),\n  {\n    label: 'understand',\n    schema: {\n      type: 'object',\n      properties: {\n        clientGoals: { type: 'array', items: { type: 'string' } },\n        constraints: { type: 'array', items: { type: 'string' } },\n        successCriteria: { type: 'array', items: { type: 'string' } },\n        redFlags: { type: 'array', items: { type: 'string' } },\n        outOfScope: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['clientGoals', 'successCriteria'],\n    },\n  },\n)\n\nphase('Structure')\nconst structure = await agent(\n  'Design proposal structure: deliverables, milestones, timeline, pricing tiers or logic, assumptions, and exclusions. Fit a solo operator capacity.\\n\\n' +\n    JSON.stringify({ clientBrief, offer, budgetHint, understanding }, null, 2),\n  {\n    label: 'structure',\n    schema: {\n      type: 'object',\n      properties: {\n        deliverables: { type: 'array', items: { type: 'string' } },\n        milestones: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              name: { type: 'string' },\n              duration: { type: 'string' },\n              output: { type: 'string' },\n            },\n            required: ['name', 'output'],\n          },\n        },\n        pricingApproach: { type: 'string' },\n        assumptions: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['deliverables', 'milestones', 'pricingApproach'],\n    },\n  },\n)\n\nphase('Draft')\nconst draft = await agent(\n  'Write a client-ready proposal draft in professional but warm tone. Include executive summary, scope, timeline, pricing section (with rationale), risks, and next steps.\\n\\n' +\n    JSON.stringify({ understanding, structure }, null, 2),\n  {\n    label: 'draft',\n    schema: {\n      type: 'object',\n      properties: {\n        title: { type: 'string' },\n        executiveSummary: { type: 'string' },\n        scope: { type: 'string' },\n        timeline: { type: 'string' },\n        pricing: { type: 'string' },\n        risks: { type: 'array', items: { type: 'string' } },\n        nextSteps: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['executiveSummary', 'scope', 'pricing', 'nextSteps'],\n    },\n  },\n)\n\nphase('Polish')\nconst polished = await agent(\n  'Polish the proposal: tighten language, add a one-line value prop, flag anything that could scare the client, and suggest 2 negotiation flex points.\\n\\n' +\n    JSON.stringify(draft, null, 2),\n  {\n    label: 'polish',\n    schema: {\n      type: 'object',\n      properties: {\n        valueProp: { type: 'string' },\n        fullProposal: { type: 'string' },\n        clientConcerns: { type: 'array', items: { type: 'string' } },\n        flexPoints: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['valueProp', 'fullProposal'],\n    },\n  },\n)\n\nconst output = {\n  ok: true,\n  understanding,\n  structure,\n  ...(polished ?? { valueProp: '', fullProposal: 'draft failed' }),\n}\nreturn {\n  summary: output.valueProp || 'Proposal draft complete.',\n  sections: [\n    { kind: 'text', title: 'Proposal', content: output.fullProposal },\n    { kind: 'questions', title: 'Client concerns', items: output.clientConcerns ?? [] },\n    { kind: 'questions', title: 'Flex points', items: output.flexPoints ?? [] },\n  ],\n  structuredOutput: output,\n}\n";

package/dist/src/agent/workflow/builtins/client-proposal.js

@@ -142,12 +142,21 @@ const polished = await agent(
   },
 )
 
-return {
+const output = {
   ok: true,
   understanding,
   structure,
   ...(polished ?? { valueProp: '', fullProposal: 'draft failed' }),
 }
+return {
+  summary: output.valueProp || 'Proposal draft complete.',
+  sections: [
+    { kind: 'text', title: 'Proposal', content: output.fullProposal },
+    { kind: 'questions', title: 'Client concerns', items: output.clientConcerns ?? [] },
+    { kind: 'questions', title: 'Flex points', items: output.flexPoints ?? [] },
+  ],
+  structuredOutput: output,
+}
 `;
 //#endregion
 export { CLIENT_PROPOSAL_SCRIPT };

package/dist/src/agent/workflow/builtins/client-proposal.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-proposal.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/client-proposal.ts"],"sourcesContent":["/**\n * Built-in workflow: `client_proposal`\n *\n * Draft a client-facing proposal from a brief — scope, timeline, pricing logic,\n * risks, and next steps. For freelancers, consultants, and solo service providers.\n *\n * Args:\n *   - client_brief: what the client wants\n *   - offer: what you provide\n *   - budget_hint: budget range or constraints (optional)\n */\n\nexport const CLIENT_PROPOSAL_SCRIPT = `export const meta = {\n  name: 'client_proposal',\n  description: 'Turn a client brief into a structured proposal with scope, timeline, pricing logic, and risks.',\n  whenToUse: 'Freelancer or solo consultant needs a client-ready proposal or SOW draft.',\n  examplePrompts: [\n    { field: 'client_brief', text: 'SaaS startup wants 3-month growth consulting, budget 50–80k CNY' },\n    { field: 'offer', text: 'Audit funnel, weekly strategy calls, async Slack support' },\n  ],\n  i18n: {\n    zh: {\n      description: '将客户需求转化为含范围、时间线、报价逻辑与风险说明的客户方案。',\n      whenToUse: '自由职业者或独立顾问需要起草客户方案 / SOW 时。',\n      examplePrompts: [\n        { field: 'client_brief', text: 'SaaS 创业公司要 3 个月增长咨询，预算 5–8 万' },\n        { field: 'offer', text: '漏斗审计、每周策略会、Slack 异步支持' },\n      ],\n    },\n  },\n  tags: ['writing', 'content', 'document'],\n  estimatedAgents: { min: 4, max: 5 },\n  phases: [\n    { title: 'Understand' },\n    { title: 'Structure' },\n    { title: 'Draft' },\n    { title: 'Polish' },\n  ],\n}\n\nconst clientBrief = args && typeof args === 'object' && args.client_brief\n  ? String(args.client_brief)\n  : 'Infer the client brief from the most recent user turn.'\n\nconst offer = args && typeof args === 'object' && args.offer\n  ? String(args.offer)\n  : 'Infer your offer from context.'\n\nconst budgetHint = args && typeof args === 'object' && args.budget_hint\n  ? String(args.budget_hint)\n  : ''\n\nphase('Understand')\nconst understanding = await agent(\n  'Extract client needs, implicit constraints, success criteria, red flags, and what is out of scope.\\\\n\\\\n' +\n    'CLIENT BRIEF:\\\\n' + clientBrief + '\\\\nYOUR OFFER:\\\\n' + offer +\n    (budgetHint ? '\\\\nBUDGET HINT:\\\\n' + budgetHint : ''),\n  {\n    label: 'understand',\n    schema: {\n      type: 'object',\n      properties: {\n        clientGoals: { type: 'array', items: { type: 'string' } },\n        constraints: { type: 'array', items: { type: 'string' } },\n        successCriteria: { type: 'array', items: { type: 'string' } },\n        redFlags: { type: 'array', items: { type: 'string' } },\n        outOfScope: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['clientGoals', 'successCriteria'],\n    },\n  },\n)\n\nphase('Structure')\nconst structure = await agent(\n  'Design proposal structure: deliverables, milestones, timeline, pricing tiers or logic, assumptions, and exclusions. Fit a solo operator capacity.\\\\n\\\\n' +\n    JSON.stringify({ clientBrief, offer, budgetHint, understanding }, null, 2),\n  {\n    label: 'structure',\n    schema: {\n      type: 'object',\n      properties: {\n        deliverables: { type: 'array', items: { type: 'string' } },\n        milestones: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              name: { type: 'string' },\n              duration: { type: 'string' },\n              output: { type: 'string' },\n            },\n            required: ['name', 'output'],\n          },\n        },\n        pricingApproach: { type: 'string' },\n        assumptions: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['deliverables', 'milestones', 'pricingApproach'],\n    },\n  },\n)\n\nphase('Draft')\nconst draft = await agent(\n  'Write a client-ready proposal draft in professional but warm tone. Include executive summary, scope, timeline, pricing section (with rationale), risks, and next steps.\\\\n\\\\n' +\n    JSON.stringify({ understanding, structure }, null, 2),\n  {\n    label: 'draft',\n    schema: {\n      type: 'object',\n      properties: {\n        title: { type: 'string' },\n        executiveSummary: { type: 'string' },\n        scope: { type: 'string' },\n        timeline: { type: 'string' },\n        pricing: { type: 'string' },\n        risks: { type: 'array', items: { type: 'string' } },\n        nextSteps: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['executiveSummary', 'scope', 'pricing', 'nextSteps'],\n    },\n  },\n)\n\nphase('Polish')\nconst polished = await agent(\n  'Polish the proposal: tighten language, add a one-line value prop, flag anything that could scare the client, and suggest 2 negotiation flex points.\\\\n\\\\n' +\n    JSON.stringify(draft, null, 2),\n  {\n    label: 'polish',\n    schema: {\n      type: 'object',\n      properties: {\n        valueProp: { type: 'string' },\n        fullProposal: { type: 'string' },\n        clientConcerns: { type: 'array', items: { type: 'string' } },\n        flexPoints: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['valueProp', 'fullProposal'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  understanding,\n  structure,\n  ...(polished ?? { valueProp: '', fullProposal: 'draft failed' }),\n}\n`\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,yBAAyB"}
+{"version":3,"file":"client-proposal.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/client-proposal.ts"],"sourcesContent":["/**\n * Built-in workflow: `client_proposal`\n *\n * Draft a client-facing proposal from a brief — scope, timeline, pricing logic,\n * risks, and next steps. For freelancers, consultants, and solo service providers.\n *\n * Args:\n *   - client_brief: what the client wants\n *   - offer: what you provide\n *   - budget_hint: budget range or constraints (optional)\n */\n\nexport const CLIENT_PROPOSAL_SCRIPT = `export const meta = {\n  name: 'client_proposal',\n  description: 'Turn a client brief into a structured proposal with scope, timeline, pricing logic, and risks.',\n  whenToUse: 'Freelancer or solo consultant needs a client-ready proposal or SOW draft.',\n  examplePrompts: [\n    { field: 'client_brief', text: 'SaaS startup wants 3-month growth consulting, budget 50–80k CNY' },\n    { field: 'offer', text: 'Audit funnel, weekly strategy calls, async Slack support' },\n  ],\n  i18n: {\n    zh: {\n      description: '将客户需求转化为含范围、时间线、报价逻辑与风险说明的客户方案。',\n      whenToUse: '自由职业者或独立顾问需要起草客户方案 / SOW 时。',\n      examplePrompts: [\n        { field: 'client_brief', text: 'SaaS 创业公司要 3 个月增长咨询，预算 5–8 万' },\n        { field: 'offer', text: '漏斗审计、每周策略会、Slack 异步支持' },\n      ],\n    },\n  },\n  tags: ['writing', 'content', 'document'],\n  estimatedAgents: { min: 4, max: 5 },\n  phases: [\n    { title: 'Understand' },\n    { title: 'Structure' },\n    { title: 'Draft' },\n    { title: 'Polish' },\n  ],\n}\n\nconst clientBrief = args && typeof args === 'object' && args.client_brief\n  ? String(args.client_brief)\n  : 'Infer the client brief from the most recent user turn.'\n\nconst offer = args && typeof args === 'object' && args.offer\n  ? String(args.offer)\n  : 'Infer your offer from context.'\n\nconst budgetHint = args && typeof args === 'object' && args.budget_hint\n  ? String(args.budget_hint)\n  : ''\n\nphase('Understand')\nconst understanding = await agent(\n  'Extract client needs, implicit constraints, success criteria, red flags, and what is out of scope.\\\\n\\\\n' +\n    'CLIENT BRIEF:\\\\n' + clientBrief + '\\\\nYOUR OFFER:\\\\n' + offer +\n    (budgetHint ? '\\\\nBUDGET HINT:\\\\n' + budgetHint : ''),\n  {\n    label: 'understand',\n    schema: {\n      type: 'object',\n      properties: {\n        clientGoals: { type: 'array', items: { type: 'string' } },\n        constraints: { type: 'array', items: { type: 'string' } },\n        successCriteria: { type: 'array', items: { type: 'string' } },\n        redFlags: { type: 'array', items: { type: 'string' } },\n        outOfScope: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['clientGoals', 'successCriteria'],\n    },\n  },\n)\n\nphase('Structure')\nconst structure = await agent(\n  'Design proposal structure: deliverables, milestones, timeline, pricing tiers or logic, assumptions, and exclusions. Fit a solo operator capacity.\\\\n\\\\n' +\n    JSON.stringify({ clientBrief, offer, budgetHint, understanding }, null, 2),\n  {\n    label: 'structure',\n    schema: {\n      type: 'object',\n      properties: {\n        deliverables: { type: 'array', items: { type: 'string' } },\n        milestones: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              name: { type: 'string' },\n              duration: { type: 'string' },\n              output: { type: 'string' },\n            },\n            required: ['name', 'output'],\n          },\n        },\n        pricingApproach: { type: 'string' },\n        assumptions: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['deliverables', 'milestones', 'pricingApproach'],\n    },\n  },\n)\n\nphase('Draft')\nconst draft = await agent(\n  'Write a client-ready proposal draft in professional but warm tone. Include executive summary, scope, timeline, pricing section (with rationale), risks, and next steps.\\\\n\\\\n' +\n    JSON.stringify({ understanding, structure }, null, 2),\n  {\n    label: 'draft',\n    schema: {\n      type: 'object',\n      properties: {\n        title: { type: 'string' },\n        executiveSummary: { type: 'string' },\n        scope: { type: 'string' },\n        timeline: { type: 'string' },\n        pricing: { type: 'string' },\n        risks: { type: 'array', items: { type: 'string' } },\n        nextSteps: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['executiveSummary', 'scope', 'pricing', 'nextSteps'],\n    },\n  },\n)\n\nphase('Polish')\nconst polished = await agent(\n  'Polish the proposal: tighten language, add a one-line value prop, flag anything that could scare the client, and suggest 2 negotiation flex points.\\\\n\\\\n' +\n    JSON.stringify(draft, null, 2),\n  {\n    label: 'polish',\n    schema: {\n      type: 'object',\n      properties: {\n        valueProp: { type: 'string' },\n        fullProposal: { type: 'string' },\n        clientConcerns: { type: 'array', items: { type: 'string' } },\n        flexPoints: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['valueProp', 'fullProposal'],\n    },\n  },\n)\n\nconst output = {\n  ok: true,\n  understanding,\n  structure,\n  ...(polished ?? { valueProp: '', fullProposal: 'draft failed' }),\n}\nreturn {\n  summary: output.valueProp || 'Proposal draft complete.',\n  sections: [\n    { kind: 'text', title: 'Proposal', content: output.fullProposal },\n    { kind: 'questions', title: 'Client concerns', items: output.clientConcerns ?? [] },\n    { kind: 'questions', title: 'Flex points', items: output.flexPoints ?? [] },\n  ],\n  structuredOutput: output,\n}\n`\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,yBAAyB"}