@bitkyc08/opencodex 2.93.0 → 2.95.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/README.md +27 -8
- package/bin/ocx.mjs +215 -63
- package/gui/dist/assets/App-8yedBkhm.js +58 -0
- package/gui/dist/assets/App-B4j-Txmb.css +1 -0
- package/gui/dist/assets/Tray-erSMzxPG.js +1 -0
- package/gui/dist/assets/index-CHWwDo9L.css +1 -0
- package/gui/dist/assets/index-D7DCm5eQ.js +94 -0
- package/gui/dist/assets/quota-summary-BK4VuQNc.js +1 -0
- package/gui/dist/index.html +2 -2
- package/gui/dist/provider-icons/t3code.svg +4 -0
- package/package.json +7 -4
- package/src/adapters/anthropic/account-metadata.ts +34 -3
- package/src/adapters/anthropic/beta-allowlist.ts +5 -5
- package/src/adapters/anthropic/passthrough.ts +5 -2
- package/src/adapters/anthropic.ts +27 -7
- package/src/adapters/antigravity-refusal.ts +29 -0
- package/src/adapters/base.ts +11 -1
- package/src/adapters/client-fingerprint.ts +43 -9
- package/src/adapters/coding-agent/protocol.ts +19 -9
- package/src/adapters/command-code-project-context.ts +3 -3
- package/src/adapters/command-code.ts +4 -5
- package/src/adapters/cursor/catalog.ts +5 -3
- package/src/adapters/cursor/claude-id.ts +30 -19
- package/src/adapters/cursor/cursor-errors.ts +5 -2
- package/src/adapters/cursor/h2-pool.ts +9 -7
- package/src/adapters/cursor/http1-bidi.ts +1 -0
- package/src/adapters/cursor/live-models.ts +4 -2
- package/src/adapters/cursor.ts +4 -1
- package/src/adapters/devin/cloud-direct/chat.ts +18 -2
- package/src/adapters/google-antigravity-replay.ts +13 -2
- package/src/adapters/google-antigravity-wire.ts +8 -3
- package/src/adapters/google-errors.ts +33 -0
- package/src/adapters/google-http.ts +41 -16
- package/src/adapters/google-wire-compiler.ts +4 -0
- package/src/adapters/google.ts +21 -10
- package/src/adapters/kiro/adapter.ts +7 -1
- package/src/adapters/kiro/stream.ts +19 -13
- package/src/adapters/kiro-events.ts +1 -0
- package/src/adapters/openai-chat/completed-tool-blocks.ts +65 -0
- package/src/adapters/openai-chat/messages.ts +42 -17
- package/src/adapters/openai-chat/passthrough.ts +4 -2
- package/src/adapters/openai-chat/required-tool-result.ts +3 -3
- package/src/adapters/openai-chat/serialized-tool-call-content.ts +5 -0
- package/src/adapters/openai-chat/single-system.ts +24 -0
- package/src/adapters/openai-chat/wire.ts +9 -0
- package/src/adapters/openai-chat.ts +18 -17
- package/src/adapters/openai-responses/image-gen.ts +15 -1
- package/src/adapters/openai-responses/muse-tool-catalog.ts +87 -0
- package/src/adapters/openai-responses/passthrough.ts +53 -41
- package/src/adapters/openai-responses/prompt-cache.ts +3 -1
- package/src/adapters/openai-responses/request-strips.ts +23 -4
- package/src/adapters/openai-responses/tool-output-recovery.ts +21 -8
- package/src/adapters/openai-responses/tool-schema.ts +20 -8
- package/src/adapters/openai-responses/transport.ts +20 -2
- package/src/adapters/openai-responses/usage.ts +34 -0
- package/src/adapters/opencode-go-additional-tools.ts +39 -6
- package/src/adapters/qoder/adapter.ts +9 -15
- package/src/adapters/qoder/image-input.ts +52 -0
- package/src/adapters/routed-agent-messages.ts +3 -0
- package/src/adapters/unique-tool-call-ids.ts +2 -2
- package/src/adapters/xai-web-search.ts +6 -3
- package/src/adapters/zed-additional-tools.ts +51 -0
- package/src/adapters/zed-diagnostic-usage.ts +22 -0
- package/src/adapters/zed-json-tokens.ts +166 -0
- package/src/adapters/zed-openai-stream.ts +723 -0
- package/src/adapters/zed-tool-arguments.ts +79 -0
- package/src/adapters/zed.ts +48 -3
- package/src/advisor/consult.ts +39 -5
- package/src/advisor/runtime.ts +12 -3
- package/src/bridge/errors.ts +22 -1
- package/src/bridge/max-output-completion.ts +41 -0
- package/src/bridge/response-json.ts +13 -5
- package/src/bridge/sse.ts +34 -14
- package/src/chat/inbound.ts +13 -2
- package/src/chatgpt/app-server-shim/bundle-trust-async.ts +111 -0
- package/src/chatgpt/app-server-shim/bundle-trust-policy.ts +88 -0
- package/src/chatgpt/app-server-shim/bundle-trust.ts +15 -72
- package/src/chatgpt/app-server-shim/launcher.ts +40 -6
- package/src/claude/compatibility.ts +5 -1
- package/src/claude/desktop-3p.ts +27 -6
- package/src/claude/desktop-first-party.ts +16 -5
- package/src/claude/desktop-gateway-state.ts +4 -0
- package/src/claude/desktop-model-visibility.ts +141 -0
- package/src/claude/desktop-remote-store-io.ts +8 -8
- package/src/claude/inbound-content-options.ts +11 -1
- package/src/claude/inbound-tool-loading.ts +93 -0
- package/src/claude/intercept/picker-listener.ts +33 -1
- package/src/claude/intercept/proxy-auth.ts +16 -16
- package/src/claude/model-info.ts +29 -4
- package/src/claude/outbound.ts +33 -13
- package/src/cli/account-main.ts +44 -5
- package/src/cli/capabilities-base.ts +22 -5
- package/src/cli/capabilities-integrations.ts +4 -4
- package/src/cli/capabilities-provider-models.ts +7 -0
- package/src/cli/chatgpt-command.ts +1 -1
- package/src/cli/claude-desktop.ts +139 -98
- package/src/cli/codex-cli-update.ts +102 -48
- package/src/cli/codex-launch-auth.ts +93 -0
- package/src/cli/codex-launch-command.ts +32 -0
- package/src/cli/codex-launch-diagnostics.ts +37 -0
- package/src/cli/codex-launch-ownership.ts +307 -0
- package/src/cli/codex-launch-policy.ts +84 -0
- package/src/cli/codex-launcher.ts +322 -0
- package/src/cli/codex-shim-autorestore.ts +21 -1
- package/src/cli/config-command.ts +9 -4
- package/src/cli/config-mutation.ts +13 -0
- package/src/cli/dispatch.ts +19 -13
- package/src/cli/doctor.ts +5 -5
- package/src/cli/effort.ts +19 -14
- package/src/cli/ensure-desired-integrations.ts +21 -14
- package/src/cli/ensure-desktop-cold-start.ts +41 -10
- package/src/cli/export-command.ts +8 -4
- package/src/cli/help.ts +3 -1
- package/src/cli/index.ts +62 -73
- package/src/cli/init.ts +2 -2
- package/src/cli/integration-input.ts +12 -0
- package/src/cli/integration-plan-dto.ts +2 -0
- package/src/cli/integration-preview.ts +6 -3
- package/src/cli/integrations.ts +2 -1
- package/src/cli/internal-command.ts +29 -2
- package/src/cli/link-cleanup.ts +8 -23
- package/src/cli/link-enrollment.ts +1 -4
- package/src/cli/link.ts +1 -1
- package/src/cli/loopback-family.ts +2 -31
- package/src/cli/models.ts +62 -49
- package/src/cli/provider-cc-switch-import.ts +185 -0
- package/src/cli/provider.ts +151 -139
- package/src/cli/registry.ts +35 -3
- package/src/cli/restart-scope.ts +2 -2
- package/src/cli/root.ts +8 -6
- package/src/cli/start-owner-fence.ts +22 -3
- package/src/cli/status-link.ts +28 -0
- package/src/cli/status.ts +15 -0
- package/src/cli/stop-approval.ts +15 -1
- package/src/cli/stop-restore-guard.ts +48 -0
- package/src/cli/stop-restore.ts +117 -36
- package/src/cli/system-command.ts +2 -0
- package/src/cli/v2.ts +86 -23
- package/src/client/lifecycle-lock.ts +1 -1
- package/src/client/link-connection.ts +19 -0
- package/src/client/link-relay-transport.ts +25 -3
- package/src/client/link-tunnel.ts +10 -0
- package/src/client/machine-api.ts +2 -2
- package/src/client/machine-listener.ts +7 -1
- package/src/client/restore-ownership.ts +45 -0
- package/src/client/runtime.ts +13 -1
- package/src/client/state.ts +1 -1
- package/src/clients/client-ids.ts +7 -0
- package/src/clients/client-path.ts +13 -5
- package/src/clients/config-export/agent-clients.ts +3 -6
- package/src/clients/config-export/alias-selectors.ts +85 -0
- package/src/clients/config-export/contracts.ts +6 -25
- package/src/clients/config-export/dsh.ts +8 -1
- package/src/clients/config-export/model-metadata.ts +19 -0
- package/src/clients/config-export/model-names.ts +31 -0
- package/src/clients/config-export/qoder.ts +3 -11
- package/src/clients/config-export/t3code.ts +141 -0
- package/src/clients/config-export.ts +65 -18
- package/src/clients/gentle-shell-path.ts +3 -3
- package/src/codex/account-cooldown-response.ts +18 -0
- package/src/codex/account-lifecycle.ts +27 -13
- package/src/codex/account-store.ts +32 -6
- package/src/codex/app-server-processes.ts +84 -1
- package/src/codex/app-server-restart-service.ts +2 -2
- package/src/codex/auth-api/login-flow.ts +2 -2
- package/src/codex/auth-api/main-account-probe.ts +50 -11
- package/src/codex/auth-api/pool-mode-gate.ts +16 -8
- package/src/codex/auth-api/pool-quota-probe.ts +2 -2
- package/src/codex/auth-context.ts +49 -8
- package/src/codex/catalog/antigravity-discovery.ts +59 -0
- package/src/codex/catalog/build-entries.ts +12 -13
- package/src/codex/catalog/bundled.ts +67 -10
- package/src/codex/catalog/derive-entry.ts +2 -0
- package/src/codex/catalog/gather-capture.ts +3 -0
- package/src/codex/catalog/metadata.ts +10 -10
- package/src/codex/catalog/model-hints.ts +36 -4
- package/src/codex/catalog/native-omission.ts +28 -0
- package/src/codex/catalog/native-priority.ts +63 -0
- package/src/codex/catalog/native-template.ts +58 -0
- package/src/codex/catalog/parsing.ts +3 -29
- package/src/codex/catalog/provider-models.ts +22 -5
- package/src/codex/catalog/retained-sync.ts +16 -6
- package/src/codex/catalog/write-audit.ts +18 -18
- package/src/codex/chatgpt-refresh-failure.ts +2 -2
- package/src/codex/cli-install-provenance.ts +103 -74
- package/src/codex/cli-installation-identity.ts +1 -1
- package/src/codex/cli-installation-limits.ts +7 -0
- package/src/codex/cli-update-apply.ts +391 -0
- package/src/codex/cli-update-artifacts.ts +259 -0
- package/src/codex/cli-update-files.ts +100 -0
- package/src/codex/cli-update-inspection-context.ts +49 -0
- package/src/codex/cli-update-job-execution.ts +77 -0
- package/src/codex/cli-update-job-store-windows.ts +1082 -0
- package/src/codex/cli-update-job-worker.ts +385 -0
- package/src/codex/cli-update-job.ts +369 -0
- package/src/codex/cli-update-lease.ts +71 -0
- package/src/codex/cli-update-paths.ts +76 -0
- package/src/codex/cli-update-plan.ts +180 -47
- package/src/codex/cli-update-recovery.ts +282 -0
- package/src/codex/cli-update-selection-gate.ts +305 -0
- package/src/codex/cli-update-windows-apply.ts +308 -0
- package/src/codex/cli-update-windows-layout.ts +110 -0
- package/src/codex/cli-update-windows-observation.ts +91 -0
- package/src/codex/cli-update-windows-paths.ts +26 -0
- package/src/codex/cli-update-worker-recovery.ts +32 -0
- package/src/codex/cli-update-worker.ts +185 -0
- package/src/codex/cli-windows-plan-provenance.ts +268 -0
- package/src/codex/codex-home-owner.ts +9 -8
- package/src/codex/convergence.ts +13 -3
- package/src/codex/coordinator-doctor.ts +14 -8
- package/src/codex/desktop-app/handoff.ts +1 -1
- package/src/codex/desktop-app-restart.ts +32 -3
- package/src/codex/exec-boundary.ts +229 -0
- package/src/codex/forward-transport-headers.ts +80 -0
- package/src/codex/history-job.ts +7 -0
- package/src/codex/history-provider.ts +16 -12
- package/src/codex/history-worker.ts +20 -1
- package/src/codex/inject/bounded-config-reader.ts +14 -13
- package/src/codex/inject/restore.ts +57 -25
- package/src/codex/internal/history-writer.ts +2 -1
- package/src/codex/mac-app-bundle.ts +52 -0
- package/src/codex/main-account.ts +167 -29
- package/src/codex/native-main-auth-temp.ts +3 -2
- package/src/codex/native-main-lock-file.ts +13 -12
- package/src/codex/native-main-refresh-mode.ts +18 -3
- package/src/codex/native-profile-manager.ts +8 -6
- package/src/codex/native-profile-store.ts +9 -0
- package/src/codex/native-residue.ts +18 -14
- package/src/codex/ocx-compaction-history.ts +3 -2
- package/src/codex/orca-auth-source.ts +8 -7
- package/src/codex/prompt-text-probe.ts +211 -69
- package/src/codex/quota-types.ts +5 -0
- package/src/codex/quota.ts +58 -7
- package/src/codex/role-auto-assign.ts +50 -26
- package/src/codex/role-capability.ts +160 -0
- package/src/codex/role-model-history.ts +253 -0
- package/src/codex/role-sizing.ts +24 -6
- package/src/codex/routing/cooldown-math.ts +3 -2
- package/src/codex/runtime.ts +161 -72
- package/src/codex/shim-fingerprint.ts +11 -9
- package/src/codex/shim-inspect.ts +3 -2
- package/src/codex/shim-overlay.ts +22 -3
- package/src/codex/shim-restore-lock.ts +11 -14
- package/src/codex/shim-state-file.ts +22 -14
- package/src/codex/shim-templates.ts +5 -2
- package/src/codex/shim-wrapper-write.ts +137 -0
- package/src/codex/shim.ts +48 -126
- package/src/codex/transition-state.ts +5 -4
- package/src/codex/windows-cli-child-native.ts +119 -0
- package/src/codex/windows-cli-child-pipe.ts +87 -0
- package/src/codex/windows-cli-child.ts +260 -0
- package/src/codex/windows-cli-recovery-guardian.ts +89 -0
- package/src/codex/windows-cli-recovery.ts +39 -0
- package/src/codex/windows-installation-files.ts +52 -6
- package/src/codex/windows-npm-execution.ts +25 -0
- package/src/combos/failover.ts +127 -9
- package/src/combos/index.ts +1 -0
- package/src/combos/resolve.ts +60 -22
- package/src/config/atomic-write.ts +113 -29
- package/src/config/diagnostics.ts +21 -10
- package/src/config/initialize.ts +6 -6
- package/src/config/live-reconcile.ts +11 -3
- package/src/config/load-degrade.ts +2 -0
- package/src/config/owner-registry.ts +5 -4
- package/src/config/persist-unlocked.ts +34 -8
- package/src/config/persisted-mutation.ts +7 -0
- package/src/config/process-state.ts +32 -10
- package/src/config/removed-opencode-free-backup.ts +99 -0
- package/src/config/removed-opencode-free.ts +4 -8
- package/src/config/salvage.ts +2 -0
- package/src/config/schema/config-schema.ts +44 -1
- package/src/config/schema/leaf-validators.ts +22 -0
- package/src/config/schema/workflow-budget.ts +43 -0
- package/src/config/tracked-runtime-inspection.ts +188 -0
- package/src/config.ts +4 -4
- package/src/generated/compatibility-version.json +962 -434
- package/src/grok/inject.ts +2 -1
- package/src/grok/sync.ts +5 -2
- package/src/images/loop.ts +14 -5
- package/src/integrations/aside-profile-context.ts +1 -1
- package/src/integrations/catalog-refresh.ts +1 -1
- package/src/integrations/droid-settings.ts +4 -4
- package/src/integrations/hermes-profiles.ts +3 -3
- package/src/integrations/hermes-refresh.ts +28 -0
- package/src/integrations/model-name-guard.ts +31 -0
- package/src/integrations/mutation-plan.ts +17 -4
- package/src/integrations/ownership.ts +3 -0
- package/src/integrations/registry.ts +10 -1
- package/src/integrations/state.ts +6 -0
- package/src/integrations/writer.ts +64 -59
- package/src/lib/abort.ts +8 -4
- package/src/lib/bounded-body.ts +7 -1
- package/src/lib/bounded-file-read.ts +3 -9
- package/src/lib/bun-runtime-preflight.ts +9 -8
- package/src/lib/config-ownership.ts +4 -0
- package/src/lib/errors.ts +2 -0
- package/src/lib/eventstream-decoder.ts +3 -2
- package/src/lib/file-identity.ts +15 -0
- package/src/lib/http-response-semantics.ts +9 -6
- package/src/lib/inbound-body-policy.ts +11 -0
- package/src/lib/jsonc.ts +7 -2
- package/src/lib/local-chat-completion.ts +8 -6
- package/src/lib/local-destinations.ts +32 -3
- package/src/lib/local-management-capability.ts +3 -1
- package/src/lib/local-upstream.ts +22 -26
- package/src/lib/loopback-family.ts +31 -0
- package/src/lib/plain-data.ts +7 -5
- package/src/lib/process-control.ts +30 -5
- package/src/lib/redact-folding.ts +9 -0
- package/src/lib/shadow-call.ts +55 -1
- package/src/lib/spend-pool-alias-validation.ts +6 -6
- package/src/lib/state-store-registrations.ts +2 -0
- package/src/lib/test-home-guard.ts +37 -9
- package/src/lib/tool-argument-integers.ts +99 -7
- package/src/lib/upstream-retry.ts +6 -1
- package/src/lib/windows-elevation.ts +34 -11
- package/src/lib/windows-owner-acl.ts +272 -32
- package/src/lib/windows-secret-acl.ts +328 -44
- package/src/lib/windows-service-wrappers.ts +10 -7
- package/src/lib/winsw.ts +8 -4
- package/src/lib/workflow-budget-config.ts +39 -0
- package/src/link/relay-auth.ts +38 -1
- package/src/link/remote-platform.ts +11 -23
- package/src/link/remote-probe.ts +3 -1
- package/src/link/remote-windows.ts +150 -0
- package/src/link/ssh-argv.ts +13 -5
- package/src/link/store.ts +4 -1
- package/src/link/supervisor.ts +9 -0
- package/src/local-credentials/generation.ts +242 -0
- package/src/local-credentials/inventory.ts +405 -0
- package/src/local-credentials/observation-lease.ts +83 -0
- package/src/local-credentials/publication-fence.ts +81 -0
- package/src/local-credentials/references.ts +36 -0
- package/src/local-credentials/runtime-observation.ts +28 -0
- package/src/messaging/remote-forward-failure.ts +35 -0
- package/src/messaging/remote-ports.ts +27 -5
- package/src/messaging/remote-process.ts +30 -4
- package/src/messaging/remote-tunnels.ts +80 -15
- package/src/oauth/account-auto-pause-policy.ts +11 -0
- package/src/oauth/anthropic-account-refusal.ts +1 -0
- package/src/oauth/anthropic-rate-limit-policy.ts +26 -2
- package/src/oauth/anthropic-routing.ts +34 -44
- package/src/oauth/anthropic-session-affinity-store.ts +177 -0
- package/src/oauth/antigravity-discovery-diagnostics.ts +65 -0
- package/src/oauth/chatgpt.ts +11 -9
- package/src/oauth/cursor.ts +8 -2
- package/src/oauth/generic-account-failover.ts +33 -2
- package/src/oauth/generic-session-affinity.ts +7 -0
- package/src/oauth/google-antigravity.ts +49 -12
- package/src/oauth/index.ts +3 -0
- package/src/oauth/kiro-device-login.ts +87 -30
- package/src/oauth/kiro-iam-identity-center.ts +107 -0
- package/src/oauth/store.ts +41 -11
- package/src/protocols/encoders/adapter-events.ts +7 -4
- package/src/protocols/encoders/messages.ts +1 -1
- package/src/providers/account-quota-disk.ts +18 -4
- package/src/providers/antigravity-account-roster.ts +73 -7
- package/src/providers/antigravity-models.ts +8 -4
- package/src/providers/api-key-resolve.ts +16 -3
- package/src/providers/cc-switch-import-bytes.ts +991 -0
- package/src/providers/cc-switch-import-source.ts +1083 -0
- package/src/providers/cc-switch-import.ts +942 -0
- package/src/providers/claude-cli-identity.ts +2 -0
- package/src/providers/codex-capacity.ts +3 -2
- package/src/providers/derive.ts +6 -0
- package/src/providers/free-directory.ts +10 -2
- package/src/providers/key-store.ts +7 -2
- package/src/providers/model-discovery-diagnostic.ts +4 -0
- package/src/providers/model-discovery.ts +4 -4
- package/src/providers/model-rename-fields.ts +2 -0
- package/src/providers/model-rename-migration.ts +41 -6
- package/src/providers/provider-id-rewrite.ts +3 -0
- package/src/providers/quota/antigravity.ts +6 -4
- package/src/providers/quota/report-cache.ts +17 -4
- package/src/providers/quota/vendor-probes-oauth.ts +0 -1
- package/src/providers/quota.ts +2 -2
- package/src/providers/reasoning-metadata.ts +31 -15
- package/src/providers/registry/entries-core.ts +1 -1
- package/src/providers/registry/entries-extended.ts +1 -1
- package/src/providers/registry/model-ids.ts +1 -0
- package/src/providers/registry/model-seeds.ts +2 -1
- package/src/providers/registry/types.ts +3 -1
- package/src/providers/resolved-model-policy.ts +2 -2
- package/src/providers/routed-config.ts +2 -0
- package/src/providers/stale-model-roster-migration.ts +8 -1
- package/src/providers/xai-transport.ts +4 -4
- package/src/quota-pool/assemble.ts +51 -21
- package/src/quota-pool/pooled.ts +162 -0
- package/src/remote-control/workspace-codex-runtime.ts +63 -20
- package/src/remote-control/workspace-executor.ts +14 -13
- package/src/responses/apply-patch-envelope.ts +35 -0
- package/src/responses/compaction-history-framing.ts +15 -4
- package/src/responses/custom-tool-compat.ts +2 -1
- package/src/responses/item-provenance.ts +79 -0
- package/src/responses/namespace-tool-compat.ts +21 -3
- package/src/responses/turn-membership.ts +111 -0
- package/src/router.ts +21 -2
- package/src/routing/analytics.ts +3 -5
- package/src/routing/fallback-policy.ts +7 -3
- package/src/routing/health.ts +5 -3
- package/src/routing/history/build-file.ts +6 -0
- package/src/routing/history/indexer.ts +158 -31
- package/src/routing/history/ingest.ts +1 -1
- package/src/routing/history/integrity.ts +208 -0
- package/src/routing/history/rebuild-job.ts +20 -6
- package/src/routing/history/rebuild-protocol.ts +2 -1
- package/src/routing/history/rebuild-worker.ts +18 -0
- package/src/routing/history/sqlite-errors.ts +9 -0
- package/src/server/admission-model-scope.ts +21 -4
- package/src/server/advisor-admission-scope.ts +72 -0
- package/src/server/audio-upstream.ts +10 -2
- package/src/server/auth-cors.ts +28 -2
- package/src/server/bind-host.ts +5 -0
- package/src/server/capture-admission-policy.ts +91 -0
- package/src/server/chat-completions.ts +47 -6
- package/src/server/chat-native.ts +16 -11
- package/src/server/claude-messages.ts +99 -3
- package/src/server/codex-model-list.ts +47 -0
- package/src/server/configured-credentials.ts +5 -0
- package/src/server/gui-session.ts +5 -2
- package/src/server/inbound-body-admission.ts +21 -13
- package/src/server/inbound-body-budget.ts +128 -0
- package/src/server/index/link-listener.ts +3 -1
- package/src/server/index/link-relay-sessions.ts +9 -2
- package/src/server/index/optional-listeners.ts +1 -0
- package/src/server/index/serve-options.ts +21 -45
- package/src/server/index/websocket-handler.ts +10 -0
- package/src/server/index.ts +6 -5
- package/src/server/inference/client-encoder-delivery.ts +3 -1
- package/src/server/lifecycle.ts +8 -1
- package/src/server/management/advisor-routes.ts +26 -9
- package/src/server/management/agent-settings-routes.ts +455 -549
- package/src/server/management/anthropic-reset-grant-routes.ts +2 -1
- package/src/server/management/claude-code-settings-patch.ts +211 -0
- package/src/server/management/claude-desktop-config-writers.ts +78 -0
- package/src/server/management/codex-agent-role-routes.ts +80 -2
- package/src/server/management/codex-cli-update-routes.ts +55 -0
- package/src/server/management/codex-prompt-routes.ts +2 -1
- package/src/server/management/codex-role-auto-assign.ts +50 -6
- package/src/server/management/config-routes.ts +459 -384
- package/src/server/management/consent-session.ts +6 -0
- package/src/server/management/context.ts +3 -0
- package/src/server/management/desktop-compatibility-authorization.ts +12 -0
- package/src/server/management/desktop-compatibility-routes.ts +3 -2
- package/src/server/management/desktop-compatibility-runtime-routes.ts +2 -1
- package/src/server/management/desktop-compatibility-settings-routes.ts +2 -1
- package/src/server/management/integration-routes.ts +45 -5
- package/src/server/management/link-enrollment.ts +21 -32
- package/src/server/management/link-route-state.ts +1 -0
- package/src/server/management/link-routes.ts +4 -1
- package/src/server/management/model-routes.ts +22 -6
- package/src/server/management/model-rows.ts +3 -1
- package/src/server/management/native-integration-routes.ts +112 -38
- package/src/server/management/oauth-account-routes.ts +28 -11
- package/src/server/management/provider-overwrite-carry.ts +21 -0
- package/src/server/management/provider-routes.ts +3 -1
- package/src/server/management/route-registry.ts +10 -3
- package/src/server/management/session-routes.ts +20 -2
- package/src/server/management/shadow-call-validation.ts +43 -2
- package/src/server/management/shared.ts +17 -1
- package/src/server/management/sidebar-routes.ts +2 -1
- package/src/server/management/system-restart.ts +47 -7
- package/src/server/management/workflow-budget-routes.ts +70 -3
- package/src/server/management-api.ts +61 -51
- package/src/server/management-auth.ts +11 -3
- package/src/server/messages-native-eligibility.ts +6 -5
- package/src/server/messages-native-scope.ts +6 -1
- package/src/server/messages-native.ts +21 -7
- package/src/server/messages-shared.ts +161 -29
- package/src/server/persistent-gui-session.ts +155 -0
- package/src/server/port-reclaim.ts +29 -5
- package/src/server/proxy-liveness.ts +110 -33
- package/src/server/request-decompress.ts +5 -1
- package/src/server/request-log.ts +30 -2
- package/src/server/responses/account-change-state.ts +14 -2
- package/src/server/responses/adapter-continuation.ts +5 -4
- package/src/server/responses/adapter-delivery.ts +24 -5
- package/src/server/responses/adapter-dispatch.ts +39 -45
- package/src/server/responses/advisor-plan-slot.ts +7 -0
- package/src/server/responses/advisor-slot.ts +77 -48
- package/src/server/responses/antigravity-model-denial-recovery.ts +70 -0
- package/src/server/responses/antigravity-validation-refusal.ts +6 -0
- package/src/server/responses/codex-auth-error.ts +5 -1
- package/src/server/responses/combo-required-tool-contract.ts +29 -1
- package/src/server/responses/combo-required-tool-fulfillments.ts +58 -0
- package/src/server/responses/combo-required-tool-stream.ts +119 -0
- package/src/server/responses/combo-stream-preflight.ts +47 -7
- package/src/server/responses/compact.ts +18 -8
- package/src/server/responses/compaction-recovery.ts +2 -1
- package/src/server/responses/core-auth.ts +2 -1
- package/src/server/responses/core-codex-account.ts +1 -0
- package/src/server/responses/core-combo-failure.ts +13 -6
- package/src/server/responses/core-combo-native.ts +6 -5
- package/src/server/responses/core-combo.ts +159 -25
- package/src/server/responses/core-lifetime.ts +4 -0
- package/src/server/responses/core-options.ts +16 -0
- package/src/server/responses/core.ts +2 -0
- package/src/server/responses/fetch-helpers.ts +5 -1
- package/src/server/responses/jev-model-invoke.ts +10 -3
- package/src/server/responses/memory-models.ts +3 -2
- package/src/server/responses/passthrough-delivery.ts +36 -8
- package/src/server/responses/passthrough-dispatch.ts +17 -16
- package/src/server/responses/policy-fallback.ts +2 -0
- package/src/server/responses/request-prepare.ts +14 -6
- package/src/server/responses/request-send-budget.ts +2 -1
- package/src/server/responses/request-sidecar-auth.ts +1 -0
- package/src/server/responses/request-transport.ts +43 -9
- package/src/server/responses/run-turn-execution.ts +15 -3
- package/src/server/responses/sidecar-execution.ts +26 -5
- package/src/server/responses/turn-membership.ts +30 -0
- package/src/server/responses-custom-tool-repair.ts +86 -11
- package/src/server/responses-image-gen-repair.ts +1 -1
- package/src/server/responses-snapshot-repair.ts +18 -4
- package/src/server/responses-undeclared-tool-guard.ts +4 -0
- package/src/server/restart-parent-ownership.ts +49 -0
- package/src/server/stop-teardown.ts +46 -9
- package/src/server/windows-tcp-drop.ts +4 -2
- package/src/server/workflow-refusal.ts +2 -1
- package/src/service/desktop-recovery-process.ts +341 -0
- package/src/service/desktop-recovery.ts +172 -0
- package/src/service/state-lock.ts +12 -11
- package/src/service/windows-ops.ts +6 -3
- package/src/service/windows-scheduler.ts +29 -6
- package/src/service-manager-probe.ts +53 -8
- package/src/stall-timeout.ts +47 -0
- package/src/tray/windows.ts +6 -4
- package/src/types/admission-policy.ts +13 -0
- package/src/types/config.ts +86 -10
- package/src/types/provider.ts +10 -0
- package/src/types/request.ts +8 -1
- package/src/types.ts +2 -0
- package/src/update/async-check.ts +4 -3
- package/src/update/bind-probe.ts +2 -2
- package/src/update/codex-cli-update-launch-policy.mjs +9 -0
- package/src/update/guarded-port-reclaim.ts +14 -0
- package/src/update/guarded-runtime-ops.ts +58 -0
- package/src/update/guarded-tray-ops.ts +9 -0
- package/src/update/index.ts +196 -58
- package/src/update/job-pinned-start.ts +53 -0
- package/src/update/job-supervised-restart.ts +23 -6
- package/src/update/job-update-home.ts +62 -0
- package/src/update/job-update-tray.ts +29 -0
- package/src/update/job-windows-restart.ts +39 -0
- package/src/update/job.ts +199 -193
- package/src/update/mutation-guard.d.mts +30 -0
- package/src/update/mutation-guard.mjs +103 -0
- package/src/update/notify.ts +2 -2
- package/src/update/npm-cache-preflight.mjs +4 -4
- package/src/update/npm-install.mjs +5 -3
- package/src/update/pnpm-read-policy.mjs +3 -2
- package/src/update/proxy-liveness-probe.mjs +2 -2
- package/src/update/service-home-authority.ts +35 -0
- package/src/update/service-home-package-only-protocol.json +1 -0
- package/src/update/service-home-policy.d.mts +25 -0
- package/src/update/service-home-policy.mjs +112 -0
- package/src/update/service-home-probe-entry.ts +9 -0
- package/src/update/service-home-probe.d.mts +15 -0
- package/src/update/service-home-probe.mjs +79 -0
- package/src/update/service-home-protocol.json +1 -0
- package/src/update/supervised-recovery.d.mts +2 -2
- package/src/update/supervised-recovery.mjs +14 -7
- package/src/update/transactional-install.d.mts +3 -1
- package/src/update/transactional-install.mjs +29 -19
- package/src/update/update-failure-guidance.mjs +1 -1
- package/src/update/worker-launch.ts +74 -4
- package/src/usage/log.ts +25 -4
- package/src/vision/anthropic-describe.ts +2 -1
- package/src/vision/index.ts +2 -0
- package/src/vision/plan.ts +4 -0
- package/src/vision/routed-describe.ts +38 -23
- package/src/web-search/anthropic-executor.ts +2 -1
- package/src/web-search/anthropic-history.ts +1 -0
- package/src/web-search/format-result.ts +3 -2
- package/src/web-search/header-deadline.ts +3 -2
- package/src/web-search/loop.ts +113 -12
- package/src/web-search/parse.ts +201 -40
- package/gui/dist/assets/App-CizjBqyk.js +0 -58
- package/gui/dist/assets/App-DMps4OLk.css +0 -1
- package/gui/dist/assets/Tray-DamiMqcX.js +0 -1
- package/gui/dist/assets/index-DQsht3vH.js +0 -94
- package/gui/dist/assets/index-DRe8Hhfz.css +0 -1
- package/gui/dist/assets/quota-summary-BXu4zE8H.js +0 -1
|
@@ -4,19 +4,23 @@
|
|
|
4
4
|
*
|
|
5
5
|
* Tier of a candidate model, first rule that applies:
|
|
6
6
|
* 1. codexRoleTiers in the opencodex config lists it under fast, standard or frontier.
|
|
7
|
-
* 2.
|
|
7
|
+
* 2. At least two candidates have a measured score in the role's task domain. Measured candidates
|
|
8
|
+
* are ranked by that score and split across the tiers the same way price splits them below;
|
|
9
|
+
* unmeasured ones are left out rather than placed among measured ones by price.
|
|
10
|
+
* 3. It has a known price. Priced candidates are ranked by input plus output USD per 1M tokens.
|
|
8
11
|
* Three or more split evenly across the three tiers by rank, cheapest in fast. Fewer than three
|
|
9
12
|
* cannot fill every tier, so the ranking is anchored at the top: the dearest is frontier,
|
|
10
13
|
* because it is the strongest model on offer, and each cheaper one sits one tier lower. One
|
|
11
14
|
* priced model is frontier; two are standard and frontier. The tier left empty is fast, so a
|
|
12
15
|
* fast role steps up to the cheapest model and a standard role keeps it instead of jumping to
|
|
13
16
|
* the dearest, which keeps every role on the cheapest sufficient model on offer.
|
|
14
|
-
*
|
|
17
|
+
* 4. Otherwise it is unclassified and never proposed.
|
|
15
18
|
*
|
|
16
19
|
* A role gets the cheapest sufficient model: the lowest tier at or above what it was sized for,
|
|
17
|
-
* then the lowest price, then the model the role already uses when
|
|
18
|
-
* then the picker's own order. The picker lists native models first,
|
|
19
|
-
* step a role on a routed model moved to a native one priced and
|
|
20
|
+
* then the lowest price, then the higher measured score, then the model the role already uses when
|
|
21
|
+
* it is one of the tied models, then the picker's own order. The picker lists native models first,
|
|
22
|
+
* so without the current-model step a role on a routed model moved to a native one priced and
|
|
23
|
+
* tiered the same.
|
|
20
24
|
*
|
|
21
25
|
* Effort binds to positions on the chosen model's ladder: glance is the floor, measured is the
|
|
22
26
|
* model's default or the middle rung, exhaustive is the ceiling, and thorough is the rung above
|
|
@@ -25,7 +29,7 @@
|
|
|
25
29
|
* above wins because thorough asks for more than the everyday setting. Nothing resolves outside
|
|
26
30
|
* the ladder.
|
|
27
31
|
*/
|
|
28
|
-
import { SIZING_TIERS, type RoleSizingOutcome, type SizingEffort, type SizingTier } from "./role-sizing";
|
|
32
|
+
import { SIZING_TIERS, type RoleSizingOutcome, type SizingDomain, type SizingEffort, type SizingTier } from "./role-sizing";
|
|
29
33
|
import { CODEX_REASONING_LEVELS } from "../reasoning-effort";
|
|
30
34
|
|
|
31
35
|
export type RoleTierMapping = Partial<Record<SizingTier, readonly string[]>>;
|
|
@@ -40,7 +44,9 @@ export interface RoleModelCandidate {
|
|
|
40
44
|
|
|
41
45
|
export interface ClassifiedCandidate extends RoleModelCandidate {
|
|
42
46
|
readonly tier: SizingTier | null;
|
|
43
|
-
readonly tierSource: "mapping" | "price" | null;
|
|
47
|
+
readonly tierSource: "mapping" | "measured" | "price" | null;
|
|
48
|
+
/** The measured score the tier came from, or null when it came from elsewhere. */
|
|
49
|
+
readonly score: number | null;
|
|
44
50
|
}
|
|
45
51
|
|
|
46
52
|
const LADDER_ORDER = ["none", "minimal", ...CODEX_REASONING_LEVELS.map(level => level.effort)];
|
|
@@ -66,33 +72,45 @@ export function mapEffortToLevel(intent: SizingEffort, efforts: readonly string[
|
|
|
66
72
|
}
|
|
67
73
|
}
|
|
68
74
|
|
|
75
|
+
/** Split items ranked weakest first across the tiers; fewer than three are anchored at the top. */
|
|
76
|
+
function tierByRank<T>(ranked: readonly T[]): Map<T, SizingTier> {
|
|
77
|
+
const top = SIZING_TIERS.length - 1;
|
|
78
|
+
return new Map(ranked.map((item, rank) => [item, SIZING_TIERS[ranked.length < SIZING_TIERS.length
|
|
79
|
+
? top - (ranked.length - 1 - rank)
|
|
80
|
+
: Math.round((rank * top) / (ranked.length - 1))]!]));
|
|
81
|
+
}
|
|
82
|
+
|
|
69
83
|
export function classifyRoleModelCandidates(
|
|
70
84
|
candidates: readonly RoleModelCandidate[],
|
|
71
85
|
mapping: RoleTierMapping = {},
|
|
86
|
+
measured: ReadonlyMap<string, number> = new Map(),
|
|
72
87
|
): ClassifiedCandidate[] {
|
|
73
88
|
const mapped = new Map<string, SizingTier>();
|
|
74
89
|
for (const tier of SIZING_TIERS) {
|
|
75
90
|
for (const model of mapping[tier] ?? []) if (!mapped.has(model)) mapped.set(model, tier);
|
|
76
91
|
}
|
|
77
|
-
const
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
92
|
+
const unmapped = candidates.filter(candidate => !mapped.has(candidate.model));
|
|
93
|
+
const scored = unmapped.filter(candidate => measured.has(candidate.model));
|
|
94
|
+
const scoreTiers = tierByRank([...new Set(scored.map(candidate => measured.get(candidate.model)!))].sort((a, b) => a - b));
|
|
95
|
+
const byScore = scored.length >= 2
|
|
96
|
+
? new Map(scored.map(candidate => [candidate.model, scoreTiers.get(measured.get(candidate.model)!)!] as const))
|
|
97
|
+
: new Map<string, SizingTier>();
|
|
98
|
+
const byPrice = byScore.size > 0
|
|
99
|
+
? new Map<string, SizingTier>()
|
|
100
|
+
: tierByRank(unmapped
|
|
101
|
+
.map((candidate, order) => ({ candidate, order }))
|
|
102
|
+
.filter(({ candidate }) => candidate.unitPrice !== null)
|
|
103
|
+
.sort((a, b) => a.candidate.unitPrice! - b.candidate.unitPrice! || a.order - b.order)
|
|
104
|
+
.map(({ candidate }) => candidate.model));
|
|
89
105
|
return candidates.map(candidate => {
|
|
90
106
|
const fromMapping = mapped.get(candidate.model);
|
|
91
|
-
if (fromMapping) return { ...candidate, tier: fromMapping, tierSource: "mapping" as const };
|
|
107
|
+
if (fromMapping) return { ...candidate, tier: fromMapping, tierSource: "mapping" as const, score: null };
|
|
108
|
+
const fromScore = byScore.get(candidate.model);
|
|
109
|
+
if (fromScore) return { ...candidate, tier: fromScore, tierSource: "measured" as const, score: measured.get(candidate.model)! };
|
|
92
110
|
const fromPrice = byPrice.get(candidate.model);
|
|
93
111
|
return fromPrice
|
|
94
|
-
? { ...candidate, tier: fromPrice, tierSource: "price" as const }
|
|
95
|
-
: { ...candidate, tier: null, tierSource: null };
|
|
112
|
+
? { ...candidate, tier: fromPrice, tierSource: "price" as const, score: null }
|
|
113
|
+
: { ...candidate, tier: null, tierSource: null, score: null };
|
|
96
114
|
});
|
|
97
115
|
}
|
|
98
116
|
|
|
@@ -107,6 +125,7 @@ export function cheapestSufficientCandidate(
|
|
|
107
125
|
.filter(entry => entry.rank >= need)
|
|
108
126
|
.sort((a, b) => a.rank - b.rank
|
|
109
127
|
|| (a.candidate.unitPrice ?? Infinity) - (b.candidate.unitPrice ?? Infinity)
|
|
128
|
+
|| (b.candidate.score ?? -Infinity) - (a.candidate.score ?? -Infinity)
|
|
110
129
|
|| Number(b.candidate.model === current) - Number(a.candidate.model === current)
|
|
111
130
|
|| a.order - b.order);
|
|
112
131
|
return ranked[0]?.candidate ?? null;
|
|
@@ -123,10 +142,13 @@ export type RoleProposal = RoleProposalInput & (
|
|
|
123
142
|
readonly status: "proposed" | "unassigned";
|
|
124
143
|
readonly tier: SizingTier;
|
|
125
144
|
readonly effortIntent: SizingEffort;
|
|
145
|
+
readonly domain: SizingDomain;
|
|
126
146
|
readonly rationale: string;
|
|
127
147
|
readonly moveUpIf: string;
|
|
128
148
|
readonly moveDownIf: string;
|
|
129
149
|
readonly proposedModel: string | null;
|
|
150
|
+
/** Where the picked model's tier came from: a user mapping, a measured score, or price rank. */
|
|
151
|
+
readonly tierSource: ClassifiedCandidate["tierSource"];
|
|
130
152
|
/** The sized effort on the picked model's ladder; null only when that model has no ladder. */
|
|
131
153
|
readonly proposedEffort: string | null;
|
|
132
154
|
readonly reason: string | null;
|
|
@@ -138,23 +160,25 @@ export function buildRoleProposals(
|
|
|
138
160
|
roles: readonly RoleProposalInput[],
|
|
139
161
|
sizing: ReadonlyMap<string, RoleSizingOutcome>,
|
|
140
162
|
classified: readonly ClassifiedCandidate[],
|
|
163
|
+
classifiedByDomain: ReadonlyMap<SizingDomain, readonly ClassifiedCandidate[]> = new Map(),
|
|
141
164
|
): RoleProposal[] {
|
|
142
165
|
return roles.map(role => {
|
|
143
166
|
const outcome = sizing.get(role.role) ?? { unsized: "the role was not sized" };
|
|
144
167
|
if ("unsized" in outcome) return { ...role, status: "unsized", reason: outcome.unsized };
|
|
145
|
-
const { tier, effort, rationale, moveUpIf, moveDownIf } = outcome.sizing;
|
|
146
|
-
const pick = cheapestSufficientCandidate(classified, tier, role.model);
|
|
147
|
-
const sized = { ...role, tier, effortIntent: effort, rationale, moveUpIf, moveDownIf };
|
|
168
|
+
const { tier, effort, domain, rationale, moveUpIf, moveDownIf } = outcome.sizing;
|
|
169
|
+
const pick = cheapestSufficientCandidate(classifiedByDomain.get(domain) ?? classified, tier, role.model);
|
|
170
|
+
const sized = { ...role, tier, effortIntent: effort, domain, rationale, moveUpIf, moveDownIf };
|
|
148
171
|
if (!pick) {
|
|
149
172
|
return {
|
|
150
173
|
...sized,
|
|
151
174
|
status: "unassigned",
|
|
152
175
|
proposedModel: null,
|
|
176
|
+
tierSource: null,
|
|
153
177
|
proposedEffort: null,
|
|
154
178
|
reason: `no available model is classified ${tier} or above`,
|
|
155
179
|
};
|
|
156
180
|
}
|
|
157
181
|
const proposedEffort = mapEffortToLevel(effort, pick.efforts, pick.defaultEffort);
|
|
158
|
-
return { ...sized, status: "proposed", proposedModel: pick.model, proposedEffort, reason: null };
|
|
182
|
+
return { ...sized, status: "proposed", proposedModel: pick.model, tierSource: pick.tierSource, proposedEffort, reason: null };
|
|
159
183
|
});
|
|
160
184
|
}
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Measured capability per task domain, so role auto-assign can tier candidates by what they score
|
|
3
|
+
* instead of what they cost. Artificial Analysis is read live when configured:
|
|
4
|
+
*
|
|
5
|
+
* - Artificial Analysis (https://artificialanalysis.ai/api-reference), when the user configures
|
|
6
|
+
* their own API key. Its terms allow that user's internal use with attribution and forbid
|
|
7
|
+
* redistributing the raw data, so its scores never leave this process.
|
|
8
|
+
*
|
|
9
|
+
* Each domain maps to one published index. The source names a model by display name
|
|
10
|
+
* with one row per reasoning setting ("Claude Opus 5.5 (High)"); capabilityModelKey drops the
|
|
11
|
+
* setting and folds the rest to a slug, which matches a catalog id once its provider prefix is
|
|
12
|
+
* gone ("cpa/claude-opus-5-5"). The best setting's score stands for the model, since a role can
|
|
13
|
+
* be given that setting. A candidate with no row is unmeasured, never guessed.
|
|
14
|
+
*/
|
|
15
|
+
import { resolveProviderApiKey } from "../providers/api-key-resolve";
|
|
16
|
+
import type { OcxConfig } from "../types";
|
|
17
|
+
import type { SizingDomain } from "./role-sizing";
|
|
18
|
+
|
|
19
|
+
export interface CapabilitySource {
|
|
20
|
+
readonly name: string;
|
|
21
|
+
readonly url: string;
|
|
22
|
+
readonly license: string;
|
|
23
|
+
/** Whether the terms let a response carry the raw scores. */
|
|
24
|
+
readonly redistributable: boolean;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export const ARTIFICIAL_ANALYSIS_SOURCE: CapabilitySource = {
|
|
28
|
+
name: "Artificial Analysis",
|
|
29
|
+
url: "https://artificialanalysis.ai",
|
|
30
|
+
license: "Artificial Analysis API terms: internal use, attribution required, no redistribution",
|
|
31
|
+
redistributable: false,
|
|
32
|
+
};
|
|
33
|
+
|
|
34
|
+
const ARTIFICIAL_ANALYSIS_URL = "https://artificialanalysis.ai/api/v2/data/llms/models";
|
|
35
|
+
|
|
36
|
+
/** Per domain, the indexes to read in order; the first one the response carries is used. */
|
|
37
|
+
const INTELLIGENCE_INDEX = "artificial_analysis_intelligence_index";
|
|
38
|
+
const ARTIFICIAL_ANALYSIS_INDEXES: Record<SizingDomain, readonly string[]> = {
|
|
39
|
+
coding: ["artificial_analysis_coding_index", INTELLIGENCE_INDEX],
|
|
40
|
+
agentic: ["artificial_analysis_agentic_index", INTELLIGENCE_INDEX],
|
|
41
|
+
reasoning: ["artificial_analysis_math_index", INTELLIGENCE_INDEX],
|
|
42
|
+
writing: [INTELLIGENCE_INDEX],
|
|
43
|
+
knowledge: [INTELLIGENCE_INDEX],
|
|
44
|
+
general: [INTELLIGENCE_INDEX],
|
|
45
|
+
};
|
|
46
|
+
|
|
47
|
+
const FETCH_TIMEOUT_MS = 30_000;
|
|
48
|
+
/** Each published table is under 1 MB today; 16 MB leaves room to grow and still bounds memory. */
|
|
49
|
+
export const MAX_TABLE_BYTES = 16 * 1024 * 1024;
|
|
50
|
+
|
|
51
|
+
export interface CapabilityTable {
|
|
52
|
+
readonly source: CapabilitySource | null;
|
|
53
|
+
readonly publishedAt: string | null;
|
|
54
|
+
/** Per domain: model key to its best published score. */
|
|
55
|
+
readonly domains: Partial<Record<SizingDomain, ReadonlyMap<string, number>>>;
|
|
56
|
+
/** Why a configured source was passed over for this one. */
|
|
57
|
+
readonly fallbackReason?: string;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
export type LoadCapability = (config: OcxConfig) => Promise<CapabilityTable>;
|
|
61
|
+
|
|
62
|
+
export function capabilityModelKey(name: string): string {
|
|
63
|
+
return name.toLowerCase().replace(/\([^)]*\)/g, " ").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
export function candidateModelKey(slug: string): string {
|
|
67
|
+
return capabilityModelKey(slug.slice(slug.lastIndexOf("/") + 1));
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
function keepBest(scores: Map<string, number>, key: string, value: number) {
|
|
71
|
+
if (key) scores.set(key, Math.max(value, scores.get(key) ?? -Infinity));
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
export function capabilityTableFromArtificialAnalysis(body: unknown): CapabilityTable {
|
|
75
|
+
const rows = (body as { data?: unknown } | null)?.data;
|
|
76
|
+
if (!Array.isArray(rows)) throw new Error("Artificial Analysis returned no model list");
|
|
77
|
+
const domains: Partial<Record<SizingDomain, Map<string, number>>> = {};
|
|
78
|
+
for (const [domain, indexes] of Object.entries(ARTIFICIAL_ANALYSIS_INDEXES) as [SizingDomain, readonly string[]][]) {
|
|
79
|
+
for (const index of indexes) {
|
|
80
|
+
const scores = new Map<string, number>();
|
|
81
|
+
for (const row of rows as Record<string, unknown>[]) {
|
|
82
|
+
const value = (row?.evaluations as Record<string, unknown> | undefined)?.[index];
|
|
83
|
+
if (typeof value !== "number" || !Number.isFinite(value)) continue;
|
|
84
|
+
if (typeof row.name === "string") keepBest(scores, capabilityModelKey(row.name), value);
|
|
85
|
+
if (typeof row.slug === "string") keepBest(scores, capabilityModelKey(row.slug), value);
|
|
86
|
+
}
|
|
87
|
+
if (scores.size > 0) {
|
|
88
|
+
domains[domain] = scores;
|
|
89
|
+
break;
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
return { source: ARTIFICIAL_ANALYSIS_SOURCE, publishedAt: null, domains };
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/** The body's bytes, refused once they pass maxBytes, whatever the transport declared. */
|
|
97
|
+
export async function readBoundedBytes(response: Response, maxBytes: number): Promise<ArrayBuffer> {
|
|
98
|
+
const chunks: Uint8Array[] = [];
|
|
99
|
+
let length = 0;
|
|
100
|
+
const reader = response.body?.getReader();
|
|
101
|
+
if (!reader) return new ArrayBuffer(0);
|
|
102
|
+
for (;;) {
|
|
103
|
+
const { done, value } = await reader.read();
|
|
104
|
+
if (done) break;
|
|
105
|
+
if (length + value.byteLength > maxBytes) {
|
|
106
|
+
await reader.cancel();
|
|
107
|
+
throw new Error("response exceeded byte bound");
|
|
108
|
+
}
|
|
109
|
+
chunks.push(value);
|
|
110
|
+
length += value.byteLength;
|
|
111
|
+
}
|
|
112
|
+
const out = new Uint8Array(length);
|
|
113
|
+
let offset = 0;
|
|
114
|
+
for (const chunk of chunks) {
|
|
115
|
+
out.set(chunk, offset);
|
|
116
|
+
offset += chunk.byteLength;
|
|
117
|
+
}
|
|
118
|
+
return out.buffer;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
export async function fetchArtificialAnalysisTable(apiKey: string, fetchImpl: typeof fetch = fetch): Promise<CapabilityTable> {
|
|
122
|
+
const response = await fetchImpl(ARTIFICIAL_ANALYSIS_URL, {
|
|
123
|
+
redirect: "error",
|
|
124
|
+
headers: { "x-api-key": apiKey },
|
|
125
|
+
signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
|
|
126
|
+
});
|
|
127
|
+
if (!response.ok) throw new Error(`HTTP ${response.status}`);
|
|
128
|
+
const bytes = await readBoundedBytes(response, MAX_TABLE_BYTES);
|
|
129
|
+
return capabilityTableFromArtificialAnalysis(JSON.parse(new TextDecoder().decode(bytes)));
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/** One fetch per period key; a failed fetch is forgotten so the next request retries. */
|
|
133
|
+
function periodCache() {
|
|
134
|
+
let slot: { key: string; table: Promise<CapabilityTable> } | null = null;
|
|
135
|
+
return (key: string, fetchTable: () => Promise<CapabilityTable>): Promise<CapabilityTable> => {
|
|
136
|
+
if (slot?.key === key) return slot.table;
|
|
137
|
+
const table = fetchTable();
|
|
138
|
+
slot = { key, table };
|
|
139
|
+
table.catch(() => { if (slot?.table === table) slot = null; });
|
|
140
|
+
return table;
|
|
141
|
+
};
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
const artificialAnalysisCache = periodCache();
|
|
145
|
+
|
|
146
|
+
/**
|
|
147
|
+
* Artificial Analysis when the user's key resolves, read once per UTC day to stay inside the
|
|
148
|
+
* free tier's daily request quota. Absent or unavailable scores leave price ranking in charge.
|
|
149
|
+
*/
|
|
150
|
+
export const loadCapabilityTable: LoadCapability = async config => {
|
|
151
|
+
const now = new Date().toISOString();
|
|
152
|
+
const unavailable = (fallbackReason: string): CapabilityTable => ({ source: null, publishedAt: null, domains: {}, fallbackReason });
|
|
153
|
+
const apiKey = resolveProviderApiKey(config.codexRoleCapability?.artificialAnalysis?.apiKey)?.trim();
|
|
154
|
+
if (!apiKey) return unavailable("benchmark data was unavailable: no Artificial Analysis key is configured");
|
|
155
|
+
try {
|
|
156
|
+
return await artificialAnalysisCache(`${now.slice(0, 10)} ${apiKey}`, () => fetchArtificialAnalysisTable(apiKey));
|
|
157
|
+
} catch {
|
|
158
|
+
return unavailable("Artificial Analysis could not be read");
|
|
159
|
+
}
|
|
160
|
+
};
|
|
@@ -0,0 +1,253 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Every role model write the omo tab and `ocx agent roles set` make, so a role can be put back.
|
|
3
|
+
* The integration journal cannot hold these: it snapshots one client config per operation, and a
|
|
4
|
+
* role write spans `$CODEX_HOME/agents/<role>.toml` and LazyCodex's omo.jsonc mirror. So the
|
|
5
|
+
* values are recorded rather than bytes, and a restore is an ordinary write of the earlier values.
|
|
6
|
+
* Writes made in one action (auto-assign's Apply all) share a batch and are restored together.
|
|
7
|
+
* The server hands out batch ids and a write joins a batch only while the history still holds it whole,
|
|
8
|
+
* so an id compaction dropped can never start over and pass for the beginning of a batch. Every row
|
|
9
|
+
* carries its number in its batch, which keeps the cap durable and lets a read tell a whole batch
|
|
10
|
+
* from a cut one, which is never listed or restored.
|
|
11
|
+
* The file sits under the opencodex config directory, which outlives a switch of Codex home, so every
|
|
12
|
+
* row names the canonical Codex home it was written in and only that home's rows are listed or restored.
|
|
13
|
+
* The file is bounded three ways: a batch holds at most ROLE_HISTORY_LIMIT rows, an append that takes
|
|
14
|
+
* the file past ROLE_HISTORY_MAX_BYTES rewrites it to its newest whole batches, and a read looks at
|
|
15
|
+
* no more than that many bytes and ROLE_HISTORY_MAX_ROWS rows from the end.
|
|
16
|
+
*/
|
|
17
|
+
import { appendFileSync, closeSync, fstatSync, openSync, readSync, statSync } from "node:fs";
|
|
18
|
+
import { join } from "node:path";
|
|
19
|
+
import { atomicWriteFile } from "../config/atomic-write";
|
|
20
|
+
import { ensureDir, integrationsDir } from "../integrations/ownership";
|
|
21
|
+
|
|
22
|
+
export interface RoleSetting {
|
|
23
|
+
readonly model: string | null;
|
|
24
|
+
readonly effort: string | null;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export interface RoleModelChange {
|
|
28
|
+
readonly at: string;
|
|
29
|
+
readonly batch: string;
|
|
30
|
+
readonly role: string;
|
|
31
|
+
readonly before: RoleSetting;
|
|
32
|
+
readonly after: RoleSetting;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
interface StoredRoleModelChange extends RoleModelChange {
|
|
36
|
+
readonly codexHome: string;
|
|
37
|
+
/** This row's number in its batch, from 1: a batch is whole when it holds rows 1 to its highest. */
|
|
38
|
+
readonly n: number;
|
|
39
|
+
/** The batch this row's write restored, so compaction keeps that batch while the Restore is kept. */
|
|
40
|
+
readonly restores?: string;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/** The batch a write is recorded in and its row number there. */
|
|
44
|
+
export interface BatchSlot {
|
|
45
|
+
readonly batch: string;
|
|
46
|
+
readonly n: number;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** Rows one listing returns, and rows one batch may hold, so a whole batch always fits a listing. */
|
|
50
|
+
export const ROLE_HISTORY_LIMIT = 50;
|
|
51
|
+
export const ROLE_HISTORY_MAX_BYTES = 256 * 1024;
|
|
52
|
+
export const ROLE_HISTORY_MAX_ROWS = 1000;
|
|
53
|
+
const BATCH_PATTERN = /^[A-Za-z0-9-]{1,64}$/;
|
|
54
|
+
|
|
55
|
+
function historyPath(dir: string): string {
|
|
56
|
+
return join(dir, "codex-agent-roles.jsonl");
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
export function isRoleHistoryBatch(value: unknown): value is string {
|
|
60
|
+
return typeof value === "string" && BATCH_PATTERN.test(value);
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** `codexHome` is the canonical path `getCodexHome()` returns, so two spellings of one home match. */
|
|
64
|
+
export function recordRoleModelChange(codexHome: string, change: RoleModelChange & { readonly n: number; readonly restores?: string }, dir: string = integrationsDir()): void {
|
|
65
|
+
ensureDir(historyPath(dir));
|
|
66
|
+
const stored: StoredRoleModelChange = { ...change, codexHome };
|
|
67
|
+
// Capture the complete source before this append can move its first row outside either tail limit.
|
|
68
|
+
const tail = tailRows(historyPath(dir));
|
|
69
|
+
// An interrupted JSONL suffix must not swallow the first record returned after restart.
|
|
70
|
+
appendFileSync(historyPath(dir), `${tail.unterminated ? "\n" : ""}${JSON.stringify(stored)}\n`, { encoding: "utf8", mode: 0o600 });
|
|
71
|
+
if (statSync(historyPath(dir)).size <= ROLE_HISTORY_MAX_BYTES && tail.lines < ROLE_HISTORY_MAX_ROWS) return;
|
|
72
|
+
try {
|
|
73
|
+
compact(dir, wholeBatches([stored, ...tail.rows]));
|
|
74
|
+
} catch (cause) {
|
|
75
|
+
// Reads stay bounded without the trim; the next append retries it.
|
|
76
|
+
throw new Error("recorded the change but could not trim the history file", { cause });
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* Rewrite the file to its newest rows within half the byte budget and the row budget, so the next
|
|
82
|
+
* compaction is many saves away. A batch the cut falls inside is dropped whole, for every Codex home,
|
|
83
|
+
* so no home is left with part of an Apply all to restore. A kept Restore keeps the batch it restores
|
|
84
|
+
* whole when the Restore and its sources fit both read limits; protected rows displace older batches.
|
|
85
|
+
*/
|
|
86
|
+
function compact(dir: string, rows: StoredRoleModelChange[]): void {
|
|
87
|
+
const batches = new Map<string, StoredRoleModelChange[]>();
|
|
88
|
+
for (const row of rows) {
|
|
89
|
+
const key = batchKey(row);
|
|
90
|
+
batches.set(key, [...(batches.get(key) ?? []), row]);
|
|
91
|
+
}
|
|
92
|
+
const keep = new Set<string>();
|
|
93
|
+
let bytes = 0;
|
|
94
|
+
let count = 0;
|
|
95
|
+
for (const key of batches.keys()) {
|
|
96
|
+
if (keep.has(key)) continue;
|
|
97
|
+
const needed = new Set([key]);
|
|
98
|
+
// Include source dependencies before admitting a batch, so they share its byte and row budgets.
|
|
99
|
+
for (const dependency of needed) {
|
|
100
|
+
for (const row of batches.get(dependency) ?? []) {
|
|
101
|
+
if (row.restores) {
|
|
102
|
+
const source = batchKey({ ...row, batch: row.restores });
|
|
103
|
+
if (batches.has(source) && !keep.has(source)) needed.add(source);
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
const added = rows.filter(row => needed.has(batchKey(row)));
|
|
108
|
+
const addedBytes = added.reduce((sum, row) => sum + Buffer.byteLength(JSON.stringify(row)) + 1, 0);
|
|
109
|
+
if (bytes + addedBytes > ROLE_HISTORY_MAX_BYTES || count + added.length > ROLE_HISTORY_MAX_ROWS) break;
|
|
110
|
+
// Ordinary batches stay within the half-budget target; Restore sources may use the headroom.
|
|
111
|
+
if (bytes + addedBytes > ROLE_HISTORY_MAX_BYTES / 2 && !added.some(row => row.restores)) break;
|
|
112
|
+
for (const dependency of needed) keep.add(dependency);
|
|
113
|
+
bytes += addedBytes;
|
|
114
|
+
count += added.length;
|
|
115
|
+
if (bytes >= ROLE_HISTORY_MAX_BYTES / 2) break;
|
|
116
|
+
}
|
|
117
|
+
const whole = rows.filter(row => keep.has(batchKey(row))).reverse();
|
|
118
|
+
atomicWriteFile(historyPath(dir), whole.map(row => `${JSON.stringify(row)}\n`).join(""));
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
function batchKey(row: Pick<StoredRoleModelChange, "codexHome" | "batch">): string {
|
|
122
|
+
return `${row.codexHome}\n${row.batch}`;
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
function isSetting(value: unknown): value is RoleSetting {
|
|
126
|
+
const setting = value as RoleSetting | null;
|
|
127
|
+
return typeof setting === "object" && setting !== null
|
|
128
|
+
&& (setting.model === null || typeof setting.model === "string")
|
|
129
|
+
&& (setting.effort === null || typeof setting.effort === "string");
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
function parseRow(line: string): StoredRoleModelChange | null {
|
|
133
|
+
let value: unknown;
|
|
134
|
+
try {
|
|
135
|
+
value = JSON.parse(line);
|
|
136
|
+
} catch {
|
|
137
|
+
return null;
|
|
138
|
+
}
|
|
139
|
+
const change = value as StoredRoleModelChange | null;
|
|
140
|
+
return typeof change === "object" && change !== null && typeof change.codexHome === "string"
|
|
141
|
+
&& typeof change.at === "string" && typeof change.role === "string"
|
|
142
|
+
&& isRoleHistoryBatch(change.batch) && isSetting(change.before) && isSetting(change.after)
|
|
143
|
+
&& Number.isSafeInteger(change.n) && change.n >= 1
|
|
144
|
+
&& (change.restores === undefined || isRoleHistoryBatch(change.restores))
|
|
145
|
+
? change
|
|
146
|
+
: null;
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
/**
|
|
150
|
+
* Every Codex home's rows, newest first, from at most the last ROLE_HISTORY_MAX_BYTES of the file and
|
|
151
|
+
* at most ROLE_HISTORY_MAX_ROWS of them. When the read starts mid-file, its first partial line is
|
|
152
|
+
* skipped; a batch that continues above the read is left for `wholeBatches` to drop.
|
|
153
|
+
*/
|
|
154
|
+
function tailRows(path: string): { rows: StoredRoleModelChange[]; lines: number; unterminated: boolean } {
|
|
155
|
+
let fd: number;
|
|
156
|
+
try {
|
|
157
|
+
fd = openSync(path, "r");
|
|
158
|
+
} catch (error) {
|
|
159
|
+
if ((error as NodeJS.ErrnoException).code === "ENOENT") return { rows: [], lines: 0, unterminated: false };
|
|
160
|
+
throw error;
|
|
161
|
+
}
|
|
162
|
+
let text: string;
|
|
163
|
+
try {
|
|
164
|
+
const stat = fstatSync(fd);
|
|
165
|
+
// Windows opens a directory for reading, so the type is checked rather than left to the read.
|
|
166
|
+
if (!stat.isFile()) throw new Error(`${path} is not a regular file`);
|
|
167
|
+
const size = stat.size;
|
|
168
|
+
const start = Math.max(0, size - ROLE_HISTORY_MAX_BYTES - 1);
|
|
169
|
+
const bytes = Buffer.alloc(size - start);
|
|
170
|
+
let length = 0;
|
|
171
|
+
while (length < bytes.length) {
|
|
172
|
+
const count = readSync(fd, bytes, length, bytes.length - length, start + length);
|
|
173
|
+
if (count === 0) break;
|
|
174
|
+
length += count;
|
|
175
|
+
}
|
|
176
|
+
const read = bytes.subarray(0, length);
|
|
177
|
+
text = (start > 0 ? read.subarray(read.indexOf(10) + 1) : read).toString("utf8");
|
|
178
|
+
} finally {
|
|
179
|
+
closeSync(fd);
|
|
180
|
+
}
|
|
181
|
+
const lines = text.split("\n").filter(line => line.trim()).slice(-ROLE_HISTORY_MAX_ROWS);
|
|
182
|
+
const rows = lines.flatMap(line => {
|
|
183
|
+
const row = parseRow(line);
|
|
184
|
+
return row ? [row] : [];
|
|
185
|
+
}).reverse();
|
|
186
|
+
return { rows, lines: lines.length, unterminated: text.length > 0 && !text.endsWith("\n") };
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
/**
|
|
190
|
+
* The rows of every batch that holds each of its rows 1 to its highest, so a batch the read or a
|
|
191
|
+
* compaction cut into is never offered as if it were whole.
|
|
192
|
+
*/
|
|
193
|
+
function wholeBatches(rows: StoredRoleModelChange[]): StoredRoleModelChange[] {
|
|
194
|
+
const numbers = new Map<string, Set<number>>();
|
|
195
|
+
const highest = new Map<string, number>();
|
|
196
|
+
for (const row of rows) {
|
|
197
|
+
const key = batchKey(row);
|
|
198
|
+
numbers.set(key, (numbers.get(key) ?? new Set()).add(row.n));
|
|
199
|
+
highest.set(key, Math.max(highest.get(key) ?? 0, row.n));
|
|
200
|
+
}
|
|
201
|
+
return rows.filter(row => numbers.get(batchKey(row))!.size === highest.get(batchKey(row)));
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
function forHome(rows: StoredRoleModelChange[], codexHome: string): RoleModelChange[] {
|
|
205
|
+
return rows.flatMap(({ codexHome: home, n: _n, restores: _restores, ...change }) => home === codexHome ? [change] : []);
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
/**
|
|
209
|
+
* This Codex home's changes, newest first, in whole batches and never more than `limit` rows: batches
|
|
210
|
+
* are taken newest first until the next would not fit, so Restore never puts back part of an Apply all.
|
|
211
|
+
* A batch larger than `limit` (written before batches were capped) can never be listed whole and is
|
|
212
|
+
* skipped. A torn or foreign line, and a row another Codex home wrote, is skipped, the way the
|
|
213
|
+
* integration journal reads its own.
|
|
214
|
+
*/
|
|
215
|
+
export function listRoleModelChanges(codexHome: string, limit: number = ROLE_HISTORY_LIMIT, dir: string = integrationsDir()): RoleModelChange[] {
|
|
216
|
+
const newestFirst = forHome(wholeBatches(tailRows(historyPath(dir)).rows), codexHome);
|
|
217
|
+
const sizes = new Map<string, number>();
|
|
218
|
+
for (const change of newestFirst) sizes.set(change.batch, (sizes.get(change.batch) ?? 0) + 1);
|
|
219
|
+
const listed = new Set<string>();
|
|
220
|
+
let count = 0;
|
|
221
|
+
for (const [batch, size] of sizes) {
|
|
222
|
+
if (size > limit) continue;
|
|
223
|
+
if (count + size > limit) break;
|
|
224
|
+
listed.add(batch);
|
|
225
|
+
count += size;
|
|
226
|
+
}
|
|
227
|
+
return newestFirst.filter(change => listed.has(change.batch));
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
/**
|
|
231
|
+
* Where a write in this Codex home is recorded. Without `batch` it starts a new batch under a fresh id.
|
|
232
|
+
* With one, it joins that batch only while this home's retained history holds the batch whole, and is
|
|
233
|
+
* refused once the batch holds ROLE_HISTORY_LIMIT rows. An id compaction dropped, or one the server
|
|
234
|
+
* never handed out, is closed: it cannot take a row and pass for the start of a batch.
|
|
235
|
+
*/
|
|
236
|
+
export function claimBatchRow(codexHome: string, batch: string | undefined, dir: string = integrationsDir()): BatchSlot | "batch_closed" | "batch_full" {
|
|
237
|
+
if (batch === undefined) return { batch: crypto.randomUUID(), n: 1 };
|
|
238
|
+
const held = wholeBatches(tailRows(historyPath(dir)).rows).filter(row => row.codexHome === codexHome && row.batch === batch);
|
|
239
|
+
if (held.length === 0) return "batch_closed";
|
|
240
|
+
return held.length >= ROLE_HISTORY_LIMIT ? "batch_full" : { batch, n: held.length + 1 };
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
/**
|
|
244
|
+
* The setting a Restore of `batch` may put back on `role` in this Codex home: the role's earliest
|
|
245
|
+
* `before` in that batch, or null when this home's retained history has no such change. The server
|
|
246
|
+
* checks a restore against it, so a dashboard still showing another home's history cannot write
|
|
247
|
+
* that home's earlier models here. It reads every retained batch rather than the 50-row listing,
|
|
248
|
+
* because a Restore's own rows push the batch it restores out of that listing before it finishes.
|
|
249
|
+
*/
|
|
250
|
+
export function restorableSetting(codexHome: string, batch: string, role: string, dir: string = integrationsDir()): RoleSetting | null {
|
|
251
|
+
const changes = forHome(wholeBatches(tailRows(historyPath(dir)).rows), codexHome).filter(change => change.batch === batch && change.role === role);
|
|
252
|
+
return changes.at(-1)?.before ?? null;
|
|
253
|
+
}
|
package/src/codex/role-sizing.ts
CHANGED
|
@@ -43,6 +43,10 @@ export type SizingTier = typeof SIZING_TIERS[number];
|
|
|
43
43
|
export const SIZING_EFFORTS = ["glance", "measured", "thorough", "exhaustive"] as const;
|
|
44
44
|
export type SizingEffort = typeof SIZING_EFFORTS[number];
|
|
45
45
|
|
|
46
|
+
/** Task domains, the kind of capability a tier is measured in. A label, never a model or a vendor. */
|
|
47
|
+
export const SIZING_DOMAINS = ["coding", "agentic", "reasoning", "writing", "knowledge", "general"] as const;
|
|
48
|
+
export type SizingDomain = typeof SIZING_DOMAINS[number];
|
|
49
|
+
|
|
46
50
|
const MAX_FIELD_CHARS = 400;
|
|
47
51
|
|
|
48
52
|
export const ROLE_SIZING_SYSTEM_PROMPT = [
|
|
@@ -66,6 +70,15 @@ export const ROLE_SIZING_SYSTEM_PROMPT = [
|
|
|
66
70
|
"or a strong model needs only a quick call. Effort buys deliberation, never capability, and more",
|
|
67
71
|
"effort is not more correct.",
|
|
68
72
|
"",
|
|
73
|
+
"Task domain names the kind of capability the tier is measured in. It sizes nothing; it tells the",
|
|
74
|
+
"mapping which measured strength matters, because models of one price class differ by domain:",
|
|
75
|
+
"- coding: writing, changing, or reviewing code in a repository.",
|
|
76
|
+
"- agentic: long multi-step tool use, where the work is completing a run of actions without derailing.",
|
|
77
|
+
"- reasoning: math, logic, planning, or analysis whose answer is derived rather than looked up.",
|
|
78
|
+
"- writing: prose meant for a reader: documents, messages, copy.",
|
|
79
|
+
"- knowledge: research and factual recall across sources.",
|
|
80
|
+
"- general: none of the above dominates. Pick it rather than guess.",
|
|
81
|
+
"",
|
|
69
82
|
"Assess risk and complexity once for both dials:",
|
|
70
83
|
"- file, module, or ownership boundary crossing;",
|
|
71
84
|
"- reversibility and blast radius;",
|
|
@@ -86,8 +99,8 @@ export const ROLE_SIZING_SYSTEM_PROMPT = [
|
|
|
86
99
|
"- Use only the neutral words above. Do not name concrete model products, vendors, versions, or vendor effort levels anywhere in the answer.",
|
|
87
100
|
"",
|
|
88
101
|
"Answer with one JSON object and nothing else, no prose and no code fence:",
|
|
89
|
-
'{"roles":{"<role name>":{"tier":"fast|standard|frontier","effort":"glance|measured|thorough|exhaustive","rationale":"<one sentence covering both dials>","move_up_if":"<signals that would justify a stronger tier or higher effort>","move_down_if":"<signals that would justify a cheaper tier or lower effort>"}}}',
|
|
90
|
-
"Include every role you were given, keyed by its exact name, with exactly those
|
|
102
|
+
'{"roles":{"<role name>":{"tier":"fast|standard|frontier","effort":"glance|measured|thorough|exhaustive","domain":"coding|agentic|reasoning|writing|knowledge|general","rationale":"<one sentence covering both dials>","move_up_if":"<signals that would justify a stronger tier or higher effort>","move_down_if":"<signals that would justify a cheaper tier or lower effort>"}}}',
|
|
103
|
+
"Include every role you were given, keyed by its exact name, with exactly those six fields.",
|
|
91
104
|
].join("\n");
|
|
92
105
|
|
|
93
106
|
/**
|
|
@@ -105,6 +118,7 @@ export const DELEGATED_WORK_SIZING_SYSTEM_PROMPT = [
|
|
|
105
118
|
export interface RoleSizing {
|
|
106
119
|
readonly tier: SizingTier;
|
|
107
120
|
readonly effort: SizingEffort;
|
|
121
|
+
readonly domain: SizingDomain;
|
|
108
122
|
readonly rationale: string;
|
|
109
123
|
readonly moveUpIf: string;
|
|
110
124
|
readonly moveDownIf: string;
|
|
@@ -167,13 +181,16 @@ function validateEntry(entry: unknown): RoleSizingOutcome {
|
|
|
167
181
|
const fields = entry as Record<string, unknown>;
|
|
168
182
|
if (!isMember(SIZING_TIERS, fields.tier)) return { unsized: "the sizing answer has no valid tier" };
|
|
169
183
|
if (!isMember(SIZING_EFFORTS, fields.effort)) return { unsized: "the sizing answer has no valid effort" };
|
|
184
|
+
// A missing or unknown domain still sizes the role on the overall scale: the domain only picks
|
|
185
|
+
// which measured capability ranks the candidates, and "general" is the rubric's own no-signal answer.
|
|
186
|
+
const domain = isMember(SIZING_DOMAINS, fields.domain) ? fields.domain : "general";
|
|
170
187
|
const rationale = oneLine(fields.rationale);
|
|
171
188
|
const moveUpIf = oneLine(fields.move_up_if);
|
|
172
189
|
const moveDownIf = oneLine(fields.move_down_if);
|
|
173
190
|
if (rationale === null || moveUpIf === null || moveDownIf === null) {
|
|
174
191
|
return { unsized: "the sizing answer is missing a rationale or a move trigger" };
|
|
175
192
|
}
|
|
176
|
-
return { sizing: { tier: fields.tier, effort: fields.effort, rationale, moveUpIf, moveDownIf } };
|
|
193
|
+
return { sizing: { tier: fields.tier, effort: fields.effort, domain, rationale, moveUpIf, moveDownIf } };
|
|
177
194
|
}
|
|
178
195
|
|
|
179
196
|
const CODE_FENCE = /^\x60{3}(?:json)?[ \t]*\r?\n([\s\S]*?)\r?\n[ \t]*\x60{3}$/i;
|
|
@@ -183,9 +200,10 @@ const CODE_FENCE = /^\x60{3}(?:json)?[ \t]*\r?\n([\s\S]*?)\r?\n[ \t]*\x60{3}$/i;
|
|
|
183
200
|
*
|
|
184
201
|
* The answer must be one JSON object of the shape the rubric asks for. Two leniencies, both for
|
|
185
202
|
* content the mapping never reads: a single surrounding code fence, which models add out of habit,
|
|
186
|
-
* and keys beyond the
|
|
187
|
-
* still be present and valid
|
|
188
|
-
*
|
|
203
|
+
* and keys beyond the six fields in a role's entry, which are ignored. Tier, effort, rationale and
|
|
204
|
+
* both move triggers must still be present and valid; a missing domain falls back to "general".
|
|
205
|
+
* Anything else wrong marks the affected role, or every role when the whole answer is unusable,
|
|
206
|
+
* as unsized with the reason.
|
|
189
207
|
*/
|
|
190
208
|
export function parseRoleSizingResponse(text: string, roles: readonly string[]): Map<string, RoleSizingOutcome> {
|
|
191
209
|
const out = new Map<string, RoleSizingOutcome>();
|