@ashx-j/lunr-dev 0.2.13-dev.8.1 → 0.2.16-dev.9.1

package/dist/builtin-extensions/pi-subagents/src/watchdog/review.d.ts

@@ -1,5 +1,5 @@
 import { type AgentTool, type StreamFn, type ThinkingLevel } from "@ashx-j/lunr-agent";
-import { type ExtensionContext } from "@ashx-j/lunr-dev";
+import type { ExtensionContext } from "@ashx-j/lunr-dev";
 import { type Model } from "@ashx-j/lunr-ai/compat";
 import type { WatchdogReviewFunction } from "./runtime.ts";
 import { type ResolvedWatchdogConfig } from "./types.ts";

package/dist/builtin-extensions/pi-subagents/src/watchdog/review.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/watchdog/review.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACzG,OAAO,EAAqC,KAAK,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAC3G,OAAO,EAAgB,KAAK,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAIxE,OAAO,KAAK,EAAE,sBAAsB,EAAyB,MAAM,cAAc,CAAC;AAClF,OAAO,EAIN,KAAK,sBAAsB,EAK3B,MAAM,YAAY,CAAC;AAepB,KAAK,uBAAuB,GAAG,gBAAgB,GAAG,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC,CAAC;AAEvF,KAAK,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;AAEhC,UAAU,kBAAkB;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC5C,KAAK,EAAE,aAAa,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,+BAA+B;IAC/C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;IACnD,gBAAgB,CAAC,EAAE,MAAM,aAAa,GAAG,SAAS,CAAC;CACnD;AAkED,wBAAsB,0BAA0B,CAC/C,GAAG,EAAE,gBAAgB,EACrB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE;IAAE,oBAAoB,CAAC,EAAE,aAAa,CAAA;CAAO,GACpD,OAAO,CAAC,4BAA4B,CAAC,CAiCvC;AAwFD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,uBAAuB,EAAE,OAAO,GAAE,+BAAoC,GAAG,sBAAsB,CAgDjJ","sourcesContent":["// @ts-nocheck\nimport { Agent, type AgentTool, type StreamFn, type ThinkingLevel } from \"@ashx-j/lunr-agent\";\nimport { createReadOnlyTools, convertToLlm, type ExtensionContext } from \"@ashx-j/lunr-dev\";\nimport { streamSimple, type Model } from \"@ashx-j/lunr-ai/compat\";\nimport { Type, type Static } from \"typebox\";\nimport { resolveModelCandidate } from \"../runs/shared/model-fallback.ts\";\nimport { resolveEffectiveThinking, splitKnownThinkingSuffix, THINKING_LEVELS, toModelInfo } from \"../shared/model-info.ts\";\nimport type { WatchdogReviewFunction, WatchdogReviewRequest } from \"./runtime.ts\";\nimport {\n\tWATCHDOG_WARNING_CATEGORIES,\n\tWATCHDOG_WARNING_CONFIDENCES,\n\tWATCHDOG_WARNING_SEVERITIES,\n\ttype ResolvedWatchdogConfig,\n\ttype WatchdogCategory,\n\ttype WatchdogConfidence,\n\ttype WatchdogSeverity,\n\ttype WatchdogWarning,\n} from \"./types.ts\";\n\nconst WATCHDOG_ALLOWED_TOOL_NAMES = new Set([\"read\", \"grep\", \"find\", \"ls\", \"watchdog_warn\"]);\n\nconst WatchdogWarnParams = Type.Object({\n\tseverity: Type.String({ enum: WATCHDOG_WARNING_SEVERITIES, description: \"concern for actionable risk, blocker for a likely wrong or unsafe outcome\" }),\n\tsummary: Type.String({ description: \"One concise sentence naming the issue.\" }),\n\tevidence: Type.String({ description: \"Specific evidence from the turn delta or inspected files.\" }),\n\trecommendedAction: Type.String({ description: \"Specific action the parent should take before accepting or continuing.\" }),\n\tcategory: Type.Optional(Type.String({ enum: WATCHDOG_WARNING_CATEGORIES })),\n\tconfidence: Type.Optional(Type.String({ enum: WATCHDOG_WARNING_CONFIDENCES })),\n}, { additionalProperties: false });\n\ntype WatchdogWarnParams = Static<typeof WatchdogWarnParams>;\n\ntype WatchdogContextProvider = ExtensionContext | (() => ExtensionContext | undefined);\n\ntype RegistryModel = Model<any>;\n\ninterface WatchdogReviewAuth {\n\tapiKey?: string;\n\theaders?: Record<string, string>;\n\tenv?: Record<string, string>;\n}\n\nexport interface WatchdogReviewModelSelection {\n\tmodel: RegistryModel;\n\tthinkingLevel: ThinkingLevel;\n\tauth: WatchdogReviewAuth;\n\texplicit: boolean;\n}\n\nexport interface CreateMainWatchdogReviewOptions {\n\tstreamFn?: StreamFn;\n\tcreateReadOnlyTools?: (cwd: string) => AgentTool[];\n\tgetThinkingLevel?: () => ThinkingLevel | undefined;\n}\n\nfunction fullModelId(model: Pick<RegistryModel, \"provider\" | \"id\">): string {\n\treturn `${model.provider}/${model.id}`;\n}\n\nfunction splitProviderModel(value: string): { provider: string; id: string } | undefined {\n\tconst slashIndex = value.indexOf(\"/\");\n\tif (slashIndex <= 0 || slashIndex === value.length - 1) return undefined;\n\treturn { provider: value.slice(0, slashIndex), id: value.slice(slashIndex + 1) };\n}\n\nfunction assertThinkingLevel(value: string, source: string): ThinkingLevel {\n\tif ((THINKING_LEVELS as readonly string[]).includes(value)) return value as ThinkingLevel;\n\tthrow new Error(`Unsupported watchdog thinking level '${value}' from ${source}; expected ${THINKING_LEVELS.join(\", \")} or false.`);\n}\n\nfunction contextThinkingLevel(ctx: ExtensionContext, currentThinkingLevel: ThinkingLevel | undefined): ThinkingLevel | undefined {\n\tif (currentThinkingLevel) return currentThinkingLevel;\n\tconst value = (ctx as { thinkingLevel?: unknown }).thinkingLevel;\n\treturn typeof value === \"string\" && (THINKING_LEVELS as readonly string[]).includes(value) ? value as ThinkingLevel : undefined;\n}\n\nfunction resolveReviewThinking(input: {\n\tmodelString: string;\n\tconfigThinking: string | false | undefined;\n\tctx: ExtensionContext;\n\tallowContextThinking: boolean;\n\tcurrentThinkingLevel?: ThinkingLevel;\n}): ThinkingLevel {\n\tconst fromModelOrConfig = resolveEffectiveThinking(input.modelString, input.configThinking);\n\tif (fromModelOrConfig) return assertThinkingLevel(fromModelOrConfig, \"watchdog model/config\");\n\tif (input.configThinking === false) return \"off\";\n\tif (input.configThinking !== undefined) return assertThinkingLevel(input.configThinking, \"watchdog config\");\n\tif (input.allowContextThinking) return contextThinkingLevel(input.ctx, input.currentThinkingLevel) ?? \"off\";\n\treturn \"off\";\n}\n\nfunction resolveConfiguredModel(ctx: ExtensionContext, rawModel: string): { model: RegistryModel; modelString: string } {\n\tconst availableModels = ctx.modelRegistry.getAvailable().map(toModelInfo);\n\tconst preferredProvider = typeof ctx.model?.provider === \"string\" ? ctx.model.provider : undefined;\n\tconst resolved = resolveModelCandidate(rawModel, availableModels, preferredProvider);\n\tconst { baseModel } = splitKnownThinkingSuffix(resolved);\n\tconst named = splitProviderModel(baseModel);\n\tif (!named) {\n\t\tthrow new Error(`Configured watchdog model '${rawModel}' did not match exactly one authenticated available model. Use provider/model or configure credentials for the intended provider.`);\n\t}\n\n\tconst model = ctx.modelRegistry.find(named.provider, named.id);\n\tif (!model) throw new Error(`Configured watchdog model '${rawModel}' was not found as '${baseModel}'.`);\n\tif (!ctx.modelRegistry.hasConfiguredAuth(model)) {\n\t\tthrow new Error(`Configured watchdog model '${baseModel}' is not authenticated. Configure credentials for provider '${named.provider}' or choose an authenticated model.`);\n\t}\n\treturn { model, modelString: resolved };\n}\n\nasync function resolveReviewAuth(ctx: ExtensionContext, model: RegistryModel): Promise<WatchdogReviewAuth> {\n\tconst auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);\n\tif (!auth.ok) throw new Error(`Watchdog model auth failed for ${fullModelId(model)}: ${auth.error}`);\n\treturn {\n\t\t...(auth.apiKey ? { apiKey: auth.apiKey } : {}),\n\t\t...(auth.headers ? { headers: auth.headers } : {}),\n\t\t...(auth.env ? { env: auth.env } : {}),\n\t};\n}\n\nexport async function resolveWatchdogReviewModel(\n\tctx: ExtensionContext,\n\tconfig: ResolvedWatchdogConfig,\n\toptions: { currentThinkingLevel?: ThinkingLevel } = {},\n): Promise<WatchdogReviewModelSelection> {\n\tif (config.main.model) {\n\t\tconst resolved = resolveConfiguredModel(ctx, config.main.model);\n\t\treturn {\n\t\t\tmodel: resolved.model,\n\t\t\tthinkingLevel: resolveReviewThinking({\n\t\t\t\tmodelString: resolved.modelString,\n\t\t\t\tconfigThinking: config.main.thinking,\n\t\t\t\tctx,\n\t\t\t\tallowContextThinking: false,\n\t\t\t\tcurrentThinkingLevel: options.currentThinkingLevel,\n\t\t\t}),\n\t\t\tauth: await resolveReviewAuth(ctx, resolved.model),\n\t\t\texplicit: true,\n\t\t};\n\t}\n\n\tconst currentModel = ctx.model;\n\tif (!currentModel) {\n\t\tthrow new Error(\"Main watchdog review cannot run because the current Pi session model is unavailable and subagents.watchdog.main.model is not configured.\");\n\t}\n\treturn {\n\t\tmodel: currentModel,\n\t\tthinkingLevel: resolveReviewThinking({\n\t\t\tmodelString: fullModelId(currentModel),\n\t\t\tconfigThinking: config.main.thinking,\n\t\t\tctx,\n\t\t\tallowContextThinking: true,\n\t\t\tcurrentThinkingLevel: options.currentThinkingLevel,\n\t\t}),\n\t\tauth: await resolveReviewAuth(ctx, currentModel),\n\t\texplicit: false,\n\t};\n}\n\nfunction nonEmptyString(value: string, field: string): string {\n\tconst trimmed = value.trim();\n\tif (!trimmed) throw new Error(`watchdog_warn.${field} must be a non-empty string.`);\n\treturn trimmed;\n}\n\nfunction toWatchdogWarning(params: WatchdogWarnParams): WatchdogWarning {\n\treturn {\n\t\tseverity: params.severity as WatchdogSeverity,\n\t\tcategory: (params.category ?? \"other\") as WatchdogCategory,\n\t\tconfidence: (params.confidence ?? \"medium\") as WatchdogConfidence,\n\t\tsource: \"main\",\n\t\tsummary: nonEmptyString(params.summary, \"summary\"),\n\t\tevidence: nonEmptyString(params.evidence, \"evidence\"),\n\t\trecommendedAction: nonEmptyString(params.recommendedAction, \"recommendedAction\"),\n\t};\n}\n\nfunction createWatchdogWarnTool(request: WatchdogReviewRequest): AgentTool<typeof WatchdogWarnParams, { accepted: boolean }> {\n\treturn {\n\t\tname: \"watchdog_warn\",\n\t\tlabel: \"Watchdog warning\",\n\t\tdescription: [\n\t\t\t\"Emit one actionable main-session watchdog warning.\",\n\t\t\t\"Use only for medium/high confidence concerns or blockers that the parent should consider before accepting the work.\",\n\t\t\t\"Do not use for nits, praise, informational notes, or clean reviews.\",\n\t\t].join(\" \"),\n\t\tparameters: WatchdogWarnParams,\n\t\texecutionMode: \"sequential\",\n\t\tasync execute(_toolCallId, params) {\n\t\t\tconst warning = toWatchdogWarning(params);\n\t\t\tconst accepted = request.emitWarning(warning);\n\t\t\treturn {\n\t\t\t\tcontent: [{\n\t\t\t\t\ttype: \"text\",\n\t\t\t\t\ttext: accepted\n\t\t\t\t\t\t? \"Watchdog warning recorded.\"\n\t\t\t\t\t\t: \"Watchdog warning was ignored by the runtime guard because it was stale, duplicate, or over budget.\",\n\t\t\t\t}],\n\t\t\t\tdetails: { accepted },\n\t\t\t};\n\t\t},\n\t};\n}\n\nfunction buildWatchdogSystemPrompt(ctx: ExtensionContext): string {\n\treturn [\n\t\t\"You are the main-session subagent watchdog for Pi.\",\n\t\t`Working directory: ${ctx.cwd}`,\n\t\t\"Review only the supplied parent turn delta. Inspect repository files only when needed to verify a concrete concern.\",\n\t\t\"You are read-only. You may use read, grep, find, and ls. Do not edit files, run shell commands, spawn agents, or mutate state.\",\n\t\t\"Emit warnings only by calling watchdog_warn. Freeform assistant text is ignored and must not be used to report warnings.\",\n\t\t\"Emit only medium/high confidence actionable concerns or blockers: missed user constraints, correctness risks, test gaps that matter, unsafe changes, stale facts, loop risks, or scope drift.\",\n\t\t\"Do not emit nits, style preferences, low-confidence guesses, informational notes, praise, or summaries.\",\n\t\t\"If the turn is clean, call no tools and end normally.\",\n\t\t\"Use severity='blocker' only when the issue should stop acceptance until addressed; otherwise use severity='concern'.\",\n\t].join(\"\\n\");\n}\n\nfunction buildReviewPrompt(request: WatchdogReviewRequest, selection: WatchdogReviewModelSelection): string {\n\treturn [\n\t\t\"Review this parent-session turn delta for subagent-watchdog-worthy issues.\",\n\t\t`Review id: ${request.reviewId}; epoch: ${request.epoch}; review model: ${fullModelId(selection.model)}; thinking: ${selection.thinkingLevel}.`,\n\t\t\"Call watchdog_warn for each qualifying concern or blocker. Call no tools when clean.\",\n\t\t\"<turn_delta>\",\n\t\trequest.delta,\n\t\t\"</turn_delta>\",\n\t].join(\"\\n\\n\");\n}\n\nfunction finalStopReason(agent: Agent): \"stop\" | \"error\" | \"aborted\" | \"length\" {\n\tfor (let index = agent.state.messages.length - 1; index >= 0; index--) {\n\t\tconst message = agent.state.messages[index];\n\t\tif (message && typeof message === \"object\" && (message as { role?: unknown }).role === \"assistant\") {\n\t\t\tconst stopReason = (message as { stopReason?: unknown }).stopReason;\n\t\t\tif (stopReason === \"error\" || stopReason === \"aborted\" || stopReason === \"length\") return stopReason;\n\t\t\treturn \"stop\";\n\t\t}\n\t}\n\treturn \"stop\";\n}\n\nfunction resolveContext(provider: WatchdogContextProvider): ExtensionContext | undefined {\n\treturn typeof provider === \"function\" ? provider() : provider;\n}\n\nexport function createMainWatchdogReview(provider: WatchdogContextProvider, options: CreateMainWatchdogReviewOptions = {}): WatchdogReviewFunction {\n\treturn async (request) => {\n\t\tconst ctx = resolveContext(provider);\n\t\tif (!ctx) throw new Error(\"Main watchdog review cannot run without an active Pi extension context.\");\n\t\tif (ctx.signal?.aborted || request.signal?.aborted) return { stopReason: \"aborted\" };\n\t\tconst selection = await resolveWatchdogReviewModel(ctx, request.config, {\n\t\t\tcurrentThinkingLevel: options.getThinkingLevel?.(),\n\t\t});\n\t\tif (ctx.signal?.aborted || request.signal?.aborted) return { stopReason: \"aborted\" };\n\t\tconst auth = selection.auth;\n\t\tconst baseStreamFn = options.streamFn ?? streamSimple;\n\t\tconst streamFn: StreamFn = (model, context, streamOptions) => baseStreamFn(model, context, {\n\t\t\t...streamOptions,\n\t\t\t...(auth.apiKey ? { apiKey: auth.apiKey } : {}),\n\t\t\tenv: auth.env || streamOptions?.env ? { ...(auth.env ?? {}), ...(streamOptions?.env ?? {}) } : undefined,\n\t\t\theaders: { ...(streamOptions?.headers ?? {}), ...(auth.headers ?? {}) },\n\t\t});\n\t\tconst tools = [\n\t\t\t...(options.createReadOnlyTools ?? createReadOnlyTools)(ctx.cwd).filter((tool) => WATCHDOG_ALLOWED_TOOL_NAMES.has(tool.name) && tool.name !== \"watchdog_warn\"),\n\t\t\tcreateWatchdogWarnTool(request),\n\t\t];\n\t\tconst agent = new Agent({\n\t\t\tinitialState: {\n\t\t\t\tsystemPrompt: buildWatchdogSystemPrompt(ctx),\n\t\t\t\tmodel: selection.model,\n\t\t\t\tthinkingLevel: selection.thinkingLevel,\n\t\t\t\ttools,\n\t\t\t},\n\t\t\tconvertToLlm,\n\t\t\tstreamFn,\n\t\t\tgetApiKey: (providerName) => providerName === selection.model.provider ? auth.apiKey : undefined,\n\t\t\tbeforeToolCall: async ({ toolCall }) => WATCHDOG_ALLOWED_TOOL_NAMES.has(toolCall.name)\n\t\t\t\t? undefined\n\t\t\t\t: { block: true, reason: `Watchdog reviews are read-only; tool '${toolCall.name}' is not allowed.` },\n\t\t\ttoolExecution: \"sequential\",\n\t\t});\n\t\tconst abort = () => agent.abort();\n\t\tctx.signal?.addEventListener(\"abort\", abort, { once: true });\n\t\trequest.signal?.addEventListener(\"abort\", abort, { once: true });\n\t\ttry {\n\t\t\tif (ctx.signal?.aborted || request.signal?.aborted) return { stopReason: \"aborted\" };\n\t\t\tawait agent.prompt(buildReviewPrompt(request, selection));\n\t\t} finally {\n\t\t\tctx.signal?.removeEventListener(\"abort\", abort);\n\t\t\trequest.signal?.removeEventListener(\"abort\", abort);\n\t\t}\n\t\treturn { stopReason: finalStopReason(agent) };\n\t};\n}\n"]}
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/watchdog/review.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACzG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGxE,OAAO,EAAgB,KAAK,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAIxE,OAAO,KAAK,EAAE,sBAAsB,EAAyB,MAAM,cAAc,CAAC;AAClF,OAAO,EAIN,KAAK,sBAAsB,EAK3B,MAAM,YAAY,CAAC;AAepB,KAAK,uBAAuB,GAAG,gBAAgB,GAAG,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC,CAAC;AAEvF,KAAK,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;AAEhC,UAAU,kBAAkB;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC5C,KAAK,EAAE,aAAa,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,+BAA+B;IAC/C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;IACnD,gBAAgB,CAAC,EAAE,MAAM,aAAa,GAAG,SAAS,CAAC;CACnD;AAkED,wBAAsB,0BAA0B,CAC/C,GAAG,EAAE,gBAAgB,EACrB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,GAAE;IAAE,oBAAoB,CAAC,EAAE,aAAa,CAAA;CAAO,GACpD,OAAO,CAAC,4BAA4B,CAAC,CAiCvC;AAwFD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,uBAAuB,EAAE,OAAO,GAAE,+BAAoC,GAAG,sBAAsB,CAgDjJ","sourcesContent":["// @ts-nocheck\nimport { Agent, type AgentTool, type StreamFn, type ThinkingLevel } from \"@ashx-j/lunr-agent\";\nimport type { ExtensionContext } from \"@ashx-j/lunr-dev\";\nimport { createReadOnlyTools } from \"../../../../core/tools/index.ts\";\nimport { convertToLlm } from \"../../../../core/messages.ts\";\nimport { streamSimple, type Model } from \"@ashx-j/lunr-ai/compat\";\nimport { Type, type Static } from \"typebox\";\nimport { resolveModelCandidate } from \"../runs/shared/model-fallback.ts\";\nimport { resolveEffectiveThinking, splitKnownThinkingSuffix, THINKING_LEVELS, toModelInfo } from \"../shared/model-info.ts\";\nimport type { WatchdogReviewFunction, WatchdogReviewRequest } from \"./runtime.ts\";\nimport {\n\tWATCHDOG_WARNING_CATEGORIES,\n\tWATCHDOG_WARNING_CONFIDENCES,\n\tWATCHDOG_WARNING_SEVERITIES,\n\ttype ResolvedWatchdogConfig,\n\ttype WatchdogCategory,\n\ttype WatchdogConfidence,\n\ttype WatchdogSeverity,\n\ttype WatchdogWarning,\n} from \"./types.ts\";\n\nconst WATCHDOG_ALLOWED_TOOL_NAMES = new Set([\"read\", \"grep\", \"find\", \"ls\", \"watchdog_warn\"]);\n\nconst WatchdogWarnParams = Type.Object({\n\tseverity: Type.String({ enum: WATCHDOG_WARNING_SEVERITIES, description: \"concern for actionable risk, blocker for a likely wrong or unsafe outcome\" }),\n\tsummary: Type.String({ description: \"One concise sentence naming the issue.\" }),\n\tevidence: Type.String({ description: \"Specific evidence from the turn delta or inspected files.\" }),\n\trecommendedAction: Type.String({ description: \"Specific action the parent should take before accepting or continuing.\" }),\n\tcategory: Type.Optional(Type.String({ enum: WATCHDOG_WARNING_CATEGORIES })),\n\tconfidence: Type.Optional(Type.String({ enum: WATCHDOG_WARNING_CONFIDENCES })),\n}, { additionalProperties: false });\n\ntype WatchdogWarnParams = Static<typeof WatchdogWarnParams>;\n\ntype WatchdogContextProvider = ExtensionContext | (() => ExtensionContext | undefined);\n\ntype RegistryModel = Model<any>;\n\ninterface WatchdogReviewAuth {\n\tapiKey?: string;\n\theaders?: Record<string, string>;\n\tenv?: Record<string, string>;\n}\n\nexport interface WatchdogReviewModelSelection {\n\tmodel: RegistryModel;\n\tthinkingLevel: ThinkingLevel;\n\tauth: WatchdogReviewAuth;\n\texplicit: boolean;\n}\n\nexport interface CreateMainWatchdogReviewOptions {\n\tstreamFn?: StreamFn;\n\tcreateReadOnlyTools?: (cwd: string) => AgentTool[];\n\tgetThinkingLevel?: () => ThinkingLevel | undefined;\n}\n\nfunction fullModelId(model: Pick<RegistryModel, \"provider\" | \"id\">): string {\n\treturn `${model.provider}/${model.id}`;\n}\n\nfunction splitProviderModel(value: string): { provider: string; id: string } | undefined {\n\tconst slashIndex = value.indexOf(\"/\");\n\tif (slashIndex <= 0 || slashIndex === value.length - 1) return undefined;\n\treturn { provider: value.slice(0, slashIndex), id: value.slice(slashIndex + 1) };\n}\n\nfunction assertThinkingLevel(value: string, source: string): ThinkingLevel {\n\tif ((THINKING_LEVELS as readonly string[]).includes(value)) return value as ThinkingLevel;\n\tthrow new Error(`Unsupported watchdog thinking level '${value}' from ${source}; expected ${THINKING_LEVELS.join(\", \")} or false.`);\n}\n\nfunction contextThinkingLevel(ctx: ExtensionContext, currentThinkingLevel: ThinkingLevel | undefined): ThinkingLevel | undefined {\n\tif (currentThinkingLevel) return currentThinkingLevel;\n\tconst value = (ctx as { thinkingLevel?: unknown }).thinkingLevel;\n\treturn typeof value === \"string\" && (THINKING_LEVELS as readonly string[]).includes(value) ? value as ThinkingLevel : undefined;\n}\n\nfunction resolveReviewThinking(input: {\n\tmodelString: string;\n\tconfigThinking: string | false | undefined;\n\tctx: ExtensionContext;\n\tallowContextThinking: boolean;\n\tcurrentThinkingLevel?: ThinkingLevel;\n}): ThinkingLevel {\n\tconst fromModelOrConfig = resolveEffectiveThinking(input.modelString, input.configThinking);\n\tif (fromModelOrConfig) return assertThinkingLevel(fromModelOrConfig, \"watchdog model/config\");\n\tif (input.configThinking === false) return \"off\";\n\tif (input.configThinking !== undefined) return assertThinkingLevel(input.configThinking, \"watchdog config\");\n\tif (input.allowContextThinking) return contextThinkingLevel(input.ctx, input.currentThinkingLevel) ?? \"off\";\n\treturn \"off\";\n}\n\nfunction resolveConfiguredModel(ctx: ExtensionContext, rawModel: string): { model: RegistryModel; modelString: string } {\n\tconst availableModels = ctx.modelRegistry.getAvailable().map(toModelInfo);\n\tconst preferredProvider = typeof ctx.model?.provider === \"string\" ? ctx.model.provider : undefined;\n\tconst resolved = resolveModelCandidate(rawModel, availableModels, preferredProvider);\n\tconst { baseModel } = splitKnownThinkingSuffix(resolved);\n\tconst named = splitProviderModel(baseModel);\n\tif (!named) {\n\t\tthrow new Error(`Configured watchdog model '${rawModel}' did not match exactly one authenticated available model. Use provider/model or configure credentials for the intended provider.`);\n\t}\n\n\tconst model = ctx.modelRegistry.find(named.provider, named.id);\n\tif (!model) throw new Error(`Configured watchdog model '${rawModel}' was not found as '${baseModel}'.`);\n\tif (!ctx.modelRegistry.hasConfiguredAuth(model)) {\n\t\tthrow new Error(`Configured watchdog model '${baseModel}' is not authenticated. Configure credentials for provider '${named.provider}' or choose an authenticated model.`);\n\t}\n\treturn { model, modelString: resolved };\n}\n\nasync function resolveReviewAuth(ctx: ExtensionContext, model: RegistryModel): Promise<WatchdogReviewAuth> {\n\tconst auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);\n\tif (!auth.ok) throw new Error(`Watchdog model auth failed for ${fullModelId(model)}: ${auth.error}`);\n\treturn {\n\t\t...(auth.apiKey ? { apiKey: auth.apiKey } : {}),\n\t\t...(auth.headers ? { headers: auth.headers } : {}),\n\t\t...(auth.env ? { env: auth.env } : {}),\n\t};\n}\n\nexport async function resolveWatchdogReviewModel(\n\tctx: ExtensionContext,\n\tconfig: ResolvedWatchdogConfig,\n\toptions: { currentThinkingLevel?: ThinkingLevel } = {},\n): Promise<WatchdogReviewModelSelection> {\n\tif (config.main.model) {\n\t\tconst resolved = resolveConfiguredModel(ctx, config.main.model);\n\t\treturn {\n\t\t\tmodel: resolved.model,\n\t\t\tthinkingLevel: resolveReviewThinking({\n\t\t\t\tmodelString: resolved.modelString,\n\t\t\t\tconfigThinking: config.main.thinking,\n\t\t\t\tctx,\n\t\t\t\tallowContextThinking: false,\n\t\t\t\tcurrentThinkingLevel: options.currentThinkingLevel,\n\t\t\t}),\n\t\t\tauth: await resolveReviewAuth(ctx, resolved.model),\n\t\t\texplicit: true,\n\t\t};\n\t}\n\n\tconst currentModel = ctx.model;\n\tif (!currentModel) {\n\t\tthrow new Error(\"Main watchdog review cannot run because the current Pi session model is unavailable and subagents.watchdog.main.model is not configured.\");\n\t}\n\treturn {\n\t\tmodel: currentModel,\n\t\tthinkingLevel: resolveReviewThinking({\n\t\t\tmodelString: fullModelId(currentModel),\n\t\t\tconfigThinking: config.main.thinking,\n\t\t\tctx,\n\t\t\tallowContextThinking: true,\n\t\t\tcurrentThinkingLevel: options.currentThinkingLevel,\n\t\t}),\n\t\tauth: await resolveReviewAuth(ctx, currentModel),\n\t\texplicit: false,\n\t};\n}\n\nfunction nonEmptyString(value: string, field: string): string {\n\tconst trimmed = value.trim();\n\tif (!trimmed) throw new Error(`watchdog_warn.${field} must be a non-empty string.`);\n\treturn trimmed;\n}\n\nfunction toWatchdogWarning(params: WatchdogWarnParams): WatchdogWarning {\n\treturn {\n\t\tseverity: params.severity as WatchdogSeverity,\n\t\tcategory: (params.category ?? \"other\") as WatchdogCategory,\n\t\tconfidence: (params.confidence ?? \"medium\") as WatchdogConfidence,\n\t\tsource: \"main\",\n\t\tsummary: nonEmptyString(params.summary, \"summary\"),\n\t\tevidence: nonEmptyString(params.evidence, \"evidence\"),\n\t\trecommendedAction: nonEmptyString(params.recommendedAction, \"recommendedAction\"),\n\t};\n}\n\nfunction createWatchdogWarnTool(request: WatchdogReviewRequest): AgentTool<typeof WatchdogWarnParams, { accepted: boolean }> {\n\treturn {\n\t\tname: \"watchdog_warn\",\n\t\tlabel: \"Watchdog warning\",\n\t\tdescription: [\n\t\t\t\"Emit one actionable main-session watchdog warning.\",\n\t\t\t\"Use only for medium/high confidence concerns or blockers that the parent should consider before accepting the work.\",\n\t\t\t\"Do not use for nits, praise, informational notes, or clean reviews.\",\n\t\t].join(\" \"),\n\t\tparameters: WatchdogWarnParams,\n\t\texecutionMode: \"sequential\",\n\t\tasync execute(_toolCallId, params) {\n\t\t\tconst warning = toWatchdogWarning(params);\n\t\t\tconst accepted = request.emitWarning(warning);\n\t\t\treturn {\n\t\t\t\tcontent: [{\n\t\t\t\t\ttype: \"text\",\n\t\t\t\t\ttext: accepted\n\t\t\t\t\t\t? \"Watchdog warning recorded.\"\n\t\t\t\t\t\t: \"Watchdog warning was ignored by the runtime guard because it was stale, duplicate, or over budget.\",\n\t\t\t\t}],\n\t\t\t\tdetails: { accepted },\n\t\t\t};\n\t\t},\n\t};\n}\n\nfunction buildWatchdogSystemPrompt(ctx: ExtensionContext): string {\n\treturn [\n\t\t\"You are the main-session subagent watchdog for Pi.\",\n\t\t`Working directory: ${ctx.cwd}`,\n\t\t\"Review only the supplied parent turn delta. Inspect repository files only when needed to verify a concrete concern.\",\n\t\t\"You are read-only. You may use read, grep, find, and ls. Do not edit files, run shell commands, spawn agents, or mutate state.\",\n\t\t\"Emit warnings only by calling watchdog_warn. Freeform assistant text is ignored and must not be used to report warnings.\",\n\t\t\"Emit only medium/high confidence actionable concerns or blockers: missed user constraints, correctness risks, test gaps that matter, unsafe changes, stale facts, loop risks, or scope drift.\",\n\t\t\"Do not emit nits, style preferences, low-confidence guesses, informational notes, praise, or summaries.\",\n\t\t\"If the turn is clean, call no tools and end normally.\",\n\t\t\"Use severity='blocker' only when the issue should stop acceptance until addressed; otherwise use severity='concern'.\",\n\t].join(\"\\n\");\n}\n\nfunction buildReviewPrompt(request: WatchdogReviewRequest, selection: WatchdogReviewModelSelection): string {\n\treturn [\n\t\t\"Review this parent-session turn delta for subagent-watchdog-worthy issues.\",\n\t\t`Review id: ${request.reviewId}; epoch: ${request.epoch}; review model: ${fullModelId(selection.model)}; thinking: ${selection.thinkingLevel}.`,\n\t\t\"Call watchdog_warn for each qualifying concern or blocker. Call no tools when clean.\",\n\t\t\"<turn_delta>\",\n\t\trequest.delta,\n\t\t\"</turn_delta>\",\n\t].join(\"\\n\\n\");\n}\n\nfunction finalStopReason(agent: Agent): \"stop\" | \"error\" | \"aborted\" | \"length\" {\n\tfor (let index = agent.state.messages.length - 1; index >= 0; index--) {\n\t\tconst message = agent.state.messages[index];\n\t\tif (message && typeof message === \"object\" && (message as { role?: unknown }).role === \"assistant\") {\n\t\t\tconst stopReason = (message as { stopReason?: unknown }).stopReason;\n\t\t\tif (stopReason === \"error\" || stopReason === \"aborted\" || stopReason === \"length\") return stopReason;\n\t\t\treturn \"stop\";\n\t\t}\n\t}\n\treturn \"stop\";\n}\n\nfunction resolveContext(provider: WatchdogContextProvider): ExtensionContext | undefined {\n\treturn typeof provider === \"function\" ? provider() : provider;\n}\n\nexport function createMainWatchdogReview(provider: WatchdogContextProvider, options: CreateMainWatchdogReviewOptions = {}): WatchdogReviewFunction {\n\treturn async (request) => {\n\t\tconst ctx = resolveContext(provider);\n\t\tif (!ctx) throw new Error(\"Main watchdog review cannot run without an active Pi extension context.\");\n\t\tif (ctx.signal?.aborted || request.signal?.aborted) return { stopReason: \"aborted\" };\n\t\tconst selection = await resolveWatchdogReviewModel(ctx, request.config, {\n\t\t\tcurrentThinkingLevel: options.getThinkingLevel?.(),\n\t\t});\n\t\tif (ctx.signal?.aborted || request.signal?.aborted) return { stopReason: \"aborted\" };\n\t\tconst auth = selection.auth;\n\t\tconst baseStreamFn = options.streamFn ?? streamSimple;\n\t\tconst streamFn: StreamFn = (model, context, streamOptions) => baseStreamFn(model, context, {\n\t\t\t...streamOptions,\n\t\t\t...(auth.apiKey ? { apiKey: auth.apiKey } : {}),\n\t\t\tenv: auth.env || streamOptions?.env ? { ...(auth.env ?? {}), ...(streamOptions?.env ?? {}) } : undefined,\n\t\t\theaders: { ...(streamOptions?.headers ?? {}), ...(auth.headers ?? {}) },\n\t\t});\n\t\tconst tools = [\n\t\t\t...(options.createReadOnlyTools ?? createReadOnlyTools)(ctx.cwd).filter((tool) => WATCHDOG_ALLOWED_TOOL_NAMES.has(tool.name) && tool.name !== \"watchdog_warn\"),\n\t\t\tcreateWatchdogWarnTool(request),\n\t\t];\n\t\tconst agent = new Agent({\n\t\t\tinitialState: {\n\t\t\t\tsystemPrompt: buildWatchdogSystemPrompt(ctx),\n\t\t\t\tmodel: selection.model,\n\t\t\t\tthinkingLevel: selection.thinkingLevel,\n\t\t\t\ttools,\n\t\t\t},\n\t\t\tconvertToLlm,\n\t\t\tstreamFn,\n\t\t\tgetApiKey: (providerName) => providerName === selection.model.provider ? auth.apiKey : undefined,\n\t\t\tbeforeToolCall: async ({ toolCall }) => WATCHDOG_ALLOWED_TOOL_NAMES.has(toolCall.name)\n\t\t\t\t? undefined\n\t\t\t\t: { block: true, reason: `Watchdog reviews are read-only; tool '${toolCall.name}' is not allowed.` },\n\t\t\ttoolExecution: \"sequential\",\n\t\t});\n\t\tconst abort = () => agent.abort();\n\t\tctx.signal?.addEventListener(\"abort\", abort, { once: true });\n\t\trequest.signal?.addEventListener(\"abort\", abort, { once: true });\n\t\ttry {\n\t\t\tif (ctx.signal?.aborted || request.signal?.aborted) return { stopReason: \"aborted\" };\n\t\t\tawait agent.prompt(buildReviewPrompt(request, selection));\n\t\t} finally {\n\t\t\tctx.signal?.removeEventListener(\"abort\", abort);\n\t\t\trequest.signal?.removeEventListener(\"abort\", abort);\n\t\t}\n\t\treturn { stopReason: finalStopReason(agent) };\n\t};\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/watchdog/review.js

