@inneranimalmedia/agentsam-sdk 2.6.1 → 2.6.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTSAM.md +45 -1
- package/README.md +80 -0
- package/apps/README.md +34 -0
- package/apps/cad-creator/README.md +728 -0
- package/apps/cad-creator/shared/cad/package.json +19 -0
- package/apps/cad-creator/shared/cad/src/domain/operations.ts +7 -0
- package/apps/cad-creator/shared/cad/src/domain/project-contract.d.ts +3 -0
- package/apps/cad-creator/shared/cad/src/domain/project-contract.js +75 -0
- package/apps/cad-creator/shared/cad/src/domain/project-tools.d.ts +1 -0
- package/apps/cad-creator/shared/cad/src/domain/project-tools.js +24 -0
- package/apps/cad-creator/shared/cad/src/domain/validation.ts +191 -0
- package/apps/cad-creator/shared/cad/src/index.ts +4 -0
- package/apps/cad-creator/shared/cad/src/robotics/types.ts +232 -0
- package/apps/cad-creator/shared/cad/src/types.ts +507 -0
- package/apps/cad-creator/shared/cad/tsconfig.json +14 -0
- package/docs/AUTH_IDENTITY_CONTRACT.md +25 -27
- package/docs/AUTORAG.md +58 -0
- package/docs/BRAND_INTELLIGENCE.md +30 -0
- package/docs/CLI_SHELL.md +4 -2
- package/docs/CMS_CONTEXTUAL_COMPOSER.md +38 -0
- package/docs/MERKLE.md +4 -0
- package/docs/PROJECT_CONFIG.md +3 -0
- package/docs/REPOSITORY_KNOWLEDGE.md +2 -0
- package/docs/SDK_WORKER.md +4 -3
- package/docs/THEME_REFINERY.md +120 -0
- package/docs/architecture/PROVIDER-TOOLS-AND-COMPACTION.md +60 -0
- package/docs/architecture/STORAGE.md +87 -0
- package/docs/cad-project-tools.md +69 -0
- package/docs/cms-scaffolding-pattern-reference.md +73 -0
- package/docs/plans/AGENTSAM-INTERACTIVE-UI-REQUIREMENTS-codex-tui-20260919.md +113 -0
- package/docs/plans/AGENTSAM-INTERACTIVE-UI-REQUIREMENTS.md +85 -0
- package/docs/plans/AGENTSAM-MCP-CLIENT-2026-09-19.md +181 -0
- package/docs/plans/ASBD-PORTABLE-WORKGRAPH-UI-DEFERRED.md +34 -0
- package/docs/plans/ASTRA-BRIEF-2026-09-18.md +258 -0
- package/docs/plans/MULTI-AGENT-SPRINTS-2026-09-19.md +373 -0
- package/docs/plans/NEXT-AGENT-HANDOFF.md +167 -0
- package/docs/plans/RECONCILIATION-2026-09-19.md +178 -0
- package/docs/plugins.md +43 -0
- package/docs/tools/README.md +57 -0
- package/docs/tools/agent-and-orchestration.md +49 -0
- package/docs/tools/browser-and-research.md +46 -0
- package/docs/tools/cloudflare-platform.md +32 -0
- package/docs/tools/cms.md +25 -0
- package/docs/tools/communications.md +41 -0
- package/docs/tools/database-and-storage.md +62 -0
- package/docs/tools/design-and-media.md +64 -0
- package/docs/tools/filesystem-and-code.md +55 -0
- package/docs/tools/github.md +56 -0
- package/docs/tools/integrations-and-misc.md +16 -0
- package/docs/tools/memory.md +21 -0
- package/docs/tools/terminal-and-execution.md +29 -0
- package/docs/tools/tickets-and-platform.md +30 -0
- package/migrations/d1/0001_agentsam_plugin_runtime.sql +177 -0
- package/migrations/d1/0002_agentsam_ticket_ownership.sql +8 -0
- package/migrations/d1/0002_dynamic_model_policies.sql +23 -0
- package/migrations/d1/0003_expand_tool_handler_families.sql +18 -0
- package/migrations/d1/0004_project_aware_retrieval_lanes.sql +24 -0
- package/migrations/d1/0005_portable_knowledge_identity.sql +104 -0
- package/migrations/d1/0006_repair_ops_trail_account_scope.sql +14 -0
- package/migrations/d1/0007_repair_ops_trail_agent_run_account.sql +13 -0
- package/migrations/d1/0008_backfill_knowledge_run_legacy_tenant.sql +14 -0
- package/migrations/d1/0009_normalize_cloudflare_plugin_installations.sql +137 -0
- package/migrations/runtime/0001_cli_runtime.sql +67 -0
- package/migrations/runtime/0002_project_sessions.sql +15 -0
- package/migrations/runtime/0003_provider_continuations.sql +8 -0
- package/package.json +92 -12
- package/packages/agentsam-brand/README.md +21 -0
- package/packages/agentsam-brand/package.json +22 -0
- package/packages/agentsam-brand/src/contract.js +59 -0
- package/packages/agentsam-brand/src/extract.js +126 -0
- package/packages/agentsam-brand/src/goap-actions.js +73 -0
- package/packages/agentsam-brand/src/index.js +48 -0
- package/packages/agentsam-brand/src/plan.js +115 -0
- package/packages/agentsam-brand/src/resolve.js +139 -0
- package/packages/agentsam-brand/src/scan.js +250 -0
- package/packages/agentsam-brand/test/brand-scan.test.mjs +106 -0
- package/packages/agentsam-contracts/README.md +23 -0
- package/packages/agentsam-contracts/package.json +32 -0
- package/packages/agentsam-contracts/src/adapter.ts +25 -0
- package/packages/agentsam-contracts/src/agent.ts +35 -0
- package/packages/agentsam-contracts/src/artifacts.ts +33 -0
- package/packages/agentsam-contracts/src/authority.ts +29 -0
- package/packages/agentsam-contracts/src/context.ts +16 -0
- package/packages/agentsam-contracts/src/errors.ts +46 -0
- package/packages/agentsam-contracts/src/events.ts +47 -0
- package/packages/agentsam-contracts/src/execution.ts +50 -0
- package/packages/agentsam-contracts/src/hooks.ts +40 -0
- package/packages/agentsam-contracts/src/identity.ts +16 -0
- package/packages/agentsam-contracts/src/index.ts +14 -0
- package/packages/agentsam-contracts/src/models.ts +9 -0
- package/packages/agentsam-contracts/src/providers.ts +33 -0
- package/packages/agentsam-contracts/src/repository.ts +64 -0
- package/packages/agentsam-contracts/src/tools.ts +98 -0
- package/packages/agentsam-contracts/test/contracts.test.mjs +16 -0
- package/packages/agentsam-contracts/test/errors-catalog.test.mjs +25 -0
- package/packages/agentsam-contracts/test/repository.test.mjs +18 -0
- package/packages/agentsam-contracts/tsconfig.json +12 -0
- package/packages/agentsam-errors/package.json +17 -0
- package/packages/agentsam-errors/src/adapters/anthropic.js +15 -0
- package/packages/agentsam-errors/src/adapters/cad.js +109 -0
- package/packages/agentsam-errors/src/adapters/cloudflare.js +21 -0
- package/packages/agentsam-errors/src/adapters/cursor.js +4 -0
- package/packages/agentsam-errors/src/adapters/device.js +38 -0
- package/packages/agentsam-errors/src/adapters/docker.js +28 -0
- package/packages/agentsam-errors/src/adapters/gcp.js +14 -0
- package/packages/agentsam-errors/src/adapters/github.js +22 -0
- package/packages/agentsam-errors/src/adapters/google.js +17 -0
- package/packages/agentsam-errors/src/adapters/index.js +55 -0
- package/packages/agentsam-errors/src/adapters/internal.js +40 -0
- package/packages/agentsam-errors/src/adapters/oauth.js +24 -0
- package/packages/agentsam-errors/src/adapters/openai.js +17 -0
- package/packages/agentsam-errors/src/adapters/process.js +35 -0
- package/packages/agentsam-errors/src/adapters/provider.js +114 -0
- package/packages/agentsam-errors/src/envelope.js +186 -0
- package/packages/agentsam-errors/src/error.js +24 -0
- package/packages/agentsam-errors/src/fingerprint.js +35 -0
- package/packages/agentsam-errors/src/index.js +10 -0
- package/packages/agentsam-errors/src/normalize.js +30 -0
- package/packages/agentsam-errors/src/redaction.js +52 -0
- package/packages/agentsam-errors/src/render.js +16 -0
- package/packages/agentsam-errors/src/retry.js +10 -0
- package/packages/agentsam-errors/src/transport.js +52 -0
- package/packages/agentsam-errors/src/vocabulary.js +320 -0
- package/packages/agentsam-errors/test/envelope.test.mjs +70 -0
- package/packages/agentsam-errors/test/providers.test.mjs +99 -0
- package/packages/agentsam-errors/test/redaction.test.mjs +21 -0
- package/packages/agentsam-errors/test/runtime-cad-device.test.mjs +76 -0
- package/packages/agentsam-errors/test/transport.test.mjs +46 -0
- package/packages/agentsam-knowledge/package.json +15 -0
- package/packages/agentsam-knowledge/src/autorag/index.js +64 -0
- package/packages/agentsam-knowledge/src/backends/index.js +26 -0
- package/packages/agentsam-knowledge/src/index.js +3 -0
- package/packages/agentsam-knowledge/src/providers/index.js +95 -0
- package/packages/agentsam-knowledge/test/autorag.test.mjs +42 -0
- package/packages/agentsam-nav/README.md +40 -0
- package/packages/agentsam-nav/dist/Nav.d.ts +43 -0
- package/packages/agentsam-nav/dist/NavCollapsible.d.ts +10 -0
- package/packages/agentsam-nav/dist/NavContent.d.ts +2 -0
- package/packages/agentsam-nav/dist/NavFooter.d.ts +2 -0
- package/packages/agentsam-nav/dist/NavGroup.d.ts +3 -0
- package/packages/agentsam-nav/dist/NavHeader.d.ts +2 -0
- package/packages/agentsam-nav/dist/NavMenu.d.ts +22 -0
- package/packages/agentsam-nav/dist/NavProvider.d.ts +35 -0
- package/packages/agentsam-nav/dist/NavTrigger.d.ts +2 -0
- package/packages/agentsam-nav/dist/Surfaces.d.ts +41 -0
- package/packages/agentsam-nav/dist/browser.d.ts +11 -0
- package/packages/agentsam-nav/dist/browser.global.js +132 -0
- package/packages/agentsam-nav/dist/browser.js +613 -0
- package/packages/agentsam-nav/dist/contracts.d.ts +76 -0
- package/packages/agentsam-nav/dist/index.d.ts +11 -0
- package/packages/agentsam-nav/dist/index.js +614 -0
- package/packages/agentsam-nav/dist/legacy.css +83 -0
- package/packages/agentsam-nav/dist/shell.css +113 -0
- package/packages/agentsam-nav/dist/theme.css +113 -0
- package/packages/agentsam-nav/dist/utils.d.ts +1 -0
- package/packages/agentsam-nav/package.json +43 -0
- package/packages/agentsam-queue-control/README.md +107 -0
- package/packages/agentsam-queue-control/package.json +31 -0
- package/packages/agentsam-queue-control/schemas/job-envelope.schema.json +56 -0
- package/packages/agentsam-queue-control/src/adapters/cloudflare.js +152 -0
- package/packages/agentsam-queue-control/src/adapters/memory.js +38 -0
- package/packages/agentsam-queue-control/src/contracts.js +130 -0
- package/packages/agentsam-queue-control/src/control-plane.js +141 -0
- package/packages/agentsam-queue-control/src/dispatch.js +43 -0
- package/packages/agentsam-queue-control/src/index.js +7 -0
- package/packages/agentsam-queue-control/src/policy.js +88 -0
- package/packages/agentsam-queue-control/src/topology.js +66 -0
- package/packages/agentsam-queue-control/test/queue-control.test.mjs +100 -0
- package/packages/agentsam-repository/src/goap.js +718 -0
- package/packages/agentsam-repository/src/goap.js.bak-20260922011251 +670 -0
- package/packages/agentsam-repository/src/index.js +5 -0
- package/packages/agentsam-repository/src/merkle/cloudflare-persistence.js +2 -2
- package/packages/agentsam-repository/src/tickets.js +184 -0
- package/packages/agentsam-repository/src/work-tracking.js +199 -0
- package/packages/agentsam-repository/src/workspace-state.js +176 -0
- package/packages/agentsam-repository/test/goap-tickets-workspace-state.test.mjs +152 -0
- package/packages/connectors/cloudflare/src/index.js +297 -15
- package/packages/connectors/cloudflare/src/owner.js +43 -40
- package/packages/connectors/cloudflare/src/routes.js +167 -26
- package/packages/connectors/cloudflare/tests/connector.test.mjs +112 -2
- package/packages/heuristic-theme/README.md +11 -0
- package/packages/heuristic-theme/package.json +25 -0
- package/packages/heuristic-theme/src/index.js +2 -0
- package/packages/heuristic-theme/src/registry.js +36 -0
- package/packages/heuristic-theme/src/theme.js +41 -0
- package/packages/heuristic-theme/test/theme.test.mjs +26 -0
- package/packages/identity/.agentsam/features/oauth-login-portal/agentsam.feature.json +64 -0
- package/packages/identity/.agentsam/features/oauth-login-portal/providers.json +96 -0
- package/packages/identity/.agentsam/features/oauth-login-portal/resources.json +47 -0
- package/packages/identity/.agentsam/features/oauth-login-portal/routes.json +74 -0
- package/packages/identity/.agentsam/features/oauth-login-portal/ui.json +35 -0
- package/packages/identity/package.json +4 -3
- package/packages/identity/src/adapters/cloudflare-d1/ids.js +4 -0
- package/packages/identity/src/adapters/cloudflare-d1/index.js +39 -1
- package/packages/identity/src/contracts/auth-config.js +23 -40
- package/packages/identity/src/contracts/provider.js +3 -2
- package/packages/identity/src/frontend/auth-portal/pages/login.html +7 -0
- package/packages/identity/src/index.js +2 -0
- package/packages/identity/src/oauth/credentials.js +13 -0
- package/packages/identity/src/oauth/iam-platform.js +5 -5
- package/packages/identity/src/providers/cloudflare/index.js +19 -0
- package/packages/identity/src/providers/cloudflare/mapper.js +21 -0
- package/packages/identity/src/providers/cloudflare/oauth.js +48 -0
- package/packages/identity/src/providers/cloudflare/profile.js +28 -0
- package/packages/identity/src/providers/index.js +18 -2
- package/packages/identity/src/server/identity-service.js +13 -3
- package/packages/identity/src/server/worker-router.js +63 -8
- package/packages/identity/tests/auth-config.test.mjs +14 -23
- package/packages/identity/tests/identity-service.test.mjs +15 -0
- package/packages/providers/completeful/README.md +38 -0
- package/packages/providers/completeful/package.json +29 -0
- package/packages/providers/completeful/src/client.js +162 -0
- package/packages/providers/completeful/src/events.js +49 -0
- package/packages/providers/completeful/src/index.js +22 -0
- package/packages/providers/completeful/src/tools.js +579 -0
- package/packages/providers/completeful/src/webhooks.js +55 -0
- package/packages/providers/completeful/test/provider.test.mjs +196 -0
- package/packages/theme-church-site/README.md +10 -0
- package/packages/theme-church-site/package.json +30 -0
- package/packages/theme-church-site/src/harvest.json +14 -0
- package/packages/theme-church-site/src/index.js +84 -0
- package/packages/theme-church-site/test/theme.test.mjs +19 -0
- package/packages/theme-companions-site/README.md +10 -0
- package/packages/theme-companions-site/package.json +30 -0
- package/packages/theme-companions-site/src/harvest.json +12 -0
- package/packages/theme-companions-site/src/index.js +82 -0
- package/packages/theme-companions-site/test/theme.test.mjs +19 -0
- package/packages/theme-floors-site/README.md +10 -0
- package/packages/theme-floors-site/package.json +30 -0
- package/packages/theme-floors-site/src/harvest.json +14 -0
- package/packages/theme-floors-site/src/index.js +82 -0
- package/packages/theme-floors-site/test/theme.test.mjs +19 -0
- package/packages/theme-fuelnfree-site/README.md +10 -0
- package/packages/theme-fuelnfree-site/package.json +30 -0
- package/packages/theme-fuelnfree-site/src/harvest.json +13 -0
- package/packages/theme-fuelnfree-site/src/index.js +81 -0
- package/packages/theme-fuelnfree-site/test/theme.test.mjs +19 -0
- package/packages/theme-handyman-site/README.md +10 -0
- package/packages/theme-handyman-site/package.json +30 -0
- package/packages/theme-handyman-site/src/harvest.json +10 -0
- package/packages/theme-handyman-site/src/index.js +83 -0
- package/packages/theme-handyman-site/test/theme.test.mjs +19 -0
- package/packages/theme-insurance-site/README.md +10 -0
- package/packages/theme-insurance-site/package.json +30 -0
- package/packages/theme-insurance-site/src/harvest.json +10 -0
- package/packages/theme-insurance-site/src/index.js +83 -0
- package/packages/theme-insurance-site/test/theme.test.mjs +19 -0
- package/packages/theme-shinshu-site/README.md +10 -0
- package/packages/theme-shinshu-site/package.json +30 -0
- package/packages/theme-shinshu-site/src/harvest.json +12 -0
- package/packages/theme-shinshu-site/src/index.js +83 -0
- package/packages/theme-shinshu-site/test/theme.test.mjs +19 -0
- package/packages/work-graph/README.md +49 -0
- package/packages/work-graph/package.json +19 -0
- package/packages/work-graph/prototype/README.md +32 -0
- package/packages/work-graph/prototype/data/demo-workgraph.js +47 -0
- package/packages/work-graph/prototype/renderers/timeline-model.js +21 -0
- package/packages/work-graph/prototype/renderers/workgraph-runtime.js +38 -0
- package/packages/work-graph/prototype-gnantt.html +655 -0
- package/packages/work-graph/src/adapters/business/projects.js +23 -0
- package/packages/work-graph/src/adapters/engineering/git.js +22 -0
- package/packages/work-graph/src/adapters/engineering/mcp.js +22 -0
- package/packages/work-graph/src/index.js +76 -0
- package/packages/work-graph/src/renderers/gantt-model.js +11 -0
- package/packages/work-graph/src/renderers/timeline.js +16 -0
- package/packages/work-graph/test/work-graph.test.mjs +37 -0
- package/protocol/README.md +12 -0
- package/protocol/capabilities/cloudflare-cpu-audit-input.schema.json +30 -6
- package/protocol/capabilities/cloudflare-cpu-profile-input.schema.json +18 -4
- package/protocol/capabilities/cloudflare-wrangler-native-input.schema.json +59 -10
- package/protocol/capabilities/knowledge-search-input.schema.json +35 -0
- package/protocol/capabilities/manifest.json +163 -1
- package/protocol/capabilities/repository-audit-input.schema.json +39 -6
- package/protocol/capabilities/repository-snapshot-input.schema.json +15 -3
- package/protocol/capabilities/terminal-exec-input.schema.json +55 -0
- package/protocol/commerce/catalog.v1.json +50 -0
- package/protocol/errors/error-catalog.json +164 -0
- package/protocol/errors/error-envelope.schema.json +544 -0
- package/protocol/features/README.md +57 -0
- package/protocol/features/agentsam.feature.v1.schema.json +290 -0
- package/protocol/features/catalog.json +65 -0
- package/protocol/features/examples/provider-resend.feature.json +17 -0
- package/protocol/go/agentsam-go-runtime.v1.json +17 -0
- package/protocol/knowledge/LIFECYCLE.md +140 -0
- package/protocol/knowledge/README.md +4 -0
- package/protocol/presets/catalog.json +128 -19
- package/protocol/rpc/v1/errors.proto +24 -0
- package/protocol/theme-refinery/d1-reconciliation.md +48 -0
- package/protocol/theme-refinery/product-metadata.schema.json +27 -0
- package/protocol/theme-refinery/receipts/products-registry-batch-20260924.json +318 -0
- package/protocol/theme-refinery/receipts/theme-harvest-20260924.json +472 -0
- package/protocol/theme-refinery/reconciliation-receipt.schema.json +83 -0
- package/services/cad/server.py +249 -2
- package/src/agent/capability-adapter.js +15 -5
- package/src/agent/index.js +2 -1
- package/src/agent/model-turn.js +51 -0
- package/src/agent/responses-runner.js +304 -38
- package/src/capabilities/index.js +1 -0
- package/src/capabilities/terminal-exec.js +78 -0
- package/src/cli.js +129 -31
- package/src/cloudflare/index.js +6 -0
- package/src/cloudflare/runtime-status.js +393 -0
- package/src/cloudflare/wrangler.js +17 -1
- package/src/commands/account-auth.js +1 -1
- package/src/commands/app.js +106 -0
- package/src/commands/autorag.js +77 -0
- package/src/commands/brand.js +293 -0
- package/src/commands/cad.js +1 -0
- package/src/commands/connections.js +126 -29
- package/src/commands/context-economics.js +8 -0
- package/src/commands/db.js +7 -0
- package/src/commands/deploy.js +2 -2
- package/src/commands/env.js +5 -4
- package/src/commands/eval.js +209 -14
- package/src/commands/go.js +365 -0
- package/src/commands/goap.js +176 -0
- package/src/commands/identity-init.js +27 -3
- package/src/commands/identity-protocol.js +195 -0
- package/src/commands/knowledge.js +64 -5
- package/src/commands/mcp.js +341 -0
- package/src/commands/merkle-persist.js +3 -1
- package/src/commands/merkle.js +18 -3
- package/src/commands/models.js +109 -23
- package/src/commands/plugins.js +175 -0
- package/src/commands/preferences.js +28 -8
- package/src/commands/product.js +53 -10
- package/src/commands/providers.js +389 -0
- package/src/commands/resume.js +9 -5
- package/src/commands/runtime-status.js +154 -0
- package/src/commands/shell.js +469 -54
- package/src/commands/status.js +82 -7
- package/src/commands/tunnel.js +228 -195
- package/src/commands/whoami.js +115 -22
- package/src/context/budget.js +6 -0
- package/src/context/index.js +2 -1
- package/src/context/project-card.js +75 -0
- package/src/errors/contract.js +34 -211
- package/src/errors/diagnostic.js +95 -50
- package/src/errors/index.js +6 -13
- package/src/eval/index.js +6 -0
- package/src/eval/live.js +439 -0
- package/src/features/resolve.js +242 -0
- package/src/go/build.js +108 -0
- package/src/go/cloudflare.js +207 -0
- package/src/go/contract.js +139 -0
- package/src/go/discover.js +96 -0
- package/src/go/index.js +13 -0
- package/src/go/receipts.js +77 -0
- package/src/go/registry.js +223 -0
- package/src/go/verify.js +31 -0
- package/src/index.js +100 -1
- package/src/knowledge/config.js +13 -5
- package/src/knowledge/engine.js +23 -8
- package/src/knowledge/index.js +1 -0
- package/src/knowledge/lane-registry.js +46 -0
- package/src/knowledge/providers/gemini.js +48 -8
- package/src/knowledge/service/client.js +13 -1
- package/src/knowledge/service/grpc-codec.js +156 -53
- package/src/knowledge/service/job-engine.js +133 -11
- package/src/knowledge/service/job-worker.js +34 -5
- package/src/knowledge/service/server.js +10 -1
- package/src/knowledge/store-discovery.js +77 -0
- package/src/lib/account-session.js +100 -25
- package/src/lib/agent-instructions.js +3 -0
- package/src/lib/auth.js +318 -51
- package/src/lib/cad/blender.js +42 -3
- package/src/lib/cad/d1-project-store.js +43 -0
- package/src/lib/cad/discovery.js +616 -0
- package/src/lib/cad/docker-executor.js +352 -0
- package/src/lib/cad/freecad.js +253 -0
- package/src/lib/cad/index.js +40 -0
- package/src/lib/cad/openscad.js +198 -0
- package/src/lib/cad/project-cli.d.ts +2 -0
- package/src/lib/cad/project-cli.js +21 -0
- package/src/lib/cad/project-contract.d.ts +3 -0
- package/src/lib/cad/project-contract.js +1 -0
- package/src/lib/cad/project-recipe.js +30 -0
- package/src/lib/cad/project-runtime.d.ts +2 -0
- package/src/lib/cad/project-runtime.js +53 -0
- package/src/lib/cad/project-store.js +25 -0
- package/src/lib/cad/project-workflows.js +31 -0
- package/src/lib/cad-docker.js +21 -2
- package/src/lib/cli-preferences.js +17 -2
- package/src/lib/core-client.js +97 -33
- package/src/lib/deploy/local-studio.js +6 -5
- package/src/lib/detect-context.js +14 -16
- package/src/lib/dockerize.js +3 -0
- package/src/lib/execution-approvals.js +1 -0
- package/src/lib/identity-scaffold.js +4 -1
- package/src/lib/knowledge-docker.js +9 -1
- package/src/lib/local-sessions.js +124 -34
- package/src/lib/local-status.js +35 -14
- package/src/lib/project-config.js +9 -0
- package/src/lib/provider-credentials.js +233 -55
- package/src/lib/scaffold/resolve-cloudflare-account.js +37 -0
- package/src/lib/scaffold/wizards/cms.js +2 -8
- package/src/lib/scaffold/wizards/worker-api.js +2 -8
- package/src/lib/slash-commands.js +10 -2
- package/src/local/migrations.js +109 -1
- package/src/local/runtime-store.js +31 -5
- package/src/local/sqlite.js +36 -1
- package/src/mcp/authority.js +348 -0
- package/src/mcp/client-adapters.js +431 -0
- package/src/mcp/client.js +172 -0
- package/src/mcp/index.js +47 -0
- package/src/mcp/telemetry.js +103 -0
- package/src/models/catalog.js +329 -51
- package/src/models/discovery.js +59 -4
- package/src/models/index.js +2 -0
- package/src/models/inventory-core.js +182 -0
- package/src/models/policy.js +20 -0
- package/src/plugins/cloudflare.js +103 -0
- package/src/plugins/completeful.js +69 -0
- package/src/plugins/contracts.js +86 -0
- package/src/plugins/index.js +11 -0
- package/src/plugins/registry.js +207 -0
- package/src/plugins/resource-scope.js +45 -0
- package/src/plugins/runtime.js +118 -0
- package/src/plugins/vectorize.js +31 -0
- package/src/progression/engine.js +171 -0
- package/src/progression/index.js +1 -0
- package/src/providers/cloudflare-chat.js +1 -1
- package/src/providers/gemini-generate-content.js +2 -1
- package/src/providers/openai-responses.js +45 -16
- package/src/providers/tool-schema.js +85 -0
- package/src/repository/index.js +29 -0
- package/src/rpc/generated/errors_pb.js +961 -1
- package/src/security/local-vault.js +415 -0
- package/src/security/process.js +20 -4
- package/src/status/actions.js +192 -0
- package/src/tools/hydrate.js +5 -1
- package/src/tools/index.js +7 -0
- package/src/tools/redact.js +64 -0
- package/src/tools/registry.js +83 -0
- package/src/tools/runtime.js +257 -0
- package/src/tools/search.js +21 -8
- package/src/ui/ansi.js +117 -3
- package/src/ui/cli/activity.js +76 -7
- package/src/ui/cli/footer.js +110 -9
- package/src/ui/cli/help.js +14 -5
- package/src/ui/wireframes.js +166 -0
- package/test/account-session.test.mjs +76 -11
- package/test/apps-scaffold-contract.test.mjs +58 -0
- package/test/capabilities.test.mjs +1 -1
- package/test/cli/eval-live.test.mjs +219 -0
- package/test/cli/go.test.mjs +71 -0
- package/test/cli/local-vault-and-provider-setup.test.mjs +268 -0
- package/test/cli/mcp-client.test.mjs +245 -0
- package/test/cli/runtime-ui.test.mjs +69 -2
- package/test/cli/status-actions.test.mjs +88 -0
- package/test/cli/wireframes-go-registry.test.mjs +54 -0
- package/test/cloudflare-connector.test.mjs +3 -6
- package/test/cloudflare-runtime.test.mjs +8 -1
- package/test/context.test.mjs +15 -0
- package/test/error-diagnostics.test.mjs +9 -0
- package/test/fixtures/cad/courtyard-house.json +208 -0
- package/test/go/cloudflare-probe.test.mjs +53 -0
- package/test/integration/app-command.test.mjs +55 -0
- package/test/integration/cad-discovery.test.mjs +158 -0
- package/test/integration/cad-docker-executor.test.mjs +249 -0
- package/test/integration/cad-execution.test.mjs +184 -0
- package/test/integration/cad-project-app.test.mjs +31 -0
- package/test/integration/cad-project-d1.test.mjs +25 -0
- package/test/integration/cad-project-native.test.mjs +24 -0
- package/test/integration/cad-project-workflow.test.mjs +9 -0
- package/test/integration/cad-project.test.mjs +82 -0
- package/test/integration/cli-help.test.mjs +4 -0
- package/test/integration/cms-site-tenancy-contract.test.mjs +256 -0
- package/test/integration/core-client.integration.test.mjs +55 -0
- package/test/integration/error-runtime-rpc.test.mjs +71 -0
- package/test/integration/features-resolve.test.mjs +128 -0
- package/test/integration/install-script.test.mjs +107 -0
- package/test/integration/inventory-core.test.mjs +53 -0
- package/test/integration/plugins-cloudflare.integration.test.mjs +28 -0
- package/test/integration/provider-env-cli.test.mjs +1 -1
- package/test/integration/runtime-migrations.test.mjs +6 -1
- package/test/integration/runtime-status.integration.test.mjs +211 -0
- package/test/integration/scaffold-cloudflare.test.mjs +46 -0
- package/test/integration/storage-architecture.test.mjs +154 -0
- package/test/integration/store-discovery.test.mjs +44 -0
- package/test/integration/terminal-exec.integration.test.mjs +86 -0
- package/test/integration/tool-runtime.test.mjs +124 -0
- package/test/integration/tool-schema.test.mjs +59 -0
- package/test/knowledge-service.test.mjs +4 -0
- package/test/local-sessions.test.mjs +11 -2
- package/test/local-studio-deploy.test.mjs +1 -1
- package/test/model-catalog.test.mjs +28 -1
- package/test/models.test.mjs +159 -5
- package/test/openai-responses.test.mjs +60 -0
- package/test/provider-credentials.test.mjs +15 -5
- package/test/responses-runner.test.mjs +321 -6
- package/test/sdk-worker-contract.test.mjs +5 -1
- package/test/shell.test.mjs +149 -4
- package/test/smoke.mjs +4 -3
- package/test/tools-search.test.mjs +33 -0
- package/test/unit/website-assets-bindings.test.mjs +60 -0
- package/test/whoami-resume.test.mjs +87 -7
- package/examples/gorilla-shell/README.md +0 -15
- package/src/lib/gorilla-template.js +0 -54
- package/src/lib/prompt-byok.js +0 -57
- package/src/lib/save-sdk-token.js +0 -19
- package/templates/gorilla-shell/App.tsx +0 -639
- package/templates/gorilla-shell/README.md +0 -34
- package/templates/gorilla-shell/index.html +0 -15
- package/templates/gorilla-shell/main.jsx +0 -9
- package/templates/gorilla-shell/package.json +0 -19
- package/templates/gorilla-shell/vite.config.js +0 -21
package/src/commands/eval.js
CHANGED
|
@@ -1,12 +1,62 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import {
|
|
2
|
+
evaluateContextFixture,
|
|
3
|
+
finishLiveEvalRun,
|
|
4
|
+
getLiveEvalStatus,
|
|
5
|
+
listContextEvalFixtures,
|
|
6
|
+
startLiveEvalRun,
|
|
7
|
+
} from '../eval/index.js';
|
|
2
8
|
|
|
3
9
|
function parse(argv) {
|
|
4
|
-
|
|
5
|
-
|
|
10
|
+
let subcommand = argv[0] || '';
|
|
11
|
+
let help = false;
|
|
12
|
+
if (subcommand === '--help' || subcommand === '-h') {
|
|
13
|
+
help = true;
|
|
14
|
+
subcommand = '';
|
|
15
|
+
}
|
|
16
|
+
const action = argv[1] || '';
|
|
17
|
+
const out = {
|
|
18
|
+
subcommand,
|
|
19
|
+
action,
|
|
20
|
+
fixture: '',
|
|
21
|
+
strategy: 'all',
|
|
22
|
+
model: '',
|
|
23
|
+
provider: '',
|
|
24
|
+
client: '',
|
|
25
|
+
reasoning: 'high',
|
|
26
|
+
suite: '',
|
|
27
|
+
case: '',
|
|
28
|
+
gate: '',
|
|
29
|
+
tenant: '',
|
|
30
|
+
workspace: '',
|
|
31
|
+
user: '',
|
|
32
|
+
database: '',
|
|
33
|
+
endpoint: '',
|
|
34
|
+
force: false,
|
|
35
|
+
remote: false,
|
|
36
|
+
json: false,
|
|
37
|
+
list: false,
|
|
38
|
+
help,
|
|
39
|
+
};
|
|
40
|
+
|
|
41
|
+
const startIndex = subcommand === 'live' ? 2 : 1;
|
|
42
|
+
for (let i = startIndex; i < argv.length; i += 1) {
|
|
6
43
|
const arg = argv[i];
|
|
7
44
|
if (arg === '--fixture') out.fixture = argv[++i] || '';
|
|
8
45
|
else if (arg === '--strategy') out.strategy = argv[++i] || 'all';
|
|
9
|
-
else if (arg === '--model') out.model = argv[++i] || '
|
|
46
|
+
else if (arg === '--model') out.model = argv[++i] || '';
|
|
47
|
+
else if (arg === '--provider') out.provider = argv[++i] || '';
|
|
48
|
+
else if (arg === '--client') out.client = argv[++i] || '';
|
|
49
|
+
else if (arg === '--reasoning') out.reasoning = argv[++i] || 'high';
|
|
50
|
+
else if (arg === '--suite') out.suite = argv[++i] || '';
|
|
51
|
+
else if (arg === '--case') out.case = argv[++i] || '';
|
|
52
|
+
else if (arg === '--gate') out.gate = argv[++i] || '';
|
|
53
|
+
else if (arg === '--tenant') out.tenant = argv[++i] || '';
|
|
54
|
+
else if (arg === '--workspace') out.workspace = argv[++i] || '';
|
|
55
|
+
else if (arg === '--user') out.user = argv[++i] || '';
|
|
56
|
+
else if (arg === '--database' || arg === '--db') out.database = argv[++i] || '';
|
|
57
|
+
else if (arg === '--endpoint') out.endpoint = argv[++i] || '';
|
|
58
|
+
else if (arg === '--force') out.force = true;
|
|
59
|
+
else if (arg === '--remote') out.remote = true;
|
|
10
60
|
else if (arg === '--json') out.json = true;
|
|
11
61
|
else if (arg === '--list') out.list = true;
|
|
12
62
|
else if (arg === '--help' || arg === '-h') out.help = true;
|
|
@@ -15,7 +65,7 @@ function parse(argv) {
|
|
|
15
65
|
return out;
|
|
16
66
|
}
|
|
17
67
|
|
|
18
|
-
function
|
|
68
|
+
function renderContextReport(report) {
|
|
19
69
|
const rows = [
|
|
20
70
|
'',
|
|
21
71
|
' AgentSam · Context Eval',
|
|
@@ -45,19 +95,164 @@ function render(report) {
|
|
|
45
95
|
return rows.join('\n');
|
|
46
96
|
}
|
|
47
97
|
|
|
98
|
+
function renderLiveHelp() {
|
|
99
|
+
return `
|
|
100
|
+
AgentSam · Live Agent Evaluation
|
|
101
|
+
|
|
102
|
+
Usage:
|
|
103
|
+
agentsam eval live start --case <id> [--suite <id>] [--model <name>] [--provider <name>] [--client <client>] [--reasoning <high|medium|low>]
|
|
104
|
+
agentsam eval live status [--json]
|
|
105
|
+
agentsam eval live finish [--gate PASS|FAIL] [--remote] [--json]
|
|
106
|
+
|
|
107
|
+
Examples:
|
|
108
|
+
agentsam eval live start --suite sdk-real-work-20260919 --case cad-shell-unification --client cursor --model "Muse Spark 1.3"
|
|
109
|
+
agentsam eval live finish --gate PASS --remote
|
|
110
|
+
`;
|
|
111
|
+
}
|
|
112
|
+
|
|
48
113
|
export async function runEval(argv = [], options = {}) {
|
|
49
114
|
const args = parse(argv);
|
|
50
|
-
const write = options.write || (text => process.stdout.write(text));
|
|
51
|
-
|
|
115
|
+
const write = options.write || ((text) => process.stdout.write(text));
|
|
116
|
+
|
|
117
|
+
if (args.help || (!args.subcommand && !argv.length)) {
|
|
52
118
|
write('agentsam eval context --fixture <name> [--strategy bounded|discovery|compact|all] [--model gpt-6-astra] [--json]\n');
|
|
119
|
+
write('agentsam eval live <start|status|finish> [options]\n');
|
|
53
120
|
return null;
|
|
54
121
|
}
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
122
|
+
|
|
123
|
+
if (args.subcommand === 'live') {
|
|
124
|
+
const action = args.action || 'status';
|
|
125
|
+
|
|
126
|
+
if (args.help || !action) {
|
|
127
|
+
write(renderLiveHelp());
|
|
128
|
+
return null;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
if (action === 'start') {
|
|
132
|
+
const run = startLiveEvalRun(
|
|
133
|
+
{
|
|
134
|
+
suite: args.suite,
|
|
135
|
+
case: args.case,
|
|
136
|
+
model: args.model,
|
|
137
|
+
provider: args.provider,
|
|
138
|
+
client: args.client,
|
|
139
|
+
reasoning: args.reasoning,
|
|
140
|
+
tenant: args.tenant,
|
|
141
|
+
workspace: args.workspace,
|
|
142
|
+
user: args.user,
|
|
143
|
+
database: args.database,
|
|
144
|
+
},
|
|
145
|
+
options
|
|
146
|
+
);
|
|
147
|
+
|
|
148
|
+
if (args.json) {
|
|
149
|
+
write(JSON.stringify(run, null, 2) + '\n');
|
|
150
|
+
return run;
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
write(`\n ✓ Started live eval run: ${run.run_id}\n`);
|
|
154
|
+
write(` Suite: ${run.suite_id}\n`);
|
|
155
|
+
write(` Case: ${run.case_id}\n`);
|
|
156
|
+
write(` Tenant: ${run.tenant_id}\n`);
|
|
157
|
+
write(` Model: ${run.model} (${run.reasoning} reasoning)\n`);
|
|
158
|
+
write(` Client: ${run.client} (${run.provider})\n`);
|
|
159
|
+
write(` Base Git: ${run.base_commit.slice(0, 7) || 'clean'} on ${run.branch || 'main'}\n`);
|
|
160
|
+
write(` Started: ${run.started_at}\n\n`);
|
|
161
|
+
return run;
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
if (action === 'status') {
|
|
165
|
+
const status = getLiveEvalStatus(options);
|
|
166
|
+
if (args.json) {
|
|
167
|
+
write(JSON.stringify(status, null, 2) + '\n');
|
|
168
|
+
return status;
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
if (!status.active) {
|
|
172
|
+
write(' No live evaluation run currently in progress.\n');
|
|
173
|
+
return status;
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
const elapsedSec = (status.elapsed_ms / 1000).toFixed(1);
|
|
177
|
+
write(`\n Live Eval In Progress · ${status.run_id}\n`);
|
|
178
|
+
write(` Case: ${status.case_id} (${status.suite_id})\n`);
|
|
179
|
+
write(` Tenant: ${status.tenant_id || 'default'}\n`);
|
|
180
|
+
write(` Model: ${status.model} [${status.client}]\n`);
|
|
181
|
+
write(` Elapsed: ${elapsedSec}s\n`);
|
|
182
|
+
write(` Tool calls: ${status.receipts_summary?.tool_call_count || 0} (${status.receipts_summary?.mcp_call_count || 0} MCP)\n\n`);
|
|
183
|
+
return status;
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
if (action === 'finish') {
|
|
187
|
+
const result = await finishLiveEvalRun({
|
|
188
|
+
...options,
|
|
189
|
+
gate: args.gate,
|
|
190
|
+
remote: args.remote,
|
|
191
|
+
tenant: args.tenant,
|
|
192
|
+
workspace: args.workspace,
|
|
193
|
+
user: args.user,
|
|
194
|
+
database: args.database,
|
|
195
|
+
evalEndpoint: args.endpoint,
|
|
196
|
+
force: args.force,
|
|
197
|
+
});
|
|
198
|
+
|
|
199
|
+
if (args.json) {
|
|
200
|
+
write(JSON.stringify(result, null, 2) + '\n');
|
|
201
|
+
return result;
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
const s = result.summary;
|
|
205
|
+
const elapsedMin = (s.elapsed_ms / 60000).toFixed(1);
|
|
206
|
+
|
|
207
|
+
write(`\n AgentSam Live Eval Summary\n`);
|
|
208
|
+
write(` ────────────────────────────────────────────────────────────\n`);
|
|
209
|
+
write(` Model: ${s.model} (${s.reasoning || 'high'})\n`);
|
|
210
|
+
write(` Case: ${s.case_id} (${s.suite_id})\n`);
|
|
211
|
+
write(` Tenant: ${s.tenant_id}\n`);
|
|
212
|
+
write(` Run ID: ${result.evalRunRow.id}\n`);
|
|
213
|
+
write(` Observation ID: ${result.modelObservationRow?.id || 'N/A'}\n`);
|
|
214
|
+
write(` Elapsed: ${elapsedMin}m (${(s.elapsed_ms / 1000).toFixed(1)}s)\n`);
|
|
215
|
+
write(` Files changed: ${s.files_changed} (+${s.insertions} / -${s.deletions})\n`);
|
|
216
|
+
write(` Tool calls: ${s.tool_call_count} total\n`);
|
|
217
|
+
write(` • MCP calls: ${s.mcp_call_count}\n`);
|
|
218
|
+
write(` • Terminal: ${s.terminal_call_count}\n`);
|
|
219
|
+
write(` • GitHub: ${s.github_call_count}\n`);
|
|
220
|
+
write(` • D1 / Database: ${s.d1_call_count}\n`);
|
|
221
|
+
write(` • Retries: ${s.failure_count}\n`);
|
|
222
|
+
write(` Gate status: ${s.gate_status}\n`);
|
|
223
|
+
write(` Commit: ${s.head_commit?.slice(0, 7) || 'N/A'}\n`);
|
|
224
|
+
write(` Local Archive: ${result.local_file}\n`);
|
|
225
|
+
if (s.d1_executed) {
|
|
226
|
+
write(` D1 Record: ✓ Recorded to ${s.tenant_id} (runs & observations via ${s.persistence_method || 'remote'})\n`);
|
|
227
|
+
} else if (s.d1_error) {
|
|
228
|
+
write(` D1 Record: ⚠ Remote persistence failed: ${s.d1_error}\n`);
|
|
229
|
+
if (s.state_preserved) {
|
|
230
|
+
write(` Status: Active run & telemetry preserved. Retry with --remote or pass --force\n`);
|
|
231
|
+
}
|
|
232
|
+
} else {
|
|
233
|
+
write(` D1 Record: ○ Local only (use --remote to push)\n`);
|
|
234
|
+
}
|
|
235
|
+
write(` ────────────────────────────────────────────────────────────\n\n`);
|
|
236
|
+
return result;
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
throw new Error(`unknown live eval action: ${action}`);
|
|
59
240
|
}
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
241
|
+
|
|
242
|
+
if (args.subcommand === 'context') {
|
|
243
|
+
if (args.list) {
|
|
244
|
+
const value = { fixtures: listContextEvalFixtures() };
|
|
245
|
+
write(args.json ? `${JSON.stringify(value)}\n` : `${value.fixtures.join('\n')}\n`);
|
|
246
|
+
return value;
|
|
247
|
+
}
|
|
248
|
+
const report = await evaluateContextFixture({
|
|
249
|
+
fixture: args.fixture || 'exact-symbol-callers',
|
|
250
|
+
strategy: args.strategy,
|
|
251
|
+
model: args.model || 'gpt-6-astra',
|
|
252
|
+
});
|
|
253
|
+
write(args.json ? `${JSON.stringify(report)}\n` : renderContextReport(report));
|
|
254
|
+
return report;
|
|
255
|
+
}
|
|
256
|
+
|
|
257
|
+
throw new Error(`unknown eval subcommand: ${args.subcommand}`);
|
|
63
258
|
}
|
|
@@ -0,0 +1,365 @@
|
|
|
1
|
+
import path from 'node:path';
|
|
2
|
+
import { cancel, intro, isCancel, outro, select } from '@clack/prompts';
|
|
3
|
+
import pc from 'picocolors';
|
|
4
|
+
import {
|
|
5
|
+
DEFAULT_PRODUCT,
|
|
6
|
+
discoverGoRuntime,
|
|
7
|
+
resolveProductRoot,
|
|
8
|
+
ensureProductContract,
|
|
9
|
+
preflightToolchain,
|
|
10
|
+
buildGoProduct,
|
|
11
|
+
deployGoCloudflare,
|
|
12
|
+
verifyGoProduct,
|
|
13
|
+
readLatestStatus,
|
|
14
|
+
runGoTests,
|
|
15
|
+
runGoVet,
|
|
16
|
+
runGoBuild,
|
|
17
|
+
} from '../go/index.js';
|
|
18
|
+
import { renderGoShipScenery, renderArchitectureExplorer } from '../ui/wireframes.js';
|
|
19
|
+
|
|
20
|
+
function parse(argv = []) {
|
|
21
|
+
const out = {
|
|
22
|
+
subcommand: null,
|
|
23
|
+
product: DEFAULT_PRODUCT,
|
|
24
|
+
cwd: process.cwd(),
|
|
25
|
+
json: false,
|
|
26
|
+
cloudflare: false,
|
|
27
|
+
dryRun: false,
|
|
28
|
+
skipDeploy: false,
|
|
29
|
+
skipRegistry: false,
|
|
30
|
+
help: false,
|
|
31
|
+
positionals: [],
|
|
32
|
+
};
|
|
33
|
+
|
|
34
|
+
for (let i = 0; i < argv.length; i += 1) {
|
|
35
|
+
const arg = argv[i];
|
|
36
|
+
if (arg === '--help' || arg === '-h') out.help = true;
|
|
37
|
+
else if (arg === '--json') out.json = true;
|
|
38
|
+
else if (arg === '--dry-run') out.dryRun = true;
|
|
39
|
+
else if (arg === '--skip-deploy') out.skipDeploy = true;
|
|
40
|
+
else if (arg === '--skip-registry') out.skipRegistry = true;
|
|
41
|
+
else if (arg === '--cwd') out.cwd = path.resolve(argv[++i] || out.cwd);
|
|
42
|
+
else if (arg === '--cloudflare') {
|
|
43
|
+
out.cloudflare = true;
|
|
44
|
+
const next = argv[i + 1];
|
|
45
|
+
if (next && !next.startsWith('-')) {
|
|
46
|
+
out.product = next;
|
|
47
|
+
i += 1;
|
|
48
|
+
}
|
|
49
|
+
} else if (['status', 'inspect', 'build', 'test', 'verify', 'deploy', 'products', 'runtime', 'dev', 'logs', 'explore'].includes(arg) && !out.subcommand) {
|
|
50
|
+
out.subcommand = arg;
|
|
51
|
+
} else if (!arg.startsWith('-')) {
|
|
52
|
+
out.positionals.push(arg);
|
|
53
|
+
} else {
|
|
54
|
+
throw new Error(`unknown go option: ${arg}`);
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
if (!out.subcommand && out.positionals[0] && !out.cloudflare) {
|
|
59
|
+
const maybe = out.positionals[0];
|
|
60
|
+
if (['status', 'inspect', 'build', 'test', 'verify', 'deploy', 'products', 'runtime', 'explore'].includes(maybe)) {
|
|
61
|
+
out.subcommand = maybe;
|
|
62
|
+
out.positionals = out.positionals.slice(1);
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
if (out.positionals[0] && out.product === DEFAULT_PRODUCT) {
|
|
66
|
+
out.product = out.positionals[0];
|
|
67
|
+
}
|
|
68
|
+
if (out.cloudflare && !out.subcommand) out.subcommand = 'cloudflare-ship';
|
|
69
|
+
if (!out.subcommand) out.subcommand = 'menu';
|
|
70
|
+
return out;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
const HELP = `Agent Sam · Go
|
|
74
|
+
|
|
75
|
+
agentsam go Interactive status / actions (TTY)
|
|
76
|
+
agentsam go status [--json] Runtime + product status
|
|
77
|
+
agentsam go explore Architecture + operation wireframes (ANSI)
|
|
78
|
+
agentsam go inspect [--json] Discover Go source / toolchain
|
|
79
|
+
agentsam go test go test ./...
|
|
80
|
+
agentsam go build go build + build receipt
|
|
81
|
+
agentsam go verify [name] [--json] Local tests + optional live probe
|
|
82
|
+
agentsam go --cloudflare [name] Discover → build → validate → deploy → probe → D1 → receipt
|
|
83
|
+
agentsam go deploy [name] --cloudflare
|
|
84
|
+
|
|
85
|
+
First happy path:
|
|
86
|
+
agentsam go --cloudflare agentsam-go-worker
|
|
87
|
+
|
|
88
|
+
Flags:
|
|
89
|
+
--json Machine-readable output
|
|
90
|
+
--dry-run Validate and print plan without deploying
|
|
91
|
+
--skip-deploy Build/test/receipt only (no Wrangler deploy)
|
|
92
|
+
--skip-registry Skip remote D1 agentsam_products upsert
|
|
93
|
+
--cwd <path> Repository root override
|
|
94
|
+
`;
|
|
95
|
+
|
|
96
|
+
function writeHumanSteps(lines, write) {
|
|
97
|
+
write('\n Agent Sam · Go\n\n');
|
|
98
|
+
for (const line of lines) write(` ${line}\n`);
|
|
99
|
+
write('\n');
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
export async function runGo(argv = [], options = {}) {
|
|
103
|
+
const args = parse(argv);
|
|
104
|
+
const write = options.write || ((value) => process.stdout.write(value));
|
|
105
|
+
if (args.help) {
|
|
106
|
+
write(HELP);
|
|
107
|
+
return { ok: true, help: true };
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
const discovery = discoverGoRuntime(args.cwd);
|
|
111
|
+
const productRoot = resolveProductRoot(discovery, args.product);
|
|
112
|
+
const runtimeRoot = discovery.runtime?.runtimeRoot || path.join(productRoot, 'runtime');
|
|
113
|
+
|
|
114
|
+
if (args.subcommand === 'menu' && process.stdout.isTTY && !args.json) {
|
|
115
|
+
return runInteractiveMenu({ discovery, productRoot, runtimeRoot, args, write });
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
if (args.subcommand === 'inspect' || args.subcommand === 'runtime') {
|
|
119
|
+
const payload = { ok: true, discovery, productRoot, runtimeRoot };
|
|
120
|
+
write(args.json ? `${JSON.stringify(payload)}\n` : `${JSON.stringify(payload, null, 2)}\n`);
|
|
121
|
+
return payload;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
if (args.subcommand === 'explore') {
|
|
125
|
+
const scenery = renderGoShipScenery({
|
|
126
|
+
product: args.product,
|
|
127
|
+
discovery,
|
|
128
|
+
deploy: { url: readLatestStatus(productRoot).deployment?.url, receipt: readLatestStatus(productRoot).deployment, probes: { ok: readLatestStatus(productRoot).deployment?.health === 'healthy' } },
|
|
129
|
+
build: { receipt: readLatestStatus(productRoot).build },
|
|
130
|
+
});
|
|
131
|
+
if (args.json) {
|
|
132
|
+
write(`${JSON.stringify({ ok: true, scenery: 'ansi', product: args.product })}\n`);
|
|
133
|
+
} else {
|
|
134
|
+
write(`\n${scenery}\n\n`);
|
|
135
|
+
write(`${pc.dim('Wireframes are reasoning scenery for the inline CLI — not pixel mockups.')}\n\n`);
|
|
136
|
+
}
|
|
137
|
+
return { ok: true, explore: true };
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
if (args.subcommand === 'status' || args.subcommand === 'products') {
|
|
141
|
+
const latest = readLatestStatus(productRoot);
|
|
142
|
+
const status = {
|
|
143
|
+
ok: true,
|
|
144
|
+
product: args.product,
|
|
145
|
+
discovery: {
|
|
146
|
+
go: discovery.go,
|
|
147
|
+
runtime: discovery.runtime
|
|
148
|
+
? { module: discovery.runtime.module, runtimeRoot: discovery.runtime.runtimeRoot, entry: discovery.runtime.entry }
|
|
149
|
+
: null,
|
|
150
|
+
product_exists: discovery.product_exists,
|
|
151
|
+
},
|
|
152
|
+
build: latest.build,
|
|
153
|
+
deployment: latest.deployment,
|
|
154
|
+
registry: latest.product,
|
|
155
|
+
};
|
|
156
|
+
if (args.json) write(`${JSON.stringify(status)}\n`);
|
|
157
|
+
else {
|
|
158
|
+
writeHumanSteps([
|
|
159
|
+
discovery.go?.ok ? `✓ Go ${discovery.go.goversion || discovery.go.version}` : '✗ Go toolchain missing',
|
|
160
|
+
discovery.runtime ? `✓ AgentSam Go source · ${discovery.runtime.module}` : '✗ Go runtime not discovered',
|
|
161
|
+
status.deployment?.url ? `✓ deployed · ${status.deployment.url} · ${status.deployment.health}` : '· no deployment receipt yet',
|
|
162
|
+
], write);
|
|
163
|
+
write(`${JSON.stringify(status, null, 2)}\n`);
|
|
164
|
+
}
|
|
165
|
+
return status;
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
if (args.subcommand === 'test') {
|
|
169
|
+
const tests = runGoTests(runtimeRoot);
|
|
170
|
+
const vet = runGoVet(runtimeRoot);
|
|
171
|
+
const payload = { ok: tests.ok && vet.ok, tests, vet };
|
|
172
|
+
write(args.json ? `${JSON.stringify(payload)}\n` : `${tests.stdout}${tests.stderr}${vet.stdout}${vet.stderr}`);
|
|
173
|
+
if (!payload.ok) {
|
|
174
|
+
const err = new Error('go_test_failed');
|
|
175
|
+
err.reported = true;
|
|
176
|
+
throw err;
|
|
177
|
+
}
|
|
178
|
+
return payload;
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
if (args.subcommand === 'build') {
|
|
182
|
+
ensureProductContract(productRoot);
|
|
183
|
+
const result = buildGoProduct({
|
|
184
|
+
productRoot,
|
|
185
|
+
runtimeRoot,
|
|
186
|
+
repositoryRoot: discovery.repository_root,
|
|
187
|
+
dryRun: args.dryRun,
|
|
188
|
+
});
|
|
189
|
+
write(args.json ? `${JSON.stringify(result)}\n` : `✓ build receipt · ${result.receiptPath}\n`);
|
|
190
|
+
return result;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
if (args.subcommand === 'verify') {
|
|
194
|
+
const result = await verifyGoProduct({
|
|
195
|
+
productRoot,
|
|
196
|
+
runtimeRoot,
|
|
197
|
+
skipLive: args.dryRun || args.skipDeploy,
|
|
198
|
+
});
|
|
199
|
+
write(args.json ? `${JSON.stringify(result)}\n` : `${JSON.stringify(result, null, 2)}\n`);
|
|
200
|
+
if (!result.ok) {
|
|
201
|
+
const err = new Error('go_verify_failed');
|
|
202
|
+
err.reported = true;
|
|
203
|
+
throw err;
|
|
204
|
+
}
|
|
205
|
+
return result;
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
if (args.subcommand === 'deploy' || args.subcommand === 'cloudflare-ship') {
|
|
209
|
+
return shipCloudflare({ discovery, productRoot, runtimeRoot, args, write });
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
write(HELP);
|
|
213
|
+
return { ok: true, help: true };
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
async function shipCloudflare({ discovery, productRoot, runtimeRoot, args, write }) {
|
|
217
|
+
const steps = [];
|
|
218
|
+
const note = (line) => {
|
|
219
|
+
steps.push(line);
|
|
220
|
+
if (!args.json) write(` ${line}\n`);
|
|
221
|
+
};
|
|
222
|
+
|
|
223
|
+
if (!args.json) write('\n Agent Sam · Go\n\n');
|
|
224
|
+
|
|
225
|
+
note(discovery.runtime ? '✓ existing AgentSam Go runtime discovered' : '✗ Go runtime missing');
|
|
226
|
+
if (!discovery.runtime) throw new Error('go_runtime_not_found');
|
|
227
|
+
note(discovery.go?.ok ? '✓ go toolchain' : '✗ go toolchain');
|
|
228
|
+
if (!discovery.go?.ok) throw new Error('go_toolchain_missing');
|
|
229
|
+
|
|
230
|
+
const preflight = preflightToolchain({
|
|
231
|
+
requireDocker: !(args.dryRun || args.skipDeploy),
|
|
232
|
+
productRoot,
|
|
233
|
+
});
|
|
234
|
+
for (const check of preflight.checks) {
|
|
235
|
+
note(`${check.ok ? '✓' : '·'} ${check.id}${check.detail ? ` · ${String(check.detail).slice(0, 80)}` : ''}`);
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
const contract = ensureProductContract(productRoot);
|
|
239
|
+
note(contract.existing ? '✓ existing product contract' : '✓ product contract established');
|
|
240
|
+
note('✓ deployment contract · cloudflare worker-container');
|
|
241
|
+
|
|
242
|
+
if (!args.json) {
|
|
243
|
+
write(`\n Product\n ${args.product}\n`);
|
|
244
|
+
write(' Target\n cloudflare\n');
|
|
245
|
+
write(' Runtime\n go/native + worker edge\n\n');
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
if (!args.json) write(' Building\n');
|
|
249
|
+
const build = buildGoProduct({
|
|
250
|
+
productRoot,
|
|
251
|
+
runtimeRoot,
|
|
252
|
+
repositoryRoot: discovery.repository_root,
|
|
253
|
+
dryRun: args.dryRun,
|
|
254
|
+
});
|
|
255
|
+
note('✓ go test ./...');
|
|
256
|
+
note('✓ go vet ./...');
|
|
257
|
+
note(build.build.binary ? `✓ Go binary · ${path.basename(build.build.binary)}` : '✓ Go build skipped (dry-run)');
|
|
258
|
+
|
|
259
|
+
if (!args.json) write('\n Deploying\n');
|
|
260
|
+
const deploy = await deployGoCloudflare({
|
|
261
|
+
productRoot,
|
|
262
|
+
product: args.product,
|
|
263
|
+
dryRun: args.dryRun,
|
|
264
|
+
skipDeploy: args.skipDeploy,
|
|
265
|
+
skipRegistry: args.skipRegistry,
|
|
266
|
+
});
|
|
267
|
+
if (deploy.deployed) note(`✓ ${args.product}`);
|
|
268
|
+
else if (args.dryRun) note('· dry-run · deploy skipped');
|
|
269
|
+
else if (args.skipDeploy) note('· skip-deploy · local receipts only');
|
|
270
|
+
else note('· deploy not completed');
|
|
271
|
+
|
|
272
|
+
if (deploy.url && !args.json) write(`\n Live\n ${deploy.url}\n`);
|
|
273
|
+
if (!args.json) write('\n Validation\n');
|
|
274
|
+
if (deploy.probes?.results) {
|
|
275
|
+
for (const [key, value] of Object.entries(deploy.probes.results)) {
|
|
276
|
+
note(`${value.ok ? '✓' : '✗'} ${key}`);
|
|
277
|
+
}
|
|
278
|
+
} else {
|
|
279
|
+
note('· live probes skipped');
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
if (!args.json) write('\n Registered\n');
|
|
283
|
+
if (deploy.registry?.remote) note('✓ agentsam_products · remote D1 upsert');
|
|
284
|
+
else if (deploy.registry?.skipped) note(`· agentsam_products · ${deploy.registry.reason || 'local only'}`);
|
|
285
|
+
else note('✓ agentsam_products (local projection)');
|
|
286
|
+
if (deploy.registry?.remote) note('✓ asset_relationships · remote D1 upsert');
|
|
287
|
+
else note('✓ asset relationships (local metadata)');
|
|
288
|
+
note('✓ deployment receipt');
|
|
289
|
+
|
|
290
|
+
const payload = {
|
|
291
|
+
ok: Boolean(build && (args.dryRun || args.skipDeploy || deploy.probes?.ok || deploy.deployed)),
|
|
292
|
+
product: args.product,
|
|
293
|
+
existing_product: contract.existing,
|
|
294
|
+
scaffold_changes_required: contract.created.length > 0,
|
|
295
|
+
discovery,
|
|
296
|
+
contract,
|
|
297
|
+
build: build.receipt,
|
|
298
|
+
deploy,
|
|
299
|
+
steps,
|
|
300
|
+
};
|
|
301
|
+
|
|
302
|
+
// Idempotent success: second run with healthy prior deploy still ok even if live probe skipped.
|
|
303
|
+
if (args.dryRun || args.skipDeploy) payload.ok = true;
|
|
304
|
+
if (deploy.deployed && deploy.probes && !deploy.probes.skipped) payload.ok = deploy.probes.ok;
|
|
305
|
+
|
|
306
|
+
if (args.json) write(`${JSON.stringify(payload)}\n`);
|
|
307
|
+
else {
|
|
308
|
+
write(`\n${renderGoShipScenery({ product: args.product, discovery, deploy, build })}\n`);
|
|
309
|
+
write(`\n ${payload.ok ? 'ready' : 'incomplete'} · ${args.product}\n`);
|
|
310
|
+
if (contract.existing && !contract.created.length) {
|
|
311
|
+
write(' ✓ existing product · update/redeploy path (no sibling scaffold)\n');
|
|
312
|
+
}
|
|
313
|
+
write('\n');
|
|
314
|
+
}
|
|
315
|
+
|
|
316
|
+
if (!payload.ok && !args.dryRun && !args.skipDeploy) {
|
|
317
|
+
const err = new Error('go_cloudflare_ship_incomplete');
|
|
318
|
+
err.detail = payload;
|
|
319
|
+
err.reported = true;
|
|
320
|
+
throw err;
|
|
321
|
+
}
|
|
322
|
+
return payload;
|
|
323
|
+
}
|
|
324
|
+
|
|
325
|
+
async function runInteractiveMenu({ discovery, productRoot, runtimeRoot, args, write }) {
|
|
326
|
+
intro(pc.bgCyan(pc.black(' Agent Sam · Go ')));
|
|
327
|
+
const status = readLatestStatus(productRoot);
|
|
328
|
+
write(`\n Runtime\n`);
|
|
329
|
+
write(` ${discovery.go?.ok ? '✓' : '✗'} Go ${discovery.go?.goversion || ''}\n`);
|
|
330
|
+
write(` ${discovery.runtime ? '✓' : '✗'} AgentSam Go source discovered\n`);
|
|
331
|
+
write(`\n Products\n`);
|
|
332
|
+
write(` ${args.product.padEnd(28)} ${status.deployment?.health || 'undeployed'} ${status.deployment?.url || ''}\n\n`);
|
|
333
|
+
|
|
334
|
+
write(`\n${renderArchitectureExplorer({
|
|
335
|
+
repo: 'agentsam-sdk',
|
|
336
|
+
git: discovery.git,
|
|
337
|
+
tree: ['apps/', 'packages/', 'protocol/', 'src/go/', 'runtime/'],
|
|
338
|
+
focus: {
|
|
339
|
+
package: args.product,
|
|
340
|
+
owns: 'Go runtime + CF container edge',
|
|
341
|
+
runtime: 'go/native + worker',
|
|
342
|
+
imported_by: 'CLI · deploy adapter · D1 registry',
|
|
343
|
+
files: 'main.go · wrangler · Dockerfile',
|
|
344
|
+
},
|
|
345
|
+
})}\n\n`);
|
|
346
|
+
|
|
347
|
+
const action = await select({
|
|
348
|
+
message: 'What would you like to do?',
|
|
349
|
+
options: [
|
|
350
|
+
{ value: 'explore', label: 'Explore wireframes' },
|
|
351
|
+
{ value: 'build', label: 'Build' },
|
|
352
|
+
{ value: 'test', label: 'Test' },
|
|
353
|
+
{ value: 'inspect', label: 'Inspect' },
|
|
354
|
+
{ value: 'cloudflare-ship', label: 'Deploy to Cloudflare' },
|
|
355
|
+
{ value: 'verify', label: 'Verify deployment' },
|
|
356
|
+
{ value: 'status', label: 'Show runtime' },
|
|
357
|
+
],
|
|
358
|
+
});
|
|
359
|
+
if (isCancel(action)) {
|
|
360
|
+
cancel('Cancelled.');
|
|
361
|
+
return { ok: false, cancelled: true };
|
|
362
|
+
}
|
|
363
|
+
outro(`Running ${action}`);
|
|
364
|
+
return runGo([action, args.product, ...(args.json ? ['--json'] : [])], { write });
|
|
365
|
+
}
|