@pencil-agent/nano-pencil 2.0.1 → 2.0.3

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.
Files changed (188) hide show
  1. package/README.md +267 -267
  2. package/dist/build-meta.json +3 -3
  3. package/dist/core/export-html/AGENT.md +11 -11
  4. package/dist/core/export-html/template.css +971 -971
  5. package/dist/core/export-html/template.html +54 -54
  6. package/dist/core/model/custom-providers.js +1 -1
  7. package/dist/core/model-registry.js +5 -5
  8. package/dist/extensions/builtin/AGENT.md +115 -115
  9. package/dist/extensions/builtin/browser/AGENT.md +17 -17
  10. package/dist/extensions/builtin/browser/agent-workspace/agent_helpers.py +12 -12
  11. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/amazon/product-search.md +198 -198
  12. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/archive-org/scraping.md +341 -341
  13. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/arxiv/scraping.md +311 -311
  14. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/arxiv-bulk/scraping.md +333 -333
  15. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/atlas/overview.md +70 -70
  16. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/booking-com/scraping.md +578 -578
  17. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/capterra/scraping.md +440 -440
  18. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/centilebrain/generate-estimates.md +110 -110
  19. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/coingecko/scraping.md +325 -325
  20. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/coinmarketcap/scraping.md +463 -463
  21. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/coursera/scraping.md +360 -360
  22. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/craigslist/scraping.md +390 -390
  23. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/crossref/scraping.md +568 -568
  24. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/dev-to/scraping.md +323 -323
  25. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/duckduckgo/scraping.md +349 -349
  26. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/ebay/scraping.md +435 -435
  27. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/etsy/scraping.md +506 -506
  28. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/eventbrite/scraping.md +363 -363
  29. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/expedia/automation.md +168 -168
  30. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/facebook/groups.md +236 -236
  31. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/facebook/pages.md +295 -295
  32. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/framer/editor.md +108 -108
  33. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/fred/scraping.md +493 -493
  34. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/g2/scraping.md +580 -580
  35. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/genius/scraping.md +511 -511
  36. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/github/repo-actions.md +65 -65
  37. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/github/scraping.md +184 -184
  38. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/glassdoor/scraping.md +543 -543
  39. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/gmail/compose.md +122 -122
  40. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/goodreads/scraping.md +461 -461
  41. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/gutenberg/scraping.md +383 -383
  42. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/hackernews/scraping.md +243 -243
  43. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/howlongtobeat/scraping.md +473 -473
  44. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/imdb/scraping.md +271 -271
  45. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/itch-io/scraping.md +436 -436
  46. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/job-boards/indeed-glassdoor.md +1021 -1021
  47. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/letterboxd/scraping.md +349 -349
  48. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/linkedin/invitation-manager.md +109 -109
  49. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/loom/folder-enumeration.md +170 -170
  50. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/macrotrends/scraping.md +537 -537
  51. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/medium/article-hydration.md +120 -120
  52. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/medium/scraping.md +414 -414
  53. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/metacritic/scraping.md +477 -477
  54. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/musicbrainz/scraping.md +478 -478
  55. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/nasa/scraping.md +339 -339
  56. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/news-aggregation/multi-source.md +205 -205
  57. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/open-library/scraping.md +472 -472
  58. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/openalex/scraping.md +470 -470
  59. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/openstreetmap/scraping.md +490 -490
  60. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/package-registries/npm-pypi.md +478 -478
  61. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/polymarket/scraping.md +234 -234
  62. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/producthunt/scraping.md +307 -307
  63. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/pubmed/scraping.md +421 -421
  64. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/quora/scraping.md +364 -364
  65. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/rawg/scraping.md +352 -352
  66. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/reddit/scraping.md +124 -124
  67. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/rest-countries/scraping.md +233 -233
  68. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/sec-edgar/scraping.md +361 -361
  69. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/shopify-admin/README.md +36 -36
  70. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/shopify-admin/embedded-apps.md +72 -72
  71. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/shopify-admin/knowledge-base.md +109 -109
  72. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/shopify-admin/polaris-inputs.md +137 -137
  73. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/soundcloud/scraping.md +362 -362
  74. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/spotify/scraping.md +339 -339
  75. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/stackoverflow/scraping.md +435 -435
  76. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/steam/scraping.md +575 -575
  77. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/substack/scraping.md +338 -338
  78. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/thetechgeeks/pricing.md +52 -52
  79. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/tiktok/upload.md +107 -107
  80. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/tradingview/scraping.md +309 -309
  81. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/trello/boards-and-lists.md +88 -88
  82. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/trustpilot/scraping.md +375 -375
  83. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/walmart/scraping.md +444 -444
  84. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/wayback-machine/scraping.md +306 -306
  85. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/weather/scraping.md +398 -398
  86. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/wellfound/scraping.md +596 -596
  87. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/world-bank/scraping.md +356 -356
  88. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/xiaohongshu/scraping.md +84 -84
  89. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/youtube/scraping.md +418 -418
  90. package/dist/extensions/builtin/browser/agent-workspace/domain-skills/zillow/scraping.md +433 -433
  91. package/dist/extensions/builtin/browser/browser.md +73 -73
  92. package/dist/extensions/builtin/browser/install.md +142 -142
  93. package/dist/extensions/builtin/browser/interaction-skills/connection.md +48 -48
  94. package/dist/extensions/builtin/browser/interaction-skills/cookies.md +3 -3
  95. package/dist/extensions/builtin/browser/interaction-skills/cross-origin-iframes.md +3 -3
  96. package/dist/extensions/builtin/browser/interaction-skills/dialogs.md +64 -64
  97. package/dist/extensions/builtin/browser/interaction-skills/downloads.md +3 -3
  98. package/dist/extensions/builtin/browser/interaction-skills/drag-and-drop.md +3 -3
  99. package/dist/extensions/builtin/browser/interaction-skills/dropdowns.md +3 -3
  100. package/dist/extensions/builtin/browser/interaction-skills/iframes.md +3 -3
  101. package/dist/extensions/builtin/browser/interaction-skills/network-requests.md +3 -3
  102. package/dist/extensions/builtin/browser/interaction-skills/print-as-pdf.md +3 -3
  103. package/dist/extensions/builtin/browser/interaction-skills/profile-sync.md +90 -90
  104. package/dist/extensions/builtin/browser/interaction-skills/screenshots.md +17 -17
  105. package/dist/extensions/builtin/browser/interaction-skills/scrolling.md +3 -3
  106. package/dist/extensions/builtin/browser/interaction-skills/shadow-dom.md +3 -3
  107. package/dist/extensions/builtin/browser/interaction-skills/tabs.md +69 -69
  108. package/dist/extensions/builtin/browser/interaction-skills/uploads.md +1 -1
  109. package/dist/extensions/builtin/browser/interaction-skills/viewport.md +3 -3
  110. package/dist/extensions/builtin/browser/src/browser_harness/AGENT.md +15 -15
  111. package/dist/extensions/builtin/browser/src/browser_harness/__init__.py +8 -8
  112. package/dist/extensions/builtin/browser/src/browser_harness/_ipc.py +90 -90
  113. package/dist/extensions/builtin/browser/src/browser_harness/admin.py +722 -722
  114. package/dist/extensions/builtin/browser/src/browser_harness/daemon.py +328 -328
  115. package/dist/extensions/builtin/browser/src/browser_harness/helpers.py +396 -396
  116. package/dist/extensions/builtin/browser/src/browser_harness/run.py +103 -103
  117. package/dist/extensions/builtin/debug/index.js +9 -9
  118. package/dist/extensions/builtin/discipline/skills/brainstorming/SKILL.md +33 -33
  119. package/dist/extensions/builtin/discipline/skills/executing-plans/SKILL.md +25 -25
  120. package/dist/extensions/builtin/discipline/skills/finishing-development-branch/SKILL.md +25 -25
  121. package/dist/extensions/builtin/discipline/skills/receiving-code-review/SKILL.md +22 -22
  122. package/dist/extensions/builtin/discipline/skills/requesting-code-review/SKILL.md +31 -31
  123. package/dist/extensions/builtin/discipline/skills/systematic-debugging/SKILL.md +28 -28
  124. package/dist/extensions/builtin/discipline/skills/test-driven-development/SKILL.md +32 -32
  125. package/dist/extensions/builtin/discipline/skills/using-git-worktrees/SKILL.md +25 -25
  126. package/dist/extensions/builtin/discipline/skills/verification-before-completion/SKILL.md +27 -27
  127. package/dist/extensions/builtin/discipline/skills/writing-plans/SKILL.md +26 -26
  128. package/dist/extensions/builtin/goal/README.md +67 -67
  129. package/dist/extensions/builtin/goal/index.js +6 -6
  130. package/dist/extensions/builtin/grub/README.md +112 -112
  131. package/dist/extensions/builtin/link-world/agent-workspace/README.md +16 -16
  132. package/dist/extensions/builtin/link-world/internet-search/internet-search.md +65 -65
  133. package/dist/extensions/builtin/link-world/link-world-agent.md +82 -82
  134. package/dist/extensions/builtin/link-world/linkworld.md +313 -313
  135. package/dist/extensions/builtin/link-world/network-routing/network-routing.md +67 -67
  136. package/dist/extensions/builtin/loop/README.md +92 -92
  137. package/dist/extensions/builtin/mcp/figma-design.md +68 -68
  138. package/dist/extensions/builtin/mcp/mcp-management.md +85 -85
  139. package/dist/extensions/builtin/recap/AGENT.md +15 -15
  140. package/dist/extensions/builtin/sal/README.md +72 -72
  141. package/dist/extensions/builtin/security-audit/README.md +289 -289
  142. package/dist/extensions/builtin/team/AGENT.md +112 -112
  143. package/dist/extensions/builtin/team/TESTING.md +299 -299
  144. package/dist/extensions/builtin/token-save/README.md +56 -56
  145. package/dist/extensions/optional/AGENT.md +10 -10
  146. package/dist/modes/interactive/controllers/input-submit-controller.js +2 -2
  147. package/dist/modes/interactive/controllers/stream-render-controller.js +2 -2
  148. package/dist/modes/interactive/interactive-mode.js +19 -19
  149. package/dist/modes/interactive/theme/dark.json +85 -85
  150. package/dist/modes/interactive/theme/light.json +84 -84
  151. package/dist/modes/interactive/theme/theme-schema.json +335 -335
  152. package/dist/modes/interactive/theme/warm.json +81 -81
  153. package/dist/node_modules/@pencil-agent/ai/dist/cli.js +0 -0
  154. package/dist/node_modules/@pencil-agent/ai/dist/models.generated.js +1 -1
  155. package/docs/ACP/345/215/217/350/256/256/351/233/206/346/210/220/345/274/200/345/217/221/346/226/207/346/241/243.md +851 -0
  156. package/docs/SDK-TESTING.md +364 -0
  157. package/docs/codex-goal-command-impl.md +1055 -1055
  158. package/docs/codex-goal-vs-grub.md +500 -500
  159. package/docs/custom-provider.md +27 -27
  160. package/docs/extensions.md +27 -27
  161. package/docs/keybindings.md +27 -27
  162. package/docs/loop /351/207/215/346/236/204/345/256/214/346/210/220/346/200/273/347/273/223.md" +250 -250
  163. package/docs/loop /351/207/215/346/236/204/345/256/214/346/210/220/346/212/245/345/221/212.md" +122 -122
  164. package/docs/loop /351/207/215/346/236/204/346/226/271/346/241/210.md" +1222 -1222
  165. package/docs/loop /351/207/215/346/236/204/346/226/271/346/241/210/345/256/236/347/216/260/346/212/245/345/221/212.md" +158 -158
  166. package/docs/loop /351/207/215/346/236/204/346/226/271/346/241/210/345/257/271/346/257/224/345/210/206/346/236/220.md" +128 -128
  167. package/docs/loop /351/207/215/346/236/204/350/256/241/345/210/222.md" +320 -320
  168. package/docs/loop-usage-examples.md +214 -214
  169. package/docs/mem-core/346/212/200/346/234/257/346/226/207/346/241/243.md +593 -0
  170. package/docs/models.md +27 -27
  171. package/docs/packages.md +27 -27
  172. package/docs/pi-design-philosophy.md +457 -457
  173. package/docs/planmode.md +1987 -1987
  174. package/docs/prompt-templates.md +27 -27
  175. package/docs/providers.md +27 -27
  176. package/docs/sdk.md +27 -27
  177. package/docs/skills.md +27 -27
  178. package/docs/startup-performance-optimization.md +301 -0
  179. package/docs/themes.md +27 -27
  180. package/docs/tui.md +27 -27
  181. package/docs//350/256/244/347/237/245/345/234/260/345/233/276.md +47 -0
  182. package/package.json +190 -190
  183. package/docs/cc-agent-design.md +0 -1297
  184. package/docs/cc-tui-design.md +0 -1333
  185. package/docs/nanoPencil-/345/255/246/344/271/240/350/256/241/345/210/222.md +0 -170
  186. package/docs/scan-report.md +0 -3820
  187. package/docs//345/257/271/346/240/207Claude-Code.md +0 -1775
  188. package/docs//351/230/277/351/207/214/345/267/264/345/267/264/350/264/242/346/212/245/345/210/206/346/236/220/344/271/246.md +0 -261