@@ -1,6 +1,7 @@
 // @ts-nocheck
 import { Agent } from "@ashx-j/lunr-agent";
-import { createReadOnlyTools, convertToLlm } from "@ashx-j/lunr-dev";
+import { createReadOnlyTools } from "../../../../core/tools/index.js";
+import { convertToLlm } from "../../../../core/messages.js";
 import { streamSimple } from "@ashx-j/lunr-ai/compat";
 import { Type } from "typebox";
 import { resolveModelCandidate } from "../runs/shared/model-fallback.js";

package/dist/builtin-extensions/pi-subagents/src/watchdog/review.js.map

@@ -1 +1 @@
-{"version":3,"file":"review.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/watchdog/review.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport { Agent, type AgentTool, type StreamFn, type ThinkingLevel } from \"@ashx-j/lunr-agent\";\nimport { createReadOnlyTools, convertToLlm, type ExtensionContext } from \"@ashx-j/lunr-dev\";\nimport { streamSimple, type Model } from \"@ashx-j/lunr-ai/compat\";\nimport { Type, type Static } from \"typebox\";\nimport { resolveModelCandidate } from \"../runs/shared/model-fallback.ts\";\nimport { resolveEffectiveThinking, splitKnownThinkingSuffix, THINKING_LEVELS, toModelInfo } from \"../shared/model-info.ts\";\nimport type { WatchdogReviewFunction, WatchdogReviewRequest } from \"./runtime.ts\";\nimport {\n\tWATCHDOG_WARNING_CATEGORIES,\n\tWATCHDOG_WARNING_CONFIDENCES,\n\tWATCHDOG_WARNING_SEVERITIES,\n\ttype ResolvedWatchdogConfig,\n\ttype WatchdogCategory,\n\ttype WatchdogConfidence,\n\ttype WatchdogSeverity,\n\ttype WatchdogWarning,\n} from \"./types.ts\";\n\nconst WATCHDOG_ALLOWED_TOOL_NAMES = new Set([\"read\", \"grep\", \"find\", \"ls\", \"watchdog_warn\"]);\n\nconst WatchdogWarnParams = Type.Object({\n\tseverity: Type.String({ enum: WATCHDOG_WARNING_SEVERITIES, description: \"concern for actionable risk, blocker for a likely wrong or unsafe outcome\" }),\n\tsummary: Type.String({ description: \"One concise sentence naming the issue.\" }),\n\tevidence: Type.String({ description: \"Specific evidence from the turn delta or inspected files.\" }),\n\trecommendedAction: Type.String({ description: \"Specific action the parent should take before accepting or continuing.\" }),\n\tcategory: Type.Optional(Type.String({ enum: WATCHDOG_WARNING_CATEGORIES })),\n\tconfidence: Type.Optional(Type.String({ enum: WATCHDOG_WARNING_CONFIDENCES })),\n}, { additionalProperties: false });\n\ntype WatchdogWarnParams = Static<typeof WatchdogWarnParams>;\n\ntype WatchdogContextProvider = ExtensionContext | (() => ExtensionContext | undefined);\n\ntype RegistryModel = Model<any>;\n\ninterface WatchdogReviewAuth {\n\tapiKey?: string;\n\theaders?: Record<string, string>;\n\tenv?: Record<string, string>;\n}\n\nexport interface WatchdogReviewModelSelection {\n\tmodel: RegistryModel;\n\tthinkingLevel: ThinkingLevel;\n\tauth: WatchdogReviewAuth;\n\texplicit: boolean;\n}\n\nexport interface CreateMainWatchdogReviewOptions {\n\tstreamFn?: StreamFn;\n\tcreateReadOnlyTools?: (cwd: string) => AgentTool[];\n\tgetThinkingLevel?: () => ThinkingLevel | undefined;\n}\n\nfunction fullModelId(model: Pick<RegistryModel, \"provider\" | \"id\">): string {\n\treturn `${model.provider}/${model.id}`;\n}\n\nfunction splitProviderModel(value: string): { provider: string; id: string } | undefined {\n\tconst slashIndex = value.indexOf(\"/\");\n\tif (slashIndex <= 0 || slashIndex === value.length - 1) return undefined;\n\treturn { provider: value.slice(0, slashIndex), id: value.slice(slashIndex + 1) };\n}\n\nfunction assertThinkingLevel(value: string, source: string): ThinkingLevel {\n\tif ((THINKING_LEVELS as readonly string[]).includes(value)) return value as ThinkingLevel;\n\tthrow new Error(`Unsupported watchdog thinking level '${value}' from ${source}; expected ${THINKING_LEVELS.join(\", \")} or false.`);\n}\n\nfunction contextThinkingLevel(ctx: ExtensionContext, currentThinkingLevel: ThinkingLevel | undefined): ThinkingLevel | undefined {\n\tif (currentThinkingLevel) return currentThinkingLevel;\n\tconst value = (ctx as { thinkingLevel?: unknown }).thinkingLevel;\n\treturn typeof value === \"string\" && (THINKING_LEVELS as readonly string[]).includes(value) ? value as ThinkingLevel : undefined;\n}\n\nfunction resolveReviewThinking(input: {\n\tmodelString: string;\n\tconfigThinking: string | false | undefined;\n\tctx: ExtensionContext;\n\tallowContextThinking: boolean;\n\tcurrentThinkingLevel?: ThinkingLevel;\n}): ThinkingLevel {\n\tconst fromModelOrConfig = resolveEffectiveThinking(input.modelString, input.configThinking);\n\tif (fromModelOrConfig) return assertThinkingLevel(fromModelOrConfig, \"watchdog model/config\");\n\tif (input.configThinking === false) return \"off\";\n\tif (input.configThinking !== undefined) return assertThinkingLevel(input.configThinking, \"watchdog config\");\n\tif (input.allowContextThinking) return contextThinkingLevel(input.ctx, input.currentThinkingLevel) ?? \"off\";\n\treturn \"off\";\n}\n\nfunction resolveConfiguredModel(ctx: ExtensionContext, rawModel: string): { model: RegistryModel; modelString: string } {\n\tconst availableModels = ctx.modelRegistry.getAvailable().map(toModelInfo);\n\tconst preferredProvider = typeof ctx.model?.provider === \"string\" ? ctx.model.provider : undefined;\n\tconst resolved = resolveModelCandidate(rawModel, availableModels, preferredProvider);\n\tconst { baseModel } = splitKnownThinkingSuffix(resolved);\n\tconst named = splitProviderModel(baseModel);\n\tif (!named) {\n\t\tthrow new Error(`Configured watchdog model '${rawModel}' did not match exactly one authenticated available model. Use provider/model or configure credentials for the intended provider.`);\n\t}\n\n\tconst model = ctx.modelRegistry.find(named.provider, named.id);\n\tif (!model) throw new Error(`Configured watchdog model '${rawModel}' was not found as '${baseModel}'.`);\n\tif (!ctx.modelRegistry.hasConfiguredAuth(model)) {\n\t\tthrow new Error(`Configured watchdog model '${baseModel}' is not authenticated. Configure credentials for provider '${named.provider}' or choose an authenticated model.`);\n\t}\n\treturn { model, modelString: resolved };\n}\n\nasync function resolveReviewAuth(ctx: ExtensionContext, model: RegistryModel): Promise<WatchdogReviewAuth> {\n\tconst auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);\n\tif (!auth.ok) throw new Error(`Watchdog model auth failed for ${fullModelId(model)}: ${auth.error}`);\n\treturn {\n\t\t...(auth.apiKey ? { apiKey: auth.apiKey } : {}),\n\t\t...(auth.headers ? { headers: auth.headers } : {}),\n\t\t...(auth.env ? { env: auth.env } : {}),\n\t};\n}\n\nexport async function resolveWatchdogReviewModel(\n\tctx: ExtensionContext,\n\tconfig: ResolvedWatchdogConfig,\n\toptions: { currentThinkingLevel?: ThinkingLevel } = {},\n): Promise<WatchdogReviewModelSelection> {\n\tif (config.main.model) {\n\t\tconst resolved = resolveConfiguredModel(ctx, config.main.model);\n\t\treturn {\n\t\t\tmodel: resolved.model,\n\t\t\tthinkingLevel: resolveReviewThinking({\n\t\t\t\tmodelString: resolved.modelString,\n\t\t\t\tconfigThinking: config.main.thinking,\n\t\t\t\tctx,\n\t\t\t\tallowContextThinking: false,\n\t\t\t\tcurrentThinkingLevel: options.currentThinkingLevel,\n\t\t\t}),\n\t\t\tauth: await resolveReviewAuth(ctx, resolved.model),\n\t\t\texplicit: true,\n\t\t};\n\t}\n\n\tconst currentModel = ctx.model;\n\tif (!currentModel) {\n\t\tthrow new Error(\"Main watchdog review cannot run because the current Pi session model is unavailable and subagents.watchdog.main.model is not configured.\");\n\t}\n\treturn {\n\t\tmodel: currentModel,\n\t\tthinkingLevel: resolveReviewThinking({\n\t\t\tmodelString: fullModelId(currentModel),\n\t\t\tconfigThinking: config.main.thinking,\n\t\t\tctx,\n\t\t\tallowContextThinking: true,\n\t\t\tcurrentThinkingLevel: options.currentThinkingLevel,\n\t\t}),\n\t\tauth: await resolveReviewAuth(ctx, currentModel),\n\t\texplicit: false,\n\t};\n}\n\nfunction nonEmptyString(value: string, field: string): string {\n\tconst trimmed = value.trim();\n\tif (!trimmed) throw new Error(`watchdog_warn.${field} must be a non-empty string.`);\n\treturn trimmed;\n}\n\nfunction toWatchdogWarning(params: WatchdogWarnParams): WatchdogWarning {\n\treturn {\n\t\tseverity: params.severity as WatchdogSeverity,\n\t\tcategory: (params.category ?? \"other\") as WatchdogCategory,\n\t\tconfidence: (params.confidence ?? \"medium\") as WatchdogConfidence,\n\t\tsource: \"main\",\n\t\tsummary: nonEmptyString(params.summary, \"summary\"),\n\t\tevidence: nonEmptyString(params.evidence, \"evidence\"),\n\t\trecommendedAction: nonEmptyString(params.recommendedAction, \"recommendedAction\"),\n\t};\n}\n\nfunction createWatchdogWarnTool(request: WatchdogReviewRequest): AgentTool<typeof WatchdogWarnParams, { accepted: boolean }> {\n\treturn {\n\t\tname: \"watchdog_warn\",\n\t\tlabel: \"Watchdog warning\",\n\t\tdescription: [\n\t\t\t\"Emit one actionable main-session watchdog warning.\",\n\t\t\t\"Use only for medium/high confidence concerns or blockers that the parent should consider before accepting the work.\",\n\t\t\t\"Do not use for nits, praise, informational notes, or clean reviews.\",\n\t\t].join(\" \"),\n\t\tparameters: WatchdogWarnParams,\n\t\texecutionMode: \"sequential\",\n\t\tasync execute(_toolCallId, params) {\n\t\t\tconst warning = toWatchdogWarning(params);\n\t\t\tconst accepted = request.emitWarning(warning);\n\t\t\treturn {\n\t\t\t\tcontent: [{\n\t\t\t\t\ttype: \"text\",\n\t\t\t\t\ttext: accepted\n\t\t\t\t\t\t? \"Watchdog warning recorded.\"\n\t\t\t\t\t\t: \"Watchdog warning was ignored by the runtime guard because it was stale, duplicate, or over budget.\",\n\t\t\t\t}],\n\t\t\t\tdetails: { accepted },\n\t\t\t};\n\t\t},\n\t};\n}\n\nfunction buildWatchdogSystemPrompt(ctx: ExtensionContext): string {\n\treturn [\n\t\t\"You are the main-session subagent watchdog for Pi.\",\n\t\t`Working directory: ${ctx.cwd}`,\n\t\t\"Review only the supplied parent turn delta. Inspect repository files only when needed to verify a concrete concern.\",\n\t\t\"You are read-only. You may use read, grep, find, and ls. Do not edit files, run shell commands, spawn agents, or mutate state.\",\n\t\t\"Emit warnings only by calling watchdog_warn. Freeform assistant text is ignored and must not be used to report warnings.\",\n\t\t\"Emit only medium/high confidence actionable concerns or blockers: missed user constraints, correctness risks, test gaps that matter, unsafe changes, stale facts, loop risks, or scope drift.\",\n\t\t\"Do not emit nits, style preferences, low-confidence guesses, informational notes, praise, or summaries.\",\n\t\t\"If the turn is clean, call no tools and end normally.\",\n\t\t\"Use severity='blocker' only when the issue should stop acceptance until addressed; otherwise use severity='concern'.\",\n\t].join(\"\\n\");\n}\n\nfunction buildReviewPrompt(request: WatchdogReviewRequest, selection: WatchdogReviewModelSelection): string {\n\treturn [\n\t\t\"Review this parent-session turn delta for subagent-watchdog-worthy issues.\",\n\t\t`Review id: ${request.reviewId}; epoch: ${request.epoch}; review model: ${fullModelId(selection.model)}; thinking: ${selection.thinkingLevel}.`,\n\t\t\"Call watchdog_warn for each qualifying concern or blocker. Call no tools when clean.\",\n\t\t\"<turn_delta>\",\n\t\trequest.delta,\n\t\t\"</turn_delta>\",\n\t].join(\"\\n\\n\");\n}\n\nfunction finalStopReason(agent: Agent): \"stop\" | \"error\" | \"aborted\" | \"length\" {\n\tfor (let index = agent.state.messages.length - 1; index >= 0; index--) {\n\t\tconst message = agent.state.messages[index];\n\t\tif (message && typeof message === \"object\" && (message as { role?: unknown }).role === \"assistant\") {\n\t\t\tconst stopReason = (message as { stopReason?: unknown }).stopReason;\n\t\t\tif (stopReason === \"error\" || stopReason === \"aborted\" || stopReason === \"length\") return stopReason;\n\t\t\treturn \"stop\";\n\t\t}\n\t}\n\treturn \"stop\";\n}\n\nfunction resolveContext(provider: WatchdogContextProvider): ExtensionContext | undefined {\n\treturn typeof provider === \"function\" ? provider() : provider;\n}\n\nexport function createMainWatchdogReview(provider: WatchdogContextProvider, options: CreateMainWatchdogReviewOptions = {}): WatchdogReviewFunction {\n\treturn async (request) => {\n\t\tconst ctx = resolveContext(provider);\n\t\tif (!ctx) throw new Error(\"Main watchdog review cannot run without an active Pi extension context.\");\n\t\tif (ctx.signal?.aborted || request.signal?.aborted) return { stopReason: \"aborted\" };\n\t\tconst selection = await resolveWatchdogReviewModel(ctx, request.config, {\n\t\t\tcurrentThinkingLevel: options.getThinkingLevel?.(),\n\t\t});\n\t\tif (ctx.signal?.aborted || request.signal?.aborted) return { stopReason: \"aborted\" };\n\t\tconst auth = selection.auth;\n\t\tconst baseStreamFn = options.streamFn ?? streamSimple;\n\t\tconst streamFn: StreamFn = (model, context, streamOptions) => baseStreamFn(model, context, {\n\t\t\t...streamOptions,\n\t\t\t...(auth.apiKey ? { apiKey: auth.apiKey } : {}),\n\t\t\tenv: auth.env || streamOptions?.env ? { ...(auth.env ?? {}), ...(streamOptions?.env ?? {}) } : undefined,\n\t\t\theaders: { ...(streamOptions?.headers ?? {}), ...(auth.headers ?? {}) },\n\t\t});\n\t\tconst tools = [\n\t\t\t...(options.createReadOnlyTools ?? createReadOnlyTools)(ctx.cwd).filter((tool) => WATCHDOG_ALLOWED_TOOL_NAMES.has(tool.name) && tool.name !== \"watchdog_warn\"),\n\t\t\tcreateWatchdogWarnTool(request),\n\t\t];\n\t\tconst agent = new Agent({\n\t\t\tinitialState: {\n\t\t\t\tsystemPrompt: buildWatchdogSystemPrompt(ctx),\n\t\t\t\tmodel: selection.model,\n\t\t\t\tthinkingLevel: selection.thinkingLevel,\n\t\t\t\ttools,\n\t\t\t},\n\t\t\tconvertToLlm,\n\t\t\tstreamFn,\n\t\t\tgetApiKey: (providerName) => providerName === selection.model.provider ? auth.apiKey : undefined,\n\t\t\tbeforeToolCall: async ({ toolCall }) => WATCHDOG_ALLOWED_TOOL_NAMES.has(toolCall.name)\n\t\t\t\t? undefined\n\t\t\t\t: { block: true, reason: `Watchdog reviews are read-only; tool '${toolCall.name}' is not allowed.` },\n\t\t\ttoolExecution: \"sequential\",\n\t\t});\n\t\tconst abort = () => agent.abort();\n\t\tctx.signal?.addEventListener(\"abort\", abort, { once: true });\n\t\trequest.signal?.addEventListener(\"abort\", abort, { once: true });\n\t\ttry {\n\t\t\tif (ctx.signal?.aborted || request.signal?.aborted) return { stopReason: \"aborted\" };\n\t\t\tawait agent.prompt(buildReviewPrompt(request, selection));\n\t\t} finally {\n\t\t\tctx.signal?.removeEventListener(\"abort\", abort);\n\t\t\trequest.signal?.removeEventListener(\"abort\", abort);\n\t\t}\n\t\treturn { stopReason: finalStopReason(agent) };\n\t};\n}\n"]}
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../../../../src/builtin-extensions/pi-subagents/src/watchdog/review.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport { Agent, type AgentTool, type StreamFn, type ThinkingLevel } from \"@ashx-j/lunr-agent\";\nimport type { ExtensionContext } from \"@ashx-j/lunr-dev\";\nimport { createReadOnlyTools } from \"../../../../core/tools/index.ts\";\nimport { convertToLlm } from \"../../../../core/messages.ts\";\nimport { streamSimple, type Model } from \"@ashx-j/lunr-ai/compat\";\nimport { Type, type Static } from \"typebox\";\nimport { resolveModelCandidate } from \"../runs/shared/model-fallback.ts\";\nimport { resolveEffectiveThinking, splitKnownThinkingSuffix, THINKING_LEVELS, toModelInfo } from \"../shared/model-info.ts\";\nimport type { WatchdogReviewFunction, WatchdogReviewRequest } from \"./runtime.ts\";\nimport {\n\tWATCHDOG_WARNING_CATEGORIES,\n\tWATCHDOG_WARNING_CONFIDENCES,\n\tWATCHDOG_WARNING_SEVERITIES,\n\ttype ResolvedWatchdogConfig,\n\ttype WatchdogCategory,\n\ttype WatchdogConfidence,\n\ttype WatchdogSeverity,\n\ttype WatchdogWarning,\n} from \"./types.ts\";\n\nconst WATCHDOG_ALLOWED_TOOL_NAMES = new Set([\"read\", \"grep\", \"find\", \"ls\", \"watchdog_warn\"]);\n\nconst WatchdogWarnParams = Type.Object({\n\tseverity: Type.String({ enum: WATCHDOG_WARNING_SEVERITIES, description: \"concern for actionable risk, blocker for a likely wrong or unsafe outcome\" }),\n\tsummary: Type.String({ description: \"One concise sentence naming the issue.\" }),\n\tevidence: Type.String({ description: \"Specific evidence from the turn delta or inspected files.\" }),\n\trecommendedAction: Type.String({ description: \"Specific action the parent should take before accepting or continuing.\" }),\n\tcategory: Type.Optional(Type.String({ enum: WATCHDOG_WARNING_CATEGORIES })),\n\tconfidence: Type.Optional(Type.String({ enum: WATCHDOG_WARNING_CONFIDENCES })),\n}, { additionalProperties: false });\n\ntype WatchdogWarnParams = Static<typeof WatchdogWarnParams>;\n\ntype WatchdogContextProvider = ExtensionContext | (() => ExtensionContext | undefined);\n\ntype RegistryModel = Model<any>;\n\ninterface WatchdogReviewAuth {\n\tapiKey?: string;\n\theaders?: Record<string, string>;\n\tenv?: Record<string, string>;\n}\n\nexport interface WatchdogReviewModelSelection {\n\tmodel: RegistryModel;\n\tthinkingLevel: ThinkingLevel;\n\tauth: WatchdogReviewAuth;\n\texplicit: boolean;\n}\n\nexport interface CreateMainWatchdogReviewOptions {\n\tstreamFn?: StreamFn;\n\tcreateReadOnlyTools?: (cwd: string) => AgentTool[];\n\tgetThinkingLevel?: () => ThinkingLevel | undefined;\n}\n\nfunction fullModelId(model: Pick<RegistryModel, \"provider\" | \"id\">): string {\n\treturn `${model.provider}/${model.id}`;\n}\n\nfunction splitProviderModel(value: string): { provider: string; id: string } | undefined {\n\tconst slashIndex = value.indexOf(\"/\");\n\tif (slashIndex <= 0 || slashIndex === value.length - 1) return undefined;\n\treturn { provider: value.slice(0, slashIndex), id: value.slice(slashIndex + 1) };\n}\n\nfunction assertThinkingLevel(value: string, source: string): ThinkingLevel {\n\tif ((THINKING_LEVELS as readonly string[]).includes(value)) return value as ThinkingLevel;\n\tthrow new Error(`Unsupported watchdog thinking level '${value}' from ${source}; expected ${THINKING_LEVELS.join(\", \")} or false.`);\n}\n\nfunction contextThinkingLevel(ctx: ExtensionContext, currentThinkingLevel: ThinkingLevel | undefined): ThinkingLevel | undefined {\n\tif (currentThinkingLevel) return currentThinkingLevel;\n\tconst value = (ctx as { thinkingLevel?: unknown }).thinkingLevel;\n\treturn typeof value === \"string\" && (THINKING_LEVELS as readonly string[]).includes(value) ? value as ThinkingLevel : undefined;\n}\n\nfunction resolveReviewThinking(input: {\n\tmodelString: string;\n\tconfigThinking: string | false | undefined;\n\tctx: ExtensionContext;\n\tallowContextThinking: boolean;\n\tcurrentThinkingLevel?: ThinkingLevel;\n}): ThinkingLevel {\n\tconst fromModelOrConfig = resolveEffectiveThinking(input.modelString, input.configThinking);\n\tif (fromModelOrConfig) return assertThinkingLevel(fromModelOrConfig, \"watchdog model/config\");\n\tif (input.configThinking === false) return \"off\";\n\tif (input.configThinking !== undefined) return assertThinkingLevel(input.configThinking, \"watchdog config\");\n\tif (input.allowContextThinking) return contextThinkingLevel(input.ctx, input.currentThinkingLevel) ?? \"off\";\n\treturn \"off\";\n}\n\nfunction resolveConfiguredModel(ctx: ExtensionContext, rawModel: string): { model: RegistryModel; modelString: string } {\n\tconst availableModels = ctx.modelRegistry.getAvailable().map(toModelInfo);\n\tconst preferredProvider = typeof ctx.model?.provider === \"string\" ? ctx.model.provider : undefined;\n\tconst resolved = resolveModelCandidate(rawModel, availableModels, preferredProvider);\n\tconst { baseModel } = splitKnownThinkingSuffix(resolved);\n\tconst named = splitProviderModel(baseModel);\n\tif (!named) {\n\t\tthrow new Error(`Configured watchdog model '${rawModel}' did not match exactly one authenticated available model. Use provider/model or configure credentials for the intended provider.`);\n\t}\n\n\tconst model = ctx.modelRegistry.find(named.provider, named.id);\n\tif (!model) throw new Error(`Configured watchdog model '${rawModel}' was not found as '${baseModel}'.`);\n\tif (!ctx.modelRegistry.hasConfiguredAuth(model)) {\n\t\tthrow new Error(`Configured watchdog model '${baseModel}' is not authenticated. Configure credentials for provider '${named.provider}' or choose an authenticated model.`);\n\t}\n\treturn { model, modelString: resolved };\n}\n\nasync function resolveReviewAuth(ctx: ExtensionContext, model: RegistryModel): Promise<WatchdogReviewAuth> {\n\tconst auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);\n\tif (!auth.ok) throw new Error(`Watchdog model auth failed for ${fullModelId(model)}: ${auth.error}`);\n\treturn {\n\t\t...(auth.apiKey ? { apiKey: auth.apiKey } : {}),\n\t\t...(auth.headers ? { headers: auth.headers } : {}),\n\t\t...(auth.env ? { env: auth.env } : {}),\n\t};\n}\n\nexport async function resolveWatchdogReviewModel(\n\tctx: ExtensionContext,\n\tconfig: ResolvedWatchdogConfig,\n\toptions: { currentThinkingLevel?: ThinkingLevel } = {},\n): Promise<WatchdogReviewModelSelection> {\n\tif (config.main.model) {\n\t\tconst resolved = resolveConfiguredModel(ctx, config.main.model);\n\t\treturn {\n\t\t\tmodel: resolved.model,\n\t\t\tthinkingLevel: resolveReviewThinking({\n\t\t\t\tmodelString: resolved.modelString,\n\t\t\t\tconfigThinking: config.main.thinking,\n\t\t\t\tctx,\n\t\t\t\tallowContextThinking: false,\n\t\t\t\tcurrentThinkingLevel: options.currentThinkingLevel,\n\t\t\t}),\n\t\t\tauth: await resolveReviewAuth(ctx, resolved.model),\n\t\t\texplicit: true,\n\t\t};\n\t}\n\n\tconst currentModel = ctx.model;\n\tif (!currentModel) {\n\t\tthrow new Error(\"Main watchdog review cannot run because the current Pi session model is unavailable and subagents.watchdog.main.model is not configured.\");\n\t}\n\treturn {\n\t\tmodel: currentModel,\n\t\tthinkingLevel: resolveReviewThinking({\n\t\t\tmodelString: fullModelId(currentModel),\n\t\t\tconfigThinking: config.main.thinking,\n\t\t\tctx,\n\t\t\tallowContextThinking: true,\n\t\t\tcurrentThinkingLevel: options.currentThinkingLevel,\n\t\t}),\n\t\tauth: await resolveReviewAuth(ctx, currentModel),\n\t\texplicit: false,\n\t};\n}\n\nfunction nonEmptyString(value: string, field: string): string {\n\tconst trimmed = value.trim();\n\tif (!trimmed) throw new Error(`watchdog_warn.${field} must be a non-empty string.`);\n\treturn trimmed;\n}\n\nfunction toWatchdogWarning(params: WatchdogWarnParams): WatchdogWarning {\n\treturn {\n\t\tseverity: params.severity as WatchdogSeverity,\n\t\tcategory: (params.category ?? \"other\") as WatchdogCategory,\n\t\tconfidence: (params.confidence ?? \"medium\") as WatchdogConfidence,\n\t\tsource: \"main\",\n\t\tsummary: nonEmptyString(params.summary, \"summary\"),\n\t\tevidence: nonEmptyString(params.evidence, \"evidence\"),\n\t\trecommendedAction: nonEmptyString(params.recommendedAction, \"recommendedAction\"),\n\t};\n}\n\nfunction createWatchdogWarnTool(request: WatchdogReviewRequest): AgentTool<typeof WatchdogWarnParams, { accepted: boolean }> {\n\treturn {\n\t\tname: \"watchdog_warn\",\n\t\tlabel: \"Watchdog warning\",\n\t\tdescription: [\n\t\t\t\"Emit one actionable main-session watchdog warning.\",\n\t\t\t\"Use only for medium/high confidence concerns or blockers that the parent should consider before accepting the work.\",\n\t\t\t\"Do not use for nits, praise, informational notes, or clean reviews.\",\n\t\t].join(\" \"),\n\t\tparameters: WatchdogWarnParams,\n\t\texecutionMode: \"sequential\",\n\t\tasync execute(_toolCallId, params) {\n\t\t\tconst warning = toWatchdogWarning(params);\n\t\t\tconst accepted = request.emitWarning(warning);\n\t\t\treturn {\n\t\t\t\tcontent: [{\n\t\t\t\t\ttype: \"text\",\n\t\t\t\t\ttext: accepted\n\t\t\t\t\t\t? \"Watchdog warning recorded.\"\n\t\t\t\t\t\t: \"Watchdog warning was ignored by the runtime guard because it was stale, duplicate, or over budget.\",\n\t\t\t\t}],\n\t\t\t\tdetails: { accepted },\n\t\t\t};\n\t\t},\n\t};\n}\n\nfunction buildWatchdogSystemPrompt(ctx: ExtensionContext): string {\n\treturn [\n\t\t\"You are the main-session subagent watchdog for Pi.\",\n\t\t`Working directory: ${ctx.cwd}`,\n\t\t\"Review only the supplied parent turn delta. Inspect repository files only when needed to verify a concrete concern.\",\n\t\t\"You are read-only. You may use read, grep, find, and ls. Do not edit files, run shell commands, spawn agents, or mutate state.\",\n\t\t\"Emit warnings only by calling watchdog_warn. Freeform assistant text is ignored and must not be used to report warnings.\",\n\t\t\"Emit only medium/high confidence actionable concerns or blockers: missed user constraints, correctness risks, test gaps that matter, unsafe changes, stale facts, loop risks, or scope drift.\",\n\t\t\"Do not emit nits, style preferences, low-confidence guesses, informational notes, praise, or summaries.\",\n\t\t\"If the turn is clean, call no tools and end normally.\",\n\t\t\"Use severity='blocker' only when the issue should stop acceptance until addressed; otherwise use severity='concern'.\",\n\t].join(\"\\n\");\n}\n\nfunction buildReviewPrompt(request: WatchdogReviewRequest, selection: WatchdogReviewModelSelection): string {\n\treturn [\n\t\t\"Review this parent-session turn delta for subagent-watchdog-worthy issues.\",\n\t\t`Review id: ${request.reviewId}; epoch: ${request.epoch}; review model: ${fullModelId(selection.model)}; thinking: ${selection.thinkingLevel}.`,\n\t\t\"Call watchdog_warn for each qualifying concern or blocker. Call no tools when clean.\",\n\t\t\"<turn_delta>\",\n\t\trequest.delta,\n\t\t\"</turn_delta>\",\n\t].join(\"\\n\\n\");\n}\n\nfunction finalStopReason(agent: Agent): \"stop\" | \"error\" | \"aborted\" | \"length\" {\n\tfor (let index = agent.state.messages.length - 1; index >= 0; index--) {\n\t\tconst message = agent.state.messages[index];\n\t\tif (message && typeof message === \"object\" && (message as { role?: unknown }).role === \"assistant\") {\n\t\t\tconst stopReason = (message as { stopReason?: unknown }).stopReason;\n\t\t\tif (stopReason === \"error\" || stopReason === \"aborted\" || stopReason === \"length\") return stopReason;\n\t\t\treturn \"stop\";\n\t\t}\n\t}\n\treturn \"stop\";\n}\n\nfunction resolveContext(provider: WatchdogContextProvider): ExtensionContext | undefined {\n\treturn typeof provider === \"function\" ? provider() : provider;\n}\n\nexport function createMainWatchdogReview(provider: WatchdogContextProvider, options: CreateMainWatchdogReviewOptions = {}): WatchdogReviewFunction {\n\treturn async (request) => {\n\t\tconst ctx = resolveContext(provider);\n\t\tif (!ctx) throw new Error(\"Main watchdog review cannot run without an active Pi extension context.\");\n\t\tif (ctx.signal?.aborted || request.signal?.aborted) return { stopReason: \"aborted\" };\n\t\tconst selection = await resolveWatchdogReviewModel(ctx, request.config, {\n\t\t\tcurrentThinkingLevel: options.getThinkingLevel?.(),\n\t\t});\n\t\tif (ctx.signal?.aborted || request.signal?.aborted) return { stopReason: \"aborted\" };\n\t\tconst auth = selection.auth;\n\t\tconst baseStreamFn = options.streamFn ?? streamSimple;\n\t\tconst streamFn: StreamFn = (model, context, streamOptions) => baseStreamFn(model, context, {\n\t\t\t...streamOptions,\n\t\t\t...(auth.apiKey ? { apiKey: auth.apiKey } : {}),\n\t\t\tenv: auth.env || streamOptions?.env ? { ...(auth.env ?? {}), ...(streamOptions?.env ?? {}) } : undefined,\n\t\t\theaders: { ...(streamOptions?.headers ?? {}), ...(auth.headers ?? {}) },\n\t\t});\n\t\tconst tools = [\n\t\t\t...(options.createReadOnlyTools ?? createReadOnlyTools)(ctx.cwd).filter((tool) => WATCHDOG_ALLOWED_TOOL_NAMES.has(tool.name) && tool.name !== \"watchdog_warn\"),\n\t\t\tcreateWatchdogWarnTool(request),\n\t\t];\n\t\tconst agent = new Agent({\n\t\t\tinitialState: {\n\t\t\t\tsystemPrompt: buildWatchdogSystemPrompt(ctx),\n\t\t\t\tmodel: selection.model,\n\t\t\t\tthinkingLevel: selection.thinkingLevel,\n\t\t\t\ttools,\n\t\t\t},\n\t\t\tconvertToLlm,\n\t\t\tstreamFn,\n\t\t\tgetApiKey: (providerName) => providerName === selection.model.provider ? auth.apiKey : undefined,\n\t\t\tbeforeToolCall: async ({ toolCall }) => WATCHDOG_ALLOWED_TOOL_NAMES.has(toolCall.name)\n\t\t\t\t? undefined\n\t\t\t\t: { block: true, reason: `Watchdog reviews are read-only; tool '${toolCall.name}' is not allowed.` },\n\t\t\ttoolExecution: \"sequential\",\n\t\t});\n\t\tconst abort = () => agent.abort();\n\t\tctx.signal?.addEventListener(\"abort\", abort, { once: true });\n\t\trequest.signal?.addEventListener(\"abort\", abort, { once: true });\n\t\ttry {\n\t\t\tif (ctx.signal?.aborted || request.signal?.aborted) return { stopReason: \"aborted\" };\n\t\t\tawait agent.prompt(buildReviewPrompt(request, selection));\n\t\t} finally {\n\t\t\tctx.signal?.removeEventListener(\"abort\", abort);\n\t\t\trequest.signal?.removeEventListener(\"abort\", abort);\n\t\t}\n\t\treturn { stopReason: finalStopReason(agent) };\n\t};\n}\n"]}

