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,77 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://agent-toolkit.local/schemas/agent-client-selective-config.schema.json",
4
+ "$defs": {
5
+ "limits": {
6
+ "type": "object", "additionalProperties": false,
7
+ "required": ["maxBytes", "blockBytes", "maxDepth", "maxNodes", "maxKeyBytes", "maxKeys"],
8
+ "properties": {
9
+ "maxBytes": {"type": "integer", "minimum": 1, "maximum": 1048576},
10
+ "blockBytes": {"type": "integer", "minimum": 1, "maximum": 4096},
11
+ "maxDepth": {"type": "integer", "minimum": 1, "maximum": 32},
12
+ "maxNodes": {"type": "integer", "minimum": 1, "maximum": 20000},
13
+ "maxKeyBytes": {"type": "integer", "minimum": 1, "maximum": 256},
14
+ "maxKeys": {"type": "integer", "minimum": 1, "maximum": 4096}
15
+ }
16
+ },
17
+ "field": {
18
+ "type": "object", "additionalProperties": false,
19
+ "required": ["name", "present", "type", "empty", "booleanValue"],
20
+ "properties": {
21
+ "name": {"enum": ["hooks", "apiKeyHelper", "disableAllHooks", "mcpServers"]},
22
+ "present": {"type": "boolean"},
23
+ "type": {"enum": ["object", "array", "string", "number", "boolean", "null", null]},
24
+ "empty": {"type": ["boolean", "null"]}, "booleanValue": {"type": ["boolean", "null"]}
25
+ }
26
+ },
27
+ "sourceObservation": {
28
+ "type": "object", "additionalProperties": false,
29
+ "required": ["sourceId", "state", "provenance", "fields", "projectionSha256", "stats"],
30
+ "properties": {
31
+ "sourceId": {"enum": ["personal-settings", "global-state"]}, "state": {"enum": ["observed", "incomplete", "blocked"]},
32
+ "provenance": {"enum": ["local-structure-observation", "pending"]},
33
+ "fields": {"type": "array", "maxItems": 3, "items": {"$ref": "#/$defs/field"}},
34
+ "projectionSha256": {"type": ["string", "null"], "pattern": "^[a-f0-9]{64}$"},
35
+ "stats": {"anyOf": [{"$ref": "#/$defs/report/properties/stats"}, {"type": "null"}]}
36
+ }
37
+ },
38
+ "fileReport": {
39
+ "type": "object", "additionalProperties": false,
40
+ "required": ["scope", "state", "sources", "inferenceRequested", "nativeExecuted", "runtimeReady", "verifiedAdmission", "externalBillingVerified", "effectiveControlsVerified", "bytesRead", "elapsedMs", "reasons"],
41
+ "properties": {
42
+ "scope": {"const": "selective-local-structure-only"}, "state": {"enum": ["observed", "incomplete", "blocked"]},
43
+ "sources": {"type": "array", "maxItems": 2, "items": {"$ref": "#/$defs/sourceObservation"}},
44
+ "inferenceRequested": {"const": false}, "nativeExecuted": {"const": false}, "runtimeReady": {"const": false},
45
+ "verifiedAdmission": {"const": false}, "externalBillingVerified": {"const": false}, "effectiveControlsVerified": {"const": false},
46
+ "bytesRead": {"type": "integer", "minimum": 0, "maximum": 2097152},
47
+ "elapsedMs": {"type": "integer", "minimum": 0, "maximum": 9007199254740991},
48
+ "reasons": {"type": "array", "maxItems": 1, "items": {"enum": ["selective-local-observed", "selective-clock-unavailable", "selective-permit-unavailable", "selective-input-forbidden", "selective-owner-unavailable", "selective-path-unsafe", "selective-file-unsafe", "selective-file-limit", "selective-file-changed", "selective-read-limit", "selective-canceled", "selective-deadline", "selective-source-missing", "selective-file-unconfirmed", "selective-byte-limit", "selective-block-invalid", "selective-depth-limit", "selective-node-limit", "selective-key-limit", "selective-key-bytes-limit", "selective-duplicate-key", "selective-invalid-utf8", "selective-invalid-unicode", "selective-invalid-json", "selective-root-object-required", "selective-truncated", "selective-closed"]}}
49
+ }
50
+ },
51
+ "report": {
52
+ "type": "object", "additionalProperties": false,
53
+ "required": ["scope", "sourceId", "state", "provenance", "fields", "projectionSha256", "inferenceRequested", "nativeExecuted", "runtimeReady", "verifiedAdmission", "externalBillingVerified", "effectiveControlsVerified", "stats", "reasons"],
54
+ "properties": {
55
+ "scope": {"const": "selective-local-structure-only"}, "sourceId": {"enum": ["personal-settings", "global-state"]},
56
+ "state": {"enum": ["invalid", "incomplete", "observed", "blocked"]}, "provenance": {"const": "provided-bytes-structure"},
57
+ "fields": {"type": "array", "maxItems": 3, "items": {"$ref": "#/$defs/field"}},
58
+ "projectionSha256": {"type": ["string", "null"], "pattern": "^[a-f0-9]{64}$"},
59
+ "inferenceRequested": {"const": false}, "nativeExecuted": {"const": false}, "runtimeReady": {"const": false},
60
+ "verifiedAdmission": {"const": false}, "externalBillingVerified": {"const": false}, "effectiveControlsVerified": {"const": false},
61
+ "stats": {
62
+ "type": "object", "additionalProperties": false,
63
+ "required": ["bytes", "nodes", "keys", "peakDepth", "peakKeyDigests", "retainedRawBytes", "retainedValueTextBytes"],
64
+ "properties": {
65
+ "bytes": {"type": "integer", "minimum": 0, "maximum": 1052672},
66
+ "nodes": {"type": "integer", "minimum": 0, "maximum": 20001},
67
+ "keys": {"type": "integer", "minimum": 0, "maximum": 4097},
68
+ "peakDepth": {"type": "integer", "minimum": 0, "maximum": 33},
69
+ "peakKeyDigests": {"type": "integer", "minimum": 0, "maximum": 4096},
70
+ "retainedRawBytes": {"const": 0}, "retainedValueTextBytes": {"const": 0}
71
+ }
72
+ },
73
+ "reasons": {"type": "array", "maxItems": 1, "items": {"enum": ["selective-observed", "selective-incomplete", "selective-byte-limit", "selective-block-invalid", "selective-depth-limit", "selective-node-limit", "selective-key-limit", "selective-key-bytes-limit", "selective-duplicate-key", "selective-invalid-utf8", "selective-invalid-unicode", "selective-invalid-json", "selective-root-object-required", "selective-truncated", "selective-closed"]}}
74
+ }
75
+ }
76
+ }
77
+ }
@@ -0,0 +1,135 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://agent-toolkit.local/schemas/agent-client-supervised-local.schema.json",
4
+ "title": "S2 independent supervised fixture-only local contract",
5
+ "$defs": {
6
+ "id": {"type": "string", "pattern": "^[a-z][a-z0-9-]{0,63}$"},
7
+ "sha": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
8
+ "identity": {
9
+ "type": "object", "additionalProperties": false,
10
+ "required": ["projectId", "taskId", "taskRevision"],
11
+ "properties": {
12
+ "projectId": {"$ref": "#/$defs/id"}, "taskId": {"$ref": "#/$defs/id"},
13
+ "taskRevision": {"$ref": "#/$defs/id"}
14
+ }
15
+ },
16
+ "limits": {
17
+ "type": "object", "additionalProperties": false,
18
+ "required": ["maxMainStarts", "concurrency", "retries", "corrections", "timeoutMs", "graceMs", "confirmationMs", "maxInputBytes", "maxOutputBytes", "maxStderrBytes", "maxLineBytes", "maxEvents"],
19
+ "properties": {
20
+ "maxMainStarts": {"const": 1}, "concurrency": {"const": 1},
21
+ "retries": {"const": 0}, "corrections": {"const": 0},
22
+ "timeoutMs": {"type": "integer", "minimum": 100, "maximum": 120000},
23
+ "graceMs": {"type": "integer", "minimum": 10, "maximum": 2000},
24
+ "confirmationMs": {"type": "integer", "minimum": 10, "maximum": 2000},
25
+ "maxInputBytes": {"type": "integer", "minimum": 1, "maximum": 16384},
26
+ "maxOutputBytes": {"type": "integer", "minimum": 1, "maximum": 262144},
27
+ "maxStderrBytes": {"type": "integer", "minimum": 1, "maximum": 32768},
28
+ "maxLineBytes": {"type": "integer", "minimum": 1, "maximum": 32768},
29
+ "maxEvents": {"type": "integer", "minimum": 1, "maximum": 512}
30
+ }
31
+ },
32
+ "fixtureId": {"enum": ["success", "split-utf8", "environment", "silent", "blocked-stdin", "closed-stdin", "failure", "stdout-overflow", "stderr-overflow", "stderr-invalid", "long-line", "event-overflow", "invalid-utf8", "forbidden-event", "duplicate-json", "after-terminal", "unterminated", "incomplete", "ignore-term", "parent-child", "child-after-parent"]},
33
+ "request": {
34
+ "type": "object", "additionalProperties": false,
35
+ "required": ["schemaVersion", "scope", "identity", "attemptId", "fixtureId", "inputText", "limits"],
36
+ "properties": {
37
+ "schemaVersion": {"const": "1.0.0"}, "scope": {"const": "fixture-only"},
38
+ "identity": {"$ref": "#/$defs/identity"}, "attemptId": {"$ref": "#/$defs/id"},
39
+ "fixtureId": {"$ref": "#/$defs/fixtureId"}, "inputText": {"type": "string", "maxLength": 16384},
40
+ "limits": {"$ref": "#/$defs/limits"}
41
+ }
42
+ },
43
+ "state": {"enum": ["reserved", "start-claimed", "started", "completed-for-review", "failed", "canceled", "timed-out", "indeterminate"]},
44
+ "metrics": {
45
+ "type": "object", "additionalProperties": false,
46
+ "required": ["spawnAttempts", "mainStartsObserved", "stdoutBytes", "stderrBytes", "events", "elapsedMs", "terminationConfirmed"],
47
+ "properties": {
48
+ "spawnAttempts": {"type": "integer", "minimum": 0, "maximum": 1},
49
+ "mainStartsObserved": {"type": "integer", "minimum": 0, "maximum": 1},
50
+ "stdoutBytes": {"type": "integer", "minimum": 0, "maximum": 9007199254740991},
51
+ "stderrBytes": {"type": "integer", "minimum": 0, "maximum": 9007199254740991},
52
+ "events": {"type": "integer", "minimum": 0, "maximum": 513},
53
+ "elapsedMs": {"type": "integer", "minimum": 0, "maximum": 9007199254740991},
54
+ "terminationConfirmed": {"type": "boolean"}
55
+ }
56
+ },
57
+ "reasons": {"type": "array", "maxItems": 32, "uniqueItems": true, "items": {"enum": ["byte-limit","duplicate-json-key","event-json-limit","invalid-byte-input","invalid-event-object","invalid-json","invalid-unicode","invalid-utf8","json-number-precision-loss","metadata-limit","non-finite-json-number","non-json-metadata","store-created-resource-unusable","store-directory-replaced","store-file-limit","store-invalid-parent","store-io-failed","store-residual-resource","store-resource-changed","store-resource-exists","store-resource-replaced","store-short-write","store-symlink-path","store-unsafe-resource","supervised-after-terminal","supervised-budget-consumed","supervised-budget-reserved","supervised-canceled","supervised-canceled-before-reservation","supervised-canceled-before-start","supervised-clock-unavailable","supervised-consumer-required","supervised-deadline","supervised-deadline-before-start","supervised-descendants-live","supervised-empty-reservation","supervised-event-binding-mismatch","supervised-event-chain-mismatch","supervised-event-gap","supervised-event-limit","supervised-exit-failed","supervised-fixture-completed","supervised-fixture-directory-unsafe","supervised-fixture-source-unsafe","supervised-forbidden-event","supervised-group-unconfirmed","supervised-incompatible-limits","supervised-incomplete-protocol","supervised-invalid-claim","supervised-invalid-completion","supervised-invalid-deadline","supervised-invalid-event","supervised-invalid-identity","supervised-invalid-observation","supervised-invalid-processReport","supervised-invalid-receipt","supervised-invalid-report","supervised-invalid-request","supervised-invalid-reservation","supervised-invalid-start","supervised-invalid-transition","supervised-line-limit","supervised-local-error","supervised-local-result","supervised-output-limit","supervised-platform-not-admitted","supervised-process-error","supervised-receipt-mismatch","supervised-reconciliation-required","supervised-reservation-changed","supervised-result-recorded","supervised-root-not-temporary","supervised-signal-unconfirmed","supervised-spawn-failed","supervised-start-record-unconfirmed","supervised-stderr-error","supervised-stderr-invalid-utf8","supervised-stderr-limit","supervised-stdin-error","supervised-stdout-error","supervised-unconfirmed-terminal","supervised-unterminated-line","supervised-workspace-cleanup-required","supervised-workspace-parent-unsafe","supervised-write-not-confirmed","synthetic-result","unsafe-json-key"]}},
58
+ "receipt": {
59
+ "type": "object", "additionalProperties": false,
60
+ "required": ["schemaVersion", "scope", "terminalSha256"],
61
+ "properties": {
62
+ "schemaVersion": {"const": "1.0.0"}, "scope": {"const": "fixture-only"},
63
+ "terminalSha256": {"$ref": "#/$defs/sha"}
64
+ }
65
+ },
66
+ "event": {
67
+ "type": "object", "additionalProperties": false,
68
+ "required": ["schemaVersion", "scope", "sequence", "previousSha256", "identity", "attemptId", "fixtureId", "requestSha256", "limits", "state", "observedAt", "metrics", "reasons", "fixtureModelCalls", "actualModelCalls", "internalCallCeiling", "remoteCancellationVerified"],
69
+ "properties": {
70
+ "schemaVersion": {"const": "1.0.0"}, "scope": {"const": "fixture-only"},
71
+ "sequence": {"type": "integer", "minimum": 0, "maximum": 3},
72
+ "previousSha256": {"anyOf": [{"$ref": "#/$defs/sha"}, {"type": "null"}]},
73
+ "identity": {"$ref": "#/$defs/identity"}, "attemptId": {"$ref": "#/$defs/id"},
74
+ "fixtureId": {"$ref": "#/$defs/fixtureId"}, "requestSha256": {"$ref": "#/$defs/sha"},
75
+ "limits": {"$ref": "#/$defs/limits"}, "state": {"$ref": "#/$defs/state"},
76
+ "observedAt": {"type": "string", "format": "date-time"},
77
+ "metrics": {"$ref": "#/$defs/metrics"}, "reasons": {"$ref": "#/$defs/reasons"},
78
+ "fixtureModelCalls": {"const": 0}, "actualModelCalls": {"type": "null"},
79
+ "internalCallCeiling": {"type": "null"}, "remoteCancellationVerified": {"const": false}
80
+ }
81
+ },
82
+ "storageReport": {
83
+ "type": "object", "additionalProperties": false,
84
+ "required": ["state", "durability", "reasons"],
85
+ "properties": {
86
+ "state": {"enum": ["blocked", "recorded", "reconciliation-required"]},
87
+ "durability": {"enum": ["confirmed", "unconfirmed"]}, "reasons": {"$ref": "#/$defs/reasons"}
88
+ }
89
+ },
90
+ "report": {
91
+ "type": "object", "additionalProperties": false,
92
+ "required": ["scope", "state", "fixtureExecuted", "nativeExecuted", "runtimeReady", "verifiedAdmission", "actualModelCalls", "fixtureModelCalls", "internalCallCeiling", "remoteCancellationVerified", "process", "storage", "elapsedMs", "reasons"],
93
+ "properties": {
94
+ "scope": {"const": "fixture-only"},
95
+ "state": {"enum": ["not-started", "completed-for-review", "failed", "canceled", "timed-out", "indeterminate"]},
96
+ "fixtureExecuted": {"type": "boolean"}, "nativeExecuted": {"const": false},
97
+ "runtimeReady": {"const": false}, "verifiedAdmission": {"const": false},
98
+ "actualModelCalls": {"type": "null"}, "fixtureModelCalls": {"const": 0},
99
+ "internalCallCeiling": {"type": "null"}, "remoteCancellationVerified": {"const": false},
100
+ "process": {"anyOf": [{"$ref": "#/$defs/processReport"}, {"type": "null"}]},
101
+ "storage": {"anyOf": [{"$ref": "#/$defs/storageReport"}, {"type": "null"}]},
102
+ "elapsedMs": {"type": "integer", "minimum": 0, "maximum": 9007199254740991},
103
+ "reasons": {"$ref": "#/$defs/reasons"}
104
+ }
105
+ },
106
+ "observation": {
107
+ "type": "object", "additionalProperties": false,
108
+ "required": ["state", "budgetConsumed", "eventCount", "lastState", "spawnAttempts", "mainStartsObserved", "fixtureModelCalls", "actualModelCalls", "internalCallCeiling", "remoteCancellationVerified", "reasons"],
109
+ "properties": {
110
+ "state": {"enum": ["clear", "consumed", "reconciliation-required"]}, "budgetConsumed": {"type": "boolean"},
111
+ "eventCount": {"type": "integer", "minimum": 0, "maximum": 4},
112
+ "lastState": {"anyOf": [{"$ref": "#/$defs/state"}, {"type": "null"}]},
113
+ "spawnAttempts": {"type": ["integer", "null"], "minimum": 0, "maximum": 1},
114
+ "mainStartsObserved": {"type": ["integer", "null"], "minimum": 0, "maximum": 1},
115
+ "fixtureModelCalls": {"const": 0}, "actualModelCalls": {"type": "null"},
116
+ "internalCallCeiling": {"type": "null"}, "remoteCancellationVerified": {"const": false},
117
+ "reasons": {"$ref": "#/$defs/reasons"}
118
+ }
119
+ },
120
+ "processReport": {
121
+ "type": "object", "additionalProperties": false,
122
+ "required": ["scope", "state", "fixtureExecuted", "nativeExecuted", "runtimeReady", "verifiedAdmission", "actualModelCalls", "fixtureModelCalls", "internalCallCeiling", "remoteCancellationVerified", "metrics", "exitObserved", "pipesClosed", "groupObservation", "reasons"],
123
+ "properties": {
124
+ "scope": {"const": "fixture-only"},
125
+ "state": {"enum": ["not-started", "completed-for-review", "failed", "canceled", "timed-out", "indeterminate"]},
126
+ "fixtureExecuted": {"type": "boolean"}, "nativeExecuted": {"const": false},
127
+ "runtimeReady": {"const": false}, "verifiedAdmission": {"const": false},
128
+ "actualModelCalls": {"type": "null"}, "fixtureModelCalls": {"const": 0},
129
+ "internalCallCeiling": {"type": "null"}, "remoteCancellationVerified": {"const": false},
130
+ "metrics": {"$ref": "#/$defs/metrics"}, "exitObserved": {"type": "boolean"}, "pipesClosed": {"type": "boolean"},
131
+ "groupObservation": {"enum": ["not-started", "absent", "unconfirmed"]}, "reasons": {"$ref": "#/$defs/reasons"}
132
+ }
133
+ }
134
+ }
135
+ }
@@ -0,0 +1,186 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://agent-toolkit.local/schemas/agent-client-supervised.schema.json",
4
+ "title": "Supervised subscription declarations, not execution permission",
5
+ "$defs": {
6
+ "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{0,95}$" },
7
+ "sha": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
8
+ "nullableId": { "anyOf": [{ "$ref": "#/$defs/id" }, { "type": "null" }] },
9
+ "date": { "type": "string", "format": "date-time" },
10
+ "assessment": {
11
+ "type": "object", "additionalProperties": false,
12
+ "required": ["status", "source", "checkedAt", "expiresAt", "evidenceRef", "scopeSha256"],
13
+ "properties": {
14
+ "status": { "enum": ["confirmed", "documented", "pending", "rejected"] },
15
+ "source": { "enum": ["operator-attestation", "installation-test", "provider-documentation"] },
16
+ "checkedAt": { "$ref": "#/$defs/date" }, "expiresAt": { "$ref": "#/$defs/date" },
17
+ "evidenceRef": { "$ref": "#/$defs/nullableId" }, "scopeSha256": { "$ref": "#/$defs/sha" }
18
+ }
19
+ },
20
+ "identity": {
21
+ "type": "object", "additionalProperties": false,
22
+ "required": ["projectId", "taskId", "taskRevision", "role", "mode"],
23
+ "properties": {
24
+ "projectId": { "$ref": "#/$defs/id" }, "taskId": { "$ref": "#/$defs/id" },
25
+ "taskRevision": { "type": "integer", "minimum": 1, "maximum": 1000000 },
26
+ "role": { "enum": ["tutor", "proposer", "reviewer"] }, "mode": { "enum": ["tutor", "autonomous"] }
27
+ }
28
+ },
29
+ "selection": {
30
+ "type": "object", "additionalProperties": false,
31
+ "required": ["provider", "client", "profileId", "model", "effort", "source", "assessment"],
32
+ "properties": {
33
+ "provider": { "const": "anthropic" }, "client": { "const": "claude-code" },
34
+ "profileId": { "$ref": "#/$defs/id" }, "model": { "$ref": "#/$defs/id" },
35
+ "effort": { "enum": ["low", "medium", "high", "xhigh", "max"] },
36
+ "source": { "enum": ["operator-choice", "selector-recommendation"] },
37
+ "assessment": { "$ref": "#/$defs/assessment" }
38
+ }
39
+ },
40
+ "binding": {
41
+ "type": "object", "additionalProperties": false,
42
+ "required": ["provider", "client", "variantId", "clientVersion", "platform", "architecture", "installationId", "artifactSha256", "configurationSha256", "environmentSha256", "controlRevision"],
43
+ "properties": {
44
+ "provider": { "const": "anthropic" }, "client": { "const": "claude-code" },
45
+ "variantId": { "$ref": "#/$defs/id" },
46
+ "clientVersion": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[a-z0-9.-]+)?$", "maxLength": 64 },
47
+ "platform": { "enum": ["darwin", "linux", "win32"] }, "architecture": { "enum": ["arm64", "x64"] },
48
+ "installationId": { "$ref": "#/$defs/id" }, "artifactSha256": { "$ref": "#/$defs/sha" },
49
+ "configurationSha256": { "$ref": "#/$defs/sha" }, "environmentSha256": { "$ref": "#/$defs/sha" },
50
+ "controlRevision": { "$ref": "#/$defs/id" }
51
+ }
52
+ },
53
+ "limits": {
54
+ "type": "object", "additionalProperties": false,
55
+ "required": ["maxMainStarts", "maxConcurrent", "maxRetries", "maxCorrections", "timeoutSeconds", "terminationGraceSeconds", "maxInputBytes", "maxStdoutBytes", "maxStderrBytes", "maxEventBytes", "maxEvents", "maxNativeTurns"],
56
+ "properties": {
57
+ "maxMainStarts": { "const": 1 }, "maxConcurrent": { "const": 1 },
58
+ "maxRetries": { "const": 0 }, "maxCorrections": { "const": 0 },
59
+ "timeoutSeconds": { "type": "integer", "minimum": 2, "maximum": 120 },
60
+ "terminationGraceSeconds": { "type": "integer", "minimum": 1, "maximum": 2 },
61
+ "maxInputBytes": { "type": "integer", "minimum": 1, "maximum": 16384 },
62
+ "maxStdoutBytes": { "type": "integer", "minimum": 1, "maximum": 262144 },
63
+ "maxStderrBytes": { "type": "integer", "minimum": 1, "maximum": 32768 },
64
+ "maxEventBytes": { "type": "integer", "minimum": 1, "maximum": 32768 },
65
+ "maxEvents": { "type": "integer", "minimum": 1, "maximum": 512 }, "maxNativeTurns": { "const": 1 }
66
+ }
67
+ },
68
+ "context": {
69
+ "type": "object", "additionalProperties": false,
70
+ "required": ["promptRef", "promptSha256", "inputBytes", "assessment"],
71
+ "properties": {
72
+ "promptRef": { "$ref": "#/$defs/id" }, "promptSha256": { "$ref": "#/$defs/sha" },
73
+ "inputBytes": { "type": "integer", "minimum": 1, "maximum": 16384 }, "assessment": { "$ref": "#/$defs/assessment" }
74
+ }
75
+ },
76
+ "effectId": { "enum": ["native-auth", "provider-inference", "client-state", "telemetry", "descendants"] },
77
+ "effectIds": { "type": "array", "maxItems": 5, "uniqueItems": true, "items": { "$ref": "#/$defs/effectId" } },
78
+ "authorization": {
79
+ "type": "object", "additionalProperties": false,
80
+ "required": ["status", "profile", "writer", "effectsApproved", "limits", "assessment"],
81
+ "properties": {
82
+ "status": { "enum": ["approved", "pending", "denied"] }, "profile": { "const": "supervised-subscription" },
83
+ "writer": { "enum": ["user", "agent"] }, "effectsApproved": { "$ref": "#/$defs/effectIds" },
84
+ "limits": { "$ref": "#/$defs/limits" }, "assessment": { "$ref": "#/$defs/assessment" }
85
+ }
86
+ },
87
+ "limitations": {
88
+ "type": "object", "additionalProperties": false,
89
+ "required": ["internalCallsUnknownAccepted", "remoteCancellationUnknownAccepted", "assessment"],
90
+ "properties": {
91
+ "internalCallsUnknownAccepted": { "type": "boolean" }, "remoteCancellationUnknownAccepted": { "type": "boolean" },
92
+ "assessment": { "$ref": "#/$defs/assessment" }
93
+ }
94
+ },
95
+ "history": {
96
+ "type": "object", "additionalProperties": false,
97
+ "required": ["projectId", "taskId", "mainStartsUsed", "durationUsedSeconds", "actualModelCalls", "state", "assessment"],
98
+ "properties": {
99
+ "projectId": { "$ref": "#/$defs/id" }, "taskId": { "$ref": "#/$defs/id" },
100
+ "mainStartsUsed": { "type": "integer", "minimum": 0, "maximum": 1000000 },
101
+ "durationUsedSeconds": { "type": "integer", "minimum": 0, "maximum": 1000000 },
102
+ "actualModelCalls": { "type": ["integer", "null"], "minimum": 0, "maximum": 1000000 },
103
+ "state": { "enum": ["clear", "active", "reconciliation-required"] }, "assessment": { "$ref": "#/$defs/assessment" }
104
+ }
105
+ },
106
+ "controlId": { "enum": ["no-tools", "no-subagents", "no-mcp", "no-hooks", "no-personalizations", "no-updates", "stdin-text", "no-fallback", "no-resume", "no-permission-bypass"] },
107
+ "control": {
108
+ "type": "object", "additionalProperties": false,
109
+ "required": ["controlId", "mechanismId", "positiveEvidenceRef", "negativeEvidenceRef", "assessment"],
110
+ "properties": {
111
+ "controlId": { "$ref": "#/$defs/controlId" }, "mechanismId": { "$ref": "#/$defs/nullableId" },
112
+ "positiveEvidenceRef": { "$ref": "#/$defs/nullableId" }, "negativeEvidenceRef": { "$ref": "#/$defs/nullableId" },
113
+ "assessment": { "$ref": "#/$defs/assessment" }
114
+ }
115
+ },
116
+ "effect": {
117
+ "type": "object", "additionalProperties": false,
118
+ "required": ["effectId", "presence", "disposition", "assessment"],
119
+ "properties": {
120
+ "effectId": { "$ref": "#/$defs/effectId" }, "presence": { "enum": ["present", "absent", "unknown"] },
121
+ "disposition": { "enum": ["allowed", "rejected", "unknown"] }, "assessment": { "$ref": "#/$defs/assessment" }
122
+ }
123
+ },
124
+ "installation": {
125
+ "type": "object", "additionalProperties": false, "required": ["assessment"],
126
+ "properties": { "assessment": { "$ref": "#/$defs/assessment" } }
127
+ },
128
+ "access": {
129
+ "type": "object", "additionalProperties": false,
130
+ "required": ["method", "externalBilling", "assessment", "billingAssessment"],
131
+ "properties": {
132
+ "method": { "enum": ["subscription-session", "api-key", "unknown"] },
133
+ "externalBilling": { "enum": ["disabled", "enabled", "unknown"] },
134
+ "assessment": { "$ref": "#/$defs/assessment" }, "billingAssessment": { "$ref": "#/$defs/assessment" }
135
+ }
136
+ },
137
+ "observations": {
138
+ "type": "array", "maxItems": 8, "uniqueItems": true,
139
+ "items": { "enum": ["artifact-race-unresolved", "configuration-unresolved", "managed-policy-unresolved", "critical-effects-unresolved", "privacy-unresolved", "quota-exhausted", "termination-unconfirmed", "prior-consumption-unresolved"] }
140
+ },
141
+ "input": {
142
+ "type": "object", "additionalProperties": false,
143
+ "required": ["schemaVersion", "profile", "intentId", "now", "identity"],
144
+ "properties": {
145
+ "schemaVersion": { "const": "1.0.0" }, "profile": { "const": "supervised-subscription" },
146
+ "intentId": { "$ref": "#/$defs/id" }, "now": { "$ref": "#/$defs/date" }, "identity": { "$ref": "#/$defs/identity" },
147
+ "selection": { "$ref": "#/$defs/selection" }, "binding": { "$ref": "#/$defs/binding" },
148
+ "expectedBinding": { "$ref": "#/$defs/binding" }, "limits": { "$ref": "#/$defs/limits" },
149
+ "context": { "$ref": "#/$defs/context" }, "authorization": { "$ref": "#/$defs/authorization" },
150
+ "limitations": { "$ref": "#/$defs/limitations" }, "history": { "$ref": "#/$defs/history" },
151
+ "installation": { "$ref": "#/$defs/installation" },
152
+ "controls": { "type": "array", "maxItems": 10, "items": { "$ref": "#/$defs/control" } },
153
+ "effects": { "type": "array", "maxItems": 5, "items": { "$ref": "#/$defs/effect" } },
154
+ "access": { "$ref": "#/$defs/access" }, "observations": { "$ref": "#/$defs/observations" }
155
+ }
156
+ },
157
+ "policy": {
158
+ "type": "object", "additionalProperties": false,
159
+ "required": ["maxEvidenceAgeSeconds", "revokedEvidenceRefs", "limits"],
160
+ "properties": {
161
+ "maxEvidenceAgeSeconds": { "type": "integer", "minimum": 1, "maximum": 86400 },
162
+ "revokedEvidenceRefs": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
163
+ "limits": { "$ref": "#/$defs/limits" }
164
+ }
165
+ },
166
+ "codes": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "type": "string", "pattern": "^[a-z][A-Za-z0-9.:-]{0,159}$" } },
167
+ "nullableSha": { "anyOf": [{ "$ref": "#/$defs/sha" }, { "type": "null" }] },
168
+ "report": {
169
+ "type": "object", "additionalProperties": false,
170
+ "required": ["schemaVersion", "profile", "intentId", "state", "executed", "runtimeReady", "verifiedAdmission", "externalBillingVerified", "selectionVerified", "internalCallCeiling", "remoteCancellationVerified", "reasons", "missing", "externalGates", "audit"],
171
+ "properties": {
172
+ "schemaVersion": { "const": "1.0.0" }, "profile": { "const": "supervised-subscription" },
173
+ "intentId": { "$ref": "#/$defs/nullableId" }, "state": { "enum": ["invalid", "incomplete", "blocked", "ready-for-supervised-review"] },
174
+ "executed": { "const": false }, "runtimeReady": { "const": false }, "verifiedAdmission": { "const": false },
175
+ "externalBillingVerified": { "const": false }, "selectionVerified": { "const": false },
176
+ "internalCallCeiling": { "type": "null" }, "remoteCancellationVerified": { "const": false },
177
+ "reasons": { "$ref": "#/$defs/codes" }, "missing": { "$ref": "#/$defs/codes" },
178
+ "externalGates": { "const": ["trusted-authorization-and-limitations", "native-installation-and-controls", "subscription-and-billing", "selection-and-private-context", "supervised-history-and-durable-reservation", "local-supervision-and-termination", "human-result-review"] },
179
+ "audit": {
180
+ "type": "object", "additionalProperties": false, "required": ["inputSha256", "scopeSha256", "policySha256"],
181
+ "properties": { "inputSha256": { "$ref": "#/$defs/nullableSha" }, "scopeSha256": { "$ref": "#/$defs/nullableSha" }, "policySha256": { "$ref": "#/$defs/sha" } }
182
+ }
183
+ }
184
+ }
185
+ }
186
+ }