@@ -1,54 +1,54 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Session Export</title>
7
- <style>
8
- {{CSS}}
9
- </style>
10
- </head>
11
- <body>
12
- <button id="hamburger" title="Open sidebar"><svg width="14" height="14" viewBox="0 0 24 24" fill="currentColor" stroke="none"><circle cx="6" cy="6" r="2.5"/><circle cx="6" cy="18" r="2.5"/><circle cx="18" cy="12" r="2.5"/><rect x="5" y="6" width="2" height="12"/><path d="M6 12h10c1 0 2 0 2-2V8"/></svg></button>
13
- <div id="sidebar-overlay"></div>
14
- <div id="app">
15
- <aside id="sidebar">
16
- <div class="sidebar-header">
17
- <div class="sidebar-controls">
18
- <input type="text" class="sidebar-search" id="tree-search" placeholder="Search...">
19
- </div>
20
- <div class="sidebar-filters">
21
- <button class="filter-btn active" data-filter="default" title="Hide settings entries">Default</button>
22
- <button class="filter-btn" data-filter="no-tools" title="Default minus tool results">No-tools</button>
23
- <button class="filter-btn" data-filter="user-only" title="Only user messages">User</button>
24
- <button class="filter-btn" data-filter="labeled-only" title="Only labeled entries">Labeled</button>
25
- <button class="filter-btn" data-filter="all" title="Show everything">All</button>
26
- <button class="sidebar-close" id="sidebar-close" title="Close">✕</button>
27
- </div>
28
- </div>
29
- <div class="tree-container" id="tree-container"></div>
30
- <div class="tree-status" id="tree-status"></div>
31
- </aside>
32
- <main id="content">
33
- <div id="header-container"></div>
34
- <div id="messages"></div>
35
- </main>
36
- <div id="image-modal" class="image-modal">
37
- <img id="modal-image" src="" alt="">
38
- </div>
39
- </div>
40
-
41
- <script id="session-data" type="application/json">{{SESSION_DATA}}</script>
42
-
43
- <!-- Vendored libraries -->
44
- <script>{{MARKED_JS}}</script>
45
-
46
- <!-- highlight.js -->
47
- <script>{{HIGHLIGHT_JS}}</script>
48
-
49
- <!-- Main application code -->
50
- <script>
51
- {{JS}}
52
- </script>
53
- </body>
54
- </html>
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Session Export</title>
7
+ <style>
8
+ {{CSS}}
9
+ </style>
10
+ </head>
11
+ <body>
12
+ <button id="hamburger" title="Open sidebar"><svg width="14" height="14" viewBox="0 0 24 24" fill="currentColor" stroke="none"><circle cx="6" cy="6" r="2.5"/><circle cx="6" cy="18" r="2.5"/><circle cx="18" cy="12" r="2.5"/><rect x="5" y="6" width="2" height="12"/><path d="M6 12h10c1 0 2 0 2-2V8"/></svg></button>
13
+ <div id="sidebar-overlay"></div>
14
+ <div id="app">
15
+ <aside id="sidebar">
16
+ <div class="sidebar-header">
17
+ <div class="sidebar-controls">
18
+ <input type="text" class="sidebar-search" id="tree-search" placeholder="Search...">
19
+ </div>
20
+ <div class="sidebar-filters">
21
+ <button class="filter-btn active" data-filter="default" title="Hide settings entries">Default</button>
22
+ <button class="filter-btn" data-filter="no-tools" title="Default minus tool results">No-tools</button>
23
+ <button class="filter-btn" data-filter="user-only" title="Only user messages">User</button>
24
+ <button class="filter-btn" data-filter="labeled-only" title="Only labeled entries">Labeled</button>
25
+ <button class="filter-btn" data-filter="all" title="Show everything">All</button>
26
+ <button class="sidebar-close" id="sidebar-close" title="Close">✕</button>
27
+ </div>
28
+ </div>
29
+ <div class="tree-container" id="tree-container"></div>
30
+ <div class="tree-status" id="tree-status"></div>
31
+ </aside>
32
+ <main id="content">
33
+ <div id="header-container"></div>
34
+ <div id="messages"></div>
35
+ </main>
36
+ <div id="image-modal" class="image-modal">
37
+ <img id="modal-image" src="" alt="">
38
+ </div>
39
+ </div>
40
+
41
+ <script id="session-data" type="application/json">{{SESSION_DATA}}</script>
42
+
43
+ <!-- Vendored libraries -->
44
+ <script>{{MARKED_JS}}</script>
45
+
46
+ <!-- highlight.js -->
47
+ <script>{{HIGHLIGHT_JS}}</script>
48
+
49
+ <!-- Main application code -->
50
+ <script>
51
+ {{JS}}
52
+ </script>
53
+ </body>
54
+ </html>
@@ -1 +1 @@
1
- var b=Object.defineProperty;var r=(e,t)=>b(e,"name",{value:t,configurable:!0});import{existsSync as M,readFileSync as O,writeFileSync as I}from"fs";const d="custom-anthropic",m="custom-openai",p="custom-model",f=2,A={[d]:{id:d,label:"Anthropic-compatible",description:"Configure or edit an endpoint that speaks the Anthropic Messages API.",defaultBaseUrl:"https://api.anthropic.com/v1",api:"anthropic-messages",defaultInput:["text","image"]},[m]:{id:m,label:"OpenAI-compatible",description:"Configure or edit an endpoint that speaks an OpenAI-compatible API.",defaultBaseUrl:"https://api.openai.com/v1",api:"openai-completions",defaultInput:["text","image"]}};function g(e){if(!M(e))return{providers:{}};const t=O(e,"utf-8");return{providers:JSON.parse(t).providers??{}}}r(g,"readModelsConfig");function h(e,t){I(e,JSON.stringify(t,null,2),"utf-8")}r(h,"writeModelsConfig");function y(e,t,o){const n=C(e),s=t.trim()||p;return{id:s,name:s,api:n.api,input:n.defaultInput,contextWindow:o?.contextWindow??256e3,maxTokens:o?.maxTokens??32768}}r(y,"createCustomModelDefinition");async function w(e,t,o,n){try{if(e===d)return null;if(t.includes("localhost:11434")||t.includes("127.0.0.1:11434")){const s=await S(n);if(s)return s}return o?await _(t,o,n):null}catch{return null}}r(w,"probeModelContextWindow");async function S(e){try{const o=await fetch("http://localhost:11434/api/show",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({name:e}),signal:AbortSignal.timeout(5e3)});if(!o.ok)return null;const s=(await o.json()).model_info;if(!s)return null;const i=s["general.context_length"];return typeof i=="number"&&i>0?{contextWindow:i}:null}catch{return null}}r(S,"probeOllamaModelInfo");async function _(e,t,o){try{const n=N(e),s=await fetch(n,{headers:{Authorization:`Bearer ${t}`},signal:AbortSignal.timeout(5e3)});if(!s.ok)return null;const c=(await s.json()).data;if(!Array.isArray(c))return null;const l=c.find(u=>u.id===o);if(!l)return null;const a=l.context_length??l.max_context_length??l.top_provider?.context_length;return typeof a=="number"&&a>0?{contextWindow:a}:null}catch{return null}}r(_,"probeOpenAICompatibleModels");function N(e){const t=e.replace(/\/+$/,"");return t.endsWith("/chat/completions")?t.slice(0,-17)+"/models":(t.endsWith("/v1"),t+"/models")}r(N,"buildModelsEndpoint");function v(e,t){try{return g(e).providers?.[t]}catch{return}}r(v,"getStoredProviderConfig");function x(e){const t=e?.models;if(!Array.isArray(t)||t.length===0)return;const o=t[0];if(typeof o=="object"&&o!==null&&"id"in o&&typeof o.id=="string"&&o.id.trim())return o.id.trim()}r(x,"getStoredModelId");function U(e){const t=e?.models;return Array.isArray(t)?t.length:0}r(U,"getStoredModelCount");function E(e){const t=e?.customProviderVersion;return typeof t=="number"?t:void 0}r(E,"getStoredConfigVersion");function B(e){return e===d||e===m}r(B,"isCustomProtocolProvider");function R(){return[d,m]}r(R,"listCustomProtocolProviders");function C(e){return A[e]}r(C,"getCustomProtocolProviderDefinition");function k(e,t){const n=v(e,t)?.baseUrl;return typeof n=="string"&&n.trim()?n.trim():void 0}r(k,"getCustomProtocolProviderBaseUrl");function D(e,t){return x(v(e,t))}r(D,"getCustomProtocolProviderModelName");function W(e){let t;try{t=g(e)}catch{return}t.providers??={};let o=!1;for(const n of R()){const s=C(n),i=t.providers[n],a=E(i)!==f||U(i)!==1?p:x(i)??p,u=[y(n,a)];if(!i){t.providers[n]={baseUrl:s.defaultBaseUrl,customProviderVersion:f,models:u},o=!0;continue}(typeof i.baseUrl!="string"||!i.baseUrl.trim())&&(i.baseUrl=s.defaultBaseUrl,o=!0),i.customProviderVersion!==f&&(i.customProviderVersion=f,o=!0);const P=i.models;JSON.stringify(P)!==JSON.stringify(u)&&(i.models=u,o=!0)}o&&h(e,t)}r(W,"ensureCustomProtocolProvidersInModels");async function F(e,t,o){const n=o.baseUrl.trim(),s=o.modelName.trim();if(!n)throw new Error("Base URL cannot be empty.");if(!s)throw new Error("Model name cannot be empty.");const i=await w(t,n,o.apiKey,s),c=g(e);return c.providers??={},c.providers[t]={...c.providers[t]??{},baseUrl:n,customProviderVersion:f,models:[y(t,s,i??void 0)]},h(e,c),i}r(F,"saveCustomProtocolProviderConfig");function J(e,t,o){const n=o.trim();if(!n)throw new Error("API key cannot be empty.");e.set(t,{type:"api_key",key:n})}r(J,"saveCustomProtocolProviderApiKey");export{d as CUSTOM_ANTHROPIC_PROVIDER,m as CUSTOM_OPENAI_PROVIDER,W as ensureCustomProtocolProvidersInModels,k as getCustomProtocolProviderBaseUrl,C as getCustomProtocolProviderDefinition,D as getCustomProtocolProviderModelName,B as isCustomProtocolProvider,R as listCustomProtocolProviders,J as saveCustomProtocolProviderApiKey,F as saveCustomProtocolProviderConfig};
1
+ var b=Object.defineProperty;var r=(e,t)=>b(e,"name",{value:t,configurable:!0});import{existsSync as M,mkdirSync as O,readFileSync as I,writeFileSync as A}from"fs";import{dirname as S}from"node:path";const d="custom-anthropic",m="custom-openai",p="custom-model",f=2,w={[d]:{id:d,label:"Anthropic-compatible",description:"Configure or edit an endpoint that speaks the Anthropic Messages API.",defaultBaseUrl:"https://api.anthropic.com/v1",api:"anthropic-messages",defaultInput:["text","image"]},[m]:{id:m,label:"OpenAI-compatible",description:"Configure or edit an endpoint that speaks an OpenAI-compatible API.",defaultBaseUrl:"https://api.openai.com/v1",api:"openai-completions",defaultInput:["text","image"]}};function g(e){if(!M(e))return{providers:{}};const t=I(e,"utf-8");return{providers:JSON.parse(t).providers??{}}}r(g,"readModelsConfig");function h(e,t){O(S(e),{recursive:!0}),A(e,JSON.stringify(t,null,2),"utf-8")}r(h,"writeModelsConfig");function y(e,t,o){const n=C(e),s=t.trim()||p;return{id:s,name:s,api:n.api,input:n.defaultInput,contextWindow:o?.contextWindow??256e3,maxTokens:o?.maxTokens??32768}}r(y,"createCustomModelDefinition");async function _(e,t,o,n){try{if(e===d)return null;if(t.includes("localhost:11434")||t.includes("127.0.0.1:11434")){const s=await N(n);if(s)return s}return o?await U(t,o,n):null}catch{return null}}r(_,"probeModelContextWindow");async function N(e){try{const o=await fetch("http://localhost:11434/api/show",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({name:e}),signal:AbortSignal.timeout(5e3)});if(!o.ok)return null;const s=(await o.json()).model_info;if(!s)return null;const i=s["general.context_length"];return typeof i=="number"&&i>0?{contextWindow:i}:null}catch{return null}}r(N,"probeOllamaModelInfo");async function U(e,t,o){try{const n=E(e),s=await fetch(n,{headers:{Authorization:`Bearer ${t}`},signal:AbortSignal.timeout(5e3)});if(!s.ok)return null;const c=(await s.json()).data;if(!Array.isArray(c))return null;const l=c.find(u=>u.id===o);if(!l)return null;const a=l.context_length??l.max_context_length??l.top_provider?.context_length;return typeof a=="number"&&a>0?{contextWindow:a}:null}catch{return null}}r(U,"probeOpenAICompatibleModels");function E(e){const t=e.replace(/\/+$/,"");return t.endsWith("/chat/completions")?t.slice(0,-17)+"/models":(t.endsWith("/v1"),t+"/models")}r(E,"buildModelsEndpoint");function v(e,t){try{return g(e).providers?.[t]}catch{return}}r(v,"getStoredProviderConfig");function x(e){const t=e?.models;if(!Array.isArray(t)||t.length===0)return;const o=t[0];if(typeof o=="object"&&o!==null&&"id"in o&&typeof o.id=="string"&&o.id.trim())return o.id.trim()}r(x,"getStoredModelId");function R(e){const t=e?.models;return Array.isArray(t)?t.length:0}r(R,"getStoredModelCount");function T(e){const t=e?.customProviderVersion;return typeof t=="number"?t:void 0}r(T,"getStoredConfigVersion");function W(e){return e===d||e===m}r(W,"isCustomProtocolProvider");function V(){return[d,m]}r(V,"listCustomProtocolProviders");function C(e){return w[e]}r(C,"getCustomProtocolProviderDefinition");function F(e,t){const n=v(e,t)?.baseUrl;return typeof n=="string"&&n.trim()?n.trim():void 0}r(F,"getCustomProtocolProviderBaseUrl");function J(e,t){return x(v(e,t))}r(J,"getCustomProtocolProviderModelName");function L(e){let t;try{t=g(e)}catch{return}t.providers??={};let o=!1;for(const n of V()){const s=C(n),i=t.providers[n],a=T(i)!==f||R(i)!==1?p:x(i)??p,u=[y(n,a)];if(!i){t.providers[n]={baseUrl:s.defaultBaseUrl,customProviderVersion:f,models:u},o=!0;continue}(typeof i.baseUrl!="string"||!i.baseUrl.trim())&&(i.baseUrl=s.defaultBaseUrl,o=!0),i.customProviderVersion!==f&&(i.customProviderVersion=f,o=!0);const P=i.models;JSON.stringify(P)!==JSON.stringify(u)&&(i.models=u,o=!0)}o&&h(e,t)}r(L,"ensureCustomProtocolProvidersInModels");async function j(e,t,o){const n=o.baseUrl.trim(),s=o.modelName.trim();if(!n)throw new Error("Base URL cannot be empty.");if(!s)throw new Error("Model name cannot be empty.");const i=await _(t,n,o.apiKey,s),c=g(e);return c.providers??={},c.providers[t]={...c.providers[t]??{},baseUrl:n,customProviderVersion:f,models:[y(t,s,i??void 0)]},h(e,c),i}r(j,"saveCustomProtocolProviderConfig");function $(e,t,o){const n=o.trim();if(!n)throw new Error("API key cannot be empty.");e.set(t,{type:"api_key",key:n})}r($,"saveCustomProtocolProviderApiKey");export{d as CUSTOM_ANTHROPIC_PROVIDER,m as CUSTOM_OPENAI_PROVIDER,L as ensureCustomProtocolProvidersInModels,F as getCustomProtocolProviderBaseUrl,C as getCustomProtocolProviderDefinition,J as getCustomProtocolProviderModelName,W as isCustomProtocolProvider,V as listCustomProtocolProviders,$ as saveCustomProtocolProviderApiKey,j as saveCustomProtocolProviderConfig};
@@ -1,9 +1,9 @@
1
- var C=Object.defineProperty;var h=(c,r)=>C(c,"name",{value:r,configurable:!0});import{getModels as k,getProviders as S}from"@pencil-agent/ai/models";import{registerOAuthProvider as E}from"@pencil-agent/ai/oauth";import{registerApiProvider as L}from"@pencil-agent/ai/registry";import{Type as e}from"@sinclair/typebox";import A from"ajv";import{existsSync as P,readFileSync as R,writeFileSync as T}from"fs";import{dirname as F,join as M}from"path";import{getAgentDir as K}from"../config.js";import{clearConfigValueCache as j,resolveConfigValue as v,resolveHeaders as m}from"./platform/config/resolve-config-value.js";import{discoverModels as $,getDiscoveryProtocol as D}from"./model/discovery.js";import{DiscoveryCache as N}from"./model/discovery-cache.js";import{lookupKnownModel as W,UNKNOWN_MODEL_DEFAULTS as I}from"./model/known-models.js";const B=A.default||A,_=e.Object({only:e.Optional(e.Array(e.String())),order:e.Optional(e.Array(e.String()))}),H=e.Object({only:e.Optional(e.Array(e.String())),order:e.Optional(e.Array(e.String()))}),q=e.Object({supportsStore:e.Optional(e.Boolean()),supportsDeveloperRole:e.Optional(e.Boolean()),supportsReasoningEffort:e.Optional(e.Boolean()),supportsUsageInStreaming:e.Optional(e.Boolean()),maxTokensField:e.Optional(e.Union([e.Literal("max_completion_tokens"),e.Literal("max_tokens")])),requiresToolResultName:e.Optional(e.Boolean()),requiresAssistantAfterToolResult:e.Optional(e.Boolean()),requiresThinkingAsText:e.Optional(e.Boolean()),requiresMistralToolIds:e.Optional(e.Boolean()),thinkingFormat:e.Optional(e.Union([e.Literal("openai"),e.Literal("zai"),e.Literal("qwen")])),openRouterRouting:e.Optional(_),vercelGatewayRouting:e.Optional(H)}),G=e.Object({}),U=e.Union([q,G]),x=e.Union([e.Literal("standard"),e.Literal("weak-model-compatible"),e.Literal("high-intelligence"),e.Literal("low-intelligence"),e.Literal("structured-adaptive")]),J=e.Object({id:e.String({minLength:1}),name:e.Optional(e.String({minLength:1})),api:e.Optional(e.String({minLength:1})),reasoning:e.Optional(e.Boolean()),input:e.Optional(e.Array(e.Union([e.Literal("text"),e.Literal("image")]))),cost:e.Optional(e.Object({input:e.Number(),output:e.Number(),cacheRead:e.Number(),cacheWrite:e.Number()})),contextWindow:e.Optional(e.Number()),maxTokens:e.Optional(e.Number()),headers:e.Optional(e.Record(e.String(),e.String())),agentLoopFramework:e.Optional(x),compat:e.Optional(U)}),z=e.Object({name:e.Optional(e.String({minLength:1})),reasoning:e.Optional(e.Boolean()),input:e.Optional(e.Array(e.Union([e.Literal("text"),e.Literal("image")]))),cost:e.Optional(e.Object({input:e.Optional(e.Number()),output:e.Optional(e.Number()),cacheRead:e.Optional(e.Number()),cacheWrite:e.Optional(e.Number())})),contextWindow:e.Optional(e.Number()),maxTokens:e.Optional(e.Number()),headers:e.Optional(e.Record(e.String(),e.String())),agentLoopFramework:e.Optional(x),compat:e.Optional(U)});function y(c){return c==="high-intelligence"?"standard":c==="low-intelligence"||c==="structured-adaptive"?"weak-model-compatible":c}h(y,"normalizeAgentLoopFramework");const V=e.Object({baseUrl:e.Optional(e.String({minLength:1})),apiKey:e.Optional(e.String({minLength:1})),api:e.Optional(e.String({minLength:1})),headers:e.Optional(e.Record(e.String(),e.String())),authHeader:e.Optional(e.Boolean()),models:e.Optional(e.Array(J)),modelOverrides:e.Optional(e.Record(e.String(),z)),discovery:e.Optional(e.Boolean()),discoveryCacheTtl:e.Optional(e.Number())}),Q=e.Object({providers:e.Record(e.String(),V)});function g(c){return{models:[],overrides:new Map,modelOverrides:new Map,error:c}}h(g,"emptyCustomModelsResult");function X(c,r){if(!r)return c;const o=c,t=r,i={...o,...t},a=o,s=t,n=i;return(a?.openRouterRouting||s.openRouterRouting)&&(n.openRouterRouting={...a?.openRouterRouting,...s.openRouterRouting}),(a?.vercelGatewayRouting||s.vercelGatewayRouting)&&(n.vercelGatewayRouting={...a?.vercelGatewayRouting,...s.vercelGatewayRouting}),i}h(X,"mergeCompat");function Y(c,r){const o={...c};if(r.name!==void 0&&(o.name=r.name),r.reasoning!==void 0&&(o.reasoning=r.reasoning),r.input!==void 0&&(o.input=r.input),r.contextWindow!==void 0&&(o.contextWindow=r.contextWindow),r.maxTokens!==void 0&&(o.maxTokens=r.maxTokens),r.agentLoopFramework!==void 0&&(o.agentLoopFramework=y(r.agentLoopFramework)),r.cost&&(o.cost={input:r.cost.input??c.cost.input,output:r.cost.output??c.cost.output,cacheRead:r.cost.cacheRead??c.cost.cacheRead,cacheWrite:r.cost.cacheWrite??c.cost.cacheWrite}),r.headers){const t=m(r.headers);o.headers=t?{...c.headers,...t}:c.headers}return o.compat=X(c.compat,r.compat),o}h(Y,"applyModelOverride");const he=j,Z=["openrouter/auto","openrouter/free"];class O{static{h(this,"ModelRegistry")}authStorage;modelsJsonPath;models=[];customProviderApiKeys=new Map;registeredProviders=new Map;loadError=void 0;useOnlyCustomModels;allowOptionalApiKeyForProvider;discoveryCache;discoveryProviders=new Map;discoveryRefreshing=!1;constructor(r,o=M(K(),"models.json"),t={}){this.authStorage=r,this.modelsJsonPath=o,this.useOnlyCustomModels=t.useOnlyCustomModels??!1,this.allowOptionalApiKeyForProvider=t.allowOptionalApiKeyForProvider;const i=o?F(o):K();this.discoveryCache=new N(M(i,".cache","discovery")),this.authStorage.setFallbackResolver(a=>{const s=this.customProviderApiKeys.get(a);if(s)return v(s)}),this.loadModels()}refresh(){this.customProviderApiKeys.clear(),this.loadError=void 0,this.loadModels();for(const[r,o]of this.registeredProviders.entries())this.applyProviderConfig(r,o)}getError(){return this.loadError}loadModels(){const{models:r,overrides:o,modelOverrides:t,error:i}=this.modelsJsonPath?this.loadCustomModels(this.modelsJsonPath):g();i&&(this.loadError=i);const a=this.useOnlyCustomModels?this.loadBuiltInModels(o,t,new Set(["openrouter","zai"]),{openrouter:new Set(Z)}):this.loadBuiltInModels(o,t);let s=this.mergeCustomModels(a,r);for(const[n,l]of this.discoveryProviders){const d=this.discoveryCache.read(n,l.cacheTtl);d&&(s=this.mergeDiscoveredModels(s,d.models,n,l))}for(const n of this.authStorage.getOAuthProviders()){const l=this.authStorage.get(n.id);l?.type==="oauth"&&n.modifyModels&&(s=n.modifyModels(s,l))}this.models=s}loadBuiltInModels(r,o,t,i){return(t?S().filter(s=>t.has(s)):S()).flatMap(s=>{const n=i?.[s],l=k(s).filter(f=>!n||n.has(f.id)),d=r.get(s),p=o.get(s);return l.map(f=>{let u=f;if(d){const b=m(d.headers);u={...u,baseUrl:d.baseUrl??u.baseUrl,headers:b?{...u.headers,...b}:u.headers}}const w=p?.get(f.id);return w&&(u=Y(u,w)),u})})}mergeCustomModels(r,o){const t=[...r];for(const i of o){const a=t.findIndex(s=>s.provider===i.provider&&s.id===i.id);a>=0?t[a]=i:t.push(i)}return t}mergeDiscoveredModels(r,o,t,i){const a=[...r],s=new Set(r.filter(n=>n.provider===t).map(n=>n.id));for(const n of o){if(s.has(n.id))continue;const l=W(n.id),d=l??I;a.push({id:n.id,name:n.name??l?.name??n.id,api:i.api??l?.api??"openai-completions",provider:t,baseUrl:i.baseUrl,reasoning:d.reasoning,input:[...d.input],cost:{...d.cost},contextWindow:d.contextWindow,maxTokens:d.maxTokens,source:"discovery"})}return a}loadCustomModels(r){if(!P(r))return g();try{const o=R(r,"utf-8"),t=JSON.parse(o),a=new B().compile(Q);if(!a(t)){const l=a.errors?.map(d=>` - ${d.instancePath||"root"}: ${d.message}`).join(`
2
- `)||"Unknown schema error";return g(`Invalid models.json schema:
1
+ var k=Object.defineProperty;var h=(c,r)=>k(c,"name",{value:r,configurable:!0});import{getModels as E,getProviders as S}from"@pencil-agent/ai/models";import{registerOAuthProvider as L}from"@pencil-agent/ai/oauth";import{registerApiProvider as T}from"@pencil-agent/ai/registry";import{Type as e}from"@sinclair/typebox";import A from"ajv";import{existsSync as P,mkdirSync as F,readFileSync as R,writeFileSync as j}from"fs";import{dirname as M,join as K}from"path";import{getAgentDir as U}from"../config.js";import{clearConfigValueCache as $,resolveConfigValue as g,resolveHeaders as m}from"./platform/config/resolve-config-value.js";import{discoverModels as D,getDiscoveryProtocol as N}from"./model/discovery.js";import{DiscoveryCache as W}from"./model/discovery-cache.js";import{lookupKnownModel as I,UNKNOWN_MODEL_DEFAULTS as B}from"./model/known-models.js";const _=A.default||A,H=e.Object({only:e.Optional(e.Array(e.String())),order:e.Optional(e.Array(e.String()))}),q=e.Object({only:e.Optional(e.Array(e.String())),order:e.Optional(e.Array(e.String()))}),G=e.Object({supportsStore:e.Optional(e.Boolean()),supportsDeveloperRole:e.Optional(e.Boolean()),supportsReasoningEffort:e.Optional(e.Boolean()),supportsUsageInStreaming:e.Optional(e.Boolean()),maxTokensField:e.Optional(e.Union([e.Literal("max_completion_tokens"),e.Literal("max_tokens")])),requiresToolResultName:e.Optional(e.Boolean()),requiresAssistantAfterToolResult:e.Optional(e.Boolean()),requiresThinkingAsText:e.Optional(e.Boolean()),requiresMistralToolIds:e.Optional(e.Boolean()),thinkingFormat:e.Optional(e.Union([e.Literal("openai"),e.Literal("zai"),e.Literal("qwen")])),openRouterRouting:e.Optional(H),vercelGatewayRouting:e.Optional(q)}),J=e.Object({}),x=e.Union([G,J]),C=e.Union([e.Literal("standard"),e.Literal("weak-model-compatible"),e.Literal("high-intelligence"),e.Literal("low-intelligence"),e.Literal("structured-adaptive")]),z=e.Object({id:e.String({minLength:1}),name:e.Optional(e.String({minLength:1})),api:e.Optional(e.String({minLength:1})),reasoning:e.Optional(e.Boolean()),input:e.Optional(e.Array(e.Union([e.Literal("text"),e.Literal("image")]))),cost:e.Optional(e.Object({input:e.Number(),output:e.Number(),cacheRead:e.Number(),cacheWrite:e.Number()})),contextWindow:e.Optional(e.Number()),maxTokens:e.Optional(e.Number()),headers:e.Optional(e.Record(e.String(),e.String())),agentLoopFramework:e.Optional(C),compat:e.Optional(x)}),V=e.Object({name:e.Optional(e.String({minLength:1})),reasoning:e.Optional(e.Boolean()),input:e.Optional(e.Array(e.Union([e.Literal("text"),e.Literal("image")]))),cost:e.Optional(e.Object({input:e.Optional(e.Number()),output:e.Optional(e.Number()),cacheRead:e.Optional(e.Number()),cacheWrite:e.Optional(e.Number())})),contextWindow:e.Optional(e.Number()),maxTokens:e.Optional(e.Number()),headers:e.Optional(e.Record(e.String(),e.String())),agentLoopFramework:e.Optional(C),compat:e.Optional(x)});function y(c){return c==="high-intelligence"?"standard":c==="low-intelligence"||c==="structured-adaptive"?"weak-model-compatible":c}h(y,"normalizeAgentLoopFramework");const Q=e.Object({baseUrl:e.Optional(e.String({minLength:1})),apiKey:e.Optional(e.String({minLength:1})),api:e.Optional(e.String({minLength:1})),headers:e.Optional(e.Record(e.String(),e.String())),authHeader:e.Optional(e.Boolean()),models:e.Optional(e.Array(z)),modelOverrides:e.Optional(e.Record(e.String(),V)),discovery:e.Optional(e.Boolean()),discoveryCacheTtl:e.Optional(e.Number())}),X=e.Object({providers:e.Record(e.String(),Q)});function v(c){return{models:[],overrides:new Map,modelOverrides:new Map,error:c}}h(v,"emptyCustomModelsResult");function Y(c,r){if(!r)return c;const o=c,t=r,i={...o,...t},a=o,s=t,n=i;return(a?.openRouterRouting||s.openRouterRouting)&&(n.openRouterRouting={...a?.openRouterRouting,...s.openRouterRouting}),(a?.vercelGatewayRouting||s.vercelGatewayRouting)&&(n.vercelGatewayRouting={...a?.vercelGatewayRouting,...s.vercelGatewayRouting}),i}h(Y,"mergeCompat");function Z(c,r){const o={...c};if(r.name!==void 0&&(o.name=r.name),r.reasoning!==void 0&&(o.reasoning=r.reasoning),r.input!==void 0&&(o.input=r.input),r.contextWindow!==void 0&&(o.contextWindow=r.contextWindow),r.maxTokens!==void 0&&(o.maxTokens=r.maxTokens),r.agentLoopFramework!==void 0&&(o.agentLoopFramework=y(r.agentLoopFramework)),r.cost&&(o.cost={input:r.cost.input??c.cost.input,output:r.cost.output??c.cost.output,cacheRead:r.cost.cacheRead??c.cost.cacheRead,cacheWrite:r.cost.cacheWrite??c.cost.cacheWrite}),r.headers){const t=m(r.headers);o.headers=t?{...c.headers,...t}:c.headers}return o.compat=Y(c.compat,r.compat),o}h(Z,"applyModelOverride");const me=$,ee=["openrouter/auto","openrouter/free"];class O{static{h(this,"ModelRegistry")}authStorage;modelsJsonPath;models=[];customProviderApiKeys=new Map;registeredProviders=new Map;loadError=void 0;useOnlyCustomModels;allowOptionalApiKeyForProvider;discoveryCache;discoveryProviders=new Map;discoveryRefreshing=!1;constructor(r,o=K(U(),"models.json"),t={}){this.authStorage=r,this.modelsJsonPath=o,this.useOnlyCustomModels=t.useOnlyCustomModels??!1,this.allowOptionalApiKeyForProvider=t.allowOptionalApiKeyForProvider;const i=o?M(o):U();this.discoveryCache=new W(K(i,".cache","discovery")),this.authStorage.setFallbackResolver(a=>{const s=this.customProviderApiKeys.get(a);if(s)return g(s)}),this.loadModels()}refresh(){this.customProviderApiKeys.clear(),this.loadError=void 0,this.loadModels();for(const[r,o]of this.registeredProviders.entries())this.applyProviderConfig(r,o)}getError(){return this.loadError}loadModels(){const{models:r,overrides:o,modelOverrides:t,error:i}=this.modelsJsonPath?this.loadCustomModels(this.modelsJsonPath):v();i&&(this.loadError=i);const a=this.useOnlyCustomModels?this.loadBuiltInModels(o,t,new Set(["openrouter","zai"]),{openrouter:new Set(ee)}):this.loadBuiltInModels(o,t);let s=this.mergeCustomModels(a,r);for(const[n,l]of this.discoveryProviders){const d=this.discoveryCache.read(n,l.cacheTtl);d&&(s=this.mergeDiscoveredModels(s,d.models,n,l))}for(const n of this.authStorage.getOAuthProviders()){const l=this.authStorage.get(n.id);l?.type==="oauth"&&n.modifyModels&&(s=n.modifyModels(s,l))}this.models=s}loadBuiltInModels(r,o,t,i){return(t?S().filter(s=>t.has(s)):S()).flatMap(s=>{const n=i?.[s],l=E(s).filter(f=>!n||n.has(f.id)),d=r.get(s),p=o.get(s);return l.map(f=>{let u=f;if(d){const b=m(d.headers);u={...u,baseUrl:d.baseUrl??u.baseUrl,headers:b?{...u.headers,...b}:u.headers}}const w=p?.get(f.id);return w&&(u=Z(u,w)),u})})}mergeCustomModels(r,o){const t=[...r];for(const i of o){const a=t.findIndex(s=>s.provider===i.provider&&s.id===i.id);a>=0?t[a]=i:t.push(i)}return t}mergeDiscoveredModels(r,o,t,i){const a=[...r],s=new Set(r.filter(n=>n.provider===t).map(n=>n.id));for(const n of o){if(s.has(n.id))continue;const l=I(n.id),d=l??B;a.push({id:n.id,name:n.name??l?.name??n.id,api:i.api??l?.api??"openai-completions",provider:t,baseUrl:i.baseUrl,reasoning:d.reasoning,input:[...d.input],cost:{...d.cost},contextWindow:d.contextWindow,maxTokens:d.maxTokens,source:"discovery"})}return a}loadCustomModels(r){if(!P(r))return v();try{const o=R(r,"utf-8"),t=JSON.parse(o),a=new _().compile(X);if(!a(t)){const l=a.errors?.map(d=>` - ${d.instancePath||"root"}: ${d.message}`).join(`
2
+ `)||"Unknown schema error";return v(`Invalid models.json schema:
3
3
  ${l}
4
4
 
5
- File: ${r}`)}this.validateConfig(t);const s=new Map,n=new Map;this.discoveryProviders.clear();for(const[l,d]of Object.entries(t.providers))(d.baseUrl||d.headers||d.apiKey)&&s.set(l,{baseUrl:d.baseUrl,headers:d.headers,apiKey:d.apiKey}),d.apiKey&&this.customProviderApiKeys.set(l,d.apiKey),d.modelOverrides&&n.set(l,new Map(Object.entries(d.modelOverrides))),d.discovery&&d.baseUrl&&d.api&&this.discoveryProviders.set(l,{provider:l,baseUrl:d.baseUrl,api:d.api,cacheTtl:d.discoveryCacheTtl??86400});return{models:this.parseModels(t),overrides:s,modelOverrides:n,error:void 0}}catch(o){return o instanceof SyntaxError?g(`Failed to parse models.json: ${o.message}
5
+ File: ${r}`)}this.validateConfig(t);const s=new Map,n=new Map;this.discoveryProviders.clear();for(const[l,d]of Object.entries(t.providers))(d.baseUrl||d.headers||d.apiKey)&&s.set(l,{baseUrl:d.baseUrl,headers:d.headers,apiKey:d.apiKey}),d.apiKey&&this.customProviderApiKeys.set(l,d.apiKey),d.modelOverrides&&n.set(l,new Map(Object.entries(d.modelOverrides))),d.discovery&&d.baseUrl&&d.api&&this.discoveryProviders.set(l,{provider:l,baseUrl:d.baseUrl,api:d.api,cacheTtl:d.discoveryCacheTtl??86400});return{models:this.parseModels(t),overrides:s,modelOverrides:n,error:void 0}}catch(o){return o instanceof SyntaxError?v(`Failed to parse models.json: ${o.message}
6
6
 
7
- File: ${r}`):g(`Failed to load models.json: ${o instanceof Error?o.message:o}
7
+ File: ${r}`):v(`Failed to load models.json: ${o instanceof Error?o.message:o}
8
8
 
9
- File: ${r}`)}}validateConfig(r){for(const[o,t]of Object.entries(r.providers)){const i=!!t.api,a=t.models??[],s=t.modelOverrides&&Object.keys(t.modelOverrides).length>0;if(a.length===0){if(t.discovery&&t.baseUrl&&t.api)continue;if(!t.baseUrl&&!s)throw new Error(`Provider ${o}: must specify "baseUrl", "modelOverrides", or "models".`)}else{if(!t.baseUrl)throw new Error(`Provider ${o}: "baseUrl" is required when defining custom models.`);if(!!!(this.allowOptionalApiKeyForProvider!==void 0&&(Array.isArray(this.allowOptionalApiKeyForProvider)?this.allowOptionalApiKeyForProvider.includes(o):o===this.allowOptionalApiKeyForProvider))&&!t.apiKey)throw new Error(`Provider ${o}: "apiKey" is required when defining custom models.`)}for(const n of a){const l=!!n.api;if(!i&&!l)throw new Error(`Provider ${o}, model ${n.id}: no "api" specified. Set at provider or model level.`);if(!n.id)throw new Error(`Provider ${o}: model missing "id"`);if(n.contextWindow!==void 0&&n.contextWindow<=0)throw new Error(`Provider ${o}, model ${n.id}: invalid contextWindow`);if(n.maxTokens!==void 0&&n.maxTokens<=0)throw new Error(`Provider ${o}, model ${n.id}: invalid maxTokens`)}}}parseModels(r){const o=[];for(const[t,i]of Object.entries(r.providers)){const a=i.models??[];if(a.length!==0){i.apiKey&&this.customProviderApiKeys.set(t,i.apiKey);for(const s of a){const n=s.api||i.api;if(!n)continue;const l=m(i.headers),d=m(s.headers);let p=l||d?{...l,...d}:void 0;if(i.authHeader&&i.apiKey){const u=v(i.apiKey);u&&(p={...p,Authorization:`Bearer ${u}`})}const f={input:0,output:0,cacheRead:0,cacheWrite:0};o.push({id:s.id,name:s.name??s.id,api:n,provider:t,baseUrl:i.baseUrl,reasoning:s.reasoning??!1,input:s.input??["text"],cost:s.cost??f,contextWindow:s.contextWindow??128e3,maxTokens:s.maxTokens??16384,headers:p,agentLoopFramework:y(s.agentLoopFramework),compat:s.compat})}}}return o}getAll(){return this.models}getAvailable(){return this.models.filter(r=>this.authStorage.hasAuth(r.provider))}async getAvailableAsync(){const r=[];for(const o of this.models)await this.authStorage.getApiKey(o.provider)&&r.push(o);return r}async refreshWithDiscovery(){if(this.discoveryRefreshing)return{discovered:0,errors:[]};this.discoveryRefreshing=!0;try{const r=await Promise.allSettled(Array.from(this.discoveryProviders.keys()).map(i=>this.discoverProvider(i)));let o=0;const t=[];for(const i of r){if(i.status==="rejected"){t.push(i.reason?.message??"Unknown discovery error");continue}o+=i.value.models.length,i.value.error&&t.push(`${i.value.provider}: ${i.value.error}`)}this.loadModels();for(const[i,a]of this.registeredProviders.entries())this.applyProviderConfig(i,a);return{discovered:o,errors:t}}finally{this.discoveryRefreshing=!1}}async discoverProvider(r){const o=this.discoveryProviders.get(r);if(!o)return{provider:r,models:[],fetchedAt:Date.now(),ttl:0,error:`Provider "${r}" does not have discovery enabled`};if(D(o.api)==="unsupported")return{provider:r,models:[],fetchedAt:Date.now(),ttl:0,error:`Discovery not supported for API type "${o.api}"`};const i=await this.authStorage.getApiKey(r),a=await $(r,o.baseUrl,o.api,i);return(a.models.length>0||!a.error)&&this.discoveryCache.write(a),a}getDiscoveryStatus(r){const o=this.discoveryProviders.get(r);if(!o)return{enabled:!1,cached:!1,modelCount:0};const t=this.discoveryCache.read(r,o.cacheTtl);return{enabled:!0,cached:t!==void 0,lastFetched:t?.fetchedAt,modelCount:t?.models.length??0}}isDiscoveryEnabled(r){return this.discoveryProviders.has(r)}clearDiscoveryCache(){this.discoveryCache.clear()}find(r,o){return this.models.find(t=>t.provider===r&&t.id===o)}async getApiKey(r){return this.authStorage.getApiKey(r.provider)}async getApiKeyForProvider(r){return this.authStorage.getApiKey(r)}isUsingOAuth(r){return this.authStorage.get(r.provider)?.type==="oauth"}registerProvider(r,o){this.registeredProviders.set(r,o),this.applyProviderConfig(r,o)}applyProviderConfig(r,o){if(o.oauth){const t={...o.oauth,id:r};E(t)}if(o.streamSimple){if(!o.api)throw new Error(`Provider ${r}: "api" is required when registering streamSimple.`);const t=o.streamSimple;L({api:o.api,stream:h((i,a,s)=>t(i,a,s),"stream"),streamSimple:t})}if(o.apiKey&&this.customProviderApiKeys.set(r,o.apiKey),o.models&&o.models.length>0){if(this.models=this.models.filter(t=>t.provider!==r),!o.baseUrl)throw new Error(`Provider ${r}: "baseUrl" is required when defining models.`);if(!o.apiKey&&!o.oauth)throw new Error(`Provider ${r}: "apiKey" or "oauth" is required when defining models.`);for(const t of o.models){const i=t.api||o.api;if(!i)throw new Error(`Provider ${r}, model ${t.id}: no "api" specified.`);const a=m(o.headers),s=m(t.headers);let n=a||s?{...a,...s}:void 0;if(o.authHeader&&o.apiKey){const l=v(o.apiKey);l&&(n={...n,Authorization:`Bearer ${l}`})}this.models.push({id:t.id,name:t.name,api:i,provider:r,baseUrl:o.baseUrl,reasoning:t.reasoning,input:t.input,cost:t.cost,contextWindow:t.contextWindow,maxTokens:t.maxTokens,headers:n,agentLoopFramework:y(t.agentLoopFramework),compat:t.compat})}if(o.oauth?.modifyModels){const t=this.authStorage.get(r);t?.type==="oauth"&&(this.models=o.oauth.modifyModels(this.models,t))}}else if(o.baseUrl){const t=m(o.headers);this.models=this.models.map(i=>i.provider!==r?i:{...i,baseUrl:o.baseUrl??i.baseUrl,headers:t?{...i.headers,...t}:i.headers})}}static OPENROUTER_JSON_BASE="https://openrouter.ai/api/v1";static OPENROUTER_JSON_API="openai-completions";appendOpenRouterModel(r,o){const t="openrouter",i=r.trim();if(!i)throw new Error("OpenRouter model id cannot be empty");const a=this.modelsJsonPath;if(!a)throw new Error("models.json path is not configured");let s;if(P(a)){const p=R(a,"utf-8");s=JSON.parse(p)}else s={providers:{}};(!s.providers||typeof s.providers!="object")&&(s.providers={});const n=s.providers[t]??{},l=Array.isArray(n.models)?[...n.models]:[];if(l.some(p=>p&&typeof p=="object"&&p.id===i))throw new Error(`OpenRouter model "${i}" already exists in models.json`);const d=o?.name?.trim()||i;l.push({id:i,name:d,input:["text"],contextWindow:256e3,maxTokens:8192}),s.providers[t]={...n,baseUrl:n.baseUrl??O.OPENROUTER_JSON_BASE,api:n.api??O.OPENROUTER_JSON_API,models:l},T(a,JSON.stringify(s,null,2),"utf-8"),this.refresh()}}export{O as ModelRegistry,he as clearApiKeyCache};
9
+ File: ${r}`)}}validateConfig(r){for(const[o,t]of Object.entries(r.providers)){const i=!!t.api,a=t.models??[],s=t.modelOverrides&&Object.keys(t.modelOverrides).length>0;if(a.length===0){if(t.discovery&&t.baseUrl&&t.api)continue;if(!t.baseUrl&&!s)throw new Error(`Provider ${o}: must specify "baseUrl", "modelOverrides", or "models".`)}else{if(!t.baseUrl)throw new Error(`Provider ${o}: "baseUrl" is required when defining custom models.`);if(!!!(this.allowOptionalApiKeyForProvider!==void 0&&(Array.isArray(this.allowOptionalApiKeyForProvider)?this.allowOptionalApiKeyForProvider.includes(o):o===this.allowOptionalApiKeyForProvider))&&!t.apiKey)throw new Error(`Provider ${o}: "apiKey" is required when defining custom models.`)}for(const n of a){const l=!!n.api;if(!i&&!l)throw new Error(`Provider ${o}, model ${n.id}: no "api" specified. Set at provider or model level.`);if(!n.id)throw new Error(`Provider ${o}: model missing "id"`);if(n.contextWindow!==void 0&&n.contextWindow<=0)throw new Error(`Provider ${o}, model ${n.id}: invalid contextWindow`);if(n.maxTokens!==void 0&&n.maxTokens<=0)throw new Error(`Provider ${o}, model ${n.id}: invalid maxTokens`)}}}parseModels(r){const o=[];for(const[t,i]of Object.entries(r.providers)){const a=i.models??[];if(a.length!==0){i.apiKey&&this.customProviderApiKeys.set(t,i.apiKey);for(const s of a){const n=s.api||i.api;if(!n)continue;const l=m(i.headers),d=m(s.headers);let p=l||d?{...l,...d}:void 0;if(i.authHeader&&i.apiKey){const u=g(i.apiKey);u&&(p={...p,Authorization:`Bearer ${u}`})}const f={input:0,output:0,cacheRead:0,cacheWrite:0};o.push({id:s.id,name:s.name??s.id,api:n,provider:t,baseUrl:i.baseUrl,reasoning:s.reasoning??!1,input:s.input??["text"],cost:s.cost??f,contextWindow:s.contextWindow??128e3,maxTokens:s.maxTokens??16384,headers:p,agentLoopFramework:y(s.agentLoopFramework),compat:s.compat})}}}return o}getAll(){return this.models}getAvailable(){return this.models.filter(r=>this.authStorage.hasAuth(r.provider))}async getAvailableAsync(){const r=[];for(const o of this.models)await this.authStorage.getApiKey(o.provider)&&r.push(o);return r}async refreshWithDiscovery(){if(this.discoveryRefreshing)return{discovered:0,errors:[]};this.discoveryRefreshing=!0;try{const r=await Promise.allSettled(Array.from(this.discoveryProviders.keys()).map(i=>this.discoverProvider(i)));let o=0;const t=[];for(const i of r){if(i.status==="rejected"){t.push(i.reason?.message??"Unknown discovery error");continue}o+=i.value.models.length,i.value.error&&t.push(`${i.value.provider}: ${i.value.error}`)}this.loadModels();for(const[i,a]of this.registeredProviders.entries())this.applyProviderConfig(i,a);return{discovered:o,errors:t}}finally{this.discoveryRefreshing=!1}}async discoverProvider(r){const o=this.discoveryProviders.get(r);if(!o)return{provider:r,models:[],fetchedAt:Date.now(),ttl:0,error:`Provider "${r}" does not have discovery enabled`};if(N(o.api)==="unsupported")return{provider:r,models:[],fetchedAt:Date.now(),ttl:0,error:`Discovery not supported for API type "${o.api}"`};const i=await this.authStorage.getApiKey(r),a=await D(r,o.baseUrl,o.api,i);return(a.models.length>0||!a.error)&&this.discoveryCache.write(a),a}getDiscoveryStatus(r){const o=this.discoveryProviders.get(r);if(!o)return{enabled:!1,cached:!1,modelCount:0};const t=this.discoveryCache.read(r,o.cacheTtl);return{enabled:!0,cached:t!==void 0,lastFetched:t?.fetchedAt,modelCount:t?.models.length??0}}isDiscoveryEnabled(r){return this.discoveryProviders.has(r)}clearDiscoveryCache(){this.discoveryCache.clear()}find(r,o){return this.models.find(t=>t.provider===r&&t.id===o)}async getApiKey(r){return this.authStorage.getApiKey(r.provider)}async getApiKeyForProvider(r){return this.authStorage.getApiKey(r)}isUsingOAuth(r){return this.authStorage.get(r.provider)?.type==="oauth"}registerProvider(r,o){this.registeredProviders.set(r,o),this.applyProviderConfig(r,o)}applyProviderConfig(r,o){if(o.oauth){const t={...o.oauth,id:r};L(t)}if(o.streamSimple){if(!o.api)throw new Error(`Provider ${r}: "api" is required when registering streamSimple.`);const t=o.streamSimple;T({api:o.api,stream:h((i,a,s)=>t(i,a,s),"stream"),streamSimple:t})}if(o.apiKey&&this.customProviderApiKeys.set(r,o.apiKey),o.models&&o.models.length>0){if(this.models=this.models.filter(t=>t.provider!==r),!o.baseUrl)throw new Error(`Provider ${r}: "baseUrl" is required when defining models.`);if(!o.apiKey&&!o.oauth)throw new Error(`Provider ${r}: "apiKey" or "oauth" is required when defining models.`);for(const t of o.models){const i=t.api||o.api;if(!i)throw new Error(`Provider ${r}, model ${t.id}: no "api" specified.`);const a=m(o.headers),s=m(t.headers);let n=a||s?{...a,...s}:void 0;if(o.authHeader&&o.apiKey){const l=g(o.apiKey);l&&(n={...n,Authorization:`Bearer ${l}`})}this.models.push({id:t.id,name:t.name,api:i,provider:r,baseUrl:o.baseUrl,reasoning:t.reasoning,input:t.input,cost:t.cost,contextWindow:t.contextWindow,maxTokens:t.maxTokens,headers:n,agentLoopFramework:y(t.agentLoopFramework),compat:t.compat})}if(o.oauth?.modifyModels){const t=this.authStorage.get(r);t?.type==="oauth"&&(this.models=o.oauth.modifyModels(this.models,t))}}else if(o.baseUrl){const t=m(o.headers);this.models=this.models.map(i=>i.provider!==r?i:{...i,baseUrl:o.baseUrl??i.baseUrl,headers:t?{...i.headers,...t}:i.headers})}}static OPENROUTER_JSON_BASE="https://openrouter.ai/api/v1";static OPENROUTER_JSON_API="openai-completions";appendOpenRouterModel(r,o){const t="openrouter",i=r.trim();if(!i)throw new Error("OpenRouter model id cannot be empty");const a=this.modelsJsonPath;if(!a)throw new Error("models.json path is not configured");let s;if(P(a)){const p=R(a,"utf-8");s=JSON.parse(p)}else s={providers:{}};(!s.providers||typeof s.providers!="object")&&(s.providers={});const n=s.providers[t]??{},l=Array.isArray(n.models)?[...n.models]:[];if(l.some(p=>p&&typeof p=="object"&&p.id===i))throw new Error(`OpenRouter model "${i}" already exists in models.json`);const d=o?.name?.trim()||i;l.push({id:i,name:d,input:["text"],contextWindow:256e3,maxTokens:8192}),s.providers[t]={...n,baseUrl:n.baseUrl??O.OPENROUTER_JSON_BASE,api:n.api??O.OPENROUTER_JSON_API,models:l},F(M(a),{recursive:!0}),j(a,JSON.stringify(s,null,2),"utf-8"),this.refresh()}}export{O as ModelRegistry,me as clearApiKeyCache};
@@ -1,115 +1,115 @@
1
- # extensions/builtin/
2
-
3
- > P2 | Parent: ../AGENT.md
4
-
5
- Member List
6
- diagnostics/index.ts: Diagnostics extension entry, subscribes to diagnostic:event, buffers session-local diagnostic records, prompts only after threshold at agent_end, registers /report-issue
7
- goal/index.ts: Goal extension entry, per-thread GoalController, /goal command and goal subcommand autocomplete, get_goal/create_goal/update_goal tools, turn/account lifecycle hooks, idle-continuation prompt dispatch, GOAL_MESSAGE_TYPE renderer, session_start/shutdown hooks, persistent per-thread status footer indicator
8
- goal/goal-types.ts: ThreadGoalStatus enum (active/paused/blocked/usage_limited/budget_limited/complete), ThreadGoal record, GoalSetMode, GoalAccountingMode, GoalTurnAccounting, GoalControllerState, validation constants
9
- goal/goal-store.ts: GoalStore JSON-file persistence layer; get/replace/insert/update/delete/account_usage primitives, atomic temp-file rename, status-filtered accounting modes, budget-limit auto-downgrade
10
- goal/goal-format.ts: formatGoalElapsedSeconds, formatTokens, goalStatusLabel, goalUsageSummary, goalSummaryLines, goalStatusIndicator, shouldConfirmBeforeReplacing, editedGoalStatus, validateObjective, validateBudget
11
- goal/goal-prompts.ts: buildContinuationPrompt, buildBudgetLimitPrompt, buildObjectiveUpdatedPrompt - three steering templates mirroring codex-rs prompts/templates/goals/*
12
- goal/goal-controller.ts: GoalController class, per-thread mutex, on_turn_start/on_token_usage/on_tool_finish/on_turn_end/on_turn_abort/on_turn_error/on_usage_limit hooks, idle continuation followUp injection, blocked-signal escalation counter, budget-limit steering emission
13
- goal/goal-tools.ts: get_goal/create_goal/update_goal LLM tool factories, TypeBox parameter schemas, host singleton for controller lookup, renderGoalResponse formatter
14
- goal/goal-parser.ts: parseGoalCommand, buildGoalHelp, getGoalArgumentCompletions for /goal subcommand autocomplete
15
- goal/goal-command.ts: runGoalCommand handler for /goal show/clear/edit/pause/resume/set with ConfirmIfExists dialog, multi-line summary renderer
16
- goal/README.md: Goal extension documentation - usage, LLM tools, lifecycle, persistence, status indicator, file-by-file architecture
17
- diagnostics/types.ts: Diagnostic event/report type contract and diagnostic:event channel name
18
- diagnostics/diagnostic-buffer.ts: DiagnosticBuffer, event coercion, fingerprint dedupe, prompt gating
19
- diagnostics/reporter.ts: User-approved InsForge pencil_issue_events reporter, configured via NANOPENCIL_ISSUE_* env vars
20
- diagnostics/redaction.ts: Diagnostic message normalization and secret/path redaction helpers
21
- browser/index.ts: Browser Harness extension entry, registers browser/browser_admin tools, /browser command, Browser Harness resource discovery, project-local browser workspace seeding; opt-in since P6/EV03 despite physical source staying under builtin pending Q2 physical/package decision
22
- browser/browser.md: Browser Harness day-to-day skill instructions for NanoPencil tool use and workspace contribution
23
- browser/install.md: Browser Harness setup and troubleshooting instructions, exposed as a skill resource
24
- browser/src/browser_harness/: Vendored Browser Harness Python package, CDP daemon, IPC bridge, admin commands, and helper functions
25
- browser/interaction-skills/: Reusable Browser Harness mechanics guides for browser interactions
26
- browser/agent-workspace/: Seed workspace copied to .nanopencil/browser-workspace for editable helpers and domain skills
27
- discipline/index.ts: Engineering discipline extension entry, registers skill tool, default workflow skills, and lightweight before_agent_start bootstrap prompt
28
- discipline/skills/: Built-in engineering workflow skills for brainstorming, debugging, TDD, verification, planning, code review, worktrees, and branch finishing
29
- idle-think/index.ts: IdleThink extension entry, session lifecycle registration, activity tracking, and persistent insight prompt injection
30
- idle-think/idle-think-runtime.ts: IdleThink runtime boundary - state, budget reset, interval ownership, abort cleanup, exploration orchestration, insight persistence, and diagnostic reporting
31
- idle-think/thinker.ts: IdleThink read-only SubAgent exploration runner, project context collection, network capability detection, and exploration prompt construction
32
- idle-think/insights.ts: IdleThink nanomem-backed project-scoped insight storage and system prompt injection
33
- idle-think/curiosity.ts: IdleThink curiosity queue persistence, topic selection, dedupe, and explored-topic pruning
34
- link-world/index.ts: Internet access integration entry, registers link_world_admin/link_world_exec/web_search/web_fetch tools, /link-world status/doctor/version/install commands, and bundled internet-search resources
35
- link-world/link-world-agent.md: Agent-facing skill that tells models to prefer web_search/web_fetch and link_world_admin/link_world_exec over bash for internet tasks
36
- link-world/network-routing.md: Routing skill that tells models when to use web_search/web_fetch/link-world versus browser automation
37
- link-world/agent-workspace/: Seed workspace copied to .nanopencil/link-world-workspace for project-local domain skills and notes
38
- mcp/index.ts: MCP protocol integration extension, MCP guidance resources
39
- presence/index.ts: AI-driven opening + idle presence lines, git/cwd snapshot, systemPrompt injection of recent presence lines, timers/debounce/idle in-flight lock, settings.presence.enabled guard, PRESENCE_MESSAGE_TYPE renderer
40
- presence/presence-memory.ts: Presence memory boundary - NanoMem directory/project discovery, memory-derived locale detection, randomized preference/lesson highlight selection for greeting prompts
41
- plan/index.ts: Plan Mode extension entry, /plan /plan:validate /plan:approve commands, EnterPlanMode/ExitPlanMode tools, permission gating, TUI status/widget, workflow prompt injection
42
- plan/types.ts: Plan mode types, persisted state payload, attachment variants, permission result model
43
- plan/plan-file-manager.ts: Plan file path management, slug generation, settings-aware plans directory, plan state hydration/serialization, resume/fork copy helpers
44
- plan/plan-permissions.ts: Plan mode tool permission gating, exact plan-file write checks, read-only bash allowlist, agent/tool blocking policy
45
- plan/plan-workflow-prompt.ts: Plan mode full/sparse workflow prompt, reentry prompt, exit prompt, EnterPlanMode/ExitPlanMode tool result text
46
- plan/enter-plan-mode-tool.ts: EnterPlanMode tool for model-initiated plan mode entry and UI state activation
47
- plan/exit-plan-mode-tool.ts: ExitPlanMode tool for user-approved plan mode exit, validation, teammate approval, UI cleanup
48
- plan/plan-agents.ts: Explore/Plan subagent prompt helpers and read-only tool list for plan mode
49
- plan/plan-validation.ts: Plan structure validation for Context, Approach, Files/Changes, and Verification sections
50
- plan/teammate-approval.ts: Teammate plan approval mailbox integration and approval/waiting message formatting
51
- subagent/index.ts: SubAgent extension entry, /subagent:/subagent:run/:stop/:status/:report/:apply commands, SUBAGENT_MESSAGE_TYPE renderer
52
- subagent/subagent-parser.ts: SubAgent command parsing, parseSubAgentCommand/buildSubAgentHelp
53
- subagent/subagent-runner.ts: SubAgent orchestration — research (read-only) and implement (isolated worktree) roles, diff preview and apply flow
54
- subagent/subagent-types.ts: SubAgent extension types — SubAgentPhase, SubAgentWorkerInfo, SubAgentRunState, SubAgentRunReport
55
- interview/index.ts: Requirement clarification extension entry, /interview and /grill-me commands, interview tool registration, custom message renderers, lightweight before_agent_start hook
56
- interview/interview-runtime.ts: Interview probe/runtime boundary - synchronous prompt heuristics, workspace context collection, LLM probe coercion, UI follow-up loop, refined intent injection text
57
- security-audit/interface.ts: Security audit interface, SecurityCheckResult/AuditEvent/SecurityEngine
58
- security-audit/index.ts: Security extension entry, audit logging and dangerous pattern detection
59
- security-audit/engine/interceptor.ts: Request/response interception, InterceptorResult confirmation flow
60
- security-audit/engine/logger.ts: Security event logging, JSON file audit trail
61
- security-audit/engine/detector.ts: Vulnerability detection, pattern matching for dangerous commands
62
- soul/index.ts: AI personality evolution extension, persistent personality across sessions
63
- grub/index.ts: Grub extension entry - autonomous iterative task runner, /grub command, dual-phase prompt injection, feature-list guard dispatch, GRUB_MESSAGE_TYPE renderer
64
- grub/grub-controller.ts: GrubController - drives autonomous grub iterations, durable GrubTaskState, initializer baseline capture, feature-list mutation validation
65
- grub/grub-decision.ts: Grub assistant protocol parser, extracts validated loop-state decisions from assistant text
66
- grub/grub-parser.ts: Grub command parsing, parseGrubCommand/buildGrubHelp
67
- grub/grub-prompts.ts: Grub prompt construction boundary, initializer/coding system prompts and per-task dispatch prompts
68
- grub/grub-harness.ts: Grub harness artifact boundary, .grub/<id>/ feature-list/progress-log/init.sh creation
69
- grub/grub-format.ts: Grub user-facing status/result formatter for readable TUI messages
70
- grub/grub-turn.ts: Grub turn-end coordinator, parsing assistant output, checklist gates, retry/terminal update events
71
- grub/grub-i18n.ts: Grub localization helper, English/Chinese prompts and TUI strings
72
- grub/grub-feature-list.ts: feature-list.json IO, initializer skeleton, legacy checklist migration, passes/evidence-only diff validation
73
- grub/grub-persistence.ts: Cross-session .grub/<id>/state.json persistence, active task discovery, stale harness pruning
74
- grub/grub-types.ts: Grub types, GrubStatus/GrubDecisionStatus/GrubDecision/GrubTaskState/GrubTaskSnapshot/FeatureList/PersistedGrubState
75
- grub/README.md: Grub extension documentation - autonomous "keep digging until done" runner without default git commits
76
- loop/index.ts: Loop extension entry - session-scoped recurring prompt/command scheduler with pause/resume/run-now/max-runs/quiet, /loop command + LOOP_MESSAGE_TYPE renderer
77
- loop/scheduler-controller.ts: SchedulerController - in-memory recurring task store with pause/resume/run-now/max-runs, MAX_SCHEDULED_TASKS=50
78
- loop/scheduler-parser.ts: Loop command parsing with flags/subcommands, parseSchedulerCommand/parseDurationSpec/buildSchedulerHelp, --name/--max/--quiet
79
- loop/scheduler-types.ts: Scheduled loop types, LoopPayloadKind/ScheduledLoopTask/LoopStartSpec/ParsedSchedulerCommand
80
- loop/README.md: Loop extension documentation - recurring scheduler usage and flags
81
- sal/index.ts: SAL extension entry, enabled by default, registers flags, /sal:* commands, lifecycle hooks including agent_result, terrain snapshot refresh, eval event emission, and stale-run cleanup scheduling; delegates config, context, runtime contracts, and tool_trace analytics to focused SAL modules
82
- sal/sal-config.ts: SAL build metadata, eval environment constants, credential loading, truthy parsing, stale-cleanup/A-B flag resolution, experiment id normalization, and sidecar directory resolution
83
- sal/sal-context.ts: SAL anchor system-prompt injection formatting plus A/B sidecar turn-record persistence
84
- sal/sal-runtime.ts: SAL shared BuildMeta/TurnState/SalRuntime contracts used across config, context, trace, and entry modules, including per-turn loop outcome state
85
- sal/sal-trace.ts: SAL tool path extraction, task intent inference, and bounded tool_trace payload construction with loop outcome summary
86
- sal/terrain.ts: TerrainSnapshot/TerrainNode/TerrainEdge model, buildTerrainIndex(), checkDipCoverage(), isSnapshotStale(), moduleIdForPath(), parses P2 AGENT.md and P3 file headers
87
- sal/anchors.ts: StructuralAnchor/AnchorResolution model, locateTask(), locateAction(), evidence-driven scoring with tunable SalWeights, CJK bigram tokenization
88
- sal/weights.ts: SalWeights interface, SAL_DEFAULT_WEIGHTS, loadSalWeights() reads sal-config.json from workspace or .memory-experiments/sal/
89
- sal/eval/index.ts: createEvalSink() factory + barrel re-exports; adapter selection via options.adapter or endpoint scheme inference (http(s)→insforge, file://|/|./|../→jsonl, missing→noop); ONLY entry point SAL imports from
90
- sal/eval/types.ts: EvalSink interface, EvalEventEnvelope/EvalEventType (run_start/run_end/turn_anchor), EvalAdapterId ("insforge"|"jsonl"|"noop"), CreateEvalSinkOptions with optional onDiagnostic callback, createEvalEvent factory; zero-dependency type surface
91
- sal/eval/noop-sink.ts: noopSink — silent EvalSink used when eval disabled or no adapter configured
92
- sal/eval/insforge-sink.ts: InsForgeEvalSink — PostgREST adapter, routes run_start→eval_runs INSERT (merge-duplicates) with legacy-schema fallback, writes turn_anchor/tool_trace/memory_recalls/run_end only after parent run confirmation, tool_trace→eval_tool_traces with PGRST204 fallback, memory_recalls→eval_memory_recalls batch INSERT, run_end→eval_runs PATCH; allowSelfSigned TLS option logs only in development runtime, batching with default 2000ms interval
93
- sal/eval/jsonl-sink.ts: JsonlEvalSink — append-only filesystem adapter, one JSON object per line, accepts file:// URLs or plain paths, auto-creates parent dir, batched writes
94
- sal/README.md: SAL extension usage, sidecar output layout, weights override, pluggability contract
95
- team/index.ts: AgentTeam extension entry, /team <task>, /team:spawn/:preset/:send/:status/:progress/:psyche/:dashboard/:task/:mail/:allow-path/:stop/:terminate/:approve/:mode command registration and dispatch
96
- team/team-ui.ts: AgentTeam message renderer, list/status/task formatting, dashboard visibility/timer ownership, realtime observer, speaker-stream emission helpers
97
- team/team-types.ts: TeammateRole/TeammateMode/TeammateStatus/TeamTask/HarnessState/PsycheWeights/TeamUtterance/Handoff/LeaderPlan/AgentLiveView/TeammateIdentity/PersistedTeammate/TeamSpawnSpec/TeamSendResult types
98
- team/team-state-store.ts: TeamStateStore class - durable teammate persistence via JSON files in <agentDir>/teams/
99
- team/team-parser.ts: Team command parser - parseTeamCommand/buildTeamHelp for /team:* subcommands
100
- team/team-runtime.ts: TeamRuntime class - teammate registry, stable internal labels plus visible teammate names, per-teammate send queue, lifecycle, durable tasks, mailbox + permission + transcript wiring
101
- team/team-runtime-helpers.ts: TeamRuntime helper boundary - teammate prompt construction, harness turn preparation, live event projection, tool selection, path guards, label/role/text helpers
102
- team/team-orchestrator.ts: Leader orchestration helpers - plan building, speaker utterance creation, @mention parsing, and handoff execution
103
- team/team-task-store.ts: TeamTaskStore class - durable shared task list in <storageDir>/tasks.json
104
- team/team-harness.ts: Harness protocol helpers - context files, phase instructions, checkpoint/revert, feature validation
105
- team/team-presets.ts: Preset definitions and executor - solo/duo/squad spawning, model-assisted auto team selection, heuristic fallback
106
- team/team-dashboard.ts: Text dashboard/status rendering - teammate workbench cards, current task, last utterance, progress bars, footer summary
107
- team/team-psyche.ts: Psyche prompt layer - role/phase weighted Id/Ego/Superego prompt construction
108
- team/team-permissions.ts: PermissionStore - pending permission request queue, approve/deny, path allowlists
109
- team/team-mailbox.ts: TeamMailbox - typed JSONL-backed append-only message log for leader↔teammate and teammate↔teammate
110
- team/team-transcript.ts: TeamTranscriptWriter - per-teammate JSONL transcripts
111
- team/TESTING.md: Manual & smoke-test guide for Phase B AgentTeam
112
-
113
- Rule: Members complete, one item per line, parent links valid, precise terms first
114
-
115
- [COVENANT]: Update this file header on changes and verify against parent AGENT.md
1
+ # extensions/builtin/
2
+
3
+ > P2 | Parent: ../AGENT.md
4
+
5
+ Member List
6
+ diagnostics/index.ts: Diagnostics extension entry, subscribes to diagnostic:event, buffers session-local diagnostic records, prompts only after threshold at agent_end, registers /report-issue
7
+ goal/index.ts: Goal extension entry, per-thread GoalController, /goal command and goal subcommand autocomplete, get_goal/create_goal/update_goal tools, turn/account lifecycle hooks, idle-continuation prompt dispatch, GOAL_MESSAGE_TYPE renderer, session_start/shutdown hooks, persistent per-thread status footer indicator
8
+ goal/goal-types.ts: ThreadGoalStatus enum (active/paused/blocked/usage_limited/budget_limited/complete), ThreadGoal record, GoalSetMode, GoalAccountingMode, GoalTurnAccounting, GoalControllerState, validation constants
9
+ goal/goal-store.ts: GoalStore JSON-file persistence layer; get/replace/insert/update/delete/account_usage primitives, atomic temp-file rename, status-filtered accounting modes, budget-limit auto-downgrade
10
+ goal/goal-format.ts: formatGoalElapsedSeconds, formatTokens, goalStatusLabel, goalUsageSummary, goalSummaryLines, goalStatusIndicator, shouldConfirmBeforeReplacing, editedGoalStatus, validateObjective, validateBudget
11
+ goal/goal-prompts.ts: buildContinuationPrompt, buildBudgetLimitPrompt, buildObjectiveUpdatedPrompt - three steering templates mirroring codex-rs prompts/templates/goals/*
12
+ goal/goal-controller.ts: GoalController class, per-thread mutex, on_turn_start/on_token_usage/on_tool_finish/on_turn_end/on_turn_abort/on_turn_error/on_usage_limit hooks, idle continuation followUp injection, blocked-signal escalation counter, budget-limit steering emission
13
+ goal/goal-tools.ts: get_goal/create_goal/update_goal LLM tool factories, TypeBox parameter schemas, host singleton for controller lookup, renderGoalResponse formatter
14
+ goal/goal-parser.ts: parseGoalCommand, buildGoalHelp, getGoalArgumentCompletions for /goal subcommand autocomplete
15
+ goal/goal-command.ts: runGoalCommand handler for /goal show/clear/edit/pause/resume/set with ConfirmIfExists dialog, multi-line summary renderer
16
+ goal/README.md: Goal extension documentation - usage, LLM tools, lifecycle, persistence, status indicator, file-by-file architecture
17
+ diagnostics/types.ts: Diagnostic event/report type contract and diagnostic:event channel name
18
+ diagnostics/diagnostic-buffer.ts: DiagnosticBuffer, event coercion, fingerprint dedupe, prompt gating
19
+ diagnostics/reporter.ts: User-approved InsForge pencil_issue_events reporter, configured via NANOPENCIL_ISSUE_* env vars
20
+ diagnostics/redaction.ts: Diagnostic message normalization and secret/path redaction helpers
21
+ browser/index.ts: Browser Harness extension entry, registers browser/browser_admin tools, /browser command, Browser Harness resource discovery, project-local browser workspace seeding; opt-in since P6/EV03 despite physical source staying under builtin pending Q2 physical/package decision
22
+ browser/browser.md: Browser Harness day-to-day skill instructions for NanoPencil tool use and workspace contribution
23
+ browser/install.md: Browser Harness setup and troubleshooting instructions, exposed as a skill resource
24
+ browser/src/browser_harness/: Vendored Browser Harness Python package, CDP daemon, IPC bridge, admin commands, and helper functions
25
+ browser/interaction-skills/: Reusable Browser Harness mechanics guides for browser interactions
26
+ browser/agent-workspace/: Seed workspace copied to .nanopencil/browser-workspace for editable helpers and domain skills
27
+ discipline/index.ts: Engineering discipline extension entry, registers skill tool, default workflow skills, and lightweight before_agent_start bootstrap prompt
28
+ discipline/skills/: Built-in engineering workflow skills for brainstorming, debugging, TDD, verification, planning, code review, worktrees, and branch finishing
29
+ idle-think/index.ts: IdleThink extension entry, session lifecycle registration, activity tracking, and persistent insight prompt injection
30
+ idle-think/idle-think-runtime.ts: IdleThink runtime boundary - state, budget reset, interval ownership, abort cleanup, exploration orchestration, insight persistence, and diagnostic reporting
31
+ idle-think/thinker.ts: IdleThink read-only SubAgent exploration runner, project context collection, network capability detection, and exploration prompt construction
32
+ idle-think/insights.ts: IdleThink nanomem-backed project-scoped insight storage and system prompt injection
33
+ idle-think/curiosity.ts: IdleThink curiosity queue persistence, topic selection, dedupe, and explored-topic pruning
34
+ link-world/index.ts: Internet access integration entry, registers link_world_admin/link_world_exec/web_search/web_fetch tools, /link-world status/doctor/version/install commands, and bundled internet-search resources
35
+ link-world/link-world-agent.md: Agent-facing skill that tells models to prefer web_search/web_fetch and link_world_admin/link_world_exec over bash for internet tasks
36
+ link-world/network-routing.md: Routing skill that tells models when to use web_search/web_fetch/link-world versus browser automation
37
+ link-world/agent-workspace/: Seed workspace copied to .nanopencil/link-world-workspace for project-local domain skills and notes
38
+ mcp/index.ts: MCP protocol integration extension, MCP guidance resources
39
+ presence/index.ts: AI-driven opening + idle presence lines, git/cwd snapshot, systemPrompt injection of recent presence lines, timers/debounce/idle in-flight lock, settings.presence.enabled guard, PRESENCE_MESSAGE_TYPE renderer
40
+ presence/presence-memory.ts: Presence memory boundary - NanoMem directory/project discovery, memory-derived locale detection, randomized preference/lesson highlight selection for greeting prompts
41
+ plan/index.ts: Plan Mode extension entry, /plan /plan:validate /plan:approve commands, EnterPlanMode/ExitPlanMode tools, permission gating, TUI status/widget, workflow prompt injection
42
+ plan/types.ts: Plan mode types, persisted state payload, attachment variants, permission result model
43
+ plan/plan-file-manager.ts: Plan file path management, slug generation, settings-aware plans directory, plan state hydration/serialization, resume/fork copy helpers
44
+ plan/plan-permissions.ts: Plan mode tool permission gating, exact plan-file write checks, read-only bash allowlist, agent/tool blocking policy
45
+ plan/plan-workflow-prompt.ts: Plan mode full/sparse workflow prompt, reentry prompt, exit prompt, EnterPlanMode/ExitPlanMode tool result text
46
+ plan/enter-plan-mode-tool.ts: EnterPlanMode tool for model-initiated plan mode entry and UI state activation
47
+ plan/exit-plan-mode-tool.ts: ExitPlanMode tool for user-approved plan mode exit, validation, teammate approval, UI cleanup
48
+ plan/plan-agents.ts: Explore/Plan subagent prompt helpers and read-only tool list for plan mode
49
+ plan/plan-validation.ts: Plan structure validation for Context, Approach, Files/Changes, and Verification sections
50
+ plan/teammate-approval.ts: Teammate plan approval mailbox integration and approval/waiting message formatting
51
+ subagent/index.ts: SubAgent extension entry, /subagent:/subagent:run/:stop/:status/:report/:apply commands, SUBAGENT_MESSAGE_TYPE renderer
52
+ subagent/subagent-parser.ts: SubAgent command parsing, parseSubAgentCommand/buildSubAgentHelp
53
+ subagent/subagent-runner.ts: SubAgent orchestration — research (read-only) and implement (isolated worktree) roles, diff preview and apply flow
54
+ subagent/subagent-types.ts: SubAgent extension types — SubAgentPhase, SubAgentWorkerInfo, SubAgentRunState, SubAgentRunReport
55
+ interview/index.ts: Requirement clarification extension entry, /interview and /grill-me commands, interview tool registration, custom message renderers, lightweight before_agent_start hook
56
+ interview/interview-runtime.ts: Interview probe/runtime boundary - synchronous prompt heuristics, workspace context collection, LLM probe coercion, UI follow-up loop, refined intent injection text
57
+ security-audit/interface.ts: Security audit interface, SecurityCheckResult/AuditEvent/SecurityEngine
58
+ security-audit/index.ts: Security extension entry, audit logging and dangerous pattern detection
59
+ security-audit/engine/interceptor.ts: Request/response interception, InterceptorResult confirmation flow
60
+ security-audit/engine/logger.ts: Security event logging, JSON file audit trail
61
+ security-audit/engine/detector.ts: Vulnerability detection, pattern matching for dangerous commands
62
+ soul/index.ts: AI personality evolution extension, persistent personality across sessions
63
+ grub/index.ts: Grub extension entry - autonomous iterative task runner, /grub command, dual-phase prompt injection, feature-list guard dispatch, GRUB_MESSAGE_TYPE renderer
64
+ grub/grub-controller.ts: GrubController - drives autonomous grub iterations, durable GrubTaskState, initializer baseline capture, feature-list mutation validation
65
+ grub/grub-decision.ts: Grub assistant protocol parser, extracts validated loop-state decisions from assistant text
66
+ grub/grub-parser.ts: Grub command parsing, parseGrubCommand/buildGrubHelp
67
+ grub/grub-prompts.ts: Grub prompt construction boundary, initializer/coding system prompts and per-task dispatch prompts
68
+ grub/grub-harness.ts: Grub harness artifact boundary, .grub/<id>/ feature-list/progress-log/init.sh creation
69
+ grub/grub-format.ts: Grub user-facing status/result formatter for readable TUI messages
70
+ grub/grub-turn.ts: Grub turn-end coordinator, parsing assistant output, checklist gates, retry/terminal update events
71
+ grub/grub-i18n.ts: Grub localization helper, English/Chinese prompts and TUI strings
72
+ grub/grub-feature-list.ts: feature-list.json IO, initializer skeleton, legacy checklist migration, passes/evidence-only diff validation
73
+ grub/grub-persistence.ts: Cross-session .grub/<id>/state.json persistence, active task discovery, stale harness pruning
74
+ grub/grub-types.ts: Grub types, GrubStatus/GrubDecisionStatus/GrubDecision/GrubTaskState/GrubTaskSnapshot/FeatureList/PersistedGrubState
75
+ grub/README.md: Grub extension documentation - autonomous "keep digging until done" runner without default git commits
76
+ loop/index.ts: Loop extension entry - session-scoped recurring prompt/command scheduler with pause/resume/run-now/max-runs/quiet, /loop command + LOOP_MESSAGE_TYPE renderer
77
+ loop/scheduler-controller.ts: SchedulerController - in-memory recurring task store with pause/resume/run-now/max-runs, MAX_SCHEDULED_TASKS=50
78
+ loop/scheduler-parser.ts: Loop command parsing with flags/subcommands, parseSchedulerCommand/parseDurationSpec/buildSchedulerHelp, --name/--max/--quiet
79
+ loop/scheduler-types.ts: Scheduled loop types, LoopPayloadKind/ScheduledLoopTask/LoopStartSpec/ParsedSchedulerCommand
80
+ loop/README.md: Loop extension documentation - recurring scheduler usage and flags
81
+ sal/index.ts: SAL extension entry, enabled by default, registers flags, /sal:* commands, lifecycle hooks including agent_result, terrain snapshot refresh, eval event emission, and stale-run cleanup scheduling; delegates config, context, runtime contracts, and tool_trace analytics to focused SAL modules
82
+ sal/sal-config.ts: SAL build metadata, eval environment constants, credential loading, truthy parsing, stale-cleanup/A-B flag resolution, experiment id normalization, and sidecar directory resolution
83
+ sal/sal-context.ts: SAL anchor system-prompt injection formatting plus A/B sidecar turn-record persistence
84
+ sal/sal-runtime.ts: SAL shared BuildMeta/TurnState/SalRuntime contracts used across config, context, trace, and entry modules, including per-turn loop outcome state
85
+ sal/sal-trace.ts: SAL tool path extraction, task intent inference, and bounded tool_trace payload construction with loop outcome summary
86
+ sal/terrain.ts: TerrainSnapshot/TerrainNode/TerrainEdge model, buildTerrainIndex(), checkDipCoverage(), isSnapshotStale(), moduleIdForPath(), parses P2 AGENT.md and P3 file headers
87
+ sal/anchors.ts: StructuralAnchor/AnchorResolution model, locateTask(), locateAction(), evidence-driven scoring with tunable SalWeights, CJK bigram tokenization
88
+ sal/weights.ts: SalWeights interface, SAL_DEFAULT_WEIGHTS, loadSalWeights() reads sal-config.json from workspace or .memory-experiments/sal/
89
+ sal/eval/index.ts: createEvalSink() factory + barrel re-exports; adapter selection via options.adapter or endpoint scheme inference (http(s)→insforge, file://|/|./|../→jsonl, missing→noop); ONLY entry point SAL imports from
90
+ sal/eval/types.ts: EvalSink interface, EvalEventEnvelope/EvalEventType (run_start/run_end/turn_anchor), EvalAdapterId ("insforge"|"jsonl"|"noop"), CreateEvalSinkOptions with optional onDiagnostic callback, createEvalEvent factory; zero-dependency type surface
91
+ sal/eval/noop-sink.ts: noopSink — silent EvalSink used when eval disabled or no adapter configured
92
+ sal/eval/insforge-sink.ts: InsForgeEvalSink — PostgREST adapter, routes run_start→eval_runs INSERT (merge-duplicates) with legacy-schema fallback, writes turn_anchor/tool_trace/memory_recalls/run_end only after parent run confirmation, tool_trace→eval_tool_traces with PGRST204 fallback, memory_recalls→eval_memory_recalls batch INSERT, run_end→eval_runs PATCH; allowSelfSigned TLS option logs only in development runtime, batching with default 2000ms interval
93
+ sal/eval/jsonl-sink.ts: JsonlEvalSink — append-only filesystem adapter, one JSON object per line, accepts file:// URLs or plain paths, auto-creates parent dir, batched writes
94
+ sal/README.md: SAL extension usage, sidecar output layout, weights override, pluggability contract
95
+ team/index.ts: AgentTeam extension entry, /team <task>, /team:spawn/:preset/:send/:status/:progress/:psyche/:dashboard/:task/:mail/:allow-path/:stop/:terminate/:approve/:mode command registration and dispatch
96
+ team/team-ui.ts: AgentTeam message renderer, list/status/task formatting, dashboard visibility/timer ownership, realtime observer, speaker-stream emission helpers
97
+ team/team-types.ts: TeammateRole/TeammateMode/TeammateStatus/TeamTask/HarnessState/PsycheWeights/TeamUtterance/Handoff/LeaderPlan/AgentLiveView/TeammateIdentity/PersistedTeammate/TeamSpawnSpec/TeamSendResult types
98
+ team/team-state-store.ts: TeamStateStore class - durable teammate persistence via JSON files in <agentDir>/teams/
99
+ team/team-parser.ts: Team command parser - parseTeamCommand/buildTeamHelp for /team:* subcommands
100
+ team/team-runtime.ts: TeamRuntime class - teammate registry, stable internal labels plus visible teammate names, per-teammate send queue, lifecycle, durable tasks, mailbox + permission + transcript wiring
101
+ team/team-runtime-helpers.ts: TeamRuntime helper boundary - teammate prompt construction, harness turn preparation, live event projection, tool selection, path guards, label/role/text helpers
102
+ team/team-orchestrator.ts: Leader orchestration helpers - plan building, speaker utterance creation, @mention parsing, and handoff execution
103
+ team/team-task-store.ts: TeamTaskStore class - durable shared task list in <storageDir>/tasks.json
104
+ team/team-harness.ts: Harness protocol helpers - context files, phase instructions, checkpoint/revert, feature validation
105
+ team/team-presets.ts: Preset definitions and executor - solo/duo/squad spawning, model-assisted auto team selection, heuristic fallback
106
+ team/team-dashboard.ts: Text dashboard/status rendering - teammate workbench cards, current task, last utterance, progress bars, footer summary
107
+ team/team-psyche.ts: Psyche prompt layer - role/phase weighted Id/Ego/Superego prompt construction
108
+ team/team-permissions.ts: PermissionStore - pending permission request queue, approve/deny, path allowlists
109
+ team/team-mailbox.ts: TeamMailbox - typed JSONL-backed append-only message log for leader↔teammate and teammate↔teammate
110
+ team/team-transcript.ts: TeamTranscriptWriter - per-teammate JSONL transcripts
111
+ team/TESTING.md: Manual & smoke-test guide for Phase B AgentTeam
112
+
113
+ Rule: Members complete, one item per line, parent links valid, precise terms first
114
+
115
+ [COVENANT]: Update this file header on changes and verify against parent AGENT.md
@@ -1,17 +1,17 @@
1
- # extensions/builtin/browser/
2
-
3
- > P2 | Parent: ../AGENT.md
4
-
5
- Member List
6
- index.ts: Browser Harness extension entry, registers browser/browser_admin tools, /browser command, Browser Harness resource discovery for core/interaction/domain skills, project-local browser workspace seeding; loaded only through explicit extension config/CLI opt-in since P6/EV03
7
- browser.md: Browser Harness day-to-day skill instructions for NanoPencil tool use and workspace contribution
8
- install.md: Browser Harness setup and troubleshooting instructions, exposed as a skill resource
9
- src/browser_harness/: Vendored Browser Harness Python package, CDP daemon, IPC bridge, admin commands, and helper functions
10
- src/browser_harness/AGENT.md: P2 module map for the vendored Browser Harness Python package
11
- interaction-skills/: Reusable Browser Harness mechanics guides for tabs, screenshots, iframes, cookies, uploads, dialogs, scrolling, and related browser interactions
12
- agent-workspace/: Seed workspace copied to .nanopencil/browser-workspace for editable helpers and domain skills
13
- .env.example: Browser Harness environment variable template for Browser Use cloud integration
14
-
15
- Rule: Members complete, one item per line, parent links valid, precise terms first
16
-
17
- [COVENANT]: Update this file header on changes and verify against parent AGENT.md
1
+ # extensions/builtin/browser/
2
+
3
+ > P2 | Parent: ../AGENT.md
4
+
5
+ Member List
6
+ index.ts: Browser Harness extension entry, registers browser/browser_admin tools, /browser command, Browser Harness resource discovery for core/interaction/domain skills, project-local browser workspace seeding; loaded only through explicit extension config/CLI opt-in since P6/EV03
7
+ browser.md: Browser Harness day-to-day skill instructions for NanoPencil tool use and workspace contribution
8
+ install.md: Browser Harness setup and troubleshooting instructions, exposed as a skill resource
9
+ src/browser_harness/: Vendored Browser Harness Python package, CDP daemon, IPC bridge, admin commands, and helper functions
10
+ src/browser_harness/AGENT.md: P2 module map for the vendored Browser Harness Python package
11
+ interaction-skills/: Reusable Browser Harness mechanics guides for tabs, screenshots, iframes, cookies, uploads, dialogs, scrolling, and related browser interactions
12
+ agent-workspace/: Seed workspace copied to .nanopencil/browser-workspace for editable helpers and domain skills
13
+ .env.example: Browser Harness environment variable template for Browser Use cloud integration
14
+
15
+ Rule: Members complete, one item per line, parent links valid, precise terms first
16
+
17
+ [COVENANT]: Update this file header on changes and verify against parent AGENT.md
@@ -1,12 +1,12 @@
1
- """Agent-editable browser helpers.
2
-
3
- Add task-specific browser primitives here. Core helpers from browser_harness.helpers
4
- load this file when BH_AGENT_WORKSPACE points at this directory, or when this
5
- repo's default agent-workspace exists.
6
-
7
- [WHO]: Provides project-local extension points for reusable Browser Harness helper functions
8
- [FROM]: Depends on browser_harness.helpers importing this file through BH_AGENT_WORKSPACE
9
- [TO]: Consumed by browser snippets after NanoPencil seeds .nanopencil/browser-workspace
10
- [HERE]: extensions/defaults/browser/agent-workspace/agent_helpers.py seed copied into project browser workspace
11
- """
12
-
1
+ """Agent-editable browser helpers.
2
+
3
+ Add task-specific browser primitives here. Core helpers from browser_harness.helpers
4
+ load this file when BH_AGENT_WORKSPACE points at this directory, or when this
5
+ repo's default agent-workspace exists.
6
+
7
+ [WHO]: Provides project-local extension points for reusable Browser Harness helper functions
8
+ [FROM]: Depends on browser_harness.helpers importing this file through BH_AGENT_WORKSPACE
9
+ [TO]: Consumed by browser snippets after NanoPencil seeds .nanopencil/browser-workspace
10
+ [HERE]: extensions/defaults/browser/agent-workspace/agent_helpers.py seed copied into project browser workspace
11
+ """
12
+