package/dist/builtin-extensions/pi-web-access/extract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-web-access/extract.ts"],"names":[],"mappings":"AAcA,OAAO,EAAqC,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAUtF;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAuB9C;AAyBD,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3D,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AA6ID,wBAAsB,cAAc,CACnC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA4P3B;AAsLD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK/D;AAMD,wBAAsB,eAAe,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAE7B","sourcesContent":["// @ts-nocheck\nimport { Readability } from \"@mozilla/readability\";\nimport { parseHTML } from \"linkedom\";\nimport TurndownService from \"turndown\";\nimport pLimit from \"p-limit\";\nimport { activityMonitor } from \"./activity.ts\";\nimport { extractRSCContent } from \"./rsc-extract.ts\";\nimport { extractPDFToMarkdown, isPDF } from \"./pdf-extract.ts\";\nimport { extractGitHub } from \"./github-extract.ts\";\nimport { isYouTubeURL, isYouTubeEnabled, extractYouTube, extractYouTubeFrame, extractYouTubeFrames, getYouTubeStreamInfo } from \"./youtube-extract.ts\";\nimport { extractWithUrlContext, extractWithGeminiWeb } from \"./gemini-url-context.ts\";\nimport { extractWithParallel, isParallelAvailable } from \"./parallel.ts\";\nimport { isVideoFile, extractVideo, extractVideoFrame, getLocalVideoDuration } from \"./video-extract.ts\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { fetchRemoteUrl, validateRemoteUrl, type Lookup } from \"./ssrf-protection.ts\";\nimport { formatSeconds, getWebSearchConfigPath } from \"./utils.ts\";\n\nconst DEFAULT_TIMEOUT_MS = 30000;\nconst CONCURRENT_LIMIT = 3;\n\nconst NON_RECOVERABLE_ERRORS = [\"Unsupported content type\", \"Response too large\"];\nconst MIN_USEFUL_CONTENT = 500;\nconst WEB_SEARCH_CONFIG_PATH = getWebSearchConfigPath();\n\n/**\n * Read `ssrf.allowRanges` (CIDR strings) from web-search.json. Returns [] when\n * the file is missing, unreadable, or the key is unset so SSRF protection stays\n * fully on by default. Throws when `ssrf.allowRanges` is present but not an array\n * so a mistyped value (e.g. a bare string instead of a JSON array) fails loudly\n * instead of being silently ignored. Exempts synthetic ranges used by TUN/fake-IP\n * proxies (e.g. 198.18.0.0/15).\n */\nexport function loadSsrfAllowRanges(): string[] {\n\tlet value: unknown;\n\ttry {\n\t\tif (!existsSync(WEB_SEARCH_CONFIG_PATH)) return [];\n\t\tconst raw = readFileSync(WEB_SEARCH_CONFIG_PATH, \"utf-8\");\n\t\tvalue = (JSON.parse(raw) as { ssrf?: { allowRanges?: unknown } })?.ssrf?.allowRanges;\n\t} catch {\n\t\t// Missing/unreadable file or invalid JSON: fail safe with SSRF fully on.\n\t\treturn [];\n\t}\n\tif (value === undefined || value === null) return [];\n\tif (!Array.isArray(value)) {\n\t\tthrow new Error(`ssrf.allowRanges in ${WEB_SEARCH_CONFIG_PATH} must be an array of CIDR strings`);\n\t}\n\tconst ranges: string[] = [];\n\tfor (const [index, entry] of value.entries()) {\n\t\tif (typeof entry !== \"string\") {\n\t\t\tthrow new Error(`ssrf.allowRanges in ${WEB_SEARCH_CONFIG_PATH} must contain only CIDR strings; entry ${index + 1} is ${typeof entry}`);\n\t\t}\n\t\tconst trimmed = entry.trim();\n\t\tif (trimmed) ranges.push(trimmed);\n\t}\n\treturn ranges;\n}\n\nfunction errorMessage(err: unknown): string {\n\treturn err instanceof Error ? err.message : String(err);\n}\n\nfunction isConfigParseError(err: unknown): boolean {\n\treturn errorMessage(err).startsWith(\"Failed to parse \");\n}\n\nfunction isAbortError(err: unknown): boolean {\n\treturn errorMessage(err).toLowerCase().includes(\"abort\");\n}\n\nfunction abortedResult(url: string): ExtractedContent {\n\treturn { url, title: \"\", content: \"\", error: \"Aborted\" };\n}\n\nconst turndown = new TurndownService({\n\theadingStyle: \"atx\",\n\tcodeBlockStyle: \"fenced\",\n});\n\nconst fetchLimit = pLimit(CONCURRENT_LIMIT);\n\nexport interface VideoFrame {\n\tdata: string;\n\tmimeType: string;\n\ttimestamp: string;\n}\n\nexport type FrameData = { data: string; mimeType: string };\nexport type FrameResult = FrameData | { error: string };\n\nexport interface ExtractedContent {\n\turl: string;\n\ttitle: string;\n\tcontent: string;\n\terror: string | null;\n\tthumbnail?: { data: string; mimeType: string };\n\tframes?: VideoFrame[];\n\tduration?: number;\n}\n\nexport interface ExtractOptions {\n\ttimeoutMs?: number;\n\tforceClone?: boolean;\n\tprompt?: string;\n\ttimestamp?: string;\n\tframes?: number;\n\tmodel?: string;\n\t/** Custom DNS resolver used for SSRF validation. Primarily a test seam. */\n\tlookup?: Lookup;\n}\n\nconst JINA_READER_BASE = \"https://r.jina.ai/\";\nconst JINA_TIMEOUT_MS = 30000;\n\nasync function extractWithJinaReader(\n\turl: string,\n\tsignal?: AbortSignal,\n\tlookup?: Lookup,\n): Promise<ExtractedContent | null> {\n\tconst jinaUrl = JINA_READER_BASE + url;\n\n\tconst activityId = activityMonitor.logStart({ type: \"api\", query: `jina: ${url}` });\n\n\ttry {\n\t\tawait validateRemoteUrl(url, { allowRanges: loadSsrfAllowRanges(), lookup });\n\t\tconst res = await fetch(jinaUrl, {\n\t\t\theaders: {\n\t\t\t\t\"Accept\": \"text/markdown\",\n\t\t\t\t\"X-No-Cache\": \"true\",\n\t\t\t},\n\t\t\tsignal: AbortSignal.any([\n\t\t\t\tAbortSignal.timeout(JINA_TIMEOUT_MS),\n\t\t\t\t...(signal ? [signal] : []),\n\t\t\t]),\n\t\t});\n\n\t\tif (!res.ok) {\n\t\t\tactivityMonitor.logComplete(activityId, res.status);\n\t\t\treturn null;\n\t\t}\n\n\t\tconst content = await res.text();\n\t\tactivityMonitor.logComplete(activityId, res.status);\n\n\t\tconst contentStart = content.indexOf(\"Markdown Content:\");\n\t\tif (contentStart < 0) {\n\t\t\treturn null;\n\t\t}\n\n\t\tconst markdownPart = content.slice(contentStart + 17).trim(); // 17 = \"Markdown Content:\".length\n\n\t\t// Check for failed JS rendering or minimal content\n\t\tif (markdownPart.length < 100 ||\n\t\t\tmarkdownPart.startsWith(\"Loading...\") ||\n\t\t\tmarkdownPart.startsWith(\"Please enable JavaScript\")) {\n\t\t\treturn null;\n\t\t}\n\n\t\tconst title = extractHeadingTitle(markdownPart) ?? (new URL(url).pathname.split(\"/\").pop() || url);\n\t\treturn { url, title, content: markdownPart, error: null };\n\t} catch (err) {\n\t\tconst message = err instanceof Error ? err.message : String(err);\n\t\tif (message.toLowerCase().includes(\"abort\")) {\n\t\t\tactivityMonitor.logComplete(activityId, 0);\n\t\t} else {\n\t\t\tactivityMonitor.logError(activityId, message);\n\t\t}\n\t\treturn null;\n\t}\n}\n\nfunction parseTimestamp(ts: string): number | null {\n\tconst num = Number(ts);\n\tif (!isNaN(num) && num >= 0) return Math.floor(num);\n\tconst parts = ts.split(\":\").map(Number);\n\tif (parts.some(p => isNaN(p) || p < 0)) return null;\n\tif (parts.length === 3) return Math.floor(parts[0] * 3600 + parts[1] * 60 + parts[2]);\n\tif (parts.length === 2) return Math.floor(parts[0] * 60 + parts[1]);\n\treturn null;\n}\n\ntype TimestampSpec = { type: \"single\"; seconds: number } | { type: \"range\"; start: number; end: number };\n\nfunction parseTimestampSpec(ts: string): TimestampSpec | null {\n\tconst dashIdx = ts.indexOf(\"-\", 1);\n\tif (dashIdx > 0) {\n\t\tconst start = parseTimestamp(ts.slice(0, dashIdx));\n\t\tconst end = parseTimestamp(ts.slice(dashIdx + 1));\n\t\tif (start !== null && end !== null && end > start) return { type: \"range\", start, end };\n\t}\n\tconst seconds = parseTimestamp(ts);\n\treturn seconds !== null ? { type: \"single\", seconds } : null;\n}\n\nconst DEFAULT_RANGE_FRAMES = 6;\nconst MIN_FRAME_INTERVAL = 5;\n\nfunction computeRangeTimestamps(start: number, end: number, maxFrames: number = DEFAULT_RANGE_FRAMES): number[] {\n\tif (maxFrames <= 1) return [start];\n\tconst duration = end - start;\n\tconst idealInterval = duration / (maxFrames - 1);\n\tif (idealInterval < MIN_FRAME_INTERVAL) {\n\t\tconst timestamps: number[] = [];\n\t\tfor (let t = start; t <= end && timestamps.length < maxFrames; t += MIN_FRAME_INTERVAL) {\n\t\t\ttimestamps.push(t);\n\t\t}\n\t\treturn timestamps;\n\t}\n\treturn Array.from({ length: maxFrames }, (_, i) => Math.round(start + i * idealInterval));\n}\n\nfunction buildFrameResult(\n\turl: string, label: string, requestedCount: number,\n\tframes: VideoFrame[], error: string | null, duration?: number,\n): ExtractedContent {\n\tif (frames.length === 0) {\n\t\tconst msg = error ?? \"Frame extraction failed\";\n\t\treturn { url, title: `Frames ${label} (0/${requestedCount})`, content: msg, error: msg };\n\t}\n\treturn {\n\t\turl,\n\t\ttitle: `Frames ${label} (${frames.length}/${requestedCount})`,\n\t\tcontent: `${frames.length} frames extracted from ${label}`,\n\t\terror: null,\n\t\tframes,\n\t\tduration,\n\t};\n}\n\nasync function extractLocalFrames(\n\tfilePath: string, timestamps: number[],\n): Promise<{ frames: VideoFrame[]; error: string | null }> {\n\tconst results = await Promise.all(timestamps.map(async (t) => {\n\t\tconst frame = await extractVideoFrame(filePath, t);\n\t\tif (\"error\" in frame) return { error: frame.error };\n\t\treturn { ...frame, timestamp: formatSeconds(t) };\n\t}));\n\tconst frames = results.filter((f): f is VideoFrame => \"data\" in f);\n\tconst firstError = results.find((f): f is { error: string } => \"error\" in f);\n\treturn { frames, error: frames.length === 0 && firstError ? firstError.error : null };\n}\n\nfunction safeVideoInfo(url: string): { info: ReturnType<typeof isVideoFile>; error?: string } {\n\ttry {\n\t\treturn { info: isVideoFile(url) };\n\t} catch (err) {\n\t\treturn { info: null, error: errorMessage(err) };\n\t}\n}\n\nexport async function extractContent(\n\turl: string,\n\tsignal?: AbortSignal,\n\toptions?: ExtractOptions,\n): Promise<ExtractedContent> {\n\tif (signal?.aborted) {\n\t\treturn { url, title: \"\", content: \"\", error: \"Aborted\" };\n\t}\n\n\tif (options?.frames && !options.timestamp) {\n\t\tconst frameCount = options.frames;\n\t\tconst ytInfo = isYouTubeURL(url);\n\t\tif (ytInfo.isYouTube && ytInfo.videoId) {\n\t\t\tconst streamInfo = await getYouTubeStreamInfo(ytInfo.videoId);\n\t\t\tif (\"error\" in streamInfo) {\n\t\t\t\treturn { url, title: \"Frames\", content: streamInfo.error, error: streamInfo.error };\n\t\t\t}\n\t\t\tif (streamInfo.duration === null) {\n\t\t\t\tconst error = \"Cannot determine video duration. Use a timestamp range instead.\";\n\t\t\t\treturn { url, title: \"Frames\", content: error, error };\n\t\t\t}\n\t\t\tconst dur = Math.floor(streamInfo.duration);\n\t\t\tconst timestamps = computeRangeTimestamps(0, dur, frameCount);\n\t\t\tconst result = await extractYouTubeFrames(ytInfo.videoId, timestamps, streamInfo);\n\t\t\tconst label = `${formatSeconds(0)}-${formatSeconds(dur)}`;\n\t\t\treturn buildFrameResult(url, label, timestamps.length, result.frames, result.error, streamInfo.duration);\n\t\t}\n\n\t\tconst localVideo = safeVideoInfo(url);\n\t\tif (localVideo.error) {\n\t\t\treturn { url, title: \"\", content: \"\", error: localVideo.error };\n\t\t}\n\t\tif (localVideo.info) {\n\t\t\tconst durationResult = await getLocalVideoDuration(localVideo.info.absolutePath);\n\t\t\tif (typeof durationResult !== \"number\") {\n\t\t\t\treturn { url, title: \"Frames\", content: durationResult.error, error: durationResult.error };\n\t\t\t}\n\t\t\tconst dur = Math.floor(durationResult);\n\t\t\tconst timestamps = computeRangeTimestamps(0, dur, frameCount);\n\t\t\tconst result = await extractLocalFrames(localVideo.info.absolutePath, timestamps);\n\t\t\tconst label = `${formatSeconds(0)}-${formatSeconds(dur)}`;\n\t\t\treturn buildFrameResult(url, label, timestamps.length, result.frames, result.error, durationResult);\n\t\t}\n\n\t\treturn { url, title: \"\", content: \"\", error: \"Frame extraction only works with YouTube and local video files\" };\n\t}\n\n\tif (options?.timestamp) {\n\t\tconst spec = parseTimestampSpec(options.timestamp);\n\t\tif (!spec) {\n\t\t\treturn {\n\t\t\t\turl,\n\t\t\t\ttitle: \"\",\n\t\t\t\tcontent: \"\",\n\t\t\t\terror: `Invalid timestamp format: \"${options.timestamp}\". Use \"H:MM:SS\", \"MM:SS\", \"85\", or \"start-end\".`,\n\t\t\t};\n\t\t}\n\n\t\tconst frameCount = options.frames;\n\t\tconst ytInfo = isYouTubeURL(url);\n\t\tif (ytInfo.isYouTube && ytInfo.videoId) {\n\t\t\tconst streamInfo = await getYouTubeStreamInfo(ytInfo.videoId);\n\t\t\tif (\"error\" in streamInfo) {\n\t\t\t\tif (spec.type === \"range\") {\n\t\t\t\t\tconst label = `${formatSeconds(spec.start)}-${formatSeconds(spec.end)}`;\n\t\t\t\t\treturn { url, title: `Frames ${label}`, content: streamInfo.error, error: streamInfo.error };\n\t\t\t\t}\n\t\t\t\tif (frameCount) {\n\t\t\t\t\tconst end = spec.seconds + (frameCount - 1) * MIN_FRAME_INTERVAL;\n\t\t\t\t\tconst label = `${formatSeconds(spec.seconds)}-${formatSeconds(end)}`;\n\t\t\t\t\treturn { url, title: `Frames ${label}`, content: streamInfo.error, error: streamInfo.error };\n\t\t\t\t}\n\t\t\t\treturn { url, title: `Frame at ${options.timestamp}`, content: streamInfo.error, error: streamInfo.error };\n\t\t\t}\n\n\t\t\tif (spec.type === \"range\") {\n\t\t\t\tconst label = `${formatSeconds(spec.start)}-${formatSeconds(spec.end)}`;\n\t\t\t\tif (streamInfo.duration !== null && spec.end > streamInfo.duration) {\n\t\t\t\t\tconst error = `Timestamp ${formatSeconds(spec.end)} exceeds video duration (${formatSeconds(Math.floor(streamInfo.duration))})`;\n\t\t\t\t\treturn { url, title: `Frames ${label}`, content: error, error };\n\t\t\t\t}\n\t\t\t\tconst timestamps = frameCount\n\t\t\t\t\t? computeRangeTimestamps(spec.start, spec.end, frameCount)\n\t\t\t\t\t: computeRangeTimestamps(spec.start, spec.end);\n\t\t\t\tconst result = await extractYouTubeFrames(ytInfo.videoId, timestamps, streamInfo);\n\t\t\t\treturn buildFrameResult(url, label, timestamps.length, result.frames, result.error, result.duration ?? undefined);\n\t\t\t}\n\n\t\t\tif (frameCount) {\n\t\t\t\tconst end = spec.seconds + (frameCount - 1) * MIN_FRAME_INTERVAL;\n\t\t\t\tconst label = `${formatSeconds(spec.seconds)}-${formatSeconds(end)}`;\n\t\t\t\tif (streamInfo.duration !== null && end > streamInfo.duration) {\n\t\t\t\t\tconst error = `Timestamp ${formatSeconds(end)} exceeds video duration (${formatSeconds(Math.floor(streamInfo.duration))})`;\n\t\t\t\t\treturn { url, title: `Frames ${label}`, content: error, error };\n\t\t\t\t}\n\t\t\t\tconst timestamps = computeRangeTimestamps(spec.seconds, end, frameCount);\n\t\t\t\tconst result = await extractYouTubeFrames(ytInfo.videoId, timestamps, streamInfo);\n\t\t\t\treturn buildFrameResult(url, label, timestamps.length, result.frames, result.error, result.duration ?? undefined);\n\t\t\t}\n\n\t\t\tif (streamInfo.duration !== null && spec.seconds > streamInfo.duration) {\n\t\t\t\tconst error = `Timestamp ${formatSeconds(spec.seconds)} exceeds video duration (${formatSeconds(Math.floor(streamInfo.duration))})`;\n\t\t\t\treturn { url, title: `Frame at ${options.timestamp}`, content: error, error };\n\t\t\t}\n\t\t\tconst frame = await extractYouTubeFrame(ytInfo.videoId, spec.seconds, streamInfo);\n\t\t\tif (\"error\" in frame) {\n\t\t\t\treturn { url, title: `Frame at ${options.timestamp}`, content: frame.error, error: frame.error };\n\t\t\t}\n\t\t\treturn { url, title: `Frame at ${options.timestamp}`, content: `Video frame at ${options.timestamp}`, error: null, thumbnail: frame };\n\t\t}\n\n\t\tconst localVideo = safeVideoInfo(url);\n\t\tif (localVideo.error) {\n\t\t\treturn { url, title: \"\", content: \"\", error: localVideo.error };\n\t\t}\n\t\tif (localVideo.info) {\n\t\t\tif (spec.type === \"range\") {\n\t\t\t\tconst timestamps = frameCount\n\t\t\t\t\t? computeRangeTimestamps(spec.start, spec.end, frameCount)\n\t\t\t\t\t: computeRangeTimestamps(spec.start, spec.end);\n\t\t\t\tconst result = await extractLocalFrames(localVideo.info.absolutePath, timestamps);\n\t\t\t\tconst label = `${formatSeconds(spec.start)}-${formatSeconds(spec.end)}`;\n\t\t\t\treturn buildFrameResult(url, label, timestamps.length, result.frames, result.error);\n\t\t\t}\n\n\t\t\tif (frameCount) {\n\t\t\t\tconst end = spec.seconds + (frameCount - 1) * MIN_FRAME_INTERVAL;\n\t\t\t\tconst timestamps = computeRangeTimestamps(spec.seconds, end, frameCount);\n\t\t\t\tconst result = await extractLocalFrames(localVideo.info.absolutePath, timestamps);\n\t\t\t\tconst label = `${formatSeconds(spec.seconds)}-${formatSeconds(end)}`;\n\t\t\t\treturn buildFrameResult(url, label, timestamps.length, result.frames, result.error);\n\t\t\t}\n\n\t\t\tconst frame = await extractVideoFrame(localVideo.info.absolutePath, spec.seconds);\n\t\t\tif (\"error\" in frame) {\n\t\t\t\treturn { url, title: `Frame at ${options.timestamp}`, content: frame.error, error: frame.error };\n\t\t\t}\n\t\t\treturn { url, title: `Frame at ${options.timestamp}`, content: `Video frame at ${options.timestamp}`, error: null, thumbnail: frame };\n\t\t}\n\n\t\treturn { url, title: \"\", content: \"\", error: \"Timestamp extraction only works with YouTube and local video files\" };\n\t}\n\n\tconst localVideo = safeVideoInfo(url);\n\tif (localVideo.error) {\n\t\treturn { url, title: \"\", content: \"\", error: localVideo.error };\n\t}\n\tif (localVideo.info) {\n\t\ttry {\n\t\t\tconst result = await extractVideo(localVideo.info, signal, options);\n\t\t\tif (signal?.aborted) return abortedResult(url);\n\t\t\treturn result ?? { url, title: \"\", content: \"\", error: `Video analysis requires Gemini access. Either:\\n  1. Sign into gemini.google.com in Chrome (free, uses cookies)\\n  2. Set GEMINI_API_KEY in ${WEB_SEARCH_CONFIG_PATH}` };\n\t\t} catch (err) {\n\t\t\tif (isAbortError(err)) return abortedResult(url);\n\t\t\treturn { url, title: \"\", content: \"\", error: errorMessage(err) };\n\t\t}\n\t}\n\n\ttry {\n\t\tconst parsed = new URL(url);\n\t\tif (parsed.protocol === \"http:\" || parsed.protocol === \"https:\") {\n\t\t\tawait validateRemoteUrl(parsed, { allowRanges: loadSsrfAllowRanges(), lookup: options?.lookup });\n\t\t}\n\t} catch (err) {\n\t\treturn { url, title: \"\", content: \"\", error: errorMessage(err) };\n\t}\n\n\ttry {\n\t\tconst ghResult = await extractGitHub(url, signal, options?.forceClone);\n\t\tif (ghResult) return ghResult;\n\t\tif (signal?.aborted) return abortedResult(url);\n\t} catch (err) {\n\t\tconst message = errorMessage(err);\n\t\tif (isAbortError(err)) return abortedResult(url);\n\t\tif (isConfigParseError(err)) {\n\t\t\treturn { url, title: \"\", content: \"\", error: message };\n\t\t}\n\t}\n\n\tconst ytInfo = isYouTubeURL(url);\n\tlet youtubeEnabled = false;\n\ttry {\n\t\tyoutubeEnabled = isYouTubeEnabled();\n\t} catch (err) {\n\t\treturn { url, title: \"\", content: \"\", error: errorMessage(err) };\n\t}\n\tif (ytInfo.isYouTube && youtubeEnabled) {\n\t\ttry {\n\t\t\tconst ytResult = await extractYouTube(url, signal, options?.prompt, options?.model);\n\t\t\tif (ytResult) return ytResult;\n\t\t\tif (signal?.aborted) return abortedResult(url);\n\t\t} catch (err) {\n\t\t\tconst message = errorMessage(err);\n\t\t\tif (isAbortError(err)) return abortedResult(url);\n\t\t\treturn { url, title: \"\", content: \"\", error: message };\n\t\t}\n\t\treturn {\n\t\t\turl,\n\t\t\ttitle: \"\",\n\t\t\tcontent: \"\",\n\t\t\terror: \"Could not extract YouTube video content. Sign into Google in Chrome for automatic access, or set GEMINI_API_KEY.\",\n\t\t};\n\t}\n\n\tif (signal?.aborted) return abortedResult(url);\n\n\tconst httpResult = await extractViaHttp(url, signal, options);\n\n\tif (signal?.aborted) return abortedResult(url);\n\tif (!httpResult.error) return httpResult;\n\tif (NON_RECOVERABLE_ERRORS.some(prefix => httpResult.error!.startsWith(prefix))) return httpResult;\n\n\tconst jinaResult = await extractWithJinaReader(url, signal, options?.lookup);\n\tif (jinaResult) return jinaResult;\n\tif (signal?.aborted) return abortedResult(url);\n\n\tlet parallelError: string | null = null;\n\ttry {\n\t\tif (isParallelAvailable()) {\n\t\t\tconst parallelResult = await extractWithParallel(url, signal, options);\n\t\t\tif (parallelResult) return parallelResult;\n\t\t}\n\t} catch (err) {\n\t\tif (isAbortError(err)) return abortedResult(url);\n\t\tparallelError = errorMessage(err);\n\t\tif (isConfigParseError(err)) {\n\t\t\treturn { ...httpResult, error: parallelError };\n\t\t}\n\t}\n\tif (signal?.aborted) return abortedResult(url);\n\n\tlet geminiResult: ExtractedContent | null = null;\n\ttry {\n\t\tgeminiResult = await extractWithUrlContext(url, signal)\n\t\t\t?? await extractWithGeminiWeb(url, signal);\n\t} catch (err) {\n\t\tif (isAbortError(err)) return abortedResult(url);\n\t\tif (isConfigParseError(err)) {\n\t\t\treturn { ...httpResult, error: errorMessage(err) };\n\t\t}\n\t}\n\n\tif (geminiResult) return geminiResult;\n\tif (signal?.aborted) return abortedResult(url);\n\n\tconst guidance = [\n\t\thttpResult.error,\n\t\t...(parallelError ? [`Parallel fallback failed: ${parallelError}`] : []),\n\t\t\"\",\n\t\t\"Fallback options:\",\n\t\t`  \\u2022 Set PARALLEL_API_KEY in ${WEB_SEARCH_CONFIG_PATH}`,\n\t\t`  \\u2022 Set GEMINI_API_KEY in ${WEB_SEARCH_CONFIG_PATH}`,\n\t\t\"  \\u2022 Sign into gemini.google.com in Chrome\",\n\t\t\"  \\u2022 Use web_search to find content about this topic\",\n\t].join(\"\\n\");\n\treturn { ...httpResult, error: guidance };\n}\n\nfunction isLikelyJSRendered(html: string): boolean {\n\t// Extract body content\n\tconst bodyMatch = html.match(/<body[^>]*>([\\s\\S]*?)<\\/body>/i);\n\tif (!bodyMatch) return false;\n\n\tconst bodyHtml = bodyMatch[1];\n\n\t// Strip tags to get text content\n\tconst textContent = bodyHtml\n\t\t.replace(/<script[\\s\\S]*?<\\/script>/gi, \"\")\n\t\t.replace(/<style[\\s\\S]*?<\\/style>/gi, \"\")\n\t\t.replace(/<[^>]+>/g, \"\")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n\n\t// Count scripts\n\tconst scriptCount = (html.match(/<script/gi) || []).length;\n\n\t// Heuristic: little text content but many scripts suggests JS rendering\n\treturn textContent.length < 500 && scriptCount > 3;\n}\n\nasync function extractViaHttp(\n\turl: string,\n\tsignal?: AbortSignal,\n\toptions?: ExtractOptions,\n): Promise<ExtractedContent> {\n\tconst timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n\tconst activityId = activityMonitor.logStart({ type: \"fetch\", url });\n\n\tconst controller = new AbortController();\n\tconst timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n\n\tconst onAbort = () => controller.abort();\n\tsignal?.addEventListener(\"abort\", onAbort);\n\n\ttry {\n\t\tconst response = await fetchRemoteUrl(\n\t\t\turl,\n\t\t\t{\n\t\t\t\tsignal: controller.signal,\n\t\t\t\theaders: {\n\t\t\t\t\t\"User-Agent\": \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36\",\n\t\t\t\t\t\"Accept\": \"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8\",\n\t\t\t\t\t\"Accept-Language\": \"en-US,en;q=0.9\",\n\t\t\t\t\t\"Cache-Control\": \"no-cache\",\n\t\t\t\t\t\"Sec-Fetch-Dest\": \"document\",\n\t\t\t\t\t\"Sec-Fetch-Mode\": \"navigate\",\n\t\t\t\t\t\"Sec-Fetch-Site\": \"none\",\n\t\t\t\t\t\"Sec-Fetch-User\": \"?1\",\n\t\t\t\t\t\"Upgrade-Insecure-Requests\": \"1\",\n\t\t\t\t},\n\t\t\t},\n\t\t\t{ allowRanges: loadSsrfAllowRanges(), lookup: options?.lookup },\n\t\t);\n\n\t\tif (!response.ok) {\n\t\t\tactivityMonitor.logComplete(activityId, response.status);\n\t\t\treturn {\n\t\t\t\turl,\n\t\t\t\ttitle: \"\",\n\t\t\t\tcontent: \"\",\n\t\t\t\terror: `HTTP ${response.status}: ${response.statusText}`,\n\t\t\t};\n\t\t}\n\n\t\tconst contentLengthHeader = response.headers.get(\"content-length\");\n\t\tconst contentType = response.headers.get(\"content-type\") || \"\";\n\t\tconst isPDFContent = isPDF(url, contentType);\n\t\tconst maxResponseSize = isPDFContent ? 20 * 1024 * 1024 : 5 * 1024 * 1024;\n\t\tif (contentLengthHeader) {\n\t\t\tconst contentLength = parseInt(contentLengthHeader, 10);\n\t\t\tif (contentLength > maxResponseSize) {\n\t\t\t\tactivityMonitor.logComplete(activityId, response.status);\n\t\t\t\treturn {\n\t\t\t\t\turl,\n\t\t\t\t\ttitle: \"\",\n\t\t\t\t\tcontent: \"\",\n\t\t\t\t\terror: `Response too large (${Math.round(contentLength / 1024 / 1024)}MB)`,\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\n\t\tif (isPDFContent) {\n\t\t\ttry {\n\t\t\t\tconst buffer = await response.arrayBuffer();\n\t\t\t\tconst result = await extractPDFToMarkdown(buffer, url);\n\t\t\t\tactivityMonitor.logComplete(activityId, response.status);\n\t\t\t\treturn {\n\t\t\t\t\turl,\n\t\t\t\t\ttitle: result.title,\n\t\t\t\t\tcontent: `PDF extracted and saved to: ${result.outputPath}\\n\\nPages: ${result.pages}\\nCharacters: ${result.chars}`,\n\t\t\t\t\terror: null,\n\t\t\t\t};\n\t\t\t} catch (err) {\n\t\t\t\tconst message = err instanceof Error ? err.message : String(err);\n\t\t\t\tactivityMonitor.logError(activityId, message);\n\t\t\t\treturn { url, title: \"\", content: \"\", error: `PDF extraction failed: ${message}` };\n\t\t\t}\n\t\t}\n\n\t\tif (contentType.includes(\"application/octet-stream\") ||\n\t\t\tcontentType.includes(\"image/\") ||\n\t\t\tcontentType.includes(\"audio/\") ||\n\t\t\tcontentType.includes(\"video/\") ||\n\t\t\tcontentType.includes(\"application/zip\")) {\n\t\t\tactivityMonitor.logComplete(activityId, response.status);\n\t\t\treturn {\n\t\t\t\turl,\n\t\t\t\ttitle: \"\",\n\t\t\t\tcontent: \"\",\n\t\t\t\terror: `Unsupported content type: ${contentType.split(\";\")[0]}`,\n\t\t\t};\n\t\t}\n\n\t\tconst text = await response.text();\n\t\tconst isHTML = contentType.includes(\"text/html\") || contentType.includes(\"application/xhtml+xml\");\n\n\t\tif (!isHTML) {\n\t\t\tactivityMonitor.logComplete(activityId, response.status);\n\t\t\tconst title = extractTextTitle(text, url);\n\t\t\treturn { url, title, content: text, error: null };\n\t\t}\n\n\t\tconst { document } = parseHTML(text);\n\t\tconst reader = new Readability(document as unknown as Document);\n\t\tconst article = reader.parse();\n\n\t\tif (!article) {\n\t\t\tconst rscResult = extractRSCContent(text);\n\t\t\tif (rscResult) {\n\t\t\t\tactivityMonitor.logComplete(activityId, response.status);\n\t\t\t\treturn { url, title: rscResult.title, content: rscResult.content, error: null };\n\t\t\t}\n\n\t\t\tactivityMonitor.logComplete(activityId, response.status);\n\n\t\t\t// Provide more specific error message\n\t\t\tconst jsRendered = isLikelyJSRendered(text);\n\t\t\tconst errorMsg = jsRendered\n\t\t\t\t? \"Page appears to be JavaScript-rendered (content loads dynamically)\"\n\t\t\t\t: \"Could not extract readable content from HTML structure\";\n\n\t\t\treturn {\n\t\t\t\turl,\n\t\t\t\ttitle: \"\",\n\t\t\t\tcontent: \"\",\n\t\t\t\terror: errorMsg,\n\t\t\t};\n\t\t}\n\n\t\tconst markdown = turndown.turndown(article.content);\n\t\tactivityMonitor.logComplete(activityId, response.status);\n\n\t\tif (markdown.length < MIN_USEFUL_CONTENT) {\n\t\t\treturn {\n\t\t\t\turl,\n\t\t\t\ttitle: article.title || \"\",\n\t\t\t\tcontent: markdown,\n\t\t\t\terror: isLikelyJSRendered(text)\n\t\t\t\t\t? \"Page appears to be JavaScript-rendered (content loads dynamically)\"\n\t\t\t\t\t: \"Extracted content appears incomplete\",\n\t\t\t};\n\t\t}\n\n\t\treturn { url, title: article.title || \"\", content: markdown, error: null };\n\t} catch (err) {\n\t\tconst message = err instanceof Error ? err.message : String(err);\n\t\tif (message.toLowerCase().includes(\"abort\")) {\n\t\t\tactivityMonitor.logComplete(activityId, 0);\n\t\t} else {\n\t\t\tactivityMonitor.logError(activityId, message);\n\t\t}\n\t\treturn { url, title: \"\", content: \"\", error: message };\n\t} finally {\n\t\tclearTimeout(timeoutId);\n\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t}\n}\n\nexport function extractHeadingTitle(text: string): string | null {\n\tconst match = text.match(/^#{1,2}\\s+(.+)/m);\n\tif (!match) return null;\n\tconst cleaned = match[1].replace(/\\*+/g, \"\").trim();\n\treturn cleaned || null;\n}\n\nfunction extractTextTitle(text: string, url: string): string {\n\treturn extractHeadingTitle(text) ?? (new URL(url).pathname.split(\"/\").pop() || url);\n}\n\nexport async function fetchAllContent(\n\turls: string[],\n\tsignal?: AbortSignal,\n\toptions?: ExtractOptions,\n): Promise<ExtractedContent[]> {\n\treturn Promise.all(urls.map((url) => fetchLimit(() => extractContent(url, signal, options))));\n}\n"]}
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-web-access/extract.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAqC,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAgDtF;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAuB9C;AAyBD,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3D,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAgJD,wBAAsB,cAAc,CACnC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA0Q3B;AAuLD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK/D;AAMD,wBAAsB,eAAe,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAE7B","sourcesContent":["// @ts-nocheck\nimport { Readability } from \"@mozilla/readability\";\nimport { parseHTML } from \"linkedom\";\nimport TurndownService from \"turndown\";\nimport pLimit from \"p-limit\";\nimport { activityMonitor } from \"./activity.ts\";\nimport { extractRSCContent } from \"./rsc-extract.ts\";\nimport {\n\tloadGeminiUrlContext,\n\tloadGithubExtract,\n\tloadParallel,\n\tloadPdfExtract,\n\tloadVideoExtract,\n\tloadYoutubeExtract,\n} from \"./lazy.ts\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { fetchRemoteUrl, validateRemoteUrl, type Lookup } from \"./ssrf-protection.ts\";\nimport { formatSeconds, getWebSearchConfigPath } from \"./utils.ts\";\n\nconst YOUTUBE_URL_RE =\n\t/(?:(?:www\\.|m\\.)?youtube\\.com\\/(?:watch\\?.*v=|shorts\\/|live\\/|embed\\/|v\\/)|youtu\\.be\\/)([a-zA-Z0-9_-]{11})/;\n\nfunction isYouTubeURL(url: string): { isYouTube: boolean; videoId: string | null } {\n\ttry {\n\t\tconst parsed = new URL(url);\n\t\tif (parsed.pathname === \"/playlist\") {\n\t\t\treturn { isYouTube: false, videoId: null };\n\t\t}\n\t} catch {\n\t}\n\tconst match = url.match(YOUTUBE_URL_RE);\n\tif (!match) return { isYouTube: false, videoId: null };\n\treturn { isYouTube: true, videoId: match[1] };\n}\n\nfunction isPDF(url: string, contentType?: string): boolean {\n\tif (contentType?.includes(\"application/pdf\")) return true;\n\ttry {\n\t\treturn new URL(url).pathname.toLowerCase().endsWith(\".pdf\");\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction looksLikeLocalPath(input: string): boolean {\n\treturn input.startsWith(\"/\") || input.startsWith(\"./\") || input.startsWith(\"../\") || input.startsWith(\"file://\");\n}\n\nfunction looksLikeGitHubUrl(url: string): boolean {\n\ttry {\n\t\tconst host = new URL(url).hostname.toLowerCase();\n\t\treturn host === \"github.com\" || host === \"www.github.com\" || host.endsWith(\".github.com\");\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nconst DEFAULT_TIMEOUT_MS = 30000;\nconst CONCURRENT_LIMIT = 3;\n\nconst NON_RECOVERABLE_ERRORS = [\"Unsupported content type\", \"Response too large\"];\nconst MIN_USEFUL_CONTENT = 500;\nconst WEB_SEARCH_CONFIG_PATH = getWebSearchConfigPath();\n\n/**\n * Read `ssrf.allowRanges` (CIDR strings) from web-search.json. Returns [] when\n * the file is missing, unreadable, or the key is unset so SSRF protection stays\n * fully on by default. Throws when `ssrf.allowRanges` is present but not an array\n * so a mistyped value (e.g. a bare string instead of a JSON array) fails loudly\n * instead of being silently ignored. Exempts synthetic ranges used by TUN/fake-IP\n * proxies (e.g. 198.18.0.0/15).\n */\nexport function loadSsrfAllowRanges(): string[] {\n\tlet value: unknown;\n\ttry {\n\t\tif (!existsSync(WEB_SEARCH_CONFIG_PATH)) return [];\n\t\tconst raw = readFileSync(WEB_SEARCH_CONFIG_PATH, \"utf-8\");\n\t\tvalue = (JSON.parse(raw) as { ssrf?: { allowRanges?: unknown } })?.ssrf?.allowRanges;\n\t} catch {\n\t\t// Missing/unreadable file or invalid JSON: fail safe with SSRF fully on.\n\t\treturn [];\n\t}\n\tif (value === undefined || value === null) return [];\n\tif (!Array.isArray(value)) {\n\t\tthrow new Error(`ssrf.allowRanges in ${WEB_SEARCH_CONFIG_PATH} must be an array of CIDR strings`);\n\t}\n\tconst ranges: string[] = [];\n\tfor (const [index, entry] of value.entries()) {\n\t\tif (typeof entry !== \"string\") {\n\t\t\tthrow new Error(`ssrf.allowRanges in ${WEB_SEARCH_CONFIG_PATH} must contain only CIDR strings; entry ${index + 1} is ${typeof entry}`);\n\t\t}\n\t\tconst trimmed = entry.trim();\n\t\tif (trimmed) ranges.push(trimmed);\n\t}\n\treturn ranges;\n}\n\nfunction errorMessage(err: unknown): string {\n\treturn err instanceof Error ? err.message : String(err);\n}\n\nfunction isConfigParseError(err: unknown): boolean {\n\treturn errorMessage(err).startsWith(\"Failed to parse \");\n}\n\nfunction isAbortError(err: unknown): boolean {\n\treturn errorMessage(err).toLowerCase().includes(\"abort\");\n}\n\nfunction abortedResult(url: string): ExtractedContent {\n\treturn { url, title: \"\", content: \"\", error: \"Aborted\" };\n}\n\nconst turndown = new TurndownService({\n\theadingStyle: \"atx\",\n\tcodeBlockStyle: \"fenced\",\n});\n\nconst fetchLimit = pLimit(CONCURRENT_LIMIT);\n\nexport interface VideoFrame {\n\tdata: string;\n\tmimeType: string;\n\ttimestamp: string;\n}\n\nexport type FrameData = { data: string; mimeType: string };\nexport type FrameResult = FrameData | { error: string };\n\nexport interface ExtractedContent {\n\turl: string;\n\ttitle: string;\n\tcontent: string;\n\terror: string | null;\n\tthumbnail?: { data: string; mimeType: string };\n\tframes?: VideoFrame[];\n\tduration?: number;\n}\n\nexport interface ExtractOptions {\n\ttimeoutMs?: number;\n\tforceClone?: boolean;\n\tprompt?: string;\n\ttimestamp?: string;\n\tframes?: number;\n\tmodel?: string;\n\t/** Custom DNS resolver used for SSRF validation. Primarily a test seam. */\n\tlookup?: Lookup;\n}\n\nconst JINA_READER_BASE = \"https://r.jina.ai/\";\nconst JINA_TIMEOUT_MS = 30000;\n\nasync function extractWithJinaReader(\n\turl: string,\n\tsignal?: AbortSignal,\n\tlookup?: Lookup,\n): Promise<ExtractedContent | null> {\n\tconst jinaUrl = JINA_READER_BASE + url;\n\n\tconst activityId = activityMonitor.logStart({ type: \"api\", query: `jina: ${url}` });\n\n\ttry {\n\t\tawait validateRemoteUrl(url, { allowRanges: loadSsrfAllowRanges(), lookup });\n\t\tconst res = await fetch(jinaUrl, {\n\t\t\theaders: {\n\t\t\t\t\"Accept\": \"text/markdown\",\n\t\t\t\t\"X-No-Cache\": \"true\",\n\t\t\t},\n\t\t\tsignal: AbortSignal.any([\n\t\t\t\tAbortSignal.timeout(JINA_TIMEOUT_MS),\n\t\t\t\t...(signal ? [signal] : []),\n\t\t\t]),\n\t\t});\n\n\t\tif (!res.ok) {\n\t\t\tactivityMonitor.logComplete(activityId, res.status);\n\t\t\treturn null;\n\t\t}\n\n\t\tconst content = await res.text();\n\t\tactivityMonitor.logComplete(activityId, res.status);\n\n\t\tconst contentStart = content.indexOf(\"Markdown Content:\");\n\t\tif (contentStart < 0) {\n\t\t\treturn null;\n\t\t}\n\n\t\tconst markdownPart = content.slice(contentStart + 17).trim(); // 17 = \"Markdown Content:\".length\n\n\t\t// Check for failed JS rendering or minimal content\n\t\tif (markdownPart.length < 100 ||\n\t\t\tmarkdownPart.startsWith(\"Loading...\") ||\n\t\t\tmarkdownPart.startsWith(\"Please enable JavaScript\")) {\n\t\t\treturn null;\n\t\t}\n\n\t\tconst title = extractHeadingTitle(markdownPart) ?? (new URL(url).pathname.split(\"/\").pop() || url);\n\t\treturn { url, title, content: markdownPart, error: null };\n\t} catch (err) {\n\t\tconst message = err instanceof Error ? err.message : String(err);\n\t\tif (message.toLowerCase().includes(\"abort\")) {\n\t\t\tactivityMonitor.logComplete(activityId, 0);\n\t\t} else {\n\t\t\tactivityMonitor.logError(activityId, message);\n\t\t}\n\t\treturn null;\n\t}\n}\n\nfunction parseTimestamp(ts: string): number | null {\n\tconst num = Number(ts);\n\tif (!isNaN(num) && num >= 0) return Math.floor(num);\n\tconst parts = ts.split(\":\").map(Number);\n\tif (parts.some(p => isNaN(p) || p < 0)) return null;\n\tif (parts.length === 3) return Math.floor(parts[0] * 3600 + parts[1] * 60 + parts[2]);\n\tif (parts.length === 2) return Math.floor(parts[0] * 60 + parts[1]);\n\treturn null;\n}\n\ntype TimestampSpec = { type: \"single\"; seconds: number } | { type: \"range\"; start: number; end: number };\n\nfunction parseTimestampSpec(ts: string): TimestampSpec | null {\n\tconst dashIdx = ts.indexOf(\"-\", 1);\n\tif (dashIdx > 0) {\n\t\tconst start = parseTimestamp(ts.slice(0, dashIdx));\n\t\tconst end = parseTimestamp(ts.slice(dashIdx + 1));\n\t\tif (start !== null && end !== null && end > start) return { type: \"range\", start, end };\n\t}\n\tconst seconds = parseTimestamp(ts);\n\treturn seconds !== null ? { type: \"single\", seconds } : null;\n}\n\nconst DEFAULT_RANGE_FRAMES = 6;\nconst MIN_FRAME_INTERVAL = 5;\n\nfunction computeRangeTimestamps(start: number, end: number, maxFrames: number = DEFAULT_RANGE_FRAMES): number[] {\n\tif (maxFrames <= 1) return [start];\n\tconst duration = end - start;\n\tconst idealInterval = duration / (maxFrames - 1);\n\tif (idealInterval < MIN_FRAME_INTERVAL) {\n\t\tconst timestamps: number[] = [];\n\t\tfor (let t = start; t <= end && timestamps.length < maxFrames; t += MIN_FRAME_INTERVAL) {\n\t\t\ttimestamps.push(t);\n\t\t}\n\t\treturn timestamps;\n\t}\n\treturn Array.from({ length: maxFrames }, (_, i) => Math.round(start + i * idealInterval));\n}\n\nfunction buildFrameResult(\n\turl: string, label: string, requestedCount: number,\n\tframes: VideoFrame[], error: string | null, duration?: number,\n): ExtractedContent {\n\tif (frames.length === 0) {\n\t\tconst msg = error ?? \"Frame extraction failed\";\n\t\treturn { url, title: `Frames ${label} (0/${requestedCount})`, content: msg, error: msg };\n\t}\n\treturn {\n\t\turl,\n\t\ttitle: `Frames ${label} (${frames.length}/${requestedCount})`,\n\t\tcontent: `${frames.length} frames extracted from ${label}`,\n\t\terror: null,\n\t\tframes,\n\t\tduration,\n\t};\n}\n\nasync function extractLocalFrames(\n\tfilePath: string, timestamps: number[],\n): Promise<{ frames: VideoFrame[]; error: string | null }> {\n\tconst { extractVideoFrame } = await loadVideoExtract();\n\tconst results = await Promise.all(timestamps.map(async (t) => {\n\t\tconst frame = await extractVideoFrame(filePath, t);\n\t\tif (\"error\" in frame) return { error: frame.error };\n\t\treturn { ...frame, timestamp: formatSeconds(t) };\n\t}));\n\tconst frames = results.filter((f): f is VideoFrame => \"data\" in f);\n\tconst firstError = results.find((f): f is { error: string } => \"error\" in f);\n\treturn { frames, error: frames.length === 0 && firstError ? firstError.error : null };\n}\n\nasync function safeVideoInfo(url: string): Promise<{ info: Awaited<ReturnType<typeof loadVideoExtract>> extends { isVideoFile: infer F } ? (F extends (...args: any) => infer R ? R : null) : null; error?: string }> {\n\tif (!looksLikeLocalPath(url)) return { info: null };\n\ttry {\n\t\tconst { isVideoFile } = await loadVideoExtract();\n\t\treturn { info: isVideoFile(url) };\n\t} catch (err) {\n\t\treturn { info: null, error: errorMessage(err) };\n\t}\n}\n\nexport async function extractContent(\n\turl: string,\n\tsignal?: AbortSignal,\n\toptions?: ExtractOptions,\n): Promise<ExtractedContent> {\n\tif (signal?.aborted) {\n\t\treturn { url, title: \"\", content: \"\", error: \"Aborted\" };\n\t}\n\n\tif (options?.frames && !options.timestamp) {\n\t\tconst frameCount = options.frames;\n\t\tconst ytInfo = isYouTubeURL(url);\n\t\tif (ytInfo.isYouTube && ytInfo.videoId) {\n\t\t\tconst yt = await loadYoutubeExtract();\n\t\t\tconst streamInfo = await yt.getYouTubeStreamInfo(ytInfo.videoId);\n\t\t\tif (\"error\" in streamInfo) {\n\t\t\t\treturn { url, title: \"Frames\", content: streamInfo.error, error: streamInfo.error };\n\t\t\t}\n\t\t\tif (streamInfo.duration === null) {\n\t\t\t\tconst error = \"Cannot determine video duration. Use a timestamp range instead.\";\n\t\t\t\treturn { url, title: \"Frames\", content: error, error };\n\t\t\t}\n\t\t\tconst dur = Math.floor(streamInfo.duration);\n\t\t\tconst timestamps = computeRangeTimestamps(0, dur, frameCount);\n\t\t\tconst result = await yt.extractYouTubeFrames(ytInfo.videoId, timestamps, streamInfo);\n\t\t\tconst label = `${formatSeconds(0)}-${formatSeconds(dur)}`;\n\t\t\treturn buildFrameResult(url, label, timestamps.length, result.frames, result.error, streamInfo.duration);\n\t\t}\n\n\t\tconst localVideo = await safeVideoInfo(url);\n\t\tif (localVideo.error) {\n\t\t\treturn { url, title: \"\", content: \"\", error: localVideo.error };\n\t\t}\n\t\tif (localVideo.info) {\n\t\t\tconst { getLocalVideoDuration } = await loadVideoExtract();\n\t\t\tconst durationResult = await getLocalVideoDuration(localVideo.info.absolutePath);\n\t\t\tif (typeof durationResult !== \"number\") {\n\t\t\t\treturn { url, title: \"Frames\", content: durationResult.error, error: durationResult.error };\n\t\t\t}\n\t\t\tconst dur = Math.floor(durationResult);\n\t\t\tconst timestamps = computeRangeTimestamps(0, dur, frameCount);\n\t\t\tconst result = await extractLocalFrames(localVideo.info.absolutePath, timestamps);\n\t\t\tconst label = `${formatSeconds(0)}-${formatSeconds(dur)}`;\n\t\t\treturn buildFrameResult(url, label, timestamps.length, result.frames, result.error, durationResult);\n\t\t}\n\n\t\treturn { url, title: \"\", content: \"\", error: \"Frame extraction only works with YouTube and local video files\" };\n\t}\n\n\tif (options?.timestamp) {\n\t\tconst spec = parseTimestampSpec(options.timestamp);\n\t\tif (!spec) {\n\t\t\treturn {\n\t\t\t\turl,\n\t\t\t\ttitle: \"\",\n\t\t\t\tcontent: \"\",\n\t\t\t\terror: `Invalid timestamp format: \"${options.timestamp}\". Use \"H:MM:SS\", \"MM:SS\", \"85\", or \"start-end\".`,\n\t\t\t};\n\t\t}\n\n\t\tconst frameCount = options.frames;\n\t\tconst ytInfo = isYouTubeURL(url);\n\t\tif (ytInfo.isYouTube && ytInfo.videoId) {\n\t\t\tconst yt = await loadYoutubeExtract();\n\t\t\tconst streamInfo = await yt.getYouTubeStreamInfo(ytInfo.videoId);\n\t\t\tif (\"error\" in streamInfo) {\n\t\t\t\tif (spec.type === \"range\") {\n\t\t\t\t\tconst label = `${formatSeconds(spec.start)}-${formatSeconds(spec.end)}`;\n\t\t\t\t\treturn { url, title: `Frames ${label}`, content: streamInfo.error, error: streamInfo.error };\n\t\t\t\t}\n\t\t\t\tif (frameCount) {\n\t\t\t\t\tconst end = spec.seconds + (frameCount - 1) * MIN_FRAME_INTERVAL;\n\t\t\t\t\tconst label = `${formatSeconds(spec.seconds)}-${formatSeconds(end)}`;\n\t\t\t\t\treturn { url, title: `Frames ${label}`, content: streamInfo.error, error: streamInfo.error };\n\t\t\t\t}\n\t\t\t\treturn { url, title: `Frame at ${options.timestamp}`, content: streamInfo.error, error: streamInfo.error };\n\t\t\t}\n\n\t\t\tif (spec.type === \"range\") {\n\t\t\t\tconst label = `${formatSeconds(spec.start)}-${formatSeconds(spec.end)}`;\n\t\t\t\tif (streamInfo.duration !== null && spec.end > streamInfo.duration) {\n\t\t\t\t\tconst error = `Timestamp ${formatSeconds(spec.end)} exceeds video duration (${formatSeconds(Math.floor(streamInfo.duration))})`;\n\t\t\t\t\treturn { url, title: `Frames ${label}`, content: error, error };\n\t\t\t\t}\n\t\t\t\tconst timestamps = frameCount\n\t\t\t\t\t? computeRangeTimestamps(spec.start, spec.end, frameCount)\n\t\t\t\t\t: computeRangeTimestamps(spec.start, spec.end);\n\t\t\t\tconst result = await yt.extractYouTubeFrames(ytInfo.videoId, timestamps, streamInfo);\n\t\t\t\treturn buildFrameResult(url, label, timestamps.length, result.frames, result.error, result.duration ?? undefined);\n\t\t\t}\n\n\t\t\tif (frameCount) {\n\t\t\t\tconst end = spec.seconds + (frameCount - 1) * MIN_FRAME_INTERVAL;\n\t\t\t\tconst label = `${formatSeconds(spec.seconds)}-${formatSeconds(end)}`;\n\t\t\t\tif (streamInfo.duration !== null && end > streamInfo.duration) {\n\t\t\t\t\tconst error = `Timestamp ${formatSeconds(end)} exceeds video duration (${formatSeconds(Math.floor(streamInfo.duration))})`;\n\t\t\t\t\treturn { url, title: `Frames ${label}`, content: error, error };\n\t\t\t\t}\n\t\t\t\tconst timestamps = computeRangeTimestamps(spec.seconds, end, frameCount);\n\t\t\t\tconst result = await yt.extractYouTubeFrames(ytInfo.videoId, timestamps, streamInfo);\n\t\t\t\treturn buildFrameResult(url, label, timestamps.length, result.frames, result.error, result.duration ?? undefined);\n\t\t\t}\n\n\t\t\tif (streamInfo.duration !== null && spec.seconds > streamInfo.duration) {\n\t\t\t\tconst error = `Timestamp ${formatSeconds(spec.seconds)} exceeds video duration (${formatSeconds(Math.floor(streamInfo.duration))})`;\n\t\t\t\treturn { url, title: `Frame at ${options.timestamp}`, content: error, error };\n\t\t\t}\n\t\t\tconst frame = await yt.extractYouTubeFrame(ytInfo.videoId, spec.seconds, streamInfo);\n\t\t\tif (\"error\" in frame) {\n\t\t\t\treturn { url, title: `Frame at ${options.timestamp}`, content: frame.error, error: frame.error };\n\t\t\t}\n\t\t\treturn { url, title: `Frame at ${options.timestamp}`, content: `Video frame at ${options.timestamp}`, error: null, thumbnail: frame };\n\t\t}\n\n\t\tconst localVideo = await safeVideoInfo(url);\n\t\tif (localVideo.error) {\n\t\t\treturn { url, title: \"\", content: \"\", error: localVideo.error };\n\t\t}\n\t\tif (localVideo.info) {\n\t\t\tif (spec.type === \"range\") {\n\t\t\t\tconst timestamps = frameCount\n\t\t\t\t\t? computeRangeTimestamps(spec.start, spec.end, frameCount)\n\t\t\t\t\t: computeRangeTimestamps(spec.start, spec.end);\n\t\t\t\tconst result = await extractLocalFrames(localVideo.info.absolutePath, timestamps);\n\t\t\t\tconst label = `${formatSeconds(spec.start)}-${formatSeconds(spec.end)}`;\n\t\t\t\treturn buildFrameResult(url, label, timestamps.length, result.frames, result.error);\n\t\t\t}\n\n\t\t\tif (frameCount) {\n\t\t\t\tconst end = spec.seconds + (frameCount - 1) * MIN_FRAME_INTERVAL;\n\t\t\t\tconst timestamps = computeRangeTimestamps(spec.seconds, end, frameCount);\n\t\t\t\tconst result = await extractLocalFrames(localVideo.info.absolutePath, timestamps);\n\t\t\t\tconst label = `${formatSeconds(spec.seconds)}-${formatSeconds(end)}`;\n\t\t\t\treturn buildFrameResult(url, label, timestamps.length, result.frames, result.error);\n\t\t\t}\n\n\t\t\tconst { extractVideoFrame } = await loadVideoExtract();\n\t\t\tconst frame = await extractVideoFrame(localVideo.info.absolutePath, spec.seconds);\n\t\t\tif (\"error\" in frame) {\n\t\t\t\treturn { url, title: `Frame at ${options.timestamp}`, content: frame.error, error: frame.error };\n\t\t\t}\n\t\t\treturn { url, title: `Frame at ${options.timestamp}`, content: `Video frame at ${options.timestamp}`, error: null, thumbnail: frame };\n\t\t}\n\n\t\treturn { url, title: \"\", content: \"\", error: \"Timestamp extraction only works with YouTube and local video files\" };\n\t}\n\n\tconst localVideo = await safeVideoInfo(url);\n\tif (localVideo.error) {\n\t\treturn { url, title: \"\", content: \"\", error: localVideo.error };\n\t}\n\tif (localVideo.info) {\n\t\ttry {\n\t\t\tconst { extractVideo } = await loadVideoExtract();\n\t\t\tconst result = await extractVideo(localVideo.info, signal, options);\n\t\t\tif (signal?.aborted) return abortedResult(url);\n\t\t\treturn result ?? { url, title: \"\", content: \"\", error: `Video analysis requires Gemini access. Either:\\n  1. Sign into gemini.google.com in Chrome (free, uses cookies)\\n  2. Set GEMINI_API_KEY in ${WEB_SEARCH_CONFIG_PATH}` };\n\t\t} catch (err) {\n\t\t\tif (isAbortError(err)) return abortedResult(url);\n\t\t\treturn { url, title: \"\", content: \"\", error: errorMessage(err) };\n\t\t}\n\t}\n\n\ttry {\n\t\tconst parsed = new URL(url);\n\t\tif (parsed.protocol === \"http:\" || parsed.protocol === \"https:\") {\n\t\t\tawait validateRemoteUrl(parsed, { allowRanges: loadSsrfAllowRanges(), lookup: options?.lookup });\n\t\t}\n\t} catch (err) {\n\t\treturn { url, title: \"\", content: \"\", error: errorMessage(err) };\n\t}\n\n\tif (looksLikeGitHubUrl(url)) {\n\t\ttry {\n\t\t\tconst { extractGitHub } = await loadGithubExtract();\n\t\t\tconst ghResult = await extractGitHub(url, signal, options?.forceClone);\n\t\t\tif (ghResult) return ghResult;\n\t\t\tif (signal?.aborted) return abortedResult(url);\n\t\t} catch (err) {\n\t\t\tconst message = errorMessage(err);\n\t\t\tif (isAbortError(err)) return abortedResult(url);\n\t\t\tif (isConfigParseError(err)) {\n\t\t\t\treturn { url, title: \"\", content: \"\", error: message };\n\t\t\t}\n\t\t}\n\t}\n\n\tconst ytInfo = isYouTubeURL(url);\n\tif (ytInfo.isYouTube) {\n\t\tlet youtubeEnabled = false;\n\t\tlet yt;\n\t\ttry {\n\t\t\tyt = await loadYoutubeExtract();\n\t\t\tyoutubeEnabled = yt.isYouTubeEnabled();\n\t\t} catch (err) {\n\t\t\treturn { url, title: \"\", content: \"\", error: errorMessage(err) };\n\t\t}\n\t\tif (youtubeEnabled) {\n\t\t\ttry {\n\t\t\t\tconst ytResult = await yt.extractYouTube(url, signal, options?.prompt, options?.model);\n\t\t\t\tif (ytResult) return ytResult;\n\t\t\t\tif (signal?.aborted) return abortedResult(url);\n\t\t\t} catch (err) {\n\t\t\t\tconst message = errorMessage(err);\n\t\t\t\tif (isAbortError(err)) return abortedResult(url);\n\t\t\t\treturn { url, title: \"\", content: \"\", error: message };\n\t\t\t}\n\t\t\treturn {\n\t\t\t\turl,\n\t\t\t\ttitle: \"\",\n\t\t\t\tcontent: \"\",\n\t\t\t\terror: \"Could not extract YouTube video content. Sign into Google in Chrome for automatic access, or set GEMINI_API_KEY.\",\n\t\t\t};\n\t\t}\n\t}\n\n\tif (signal?.aborted) return abortedResult(url);\n\n\tconst httpResult = await extractViaHttp(url, signal, options);\n\n\tif (signal?.aborted) return abortedResult(url);\n\tif (!httpResult.error) return httpResult;\n\tif (NON_RECOVERABLE_ERRORS.some(prefix => httpResult.error!.startsWith(prefix))) return httpResult;\n\n\tconst jinaResult = await extractWithJinaReader(url, signal, options?.lookup);\n\tif (jinaResult) return jinaResult;\n\tif (signal?.aborted) return abortedResult(url);\n\n\tlet parallelError: string | null = null;\n\ttry {\n\t\tconst parallel = await loadParallel();\n\t\tif (parallel.isParallelAvailable()) {\n\t\t\tconst parallelResult = await parallel.extractWithParallel(url, signal, options);\n\t\t\tif (parallelResult) return parallelResult;\n\t\t}\n\t} catch (err) {\n\t\tif (isAbortError(err)) return abortedResult(url);\n\t\tparallelError = errorMessage(err);\n\t\tif (isConfigParseError(err)) {\n\t\t\treturn { ...httpResult, error: parallelError };\n\t\t}\n\t}\n\tif (signal?.aborted) return abortedResult(url);\n\n\tlet geminiResult: ExtractedContent | null = null;\n\ttry {\n\t\tconst geminiUrl = await loadGeminiUrlContext();\n\t\tgeminiResult = await geminiUrl.extractWithUrlContext(url, signal)\n\t\t\t?? await geminiUrl.extractWithGeminiWeb(url, signal);\n\t} catch (err) {\n\t\tif (isAbortError(err)) return abortedResult(url);\n\t\tif (isConfigParseError(err)) {\n\t\t\treturn { ...httpResult, error: errorMessage(err) };\n\t\t}\n\t}\n\n\tif (geminiResult) return geminiResult;\n\tif (signal?.aborted) return abortedResult(url);\n\n\tconst guidance = [\n\t\thttpResult.error,\n\t\t...(parallelError ? [`Parallel fallback failed: ${parallelError}`] : []),\n\t\t\"\",\n\t\t\"Fallback options:\",\n\t\t`  \\u2022 Set PARALLEL_API_KEY in ${WEB_SEARCH_CONFIG_PATH}`,\n\t\t`  \\u2022 Set GEMINI_API_KEY in ${WEB_SEARCH_CONFIG_PATH}`,\n\t\t\"  \\u2022 Sign into gemini.google.com in Chrome\",\n\t\t\"  \\u2022 Use web_search to find content about this topic\",\n\t].join(\"\\n\");\n\treturn { ...httpResult, error: guidance };\n}\n\nfunction isLikelyJSRendered(html: string): boolean {\n\t// Extract body content\n\tconst bodyMatch = html.match(/<body[^>]*>([\\s\\S]*?)<\\/body>/i);\n\tif (!bodyMatch) return false;\n\n\tconst bodyHtml = bodyMatch[1];\n\n\t// Strip tags to get text content\n\tconst textContent = bodyHtml\n\t\t.replace(/<script[\\s\\S]*?<\\/script>/gi, \"\")\n\t\t.replace(/<style[\\s\\S]*?<\\/style>/gi, \"\")\n\t\t.replace(/<[^>]+>/g, \"\")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n\n\t// Count scripts\n\tconst scriptCount = (html.match(/<script/gi) || []).length;\n\n\t// Heuristic: little text content but many scripts suggests JS rendering\n\treturn textContent.length < 500 && scriptCount > 3;\n}\n\nasync function extractViaHttp(\n\turl: string,\n\tsignal?: AbortSignal,\n\toptions?: ExtractOptions,\n): Promise<ExtractedContent> {\n\tconst timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n\tconst activityId = activityMonitor.logStart({ type: \"fetch\", url });\n\n\tconst controller = new AbortController();\n\tconst timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n\n\tconst onAbort = () => controller.abort();\n\tsignal?.addEventListener(\"abort\", onAbort);\n\n\ttry {\n\t\tconst response = await fetchRemoteUrl(\n\t\t\turl,\n\t\t\t{\n\t\t\t\tsignal: controller.signal,\n\t\t\t\theaders: {\n\t\t\t\t\t\"User-Agent\": \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36\",\n\t\t\t\t\t\"Accept\": \"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8\",\n\t\t\t\t\t\"Accept-Language\": \"en-US,en;q=0.9\",\n\t\t\t\t\t\"Cache-Control\": \"no-cache\",\n\t\t\t\t\t\"Sec-Fetch-Dest\": \"document\",\n\t\t\t\t\t\"Sec-Fetch-Mode\": \"navigate\",\n\t\t\t\t\t\"Sec-Fetch-Site\": \"none\",\n\t\t\t\t\t\"Sec-Fetch-User\": \"?1\",\n\t\t\t\t\t\"Upgrade-Insecure-Requests\": \"1\",\n\t\t\t\t},\n\t\t\t},\n\t\t\t{ allowRanges: loadSsrfAllowRanges(), lookup: options?.lookup },\n\t\t);\n\n\t\tif (!response.ok) {\n\t\t\tactivityMonitor.logComplete(activityId, response.status);\n\t\t\treturn {\n\t\t\t\turl,\n\t\t\t\ttitle: \"\",\n\t\t\t\tcontent: \"\",\n\t\t\t\terror: `HTTP ${response.status}: ${response.statusText}`,\n\t\t\t};\n\t\t}\n\n\t\tconst contentLengthHeader = response.headers.get(\"content-length\");\n\t\tconst contentType = response.headers.get(\"content-type\") || \"\";\n\t\tconst isPDFContent = isPDF(url, contentType);\n\t\tconst maxResponseSize = isPDFContent ? 20 * 1024 * 1024 : 5 * 1024 * 1024;\n\t\tif (contentLengthHeader) {\n\t\t\tconst contentLength = parseInt(contentLengthHeader, 10);\n\t\t\tif (contentLength > maxResponseSize) {\n\t\t\t\tactivityMonitor.logComplete(activityId, response.status);\n\t\t\t\treturn {\n\t\t\t\t\turl,\n\t\t\t\t\ttitle: \"\",\n\t\t\t\t\tcontent: \"\",\n\t\t\t\t\terror: `Response too large (${Math.round(contentLength / 1024 / 1024)}MB)`,\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\n\t\tif (isPDFContent) {\n\t\t\ttry {\n\t\t\t\tconst buffer = await response.arrayBuffer();\n\t\t\t\tconst { extractPDFToMarkdown } = await loadPdfExtract();\n\t\t\t\tconst result = await extractPDFToMarkdown(buffer, url);\n\t\t\t\tactivityMonitor.logComplete(activityId, response.status);\n\t\t\t\treturn {\n\t\t\t\t\turl,\n\t\t\t\t\ttitle: result.title,\n\t\t\t\t\tcontent: `PDF extracted and saved to: ${result.outputPath}\\n\\nPages: ${result.pages}\\nCharacters: ${result.chars}`,\n\t\t\t\t\terror: null,\n\t\t\t\t};\n\t\t\t} catch (err) {\n\t\t\t\tconst message = err instanceof Error ? err.message : String(err);\n\t\t\t\tactivityMonitor.logError(activityId, message);\n\t\t\t\treturn { url, title: \"\", content: \"\", error: `PDF extraction failed: ${message}` };\n\t\t\t}\n\t\t}\n\n\t\tif (contentType.includes(\"application/octet-stream\") ||\n\t\t\tcontentType.includes(\"image/\") ||\n\t\t\tcontentType.includes(\"audio/\") ||\n\t\t\tcontentType.includes(\"video/\") ||\n\t\t\tcontentType.includes(\"application/zip\")) {\n\t\t\tactivityMonitor.logComplete(activityId, response.status);\n\t\t\treturn {\n\t\t\t\turl,\n\t\t\t\ttitle: \"\",\n\t\t\t\tcontent: \"\",\n\t\t\t\terror: `Unsupported content type: ${contentType.split(\";\")[0]}`,\n\t\t\t};\n\t\t}\n\n\t\tconst text = await response.text();\n\t\tconst isHTML = contentType.includes(\"text/html\") || contentType.includes(\"application/xhtml+xml\");\n\n\t\tif (!isHTML) {\n\t\t\tactivityMonitor.logComplete(activityId, response.status);\n\t\t\tconst title = extractTextTitle(text, url);\n\t\t\treturn { url, title, content: text, error: null };\n\t\t}\n\n\t\tconst { document } = parseHTML(text);\n\t\tconst reader = new Readability(document as unknown as Document);\n\t\tconst article = reader.parse();\n\n\t\tif (!article) {\n\t\t\tconst rscResult = extractRSCContent(text);\n\t\t\tif (rscResult) {\n\t\t\t\tactivityMonitor.logComplete(activityId, response.status);\n\t\t\t\treturn { url, title: rscResult.title, content: rscResult.content, error: null };\n\t\t\t}\n\n\t\t\tactivityMonitor.logComplete(activityId, response.status);\n\n\t\t\t// Provide more specific error message\n\t\t\tconst jsRendered = isLikelyJSRendered(text);\n\t\t\tconst errorMsg = jsRendered\n\t\t\t\t? \"Page appears to be JavaScript-rendered (content loads dynamically)\"\n\t\t\t\t: \"Could not extract readable content from HTML structure\";\n\n\t\t\treturn {\n\t\t\t\turl,\n\t\t\t\ttitle: \"\",\n\t\t\t\tcontent: \"\",\n\t\t\t\terror: errorMsg,\n\t\t\t};\n\t\t}\n\n\t\tconst markdown = turndown.turndown(article.content);\n\t\tactivityMonitor.logComplete(activityId, response.status);\n\n\t\tif (markdown.length < MIN_USEFUL_CONTENT) {\n\t\t\treturn {\n\t\t\t\turl,\n\t\t\t\ttitle: article.title || \"\",\n\t\t\t\tcontent: markdown,\n\t\t\t\terror: isLikelyJSRendered(text)\n\t\t\t\t\t? \"Page appears to be JavaScript-rendered (content loads dynamically)\"\n\t\t\t\t\t: \"Extracted content appears incomplete\",\n\t\t\t};\n\t\t}\n\n\t\treturn { url, title: article.title || \"\", content: markdown, error: null };\n\t} catch (err) {\n\t\tconst message = err instanceof Error ? err.message : String(err);\n\t\tif (message.toLowerCase().includes(\"abort\")) {\n\t\t\tactivityMonitor.logComplete(activityId, 0);\n\t\t} else {\n\t\t\tactivityMonitor.logError(activityId, message);\n\t\t}\n\t\treturn { url, title: \"\", content: \"\", error: message };\n\t} finally {\n\t\tclearTimeout(timeoutId);\n\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t}\n}\n\nexport function extractHeadingTitle(text: string): string | null {\n\tconst match = text.match(/^#{1,2}\\s+(.+)/m);\n\tif (!match) return null;\n\tconst cleaned = match[1].replace(/\\*+/g, \"\").trim();\n\treturn cleaned || null;\n}\n\nfunction extractTextTitle(text: string, url: string): string {\n\treturn extractHeadingTitle(text) ?? (new URL(url).pathname.split(\"/\").pop() || url);\n}\n\nexport async function fetchAllContent(\n\turls: string[],\n\tsignal?: AbortSignal,\n\toptions?: ExtractOptions,\n): Promise<ExtractedContent[]> {\n\treturn Promise.all(urls.map((url) => fetchLimit(() => extractContent(url, signal, options))));\n}\n"]}