nexakit 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (438) hide show
  1. package/.claude-plugin/marketplace.json +28 -0
  2. package/LICENSE +26 -0
  3. package/README.md +79 -2
  4. package/agents/claude/docs-researcher.md +9 -0
  5. package/agents/claude/implementation-tutor.md +9 -0
  6. package/agents/claude/project-explorer.md +9 -0
  7. package/agents/claude/quality-reviewer.md +9 -0
  8. package/agents/claude/requirements-analyst.md +9 -0
  9. package/agents/claude/solution-architect.md +9 -0
  10. package/agents/codex/docs-researcher.toml +10 -0
  11. package/agents/codex/implementation-tutor.toml +10 -0
  12. package/agents/codex/project-explorer.toml +10 -0
  13. package/agents/codex/quality-reviewer.toml +10 -0
  14. package/agents/codex/requirements-analyst.toml +11 -0
  15. package/agents/codex/solution-architect.toml +10 -0
  16. package/assets/brand/README.md +38 -0
  17. package/assets/brand/agent-toolkit-mark.png +0 -0
  18. package/assets/brand/agent-toolkit-mark.svg +13 -0
  19. package/assets/brand/agent-toolkit-tui-hero.png +0 -0
  20. package/assets/brand/nexakit-readme-hero.png +0 -0
  21. package/assets/brand/nexakit-readme-hero.svg +21 -0
  22. package/assets/runtime/package-lock.json +1425 -0
  23. package/bin/agent-task.js +14 -0
  24. package/bin/agent-toolkit-gemini.js +13 -0
  25. package/bin/agent-toolkit-inbox.js +14 -0
  26. package/bin/agent-toolkit-mcp.js +17 -0
  27. package/bin/agent-toolkit.js +13 -0
  28. package/bin/nexakit.js +13 -0
  29. package/bin/project-memory-mcp.js +22 -0
  30. package/bin/project-memory.js +7 -0
  31. package/catalogs/skills/api-design-principles/LICENSE.txt +21 -0
  32. package/catalogs/skills/api-design-principles/SKILL.md +110 -0
  33. package/catalogs/skills/api-design-principles/assets/api-design-checklist.md +155 -0
  34. package/catalogs/skills/api-design-principles/assets/rest-api-template.py +185 -0
  35. package/catalogs/skills/api-design-principles/references/details.md +413 -0
  36. package/catalogs/skills/api-design-principles/references/graphql-schema-design.md +589 -0
  37. package/catalogs/skills/api-design-principles/references/rest-best-practices.md +408 -0
  38. package/catalogs/skills/nodejs-backend-patterns/LICENSE.txt +21 -0
  39. package/catalogs/skills/nodejs-backend-patterns/SKILL.md +45 -0
  40. package/catalogs/skills/nodejs-backend-patterns/references/advanced-patterns.md +430 -0
  41. package/catalogs/skills/nodejs-backend-patterns/references/details.md +599 -0
  42. package/catalogs/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
  43. package/catalogs/skills/supabase-postgres-best-practices/LICENSE.txt +21 -0
  44. package/catalogs/skills/supabase-postgres-best-practices/SKILL.md +64 -0
  45. package/catalogs/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
  46. package/catalogs/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
  47. package/catalogs/skills/supabase-postgres-best-practices/references/_template.md +34 -0
  48. package/catalogs/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
  49. package/catalogs/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
  50. package/catalogs/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
  51. package/catalogs/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
  52. package/catalogs/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
  53. package/catalogs/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
  54. package/catalogs/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
  55. package/catalogs/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
  56. package/catalogs/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
  57. package/catalogs/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
  58. package/catalogs/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
  59. package/catalogs/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
  60. package/catalogs/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
  61. package/catalogs/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
  62. package/catalogs/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
  63. package/catalogs/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
  64. package/catalogs/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
  65. package/catalogs/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
  66. package/catalogs/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
  67. package/catalogs/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
  68. package/catalogs/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
  69. package/catalogs/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
  70. package/catalogs/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
  71. package/catalogs/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
  72. package/catalogs/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
  73. package/catalogs/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
  74. package/catalogs/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
  75. package/catalogs/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
  76. package/catalogs/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
  77. package/catalogs/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
  78. package/catalogs/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
  79. package/catalogs/skills/vercel-composition-patterns/AGENTS.md +946 -0
  80. package/catalogs/skills/vercel-composition-patterns/LICENSE.txt +27 -0
  81. package/catalogs/skills/vercel-composition-patterns/README.md +60 -0
  82. package/catalogs/skills/vercel-composition-patterns/SKILL.md +89 -0
  83. package/catalogs/skills/vercel-composition-patterns/metadata.json +11 -0
  84. package/catalogs/skills/vercel-composition-patterns/rules/_sections.md +29 -0
  85. package/catalogs/skills/vercel-composition-patterns/rules/_template.md +24 -0
  86. package/catalogs/skills/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
  87. package/catalogs/skills/vercel-composition-patterns/rules/architecture-compound-components.md +112 -0
  88. package/catalogs/skills/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -0
  89. package/catalogs/skills/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -0
  90. package/catalogs/skills/vercel-composition-patterns/rules/react19-no-forwardref.md +42 -0
  91. package/catalogs/skills/vercel-composition-patterns/rules/state-context-interface.md +191 -0
  92. package/catalogs/skills/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -0
  93. package/catalogs/skills/vercel-composition-patterns/rules/state-lift-state.md +125 -0
  94. package/catalogs/skills/vercel-react-best-practices/AGENTS.md +3810 -0
  95. package/catalogs/skills/vercel-react-best-practices/LICENSE.txt +27 -0
  96. package/catalogs/skills/vercel-react-best-practices/README.md +123 -0
  97. package/catalogs/skills/vercel-react-best-practices/SKILL.md +149 -0
  98. package/catalogs/skills/vercel-react-best-practices/metadata.json +15 -0
  99. package/catalogs/skills/vercel-react-best-practices/rules/_sections.md +46 -0
  100. package/catalogs/skills/vercel-react-best-practices/rules/_template.md +28 -0
  101. package/catalogs/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  102. package/catalogs/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  103. package/catalogs/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
  104. package/catalogs/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
  105. package/catalogs/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
  106. package/catalogs/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  107. package/catalogs/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
  108. package/catalogs/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
  109. package/catalogs/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
  110. package/catalogs/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
  111. package/catalogs/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
  112. package/catalogs/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
  113. package/catalogs/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
  114. package/catalogs/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
  115. package/catalogs/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  116. package/catalogs/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
  117. package/catalogs/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
  118. package/catalogs/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
  119. package/catalogs/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
  120. package/catalogs/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
  121. package/catalogs/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
  122. package/catalogs/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
  123. package/catalogs/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
  124. package/catalogs/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
  125. package/catalogs/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
  126. package/catalogs/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
  127. package/catalogs/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
  128. package/catalogs/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
  129. package/catalogs/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
  130. package/catalogs/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
  131. package/catalogs/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
  132. package/catalogs/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
  133. package/catalogs/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
  134. package/catalogs/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
  135. package/catalogs/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
  136. package/catalogs/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  137. package/catalogs/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
  138. package/catalogs/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
  139. package/catalogs/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  140. package/catalogs/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  141. package/catalogs/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  142. package/catalogs/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
  143. package/catalogs/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
  144. package/catalogs/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
  145. package/catalogs/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  146. package/catalogs/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
  147. package/catalogs/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
  148. package/catalogs/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  149. package/catalogs/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
  150. package/catalogs/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
  151. package/catalogs/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  152. package/catalogs/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  153. package/catalogs/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
  154. package/catalogs/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  155. package/catalogs/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
  156. package/catalogs/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  157. package/catalogs/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  158. package/catalogs/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
  159. package/catalogs/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  160. package/catalogs/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  161. package/catalogs/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
  162. package/catalogs/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
  163. package/catalogs/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
  164. package/catalogs/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
  165. package/catalogs/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
  166. package/catalogs/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
  167. package/catalogs/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
  168. package/catalogs/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
  169. package/catalogs/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  170. package/catalogs/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
  171. package/catalogs/skills/webapp-testing/LICENSE.txt +202 -0
  172. package/catalogs/skills/webapp-testing/SKILL.md +96 -0
  173. package/catalogs/skills/webapp-testing/examples/console_logging.py +35 -0
  174. package/catalogs/skills/webapp-testing/examples/element_discovery.py +40 -0
  175. package/catalogs/skills/webapp-testing/examples/static_html_automation.py +33 -0
  176. package/catalogs/skills/webapp-testing/scripts/with_server.py +106 -0
  177. package/catalogs/skills.json +1115 -0
  178. package/docs/skills/evidencias/2026-10-28-evaluacion-inicial-mcp-seguridad.md +118 -0
  179. package/docs/skills/evidencias/2026-10-28-incorporacion-mcp-seguridad.json +152 -0
  180. package/docs/skills/evidencias/2026-10-28-recomendador-preparacion.md +50 -0
  181. package/package.json +73 -4
  182. package/plugins/nexakit-modelo/.claude-plugin/plugin.json +1 -0
  183. package/plugins/nexakit-modelo/hooks/hooks.json +1 -0
  184. package/plugins/nexakit-modelo/hooks/register.js +48 -0
  185. package/plugins/nexakit-modelo/hooks/status.js +8 -0
  186. package/plugins/nexakit-modelo/tests/register.test.ts +21 -0
  187. package/plugins/nexakit-panel/.claude-plugin/plugin.json +1 -0
  188. package/plugins/nexakit-panel/README.md +20 -0
  189. package/plugins/nexakit-panel/hooks/hooks.json +1 -0
  190. package/plugins/nexakit-panel/hooks/lienzo.js +382 -0
  191. package/plugins/nexakit-panel/hooks/panel.js +279 -0
  192. package/plugins/nexakit-panel/hooks/register.tsx +248 -0
  193. package/plugins/nexakit-panel/tests/lienzo.test.ts +142 -0
  194. package/plugins/nexakit-panel/tests/panel.test.ts +240 -0
  195. package/plugins/nexakit-panel/tests/register.test.ts +167 -0
  196. package/plugins/nexakit-panel/types/index.d.ts +41 -0
  197. package/plugins/nexakit-sesion/.claude-plugin/plugin.json +1 -0
  198. package/plugins/nexakit-sesion/README.md +12 -0
  199. package/plugins/nexakit-sesion/hooks/aviso.js +38 -0
  200. package/plugins/nexakit-sesion/hooks/hooks.json +1 -0
  201. package/plugins/nexakit-sesion/hooks/register.js +28 -0
  202. package/plugins/nexakit-sesion/tests/register.test.ts +96 -0
  203. package/plugins/niveles/.claude-plugin/plugin.json +5 -0
  204. package/plugins/niveles/agents/nivel-alto.md +13 -0
  205. package/plugins/niveles/agents/nivel-exigente.md +13 -0
  206. package/plugins/niveles/agents/nivel-ligero.md +13 -0
  207. package/plugins/niveles/agents/nivel-normal.md +13 -0
  208. package/schemas/agent-client-adapter.schema.json +786 -0
  209. package/schemas/agent-client-auth-diagnostic.schema.json +801 -0
  210. package/schemas/agent-client-isolated-variant.schema.json +105 -0
  211. package/schemas/agent-client-isolated-verification.schema.json +99 -0
  212. package/schemas/agent-client-managed-preferences-invocation.schema.json +67 -0
  213. package/schemas/agent-client-managed-preferences.schema.json +63 -0
  214. package/schemas/agent-client-native-diagnostics.schema.json +85 -0
  215. package/schemas/agent-client-native-evaluation.schema.json +171 -0
  216. package/schemas/agent-client-native-preflight.schema.json +90 -0
  217. package/schemas/agent-client-output.schema.json +551 -0
  218. package/schemas/agent-client-runtime-fixture.schema.json +90 -0
  219. package/schemas/agent-client-runtime-local.schema.json +95 -0
  220. package/schemas/agent-client-runtime.schema.json +1288 -0
  221. package/schemas/agent-client-selective-config.schema.json +77 -0
  222. package/schemas/agent-client-supervised-local.schema.json +135 -0
  223. package/schemas/agent-client-supervised.schema.json +186 -0
  224. package/schemas/agent-model-preference.schema.json +573 -0
  225. package/schemas/agent-model-selection.schema.json +311 -0
  226. package/schemas/agent-task-approvals.schema.json +362 -0
  227. package/schemas/agent-task-prepare.schema.json +1324 -0
  228. package/schemas/agent-task-verify.schema.json +198 -0
  229. package/schemas/project-memory-update.schema.json +33 -0
  230. package/schemas/project-memory.schema.json +298 -0
  231. package/schemas/skill-catalog.schema.json +246 -0
  232. package/schemas/task-workflow-plan-output.schema.json +35 -0
  233. package/scripts/prepare-package.js +6 -0
  234. package/scripts/validate-skill-catalog.js +41 -0
  235. package/skills/cerrar-avisens/SKILL.md +12 -0
  236. package/skills/cerrar-memoria/SKILL.md +96 -0
  237. package/skills/cerrar-memoria/references/cierre.md +76 -0
  238. package/skills/decision-records/SKILL.md +27 -0
  239. package/skills/decision-records/agents/openai.yaml +7 -0
  240. package/skills/decision-records/references/adr-template.md +35 -0
  241. package/skills/differential-review/LICENSE.txt +427 -0
  242. package/skills/differential-review/SKILL.md +225 -0
  243. package/skills/differential-review/adversarial.md +203 -0
  244. package/skills/differential-review/agents/openai.yaml +6 -0
  245. package/skills/differential-review/assets/trail-of-bits-mark.svg +1 -0
  246. package/skills/differential-review/methodology.md +234 -0
  247. package/skills/differential-review/patterns.md +300 -0
  248. package/skills/differential-review/reporting.md +369 -0
  249. package/skills/elegir-modelo/SKILL.md +68 -0
  250. package/skills/elegir-modelo/modelos.mjs +108 -0
  251. package/skills/frontend-design/LICENSE.txt +177 -0
  252. package/skills/frontend-design/SKILL.md +71 -0
  253. package/skills/gemini/SKILL.md +52 -0
  254. package/skills/imagen/SKILL.md +12 -0
  255. package/skills/investigar/SKILL.md +11 -0
  256. package/skills/mcp-builder/LICENSE.txt +202 -0
  257. package/skills/mcp-builder/SKILL.md +236 -0
  258. package/skills/mcp-builder/reference/evaluation.md +602 -0
  259. package/skills/mcp-builder/reference/mcp_best_practices.md +249 -0
  260. package/skills/mcp-builder/reference/node_mcp_server.md +970 -0
  261. package/skills/mcp-builder/reference/python_mcp_server.md +719 -0
  262. package/skills/mcp-builder/scripts/connections.py +151 -0
  263. package/skills/mcp-builder/scripts/evaluation.py +373 -0
  264. package/skills/mcp-builder/scripts/example_evaluation.xml +22 -0
  265. package/skills/mcp-builder/scripts/requirements.txt +2 -0
  266. package/skills/ordenar-proyecto/SKILL.md +56 -0
  267. package/skills/project-handoff/SKILL.md +53 -0
  268. package/skills/project-handoff/agents/openai.yaml +7 -0
  269. package/skills/project-handoff/references/handoff-template.md +35 -0
  270. package/skills/quality-gate/LICENSE.txt +26 -0
  271. package/skills/quality-gate/SKILL.md +44 -0
  272. package/skills/quality-gate/agents/openai.yaml +7 -0
  273. package/skills/quality-gate/references/review-checklist.md +42 -0
  274. package/skills/revisar/SKILL.md +11 -0
  275. package/skills/revisar-skill/LICENSE-find-skills.txt +26 -0
  276. package/skills/revisar-skill/SKILL.md +94 -0
  277. package/skills/revision-cruzada/SKILL.md +59 -0
  278. package/skills/web-design-guidelines/AGENTS.md +156 -0
  279. package/skills/web-design-guidelines/LICENSE.txt +21 -0
  280. package/skills/web-design-guidelines/SKILL.md +29 -0
  281. package/src/agent-models.js +131 -0
  282. package/src/brand.js +117 -0
  283. package/src/claude-code-runner.js +642 -0
  284. package/src/cli-executable.js +88 -0
  285. package/src/cli.js +778 -0
  286. package/src/client-adapter-plan.js +271 -0
  287. package/src/client-auth-diagnostic-parser.js +211 -0
  288. package/src/client-auth-diagnostic.js +257 -0
  289. package/src/client-isolated-variant.js +106 -0
  290. package/src/client-isolated-verification.js +130 -0
  291. package/src/client-local-platform.js +14 -0
  292. package/src/client-managed-preferences-invocation.js +209 -0
  293. package/src/client-managed-preferences.js +78 -0
  294. package/src/client-native-access.js +134 -0
  295. package/src/client-native-diagnostics.js +253 -0
  296. package/src/client-native-evaluation.js +106 -0
  297. package/src/client-native-preflight-files.js +68 -0
  298. package/src/client-native-preflight.js +95 -0
  299. package/src/client-output-json.js +118 -0
  300. package/src/client-output-parser.js +278 -0
  301. package/src/client-runtime-admission.js +80 -0
  302. package/src/client-runtime-coordinator.js +70 -0
  303. package/src/client-runtime-core.js +92 -0
  304. package/src/client-runtime-fixture-permit.js +20 -0
  305. package/src/client-runtime-fixture-protocol.js +39 -0
  306. package/src/client-runtime-state.js +67 -0
  307. package/src/client-runtime-store-files.js +91 -0
  308. package/src/client-runtime-store.js +239 -0
  309. package/src/client-runtime-supervisor.js +146 -0
  310. package/src/client-selective-config.js +195 -0
  311. package/src/client-selective-files.js +126 -0
  312. package/src/client-supervised-codes.js +32 -0
  313. package/src/client-supervised-contract.js +52 -0
  314. package/src/client-supervised-coordinator.js +36 -0
  315. package/src/client-supervised-permit.js +20 -0
  316. package/src/client-supervised-protocol.js +37 -0
  317. package/src/client-supervised-store.js +167 -0
  318. package/src/client-supervised-supervisor.js +167 -0
  319. package/src/client-supervised.js +160 -0
  320. package/src/codex-cli-runner.js +358 -0
  321. package/src/codex-delivery.js +101 -0
  322. package/src/connect.js +703 -0
  323. package/src/doctor.js +795 -0
  324. package/src/gemini-cli.js +76 -0
  325. package/src/gemini-files.js +45 -0
  326. package/src/gemini-tools.js +249 -0
  327. package/src/init.js +473 -0
  328. package/src/install-lock.js +127 -0
  329. package/src/install-registry.js +61 -0
  330. package/src/legacy-repair.js +71 -0
  331. package/src/level-agents.js +111 -0
  332. package/src/link-states.js +172 -0
  333. package/src/memory-connection-artifacts.js +192 -0
  334. package/src/memory-connection-descriptor.js +158 -0
  335. package/src/memory-connection-diagnostic.js +177 -0
  336. package/src/memory-connection-files.js +191 -0
  337. package/src/memory-connection-manifest.js +118 -0
  338. package/src/memory-connection-package.js +176 -0
  339. package/src/memory-connection-plan.js +211 -0
  340. package/src/memory-connection-skill.js +211 -0
  341. package/src/memory-connection-toml.js +153 -0
  342. package/src/memory-locator.js +118 -0
  343. package/src/memory-mcp-policy.js +181 -0
  344. package/src/memory-mcp-server.js +166 -0
  345. package/src/memory-mcp-transport.js +59 -0
  346. package/src/missing-dependencies.js +21 -0
  347. package/src/model-command.js +147 -0
  348. package/src/model-preference.js +235 -0
  349. package/src/model-selection.js +368 -0
  350. package/src/native/managed-preferences.c +100 -0
  351. package/src/native/managed-preferences.h +17 -0
  352. package/src/package-lock-path.js +13 -0
  353. package/src/panel-cli.js +182 -0
  354. package/src/peer-handoff.js +27 -0
  355. package/src/peer-inbox-cli.js +211 -0
  356. package/src/peer-review-mcp.js +210 -0
  357. package/src/peer-review-store.js +532 -0
  358. package/src/platform.js +24 -0
  359. package/src/project-root.js +41 -0
  360. package/src/project-signals.js +339 -0
  361. package/src/recommend-report.js +77 -0
  362. package/src/review-instructions.js +211 -0
  363. package/src/review-policy.js +35 -0
  364. package/src/revision-adapters.js +157 -0
  365. package/src/revision-context.js +86 -0
  366. package/src/revision-isolation.js +222 -0
  367. package/src/revision-process.js +103 -0
  368. package/src/revision-provenance.js +89 -0
  369. package/src/revision-snapshot.js +120 -0
  370. package/src/revision.js +242 -0
  371. package/src/runtime-fixtures/runtime-supervisor/child.cjs +3 -0
  372. package/src/runtime-fixtures/runtime-supervisor/fixture.cjs +49 -0
  373. package/src/runtime-fixtures/supervised/child.cjs +3 -0
  374. package/src/runtime-fixtures/supervised/fixture.cjs +47 -0
  375. package/src/sensitive-data.js +21 -0
  376. package/src/setup-apply.js +231 -0
  377. package/src/setup-plan.js +231 -0
  378. package/src/setup-state.js +277 -0
  379. package/src/setup-tui.js +555 -0
  380. package/src/skill-catalog-add.js +91 -0
  381. package/src/skill-catalog-audit.js +68 -0
  382. package/src/skill-catalog.js +170 -0
  383. package/src/skill-files.js +39 -0
  384. package/src/skill-recommendations.js +1673 -0
  385. package/src/skill-scan-report.js +14 -0
  386. package/src/skill-scan.js +178 -0
  387. package/src/stable-command.js +53 -0
  388. package/src/stable-install.js +222 -0
  389. package/src/status.js +200 -0
  390. package/src/superpowers.js +133 -0
  391. package/src/sync-apply.js +227 -0
  392. package/src/sync-files.js +109 -0
  393. package/src/sync-inspect.js +394 -0
  394. package/src/sync-ledger.js +94 -0
  395. package/src/sync-markdown.js +151 -0
  396. package/src/sync-proposal.js +84 -0
  397. package/src/sync-record.js +459 -0
  398. package/src/sync.js +360 -0
  399. package/src/task-approvals.js +367 -0
  400. package/src/task-cli.js +79 -0
  401. package/src/task-external-verifier.js +584 -0
  402. package/src/task-prepare-files.js +115 -0
  403. package/src/task-prepare.js +180 -0
  404. package/src/task-verify-cli.js +67 -0
  405. package/src/task-verify-files.js +188 -0
  406. package/src/task-verify.js +118 -0
  407. package/src/task-workflow-mcp.js +544 -0
  408. package/src/task-workflow-store.js +254 -0
  409. package/src/terminal-text.js +68 -0
  410. package/src/toolkit-cli.js +543 -0
  411. package/src/toolkit-commands-guide.js +107 -0
  412. package/src/toolkit-setup.js +614 -0
  413. package/src/usage-metrics.js +43 -0
  414. package/templates/agent-team/01-encargo.md +158 -0
  415. package/templates/agent-team/02-propuesta.md +132 -0
  416. package/templates/agent-team/03-revision.md +150 -0
  417. package/templates/agent-team/README.md +213 -0
  418. package/templates/model-inventory/01-inventario.md +154 -0
  419. package/templates/model-inventory/README.md +115 -0
  420. package/templates/project-memory/README.md +67 -0
  421. package/templates/project-memory/project-memory.example.json +53 -0
  422. package/templates/project-memory/skill/project-id/SKILL.md +37 -0
  423. package/templates/project-memory/skill/project-id/references/project-profile.md +44 -0
  424. package/templates/project-memory/vault/00-INICIO/Estado actual.md +44 -0
  425. package/templates/project-memory/vault/00-INICIO/Fuentes de verdad.md +30 -0
  426. package/templates/project-memory/vault/00-INICIO/Inicio del proyecto.md +44 -0
  427. package/templates/project-memory/vault/00-INICIO/Mantenimiento de la memoria.md +26 -0
  428. package/templates/project-memory/vault/00-INICIO/Mapa de la memoria.md +33 -0
  429. package/templates/project-memory/vault/00-INICIO/Registro de sincronizaci/303/263n.md" +28 -0
  430. package/templates/project-memory/vault/01-PRODUCTO/Producto.md +16 -0
  431. package/templates/project-memory/vault/02-ARQUITECTURA/Arquitectura.md +16 -0
  432. package/templates/project-memory/vault/03-IMPLEMENTACION/Implementaci/303/263n.md +15 -0
  433. package/templates/project-memory/vault/04-DECISIONES/Decisiones.md +19 -0
  434. package/templates/project-memory/vault/05-ENTREGAS/Entregas.md +12 -0
  435. package/templates/project-memory/vault/06-OPERACION/Operaci/303/263n.md +15 -0
  436. package/templates/project-memory/vault/07-AGENTES/Protocolo de agentes.md +33 -0
  437. package/templates/project-memory/vault/08-RECURSOS/Recursos.md +12 -0
  438. package/templates/project-memory/vault/09-ARCHIVO/README.md +5 -0
