@asterxsk/kiln 0.1.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +155 -170
- package/agent/AGENTS.md +67 -67
- package/agent/README.md +5 -5
- package/agent/extensions/ask-user/index.ts +418 -418
- package/agent/extensions/ask-user/install.ps1 +4 -0
- package/agent/extensions/ask-user/install.sh +3 -0
- package/agent/extensions/ask-user/package-lock.json +769 -769
- package/agent/extensions/ask-user/package.json +19 -19
- package/agent/extensions/ask-user/prompt.ts +45 -45
- package/agent/extensions/ask-user/tsconfig.json +7 -7
- package/agent/extensions/background-terminals/docs/implementation-guide.md +942 -942
- package/agent/extensions/background-terminals/index.ts +627 -627
- package/agent/extensions/background-terminals/install.ps1 +4 -0
- package/agent/extensions/background-terminals/install.sh +3 -0
- package/agent/extensions/background-terminals/manager.test.ts +735 -735
- package/agent/extensions/background-terminals/output.test.ts +109 -109
- package/agent/extensions/background-terminals/package-lock.json +769 -769
- package/agent/extensions/background-terminals/package.json +17 -17
- package/agent/extensions/background-terminals/prompt.test.ts +125 -125
- package/agent/extensions/background-terminals/ps.test.ts +82 -82
- package/agent/extensions/background-terminals/result-delivery.test.ts +44 -44
- package/agent/extensions/background-terminals/src/domain.ts +87 -87
- package/agent/extensions/background-terminals/src/manager.ts +907 -907
- package/agent/extensions/background-terminals/src/output.ts +84 -84
- package/agent/extensions/background-terminals/src/prompt.ts +142 -142
- package/agent/extensions/background-terminals/src/result-delivery.ts +27 -27
- package/agent/extensions/background-terminals/src/runtime.ts +36 -36
- package/agent/extensions/background-terminals/src/ui/output-view.ts +79 -79
- package/agent/extensions/background-terminals/src/ui/ps.ts +621 -621
- package/agent/extensions/background-terminals/tsconfig.json +7 -7
- package/agent/extensions/destructive/install.ps1 +4 -0
- package/agent/extensions/destructive/install.sh +3 -0
- package/agent/extensions/file-search/index.spec.ts +443 -443
- package/agent/extensions/file-search/index.ts +459 -459
- package/agent/extensions/file-search/install.ps1 +4 -0
- package/agent/extensions/file-search/install.sh +3 -0
- package/agent/extensions/file-search/package-lock.json +2253 -2253
- package/agent/extensions/file-search/package.json +23 -23
- package/agent/extensions/file-search/src/args.ts +122 -122
- package/agent/extensions/file-search/src/binaries.ts +422 -422
- package/agent/extensions/file-search/src/output.ts +126 -126
- package/agent/extensions/file-search/src/process.ts +146 -146
- package/agent/extensions/file-search/src/prompt.ts +52 -52
- package/agent/extensions/file-search/tsconfig.json +7 -7
- package/agent/extensions/goal/install.ps1 +4 -0
- package/agent/extensions/goal/install.sh +3 -0
- package/agent/extensions/herdr-agent-state.ts +257 -0
- package/agent/extensions/kiln-update/README.md +25 -0
- package/agent/extensions/kiln-update/index.ts +99 -0
- package/agent/extensions/kiln-update/install.ps1 +27 -0
- package/agent/extensions/kiln-update/install.sh +24 -0
- package/agent/extensions/modelconf/PLAN.md +915 -915
- package/agent/extensions/modelconf/index.ts +296 -296
- package/agent/extensions/modelconf/install.ps1 +4 -0
- package/agent/extensions/modelconf/install.sh +3 -0
- package/agent/extensions/modelconf/src/ui/ModelConfView.ts +1101 -1101
- package/agent/extensions/pi-web-access/CHANGELOG.md +690 -690
- package/agent/extensions/pi-web-access/LICENSE +21 -21
- package/agent/extensions/pi-web-access/README.md +470 -470
- package/agent/extensions/pi-web-access/SECURITY.md +5 -5
- package/agent/extensions/pi-web-access/activity.ts +101 -101
- package/agent/extensions/pi-web-access/auth-fetch.ts +148 -148
- package/agent/extensions/pi-web-access/brightdata-unlocker.ts +272 -272
- package/agent/extensions/pi-web-access/chrome-cookies.ts +669 -669
- package/agent/extensions/pi-web-access/content-find.ts +139 -139
- package/agent/extensions/pi-web-access/credential-source.ts +191 -191
- package/agent/extensions/pi-web-access/data-uri-sanitize.ts +406 -406
- package/agent/extensions/pi-web-access/datalab-pdf-extract.ts +568 -568
- package/agent/extensions/pi-web-access/declared-web-links.ts +173 -173
- package/agent/extensions/pi-web-access/evidence/CONTRACT-EVIDENCE.md +496 -496
- package/agent/extensions/pi-web-access/evidence/contract-probe.mjs +140 -140
- package/agent/extensions/pi-web-access/exa.ts +526 -526
- package/agent/extensions/pi-web-access/extract.ts +1196 -1196
- package/agent/extensions/pi-web-access/feature-config.ts +29 -29
- package/agent/extensions/pi-web-access/fetch-params.ts +111 -111
- package/agent/extensions/pi-web-access/gemini-adc.ts +298 -298
- package/agent/extensions/pi-web-access/gemini-api.ts +353 -353
- package/agent/extensions/pi-web-access/gemini-pdf-extract.ts +108 -108
- package/agent/extensions/pi-web-access/gemini-url-context.ts +128 -128
- package/agent/extensions/pi-web-access/gemini-web-config.ts +101 -101
- package/agent/extensions/pi-web-access/gemini-web.ts +487 -487
- package/agent/extensions/pi-web-access/github-api.ts +197 -197
- package/agent/extensions/pi-web-access/github-extract.ts +746 -746
- package/agent/extensions/pi-web-access/github-issue-pr.ts +700 -700
- package/agent/extensions/pi-web-access/index.ts +1737 -1737
- package/agent/extensions/pi-web-access/package-lock.json +5808 -5808
- package/agent/extensions/pi-web-access/package.json +64 -64
- package/agent/extensions/pi-web-access/page-query.ts +96 -96
- package/agent/extensions/pi-web-access/pdf-extract.ts +409 -409
- package/agent/extensions/pi-web-access/promise-try.d.ts +7 -7
- package/agent/extensions/pi-web-access/query-rewrite.ts +51 -51
- package/agent/extensions/pi-web-access/render-search-error.ts +170 -170
- package/agent/extensions/pi-web-access/rsc-extract.ts +338 -338
- package/agent/extensions/pi-web-access/source-check.ts +282 -282
- package/agent/extensions/pi-web-access/ssrf-protection.ts +526 -526
- package/agent/extensions/pi-web-access/storage.ts +521 -521
- package/agent/extensions/pi-web-access/summary-model-scope.ts +125 -125
- package/agent/extensions/pi-web-access/test/auth-fetch.test.mjs +208 -208
- package/agent/extensions/pi-web-access/test/brightdata-unlocker.test.mjs +840 -840
- package/agent/extensions/pi-web-access/test/chrome-cookie-extraction.test.mjs +441 -441
- package/agent/extensions/pi-web-access/test/config-path.test.mjs +283 -283
- package/agent/extensions/pi-web-access/test/content-find.test.mjs +25 -25
- package/agent/extensions/pi-web-access/test/credential-source.test.mjs +118 -118
- package/agent/extensions/pi-web-access/test/data-uri-sanitize.test.mjs +210 -210
- package/agent/extensions/pi-web-access/test/datalab-pdf-extract.test.mjs +552 -552
- package/agent/extensions/pi-web-access/test/declared-web-links.test.mjs +212 -212
- package/agent/extensions/pi-web-access/test/fetch-answer-storage.test.mjs +40 -40
- package/agent/extensions/pi-web-access/test/fetch-cache-storage.test.mjs +334 -334
- package/agent/extensions/pi-web-access/test/fetch-content-domain-policy.test.mjs +95 -95
- package/agent/extensions/pi-web-access/test/fetch-modes.test.mjs +53 -53
- package/agent/extensions/pi-web-access/test/fetch-not-found-guidance.test.mjs +92 -92
- package/agent/extensions/pi-web-access/test/fetch-params.test.mjs +86 -86
- package/agent/extensions/pi-web-access/test/fetch-render-call.test.mjs +34 -34
- package/agent/extensions/pi-web-access/test/fetch-routing.test.mjs +173 -173
- package/agent/extensions/pi-web-access/test/gemini-adc-auth.test.mjs +257 -257
- package/agent/extensions/pi-web-access/test/gemini-api-transport.test.mjs +170 -170
- package/agent/extensions/pi-web-access/test/gemini-pdf-extract.test.mjs +133 -133
- package/agent/extensions/pi-web-access/test/gemini-web-cookie-opt-in.test.mjs +178 -178
- package/agent/extensions/pi-web-access/test/gemini-web-header-overflow.test.mjs +148 -148
- package/agent/extensions/pi-web-access/test/get-search-content.test.mjs +223 -223
- package/agent/extensions/pi-web-access/test/github-extract.test.mjs +378 -378
- package/agent/extensions/pi-web-access/test/github-issue-pr.test.mjs +565 -565
- package/agent/extensions/pi-web-access/test/inline-content-config.test.mjs +99 -99
- package/agent/extensions/pi-web-access/test/lazy-extract-load.test.mjs +118 -118
- package/agent/extensions/pi-web-access/test/local-video-oversize.test.mjs +52 -52
- package/agent/extensions/pi-web-access/test/package-typebox-dependency.test.mjs +50 -50
- package/agent/extensions/pi-web-access/test/page-query.test.mjs +51 -51
- package/agent/extensions/pi-web-access/test/pdf-config.test.mjs +140 -140
- package/agent/extensions/pi-web-access/test/pdf-extract.test.mjs +500 -500
- package/agent/extensions/pi-web-access/test/proxy-transport.test.mjs +286 -286
- package/agent/extensions/pi-web-access/test/query-rewrite.test.mjs +52 -52
- package/agent/extensions/pi-web-access/test/rsc-fallback.test.mjs +102 -102
- package/agent/extensions/pi-web-access/test/search-error-render.test.mjs +152 -152
- package/agent/extensions/pi-web-access/test/search-providers.test.mjs +274 -274
- package/agent/extensions/pi-web-access/test/source-check.test.mjs +179 -179
- package/agent/extensions/pi-web-access/test/ssrf-allow-ranges-config.test.mjs +205 -205
- package/agent/extensions/pi-web-access/test/ssrf-protection.test.mjs +456 -456
- package/agent/extensions/pi-web-access/test/tool-registration-config.test.mjs +182 -182
- package/agent/extensions/pi-web-access/test/youtube-extract-errors.test.mjs +64 -64
- package/agent/extensions/pi-web-access/tsconfig.json +11 -11
- package/agent/extensions/pi-web-access/utils.ts +451 -451
- package/agent/extensions/pi-web-access/video-extract.ts +392 -392
- package/agent/extensions/pi-web-access/youtube-extract.ts +328 -328
- package/agent/extensions/shared/activity-status.ts +31 -31
- package/agent/extensions/shared/child-session.test.ts +270 -270
- package/agent/extensions/shared/child-session.ts +148 -148
- package/agent/extensions/shared/context-utilization.test.ts +48 -48
- package/agent/extensions/shared/context-utilization.ts +47 -47
- package/agent/extensions/shared/dashboard-state.ts +99 -99
- package/agent/extensions/shared/install.ps1 +4 -0
- package/agent/extensions/shared/install.sh +3 -0
- package/agent/extensions/shared/tool-call-timeout.test.ts +117 -117
- package/agent/extensions/shared/tool-call-timeout.ts +104 -104
- package/agent/extensions/skillsconf/install.ps1 +4 -0
- package/agent/extensions/skillsconf/install.sh +3 -0
- package/agent/extensions/statusline/index.ts +282 -0
- package/agent/extensions/statusline/install.ps1 +27 -0
- package/agent/extensions/statusline/install.sh +24 -0
- package/agent/extensions/subagents/by-the-way.test.ts +29 -29
- package/agent/extensions/subagents/claude.test.ts +119 -119
- package/agent/extensions/subagents/codex.test.ts +102 -102
- package/agent/extensions/subagents/context-usage.test.ts +107 -107
- package/agent/extensions/subagents/docs/design-plan.md +568 -568
- package/agent/extensions/subagents/docs/effect-v4-extension-guide.md +354 -354
- package/agent/extensions/subagents/docs/effect-v4-notes.md +571 -571
- package/agent/extensions/subagents/index.ts +779 -779
- package/agent/extensions/subagents/install.ps1 +4 -0
- package/agent/extensions/subagents/install.sh +3 -0
- package/agent/extensions/subagents/manager.test.ts +276 -276
- package/agent/extensions/subagents/package-lock.json +2244 -2244
- package/agent/extensions/subagents/package.json +19 -19
- package/agent/extensions/subagents/result-delivery.test.ts +27 -27
- package/agent/extensions/subagents/src/backend.ts +73 -73
- package/agent/extensions/subagents/src/backends/claude.ts +701 -701
- package/agent/extensions/subagents/src/backends/codex.ts +1060 -1060
- package/agent/extensions/subagents/src/backends/pi.ts +575 -575
- package/agent/extensions/subagents/src/backends/stub.ts +300 -300
- package/agent/extensions/subagents/src/by-the-way.ts +21 -21
- package/agent/extensions/subagents/src/domain.ts +253 -253
- package/agent/extensions/subagents/src/format.ts +74 -74
- package/agent/extensions/subagents/src/manager.ts +736 -736
- package/agent/extensions/subagents/src/prompt.ts +92 -92
- package/agent/extensions/subagents/src/result-delivery.ts +20 -20
- package/agent/extensions/subagents/src/runtime.ts +53 -53
- package/agent/extensions/subagents/src/ui/takeover.ts +583 -583
- package/agent/extensions/subagents/src/ui/transcript.ts +201 -201
- package/agent/extensions/subagents/takeover.test.ts +29 -29
- package/agent/extensions/subagents/tsconfig.json +7 -7
- package/agent/extensions/taste/install.ps1 +4 -0
- package/agent/extensions/taste/install.sh +3 -0
- package/agent/extensions/todo/AGENTS.md +38 -38
- package/agent/extensions/todo/LICENSE +21 -21
- package/agent/extensions/todo/config.ts +55 -55
- package/agent/extensions/todo/index.ts +151 -151
- package/agent/extensions/todo/install.ps1 +4 -0
- package/agent/extensions/todo/install.sh +3 -0
- package/agent/extensions/todo/locales/de.json +17 -17
- package/agent/extensions/todo/locales/en.json +15 -15
- package/agent/extensions/todo/locales/es.json +17 -17
- package/agent/extensions/todo/locales/fr.json +17 -17
- package/agent/extensions/todo/locales/pt-BR.json +17 -17
- package/agent/extensions/todo/locales/pt.json +17 -17
- package/agent/extensions/todo/locales/ru.json +17 -17
- package/agent/extensions/todo/locales/uk.json +17 -17
- package/agent/extensions/todo/locales/zh.json +17 -17
- package/agent/extensions/todo/package-lock.json +3358 -3358
- package/agent/extensions/todo/package.json +67 -67
- package/agent/extensions/todo/state/i18n-bridge.ts +64 -64
- package/agent/extensions/todo/state/invariants.ts +20 -20
- package/agent/extensions/todo/state/replay.ts +38 -38
- package/agent/extensions/todo/state/selectors.ts +107 -107
- package/agent/extensions/todo/state/state-reducer.ts +326 -326
- package/agent/extensions/todo/state/state.ts +18 -18
- package/agent/extensions/todo/state/store.ts +82 -82
- package/agent/extensions/todo/state/task-graph.ts +57 -57
- package/agent/extensions/todo/todo-overlay.ts +200 -200
- package/agent/extensions/todo/todo.ts +155 -155
- package/agent/extensions/todo/tool/response-envelope.ts +109 -109
- package/agent/extensions/todo/tool/types.ts +206 -206
- package/agent/extensions/todo/view/format.ts +177 -177
- package/agent/extensions/trim-context/install.ps1 +4 -0
- package/agent/extensions/trim-context/install.sh +3 -0
- package/agent/keybindings.json +7 -7
- package/agent/version.txt +1 -0
- package/agent.bak.20260905-190020/AGENTS.md +67 -0
- package/agent.bak.20260905-190020/README.md +5 -0
- package/agent.bak.20260905-190020/extensions/ask-user/index.ts +418 -0
- package/agent.bak.20260905-190020/extensions/ask-user/package-lock.json +769 -0
- package/agent.bak.20260905-190020/extensions/ask-user/package.json +19 -0
- package/agent.bak.20260905-190020/extensions/ask-user/prompt.ts +45 -0
- package/agent.bak.20260905-190020/extensions/ask-user/tsconfig.json +7 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/docs/implementation-guide.md +942 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/index.ts +629 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/install.ps1 +23 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/install.sh +21 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/package-lock.json +769 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/package.json +17 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/src/domain.ts +87 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/src/manager.ts +907 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/src/output.ts +84 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/src/prompt.ts +142 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/src/result-delivery.ts +27 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/src/runtime.ts +36 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/src/ui/output-view.ts +79 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/src/ui/ps.ts +621 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/src/widget-order.ts +121 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/test/manager.test.ts +735 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/test/output.test.ts +109 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/test/prompt.test.ts +125 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/test/ps.test.ts +82 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/test/result-delivery.test.ts +44 -0
- package/agent.bak.20260905-190020/extensions/background-terminals/tsconfig.json +7 -0
- package/agent.bak.20260905-190020/extensions/destructive/README.md +34 -0
- package/agent.bak.20260905-190020/extensions/destructive/index.ts +124 -0
- package/agent.bak.20260905-190020/extensions/destructive/install.ps1 +23 -0
- package/agent.bak.20260905-190020/extensions/destructive/install.sh +21 -0
- package/agent.bak.20260905-190020/extensions/file-search/index.ts +459 -0
- package/agent.bak.20260905-190020/extensions/file-search/install.ps1 +23 -0
- package/agent.bak.20260905-190020/extensions/file-search/install.sh +21 -0
- package/agent.bak.20260905-190020/extensions/file-search/package-lock.json +2253 -0
- package/agent.bak.20260905-190020/extensions/file-search/package.json +23 -0
- package/agent.bak.20260905-190020/extensions/file-search/src/args.ts +122 -0
- package/agent.bak.20260905-190020/extensions/file-search/src/binaries.ts +422 -0
- package/agent.bak.20260905-190020/extensions/file-search/src/output.ts +126 -0
- package/agent.bak.20260905-190020/extensions/file-search/src/process.ts +146 -0
- package/agent.bak.20260905-190020/extensions/file-search/src/prompt.ts +52 -0
- package/agent.bak.20260905-190020/extensions/file-search/test/index.spec.ts +443 -0
- package/agent.bak.20260905-190020/extensions/file-search/tsconfig.json +7 -0
- package/agent.bak.20260905-190020/extensions/goal/README.md +50 -0
- package/agent.bak.20260905-190020/extensions/goal/index.ts +155 -0
- package/agent.bak.20260905-190020/extensions/goal/install.ps1 +23 -0
- package/agent.bak.20260905-190020/extensions/goal/install.sh +21 -0
- package/agent.bak.20260905-190020/extensions/kiln-update/README.md +25 -0
- package/agent.bak.20260905-190020/extensions/kiln-update/index.ts +99 -0
- package/agent.bak.20260905-190020/extensions/kiln-update/install.ps1 +23 -0
- package/agent.bak.20260905-190020/extensions/kiln-update/install.sh +21 -0
- package/agent.bak.20260905-190020/extensions/modelconf/PLAN.md +915 -0
- package/agent.bak.20260905-190020/extensions/modelconf/README.md +66 -0
- package/agent.bak.20260905-190020/extensions/modelconf/index.ts +296 -0
- package/agent.bak.20260905-190020/extensions/modelconf/install.ps1 +23 -0
- package/agent.bak.20260905-190020/extensions/modelconf/install.sh +21 -0
- package/agent.bak.20260905-190020/extensions/modelconf/package-lock.json +1809 -0
- package/agent.bak.20260905-190020/extensions/modelconf/package.json +13 -0
- package/agent.bak.20260905-190020/extensions/modelconf/src/fuzzy.ts +26 -0
- package/agent.bak.20260905-190020/extensions/modelconf/src/glob.ts +13 -0
- package/agent.bak.20260905-190020/extensions/modelconf/src/persistence.test.ts +46 -0
- package/agent.bak.20260905-190020/extensions/modelconf/src/persistence.ts +164 -0
- package/agent.bak.20260905-190020/extensions/modelconf/src/ui/ModelConfView.test.ts +75 -0
- package/agent.bak.20260905-190020/extensions/modelconf/src/ui/ModelConfView.ts +1101 -0
- package/agent.bak.20260905-190020/extensions/modelconf/tsconfig.json +15 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/CHANGELOG.md +690 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/LICENSE +21 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/README.md +470 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/SECURITY.md +5 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/activity.ts +101 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/auth-fetch.ts +148 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/banner.png +0 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/brightdata-unlocker.ts +272 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/chrome-cookies.ts +669 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/content-find.ts +139 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/credential-source.ts +191 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/data-uri-sanitize.ts +406 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/datalab-pdf-extract.ts +568 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/declared-web-links.ts +173 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/evidence/CONTRACT-EVIDENCE.md +496 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/evidence/contract-probe.mjs +140 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/exa.ts +526 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/extract.ts +1196 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/feature-config.ts +29 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/fetch-params.ts +111 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-adc.ts +298 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-api.ts +353 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-pdf-extract.ts +108 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-search.ts +21 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-url-context.ts +128 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-web-config.ts +101 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-web.ts +487 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/github-api.ts +197 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/github-extract.ts +746 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/github-issue-pr.ts +700 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/index.ts +1737 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/package-lock.json +5808 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/package.json +64 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/page-query.ts +96 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/pdf-extract.ts +409 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/pi-web-fetch-demo.mp4 +0 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/promise-try.d.ts +7 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/query-rewrite.ts +51 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/render-search-error.ts +170 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/rsc-extract.ts +338 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/search-types.ts +20 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/source-check.ts +282 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/ssrf-protection.ts +526 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/storage.ts +521 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/summary-model-scope.ts +125 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/auth-fetch.test.mjs +208 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/brightdata-unlocker.test.mjs +840 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/chrome-cookie-extraction.test.mjs +441 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/config-path.test.mjs +283 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/content-find.test.mjs +25 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/credential-source.test.mjs +118 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/data-uri-sanitize.test.mjs +210 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/datalab-pdf-extract.test.mjs +552 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/declared-web-links.test.mjs +212 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-answer-storage.test.mjs +40 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-cache-storage.test.mjs +334 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-content-domain-policy.test.mjs +95 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-modes.test.mjs +53 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-not-found-guidance.test.mjs +92 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-params.test.mjs +86 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-render-call.test.mjs +34 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-routing.test.mjs +173 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/gemini-adc-auth.test.mjs +257 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/gemini-api-transport.test.mjs +170 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/gemini-pdf-extract.test.mjs +133 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/gemini-web-cookie-opt-in.test.mjs +178 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/gemini-web-header-overflow.test.mjs +148 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/get-search-content.test.mjs +223 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/github-extract.test.mjs +378 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/github-issue-pr.test.mjs +565 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/inline-content-config.test.mjs +99 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/lazy-extract-load.test.mjs +118 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/local-video-oversize.test.mjs +52 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/package-typebox-dependency.test.mjs +50 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/page-query.test.mjs +51 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/pdf-config.test.mjs +140 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/pdf-extract.test.mjs +500 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/proxy-transport.test.mjs +286 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/query-rewrite.test.mjs +52 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/rsc-fallback.test.mjs +102 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/search-error-render.test.mjs +152 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/search-providers.test.mjs +274 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/source-check.test.mjs +179 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/ssrf-allow-ranges-config.test.mjs +205 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/ssrf-protection.test.mjs +456 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/summary-model-scope.test.mjs +106 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/tool-registration-config.test.mjs +182 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/web-search-answer-render.test.mjs +66 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/test/youtube-extract-errors.test.mjs +64 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/tsconfig.json +11 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/utils.ts +451 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/video-extract.ts +392 -0
- package/agent.bak.20260905-190020/extensions/pi-web-access/youtube-extract.ts +328 -0
- package/agent.bak.20260905-190020/extensions/shared/activity-status.ts +31 -0
- package/agent.bak.20260905-190020/extensions/shared/child-session.ts +148 -0
- package/agent.bak.20260905-190020/extensions/shared/context-utilization.ts +47 -0
- package/agent.bak.20260905-190020/extensions/shared/dashboard-state.ts +99 -0
- package/agent.bak.20260905-190020/extensions/shared/install.ps1 +23 -0
- package/agent.bak.20260905-190020/extensions/shared/install.sh +21 -0
- package/agent.bak.20260905-190020/extensions/shared/test/child-session.test.ts +270 -0
- package/agent.bak.20260905-190020/extensions/shared/test/context-utilization.test.ts +48 -0
- package/agent.bak.20260905-190020/extensions/shared/test/tool-call-timeout.test.ts +117 -0
- package/agent.bak.20260905-190020/extensions/shared/test/widget-order.test.ts +167 -0
- package/agent.bak.20260905-190020/extensions/shared/tool-call-timeout.ts +104 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/README.md +74 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/index.ts +92 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/install.ps1 +23 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/install.sh +21 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/package-lock.json +1809 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/package.json +18 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/src/delete-skill.test.ts +64 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/src/delete-skill.ts +45 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/src/filter.test.ts +80 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/src/filter.ts +74 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/src/fuzzy.ts +26 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/src/persistence.test.ts +72 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/src/persistence.ts +169 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/src/ui/SkillConfView.test.ts +337 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/src/ui/SkillConfView.ts +758 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/src/ui/text-input.ts +91 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/src/ui/tui-helpers.ts +144 -0
- package/agent.bak.20260905-190020/extensions/skillsconf/tsconfig.json +15 -0
- package/agent.bak.20260905-190020/extensions/statusline/install.ps1 +23 -0
- package/agent.bak.20260905-190020/extensions/statusline/install.sh +21 -0
- package/agent.bak.20260905-190020/extensions/subagents/docs/design-plan.md +568 -0
- package/agent.bak.20260905-190020/extensions/subagents/docs/effect-v4-extension-guide.md +354 -0
- package/agent.bak.20260905-190020/extensions/subagents/docs/effect-v4-notes.md +571 -0
- package/agent.bak.20260905-190020/extensions/subagents/index.ts +826 -0
- package/agent.bak.20260905-190020/extensions/subagents/install.ps1 +23 -0
- package/agent.bak.20260905-190020/extensions/subagents/install.sh +21 -0
- package/agent.bak.20260905-190020/extensions/subagents/package-lock.json +2244 -0
- package/agent.bak.20260905-190020/extensions/subagents/package.json +19 -0
- package/agent.bak.20260905-190020/extensions/subagents/src/backend.ts +73 -0
- package/agent.bak.20260905-190020/extensions/subagents/src/backends/claude.ts +701 -0
- package/agent.bak.20260905-190020/extensions/subagents/src/backends/codex.ts +1060 -0
- package/agent.bak.20260905-190020/extensions/subagents/src/backends/pi.ts +575 -0
- package/agent.bak.20260905-190020/extensions/subagents/src/backends/stub.ts +300 -0
- package/agent.bak.20260905-190020/extensions/subagents/src/by-the-way.ts +21 -0
- package/agent.bak.20260905-190020/extensions/subagents/src/domain.ts +253 -0
- package/agent.bak.20260905-190020/extensions/subagents/src/format.ts +74 -0
- package/agent.bak.20260905-190020/extensions/subagents/src/manager.ts +736 -0
- package/agent.bak.20260905-190020/extensions/subagents/src/prompt.ts +92 -0
- package/agent.bak.20260905-190020/extensions/subagents/src/result-delivery.ts +20 -0
- package/agent.bak.20260905-190020/extensions/subagents/src/runtime.ts +53 -0
- package/agent.bak.20260905-190020/extensions/subagents/src/ui/takeover.ts +583 -0
- package/agent.bak.20260905-190020/extensions/subagents/src/ui/transcript.ts +201 -0
- package/agent.bak.20260905-190020/extensions/subagents/src/widget-order.ts +121 -0
- package/agent.bak.20260905-190020/extensions/subagents/test/by-the-way.test.ts +29 -0
- package/agent.bak.20260905-190020/extensions/subagents/test/claude.test.ts +119 -0
- package/agent.bak.20260905-190020/extensions/subagents/test/codex.test.ts +102 -0
- package/agent.bak.20260905-190020/extensions/subagents/test/context-usage.test.ts +107 -0
- package/agent.bak.20260905-190020/extensions/subagents/test/manager.test.ts +276 -0
- package/agent.bak.20260905-190020/extensions/subagents/test/result-delivery.test.ts +27 -0
- package/agent.bak.20260905-190020/extensions/subagents/test/takeover.test.ts +29 -0
- package/agent.bak.20260905-190020/extensions/subagents/tsconfig.json +7 -0
- package/agent.bak.20260905-190020/extensions/taste/index.ts +443 -0
- package/agent.bak.20260905-190020/extensions/taste/install.ps1 +23 -0
- package/agent.bak.20260905-190020/extensions/taste/install.sh +21 -0
- package/agent.bak.20260905-190020/extensions/todo/AGENTS.md +38 -0
- package/agent.bak.20260905-190020/extensions/todo/LICENSE +21 -0
- package/agent.bak.20260905-190020/extensions/todo/config.ts +55 -0
- package/agent.bak.20260905-190020/extensions/todo/index.ts +151 -0
- package/agent.bak.20260905-190020/extensions/todo/install.ps1 +23 -0
- package/agent.bak.20260905-190020/extensions/todo/install.sh +21 -0
- package/agent.bak.20260905-190020/extensions/todo/locales/de.json +17 -0
- package/agent.bak.20260905-190020/extensions/todo/locales/en.json +15 -0
- package/agent.bak.20260905-190020/extensions/todo/locales/es.json +17 -0
- package/agent.bak.20260905-190020/extensions/todo/locales/fr.json +17 -0
- package/agent.bak.20260905-190020/extensions/todo/locales/pt-BR.json +17 -0
- package/agent.bak.20260905-190020/extensions/todo/locales/pt.json +17 -0
- package/agent.bak.20260905-190020/extensions/todo/locales/ru.json +17 -0
- package/agent.bak.20260905-190020/extensions/todo/locales/uk.json +17 -0
- package/agent.bak.20260905-190020/extensions/todo/locales/zh.json +17 -0
- package/agent.bak.20260905-190020/extensions/todo/package-lock.json +3358 -0
- package/agent.bak.20260905-190020/extensions/todo/package.json +67 -0
- package/agent.bak.20260905-190020/extensions/todo/state/i18n-bridge.ts +64 -0
- package/agent.bak.20260905-190020/extensions/todo/state/invariants.ts +20 -0
- package/agent.bak.20260905-190020/extensions/todo/state/replay.ts +38 -0
- package/agent.bak.20260905-190020/extensions/todo/state/selectors.ts +107 -0
- package/agent.bak.20260905-190020/extensions/todo/state/state-reducer.ts +326 -0
- package/agent.bak.20260905-190020/extensions/todo/state/state.ts +18 -0
- package/agent.bak.20260905-190020/extensions/todo/state/store.ts +82 -0
- package/agent.bak.20260905-190020/extensions/todo/state/task-graph.ts +57 -0
- package/agent.bak.20260905-190020/extensions/todo/todo-overlay.ts +204 -0
- package/agent.bak.20260905-190020/extensions/todo/todo.ts +155 -0
- package/agent.bak.20260905-190020/extensions/todo/tool/response-envelope.ts +109 -0
- package/agent.bak.20260905-190020/extensions/todo/tool/types.ts +206 -0
- package/agent.bak.20260905-190020/extensions/todo/view/format.ts +177 -0
- package/agent.bak.20260905-190020/extensions/todo/widget-order.ts +121 -0
- package/agent.bak.20260905-190020/extensions/trim-context/README.md +54 -0
- package/agent.bak.20260905-190020/extensions/trim-context/index.ts +487 -0
- package/agent.bak.20260905-190020/extensions/trim-context/install.ps1 +23 -0
- package/agent.bak.20260905-190020/extensions/trim-context/install.sh +21 -0
- package/agent.bak.20260905-190020/keybindings.json +7 -0
- package/bin/kiln.js +588 -358
- package/package.json +27 -21
- package/agent/install.ps1 +0 -527
- package/agent/install.sh +0 -511
- /package/{agent/extensions/status line → agent.bak.20260905-190020/extensions/ask-user}/install.ps1 +0 -0
- /package/{agent/extensions/status line → agent.bak.20260905-190020/extensions/ask-user}/install.sh +0 -0
- /package/{agent/extensions/status line → agent.bak.20260905-190020/extensions/statusline}/index.ts +0 -0
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
// Regenerates evidence/CONTRACT-EVIDENCE.md from REAL calls against the
|
|
2
|
+
// SERPdive API. Run it with your own key to reproduce the file:
|
|
3
|
+
//
|
|
4
|
+
// SERPDIVE_API_KEY=sd_live_… node evidence/contract-probe.mjs
|
|
5
|
+
//
|
|
6
|
+
// The key is read from the environment and never written to the output —
|
|
7
|
+
// the script asserts that before exiting.
|
|
8
|
+
import fs from 'node:fs';
|
|
9
|
+
|
|
10
|
+
const KEY = process.env.SERPDIVE_API_KEY;
|
|
11
|
+
if (!KEY) {
|
|
12
|
+
console.error('SERPDIVE_API_KEY is not set. Get a key at https://serpdive.com/dashboard/keys');
|
|
13
|
+
process.exit(1);
|
|
14
|
+
}
|
|
15
|
+
const URL = 'https://api.serpdive.com/v1/search';
|
|
16
|
+
const out = [];
|
|
17
|
+
const say = (s = '') => out.push(s);
|
|
18
|
+
|
|
19
|
+
async function call(body, { key = KEY, abortAfterMs = null } = {}) {
|
|
20
|
+
const ctrl = new AbortController();
|
|
21
|
+
if (abortAfterMs) setTimeout(() => ctrl.abort(), abortAfterMs);
|
|
22
|
+
const t0 = Date.now();
|
|
23
|
+
try {
|
|
24
|
+
const res = await fetch(URL, {
|
|
25
|
+
method: 'POST',
|
|
26
|
+
headers: { 'content-type': 'application/json', ...(key ? { authorization: `Bearer ${key}` } : {}) },
|
|
27
|
+
body: JSON.stringify(body),
|
|
28
|
+
signal: ctrl.signal,
|
|
29
|
+
});
|
|
30
|
+
const json = await res.json().catch(() => null);
|
|
31
|
+
return { status: res.status, ms: Date.now() - t0, json };
|
|
32
|
+
} catch (err) {
|
|
33
|
+
return { status: null, ms: Date.now() - t0, aborted: err.name === 'AbortError', err: err.name };
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
// Reduce a response to its SHAPE: keep the structure, truncate the content.
|
|
38
|
+
function shape(j) {
|
|
39
|
+
if (!j) return null;
|
|
40
|
+
const c = JSON.parse(JSON.stringify(j));
|
|
41
|
+
if (Array.isArray(c.results)) {
|
|
42
|
+
c.results = c.results.slice(0, 2).map((r) => ({
|
|
43
|
+
...r,
|
|
44
|
+
content: typeof r.content === 'string' ? `${r.content.slice(0, 90)}… (${r.content.length} chars)` : r.content,
|
|
45
|
+
}));
|
|
46
|
+
if (j.results.length > 2) c.results.push(`… ${j.results.length - 2} more, same shape`);
|
|
47
|
+
}
|
|
48
|
+
if (typeof c.answer === 'string') c.answer = `${c.answer.slice(0, 160)}… (${j.answer.length} chars)`;
|
|
49
|
+
return c;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
async function section(title, note, body, opts = {}) {
|
|
53
|
+
const r = await call(body, opts);
|
|
54
|
+
const keyLine = !('key' in opts)
|
|
55
|
+
? 'authorization: Bearer sd_live_… # a valid key, redacted'
|
|
56
|
+
: opts.key === null
|
|
57
|
+
? '(no authorization header sent)'
|
|
58
|
+
: `authorization: Bearer ${opts.key}`;
|
|
59
|
+
say(`### ${title}`);
|
|
60
|
+
say();
|
|
61
|
+
if (note) { say(note); say(); }
|
|
62
|
+
say('```http');
|
|
63
|
+
say('POST https://api.serpdive.com/v1/search');
|
|
64
|
+
say(keyLine);
|
|
65
|
+
say('content-type: application/json');
|
|
66
|
+
say();
|
|
67
|
+
say(JSON.stringify(body));
|
|
68
|
+
say('```');
|
|
69
|
+
say();
|
|
70
|
+
if (r.aborted) {
|
|
71
|
+
say(`Client aborted after ${opts.abortAfterMs} ms → \`${r.err}\` raised locally; no response body.`);
|
|
72
|
+
} else {
|
|
73
|
+
say(`\`HTTP ${r.status}\` in ${r.ms} ms`);
|
|
74
|
+
say();
|
|
75
|
+
say('```json');
|
|
76
|
+
say(JSON.stringify(shape(r.json), null, 2));
|
|
77
|
+
say('```');
|
|
78
|
+
}
|
|
79
|
+
say();
|
|
80
|
+
return r;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
const Q = 'best open source vector databases';
|
|
84
|
+
|
|
85
|
+
say('# SERPdive API — contract evidence');
|
|
86
|
+
say();
|
|
87
|
+
say('Every block below is a real call against `https://api.serpdive.com/v1/search`, captured on '
|
|
88
|
+
+ new Date().toISOString().slice(0, 10) + '. Reproduce any of them with your own key: the script that');
|
|
89
|
+
say('generated this file is `evidence/contract-probe.mjs`. Page content is truncated to keep the file');
|
|
90
|
+
say('readable — nothing else is edited, and the API key is redacted.');
|
|
91
|
+
say();
|
|
92
|
+
say('---');
|
|
93
|
+
say();
|
|
94
|
+
say('## 1. Default request and response shape');
|
|
95
|
+
say();
|
|
96
|
+
await section('Query only', 'The whole request surface is `query`, `model`, `answer`, `max_results`. Everything else is ignored.', { query: Q });
|
|
97
|
+
|
|
98
|
+
say('## 2. Models');
|
|
99
|
+
say();
|
|
100
|
+
await section('krill — free tier', 'No answer synthesis on this tier: requesting one is ignored rather than refused (see §3).', { query: Q, model: 'krill' });
|
|
101
|
+
await section('mako — 1 credit', null, { query: Q, model: 'mako' });
|
|
102
|
+
await section('moby — 1.5 credits', 'Full readable page content; note the content lengths against mako above.', { query: Q, model: 'moby' });
|
|
103
|
+
|
|
104
|
+
say('## 3. `answer`');
|
|
105
|
+
say();
|
|
106
|
+
await section('answer: true with mako', 'The `answer` key is present only when requested.', { query: Q, model: 'mako', answer: true });
|
|
107
|
+
await section('answer: true with krill', 'Silently ignored on the free tier — no `answer` key, no error, still a complete result.', { query: Q, model: 'krill', answer: true });
|
|
108
|
+
|
|
109
|
+
say('## 4. `max_results` is a cap, never a minimum');
|
|
110
|
+
say();
|
|
111
|
+
say('A cap, applied at the edge after the search. The engine still reads a full corpus, so a small');
|
|
112
|
+
say('cap trims the response, not the work — and asking for more does not produce more.');
|
|
113
|
+
say();
|
|
114
|
+
for (const [n, note] of [
|
|
115
|
+
[1, null],
|
|
116
|
+
[3, null],
|
|
117
|
+
[10, 'The ceiling of the range. Fewer come back when fewer are judged relevant — see §1, where no cap returned 5.'],
|
|
118
|
+
[50, 'Above the range: clamped down to 10, silently. Never a 400.'],
|
|
119
|
+
[0, 'Below the range: clamped UP to 1, silently — it is the minimum of the range, NOT a way to say "no cap". One result comes back.'],
|
|
120
|
+
['abc', 'Unparseable, and this is the asymmetry worth knowing: an out-of-range NUMBER is clamped into the range, but a value that is not a number at all drops the cap entirely and the default applies. Same for null or an absent field.'],
|
|
121
|
+
]) {
|
|
122
|
+
await section(`max_results: ${JSON.stringify(n)}`, note, { query: Q, model: 'krill', max_results: n });
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
say('## 5. Errors');
|
|
126
|
+
say();
|
|
127
|
+
await section('Missing query', null, { model: 'krill' });
|
|
128
|
+
await section('Invalid key', null, { query: Q }, { key: 'sd_live_not_a_real_key' });
|
|
129
|
+
await section('No key at all', null, { query: Q }, { key: null });
|
|
130
|
+
|
|
131
|
+
say('## 6. Abort');
|
|
132
|
+
say();
|
|
133
|
+
await section('Client aborts mid-flight', 'The request is cancellable at any point; the provider maps this to the framework abort path.', { query: Q, model: 'krill' }, { abortAfterMs: 300 });
|
|
134
|
+
|
|
135
|
+
const path = new URL('./CONTRACT-EVIDENCE.md', import.meta.url).pathname;
|
|
136
|
+
fs.writeFileSync(path, out.join('\n'));
|
|
137
|
+
console.log(`written: ${path}`);
|
|
138
|
+
console.log(`${out.join('\n').length} characters`);
|
|
139
|
+
if (out.join('\n').includes(KEY)) console.error('!! THE API KEY APPEARS IN THE OUTPUT — not written');
|
|
140
|
+
else console.log('verified: the key appears nowhere in the output');
|
|
@@ -0,0 +1,526 @@
|
|
|
1
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
2
|
+
import { activityMonitor } from "./activity.ts";
|
|
3
|
+
import type { ExtractedContent } from "./extract.ts";
|
|
4
|
+
import type { SearchOptions, SearchResponse } from "./search-types.ts";
|
|
5
|
+
import { hasCredentialSource, redactCredential, resolveCredential } from "./credential-source.ts";
|
|
6
|
+
import { fetchWithCredentialRedirects, getWebSearchConfigPath, resolveApiBaseUrl } from "./utils.ts";
|
|
7
|
+
|
|
8
|
+
const EXA_API_BASE_URL = "https://api.exa.ai";
|
|
9
|
+
const EXA_MCP_URL = "https://mcp.exa.ai/mcp";
|
|
10
|
+
const CONFIG_PATH = getWebSearchConfigPath();
|
|
11
|
+
const EXA_MCP_ADVANCED_TOOL = "web_search_advanced_exa";
|
|
12
|
+
const EXA_MCP_BASIC_TOOL = "web_search_exa";
|
|
13
|
+
|
|
14
|
+
interface WebSearchConfig {
|
|
15
|
+
exaApiKey?: unknown;
|
|
16
|
+
exaBaseUrl?: unknown;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
interface ExaAnswerResponse {
|
|
20
|
+
answer?: string;
|
|
21
|
+
citations?: Array<{ url?: string; title?: string; text?: string; publishedDate?: string }>;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
interface ExaSearchResponse {
|
|
25
|
+
results?: Array<{
|
|
26
|
+
title?: string;
|
|
27
|
+
url?: string;
|
|
28
|
+
publishedDate?: string;
|
|
29
|
+
author?: string;
|
|
30
|
+
text?: string;
|
|
31
|
+
highlights?: unknown;
|
|
32
|
+
highlightScores?: number[];
|
|
33
|
+
}>;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
interface ExaMcpRpcResponse {
|
|
37
|
+
result?: {
|
|
38
|
+
content?: Array<{ type?: string; text?: string }>;
|
|
39
|
+
isError?: boolean;
|
|
40
|
+
};
|
|
41
|
+
error?: {
|
|
42
|
+
code?: number;
|
|
43
|
+
message?: string;
|
|
44
|
+
};
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
export type ExaSearchResult = SearchResponse | null;
|
|
48
|
+
|
|
49
|
+
export interface ExaSearchOptions extends SearchOptions {
|
|
50
|
+
includeContent?: boolean;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
type McpParsedResult = { title: string; url: string; content: string };
|
|
54
|
+
|
|
55
|
+
let cachedConfig: WebSearchConfig | null = null;
|
|
56
|
+
|
|
57
|
+
function loadConfig(): WebSearchConfig {
|
|
58
|
+
if (cachedConfig) return cachedConfig;
|
|
59
|
+
if (!existsSync(CONFIG_PATH)) {
|
|
60
|
+
cachedConfig = {};
|
|
61
|
+
return cachedConfig;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
const raw = readFileSync(CONFIG_PATH, "utf-8");
|
|
65
|
+
try {
|
|
66
|
+
cachedConfig = JSON.parse(raw) as WebSearchConfig;
|
|
67
|
+
return cachedConfig;
|
|
68
|
+
} catch (err) {
|
|
69
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
70
|
+
throw new Error(`Failed to parse ${CONFIG_PATH}: ${message}`);
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
async function getApiKey(signal?: AbortSignal): Promise<string | null> {
|
|
75
|
+
return resolveCredential({
|
|
76
|
+
provider: "Exa",
|
|
77
|
+
configuredValue: loadConfig().exaApiKey,
|
|
78
|
+
environmentValue: process.env.EXA_API_KEY,
|
|
79
|
+
signal,
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
function getApiBaseUrl(): string {
|
|
84
|
+
return resolveApiBaseUrl({
|
|
85
|
+
configKey: "exaBaseUrl",
|
|
86
|
+
configuredValue: loadConfig().exaBaseUrl,
|
|
87
|
+
defaultValue: EXA_API_BASE_URL,
|
|
88
|
+
environmentKey: "EXA_BASE_URL",
|
|
89
|
+
environmentValue: process.env.EXA_BASE_URL,
|
|
90
|
+
});
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
function exaApiHeaders(apiKey: string): Record<string, string> {
|
|
94
|
+
return {
|
|
95
|
+
"x-api-key": apiKey,
|
|
96
|
+
"Content-Type": "application/json",
|
|
97
|
+
"x-exa-integration": "pi-web-access",
|
|
98
|
+
};
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
function requestSignal(signal?: AbortSignal): AbortSignal {
|
|
102
|
+
const timeout = AbortSignal.timeout(60000);
|
|
103
|
+
return signal ? AbortSignal.any([signal, timeout]) : timeout;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
function recencyToStartDate(filter: string): string {
|
|
107
|
+
const now = new Date();
|
|
108
|
+
const offsets: Record<string, number> = {
|
|
109
|
+
day: 1,
|
|
110
|
+
week: 7,
|
|
111
|
+
month: 30,
|
|
112
|
+
year: 365,
|
|
113
|
+
};
|
|
114
|
+
const days = offsets[filter] ?? 0;
|
|
115
|
+
return new Date(now.getTime() - days * 86400000).toISOString();
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
function mapDomainFilter(domainFilter: string[] | undefined): { includeDomains?: string[]; excludeDomains?: string[] } {
|
|
119
|
+
if (!domainFilter?.length) return {};
|
|
120
|
+
const includeDomains = domainFilter
|
|
121
|
+
.filter(d => !d.startsWith("-") && d.trim().length > 0)
|
|
122
|
+
.map(d => d.trim());
|
|
123
|
+
const excludeDomains = domainFilter
|
|
124
|
+
.filter(d => d.startsWith("-"))
|
|
125
|
+
.map(d => d.slice(1).trim())
|
|
126
|
+
.filter(Boolean);
|
|
127
|
+
return {
|
|
128
|
+
...(includeDomains.length ? { includeDomains } : {}),
|
|
129
|
+
...(excludeDomains.length ? { excludeDomains } : {}),
|
|
130
|
+
};
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
function exaSearchArgs(query: string, options: ExaSearchOptions): Record<string, unknown> {
|
|
134
|
+
const startDate = options.recencyFilter ? recencyToStartDate(options.recencyFilter) : null;
|
|
135
|
+
return {
|
|
136
|
+
query,
|
|
137
|
+
type: "auto",
|
|
138
|
+
numResults: options.numResults ?? 5,
|
|
139
|
+
...mapDomainFilter(options.domainFilter),
|
|
140
|
+
...(startDate ? { startPublishedDate: startDate } : {}),
|
|
141
|
+
};
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
function normalizeHighlights(value: unknown): string[] {
|
|
145
|
+
if (!Array.isArray(value)) return [];
|
|
146
|
+
return value.filter((item): item is string => typeof item === "string" && item.trim().length > 0);
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
function buildAnswerFromSearchResults(results: ExaSearchResponse["results"]): string {
|
|
150
|
+
if (!results?.length) return "";
|
|
151
|
+
const parts: string[] = [];
|
|
152
|
+
for (let i = 0; i < results.length; i++) {
|
|
153
|
+
const item = results[i];
|
|
154
|
+
if (!item?.url) continue;
|
|
155
|
+
const highlights = normalizeHighlights(item.highlights);
|
|
156
|
+
const content = highlights.length > 0
|
|
157
|
+
? highlights.join(" ")
|
|
158
|
+
: typeof item.text === "string" ? item.text.trim().slice(0, 1000) : "";
|
|
159
|
+
if (!content) continue;
|
|
160
|
+
const sourceTitle = item.title || `Source ${i + 1}`;
|
|
161
|
+
parts.push(`${content}\nSource: ${sourceTitle} (${item.url})`);
|
|
162
|
+
}
|
|
163
|
+
return parts.join("\n\n");
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
function mapResults(results: ExaSearchResponse["results"] | ExaAnswerResponse["citations"]): SearchResponse["results"] {
|
|
167
|
+
if (!Array.isArray(results)) return [];
|
|
168
|
+
const mapped: SearchResponse["results"] = [];
|
|
169
|
+
for (let i = 0; i < results.length; i++) {
|
|
170
|
+
const item = results[i];
|
|
171
|
+
if (!item?.url) continue;
|
|
172
|
+
mapped.push({
|
|
173
|
+
title: item.title || `Source ${i + 1}`,
|
|
174
|
+
url: item.url,
|
|
175
|
+
snippet: "",
|
|
176
|
+
});
|
|
177
|
+
}
|
|
178
|
+
return mapped;
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
function mapInlineContent(results: ExaSearchResponse["results"]): ExtractedContent[] {
|
|
182
|
+
if (!results?.length) return [];
|
|
183
|
+
return results
|
|
184
|
+
.filter((r): r is NonNullable<ExaSearchResponse["results"]>[number] & { url: string; text: string } =>
|
|
185
|
+
!!r?.url && typeof r.text === "string" && r.text.length > 0)
|
|
186
|
+
.map(r => ({
|
|
187
|
+
url: r.url,
|
|
188
|
+
title: r.title || "",
|
|
189
|
+
content: r.text,
|
|
190
|
+
error: null,
|
|
191
|
+
}));
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
function toSearchResponse(
|
|
195
|
+
answer: string,
|
|
196
|
+
results: SearchResponse["results"],
|
|
197
|
+
inlineContent: ExtractedContent[] | null,
|
|
198
|
+
): SearchResponse {
|
|
199
|
+
const response: SearchResponse = { answer, results };
|
|
200
|
+
if (inlineContent?.length) response.inlineContent = inlineContent;
|
|
201
|
+
return response;
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
export async function callExaMcp(
|
|
205
|
+
toolName: string,
|
|
206
|
+
args: Record<string, unknown>,
|
|
207
|
+
signal?: AbortSignal,
|
|
208
|
+
): Promise<string> {
|
|
209
|
+
const response = await fetch(`${EXA_MCP_URL}?tools=${toolName}`, {
|
|
210
|
+
method: "POST",
|
|
211
|
+
headers: {
|
|
212
|
+
"Content-Type": "application/json",
|
|
213
|
+
"Accept": "application/json, text/event-stream",
|
|
214
|
+
"x-exa-source": "pi-web-access",
|
|
215
|
+
},
|
|
216
|
+
body: JSON.stringify({
|
|
217
|
+
jsonrpc: "2.0",
|
|
218
|
+
id: 1,
|
|
219
|
+
method: "tools/call",
|
|
220
|
+
params: {
|
|
221
|
+
name: toolName,
|
|
222
|
+
arguments: args,
|
|
223
|
+
},
|
|
224
|
+
}),
|
|
225
|
+
signal: requestSignal(signal),
|
|
226
|
+
});
|
|
227
|
+
|
|
228
|
+
if (!response.ok) {
|
|
229
|
+
const errorText = await response.text();
|
|
230
|
+
if (response.status === 429) {
|
|
231
|
+
throw new Error(
|
|
232
|
+
`Exa MCP rate limit reached (429). Add "exaApiKey" to ${CONFIG_PATH} for unthrottled Exa search: ${errorText.slice(0, 200)}`,
|
|
233
|
+
);
|
|
234
|
+
}
|
|
235
|
+
throw new Error(`Exa MCP error ${response.status}: ${errorText.slice(0, 300)}`);
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
const body = await response.text();
|
|
239
|
+
const dataLines = body.split("\n").filter(line => line.startsWith("data:"));
|
|
240
|
+
|
|
241
|
+
let parsed: ExaMcpRpcResponse | null = null;
|
|
242
|
+
for (const line of dataLines) {
|
|
243
|
+
const payload = line.slice(5).trim();
|
|
244
|
+
if (!payload) continue;
|
|
245
|
+
try {
|
|
246
|
+
const candidate = JSON.parse(payload) as ExaMcpRpcResponse;
|
|
247
|
+
if (candidate?.result || candidate?.error) {
|
|
248
|
+
parsed = candidate;
|
|
249
|
+
break;
|
|
250
|
+
}
|
|
251
|
+
} catch {
|
|
252
|
+
}
|
|
253
|
+
}
|
|
254
|
+
|
|
255
|
+
if (!parsed) {
|
|
256
|
+
try {
|
|
257
|
+
const candidate = JSON.parse(body) as ExaMcpRpcResponse;
|
|
258
|
+
if (candidate?.result || candidate?.error) {
|
|
259
|
+
parsed = candidate;
|
|
260
|
+
}
|
|
261
|
+
} catch {
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
if (!parsed) {
|
|
266
|
+
throw new Error("Exa MCP returned an empty response");
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
if (parsed.error) {
|
|
270
|
+
const code = typeof parsed.error.code === "number" ? ` ${parsed.error.code}` : "";
|
|
271
|
+
const message = parsed.error.message || "Unknown error";
|
|
272
|
+
throw new Error(`Exa MCP error${code}: ${message}`);
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
if (parsed.result?.isError) {
|
|
276
|
+
const message = parsed.result.content
|
|
277
|
+
?.find(item => item.type === "text" && typeof item.text === "string")
|
|
278
|
+
?.text?.trim();
|
|
279
|
+
throw new Error(message || "Exa MCP returned an error");
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
const text = parsed.result?.content
|
|
283
|
+
?.find(item => item.type === "text" && typeof item.text === "string" && item.text.trim().length > 0)
|
|
284
|
+
?.text;
|
|
285
|
+
|
|
286
|
+
if (!text) {
|
|
287
|
+
throw new Error("Exa MCP returned empty content");
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
return text;
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
function parseMcpResults(text: string): McpParsedResult[] | null {
|
|
294
|
+
const blocks = text.split(/(?=^Title: )/m).filter(block => block.trim().length > 0);
|
|
295
|
+
const parsed = blocks.map(block => {
|
|
296
|
+
const title = block.match(/^Title: (.+)/m)?.[1]?.trim() ?? "";
|
|
297
|
+
const url = block.match(/^URL: (.+)/m)?.[1]?.trim() ?? "";
|
|
298
|
+
let content = "";
|
|
299
|
+
const textStart = block.indexOf("\nText: ");
|
|
300
|
+
if (textStart >= 0) {
|
|
301
|
+
content = block.slice(textStart + 7).trim();
|
|
302
|
+
} else {
|
|
303
|
+
const hlMatch = block.match(/\nHighlights:\s*\n/);
|
|
304
|
+
if (hlMatch?.index != null) {
|
|
305
|
+
content = block.slice(hlMatch.index + hlMatch[0].length).trim();
|
|
306
|
+
}
|
|
307
|
+
}
|
|
308
|
+
content = content.replace(/\n---\s*$/, "").trim();
|
|
309
|
+
return { title, url, content };
|
|
310
|
+
}).filter(result => result.url.length > 0);
|
|
311
|
+
return parsed.length > 0 ? parsed : null;
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
function buildAnswerFromMcpResults(results: McpParsedResult[]): string {
|
|
315
|
+
if (results.length === 0) return "";
|
|
316
|
+
const parts: string[] = [];
|
|
317
|
+
for (let i = 0; i < results.length; i++) {
|
|
318
|
+
const result = results[i];
|
|
319
|
+
const snippet = result.content.replace(/\s+/g, " ").trim().slice(0, 500);
|
|
320
|
+
if (!snippet) continue;
|
|
321
|
+
const sourceTitle = result.title || `Source ${i + 1}`;
|
|
322
|
+
parts.push(`${snippet}\nSource: ${sourceTitle} (${result.url})`);
|
|
323
|
+
}
|
|
324
|
+
return parts.join("\n\n");
|
|
325
|
+
}
|
|
326
|
+
|
|
327
|
+
function mapMcpInlineContent(results: McpParsedResult[]): ExtractedContent[] {
|
|
328
|
+
return results
|
|
329
|
+
.filter(result => result.content.length > 0)
|
|
330
|
+
.map(result => ({
|
|
331
|
+
url: result.url,
|
|
332
|
+
title: result.title,
|
|
333
|
+
content: result.content,
|
|
334
|
+
error: null,
|
|
335
|
+
}));
|
|
336
|
+
}
|
|
337
|
+
|
|
338
|
+
function buildMcpQuery(query: string, options: ExaSearchOptions): string {
|
|
339
|
+
const parts = [query];
|
|
340
|
+
if (options.domainFilter?.length) {
|
|
341
|
+
for (const d of options.domainFilter) {
|
|
342
|
+
parts.push(d.startsWith("-") ? `-site:${d.slice(1)}` : `site:${d}`);
|
|
343
|
+
}
|
|
344
|
+
}
|
|
345
|
+
if (options.recencyFilter) {
|
|
346
|
+
const now = new Date();
|
|
347
|
+
switch (options.recencyFilter) {
|
|
348
|
+
case "day": parts.push("past 24 hours"); break;
|
|
349
|
+
case "week": parts.push("past week"); break;
|
|
350
|
+
case "month": parts.push(`${now.toLocaleString("en", { month: "long" })} ${now.getFullYear()}`); break;
|
|
351
|
+
case "year": parts.push(String(now.getFullYear())); break;
|
|
352
|
+
}
|
|
353
|
+
}
|
|
354
|
+
return parts.join(" ");
|
|
355
|
+
}
|
|
356
|
+
|
|
357
|
+
function isAbortMessage(message: string): boolean {
|
|
358
|
+
return message.toLowerCase().includes("abort");
|
|
359
|
+
}
|
|
360
|
+
|
|
361
|
+
function parseJsonMcpResults(text: string): ExaSearchResponse["results"] | null {
|
|
362
|
+
try {
|
|
363
|
+
const results = (JSON.parse(text) as ExaSearchResponse).results;
|
|
364
|
+
return Array.isArray(results) && results.length > 0 ? results : null;
|
|
365
|
+
} catch {
|
|
366
|
+
return null;
|
|
367
|
+
}
|
|
368
|
+
}
|
|
369
|
+
|
|
370
|
+
/**
|
|
371
|
+
* Calls one Exa MCP search tool and normalizes its payload. `web_search_advanced_exa`
|
|
372
|
+
* returns the raw Exa search JSON; `web_search_exa` returns a formatted text block.
|
|
373
|
+
*/
|
|
374
|
+
async function searchWithExaMcpTool(
|
|
375
|
+
tool: string,
|
|
376
|
+
args: Record<string, unknown>,
|
|
377
|
+
options: ExaSearchOptions,
|
|
378
|
+
): Promise<SearchResponse | null> {
|
|
379
|
+
const text = await callExaMcp(tool, args, options.signal);
|
|
380
|
+
|
|
381
|
+
const jsonResults = parseJsonMcpResults(text);
|
|
382
|
+
if (jsonResults) {
|
|
383
|
+
return toSearchResponse(
|
|
384
|
+
buildAnswerFromSearchResults(jsonResults),
|
|
385
|
+
mapResults(jsonResults),
|
|
386
|
+
options.includeContent ? mapInlineContent(jsonResults) : null,
|
|
387
|
+
);
|
|
388
|
+
}
|
|
389
|
+
|
|
390
|
+
const textResults = parseMcpResults(text);
|
|
391
|
+
if (!textResults) return null;
|
|
392
|
+
|
|
393
|
+
return toSearchResponse(
|
|
394
|
+
buildAnswerFromMcpResults(textResults),
|
|
395
|
+
mapResults(textResults),
|
|
396
|
+
options.includeContent ? mapMcpInlineContent(textResults) : null,
|
|
397
|
+
);
|
|
398
|
+
}
|
|
399
|
+
|
|
400
|
+
/** Filtered searches need the advanced tool, which not every deployment exposes. */
|
|
401
|
+
async function searchWithFilteredExaMcp(
|
|
402
|
+
query: string,
|
|
403
|
+
options: ExaSearchOptions,
|
|
404
|
+
basicArgs: Record<string, unknown>,
|
|
405
|
+
): Promise<SearchResponse | null> {
|
|
406
|
+
try {
|
|
407
|
+
return await searchWithExaMcpTool(EXA_MCP_ADVANCED_TOOL, {
|
|
408
|
+
...exaSearchArgs(query, options),
|
|
409
|
+
enableHighlights: true,
|
|
410
|
+
textMaxCharacters: options.includeContent ? 50000 : 3000,
|
|
411
|
+
}, options);
|
|
412
|
+
} catch (err) {
|
|
413
|
+
if (isAbortMessage(err instanceof Error ? err.message : String(err))) throw err;
|
|
414
|
+
// The basic tool ignores every argument except query/numResults, so the
|
|
415
|
+
// filters degrade into the query text.
|
|
416
|
+
return searchWithExaMcpTool(EXA_MCP_BASIC_TOOL, basicArgs, options);
|
|
417
|
+
}
|
|
418
|
+
}
|
|
419
|
+
|
|
420
|
+
async function searchWithExaMcp(query: string, options: ExaSearchOptions = {}): Promise<SearchResponse | null> {
|
|
421
|
+
const activityId = activityMonitor.logStart({ type: "api", query });
|
|
422
|
+
const basicArgs = { query: buildMcpQuery(query, options), numResults: options.numResults ?? 5 };
|
|
423
|
+
const filtered = !!options.includeContent || !!options.recencyFilter || !!options.domainFilter?.length;
|
|
424
|
+
|
|
425
|
+
try {
|
|
426
|
+
const response = filtered
|
|
427
|
+
? await searchWithFilteredExaMcp(query, options, basicArgs)
|
|
428
|
+
: await searchWithExaMcpTool(EXA_MCP_BASIC_TOOL, basicArgs, options);
|
|
429
|
+
activityMonitor.logComplete(activityId, 200);
|
|
430
|
+
return response;
|
|
431
|
+
} catch (err) {
|
|
432
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
433
|
+
if (isAbortMessage(message)) {
|
|
434
|
+
activityMonitor.logComplete(activityId, 0);
|
|
435
|
+
} else {
|
|
436
|
+
activityMonitor.logError(activityId, message);
|
|
437
|
+
}
|
|
438
|
+
throw err;
|
|
439
|
+
}
|
|
440
|
+
}
|
|
441
|
+
|
|
442
|
+
export function isExaAvailable(): boolean {
|
|
443
|
+
return true;
|
|
444
|
+
}
|
|
445
|
+
|
|
446
|
+
export function hasExaApiKey(): boolean {
|
|
447
|
+
return hasCredentialSource({
|
|
448
|
+
provider: "Exa",
|
|
449
|
+
configuredValue: loadConfig().exaApiKey,
|
|
450
|
+
environmentValue: process.env.EXA_API_KEY,
|
|
451
|
+
});
|
|
452
|
+
}
|
|
453
|
+
|
|
454
|
+
export async function searchWithExa(query: string, options: ExaSearchOptions = {}): Promise<ExaSearchResult> {
|
|
455
|
+
const apiKey = await getApiKey(options.signal);
|
|
456
|
+
if (!apiKey) {
|
|
457
|
+
return searchWithExaMcp(query, options);
|
|
458
|
+
}
|
|
459
|
+
|
|
460
|
+
const apiBaseUrl = getApiBaseUrl();
|
|
461
|
+
const useSearch = options.includeContent
|
|
462
|
+
|| !!options.recencyFilter
|
|
463
|
+
|| !!options.domainFilter?.length
|
|
464
|
+
|| !!(options.numResults && options.numResults !== 5);
|
|
465
|
+
|
|
466
|
+
const activityId = activityMonitor.logStart({ type: "api", query });
|
|
467
|
+
|
|
468
|
+
try {
|
|
469
|
+
if (!useSearch) {
|
|
470
|
+
const response = await fetchWithCredentialRedirects(`${apiBaseUrl}/answer`, {
|
|
471
|
+
method: "POST",
|
|
472
|
+
headers: exaApiHeaders(apiKey),
|
|
473
|
+
body: JSON.stringify({ query }),
|
|
474
|
+
signal: requestSignal(options.signal),
|
|
475
|
+
}, ["x-api-key"]);
|
|
476
|
+
|
|
477
|
+
if (!response.ok) {
|
|
478
|
+
const errorText = redactCredential(await response.text(), apiKey);
|
|
479
|
+
throw new Error(`Exa API error ${response.status}: ${errorText.slice(0, 300)}`);
|
|
480
|
+
}
|
|
481
|
+
|
|
482
|
+
const data = await response.json() as ExaAnswerResponse;
|
|
483
|
+
activityMonitor.logComplete(activityId, response.status);
|
|
484
|
+
return {
|
|
485
|
+
answer: data.answer || "",
|
|
486
|
+
results: mapResults(data.citations),
|
|
487
|
+
};
|
|
488
|
+
}
|
|
489
|
+
|
|
490
|
+
const response = await fetchWithCredentialRedirects(`${apiBaseUrl}/search`, {
|
|
491
|
+
method: "POST",
|
|
492
|
+
headers: exaApiHeaders(apiKey),
|
|
493
|
+
body: JSON.stringify({
|
|
494
|
+
...exaSearchArgs(query, options),
|
|
495
|
+
contents: options.includeContent
|
|
496
|
+
? { text: true, highlights: true }
|
|
497
|
+
: { highlights: true },
|
|
498
|
+
}),
|
|
499
|
+
signal: requestSignal(options.signal),
|
|
500
|
+
}, ["x-api-key"]);
|
|
501
|
+
|
|
502
|
+
if (!response.ok) {
|
|
503
|
+
const errorText = redactCredential(await response.text(), apiKey);
|
|
504
|
+
throw new Error(`Exa API error ${response.status}: ${errorText.slice(0, 300)}`);
|
|
505
|
+
}
|
|
506
|
+
|
|
507
|
+
const data = await response.json() as ExaSearchResponse;
|
|
508
|
+
activityMonitor.logComplete(activityId, response.status);
|
|
509
|
+
|
|
510
|
+
return toSearchResponse(
|
|
511
|
+
buildAnswerFromSearchResults(data.results),
|
|
512
|
+
mapResults(data.results),
|
|
513
|
+
options.includeContent ? mapInlineContent(data.results) : null,
|
|
514
|
+
);
|
|
515
|
+
} catch (err) {
|
|
516
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
517
|
+
const redactedMessage = redactCredential(message, apiKey);
|
|
518
|
+
if (isAbortMessage(redactedMessage)) {
|
|
519
|
+
activityMonitor.logComplete(activityId, 0);
|
|
520
|
+
} else {
|
|
521
|
+
activityMonitor.logError(activityId, redactedMessage);
|
|
522
|
+
}
|
|
523
|
+
if (redactedMessage === message) throw err;
|
|
524
|
+
throw new Error(redactedMessage);
|
|
525
|
+
}
|
|
526
|
+
}
|