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.
- package/.claude-plugin/marketplace.json +28 -0
- package/LICENSE +26 -0
- package/README.md +79 -2
- package/agents/claude/docs-researcher.md +9 -0
- package/agents/claude/implementation-tutor.md +9 -0
- package/agents/claude/project-explorer.md +9 -0
- package/agents/claude/quality-reviewer.md +9 -0
- package/agents/claude/requirements-analyst.md +9 -0
- package/agents/claude/solution-architect.md +9 -0
- package/agents/codex/docs-researcher.toml +10 -0
- package/agents/codex/implementation-tutor.toml +10 -0
- package/agents/codex/project-explorer.toml +10 -0
- package/agents/codex/quality-reviewer.toml +10 -0
- package/agents/codex/requirements-analyst.toml +11 -0
- package/agents/codex/solution-architect.toml +10 -0
- package/assets/brand/README.md +38 -0
- package/assets/brand/agent-toolkit-mark.png +0 -0
- package/assets/brand/agent-toolkit-mark.svg +13 -0
- package/assets/brand/agent-toolkit-tui-hero.png +0 -0
- package/assets/brand/nexakit-readme-hero.png +0 -0
- package/assets/brand/nexakit-readme-hero.svg +21 -0
- package/assets/runtime/package-lock.json +1425 -0
- package/bin/agent-task.js +14 -0
- package/bin/agent-toolkit-gemini.js +13 -0
- package/bin/agent-toolkit-inbox.js +14 -0
- package/bin/agent-toolkit-mcp.js +17 -0
- package/bin/agent-toolkit.js +13 -0
- package/bin/nexakit.js +13 -0
- package/bin/project-memory-mcp.js +22 -0
- package/bin/project-memory.js +7 -0
- package/catalogs/skills/api-design-principles/LICENSE.txt +21 -0
- package/catalogs/skills/api-design-principles/SKILL.md +110 -0
- package/catalogs/skills/api-design-principles/assets/api-design-checklist.md +155 -0
- package/catalogs/skills/api-design-principles/assets/rest-api-template.py +185 -0
- package/catalogs/skills/api-design-principles/references/details.md +413 -0
- package/catalogs/skills/api-design-principles/references/graphql-schema-design.md +589 -0
- package/catalogs/skills/api-design-principles/references/rest-best-practices.md +408 -0
- package/catalogs/skills/nodejs-backend-patterns/LICENSE.txt +21 -0
- package/catalogs/skills/nodejs-backend-patterns/SKILL.md +45 -0
- package/catalogs/skills/nodejs-backend-patterns/references/advanced-patterns.md +430 -0
- package/catalogs/skills/nodejs-backend-patterns/references/details.md +599 -0
- package/catalogs/skills/supabase-postgres-best-practices/CHANGELOG.md +73 -0
- package/catalogs/skills/supabase-postgres-best-practices/LICENSE.txt +21 -0
- package/catalogs/skills/supabase-postgres-best-practices/SKILL.md +64 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/_contributing.md +170 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/_sections.md +39 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/_template.md +34 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/advanced-full-text-search.md +55 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/advanced-jsonb-indexing.md +49 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/conn-idle-timeout.md +46 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/conn-limits.md +44 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/conn-pooling.md +41 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/conn-prepared-statements.md +46 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/data-batch-inserts.md +54 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/data-n-plus-one.md +53 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/data-pagination.md +50 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/data-upsert.md +50 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/lock-advisory.md +56 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/lock-deadlock-prevention.md +68 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/lock-short-transactions.md +50 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/lock-skip-locked.md +54 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/monitor-explain-analyze.md +45 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/monitor-pg-stat-statements.md +55 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/monitor-vacuum-analyze.md +55 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/query-composite-indexes.md +44 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/query-covering-indexes.md +40 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/query-index-types.md +48 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/query-missing-indexes.md +43 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/query-partial-indexes.md +45 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/schema-constraints.md +80 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/schema-data-types.md +46 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/schema-foreign-key-indexes.md +59 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/schema-lowercase-identifiers.md +55 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/schema-partitioning.md +55 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/schema-primary-keys.md +61 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/security-privileges.md +54 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/security-rls-basics.md +50 -0
- package/catalogs/skills/supabase-postgres-best-practices/references/security-rls-performance.md +63 -0
- package/catalogs/skills/vercel-composition-patterns/AGENTS.md +946 -0
- package/catalogs/skills/vercel-composition-patterns/LICENSE.txt +27 -0
- package/catalogs/skills/vercel-composition-patterns/README.md +60 -0
- package/catalogs/skills/vercel-composition-patterns/SKILL.md +89 -0
- package/catalogs/skills/vercel-composition-patterns/metadata.json +11 -0
- package/catalogs/skills/vercel-composition-patterns/rules/_sections.md +29 -0
- package/catalogs/skills/vercel-composition-patterns/rules/_template.md +24 -0
- package/catalogs/skills/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
- package/catalogs/skills/vercel-composition-patterns/rules/architecture-compound-components.md +112 -0
- package/catalogs/skills/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -0
- package/catalogs/skills/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -0
- package/catalogs/skills/vercel-composition-patterns/rules/react19-no-forwardref.md +42 -0
- package/catalogs/skills/vercel-composition-patterns/rules/state-context-interface.md +191 -0
- package/catalogs/skills/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -0
- package/catalogs/skills/vercel-composition-patterns/rules/state-lift-state.md +125 -0
- package/catalogs/skills/vercel-react-best-practices/AGENTS.md +3810 -0
- package/catalogs/skills/vercel-react-best-practices/LICENSE.txt +27 -0
- package/catalogs/skills/vercel-react-best-practices/README.md +123 -0
- package/catalogs/skills/vercel-react-best-practices/SKILL.md +149 -0
- package/catalogs/skills/vercel-react-best-practices/metadata.json +15 -0
- package/catalogs/skills/vercel-react-best-practices/rules/_sections.md +46 -0
- package/catalogs/skills/vercel-react-best-practices/rules/_template.md +28 -0
- package/catalogs/skills/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
- package/catalogs/skills/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
- package/catalogs/skills/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
- package/catalogs/skills/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
- package/catalogs/skills/vercel-react-best-practices/rules/async-api-routes.md +38 -0
- package/catalogs/skills/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
- package/catalogs/skills/vercel-react-best-practices/rules/async-defer-await.md +82 -0
- package/catalogs/skills/vercel-react-best-practices/rules/async-dependencies.md +51 -0
- package/catalogs/skills/vercel-react-best-practices/rules/async-parallel.md +28 -0
- package/catalogs/skills/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
- package/catalogs/skills/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
- package/catalogs/skills/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
- package/catalogs/skills/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
- package/catalogs/skills/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
- package/catalogs/skills/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
- package/catalogs/skills/vercel-react-best-practices/rules/bundle-preload.md +50 -0
- package/catalogs/skills/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
- package/catalogs/skills/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
- package/catalogs/skills/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
- package/catalogs/skills/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
- package/catalogs/skills/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
- package/catalogs/skills/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
- package/catalogs/skills/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
- package/catalogs/skills/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
- package/catalogs/skills/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
- package/catalogs/skills/vercel-react-best-practices/rules/js-early-exit.md +50 -0
- package/catalogs/skills/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
- package/catalogs/skills/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
- package/catalogs/skills/vercel-react-best-practices/rules/js-index-maps.md +37 -0
- package/catalogs/skills/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
- package/catalogs/skills/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
- package/catalogs/skills/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
- package/catalogs/skills/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
- package/catalogs/skills/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rendering-activity.md +26 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rerender-memo.md +44 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
- package/catalogs/skills/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
- package/catalogs/skills/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
- package/catalogs/skills/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
- package/catalogs/skills/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
- package/catalogs/skills/vercel-react-best-practices/rules/server-cache-react.md +76 -0
- package/catalogs/skills/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
- package/catalogs/skills/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
- package/catalogs/skills/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
- package/catalogs/skills/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
- package/catalogs/skills/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
- package/catalogs/skills/vercel-react-best-practices/rules/server-serialization.md +38 -0
- package/catalogs/skills/webapp-testing/LICENSE.txt +202 -0
- package/catalogs/skills/webapp-testing/SKILL.md +96 -0
- package/catalogs/skills/webapp-testing/examples/console_logging.py +35 -0
- package/catalogs/skills/webapp-testing/examples/element_discovery.py +40 -0
- package/catalogs/skills/webapp-testing/examples/static_html_automation.py +33 -0
- package/catalogs/skills/webapp-testing/scripts/with_server.py +106 -0
- package/catalogs/skills.json +1115 -0
- package/docs/skills/evidencias/2026-10-28-evaluacion-inicial-mcp-seguridad.md +118 -0
- package/docs/skills/evidencias/2026-10-28-incorporacion-mcp-seguridad.json +152 -0
- package/docs/skills/evidencias/2026-10-28-recomendador-preparacion.md +50 -0
- package/package.json +73 -4
- package/plugins/nexakit-modelo/.claude-plugin/plugin.json +1 -0
- package/plugins/nexakit-modelo/hooks/hooks.json +1 -0
- package/plugins/nexakit-modelo/hooks/register.js +48 -0
- package/plugins/nexakit-modelo/hooks/status.js +8 -0
- package/plugins/nexakit-modelo/tests/register.test.ts +21 -0
- package/plugins/nexakit-panel/.claude-plugin/plugin.json +1 -0
- package/plugins/nexakit-panel/README.md +20 -0
- package/plugins/nexakit-panel/hooks/hooks.json +1 -0
- package/plugins/nexakit-panel/hooks/lienzo.js +382 -0
- package/plugins/nexakit-panel/hooks/panel.js +279 -0
- package/plugins/nexakit-panel/hooks/register.tsx +248 -0
- package/plugins/nexakit-panel/tests/lienzo.test.ts +142 -0
- package/plugins/nexakit-panel/tests/panel.test.ts +240 -0
- package/plugins/nexakit-panel/tests/register.test.ts +167 -0
- package/plugins/nexakit-panel/types/index.d.ts +41 -0
- package/plugins/nexakit-sesion/.claude-plugin/plugin.json +1 -0
- package/plugins/nexakit-sesion/README.md +12 -0
- package/plugins/nexakit-sesion/hooks/aviso.js +38 -0
- package/plugins/nexakit-sesion/hooks/hooks.json +1 -0
- package/plugins/nexakit-sesion/hooks/register.js +28 -0
- package/plugins/nexakit-sesion/tests/register.test.ts +96 -0
- package/plugins/niveles/.claude-plugin/plugin.json +5 -0
- package/plugins/niveles/agents/nivel-alto.md +13 -0
- package/plugins/niveles/agents/nivel-exigente.md +13 -0
- package/plugins/niveles/agents/nivel-ligero.md +13 -0
- package/plugins/niveles/agents/nivel-normal.md +13 -0
- package/schemas/agent-client-adapter.schema.json +786 -0
- package/schemas/agent-client-auth-diagnostic.schema.json +801 -0
- package/schemas/agent-client-isolated-variant.schema.json +105 -0
- package/schemas/agent-client-isolated-verification.schema.json +99 -0
- package/schemas/agent-client-managed-preferences-invocation.schema.json +67 -0
- package/schemas/agent-client-managed-preferences.schema.json +63 -0
- package/schemas/agent-client-native-diagnostics.schema.json +85 -0
- package/schemas/agent-client-native-evaluation.schema.json +171 -0
- package/schemas/agent-client-native-preflight.schema.json +90 -0
- package/schemas/agent-client-output.schema.json +551 -0
- package/schemas/agent-client-runtime-fixture.schema.json +90 -0
- package/schemas/agent-client-runtime-local.schema.json +95 -0
- package/schemas/agent-client-runtime.schema.json +1288 -0
- package/schemas/agent-client-selective-config.schema.json +77 -0
- package/schemas/agent-client-supervised-local.schema.json +135 -0
- package/schemas/agent-client-supervised.schema.json +186 -0
- package/schemas/agent-model-preference.schema.json +573 -0
- package/schemas/agent-model-selection.schema.json +311 -0
- package/schemas/agent-task-approvals.schema.json +362 -0
- package/schemas/agent-task-prepare.schema.json +1324 -0
- package/schemas/agent-task-verify.schema.json +198 -0
- package/schemas/project-memory-update.schema.json +33 -0
- package/schemas/project-memory.schema.json +298 -0
- package/schemas/skill-catalog.schema.json +246 -0
- package/schemas/task-workflow-plan-output.schema.json +35 -0
- package/scripts/prepare-package.js +6 -0
- package/scripts/validate-skill-catalog.js +41 -0
- package/skills/cerrar-avisens/SKILL.md +12 -0
- package/skills/cerrar-memoria/SKILL.md +96 -0
- package/skills/cerrar-memoria/references/cierre.md +76 -0
- package/skills/decision-records/SKILL.md +27 -0
- package/skills/decision-records/agents/openai.yaml +7 -0
- package/skills/decision-records/references/adr-template.md +35 -0
- package/skills/differential-review/LICENSE.txt +427 -0
- package/skills/differential-review/SKILL.md +225 -0
- package/skills/differential-review/adversarial.md +203 -0
- package/skills/differential-review/agents/openai.yaml +6 -0
- package/skills/differential-review/assets/trail-of-bits-mark.svg +1 -0
- package/skills/differential-review/methodology.md +234 -0
- package/skills/differential-review/patterns.md +300 -0
- package/skills/differential-review/reporting.md +369 -0
- package/skills/elegir-modelo/SKILL.md +68 -0
- package/skills/elegir-modelo/modelos.mjs +108 -0
- package/skills/frontend-design/LICENSE.txt +177 -0
- package/skills/frontend-design/SKILL.md +71 -0
- package/skills/gemini/SKILL.md +52 -0
- package/skills/imagen/SKILL.md +12 -0
- package/skills/investigar/SKILL.md +11 -0
- package/skills/mcp-builder/LICENSE.txt +202 -0
- package/skills/mcp-builder/SKILL.md +236 -0
- package/skills/mcp-builder/reference/evaluation.md +602 -0
- package/skills/mcp-builder/reference/mcp_best_practices.md +249 -0
- package/skills/mcp-builder/reference/node_mcp_server.md +970 -0
- package/skills/mcp-builder/reference/python_mcp_server.md +719 -0
- package/skills/mcp-builder/scripts/connections.py +151 -0
- package/skills/mcp-builder/scripts/evaluation.py +373 -0
- package/skills/mcp-builder/scripts/example_evaluation.xml +22 -0
- package/skills/mcp-builder/scripts/requirements.txt +2 -0
- package/skills/ordenar-proyecto/SKILL.md +56 -0
- package/skills/project-handoff/SKILL.md +53 -0
- package/skills/project-handoff/agents/openai.yaml +7 -0
- package/skills/project-handoff/references/handoff-template.md +35 -0
- package/skills/quality-gate/LICENSE.txt +26 -0
- package/skills/quality-gate/SKILL.md +44 -0
- package/skills/quality-gate/agents/openai.yaml +7 -0
- package/skills/quality-gate/references/review-checklist.md +42 -0
- package/skills/revisar/SKILL.md +11 -0
- package/skills/revisar-skill/LICENSE-find-skills.txt +26 -0
- package/skills/revisar-skill/SKILL.md +94 -0
- package/skills/revision-cruzada/SKILL.md +59 -0
- package/skills/web-design-guidelines/AGENTS.md +156 -0
- package/skills/web-design-guidelines/LICENSE.txt +21 -0
- package/skills/web-design-guidelines/SKILL.md +29 -0
- package/src/agent-models.js +131 -0
- package/src/brand.js +117 -0
- package/src/claude-code-runner.js +642 -0
- package/src/cli-executable.js +88 -0
- package/src/cli.js +778 -0
- package/src/client-adapter-plan.js +271 -0
- package/src/client-auth-diagnostic-parser.js +211 -0
- package/src/client-auth-diagnostic.js +257 -0
- package/src/client-isolated-variant.js +106 -0
- package/src/client-isolated-verification.js +130 -0
- package/src/client-local-platform.js +14 -0
- package/src/client-managed-preferences-invocation.js +209 -0
- package/src/client-managed-preferences.js +78 -0
- package/src/client-native-access.js +134 -0
- package/src/client-native-diagnostics.js +253 -0
- package/src/client-native-evaluation.js +106 -0
- package/src/client-native-preflight-files.js +68 -0
- package/src/client-native-preflight.js +95 -0
- package/src/client-output-json.js +118 -0
- package/src/client-output-parser.js +278 -0
- package/src/client-runtime-admission.js +80 -0
- package/src/client-runtime-coordinator.js +70 -0
- package/src/client-runtime-core.js +92 -0
- package/src/client-runtime-fixture-permit.js +20 -0
- package/src/client-runtime-fixture-protocol.js +39 -0
- package/src/client-runtime-state.js +67 -0
- package/src/client-runtime-store-files.js +91 -0
- package/src/client-runtime-store.js +239 -0
- package/src/client-runtime-supervisor.js +146 -0
- package/src/client-selective-config.js +195 -0
- package/src/client-selective-files.js +126 -0
- package/src/client-supervised-codes.js +32 -0
- package/src/client-supervised-contract.js +52 -0
- package/src/client-supervised-coordinator.js +36 -0
- package/src/client-supervised-permit.js +20 -0
- package/src/client-supervised-protocol.js +37 -0
- package/src/client-supervised-store.js +167 -0
- package/src/client-supervised-supervisor.js +167 -0
- package/src/client-supervised.js +160 -0
- package/src/codex-cli-runner.js +358 -0
- package/src/codex-delivery.js +101 -0
- package/src/connect.js +703 -0
- package/src/doctor.js +795 -0
- package/src/gemini-cli.js +76 -0
- package/src/gemini-files.js +45 -0
- package/src/gemini-tools.js +249 -0
- package/src/init.js +473 -0
- package/src/install-lock.js +127 -0
- package/src/install-registry.js +61 -0
- package/src/legacy-repair.js +71 -0
- package/src/level-agents.js +111 -0
- package/src/link-states.js +172 -0
- package/src/memory-connection-artifacts.js +192 -0
- package/src/memory-connection-descriptor.js +158 -0
- package/src/memory-connection-diagnostic.js +177 -0
- package/src/memory-connection-files.js +191 -0
- package/src/memory-connection-manifest.js +118 -0
- package/src/memory-connection-package.js +176 -0
- package/src/memory-connection-plan.js +211 -0
- package/src/memory-connection-skill.js +211 -0
- package/src/memory-connection-toml.js +153 -0
- package/src/memory-locator.js +118 -0
- package/src/memory-mcp-policy.js +181 -0
- package/src/memory-mcp-server.js +166 -0
- package/src/memory-mcp-transport.js +59 -0
- package/src/missing-dependencies.js +21 -0
- package/src/model-command.js +147 -0
- package/src/model-preference.js +235 -0
- package/src/model-selection.js +368 -0
- package/src/native/managed-preferences.c +100 -0
- package/src/native/managed-preferences.h +17 -0
- package/src/package-lock-path.js +13 -0
- package/src/panel-cli.js +182 -0
- package/src/peer-handoff.js +27 -0
- package/src/peer-inbox-cli.js +211 -0
- package/src/peer-review-mcp.js +210 -0
- package/src/peer-review-store.js +532 -0
- package/src/platform.js +24 -0
- package/src/project-root.js +41 -0
- package/src/project-signals.js +339 -0
- package/src/recommend-report.js +77 -0
- package/src/review-instructions.js +211 -0
- package/src/review-policy.js +35 -0
- package/src/revision-adapters.js +157 -0
- package/src/revision-context.js +86 -0
- package/src/revision-isolation.js +222 -0
- package/src/revision-process.js +103 -0
- package/src/revision-provenance.js +89 -0
- package/src/revision-snapshot.js +120 -0
- package/src/revision.js +242 -0
- package/src/runtime-fixtures/runtime-supervisor/child.cjs +3 -0
- package/src/runtime-fixtures/runtime-supervisor/fixture.cjs +49 -0
- package/src/runtime-fixtures/supervised/child.cjs +3 -0
- package/src/runtime-fixtures/supervised/fixture.cjs +47 -0
- package/src/sensitive-data.js +21 -0
- package/src/setup-apply.js +231 -0
- package/src/setup-plan.js +231 -0
- package/src/setup-state.js +277 -0
- package/src/setup-tui.js +555 -0
- package/src/skill-catalog-add.js +91 -0
- package/src/skill-catalog-audit.js +68 -0
- package/src/skill-catalog.js +170 -0
- package/src/skill-files.js +39 -0
- package/src/skill-recommendations.js +1673 -0
- package/src/skill-scan-report.js +14 -0
- package/src/skill-scan.js +178 -0
- package/src/stable-command.js +53 -0
- package/src/stable-install.js +222 -0
- package/src/status.js +200 -0
- package/src/superpowers.js +133 -0
- package/src/sync-apply.js +227 -0
- package/src/sync-files.js +109 -0
- package/src/sync-inspect.js +394 -0
- package/src/sync-ledger.js +94 -0
- package/src/sync-markdown.js +151 -0
- package/src/sync-proposal.js +84 -0
- package/src/sync-record.js +459 -0
- package/src/sync.js +360 -0
- package/src/task-approvals.js +367 -0
- package/src/task-cli.js +79 -0
- package/src/task-external-verifier.js +584 -0
- package/src/task-prepare-files.js +115 -0
- package/src/task-prepare.js +180 -0
- package/src/task-verify-cli.js +67 -0
- package/src/task-verify-files.js +188 -0
- package/src/task-verify.js +118 -0
- package/src/task-workflow-mcp.js +544 -0
- package/src/task-workflow-store.js +254 -0
- package/src/terminal-text.js +68 -0
- package/src/toolkit-cli.js +543 -0
- package/src/toolkit-commands-guide.js +107 -0
- package/src/toolkit-setup.js +614 -0
- package/src/usage-metrics.js +43 -0
- package/templates/agent-team/01-encargo.md +158 -0
- package/templates/agent-team/02-propuesta.md +132 -0
- package/templates/agent-team/03-revision.md +150 -0
- package/templates/agent-team/README.md +213 -0
- package/templates/model-inventory/01-inventario.md +154 -0
- package/templates/model-inventory/README.md +115 -0
- package/templates/project-memory/README.md +67 -0
- package/templates/project-memory/project-memory.example.json +53 -0
- package/templates/project-memory/skill/project-id/SKILL.md +37 -0
- package/templates/project-memory/skill/project-id/references/project-profile.md +44 -0
- package/templates/project-memory/vault/00-INICIO/Estado actual.md +44 -0
- package/templates/project-memory/vault/00-INICIO/Fuentes de verdad.md +30 -0
- package/templates/project-memory/vault/00-INICIO/Inicio del proyecto.md +44 -0
- package/templates/project-memory/vault/00-INICIO/Mantenimiento de la memoria.md +26 -0
- package/templates/project-memory/vault/00-INICIO/Mapa de la memoria.md +33 -0
- package/templates/project-memory/vault/00-INICIO/Registro de sincronizaci/303/263n.md" +28 -0
- package/templates/project-memory/vault/01-PRODUCTO/Producto.md +16 -0
- package/templates/project-memory/vault/02-ARQUITECTURA/Arquitectura.md +16 -0
- package/templates/project-memory/vault/03-IMPLEMENTACION/Implementaci/303/263n.md +15 -0
- package/templates/project-memory/vault/04-DECISIONES/Decisiones.md +19 -0
- package/templates/project-memory/vault/05-ENTREGAS/Entregas.md +12 -0
- package/templates/project-memory/vault/06-OPERACION/Operaci/303/263n.md +15 -0
- package/templates/project-memory/vault/07-AGENTES/Protocolo de agentes.md +33 -0
- package/templates/project-memory/vault/08-RECURSOS/Recursos.md +12 -0
- 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
|
+
}
|