@@ -0,0 +1,209 @@
1
+ import { supportsPreferenceHost } from "./client-local-platform.js";
2
+ import fs from "node:fs/promises";
3
+ import { constants } from "node:fs";
4
+ import path from "node:path";
5
+ import { spawn as systemSpawn } from "node:child_process";
6
+ import { createHash } from "node:crypto";
7
+ import { types } from "node:util";
8
+ import Ajv2020 from "ajv/dist/2020.js";
9
+ import { copyInertJson, copyBytes } from "./client-output-json.js";
10
+ import { hash } from "./client-runtime-core.js";
11
+ import { createStoreFiles } from "./client-runtime-store-files.js";
12
+ import { createManagedPreferencesStreamReader } from "./client-managed-preferences.js";
13
+
14
+ export const INVOCATION_SCHEMA_ID = "https://agent-toolkit.local/schemas/agent-client-managed-preferences-invocation.schema.json";
15
+ const permits = new WeakMap(), monotonic = () => Number(process.hrtime.bigint() / 1000000n);
16
+ const environmentIdentity = () => hash({ home: process.env.HOME, uid: process.getuid?.() ?? null, profile: "preferences-minimal-v1" });
17
+ const physicalName = p => typeof p === "string" && path.isAbsolute(p) && path.normalize(p) === p &&
18
+ !/[\x00-\x1f\x7f]/.test(p) && Buffer.from(p, "utf8").toString("utf8") === p;
19
+ const signature = s => JSON.stringify([s.dev, s.ino, s.uid, s.mode, s.nlink, s.size, s.mtimeMs, s.ctimeMs]);
20
+ const chunkLength = b => {
21
+ if (types.isProxy(b) || !types.isUint8Array(b)) throw Error("chunk");
22
+ return Object.getOwnPropertyDescriptor(Object.getPrototypeOf(Uint8Array.prototype), "length").get.call(b);
23
+ };
24
+
25
+ /** Trusted orchestration must obtain human approval first. JSON/hash is not consent. */
26
+ export function createManagedPreferencesInvocationPermit(configuration) {
27
+ let cfg;
28
+ try {
29
+ cfg = copyInertJson(configuration);
30
+ if (!Number.isSafeInteger(cfg.limits.permitLifetimeMs) || cfg.limits.permitLifetimeMs < 1 || cfg.limits.permitLifetimeMs > 3600000) throw Error();
31
+ } catch { throw Error("Invalid helper permission configuration"); }
32
+ const handle = Object.freeze(Object.create(null)), issuedAt = monotonic();
33
+ permits.set(handle, { binding: hash(cfg), environment: environmentIdentity(), issuedAt, expiresAt: issuedAt + cfg.limits.permitLifetimeMs, live: true, used: false });
34
+ return handle;
35
+ }
36
+ export function revokeManagedPreferencesInvocationPermit(handle) {
37
+ if (types.isProxy(handle)) return;
38
+ const p = permits.get(handle); if (p) p.live = false;
39
+ }
40
+
41
+ async function verifyArtifact(pin, io, files, deadline, now) {
42
+ await files.physical(pin.path);
43
+ const before = await io.lstat(pin.path);
44
+ if (!before.isFile() || before.isSymbolicLink() || before.nlink !== 1 || before.dev !== pin.dev || before.ino !== pin.ino ||
45
+ before.uid !== pin.uid || (before.mode & 4095) !== pin.mode || !(pin.mode & 0o100) || pin.mode & 0o022 || before.size !== pin.size ||
46
+ before.mtimeMs !== pin.mtimeMs || before.ctimeMs !== pin.ctimeMs) throw Error("artifact");
47
+ const handle = await io.open(pin.path, constants.O_RDONLY | constants.O_NOFOLLOW), digest = createHash("sha256");
48
+ try {
49
+ if (signature(before) !== signature(await handle.stat())) throw Error("artifact");
50
+ const buffer = Buffer.alloc(65536); let offset = 0;
51
+ while (offset < pin.size) {
52
+ if (now() >= deadline) throw Error("deadline");
53
+ const length = Math.min(buffer.length, pin.size - offset, 8388608 - offset);
54
+ const { bytesRead } = await handle.read(buffer, 0, length, offset); if (!bytesRead) throw Error("artifact");
55
+ offset += bytesRead; if (offset > pin.size || offset > 8388608) throw Error("artifact"); digest.update(buffer.subarray(0, bytesRead));
56
+ }
57
+ if (offset !== pin.size || digest.digest("hex") !== pin.sha256 || signature(before) !== signature(await handle.stat()) ||
58
+ signature(before) !== signature(await io.lstat(pin.path))) throw Error("artifact");
59
+ await files.physical(pin.path);
60
+ } finally { await handle.close(); }
61
+ }
62
+
63
+ /** A single approved helper, not an AI client launcher or an isolation certificate. */
64
+ export function createManagedPreferencesInvocation(schema, preferencesSchema, configuration, authorization, dependencies = {}) {
65
+ let cfg, validReport, prefSchema;
66
+ try {
67
+ cfg = copyInertJson(configuration);
68
+ const s = copyInertJson(schema), ps = copyInertJson(preferencesSchema); prefSchema = ps;
69
+ if (s.$id !== INVOCATION_SCHEMA_ID || ps.$id !== "https://agent-toolkit.local/schemas/agent-client-managed-preferences.schema.json") throw Error();
70
+ const ajv = new Ajv2020({ strict: true, allErrors: true }); ajv.addSchema(ps); ajv.addSchema(s);
71
+ const valid = ajv.compile({ $ref: `${INVOCATION_SCHEMA_ID}#/$defs/configuration` });
72
+ if (!valid(cfg) || !physicalName(cfg.artifact.path) || !physicalName(cfg.workspaceParent.path) ||
73
+ cfg.limits.graceMs + cfg.limits.confirmationMs + 20 >= cfg.limits.totalTimeoutMs) throw Error();
74
+ createManagedPreferencesStreamReader(ps, cfg.expectedSource); // Validate the decoder contract before IO.
75
+ validReport = ajv.compile({ $ref: `${INVOCATION_SCHEMA_ID}#/$defs/report` });
76
+ } catch { throw Error("Invalid managed-preferences invocation configuration"); }
77
+ const limits = cfg.limits, io = { ...fs, ...dependencies.io }, files = createStoreFiles(dependencies.io);
78
+ const spawn = dependencies.spawn ?? systemSpawn, kill = dependencies.kill ?? process.kill.bind(process), now = dependencies.monotonic ?? monotonic;
79
+ let invoked = false;
80
+ return Object.freeze({ async run(...args) {
81
+ const began = now(), deadline = began + limits.totalTimeoutMs;
82
+ const r = { scope: "managed-preferences-helper-only", state: "blocked", decision: "no-client-start", spawnAttempts: 0,
83
+ helperStarted: false, helperExecutionVerified: false, artifactMatchedBefore: false, artifactMatchedAfter: false,
84
+ terminationConfirmed: true, cleanupRequired: false, stdoutBytes: 0, stderrBytes: 0, elapsedMs: 0, projection: null, reasons: [],
85
+ nativeClientStarted: false, inferenceRequested: false, runtimeReady: false, verifiedAdmission: false,
86
+ effectiveIsolationVerified: false, externalBillingVerified: false, preferencesQueriedVerified: false };
87
+ let workspace, owned, parent, permission, claimed = false;
88
+ const add = code => { if (!r.reasons.includes(code)) r.reasons.push(code); };
89
+ try {
90
+ if (invoked) throw Error("permission"); invoked = true;
91
+ permission = !types.isProxy(authorization) && permits.get(authorization);
92
+ if (!permission || !permission.live || permission.used || permission.binding !== hash(cfg) ||
93
+ permission.environment !== environmentIdentity() ||
94
+ began < permission.issuedAt || began >= permission.expiresAt) { add("helper-permission-rejected"); return r; }
95
+ permission.used = true; claimed = true;
96
+ if (args.length) { add("helper-input-forbidden"); return r; }
97
+ if (!supportsPreferenceHost(process.platform, cfg.expectedSource) || cfg.artifact.uid !== process.getuid() || cfg.workspaceParent.uid !== process.getuid()) throw Error("identity");
98
+ if (dependencies.signal?.aborted) { r.state = "canceled"; add("helper-canceled"); return r; }
99
+ const home = process.env.HOME;
100
+ if (!physicalName(home) || /(CloudStorage|Mobile Documents|Dropbox|OneDrive|iCloud)/i.test(cfg.workspaceParent.path)) throw Error("parent");
101
+ parent = await files.directory(cfg.workspaceParent.path);
102
+ if (parent.dev !== cfg.workspaceParent.dev || parent.ino !== cfg.workspaceParent.ino || parent.uid !== cfg.workspaceParent.uid ||
103
+ (parent.mode & 4095) !== cfg.workspaceParent.mode) throw Error("parent");
104
+ for (let dir = cfg.workspaceParent.path; ; dir = path.dirname(dir)) {
105
+ try { await io.lstat(path.join(dir, ".git")); throw Error("git"); } catch (e) { if (e.code !== "ENOENT") throw e; }
106
+ if (dir === path.parse(dir).root) break;
107
+ }
108
+ await verifyArtifact(cfg.artifact, io, files, deadline, now); r.artifactMatchedBefore = true;
109
+ workspace = await io.mkdtemp(path.join(cfg.workspaceParent.path, "preferences-work-")); await io.chmod(workspace, 0o700); owned = await files.directory(workspace);
110
+ if (!permission.live || dependencies.signal?.aborted || now() >= Math.min(deadline, permission.expiresAt) - limits.graceMs - limits.confirmationMs) throw Error("pre-start");
111
+ const stream = createManagedPreferencesStreamReader(prefSchema, cfg.expectedSource);
112
+ const env = { HOME: home, TMPDIR: workspace, PATH: "/usr/bin:/bin", LANG: "C", LC_ALL: "C" };
113
+ r.spawnAttempts = 1; r.terminationConfirmed = false;
114
+ let child;
115
+ try { child = spawn(cfg.artifact.path, [], { shell: false, detached: true, cwd: workspace, env, stdio: ["ignore", "pipe", "pipe"] }); }
116
+ catch { r.terminationConfirmed = true; add("helper-spawn-failed"); throw Error("spawn"); }
117
+ await new Promise(resolve => {
118
+ let done = false, stopped = false, stoppedAt = null, forced = false, gone = false, failedSpawn = false, pid = null;
119
+ let exited = false, closed = false, outClosed = false, errClosed = false, exitCode = null, timer, hard;
120
+ const send = signal => {
121
+ if (pid === null || gone) return;
122
+ try { kill(-pid, signal); } catch (e) { if (e.code === "ESRCH") gone = true; else add("helper-signal-unconfirmed"); }
123
+ };
124
+ const alive = () => {
125
+ if (gone || failedSpawn) return false;
126
+ if (pid === null) return true;
127
+ try { kill(-pid, 0); return true; } catch (e) { if (e.code === "ESRCH") { gone = true; return false; } add("helper-group-unconfirmed"); return true; }
128
+ };
129
+ const stop = (code, state = "failed", decoderCode = "preferences-transport-error") => {
130
+ if (done) return; add(code);
131
+ if (stopped) return;
132
+ stopped = true; stoppedAt = now(); r.state = state; stream.abort(decoderCode); send("SIGTERM");
133
+ };
134
+ const finish = uncertain => {
135
+ if (done) return; done = true; clearInterval(timer); clearTimeout(hard); dependencies.signal?.removeEventListener("abort", abort);
136
+ r.terminationConfirmed = failedSpawn || exited && closed && outClosed && errClosed && gone;
137
+ if (uncertain || !r.terminationConfirmed || now() > deadline) { r.state = "indeterminate"; add("helper-termination-unconfirmed"); stream.abort("preferences-transport-unconfirmed"); }
138
+ else if (failedSpawn) r.state = "failed";
139
+ else if (!stopped) {
140
+ const projection = stream.finish(exitCode);
141
+ if (projection.state === "invalid") { r.state = "failed"; add("helper-protocol-invalid"); }
142
+ else { r.projection = projection; r.state = projection.state === "helper-failed" ? "helper-failed" : "completed"; }
143
+ }
144
+ if (stopped || uncertain || failedSpawn) stream.finish(null);
145
+ child.stdout.destroy(); child.stderr.destroy(); resolve();
146
+ };
147
+ const poll = () => {
148
+ if (done) return;
149
+ if (!permission.live || now() >= permission.expiresAt) stop("helper-permission-revoked", "canceled");
150
+ if (now() >= deadline - limits.graceMs - limits.confirmationMs && !stopped) stop("helper-deadline", "timed-out", "preferences-transport-timeout");
151
+ if (stopped && !forced && now() - stoppedAt >= limits.graceMs) { forced = true; send("SIGKILL"); }
152
+ const live = alive();
153
+ if (exited && closed && outClosed && errClosed && !live) finish(false);
154
+ else if (exited && live && !stopped) stop("helper-descendants-unconfirmed");
155
+ if (failedSpawn && closed) finish(false);
156
+ if (!done && stopped && forced && now() - stoppedAt >= limits.graceMs + limits.confirmationMs) finish(true);
157
+ };
158
+ const abort = () => stop("helper-canceled", "canceled");
159
+ child.on("spawn", () => {
160
+ if (!Number.isSafeInteger(child.pid) || child.pid <= 1) { stop("helper-pid-unavailable"); return; }
161
+ pid = child.pid;
162
+ if (done) { send("SIGKILL"); return; }
163
+ r.helperStarted = true; if (stopped) send("SIGTERM");
164
+ });
165
+ child.on("error", () => { if (done) return; if (!r.helperStarted) { failedSpawn = true; add("helper-spawn-failed"); } else stop("helper-process-error"); });
166
+ child.on("exit", code => { exited = true; exitCode = code; poll(); }); child.on("close", () => { closed = true; poll(); });
167
+ child.stdout.on("close", () => { outClosed = true; poll(); }); child.stderr.on("close", () => { errClosed = true; poll(); });
168
+ child.stdout.on("error", () => stop("helper-stream-error")); child.stderr.on("error", () => stop("helper-stream-error"));
169
+ child.stdout.on("data", chunk => {
170
+ if (done || stopped) return;
171
+ try {
172
+ r.stdoutBytes += chunkLength(chunk);
173
+ if (r.stdoutBytes > limits.maxOutputBytes) stop("helper-output-limit", "failed", "preferences-transport-overflow");
174
+ else if (!stream.push(copyBytes(chunk, limits.maxOutputBytes))) stop("helper-output-invalid");
175
+ } catch { stop("helper-output-invalid"); }
176
+ });
177
+ child.stderr.on("data", chunk => {
178
+ if (done || stopped) return;
179
+ try { const size = chunkLength(chunk); r.stderrBytes += size; if (size) stop(r.stderrBytes > limits.maxErrorBytes ? "helper-stderr-limit" : "helper-stderr-not-empty"); }
180
+ catch { stop("helper-stderr-invalid"); }
181
+ });
182
+ dependencies.signal?.addEventListener("abort", abort, { once: true }); if (dependencies.signal?.aborted) abort();
183
+ timer = setInterval(poll, 10);
184
+ hard = setTimeout(() => { send("SIGKILL"); poll(); if (!done) finish(true); }, Math.max(1, deadline - now()));
185
+ });
186
+ if (r.state === "completed" || r.state === "helper-failed") {
187
+ await verifyArtifact(cfg.artifact, io, files, deadline, now); r.artifactMatchedAfter = true;
188
+ if (!permission.live || now() >= permission.expiresAt) throw Error("revoked");
189
+ r.helperExecutionVerified = true;
190
+ }
191
+ } catch {
192
+ r.state = r.helperStarted ? "indeterminate" : r.spawnAttempts ? "failed" : "blocked";
193
+ r.projection = null; r.helperExecutionVerified = false; add("helper-local-check-failed");
194
+ } finally {
195
+ if (claimed) revokeManagedPreferencesInvocationPermit(authorization);
196
+ if (workspace) {
197
+ if (r.terminationConfirmed) try { await files.directory(cfg.workspaceParent.path, parent); await files.directory(workspace, owned); await io.rmdir(workspace); }
198
+ catch { r.state = "indeterminate"; r.cleanupRequired = true; add("helper-workspace-cleanup-required"); }
199
+ else { r.cleanupRequired = true; add("helper-workspace-retained"); }
200
+ }
201
+ r.elapsedMs = Math.max(0, Math.ceil(now() - began));
202
+ if (r.elapsedMs > limits.totalTimeoutMs) { r.state = "indeterminate"; add("helper-deadline"); }
203
+ if (!["completed", "helper-failed"].includes(r.state)) { r.projection = null; r.helperExecutionVerified = false; }
204
+ if (!r.reasons.length) add(r.state === "completed" ? "helper-completed" : "helper-failed");
205
+ r.reasons.sort(); if (!validReport(r)) throw Error("Managed-preferences invocation report invariant failed");
206
+ }
207
+ return r;
208
+ } });
209
+ }
@@ -0,0 +1,78 @@
1
+ import Ajv2020 from "ajv/dist/2020.js";
2
+ import { types } from "node:util";
3
+ import { copyInertJson, copyBytes, decode, parseEventJson, fail } from "./client-output-json.js";
4
+
5
+ export const PREFERENCES_SCHEMA_ID = "https://agent-toolkit.local/schemas/agent-client-managed-preferences.schema.json";
6
+ export const PREFERENCE_KEYS = Object.freeze(["hooks", "policyHelper", "apiKeyHelper", "env", "managedMcpServers", "disableAllHooks"]);
7
+ const transportReasons = Object.freeze(["preferences-transport-timeout", "preferences-transport-overflow", "preferences-transport-unconfirmed", "preferences-transport-changed-artifact", "preferences-transport-error"]);
8
+ function strictJson(input) {
9
+ if (types.isProxy(input)) fail("preferences-invalid-output");
10
+ const d = typeof input === "string" || types.isUint8Array(input)
11
+ ? parseEventJson(decode(copyBytes(input, 32768))) : copyInertJson(input);
12
+ return copyInertJson(parseEventJson(decode(copyBytes(JSON.stringify(d), 32768))));
13
+ }
14
+ const report = reason => ({ scope: "partial-preference-observation", state: "invalid", decision: "no-native-start",
15
+ sourceClaim: null, fields: [], reasons: [reason], helperExecutionVerified: false, preferencesQueriedVerified: false,
16
+ runtimeReady: false, verifiedAdmission: false, effectiveIsolationVerified: false, externalBillingVerified: false });
17
+
18
+ /** This decoder validates protocol claims; it does not launch or authenticate a helper. */
19
+ export function createManagedPreferencesReader(schema, expectedSource) {
20
+ let valid;
21
+ try {
22
+ const s = copyInertJson(schema);
23
+ if (s.$id !== PREFERENCES_SCHEMA_ID || JSON.stringify(s.$defs.field.properties.name.enum) !== JSON.stringify(PREFERENCE_KEYS) ||
24
+ typeof expectedSource !== "string" || !["synthetic", "core-foundation-claim"].includes(expectedSource)) throw Error();
25
+ const ajv = new Ajv2020({ strict: true, allErrors: true }); ajv.addSchema(s);
26
+ valid = Object.fromEntries(["wire", "report"].map(n => [n, ajv.compile({ $ref: `${PREFERENCES_SCHEMA_ID}#/$defs/${n}` })]));
27
+ } catch { throw Error("Invalid managed-preferences schema or source"); }
28
+ const checked = r => { if (!valid.report(r)) throw Error("Managed-preferences report invariant failed"); return r; };
29
+ return (input, exitCode) => {
30
+ let r = report("preferences-invalid-output");
31
+ try {
32
+ const d = strictJson(input); if (!valid.wire(d)) fail("preferences-invalid-output");
33
+ if (d.source !== expectedSource) return checked(report("preferences-source-mismatch"));
34
+ if (!Number.isSafeInteger(exitCode) || exitCode !== (d.status === "complete" ? 0 : 1)) return checked(report("preferences-exit-mismatch"));
35
+ if (d.status === "failed") { r.state = "helper-failed"; r.sourceClaim = d.source; r.reasons = [d.code]; }
36
+ else {
37
+ if (new Set(d.fields.map(f => f.name)).size !== 6) fail("preferences-invalid-output");
38
+ r.state = "partial-observation"; r.sourceClaim = d.source;
39
+ r.fields = PREFERENCE_KEYS.map(name => ({ ...d.fields.find(f => f.name === name) }));
40
+ r.reasons = ["preferences-observation-partial"];
41
+ if (r.fields.some(f => f.forced === "unknown")) r.reasons.push("preferences-force-unknown");
42
+ if (r.fields.some(f => f.type === "not-found-by-api" && f.forced === "forced")) r.reasons.push("preferences-nonatomic-observation");
43
+ r.reasons.sort();
44
+ }
45
+ } catch { r = report("preferences-invalid-output"); }
46
+ return checked(r);
47
+ };
48
+ }
49
+
50
+ /** Closed, bounded stdout accumulator. No provisional fields, native IO, or timers. */
51
+ export function createManagedPreferencesStreamReader(schema, expectedSource) {
52
+ const read = createManagedPreferencesReader(schema, expectedSource);
53
+ let buffer = Buffer.alloc(32768), bytes = 0, closed = false, error = null;
54
+ const discard = reason => { buffer = null; bytes = 0; error = reason; };
55
+ return Object.freeze({
56
+ push(chunk) {
57
+ if (closed) { discard("preferences-stream-closed"); return false; }
58
+ if (error) return false;
59
+ try {
60
+ const b = copyBytes(chunk, 32768);
61
+ if (bytes + b.length > 32768) { discard("preferences-transport-overflow"); return false; }
62
+ Uint8Array.prototype.set.call(buffer, b, bytes); bytes += b.length; return true;
63
+ } catch { discard("preferences-invalid-output"); return false; }
64
+ },
65
+ abort(reason) {
66
+ if (closed) { discard("preferences-stream-closed"); return false; }
67
+ discard(typeof reason === "string" && transportReasons.includes(reason) ? reason : "preferences-transport-error");
68
+ return false;
69
+ },
70
+ finish(exitCode) {
71
+ if (closed) return report("preferences-stream-closed");
72
+ closed = true;
73
+ if (error) { buffer = null; return report(error); }
74
+ const result = read(buffer.subarray(0, bytes), exitCode); buffer = null; bytes = 0;
75
+ return result;
76
+ }
77
+ });
78
+ }
@@ -0,0 +1,134 @@
1
+ import { supportsDiagnosticHost } from "./client-local-platform.js";
2
+ import fs from "node:fs/promises";
3
+ import path from "node:path";
4
+ import { spawn as nativeSpawn } from "node:child_process";
5
+ import { types } from "node:util";
6
+ import Ajv2020 from "ajv/dist/2020.js";
7
+ import { hash } from "./client-runtime-core.js";
8
+ import { createStoreFiles } from "./client-runtime-store-files.js";
9
+ import { copyInertJson } from "./client-output-json.js";
10
+ import { createNativePreflightEvaluator, createNativeAccessExtractor, strictPreflightJson } from "./client-native-preflight.js";
11
+ import { verifyPreflightCandidate, absolutePhysicalName } from "./client-native-preflight-files.js";
12
+
13
+ const permits = new WeakMap(), monoMs = () => Number(process.hrtime.bigint() / 1000000n);
14
+ export const nativeAccessScope = cfg => hash({ candidate: cfg.candidate, recipe: ["auth", "status"], limits: cfg.limits, environmentProfile: "native-access-minimal-v1" });
15
+ // Trusted orchestration only; hashes/JSON never create human approval themselves.
16
+ export function createNativeAccessPermit(cfg, input) {
17
+ const h = Object.freeze(Object.create(null)); permits.set(h, { binding: hash({ cfg: copyInertJson(cfg), input: strictPreflightJson(input) }), used: false, live: true }); return h;
18
+ }
19
+ export function revokeNativeAccessPermit(h) { const p = permits.get(h); if (p) p.live = false; }
20
+
21
+ export function createNativeAccessCollector(schema, candidateSchema, configuration, authorization, dependencies = {}) {
22
+ const platformAdmitted = supportsDiagnosticHost(process.platform, process.arch, dependencies);
23
+ const cfg = copyInertJson(configuration), cs = copyInertJson(candidateSchema);
24
+ if (cs.$id !== "https://agent-toolkit.local/schemas/agent-client-native-diagnostics.schema.json") throw Error("Invalid candidate schema");
25
+ const ajv = new Ajv2020({ strict: true }); ajv.addSchema(cs);
26
+ ajv.addFormat("date-time", { type: "string", validate: v => /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/.test(v) && Number.isFinite(Date.parse(v)) && new Date(v).toISOString() === v.replace(/Z$/, ".000Z") });
27
+ const ps = copyInertJson(schema); ajv.addSchema(ps);
28
+ const reportValid = ajv.compile({ $ref: ps.$id + "#/$defs/accessReport" });
29
+ const pinValid = ajv.compile({ $ref: cs.$id + "#/$defs/pin" });
30
+ const l = cfg.limits;
31
+ if (Object.keys(cfg).sort().join() !== "candidate,limits,workspaceParent" || !pinValid(cfg.candidate) ||
32
+ ![cfg.workspaceParent, cfg.candidate.entryPath, cfg.candidate.artifactPath].every(absolutePhysicalName) ||
33
+ Object.keys(l).sort().join() !== "confirmationMs,graceMs,maxErrorBytes,maxOutputBytes,timeoutMs,totalTimeoutMs" ||
34
+ Object.values(l).some(v => !Number.isSafeInteger(v) || v < 1) || l.timeoutMs > 15000 || l.totalTimeoutMs > 90000 ||
35
+ l.timeoutMs > l.totalTimeoutMs || l.graceMs > 1000 || l.confirmationMs > 1000 || l.graceMs + l.confirmationMs >= l.timeoutMs ||
36
+ l.maxOutputBytes > 32768 || l.maxErrorBytes > 32768) throw Error("Invalid access configuration");
37
+ const policy = { expectedScopeSha256: nativeAccessScope(cfg), maxEvidenceAgeSeconds: 3600, revokedReferences: dependencies.revokedReferences ?? [] };
38
+ const evaluate = createNativePreflightEvaluator(schema, policy), extract = createNativeAccessExtractor(schema);
39
+ const spawn = dependencies.spawn ?? nativeSpawn, kill = dependencies.kill ?? process.kill.bind(process);
40
+ const mono = dependencies.monotonic ?? monoMs, clock = dependencies.clock ?? Date.now;
41
+ const io = { ...fs, ...dependencies.io }, files = createStoreFiles(dependencies.io); let invoked = false;
42
+ return Object.freeze({ async run(input) {
43
+ const began = mono(), deadline = began + l.totalTimeoutMs;
44
+ const r = { scope: "native-access-only", state: "blocked", nativeExecuted: false, spawnAttempts: 0,
45
+ inferenceRequested: false, actualModelCalls: null, runtimeReady: false, verifiedAdmission: false,
46
+ externalBillingVerified: false, remoteCancellationVerified: false, terminationConfirmed: true,
47
+ stdoutBytes: 0, stderrBytes: 0, elapsedMs: 0, preflight: null, reasons: [] };
48
+ let workspace, owned, parent, claimed = false, auth = null;
49
+ try {
50
+ if (invoked) throw Error("permission"); invoked = true;
51
+ const d = strictPreflightJson(input), p = !types.isProxy(authorization) && permits.get(authorization);
52
+ if (!p || !p.live || p.used || p.binding !== hash({ cfg, input: d })) throw Error("permission");
53
+ p.used = true; claimed = true;
54
+ if (!platformAdmitted) throw Error("platform");
55
+ const current = new Date(clock()).toISOString().replace(/\.\d{3}Z$/, "Z");
56
+ r.preflight = evaluate({ ...d, now: current });
57
+ if (!r.preflight.queryEligible) { r.reasons = ["access-controls-insufficient"]; return { report: r, auth }; }
58
+ await verifyPreflightCandidate(cfg.candidate, { io: dependencies.io, deadline, monotonic: mono });
59
+ if (/(CloudStorage|Mobile Documents|Dropbox|OneDrive|iCloud)/i.test(cfg.workspaceParent)) throw Error("parent");
60
+ parent = await files.directory(cfg.workspaceParent);
61
+ if (parent.dev !== cfg.candidate.expectedDev || parent.uid !== cfg.candidate.expectedUid) throw Error("parent");
62
+ for (let dir = cfg.workspaceParent; dir !== path.parse(dir).root; dir = path.dirname(dir)) {
63
+ try { await io.lstat(path.join(dir, ".git")); throw Error("git"); } catch (e) { if (e.code !== "ENOENT") throw e; }
64
+ }
65
+ workspace = await io.mkdtemp(path.join(cfg.workspaceParent, "access-work-")); await io.chmod(workspace, 0o700); owned = await files.directory(workspace);
66
+ if (!p.live || dependencies.signal?.aborted || mono() >= deadline - l.graceMs - l.confirmationMs) throw Error("deadline");
67
+ const env = { HOME: process.env.HOME, TMPDIR: workspace, PATH: "/usr/bin:/bin:/usr/sbin:/sbin", LANG: "C", LC_ALL: "C",
68
+ DISABLE_UPDATES: "1", DISABLE_AUTOUPDATER: "1", CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: "1", ENABLE_CLAUDEAI_MCP_SERVERS: "false" };
69
+ if (!absolutePhysicalName(env.HOME)) throw Error("home");
70
+ const end = Math.min(deadline, mono() + l.timeoutMs); r.spawnAttempts = 1; r.terminationConfirmed = false;
71
+ let child;
72
+ try { child = spawn(cfg.candidate.artifactPath, ["auth", "status"], { shell: false, detached: true, cwd: workspace, env, stdio: ["ignore", "pipe", "pipe"] }); }
73
+ catch { r.terminationConfirmed = true; throw Error("spawn-failed"); }
74
+ let decoded = "";
75
+ await new Promise(resolve => {
76
+ const out = new TextDecoder("utf-8", { fatal: true }), err = new TextDecoder("utf-8", { fatal: true });
77
+ let done = false, canceled = false, at = null, forced = false, gone = false, failedSpawn = false;
78
+ let exited = false, closed = false, outClosed = false, errClosed = false, exitCode = null, timer, hard;
79
+ const add = c => { if (!r.reasons.includes(c)) r.reasons.push(c); };
80
+ const send = sig => { if (!r.nativeExecuted || gone) return; try { kill(-child.pid, sig); } catch (e) { if (e.code === "ESRCH") gone = true; else add("access-signal-unconfirmed"); } };
81
+ const alive = () => { if (gone || failedSpawn) return false; if (!r.nativeExecuted) return true; try { kill(-child.pid, 0); return true; } catch (e) { if (e.code === "ESRCH") { gone = true; return false; } add("access-group-unconfirmed"); return true; } };
82
+ const stop = (c, state = "failed") => { if (done) return; add(c); if (canceled) return; canceled = true; at = mono(); r.state = state; send("SIGTERM"); };
83
+ const finish = uncertain => {
84
+ if (done) return; done = true; clearInterval(timer); clearTimeout(hard); dependencies.signal?.removeEventListener("abort", abort);
85
+ r.terminationConfirmed = failedSpawn || exited && closed && outClosed && errClosed && gone;
86
+ if (uncertain || !r.terminationConfirmed || mono() > end) { r.state = "indeterminate"; add("access-termination-unconfirmed"); }
87
+ else if (failedSpawn) r.state = "failed";
88
+ else if (!canceled) {
89
+ try { if (exitCode !== 0) throw Error("exit"); decoded += out.decode(); err.decode(); auth = extract(decoded); r.state = "completed"; }
90
+ catch { r.state = "failed"; add("access-response-invalid"); auth = null; }
91
+ }
92
+ decoded = ""; child.stdout.destroy(); child.stderr.destroy(); resolve();
93
+ };
94
+ const poll = () => {
95
+ if (done) return;
96
+ if (mono() >= end - l.graceMs - l.confirmationMs && !canceled) stop("access-deadline", "timed-out");
97
+ if (canceled && !forced && mono() - at >= l.graceMs) { forced = true; send("SIGKILL"); }
98
+ const live = alive();
99
+ if (exited && closed && outClosed && errClosed && !live) finish(false);
100
+ else if (exited && live && !canceled) stop("access-descendants-unconfirmed");
101
+ if (failedSpawn && closed) finish(false);
102
+ };
103
+ const abort = () => stop("access-canceled", "canceled");
104
+ child.on("spawn", () => { r.nativeExecuted = true; if (done) send("SIGKILL"); else if (canceled) send("SIGTERM"); });
105
+ child.on("error", () => { if (!r.nativeExecuted) { failedSpawn = true; add("access-spawn-failed"); } else stop("access-process-error"); });
106
+ child.on("exit", code => { exited = true; exitCode = code; poll(); }); child.on("close", () => { closed = true; poll(); });
107
+ child.stdout.on("close", () => { outClosed = true; poll(); }); child.stderr.on("close", () => { errClosed = true; poll(); });
108
+ child.stdout.on("error", () => stop("access-process-error")); child.stderr.on("error", () => stop("access-process-error"));
109
+ child.stdout.on("data", b => { if (done || canceled) return; r.stdoutBytes += b.length; if (r.stdoutBytes > l.maxOutputBytes) stop("access-output-limit"); else try { decoded += out.decode(b, { stream: true }); } catch { stop("access-utf8-invalid"); } });
110
+ child.stderr.on("data", b => { if (done || canceled) return; r.stderrBytes += b.length; if (r.stderrBytes > l.maxErrorBytes) stop("access-stderr-limit"); else try { err.decode(b, { stream: true }); } catch { stop("access-utf8-invalid"); } });
111
+ dependencies.signal?.addEventListener("abort", abort, { once: true }); if (dependencies.signal?.aborted) abort();
112
+ timer = setInterval(poll, 10); hard = setTimeout(() => { send("SIGKILL"); poll(); if (!done) finish(true); }, Math.max(1, end - mono()));
113
+ });
114
+ if (r.state === "completed") {
115
+ await verifyPreflightCandidate(cfg.candidate, { io: dependencies.io, deadline, monotonic: mono });
116
+ const observedAt = new Date(clock()).toISOString().replace(/\.\d{3}Z$/, "Z");
117
+ r.preflight = evaluate({ ...d, now: observedAt, access: { data: auth,
118
+ assessment: { source: "locally-observed", referenceId: "native-access-observation", checkedAt: observedAt, scopeSha256: policy.expectedScopeSha256 } } });
119
+ if (r.preflight.state === "blocked") { r.state = "blocked"; r.reasons.push("access-preflight-incompatible"); }
120
+ }
121
+ if (!r.reasons.length) r.reasons = ["access-completed"];
122
+ } catch { auth = null; r.state = r.nativeExecuted ? "indeterminate" : "blocked"; r.reasons = ["access-local-check-failed"]; }
123
+ finally {
124
+ if (claimed) revokeNativeAccessPermit(authorization);
125
+ if (workspace && r.terminationConfirmed) try { await files.directory(cfg.workspaceParent, parent); await files.directory(workspace, owned); await io.rmdir(workspace); }
126
+ catch { r.state = "indeterminate"; r.reasons.push("access-workspace-cleanup-required"); }
127
+ r.elapsedMs = Math.max(0, Math.ceil(mono() - began));
128
+ if (r.elapsedMs > l.totalTimeoutMs) { r.state = "indeterminate"; r.reasons.push("access-deadline"); }
129
+ r.reasons = [...new Set(r.reasons)].sort();
130
+ if (!reportValid(r)) throw Error("Access report invariant failed");
131
+ }
132
+ return { report: r, auth }; // auth is a private projection, never raw stdout.
133
+ } });
134
+ }