From bfa05d9961b7404dd97f0b9329f38cd34efa4874 Mon Sep 17 00:00:00 2001 From: devlikebear Date: Mon, 24 Aug 2026 09:21:45 +0900 Subject: [PATCH 1/5] refactor(console): write down console purpose and file-first config policy Part of #919. Refs #931. Step 1 of the console-narrowing first cut: normative purpose statement (conversation / observability / targeted control), route inventory mapped to pillars, and the config policy (file-first, inspection-not-editing) recorded in DESIGN.md before any visual or route change. --- frontend/console/DESIGN.md | 46 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) diff --git a/frontend/console/DESIGN.md b/frontend/console/DESIGN.md index c378b398..1cfc57e2 100644 --- a/frontend/console/DESIGN.md +++ b/frontend/console/DESIGN.md @@ -228,6 +228,52 @@ The aesthetic resists three temptations: The system is dark-first. There is no light theme; light backgrounds wash out the warmth of the accent and break the workshop framing. +## Console Purpose & Surface Policy (#931) + +Decision recorded in the console-narrowing first cut (`refactor/console-narrow-surface`, Refs #931, Part of epic #919 LP-012). This section is normative for future surface decisions: when a proposed feature does not fit one of the pillars below, it belongs in a skill, a CLI command, or the YAML file — not a new console route. + +### Purpose + +The TARS Console exists for exactly three things: + +1. **Conversation** — chat with the agent, steer sessions (title/archive/pin/fork, goal/critic, prompt override), switch active cwd, inspect transcripts and work timelines. +2. **Observability** — read system signals: pulse findings, reflection runs, ops health and cleanup plans, memory state, agent-runtime runs/subagents/costs, logs, analytics, event stream. +3. **Targeted control** — the small set of mutations that genuinely need UI: onboarding (provider/tier setup), credential entry, approvals (approve/reject destructive ops), cron job CRUD, extension install/enable/disable, channel pairing, remote access, restart/reset. + +Everything else is **file-first**. Configuration is owned by `workspace/config/tars.config.yaml` (documented in `config/tars.config.example.yaml`, validated server-side at load). The console offers *inspection and validation* of configuration, not full editing: long-tail fields are read-only in the UI with a pointer to their documented YAML key. + +### Route inventory + +Every route must map to a pillar. Current mapping (first cut keeps all routes; consolidation candidates are noted, not acted on): + +| Route | Pillar | Rationale | +|---|---|---| +| `/console` (home) | Observability | Dashboard summary of all signals | +| `/console/chat`, `/console/sessions` | Conversation | Chat transcript, session list | +| `/console/sessions/graph` | Conversation | Session lineage / fork history | +| `/console/tasks` | Conversation | Work timeline / task contracts | +| `/console/sysprompt`, `/console/workspace` | Conversation | System-prompt authoring (adjacent to chat behavior) | +| `/console/memory` | Observability | Memory assets, inbox review | +| `/console/agentruntime` | Observability | Runs, subagents, cost flow, replay | +| `/console/pulse`, `/console/heartbeat` | Observability | Watchdog findings | +| `/console/reflection` | Observability | Nightly batch results | +| `/console/ops`, `/console/approvals` | Observability + Control | Health/cleanup plus approve/reject | +| `/console/logs` | Observability | Log tail/filter | +| `/console/analytics` | Observability | Usage trends (consolidation candidate: overlaps home cards) | +| `/console/cron` | Control | Cron CRUD + run history | +| `/console/extensions` | Control | Skill/plugin/MCP management | +| `/console/channels` | Control | Telegram pairing | +| `/console/config` | Inspection | File-first config policy (see below) | +| `/console/onboarding` | Control (setup) | Provider/tier wizard; capability-preserving reentry | + +### Config policy: file-first, inspection-not-editing + +- Source of truth: `workspace/config/tars.config.yaml`. Reference doc: `config/tars.config.example.yaml`. Server validates on load and reports via `/v1/admin/config/schema`. +- Console **keeps UI editing** only for: onboarding flows (wizard), credential entry (API keys/tokens marked sensitive), and Quick Start basics that gate first-run readiness. +- Console **stops editing** the long tail: the Fields tab becomes a validated read view (current value, effective value under env override, default/restart/secret badges) with pointers to the documented YAML key instead of inline editors. Structured LLM provider/tier editing remains available through the onboarding wizard reentry. +- The raw YAML tab becomes a read view; editing happens in an editor against the real file, then restart applies it. +- Server write routes (`PUT /v1/admin/config`, `PATCH /v1/admin/config/values`) remain part of the HTTP API for CLI/scripting use even where the console stops calling them. + ## Colors The palette is rooted in deep neutrals, a single warm accent, and four semantic states. From 93dbb493d6822532d3cadc35979912540016333b Mon Sep 17 00:00:00 2001 From: devlikebear Date: Mon, 24 Aug 2026 09:22:37 +0900 Subject: [PATCH 2/5] refactor(console): record Config.svelte surface audit in DESIGN.md Part of #919. Refs #931. Step 2: classification of all 165 schema fields into (a) keep-UI (onboarding/credentials/session control), (b) read-only inspection candidates, and (c) YAML-first removals, including where each removed editor's capability lands. --- frontend/console/DESIGN.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/frontend/console/DESIGN.md b/frontend/console/DESIGN.md index 1cfc57e2..d01d3776 100644 --- a/frontend/console/DESIGN.md +++ b/frontend/console/DESIGN.md @@ -274,6 +274,27 @@ Every route must map to a pillar. Current mapping (first cut keeps all routes; c - The raw YAML tab becomes a read view; editing happens in an editor against the real file, then restart applies it. - Server write routes (`PUT /v1/admin/config`, `PATCH /v1/admin/config/values`) remain part of the HTTP API for CLI/scripting use even where the console stops calling them. +### Config surface audit (#931, first cut) + +Server schema exposes 165 fields (`internal/config/schema.go`) grouped into 15 sections. Audit of `Config.svelte` and `SessionConfigPanel.svelte` against actual usage classifies them as follows: + +**(a) Keep UI editing** — onboarding, credentials, session control: + +- Quick Start set (13 curated gates in `lib/quickStartFields.ts`): `api_auth_mode`, `llm_providers`, `llm_tiers`, `llm_default_tier`, `workspace_dir`, `telegram_bot_token`, `companion_enabled`, `embodiment_enabled`, `embodiment_providers_json`, `pulse_enabled`, `reflection_enabled`, `log_level`, `session_telegram_scope`. These gate first-run readiness and stay interactive. +- Credential/sensitive fields (masked entry preserved wherever surfaced): `api_auth_token`, `api_user_token`, `api_admin_token`, `memory_embed_api_key`, `tools_web_search_api_key`, `tools_web_search_perplexity_api_key`, `work_scheduler_a2a_bearer_token`. +- Structured LLM provider/tier editing stays in the console product — but lives in the onboarding wizard reentry (`/console/onboarding?reentry=1§ion=provider|tiers`), which already implements alias-replace saves with masked-key preservation. `Config.svelte` links there instead of hosting duplicate editors. +- `SessionConfigPanel.svelte` (session-scoped tools/skills/commands/MCP allowlists, automation consent, style controls) is session/cwd control — core purpose. Unchanged. + +**(b) Read-only inspection candidates** — validated read view + YAML key pointer: + +- Operational tuning long-tail across sections: Runtime logging/rotation, API inflight caps, Remote Access, Memory embedding tuning, Usage limits/budgets, Pulse thresholds/windows, Reflection windows, Compaction numbers, Tools toggles/timeouts/providers, MCP allowlist, Agent Runtime persistence/archive/watch/consensus knobs, Work Ledger / Work Scheduler internals (leases, polling, A2A), Channels enables, Assistant binaries, notify/schedule settings. +- These render value + effective-value-under-env-override + default/restart/secret badges. Editing happens in the YAML file; console shows what the server actually loaded. + +**(c) YAML-first removals** — editors deleted from `Config.svelte` in this cut (values remain visible read-only): + +- All four heavyweight modal editors: generic JSON editor, LLM tier editor, LLM provider editor, embodiment provider preset editor. +- Consequence table: `llm_providers` / `llm_tiers` → deep link to onboarding wizard sections (capability preserved). `embodiment_providers_json`, `llm_role_defaults`, `usage_price_overrides_json`, `mcp_servers_json`, `agentruntime_agents_json`, `agentruntime_task_override`, and every other `json`/`string_list` field → read-only summary plus documented YAML key (`config/tars.config.example.yaml`). If a dedicated UI for embodiment presets proves necessary later, it should be a follow-up issue scoped against this policy. + ## Colors The palette is rooted in deep neutrals, a single warm accent, and four semantic states. From 3e9d6336111f5fb573bb740510a5a09db49ca217 Mon Sep 17 00:00:00 2001 From: devlikebear Date: Mon, 24 Aug 2026 09:30:28 +0900 Subject: [PATCH 3/5] refactor(console): narrow Config page to Quick Start editing plus inspection MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Part of #919. Refs #931. Step 3: replace the long-tail field editors with a validated read-only inspection view (value, env-override effective value, default/restart/secret badges, documented YAML key). Remove the generic JSON / LLM tier / LLM provider / embodiment preset modal editors; provider and tier editing deep links to the onboarding wizard reentry which already preserves masked keys via alias-replace. YAML tab becomes a read view — file-first per DESIGN.md. Onboarding, credential entry, restart, danger zone, pending-changes diff, and LLM connection test unchanged. Config.svelte 3200 -> 1393 lines. --- frontend/console/src/components/Config.svelte | 2081 ++--------------- frontend/console/src/i18n/en.ts | 2 +- frontend/console/src/i18n/ko.ts | 2 +- .../console/tests/configModalLayout.test.ts | 29 +- .../console/tests/quickStartFields.test.ts | 14 +- 5 files changed, 164 insertions(+), 1964 deletions(-) diff --git a/frontend/console/src/components/Config.svelte b/frontend/console/src/components/Config.svelte index 8bd3d613..c3c242cb 100644 --- a/frontend/console/src/components/Config.svelte +++ b/frontend/console/src/components/Config.svelte @@ -4,8 +4,6 @@ getConfig, getConfigSchema, getProviderModels, - getProviders, - saveConfig, patchConfigValues, resetWorkspace, restartServer, @@ -14,80 +12,17 @@ import { buildConfigMetaBadges } from '../lib/configMetaBadges' import { buildQuickStartItems, quickStartProgress } from '../lib/quickStartFields' import { - LLM_PROVIDER_AUTH_MODES, - LLM_PROVIDER_KINDS, - LLM_TIER_SERVICE_TIERS, - EMBODIMENT_PROVIDER_CAPABILITY_DETAILS, - EMBODIMENT_PROVIDER_PRESETS, - EMBODIMENT_PROVIDER_TRANSPORTS, - buildEmbodimentProvidersFromDrafts, - buildLLMProvidersFromDrafts, - buildLLMTiersFromDrafts, configValuesEqual, - extractLLMProviderAliases, formatConfigDisplayValue, - makeEmbodimentProviderDrafts, - makeEmbodimentProviderPresetDraft, - makeLLMProviderDrafts, - makeLLMTierDrafts, - parseStructuredJSONEdit, - prettyConfigJSON, stringifyConfigValue, type ConfigDisplaySummary, - type EmbodimentCapabilityGroup, - type EmbodimentProviderDraft, - type EmbodimentProviderDraftErrors, - type EmbodimentProviderDraftField, - type EmbodimentProviderPreset, - type EmbodimentProviderPresetID, - type LLMProviderDraft, - type LLMProviderDraftErrors, - type LLMProviderDraftField, - type LLMTierDraft, - type LLMTierDraftErrors, - type LLMTierDraftField, } from '../lib/configStructured' - import { - availableAuthModesForKind, - defaultBaseURLForKind, - suggestedAuthModeForKind, - type AuthMode, - type ProviderKind, - } from '../lib/onboarding' - import { sortStrings } from '../lib/sort' - import type { ConfigEnvOverride, ConfigFieldMeta, ConfigSchema, ProvidersAPIInfo } from '../lib/types' + import type { ConfigEnvOverride, ConfigFieldMeta, ConfigSchema } from '../lib/types' import ConfigPendingChanges from './ConfigPendingChanges.svelte' import RemoteAccessCard from './RemoteAccessCard.svelte' import { t } from '../i18n' - type ViewMode = 'quick' | 'form' | 'yaml' - - const EMBODIMENT_FIELD_HINTS: Record = { - name: 'Unique body provider name. Use host for Mac Host or stackchan for physical StackChan.', - enabled: 'Disabled providers stay in config but cannot trigger cognition or receive actions.', - transport: 'Use mcp for tars-stackchan servers. Use webhook only when Endpoint is a full POST URL.', - endpoint: 'For mcp, this must match an mcp.servers key such as tars-stackchan or tars-stackchan-host.', - capabilities: 'Only declare capabilities the provider can actually perform; unsupported actions are dropped.', - session_id: 'Session that receives autonomous embodied turns. sess_main is the normal default.', - agent: 'Optional agent override for embodied turns. Leave blank to use the default agent.', - owner_only_directive: 'When enabled, only owner audio can become a directive. Ambient or stranger input stays observational.', - salience_min_sound_level: 'Audio salience threshold from 0 to 1. 0.6 is a conservative default.', - min_trigger_interval: 'Debounce window between autonomous trigger turns for this provider, for example 30s.', - max_triggers_per_hour: 'Hourly cap for autonomous trigger turns. 60 is the default guardrail.', - trigger_observations: 'Allow non-directive observations to trigger turns. Useful for Mac Host when owner detection is unknown.', - } - - const EMBODIMENT_CAPABILITY_GROUP_LABELS: Record = { - perception: 'Perception', - actuation: 'Actuation', - } - - const EMBODIMENT_CAPABILITY_GROUP_HINTS: Record = { - perception: 'Inputs the provider can send into TARS as Percepts.', - actuation: 'Body actions TARS can send back to the provider.', - } - - const EMBODIMENT_CAPABILITY_GROUPS: EmbodimentCapabilityGroup[] = ['perception', 'actuation'] + type ViewMode = 'quick' | 'inspect' | 'yaml' interface Props { onNavigate?: (path: string) => void @@ -101,42 +36,19 @@ let effectiveValues: Record = $state({}) let envOverrides: Record = $state({}) let yamlContent = $state('') - let originalYaml = $state('') let loading = $state(true) - let saving = $state(false) let error = $state('') let success = $state('') let viewMode: ViewMode = $state('quick') let expandedSections: Record = $state({}) - // -- Field editing -- + // -- Quick Start field editing (the only remaining config editing surface; + // everything else is inspection-first per DESIGN.md #931) -- let editingKey: string | null = $state(null) let editValue: string = $state('') let editBool: boolean = $state(false) let fieldSaving = $state(false) let dirtyFields: Record = $state({}) - let jsonEditorField: ConfigFieldMeta | null = $state(null) - let jsonEditorText = $state('') - let jsonEditorError = $state('') - let tierEditorField: ConfigFieldMeta | null = $state(null) - let tierDrafts: LLMTierDraft[] = $state([]) - let tierEditorErrors: LLMTierDraftErrors = $state({}) - let tierProviderOptions: string[] = $state([]) - let tierDraftSeq = 0 - let providerEditorField: ConfigFieldMeta | null = $state(null) - let providerDrafts: LLMProviderDraft[] = $state([]) - let providerEditorErrors: LLMProviderDraftErrors = $state({}) - let providerDraftSeq = 0 - let providerSecretReveal: Record = $state({}) - let embodimentProviderEditorField: ConfigFieldMeta | null = $state(null) - let embodimentProviderDrafts: EmbodimentProviderDraft[] = $state([]) - let embodimentProviderEditorErrors: EmbodimentProviderDraftErrors = $state({}) - let embodimentProviderDraftSeq = 0 - let tierModelOptionsByProvider: Record = $state({}) - let tierModelLoadingByProvider: Record = $state({}) - let tierModelLoadErrorByProvider: Record = $state({}) - let tierModelSupportsByAlias: Record = $state({}) - let providersMetadataRequest: Promise | null = $state(null) let llmTestBusy = $state(false) let llmTestResult = $state('') let llmTestKind: 'success' | 'error' | '' = $state('') @@ -144,9 +56,7 @@ let hasDirtyFields = $derived(Object.keys(dirtyFields).length > 0) let quickStartItems = $derived(buildQuickStartItems(schema, values, dirtyFields)) let quickStartStats = $derived(quickStartProgress(quickStartItems)) - let shouldShowFieldActions = $derived(viewMode === 'quick' || viewMode === 'form') - - // -- Diff popup -- + let shouldShowFieldActions = $derived(viewMode === 'quick') let showDiff = $state(false) let diffEntries = $derived.by(() => { @@ -237,8 +147,6 @@ return order.map((name) => ({ name, fields: groups[name] })) }) - let isYamlDirty = $derived(yamlContent !== originalYaml) - async function load() { loading = true error = '' @@ -251,7 +159,6 @@ effectiveValues = schemaResp.effective_values || {} envOverrides = schemaResp.env_overrides || {} yamlContent = rawResp.content - originalYaml = rawResp.content dirtyFields = {} const sectionNames = [...new Set(schemaResp.fields.map((f) => f.section))] for (let i = 0; i < Math.min(3, sectionNames.length); i++) { @@ -275,9 +182,6 @@ } else { editValue = current !== undefined && current !== null ? String(current) : '' } - } else if (field.type === 'json') { - if (field.sensitive) return // Don't expose full structured sensitive data - openStructuredEditor(field) } else { // Sensitive fields start empty so the masked value is not exposed editValue = field.sensitive ? '' : (current !== undefined && current !== null ? String(current) : '') @@ -299,13 +203,6 @@ .split(/\r?\n|,/) .map((item) => item.trim()) .filter(Boolean) - } else if (field.type === 'json') { - const result = parseStructuredJSONEdit(editValue) - if (!result.ok) { - error = result.error - return - } - parsed = result.value } else if (field.type === 'int') { parsed = editValue.trim() === '' ? 0 : parseInt(editValue, 10) if (isNaN(parsed as number)) { cancelEdit(); return } @@ -436,7 +333,6 @@ effectiveValues = schemaResp.effective_values || {} envOverrides = schemaResp.env_overrides || {} yamlContent = rawResp.content - originalYaml = rawResp.content } catch (e) { error = e instanceof Error ? e.message : 'Failed to save config' } finally { @@ -446,50 +342,20 @@ function handleDiscardFields() { dirtyFields = {} - closeJSONEditor() - closeTierEditor() - closeProviderEditor() - closeEmbodimentProviderEditor() - success = '' - error = '' - } - - async function handleSaveYaml() { - saving = true - error = '' + cancelEdit() success = '' - try { - await saveConfig(yamlContent) - originalYaml = yamlContent - success = 'Config saved. Restart TARS to apply changes.' - const schemaResp = await getConfigSchema() - schemaUpdatedAt = schemaResp.updated_at || '' - values = schemaResp.values - effectiveValues = schemaResp.effective_values || {} - envOverrides = schemaResp.env_overrides || {} - } catch (e) { - error = e instanceof Error ? e.message : 'Failed to save config' - } finally { - saving = false - } - } - - function handleResetYaml() { - yamlContent = originalYaml error = '' - success = '' } function handleKeydown(e: KeyboardEvent) { if ((e.metaKey || e.ctrlKey) && e.key === 's') { e.preventDefault() - if (viewMode === 'yaml' && isYamlDirty && !saving) handleSaveYaml() - if ((viewMode === 'form' || viewMode === 'quick') && hasDirtyFields && !fieldSaving) handleSaveFields() + if (viewMode === 'quick' && hasDirtyFields && !fieldSaving) handleSaveFields() } } function handleFieldKeydown(e: KeyboardEvent, field: ConfigFieldMeta) { - const multiline = field.type === 'json' || field.type === 'string_list' + const multiline = field.type === 'string_list' if (e.key === 'Enter' && (!multiline || e.metaKey || e.ctrlKey)) { e.preventDefault() commitEdit(field) @@ -506,7 +372,7 @@ function formatValue(field: ConfigFieldMeta): string { const v = getDisplayValue(field) if (field.sensitive && typeof v === 'string' && v.length > 0) { - return v.includes('*') ? v : '••••••••' + return v.includes('*') ? v : '\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022' } const summary = formatConfigDisplayValue(v) if (field.type === 'json' || summary.kind === 'array' || summary.kind === 'object') return summary.text @@ -517,675 +383,18 @@ return field.path || field.key } - function openJSONEditor(field: ConfigFieldMeta) { - if (field.sensitive) return - editingKey = null - editValue = '' - closeTierEditor() - closeProviderEditor() - closeEmbodimentProviderEditor() - jsonEditorField = field - jsonEditorText = prettyConfigJSON(getDisplayValue(field)) - jsonEditorError = '' - } - - function closeJSONEditor() { - jsonEditorField = null - jsonEditorText = '' - jsonEditorError = '' - } - - function resetJSONEditor() { - if (!jsonEditorField) return - jsonEditorText = prettyConfigJSON(values[jsonEditorField.key]) - jsonEditorError = '' - } - - function applyJSONEditor() { - if (!jsonEditorField) return - const result = parseStructuredJSONEdit(jsonEditorText) - if (!result.ok) { - jsonEditorError = result.error - return - } - const original = values[jsonEditorField.key] - if (configValuesEqual(result.value, original)) { - delete dirtyFields[jsonEditorField.key] - } else { - dirtyFields[jsonEditorField.key] = result.value - } - dirtyFields = { ...dirtyFields } - closeJSONEditor() - } - - function openStructuredEditor(field: ConfigFieldMeta) { - if (field.key === 'llm_tiers') { - openTierEditor(field) - return - } - if (field.key === 'llm_providers') { - openProviderEditor(field) - return - } - if (field.key === 'embodiment_providers_json') { - openEmbodimentProviderEditor(field) - return - } - openJSONEditor(field) - } - - function openTierEditor(field: ConfigFieldMeta) { - if (field.sensitive) return - editingKey = null - editValue = '' - closeJSONEditor() - closeProviderEditor() - closeEmbodimentProviderEditor() - tierProviderOptions = extractLLMProviderAliases(getValueByKey('llm_providers')) - const drafts = makeLLMTierDrafts(getDisplayValue(field)) - tierDrafts = drafts.length > 0 ? drafts : [createTierDraft('standard')] - tierEditorField = field - tierEditorErrors = {} - tierModelOptionsByProvider = {} - tierModelLoadingByProvider = {} - tierModelLoadErrorByProvider = {} - void preloadTierModelOptions(drafts) - } - - function openProviderEditor(field: ConfigFieldMeta) { - if (field.sensitive) return - editingKey = null - editValue = '' - closeJSONEditor() - closeTierEditor() - closeEmbodimentProviderEditor() - const drafts = makeLLMProviderDrafts(getDisplayValue(field)) - providerDrafts = drafts.length > 0 ? drafts : [createProviderDraft('default')] - providerEditorField = field - providerEditorErrors = {} - providerSecretReveal = {} - } - - function closeProviderEditor() { - providerEditorField = null - providerDrafts = [] - providerEditorErrors = {} - providerSecretReveal = {} - } - - function openEmbodimentProviderEditor(field: ConfigFieldMeta) { - if (field.sensitive) return - editingKey = null - editValue = '' - closeJSONEditor() - closeTierEditor() - closeProviderEditor() - embodimentProviderDrafts = makeEmbodimentProviderDrafts(getDisplayValue(field)) - embodimentProviderEditorField = field - embodimentProviderEditorErrors = {} - } - - function closeEmbodimentProviderEditor() { - embodimentProviderEditorField = null - embodimentProviderDrafts = [] - embodimentProviderEditorErrors = {} - } - - function resetEmbodimentProviderEditor() { - if (!embodimentProviderEditorField) return - embodimentProviderDrafts = makeEmbodimentProviderDrafts(values[embodimentProviderEditorField.key]) - embodimentProviderEditorErrors = {} - } - - function addEmbodimentProviderDraft(presetID: EmbodimentProviderPresetID = 'custom') { - embodimentProviderDraftSeq += 1 - const id = `new-embodiment-provider-${embodimentProviderDraftSeq}` - const existingNames = embodimentProviderDrafts.map((draft) => draft.name) - embodimentProviderDrafts = [ - ...embodimentProviderDrafts, - makeEmbodimentProviderPresetDraft(presetID, id, existingNames), - ] - } - - function removeEmbodimentProviderDraft(id: string) { - embodimentProviderDrafts = embodimentProviderDrafts.filter((draft) => draft.id !== id) - const { [id]: _removed, ...remaining } = embodimentProviderEditorErrors - embodimentProviderEditorErrors = remaining - } - - function updateEmbodimentProviderDraft(id: string, field: EmbodimentProviderDraftField, value: string | boolean | string[]) { - embodimentProviderDrafts = embodimentProviderDrafts.map((draft) => ( - draft.id === id ? { ...draft, [field]: value } as EmbodimentProviderDraft : draft - )) - const rowErrors = embodimentProviderEditorErrors[id] - if (!rowErrors?.[field]) return - const nextRowErrors = { ...rowErrors } - delete nextRowErrors[field] - const nextErrors = { ...embodimentProviderEditorErrors } - if (Object.keys(nextRowErrors).length === 0) { - delete nextErrors[id] - } else { - nextErrors[id] = nextRowErrors - } - embodimentProviderEditorErrors = nextErrors - } - - function toggleEmbodimentCapability(id: string, capability: string) { - const draft = embodimentProviderDrafts.find((item) => item.id === id) - if (!draft) return - const current = new Set(draft.capabilities) - if (current.has(capability)) { - current.delete(capability) - } else { - current.add(capability) - } - updateEmbodimentProviderDraft(id, 'capabilities', Array.from(current)) - } - - function applyEmbodimentProviderEditor() { - if (!embodimentProviderEditorField) return - const result = buildEmbodimentProvidersFromDrafts(embodimentProviderDrafts) - if (!result.ok) { - embodimentProviderEditorErrors = result.errors - return - } - const original = values[embodimentProviderEditorField.key] - if (configValuesEqual(result.value, original)) { - delete dirtyFields[embodimentProviderEditorField.key] - } else { - dirtyFields[embodimentProviderEditorField.key] = result.value - } - dirtyFields = { ...dirtyFields } - closeEmbodimentProviderEditor() - } - - function embodimentProviderError(id: string, field: EmbodimentProviderDraftField): string { - return embodimentProviderEditorErrors[id]?.[field] || '' - } - - function resetProviderEditor() { - if (!providerEditorField) return - const drafts = makeLLMProviderDrafts(values[providerEditorField.key]) - providerDrafts = drafts.length > 0 ? drafts : [createProviderDraft('default')] - providerEditorErrors = {} - } - - function addProviderDraft() { - providerDrafts = [...providerDrafts, createProviderDraft(nextProviderAlias())] - } - - function removeProviderDraft(id: string) { - if (providerDrafts.length <= 1) return - providerDrafts = providerDrafts.filter((draft) => draft.id !== id) - const { [id]: _removed, ...remaining } = providerEditorErrors - providerEditorErrors = remaining - const { [id]: _r2, ...remainReveal } = providerSecretReveal - providerSecretReveal = remainReveal - } - - function updateProviderDraft(id: string, field: LLMProviderDraftField, value: string) { - providerDrafts = providerDrafts.map((draft) => { - if (draft.id !== id) return draft - const updated = { ...draft, [field]: value } as LLMProviderDraft - if (field === 'kind') { - const previousKind = draft.kind as ProviderKind | '' - const nextKind = value as ProviderKind | '' - // Boilerplate fields tied to the kind get re-seeded when the - // kind changes. base_url is only swapped when it was empty or - // matched the previous kind's canonical default — preserving - // any custom URL the user typed. auth_mode falls back to a - // valid value for the new kind. api_key stays as-is so the - // user does not need to retype credentials when correcting a - // kind misclick. - if (previousKind !== nextKind) { - const previousDefaultURL = defaultBaseURLForKind(previousKind) - const currentBaseURL = updated.base_url.trim() - if (currentBaseURL === '' || currentBaseURL === previousDefaultURL) { - updated.base_url = defaultBaseURLForKind(nextKind) - } - const validModes = availableAuthModesForKind(nextKind) - if (!validModes.includes(updated.auth_mode as AuthMode)) { - updated.auth_mode = suggestedAuthModeForKind(nextKind) - } - } - } - if (field === 'auth_mode' && value !== 'api-key') { - updated.api_key = '' - } - return updated - }) - const rowErrors = providerEditorErrors[id] - if (!rowErrors?.[field]) return - const nextRowErrors = { ...rowErrors } - delete nextRowErrors[field] - const nextErrors = { ...providerEditorErrors } - if (Object.keys(nextRowErrors).length === 0) { - delete nextErrors[id] - } else { - nextErrors[id] = nextRowErrors - } - providerEditorErrors = nextErrors - } - - function applyProviderEditor() { - if (!providerEditorField) return - const result = buildLLMProvidersFromDrafts(providerDrafts) - if (!result.ok) { - providerEditorErrors = result.errors - return - } - const original = values[providerEditorField.key] - if (configValuesEqual(result.value, original)) { - delete dirtyFields[providerEditorField.key] - } else { - dirtyFields[providerEditorField.key] = result.value - } - - // When the editor renamed a provider alias, rebind any tier that - // referenced the old alias to the new one. The backend's - // alias-replace PATCH would otherwise leave those tiers pointing - // at a deleted provider. We only rewrite tier entries currently - // bound to the renamed alias — tiers using a different provider - // are left as-is. - const renames = providerDrafts - .filter((draft) => draft.originalAlias && draft.originalAlias !== draft.alias.trim() && draft.alias.trim() !== '') - .map((draft) => ({ from: draft.originalAlias, to: draft.alias.trim() })) - if (renames.length > 0) { - const tiersValue = (dirtyFields['llm_tiers'] !== undefined - ? dirtyFields['llm_tiers'] - : values['llm_tiers']) as Record> | undefined - if (tiersValue && typeof tiersValue === 'object') { - const next: Record> = {} - let changed = false - for (const [tierName, binding] of Object.entries(tiersValue)) { - const entry = { ...(binding as Record) } - const rename = renames.find((r) => entry.provider === r.from) - if (rename) { - entry.provider = rename.to - changed = true - } - next[tierName] = entry - } - if (changed) { - if (configValuesEqual(next, values['llm_tiers'])) { - delete dirtyFields['llm_tiers'] - } else { - dirtyFields['llm_tiers'] = next - } - } - } - } - - dirtyFields = { ...dirtyFields } - closeProviderEditor() - } - - function createProviderDraft(alias: string): LLMProviderDraft { - providerDraftSeq += 1 - return { - id: `new-provider-${providerDraftSeq}`, - originalAlias: '', - alias, - kind: '', - auth_mode: '', - base_url: '', - api_key: '', - } - } - - function nextProviderAlias(): string { - const aliases = new Set(providerDrafts.map((draft) => draft.alias.trim()).filter(Boolean)) - let idx = providerDrafts.length + 1 - let candidate = `provider${idx}` - while (aliases.has(candidate)) { - idx += 1 - candidate = `provider${idx}` - } - return candidate - } - - function providerError(id: string, field: LLMProviderDraftField): string { - return providerEditorErrors[id]?.[field] || '' - } - - function providerKindChoices(current: string): string[] { - const choices = new Set(LLM_PROVIDER_KINDS) - const value = current.trim() - if (value) choices.add(value) - return sortStrings(choices) - } - - function providerAuthModeChoices(current: string): string[] { - const choices = new Set(LLM_PROVIDER_AUTH_MODES) - const value = current.trim() - if (value) choices.add(value) - return ['', ...sortStrings(choices)] - } - - function tierServiceTierChoices(current: string): string[] { - const choices = new Set(LLM_TIER_SERVICE_TIERS.filter(Boolean) as string[]) - const value = current.trim() - if (value) choices.add(value) - return ['', ...sortStrings(choices)] - } - - function toggleProviderSecret(id: string) { - providerSecretReveal = { ...providerSecretReveal, [id]: !providerSecretReveal[id] } - } - - function closeTierEditor() { - tierEditorField = null - tierDrafts = [] - tierEditorErrors = {} - tierProviderOptions = [] - tierModelOptionsByProvider = {} - tierModelLoadingByProvider = {} - tierModelLoadErrorByProvider = {} - } - - function resetTierEditor() { - if (!tierEditorField) return - const drafts = makeLLMTierDrafts(values[tierEditorField.key]) - tierDrafts = drafts.length > 0 ? drafts : [createTierDraft('standard')] - tierEditorErrors = {} - tierModelOptionsByProvider = {} - tierModelLoadingByProvider = {} - tierModelLoadErrorByProvider = {} - void preloadTierModelOptions(drafts) - } - - function addTierDraft() { - const draft = createTierDraft(nextTierName()) - tierDrafts = [...tierDrafts, draft] - if (draft?.provider.trim()) { - void ensureTierModelOptionsForProvider(draft.provider) - } - } - - function removeTierDraft(id: string) { - if (tierDrafts.length <= 1) return - tierDrafts = tierDrafts.filter((draft) => draft.id !== id) - const { [id]: _removed, ...remaining } = tierEditorErrors - tierEditorErrors = remaining - } - - function normalizeProviderAlias(alias: string): string { - return alias.trim() - } - - function setTierProviderModelSupport(providerAlias: string, supportsLiveModels: boolean) { - const alias = normalizeProviderAlias(providerAlias) - if (!alias) return - tierModelSupportsByAlias = { ...tierModelSupportsByAlias, [alias]: supportsLiveModels } - } - - function getTierProviderSupportsLiveModels(alias: string): boolean | undefined { - const providerAlias = normalizeProviderAlias(alias) - if (!providerAlias || !Object.prototype.hasOwnProperty.call(tierModelSupportsByAlias, providerAlias)) return undefined - return tierModelSupportsByAlias[providerAlias] - } - - function getProviderKindFromPool(metadata: Pick, alias: string): string | null { - const target = normalizeProviderAlias(alias).toLowerCase() - const entry = metadata.pool.find((item) => normalizeProviderAlias(item.alias).toLowerCase() === target) - return entry?.kind?.trim().toLowerCase() || null - } - - async function preloadProviderModelsMetadata(): Promise { - if (providersMetadataRequest) { - try { - return await providersMetadataRequest - } catch { - providersMetadataRequest = null - return null - } - } - - providersMetadataRequest = getProviders() - try { - return await providersMetadataRequest - } catch { - providersMetadataRequest = null - return null - } - } - - async function providerSupportsLiveModels(alias: string): Promise { - const normalizedAlias = normalizeProviderAlias(alias) - if (!normalizedAlias) return false - const cached = getTierProviderSupportsLiveModels(normalizedAlias) - if (cached !== undefined) return cached - - const metadata = await preloadProviderModelsMetadata() - if (!metadata) { - setTierProviderModelSupport(normalizedAlias, true) - return true - } - - const kind = getProviderKindFromPool(metadata, normalizedAlias) - if (!kind) { - setTierProviderModelSupport(normalizedAlias, true) - return true - } - - const provider = metadata.providers.find((entry) => entry.id.toLowerCase() === kind) - const supports = provider ? provider.supports_live_models : true - setTierProviderModelSupport(normalizedAlias, supports) - return supports - } - - function preloadTierModelOptions(drafts: LLMTierDraft[]) { - const providers = new Set() - for (const draft of drafts) { - const provider = normalizeProviderAlias(draft.provider) - if (provider) providers.add(provider) - } - providers.forEach((provider) => { - void ensureTierModelOptionsForProvider(provider) - }) - } - - async function ensureTierModelOptionsForProvider(providerAlias: string) { - const alias = normalizeProviderAlias(providerAlias) - if (!alias) return - if (tierModelLoadingByProvider[alias] || Object.prototype.hasOwnProperty.call(tierModelOptionsByProvider, alias)) { - return - } - tierModelLoadingByProvider = { ...tierModelLoadingByProvider, [alias]: true } - tierModelLoadErrorByProvider = { ...tierModelLoadErrorByProvider, [alias]: '' } - - try { - const supportsLiveModels = await providerSupportsLiveModels(alias) - if (!supportsLiveModels) { - tierModelOptionsByProvider = { ...tierModelOptionsByProvider, [alias]: [] } - tierModelLoadErrorByProvider = { ...tierModelLoadErrorByProvider, [alias]: 'Live model listing is unavailable for this provider' } - return - } - - const info = await getProviderModels(alias) - const warning = typeof info.warning === 'string' ? info.warning.trim() : '' - const models = Array.isArray(info.models) ? info.models : [] - const deduped = sortStrings(new Set(models.map((model) => String(model).trim()).filter(Boolean))) - tierModelOptionsByProvider = { ...tierModelOptionsByProvider, [alias]: deduped } - tierModelLoadErrorByProvider = { ...tierModelLoadErrorByProvider, [alias]: warning } - } catch (error) { - tierModelLoadErrorByProvider = { ...tierModelLoadErrorByProvider, [alias]: error instanceof Error ? error.message : 'Failed to load models' } - tierModelOptionsByProvider = { ...tierModelOptionsByProvider, [alias]: [] } - } finally { - tierModelLoadingByProvider = { ...tierModelLoadingByProvider, [alias]: false } - } - } - - function tierModelOptionsForProvider(alias: string): string[] { - const provider = normalizeProviderAlias(alias) - return provider && tierModelOptionsByProvider[provider] ? tierModelOptionsByProvider[provider] : [] - } - - function tierModelLoadingForProvider(alias: string): boolean { - const provider = normalizeProviderAlias(alias) - return !!tierModelLoadingByProvider[provider] - } - - function tierModelLoadErrorForProvider(alias: string): string { - const provider = normalizeProviderAlias(alias) - return tierModelLoadErrorByProvider[provider] || '' - } - - function tierModelOptionsForDraft(draft: LLMTierDraft): string[] { - const provider = normalizeProviderAlias(draft.provider) - if (!provider) return [] - const options = tierModelOptionsForProvider(provider) - if (options.length === 0) return [] - const current = normalizeProviderAlias(draft.model) - if (!current) return options - if (options.includes(current)) return options - return [current, ...options] - } - - function updateTierDraft(id: string, field: LLMTierDraftField, value: string) { - tierDrafts = tierDrafts.map((draft) => { - if (draft.id !== id) return draft - const updated = { ...draft, [field]: value } - if (field === 'provider') { - updated.model = '' - if (normalizeProviderAlias(value)) { - void ensureTierModelOptionsForProvider(value) - } - } - return updated - }) - const rowErrors = tierEditorErrors[id] - if (!rowErrors?.[field]) return - const nextRowErrors = { ...rowErrors } - delete nextRowErrors[field] - const nextErrors = { ...tierEditorErrors } - if (Object.keys(nextRowErrors).length === 0) { - delete nextErrors[id] - } else { - nextErrors[id] = nextRowErrors - } - tierEditorErrors = nextErrors - } - - function applyTierEditor() { - if (!tierEditorField) return - const result = buildLLMTiersFromDrafts(tierDrafts, tierProviderOptions) - if (!result.ok) { - tierEditorErrors = result.errors - return - } - const original = values[tierEditorField.key] - if (configValuesEqual(result.value, original)) { - delete dirtyFields[tierEditorField.key] - } else { - dirtyFields[tierEditorField.key] = result.value - } - dirtyFields = { ...dirtyFields } - closeTierEditor() - } - - function createTierDraft(name: string): LLMTierDraft { - tierDraftSeq += 1 - return { - id: `new-tier-${tierDraftSeq}`, - originalName: '', - name, - provider: tierProviderOptions[0] || '', - model: '', - reasoning_effort: '', - thinking_budget: '', - service_tier: '', - } - } - - function nextTierName(): string { - const names = new Set(tierDrafts.map((draft) => draft.name.trim()).filter(Boolean)) - let idx = tierDrafts.length + 1 - let candidate = `tier${idx}` - while (names.has(candidate)) { - idx += 1 - candidate = `tier${idx}` - } - return candidate - } - - function getValueByKey(key: string): unknown { - return dirtyFields[key] !== undefined ? dirtyFields[key] : values[key] - } - - function inputValue(event: Event): string { - const target = event.currentTarget - if (target instanceof HTMLInputElement || target instanceof HTMLSelectElement) return target.value - return '' - } - - function checkedValue(event: Event): boolean { - const target = event.currentTarget - return target instanceof HTMLInputElement ? target.checked : false - } - - function tierError(id: string, field: LLMTierDraftField): string { - return tierEditorErrors[id]?.[field] || '' - } - - function tierProviderChoices(current: string): string[] { - const choices = new Set(tierProviderOptions) - const value = current.trim() - if (value) choices.add(value) - return sortStrings(choices) - } - - function tierReasoningChoices(current: string): string[] { - const defaults = ['', 'minimal', 'low', 'medium', 'high'] - const value = current.trim() - if (value && !defaults.includes(value)) return [...defaults, value] - return defaults - } - - function embodimentTransportChoices(current: string): string[] { - const choices = new Set(EMBODIMENT_PROVIDER_TRANSPORTS) - const value = current.trim() - if (value) choices.add(value) - return ['', ...sortStrings(choices)] - } - - function embodimentPresetCapabilityLabels(preset: EmbodimentProviderPreset): string { - return preset.capabilities.map(embodimentCapabilityLabel).join(', ') - } - - function embodimentEndpointPlaceholder(draft: EmbodimentProviderDraft): string { - return draft.transport.trim().toLowerCase() === 'webhook' - ? 'http://127.0.0.1:43180/v1/embodiment/percept/host' - : 'tars-stackchan' - } - - function embodimentCapabilityDetail(capability: string) { - const value = capability.trim().toLowerCase() - return EMBODIMENT_PROVIDER_CAPABILITY_DETAILS.find((detail) => detail.id === value) || { - id: value, - label: value || 'Custom', - group: 'actuation' as EmbodimentCapabilityGroup, - description: 'Custom provider capability preserved from config.', - } - } - - function embodimentCapabilityLabel(capability: string): string { - return embodimentCapabilityDetail(capability).label + // Deep link for structured fields that keep a UI editor elsewhere. + // Provider/tier editing lives in the onboarding wizard reentry; every + // other structured field is documented file-first (DESIGN.md #931). + function jsonWizardLink(key: string): string | null { + if (key === 'llm_providers') return '/console/onboarding?reentry=1§ion=provider' + if (key === 'llm_tiers') return '/console/onboarding?reentry=1§ion=tiers' + return null } - function embodimentCapabilityDescription(capability: string): string { - return embodimentCapabilityDetail(capability).description - } - - function embodimentCapabilitiesForGroup(group: EmbodimentCapabilityGroup): string[] { - return EMBODIMENT_PROVIDER_CAPABILITY_DETAILS - .filter((detail) => detail.group === group) - .map((detail) => detail.id) - } - - function customEmbodimentCapabilities(current: string[]): string[] { - const known = new Set(EMBODIMENT_PROVIDER_CAPABILITY_DETAILS.map((detail) => detail.id)) - return sortStrings(current.map((value) => value.trim().toLowerCase()).filter((value) => value && !known.has(value))) + function openJSONWizard(key: string) { + const link = jsonWizardLink(key) + if (link) onNavigate?.(link) } const sectionIcons: Record = { @@ -1218,7 +427,7 @@ {/if}
- +
@@ -1350,27 +559,33 @@ > {formatValue(field)} + {:else if field.type === 'json'} + {@const summary = structuredSummary(field)} +
+ {summary.text} + {#if summary.preview.length > 0} + + {#each summary.preview as preview} + {preview} + {/each} + + {/if} + {#if jsonWizardLink(item.key)} + + {:else} + YAML: {fieldPath(field)} + {/if} +
{:else} {/if} {#if item.key === 'llm_providers'} @@ -1386,7 +601,15 @@ {/each} - {:else if viewMode === 'form'} + {:else if viewMode === 'inspect'} +
+ + Read-only inspection. Configuration is file-first: edit + workspace/config/tars.config.yaml (see config/tars.config.example.yaml) + and restart to apply. + + +
+
{field.label} {field.description} - {fieldPath(field)} + {fieldPath(field)} {#if metaBadges.length > 0}
{#each metaBadges as badge} @@ -1437,76 +660,29 @@ {/if}
- {#if field.type === 'bool'} - - - {:else if field.type === 'select' && field.options} - - - {:else if editingKey === field.key} - -
- {#if field.type === 'string_list'} - - {:else} - handleFieldKeydown(e, field)} - onblur={() => commitEdit(field)} - /> + {#if field.type === 'json'} + {@const summary = structuredSummary(field)} +
+ {summary.text} + {#if summary.preview.length > 0} + + {#each summary.preview as previewItem} + {previewItem} + {/each} + + {/if} + {#if jsonWizardLink(field.key)} + {/if}
- {:else if field.sensitive} - - {formatValue(field)} + {:else if field.type === 'bool'} + + {getDisplayValue(field) ? 'ON' : 'OFF'} + {:else} - - + {formatValue(field)} {/if}
@@ -1520,562 +696,17 @@
Configuration (YAML) -
- - -
-
- -
- {#if isYamlDirty} - Unsaved changes - {:else} - No changes - {/if} - Ctrl+S / Cmd+S to save + Read-only — edit the file on disk, then restart to apply.
+ 
{yamlContent}
{/if} - {#if embodimentProviderEditorField} - - {/if} - - {#if providerEditorField} - - {/if} - - {#if tierEditorField} - - {/if} - - {#if jsonEditorField} - - {/if} - - -
-
- Server + +
+
+ Server
@@ -2505,35 +1136,19 @@ font-weight: 500; } - .structured-value-btn { + .structured-readonly { display: grid; gap: var(--space-1); justify-items: end; - max-width: 300px; + max-width: 320px; min-width: 150px; - border: 1px solid transparent; - border-radius: var(--radius-sm); - background: transparent; - padding: var(--space-1) var(--space-2); - color: inherit; - cursor: pointer; text-align: right; - transition: all var(--duration-fast) var(--ease-out); - } - .structured-value-btn:hover { - border-color: var(--border-default); - background: var(--surface-elevated); - } - .structured-value-btn.dirty { - border-color: rgba(224, 145, 69, 0.4); - background: rgba(224, 145, 69, 0.08); } .structured-main { font-family: var(--font-mono); font-size: var(--text-xs); color: var(--text-primary); } - .structured-value-btn.dirty .structured-main { color: var(--primary); } .structured-preview { display: flex; flex-wrap: wrap; @@ -2556,6 +1171,50 @@ white-space: nowrap; } + + .yaml-key-hint { + font-family: var(--font-mono); + font-size: 10px; + color: var(--text-ghost); + } + + /* Read-only inspection (Fields tab is inspection-only per DESIGN.md #931) */ + .inspect-note { + display: flex; + align-items: center; + justify-content: space-between; + gap: var(--space-3); + padding: var(--space-2) var(--space-3); + border: 1px solid var(--border-subtle); + border-radius: var(--radius-md); + background: var(--surface-elevated); + color: var(--text-secondary); + font-size: var(--text-xs); + line-height: 1.5; + } + .inspect-note code { + font-family: var(--font-mono); + color: var(--text-primary); + font-size: 10px; + } + .readonly-bool { + display: inline-block; + padding: 3px var(--space-2); + border-radius: var(--radius-sm); + border: 1px solid var(--border-subtle); + font-family: var(--font-display); + font-size: var(--text-xs); + font-weight: 600; + letter-spacing: 0.04em; + background: rgba(255, 255, 255, 0.04); + color: var(--text-ghost); + } + .readonly-bool.readonly-on { + border-color: rgba(60, 180, 100, 0.28); + background: rgba(60, 180, 100, 0.08); + color: var(--green); + } + /* ── Bool toggle ─────────────────────────── */ .bool-toggle { display: inline-block; @@ -2641,36 +1300,33 @@ box-shadow: 0 0 0 2px rgba(224, 145, 69, 0.3); } - /* ── YAML Editor ─────────────────────────── */ + /* ── YAML read view ───────────────────── */ .editor-card { display: flex; flex-direction: column; } - .card-actions { display: flex; gap: var(--space-2); } - .config-editor { + .yaml-readonly-hint { + font-family: var(--font-mono); + font-size: var(--text-xs); + color: var(--text-ghost); + } + + .config-yaml-view { width: 100%; + margin: 0; min-height: 500px; + max-height: 70vh; padding: var(--space-3); background: var(--surface-base); color: var(--text-primary); - border: none; border-top: 1px solid var(--border-subtle); border-bottom: 1px solid var(--border-subtle); font-family: var(--font-mono); font-size: var(--text-sm); line-height: 1.6; - resize: vertical; tab-size: 2; white-space: pre; overflow-x: auto; + overflow-y: auto; } - .config-editor:focus { outline: none; box-shadow: inset 0 0 0 1px var(--primary); } - - .editor-footer { - display: flex; - align-items: center; - justify-content: space-between; - padding: var(--space-2) var(--space-3); - } - .hint { font-family: var(--font-mono); font-size: var(--text-xs); color: var(--text-ghost); } /* ── Restart section ──────────────────────── */ .restart-section { margin-top: var(--space-4); } @@ -2697,469 +1353,6 @@ /* ── Diff panel ──────────────────────────── */ .diff-badge { cursor: pointer; } - /* ── JSON editor modal ───────────────────── */ - .modal-backdrop { - position: fixed; - top: 0; - right: 0; - bottom: 0; - left: var(--nav-width); - z-index: 30; - display: flex; - align-items: center; - justify-content: center; - padding: var(--space-4); - background: rgba(0, 0, 0, 0.62); - } - .json-editor-modal { - width: min(880px, calc(100vw - var(--nav-width) - 32px)); - max-height: calc(100vh - 32px); - display: flex; - flex-direction: column; - gap: var(--space-3); - border: 1px solid var(--border-default); - border-radius: var(--radius-lg); - background: var(--surface); - box-shadow: var(--shadow-lg); - padding: var(--space-4); - overflow: hidden; - } - .json-editor-header, .json-editor-footer { - display: flex; - align-items: flex-start; - justify-content: space-between; - gap: var(--space-3); - } - .json-editor-title { - font-family: var(--font-display); - font-size: var(--text-md); - color: var(--text-primary); - } - .json-editor-path { - margin-top: 2px; - font-family: var(--font-mono); - font-size: var(--text-xs); - color: var(--text-ghost); - } - .json-editor-textarea { - width: 100%; - min-height: clamp(280px, 54vh, 520px); - border: 1px solid var(--border-subtle); - border-radius: var(--radius-md); - background: var(--surface-base); - color: var(--text-primary); - padding: var(--space-3); - font-family: var(--font-mono); - font-size: var(--text-sm); - line-height: 1.55; - resize: vertical; - tab-size: 2; - white-space: pre; - overflow: auto; - } - .json-editor-textarea:focus { - outline: none; - border-color: var(--primary); - box-shadow: 0 0 0 2px rgba(224, 145, 69, 0.22); - } - .json-editor-actions { - display: flex; - gap: var(--space-2); - } - - .tier-editor-modal { - width: min(1040px, calc(100vw - var(--nav-width) - 32px)); - } - .tier-editor-toolbar { - display: flex; - justify-content: flex-end; - } - .tier-editor-list { - display: flex; - flex-direction: column; - gap: var(--space-2); - min-height: 0; - overflow: auto; - padding-right: 2px; - } - .tier-row { - display: grid; - grid-template-columns: minmax(90px, 1fr) minmax(120px, 1fr) minmax(180px, 1.4fr) minmax(110px, 0.9fr) minmax(96px, 0.8fr) minmax(130px, 1fr) auto; - gap: var(--space-2); - align-items: start; - padding: var(--space-3); - border: 1px solid var(--border-subtle); - border-radius: var(--radius-md); - background: var(--surface-base); - } - .tier-field { - display: flex; - flex-direction: column; - gap: 4px; - min-width: 0; - } - .tier-field span { - font-family: var(--font-display); - font-size: 10px; - font-weight: 600; - color: var(--text-ghost); - text-transform: uppercase; - letter-spacing: 0.04em; - } - .tier-field input, - .tier-field select { - width: 100%; - min-width: 0; - height: 32px; - border: 1px solid var(--border-subtle); - border-radius: var(--radius-sm); - background: var(--surface); - color: var(--text-primary); - padding: 0 var(--space-2); - font-family: var(--font-mono); - font-size: var(--text-xs); - } - .tier-field input:focus, - .tier-field select:focus { - outline: none; - border-color: var(--primary); - box-shadow: 0 0 0 2px rgba(224, 145, 69, 0.22); - } - .tier-field input.error, - .tier-field select.error { - border-color: var(--red); - box-shadow: 0 0 0 1px rgba(220, 60, 60, 0.25); - } - .tier-field small { - color: var(--red); - font-size: 10px; - line-height: 1.25; - } - .tier-field small.tier-model-warn { - color: var(--amber, #e09145); - } - .tier-remove { - align-self: end; - white-space: nowrap; - } - - /* ── Provider editor ─────────────────────── */ - .provider-editor-modal { - width: min(880px, calc(100vw - var(--nav-width) - 32px)); - } - .provider-card { - display: flex; - flex-direction: column; - gap: var(--space-3); - padding: var(--space-3); - border: 1px solid var(--border-subtle); - border-radius: var(--radius-md); - background: var(--surface-base); - } - .provider-card-header { - display: grid; - grid-template-columns: minmax(0, 1fr) auto; - gap: var(--space-3); - align-items: end; - } - .provider-grid { - display: grid; - grid-template-columns: repeat(2, minmax(0, 1fr)); - gap: var(--space-3); - } - .provider-field-wide { - grid-column: span 2; - } - .provider-secret { - display: grid; - grid-template-columns: minmax(0, 1fr) auto; - gap: var(--space-2); - align-items: stretch; - } - .provider-secret input { - width: 100%; - } - .provider-secret-toggle { - align-self: stretch; - white-space: nowrap; - } - - /* ── Embodiment provider editor ─────────── */ - .embodiment-provider-editor-modal { - width: min(1040px, calc(100vw - var(--nav-width) - 32px)); - } - .embodiment-preset-toolbar { - display: flex; - flex-wrap: wrap; - justify-content: flex-end; - gap: var(--space-2); - } - .embodiment-provider-card { - gap: var(--space-3); - } - .embodiment-card-actions { - display: flex; - align-items: flex-end; - gap: var(--space-2); - justify-content: flex-end; - } - .embodiment-provider-grid { - grid-template-columns: repeat(4, minmax(0, 1fr)); - } - .embodiment-toggle-stack { - display: flex; - flex-direction: column; - justify-content: flex-end; - gap: var(--space-2); - min-height: 58px; - } - .embodiment-switch, - .embodiment-check { - display: inline-flex; - align-items: center; - gap: var(--space-2); - color: var(--text-secondary); - font-family: var(--font-display); - font-size: var(--text-xs); - line-height: 1.3; - cursor: pointer; - } - .embodiment-switch { - height: 32px; - padding: 0 var(--space-2); - border: 1px solid var(--border-subtle); - border-radius: var(--radius-sm); - background: var(--surface); - white-space: nowrap; - } - .embodiment-switch input, - .embodiment-check input { - accent-color: var(--primary); - } - .tier-field .field-label-with-help { - display: inline-flex; - align-items: center; - gap: 5px; - color: var(--text-ghost); - letter-spacing: 0; - } - .tier-field .help-dot { - display: inline-flex; - align-items: center; - justify-content: center; - width: 15px; - height: 15px; - border: 1px solid var(--border-subtle); - border-radius: 50%; - color: var(--text-secondary); - background: var(--surface); - font-size: 10px; - line-height: 1; - text-transform: none; - letter-spacing: 0; - cursor: help; - } - .embodiment-capability-board { - display: grid; - grid-template-columns: repeat(2, minmax(0, 1fr)); - gap: var(--space-2); - padding: var(--space-2); - border: 1px solid var(--border-subtle); - border-radius: var(--radius-sm); - background: var(--surface); - } - .embodiment-capability-board.error { - border-color: var(--red); - box-shadow: 0 0 0 1px rgba(220, 60, 60, 0.25); - } - .capability-group { - display: flex; - flex-direction: column; - gap: var(--space-2); - min-width: 0; - padding: var(--space-2); - border: 1px solid var(--border-subtle); - border-radius: var(--radius-sm); - background: var(--surface-base); - } - .capability-group-title { - display: inline-flex; - align-items: center; - gap: 5px; - color: var(--text-secondary); - font-family: var(--font-display); - font-size: 10px; - font-weight: 700; - text-transform: uppercase; - letter-spacing: 0; - } - .capability-chip-grid { - display: grid; - grid-template-columns: repeat(2, minmax(0, 1fr)); - gap: var(--space-2); - } - .capability-chip { - display: flex; - flex-direction: column; - align-items: flex-start; - justify-content: center; - min-width: 0; - min-height: 44px; - gap: 1px; - padding: var(--space-2); - border: 1px solid var(--border-subtle); - border-radius: var(--radius-sm); - color: var(--text-secondary); - background: var(--surface); - cursor: pointer; - text-align: left; - } - .capability-chip:hover { - border-color: rgba(224, 145, 69, 0.45); - color: var(--text-primary); - } - .capability-chip.selected { - border-color: rgba(224, 145, 69, 0.72); - color: var(--text-primary); - background: rgba(224, 145, 69, 0.14); - box-shadow: inset 3px 0 0 var(--primary); - } - .tier-field .capability-chip-label { - color: inherit; - font-family: var(--font-display); - font-size: var(--text-xs); - font-weight: 700; - text-transform: none; - letter-spacing: 0; - line-height: 1.15; - } - .tier-field .capability-chip small { - color: var(--text-ghost); - font-family: var(--font-mono); - font-size: 10px; - line-height: 1.1; - text-transform: none; - letter-spacing: 0; - } - .embodiment-empty-state { - display: flex; - align-items: center; - justify-content: space-between; - gap: var(--space-3); - padding: var(--space-4); - border: 1px dashed var(--border-default); - border-radius: var(--radius-md); - color: var(--text-secondary); - background: var(--surface-base); - } - .embodiment-preset-grid { - display: grid; - grid-template-columns: repeat(2, minmax(0, 1fr)); - gap: var(--space-2); - min-width: min(520px, 100%); - } - .embodiment-preset-card { - display: flex; - flex-direction: column; - gap: 3px; - min-width: 0; - padding: var(--space-3); - border: 1px solid var(--border-subtle); - border-radius: var(--radius-sm); - color: var(--text-secondary); - background: var(--surface); - cursor: pointer; - text-align: left; - } - .embodiment-preset-card:hover { - border-color: rgba(224, 145, 69, 0.45); - color: var(--text-primary); - } - .embodiment-preset-card strong { - color: var(--text-primary); - font-family: var(--font-display); - font-size: var(--text-sm); - } - .embodiment-preset-card span, - .embodiment-preset-card small { - overflow-wrap: anywhere; - } - .embodiment-preset-card span { - font-family: var(--font-mono); - font-size: 11px; - } - .embodiment-preset-card small { - color: var(--text-ghost); - font-size: 11px; - line-height: 1.25; - } - - @media (max-width: 640px) { - .provider-grid { - grid-template-columns: minmax(0, 1fr); - } - .provider-field-wide { - grid-column: auto; - } - } - - @media (max-width: 960px) { - .embodiment-provider-grid { - grid-template-columns: repeat(2, minmax(0, 1fr)); - } - .tier-row { - grid-template-columns: repeat(2, minmax(0, 1fr)); - } - .tier-field-model, - .tier-field-service { - grid-column: span 2; - } - .tier-remove { - justify-self: end; - } - } - - @media (max-width: 640px) { - .modal-backdrop { - left: 0; - padding: var(--space-2); - } - .json-editor-modal, - .tier-editor-modal, - .embodiment-provider-editor-modal { - width: calc(100vw - 16px); - max-height: calc(100vh - 16px); - } - .embodiment-provider-grid, - .embodiment-capability-board { - grid-template-columns: minmax(0, 1fr); - } - .embodiment-preset-grid, - .capability-chip-grid { - grid-template-columns: minmax(0, 1fr); - } - .embodiment-card-actions, - .embodiment-empty-state { - align-items: stretch; - flex-direction: column; - } - .tier-row { - grid-template-columns: minmax(0, 1fr); - } - .tier-field-model, - .tier-field-service { - grid-column: auto; - } - .json-editor-header, - .json-editor-footer { - align-items: stretch; - flex-direction: column; - } - .json-editor-actions { - justify-content: flex-end; - } - } - /* ── Search bar ──────────────────────────── */ .search-bar { position: relative; diff --git a/frontend/console/src/i18n/en.ts b/frontend/console/src/i18n/en.ts index 0a360af4..2d562679 100644 --- a/frontend/console/src/i18n/en.ts +++ b/frontend/console/src/i18n/en.ts @@ -597,7 +597,7 @@ export const en = { config: { pageTitle: 'Settings', viewToggleQuick: 'Quick Start', - viewToggleFields: 'Fields', + viewToggleFields: 'Inspect', viewToggleYaml: 'YAML', save: 'Save', saving: 'Saving...', diff --git a/frontend/console/src/i18n/ko.ts b/frontend/console/src/i18n/ko.ts index 3a6ee681..376b2ada 100644 --- a/frontend/console/src/i18n/ko.ts +++ b/frontend/console/src/i18n/ko.ts @@ -597,7 +597,7 @@ export const ko = { config: { pageTitle: '설정', viewToggleQuick: '빠른 시작', - viewToggleFields: '필드', + viewToggleFields: '검사', viewToggleYaml: 'YAML', save: '저장', saving: '저장 중...', diff --git a/frontend/console/tests/configModalLayout.test.ts b/frontend/console/tests/configModalLayout.test.ts index 708ac5c7..cb9bfa35 100644 --- a/frontend/console/tests/configModalLayout.test.ts +++ b/frontend/console/tests/configModalLayout.test.ts @@ -4,18 +4,21 @@ import { readFileSync } from 'node:fs' const source = readFileSync(new URL('../src/components/Config.svelte', import.meta.url), 'utf8') -function cssRule(selector: string): string { - const escaped = selector.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') - const match = source.match(new RegExp(`${escaped}\\s*\\{([\\s\\S]*?)\\n\\s*\\}`)) - assert.ok(match, `expected ${selector} rule`) - return match[1] -} - -test('JSON editor modal is centered in the content area beside the fixed sidebar', () => { - const backdrop = cssRule('.modal-backdrop') - const modal = cssRule('.json-editor-modal') +test('Config page stays inspection-first and hosts no heavyweight modal editors (#931)', () => { + // The long-tail config editors (generic JSON, LLM tier/provider, embodiment + // presets) were removed; provider/tier editing lives in the onboarding + // wizard reentry and everything else is documented file-first. + assert.doesNotMatch(source, /json-editor-modal/) + assert.doesNotMatch(source, /tier-editor|provider-editor|embodiment/i) + assert.doesNotMatch(source, /modal-backdrop/) +}) - assert.match(backdrop, /left:\s*var\(--nav-width\);/) - assert.match(backdrop, /right:\s*0;/) - assert.match(modal, /calc\(100vw - var\(--nav-width\) - 32px\)/) +test('Config inspection surfaces read-only values with YAML-key pointers and wizard deep links', () => { + assert.match(source, /config-yaml-view/) + assert.match(source, /Read-only/) + assert.match(source, /jsonWizardLink/) + assert.match(source, /onboarding\?reentry=1§ion=provider/) + assert.match(source, /onboarding\?reentry=1§ion=tiers/) + assert.match(source, /yaml-key-hint/) + assert.match(source, /config\/tars\.config\.example\.yaml/) }) diff --git a/frontend/console/tests/quickStartFields.test.ts b/frontend/console/tests/quickStartFields.test.ts index 54f936b9..9ad0a005 100644 --- a/frontend/console/tests/quickStartFields.test.ts +++ b/frontend/console/tests/quickStartFields.test.ts @@ -10,7 +10,6 @@ import { import type { ConfigFieldMeta } from '../src/lib/types.ts' const configSource = readFileSync(new URL('../src/components/Config.svelte', import.meta.url), 'utf8') -const configStructuredSource = readFileSync(new URL('../src/lib/configStructured.ts', import.meta.url), 'utf8') const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') function field(key: string, label = key, type = 'string'): ConfigFieldMeta { @@ -103,8 +102,13 @@ test('Settings renders Quick Start tab and LLM connection action', () => { assert.match(configSource, /Quick Start/) assert.match(configSource, /quick-start-grid/) assert.match(configSource, /Test connection/) - assert.match(configSource, /openEmbodimentProviderEditor/) - assert.match(configSource, /EMBODIMENT_PROVIDER_PRESETS/) - assert.match(configStructuredSource, /Add StackChan/) - assert.match(configSource, /capability-chip/) +}) + +test('Quick Start routes structured provider editing to the wizard, not local editors (#931)', () => { + // Provider/tier structured editors moved to the onboarding wizard reentry; + // Config.svelte only deep links there. Other json fields get a YAML-key hint. + assert.match(configSource, /jsonWizardLink/) + assert.match(configSource, /onboarding\?reentry=1§ion=provider/) + assert.match(configSource, /onboarding\?reentry=1§ion=tiers/) + assert.doesNotMatch(configSource, /openEmbodimentProviderEditor|EMBODIMENT_PROVIDER_PRESETS/) }) From cacbc6d1d1660d7604100a7e40355d0871edb092 Mon Sep 17 00:00:00 2001 From: devlikebear Date: Mon, 24 Aug 2026 10:27:19 +0900 Subject: [PATCH 4/5] refactor(console): split lib/api.ts into domain modules behind a barrel MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Part of #919. Refs #931. Step 4: api.ts (1825 lines) becomes src/lib/api/{client,normalize,system,config,chat,sessions,tasks,git, memory,ops,extensions,channels,agentruntime,workspace}.ts with an index.ts barrel re-exporting the full surface — all existing '../lib/api' imports keep working. Runtime relative imports carry explicit .ts extensions so node --experimental-strip-types can load modules directly; tsconfig gains allowImportingTsExtensions. Tests that asserted on api.ts source now read the owning module. No endpoint, function, or type removed. --- frontend/console/src/lib/api.ts | 1825 ----------------- frontend/console/src/lib/api/agentruntime.ts | 134 ++ frontend/console/src/lib/api/channels.ts | 24 + frontend/console/src/lib/api/chat.ts | 314 +++ frontend/console/src/lib/api/client.ts | 48 + frontend/console/src/lib/api/config.ts | 81 + frontend/console/src/lib/api/extensions.ts | 250 +++ frontend/console/src/lib/api/git.ts | 94 + frontend/console/src/lib/api/index.ts | 19 + frontend/console/src/lib/api/memory.ts | 96 + frontend/console/src/lib/api/normalize.ts | 56 + frontend/console/src/lib/api/ops.ts | 126 ++ frontend/console/src/lib/api/sessions.ts | 335 +++ frontend/console/src/lib/api/system.ts | 98 + frontend/console/src/lib/api/tasks.ts | 119 ++ frontend/console/src/lib/api/workspace.ts | 93 + .../console/tests/agentRuntimeRunView.test.ts | 2 +- frontend/console/tests/analyticsPage.test.ts | 2 +- frontend/console/tests/contractPanel.test.ts | 5 +- .../tests/extensionsPluginPolicy.test.ts | 2 +- .../tests/extensionsSkillSandbox.test.ts | 9 +- frontend/console/tests/gitInspector.test.ts | 2 +- .../tests/gitInspectorMutations.test.ts | 2 +- .../tests/headerBudgetIndicator.test.ts | 2 +- frontend/console/tests/logsPage.test.ts | 2 +- .../console/tests/mcpServerCreator.test.ts | 2 +- .../console/tests/memoryAssetMetadata.test.ts | 2 +- .../console/tests/opsApprovalsFocus.test.ts | 2 +- frontend/console/tests/plansPage.test.ts | 2 +- .../console/tests/priorContextPanel.test.ts | 2 +- .../console/tests/quickStartFields.test.ts | 2 +- .../console/tests/sessionAICleanup.test.ts | 2 +- .../tests/sessionAutomationConsent.test.ts | 2 +- frontend/console/tests/sessionHealth.test.ts | 3 +- .../console/tests/sessionLineageGraph.test.ts | 2 +- .../tests/sessionPermissionPreview.test.ts | 3 +- .../console/tests/sessionStyleControl.test.ts | 2 +- .../tests/sessionTranscriptSearch.test.ts | 2 +- frontend/console/tests/skillCreator.test.ts | 2 +- .../tests/skillExtractionInbox.test.ts | 2 +- .../tests/syspromptImpactPreview.test.ts | 2 +- frontend/console/tests/taskEvidence.test.ts | 2 +- frontend/console/tests/tasksArchive.test.ts | 2 +- .../console/tests/workLedgerTimeline.test.ts | 4 +- .../console/tests/workerControlPlane.test.ts | 2 +- frontend/console/tsconfig.app.json | 1 + 46 files changed, 1926 insertions(+), 1859 deletions(-) delete mode 100644 frontend/console/src/lib/api.ts create mode 100644 frontend/console/src/lib/api/agentruntime.ts create mode 100644 frontend/console/src/lib/api/channels.ts create mode 100644 frontend/console/src/lib/api/chat.ts create mode 100644 frontend/console/src/lib/api/client.ts create mode 100644 frontend/console/src/lib/api/config.ts create mode 100644 frontend/console/src/lib/api/extensions.ts create mode 100644 frontend/console/src/lib/api/git.ts create mode 100644 frontend/console/src/lib/api/index.ts create mode 100644 frontend/console/src/lib/api/memory.ts create mode 100644 frontend/console/src/lib/api/normalize.ts create mode 100644 frontend/console/src/lib/api/ops.ts create mode 100644 frontend/console/src/lib/api/sessions.ts create mode 100644 frontend/console/src/lib/api/system.ts create mode 100644 frontend/console/src/lib/api/tasks.ts create mode 100644 frontend/console/src/lib/api/workspace.ts diff --git a/frontend/console/src/lib/api.ts b/frontend/console/src/lib/api.ts deleted file mode 100644 index 529cdb3b..00000000 --- a/frontend/console/src/lib/api.ts +++ /dev/null @@ -1,1825 +0,0 @@ -import type { - APIErrorPayload, - Approval, - AutomationAuditListResponse, - ChatEvent, - ChatRequest, - ChatTierRecommendationRequest, - CleanupApplyResult, - CleanupPlan, - ConfigFile, - ConfigSchema, - CommandDef, - HealthzResponse, - ProvidersAPIInfo, - ProviderModelsInfo, - SetupStatusResponse, - HubDryRunResult, - HubInstallResponse, - HubInstalled, - HubSkillSearchResult, - HubSource, - AgentRuntimeRun, - AgentRuntimeRunEvent, - AgentRuntimeProviderOverride, - AgentRuntimeRecoveryMode, - AgentRuntimeSubagent, - AgentRuntimeSubagentArchiveResponse, - AgentRuntimeSubagentDraft, - AgentRuntimeSubagentDraftResponse, - AgentRuntimeSubagentRecommendationsResponse, - AgentRuntimeSubagentsResponse, - HubRegistry, - ExtensionHealthResponse, - ExtensionRepairResponse, - MCPServerStatus, - MemoryAsset, - MemoryCandidateAction, - MemoryCandidateListResponse, - MemoryCandidateReviewResponse, - MemoryCandidateStatus, - MemoryFile, - MemoryPrefetchResult, - MemorySearchResult, - SyspromptFile, - SyspromptPreview, - SkillDef, - CreateCronJobRequest, - CronJob, - CronRunRecord, - CronRunResult, - EventsHistoryInfo, - ForkPromotionListResponse, - ForkPromotionResult, - NotificationMessage, - OpsStatus, - PulseSnapshot, - PulseTickOutcome, - PulseConfigView, - ReflectionSnapshot, - ReflectionRunSummary, - ReflectionConfigView, - Session, - SessionAutomationConsent, - SessionStyleControl, - SessionStyleResponse, - SessionMessage, - GlobalPlansResponse, - PlanArchiveResponse, - SkillCreatorDraftRequest, - SkillCreatorDraftResponse, - SkillCreatorSaveResponse, - SkillCreatorTestResponse, - SkillCreatorSubmitResponse, - SkillExtractionCandidateAction, - SkillExtractionCandidateStatus, - SkillExtractionListResponse, - SkillExtractionReviewResponse, - SessionLocalSkillListResponse, - SessionLocalSkillPromoteRequest, - SessionLocalSkillPromoteResponse, - MCPServerCreatorDraftRequest, - MCPServerCreatorDraftResponse, - MCPServerCreatorSaveResponse, - MCPServerCreatorTestResponse, - MCPServerCreatorSubmitResponse, - UpdateCronJobRequest, - SessionTasks, - TaskContract, - TaskEvidence, - TaskVerificationResponse, - GitBranchesResponse, - GitCommitDetail, - GitDiff, - GitLogResponse, - GitMutationPlan, - GitStatus, - GitWorktreesResponse, - SessionWorkDirs, - SessionCwd, - SessionEffectiveConfig, - SessionGoal, - SessionCritic, - UsageToday, - CodexUsageResponse, - LogsResponse, - AnalyticsResponse, - AuthLoginRequest, - AuthPairingLoginRequest, - AuthWhoamiResponse, - TelegramPairingsResponse, - TelegramAllowedUser, - RemoteAccessResponse, - SessionCleanupMode, - SessionCleanupSuggestionResponse, - WorkLedgerEvent, - WorkLedgerProjection, - WorkLedgerWork, - WorkLedgerWorksResponse, - WorkerControlPlaneResponse, -} from './types' - -export class APIRequestError extends Error { - status: number - payload?: APIErrorPayload - - constructor(message: string, status: number, payload?: APIErrorPayload) { - super(message) - this.name = 'APIRequestError' - this.status = status - this.payload = payload - } - - get sandboxReport() { - return this.payload?.sandbox_report - } -} - -async function requestJSON(input: string, init?: RequestInit): Promise { - const response = await fetch(input, { - credentials: 'same-origin', - headers: { - Accept: 'application/json', - ...(init?.headers ?? {}), - }, - ...init, - }) - - if (!response.ok) { - let message = `${response.status} ${response.statusText}`.trim() - let payload: APIErrorPayload | undefined - try { - payload = (await response.json()) as APIErrorPayload - if (payload?.error?.trim()) { - message = payload.error.trim() - } - } catch { - // ignore non-JSON error bodies - } - throw new APIRequestError(message, response.status, payload) - } - - if (response.status === 204) { - return undefined as T - } - - return (await response.json()) as T -} - -function normalizeSessionTasks(data: Partial | null | undefined): SessionTasks { - return { - ...(data?.plan ? { plan: data.plan } : {}), - ...(data?.contract ? { contract: normalizeTaskContract(data.contract) } : {}), - tasks: Array.isArray(data?.tasks) - ? data.tasks.map((task) => ({ - ...task, - evidence: Array.isArray(task.evidence) ? task.evidence.map(normalizeTaskEvidence) : [], - })) - : [], - } -} - -function normalizeTaskEvidence(data: Partial | null | undefined): TaskEvidence { - return { - ...(data ?? {}), - id: data?.id ?? '', - type: data?.type ?? 'command_output_summary', - } -} - -function normalizeTaskContract(data: Partial | null | undefined): TaskContract { - return { - ...data, - done_criteria: Array.isArray(data?.done_criteria) ? data.done_criteria : [], - verification_commands: Array.isArray(data?.verification_commands) ? data.verification_commands : [], - artifacts: Array.isArray(data?.artifacts) ? data.artifacts : [], - } -} - -function normalizePlanArchive(data: Partial | null | undefined): PlanArchiveResponse { - return { - items: Array.isArray(data?.items) ? data.items : [], - count: typeof data?.count === 'number' ? data.count : Array.isArray(data?.items) ? data.items.length : 0, - } -} - -function normalizeGlobalPlans(data: Partial | null | undefined): GlobalPlansResponse { - return { - items: Array.isArray(data?.items) - ? data.items.map((item) => ({ - ...item, - ...(item.contract ? { contract: normalizeTaskContract(item.contract) } : {}), - })) - : [], - count: typeof data?.count === 'number' ? data.count : Array.isArray(data?.items) ? data.items.length : 0, - } -} - -// --- Server status --- - -// --- Onboarding signals --- - -export async function getHealthz(): Promise { - return requestJSON('/v1/healthz') -} - -export async function getSetupStatus(): Promise { - return requestJSON('/v1/setup/status') -} - -export async function getServerStatus(): Promise<{ version: string }> { - return requestJSON<{ version: string }>('/v1/status') -} - -export async function getAuthWhoami(): Promise { - return requestJSON('/v1/auth/whoami') -} - -export async function loginAuth(payload: AuthLoginRequest): Promise { - return requestJSON('/v1/auth/login', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(payload), - }) -} - -export async function loginWithPairingCode(payload: AuthPairingLoginRequest): Promise { - return requestJSON('/v1/auth/pairing-login', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(payload), - }) -} - -export async function logoutAuth(): Promise { - await requestJSON<{ ok: boolean }>('/v1/auth/logout', { method: 'POST' }) -} - -export async function changeBrowserPassword(role: 'admin' | 'user', payload: { current_password?: string; new_password: string }): Promise { - await requestJSON<{ ok: boolean }>(`/v1/auth/users/${encodeURIComponent(role)}/password`, { - method: 'PATCH', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(payload), - }) -} - -export async function getTodayUsage(): Promise { - return requestJSON('/v1/admin/usage/today') -} - -export async function getCodexUsage(): Promise { - return requestJSON('/v1/admin/llm/codex/usage') -} - -export type LogsQuery = { - file?: string - level?: string - component?: string - lines?: number -} - -export async function getLogs(query: LogsQuery = {}): Promise { - const params = new URLSearchParams() - if (query.file?.trim()) params.set('file', query.file.trim()) - if (query.level?.trim()) params.set('level', query.level.trim()) - if (query.component?.trim()) params.set('component', query.component.trim()) - if (query.lines && Number.isFinite(query.lines)) params.set('lines', String(query.lines)) - const suffix = params.toString() - return requestJSON(`/v1/admin/logs${suffix ? `?${suffix}` : ''}`) -} - -export async function getAnalytics(days = 7): Promise { - return requestJSON(`/v1/admin/analytics?days=${days}`) -} - -// --- Pulse (system watchdog, replaces heartbeat) --- - -export async function getPulseStatus(): Promise { - return requestJSON('/v1/pulse/status') -} - -export async function runPulseOnce(): Promise { - return requestJSON('/v1/pulse/run-once', { method: 'POST' }) -} - -export async function getPulseConfig(): Promise { - return requestJSON('/v1/pulse/config') -} - -// --- Reflection (nightly batch runner) --- - -export async function getReflectionStatus(): Promise { - return requestJSON('/v1/reflection/status') -} - -export async function runReflectionOnce(): Promise { - return requestJSON('/v1/reflection/run-once', { method: 'POST' }) -} - -export async function getReflectionConfig(): Promise { - return requestJSON('/v1/reflection/config') -} - -export async function listCronJobs(): Promise { - return requestJSON('/v1/cron/jobs') -} - -export async function listCronRuns(jobId: string, limit = 5): Promise { - return requestJSON(`/v1/cron/jobs/${encodeURIComponent(jobId)}/runs?limit=${limit}`) -} - -export async function getOpsStatus(): Promise { - return requestJSON('/v1/ops/status') -} - -export async function getWorkerControlPlane(): Promise { - return requestJSON('/v1/admin/workers') -} - -export async function createCleanupPlan(): Promise { - return requestJSON('/v1/ops/cleanup/plan', { method: 'POST' }) -} - -export async function applyCleanup(approvalId: string): Promise { - return requestJSON('/v1/ops/cleanup/apply', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ approval_id: approvalId }), - }) -} - -export async function listApprovals(): Promise { - return requestJSON('/v1/ops/approvals') -} - -export async function reviewApproval(approvalId: string, action: 'approve' | 'reject'): Promise { - await requestJSON<{ ok: boolean }>(`/v1/ops/approvals/${encodeURIComponent(approvalId)}/${action}`, { - method: 'POST', - }) -} - -export async function listAutomationAudit(limit = 50, sessionId = ''): Promise { - const params = new URLSearchParams() - if (limit > 0) params.set('limit', String(limit)) - if (sessionId.trim()) params.set('session_id', sessionId.trim()) - const suffix = params.toString() - return requestJSON(`/v1/ops/automation-audit${suffix ? `?${suffix}` : ''}`) -} - -export type SessionArchiveMode = 'active' | 'include' | 'only' - -export async function listSessions(includeHidden = false, archivedMode: SessionArchiveMode = 'active'): Promise { - const params = new URLSearchParams() - if (includeHidden) params.set('hidden', '1') - if (archivedMode !== 'active') params.set('archived', archivedMode) - const query = params.toString() - return requestJSON(`/v1/admin/sessions${query ? `?${query}` : ''}`) -} - -export async function createSession(title?: string): Promise { - return requestJSON('/v1/admin/sessions', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ title: title || 'New Chat' }), - }) -} - -export async function getSession(sessionId: string): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}`) -} - -export async function getSessionHistory(sessionId: string): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/history`) -} - -export async function forkSessionFromMessage(sessionId: string, messageId: string, forkReason?: string): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/fork`, { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ message_id: messageId, fork_reason: forkReason || 'Forked from chat transcript' }), - }) -} - -export async function getForkPromotions(sessionId: string): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/promotions`) -} - -export async function promoteForkInsights(sessionId: string, candidateIds: string[]): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/promotions`, { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ candidate_ids: candidateIds }), - }) -} - -export async function renameSession(sessionId: string, title: string): Promise { - await requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}`, { - method: 'PATCH', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ title }), - }) -} - -export async function setSessionArchived(sessionId: string, archived: boolean): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}`, { - method: 'PATCH', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ archived }), - }) -} - -export async function setSessionPinned(sessionId: string, pinned: boolean): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}`, { - method: 'PATCH', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ pinned }), - }) -} - -export async function recommendSessionCleanup(request: { mode: SessionCleanupMode; limit?: number }): Promise { - return requestJSON('/v1/admin/sessions/cleanup-suggestions', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(request), - }) -} - -export async function deleteSession(sessionId: string): Promise { - await requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}`, { - method: 'DELETE', - }) -} - -export type AgentRuntimeRunsOptions = { - limit?: number - status?: string - since?: string - search?: string -} - -export async function listAgentRuntimeRuns(options: number | AgentRuntimeRunsOptions = 30): Promise { - const params = new URLSearchParams() - const opts = typeof options === 'number' ? { limit: options } : options - params.set('limit', String(opts.limit ?? 30)) - if (opts.status?.trim() && opts.status !== 'all') params.set('status', opts.status.trim()) - if (opts.since?.trim() && opts.since !== 'all') params.set('since', opts.since.trim()) - if (opts.search?.trim()) params.set('search', opts.search.trim()) - const payload = await requestJSON<{ runs: AgentRuntimeRun[] }>(`/v1/agentruntime/runs?${params.toString()}`) - return payload.runs ?? [] -} - -export async function getAgentRuntimeRun(runId: string): Promise { - return requestJSON(`/v1/agentruntime/runs/${encodeURIComponent(runId)}`) -} - -export type AgentRuntimeRestartRequest = { - checkpoint_id?: string - agent?: string - tier?: string - provider_override?: AgentRuntimeProviderOverride - prompt_adjustment?: string - title?: string - mode?: AgentRuntimeRecoveryMode - confirm_unsafe_recovery?: boolean -} - -export async function restartAgentRuntimeRun(runId: string, payload: AgentRuntimeRestartRequest): Promise { - return requestJSON(`/v1/agentruntime/runs/${encodeURIComponent(runId)}/restart`, { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(payload), - }) -} - -export async function listAgentRuntimeSubagents(): Promise { - return requestJSON('/v1/agentruntime/subagents') -} - -export async function getAgentRuntimeSubagent(name: string): Promise { - return requestJSON(`/v1/agentruntime/subagents/${encodeURIComponent(name)}`) -} - -export async function updateAgentRuntimeSubagentTier(name: string, defaultTier: string): Promise { - return requestJSON(`/v1/agentruntime/subagents/${encodeURIComponent(name)}`, { - method: 'PATCH', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ default_tier: defaultTier }), - }) -} - -export async function draftAgentRuntimeSubagent(payload: { - mode: 'create' | 'edit' - request: string - base_name?: string - default_tier?: string - use_llm?: boolean -}): Promise { - return requestJSON('/v1/agentruntime/subagents/builder/draft', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(payload), - }) -} - -export async function applyAgentRuntimeSubagentDraft(draft: AgentRuntimeSubagentDraft): Promise { - return requestJSON('/v1/agentruntime/subagents/builder/apply', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ draft }), - }) -} - -export async function archiveAgentRuntimeSubagent(name: string, confirm: boolean): Promise { - return requestJSON(`/v1/agentruntime/subagents/${encodeURIComponent(name)}/archive`, { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ confirm }), - }) -} - -export async function recommendAgentRuntimeSubagents(payload: { - limit?: number - min_runs?: number - include_failed?: boolean -} = {}): Promise { - return requestJSON('/v1/agentruntime/subagents/recommendations', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(payload), - }) -} - -export function streamAgentRuntimeRunEvents( - runId: string, - onEvent: (event: AgentRuntimeRunEvent) => void, - onError?: (message: string) => void, - onOpen?: () => void, -): () => void { - const stream = new EventSource(`/v1/agentruntime/runs/${encodeURIComponent(runId)}/events`, { withCredentials: true }) - stream.onopen = () => { - onOpen?.() - } - stream.onmessage = (message) => { - if (!message.data) return - try { - onEvent(JSON.parse(message.data) as AgentRuntimeRunEvent) - } catch { - onError?.('Failed to parse agent runtime run event') - } - } - stream.onerror = () => onError?.('Agent Runtime run event stream disconnected') - return () => stream.close() -} - -export interface CompactResult { - session_id: string - compacted: boolean - original_count: number - final_count: number - compacted_count: number - tokens_before: number - tokens_after: number - reason: string -} - -export async function compactSession(sessionId: string): Promise { - return requestJSON( - `/v1/admin/sessions/${encodeURIComponent(sessionId)}/compact`, - { method: 'POST' }, - ) -} - -export async function getSessionTasks(sessionId: string): Promise { - const data = await requestJSON>(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/tasks`) - return normalizeSessionTasks(data) -} - -export async function getSessionWorkLedger(sessionId: string): Promise { - for (const source of ['session', 'legacy-session']) { - const params = new URLSearchParams({ - source, - source_id: sessionId, - limit: '1', - }) - const data = await requestJSON(`/v1/work/works?${params.toString()}`) - if (data.works[0]) return data.works[0] - } - return null -} - -export async function getWorkLedgerTimeline(workId: string): Promise { - return requestJSON(`/v1/work/works/${encodeURIComponent(workId)}/timeline`) -} - -export async function cancelWorkLedger(workId: string, reason: string): Promise { - return requestJSON(`/v1/admin/work/works/${encodeURIComponent(workId)}/cancel`, { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ reason }), - }) -} - -export async function resumeWorkLedgerStep(workId: string, stepId: string, reason: string): Promise { - return requestJSON( - `/v1/admin/work/works/${encodeURIComponent(workId)}/steps/${encodeURIComponent(stepId)}/resume`, - { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ reason }), - }, - ) -} - -export function watchWorkLedger( - workId: string, - afterSequence: number, - onEvent: (event: WorkLedgerEvent) => void, - onError?: () => void, -): () => void { - const params = new URLSearchParams({ after_sequence: String(Math.max(0, afterSequence)) }) - const stream = new EventSource( - `/v1/work/works/${encodeURIComponent(workId)}/watch?${params.toString()}`, - { withCredentials: true }, - ) - stream.addEventListener('work_event', (message) => { - if (!(message instanceof MessageEvent) || !message.data) return - try { - onEvent(JSON.parse(message.data) as WorkLedgerEvent) - } catch { - onError?.() - } - }) - stream.onerror = () => onError?.() - return () => stream.close() -} - -export async function getGlobalPlans(active = true): Promise { - const endpoint = active ? '/v1/admin/tasks?active=true' : '/v1/admin/tasks?active=false' - const data = await requestJSON>(endpoint) - return normalizeGlobalPlans(data) -} - -export async function getPlanArchive(limit = 50): Promise { - const data = await requestJSON>(`/v1/admin/plans/archive?limit=${limit}`) - return normalizePlanArchive(data) -} - -export async function getSessionPlanArchive(sessionId: string, limit = 20): Promise { - const data = await requestJSON>( - `/v1/admin/sessions/${encodeURIComponent(sessionId)}/plans/archive?limit=${limit}`, - ) - return normalizePlanArchive(data) -} - -// executeTasksAction drives the plan state machine directly from the -// console — used by the TasksPanel CTA buttons (Approve / Discard / Save -// edits). The body shape mirrors the chat-side `tasks` tool action. -export async function executeTasksAction( - sessionId: string, - payload: Record, -): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/tasks`, { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(payload), - }) -} - -export async function runTaskVerification( - sessionId: string, - payload: { task_id?: string; timeout_ms?: number } = {}, -): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/tasks/verify`, { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(payload), - }) -} - -// --- Git Inspector --- - -type GitQuery = { - sessionId?: string - root?: string -} - -function gitQueryParams(query: GitQuery = {}): URLSearchParams { - const params = new URLSearchParams() - if (query.sessionId?.trim()) params.set('session_id', query.sessionId.trim()) - if (query.root?.trim()) params.set('root', query.root.trim()) - return params -} - -function gitEndpoint(path: string, query: GitQuery = {}): string { - const params = gitQueryParams(query) - const suffix = params.toString() - return `/v1/git/${path}${suffix ? `?${suffix}` : ''}` -} - -export function getGitStatus(query: GitQuery = {}): Promise { - return requestJSON(gitEndpoint('status', query)) -} - -export function getGitDiff(query: GitQuery & { path?: string; staged?: boolean; hash?: string } = {}): Promise { - const params = gitQueryParams(query) - if (query.path?.trim()) params.set('path', query.path.trim()) - if (query.staged) params.set('staged', '1') - if (query.hash?.trim()) params.set('hash', query.hash.trim()) - const suffix = params.toString() - return requestJSON(`/v1/git/diff${suffix ? `?${suffix}` : ''}`) -} - -export function getGitCommit(query: GitQuery & { hash: string }): Promise { - const params = gitQueryParams(query) - params.set('hash', query.hash.trim()) - return requestJSON(`/v1/git/commit?${params.toString()}`) -} - -export function getGitWorktrees(query: GitQuery = {}): Promise { - return requestJSON(gitEndpoint('worktrees', query)) -} - -export function getGitLog(query: GitQuery & { limit?: number } = {}): Promise { - const params = gitQueryParams(query) - if (query.limit) params.set('limit', String(query.limit)) - const suffix = params.toString() - return requestJSON(`/v1/git/log${suffix ? `?${suffix}` : ''}`) -} - -export function getGitBranches(query: GitQuery = {}): Promise { - return requestJSON(gitEndpoint('branches', query)) -} - -export type CreateGitMutationApprovalRequest = { - session_id: string - root?: string - action: - | 'stage' - | 'unstage' - | 'discard' - | 'commit' - | 'switch_branch' - | 'checkout_commit' - | 'worktree_add' - | 'worktree_remove' - | 'fetch' - path?: string - branch?: string - message?: string - hash?: string - worktree_path?: string - new_branch?: string - reason?: string -} - -export function createGitMutationApproval(payload: CreateGitMutationApprovalRequest): Promise { - return requestJSON('/v1/git/mutations', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(payload), - }) -} - -export async function getSessionWorkDirs(sessionId: string): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/workdirs`) -} - -export async function updateSessionWorkDirs(sessionId: string, data: { work_dirs: string[]; current_dir: string }): Promise { - await requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/workdirs`, { - method: 'PUT', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(data), - }) -} - -export async function getSessionCwd(sessionId: string): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/cwd`) -} - -export async function setSessionCwd(sessionId: string, current: string): Promise { - await requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/cwd`, { - method: 'PUT', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ current }), - }) -} - -export async function getSessionGoal(sessionId: string): Promise<{ goal: SessionGoal | null }> { - return requestJSON<{ goal: SessionGoal | null }>( - `/v1/admin/sessions/${encodeURIComponent(sessionId)}/goal`, - ) -} - -export async function setSessionGoal( - sessionId: string, - description: string, - maxAutoContinues?: number, -): Promise<{ goal: SessionGoal | null }> { - const body: Record = { description } - if (typeof maxAutoContinues === 'number' && maxAutoContinues > 0) { - body.max_auto_continues = maxAutoContinues - } - return requestJSON<{ goal: SessionGoal | null }>( - `/v1/admin/sessions/${encodeURIComponent(sessionId)}/goal`, - { - method: 'PUT', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(body), - }, - ) -} - -export async function clearSessionGoal(sessionId: string): Promise<{ goal: SessionGoal | null }> { - return requestJSON<{ goal: SessionGoal | null }>( - `/v1/admin/sessions/${encodeURIComponent(sessionId)}/goal`, - { method: 'DELETE' }, - ) -} - -export async function getSessionCritic( - sessionId: string, -): Promise<{ critic: SessionCritic | null }> { - return requestJSON<{ critic: SessionCritic | null }>( - `/v1/admin/sessions/${encodeURIComponent(sessionId)}/critic`, - ) -} - -export async function setSessionCritic( - sessionId: string, - enabled: boolean, - maxIterations?: number, -): Promise<{ critic: SessionCritic | null }> { - const body: Record = { enabled } - if (typeof maxIterations === 'number' && maxIterations > 0) { - body.max_iterations = maxIterations - } - return requestJSON<{ critic: SessionCritic | null }>( - `/v1/admin/sessions/${encodeURIComponent(sessionId)}/critic`, - { - method: 'PUT', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(body), - }, - ) -} - -export async function clearSessionCritic( - sessionId: string, -): Promise<{ critic: SessionCritic | null }> { - return requestJSON<{ critic: SessionCritic | null }>( - `/v1/admin/sessions/${encodeURIComponent(sessionId)}/critic`, - { method: 'DELETE' }, - ) -} - -export async function getSessionEffectiveConfig(sessionId: string): Promise { - return requestJSON( - `/v1/admin/sessions/${encodeURIComponent(sessionId)}/effective-config`, - ) -} - -export type OpenTerminalResult = { - ok: boolean - cwd: string - app: string - message?: string -} - -export async function openTerminalHere(sessionId: string, cwd?: string): Promise { - return requestJSON('/v1/terminal/open', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ session_id: sessionId, cwd: cwd || '' }), - }) -} - -export function terminalWebSocketURL(sessionId: string, cwd?: string, cols = 80, rows = 24): string { - const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:' - const params = new URLSearchParams({ - session_id: sessionId, - cols: String(cols), - rows: String(rows), - }) - if (cwd) params.set('cwd', cwd) - return `${protocol}//${window.location.host}/v1/terminal/ws?${params}` -} - -export async function listMemoryAssets(): Promise<{ count: number; items: MemoryAsset[] }> { - return requestJSON<{ count: number; items: MemoryAsset[] }>('/v1/memory/assets') -} - -export async function getMemoryFile(path: string): Promise { - return requestJSON(`/v1/memory/file?path=${encodeURIComponent(path)}`) -} - -export async function saveMemoryFile(path: string, content: string): Promise { - return requestJSON('/v1/memory/file', { - method: 'PUT', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ path, content }), - }) -} - -export async function listMemoryInbox(status: MemoryCandidateStatus | 'all' = 'pending'): Promise { - const params = new URLSearchParams() - if (status) params.set('status', status) - const qs = params.toString() - return requestJSON(`/v1/memory/inbox${qs ? `?${qs}` : ''}`) -} - -export async function reviewMemoryCandidate( - id: string, - action: MemoryCandidateAction, - mergeTarget?: string, -): Promise { - return requestJSON('/v1/memory/inbox/review', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ id, action, merge_target: mergeTarget || '' }), - }) -} - -export async function runMemorySearch(payload: { - query: string - limit?: number - include_memory?: boolean - include_daily?: boolean - include_sessions?: boolean -}): Promise { - return requestJSON('/v1/memory/search', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(payload), - }) -} - -export async function runMemoryPrefetch(payload: { - query: string - session_id?: string -}): Promise { - const params = new URLSearchParams({ query: payload.query }) - if (payload.session_id?.trim()) params.set('session_id', payload.session_id.trim()) - return requestJSON(`/v1/memory/prefetch?${params.toString()}`, { - method: 'POST', - }) -} - -export async function listSyspromptFiles(scope?: 'workspace' | 'agent'): Promise<{ count: number; items: SyspromptFile[] }> { - const qs = scope ? `?scope=${encodeURIComponent(scope)}` : '' - return requestJSON<{ count: number; items: SyspromptFile[] }>(`/v1/workspace/sysprompt/files${qs}`) -} - -export async function getSyspromptFile(scope: 'workspace' | 'agent', path: string): Promise { - return requestJSON(`/v1/workspace/sysprompt/file?scope=${encodeURIComponent(scope)}&path=${encodeURIComponent(path)}`) -} - -export async function saveSyspromptFile(scope: 'workspace' | 'agent', path: string, content: string): Promise { - return requestJSON('/v1/workspace/sysprompt/file', { - method: 'PUT', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ scope, path, content }), - }) -} - -export async function getSyspromptPreview(target: 'main_agent' | 'sub_agent' = 'main_agent'): Promise { - return requestJSON(`/v1/admin/sysprompt/preview?target=${encodeURIComponent(target)}`) -} - -// --- Session Config --- - -export type SessionToolConfig = { - tools_enabled?: string[] - tools_custom?: boolean - tools_disabled?: string[] - tools_allow_groups?: string[] - tools_deny_groups?: string[] - skills_enabled?: string[] - skills_custom?: boolean - commands_enabled?: string[] - commands_custom?: boolean - mcp_enabled?: string[] - mcp_custom?: boolean -} - -export async function getSessionConfig(sessionId: string): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/config`) -} - -export async function updateSessionConfig(sessionId: string, config: SessionToolConfig): Promise { - await requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/config`, { - method: 'PATCH', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(config), - }) -} - -export async function updateSessionLocalConfig( - sessionId: string, - config: SessionToolConfig, -): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/local-config`, { - method: 'PATCH', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(config), - }) -} - -export async function getSessionAutomationConsent(sessionId: string): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/automation-consent`) -} - -export async function updateSessionAutomationConsent( - sessionId: string, - consent: SessionAutomationConsent, -): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/automation-consent`, { - method: 'PATCH', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(consent), - }) -} - -export async function getSessionStyle(sessionId: string): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/style`) -} - -export async function updateSessionStyle( - sessionId: string, - style: SessionStyleControl, -): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/style`, { - method: 'PATCH', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(style), - }) -} - -export type ChatToolInfo = { - name: string - description: string - high_risk: boolean - group?: string -} - -export type ChatToolsResponse = { - tools: ChatToolInfo[] - skills?: string[] - commands?: CommandDef[] - mcp_servers?: string[] -} - -export async function listChatTools(sessionId?: string): Promise { - const params = new URLSearchParams() - if (sessionId?.trim()) params.set('session_id', sessionId.trim()) - const qs = params.toString() - return requestJSON(`/v1/chat/tools${qs ? `?${qs}` : ''}`) -} - -// --- Chat Context --- - -export type ChatContextInfo = { - session_id: string - system_prompt: string - system_prompt_tokens: number - history_tokens: number - history_messages: number - tool_count: number - tool_names: string[] - skill_count?: number - skill_names?: string[] - command_count?: number - command_names?: string[] - memory_count: number - memory_tokens: number - compaction_trigger_tokens?: number - compaction_keep_recent_tokens?: number - compaction_keep_recent_fraction?: number - compaction_last_mode?: string - used_tool_names?: string[] - selected_skill_name?: string - selected_skill_reason?: string - selected_command_name?: string - selected_command_reason?: string - mentioned_path_count?: number - mentioned_paths?: string[] - mentioned_subagent_count?: number - mentioned_subagents?: string[] - llm_tier?: string - tier_recommendation?: ChatTierRecommendationRequest - style_effective?: SessionStyleResponse['effective'] - prompt_override: string -} - -export async function getChatContext(sessionId: string): Promise { - return requestJSON(`/v1/chat/context?session_id=${encodeURIComponent(sessionId)}`) -} - -export type PriorContextPreviewItem = { - source: string - source_tag: string - snippet: string - tokens: number -} - -export type PriorContextPreviewMode = 'default' | 'recent' - -export type PriorContextPreview = { - session_id: string - query: string - mode: PriorContextPreviewMode - section: string - items: PriorContextPreviewItem[] - below_threshold_items: PriorContextPreviewItem[] - recent_fallback_items: PriorContextPreviewItem[] - relevant_tokens: number - relevant_memory_count: number - relevant_budget_tokens: number - budget_percent: number - generated_at: string -} - -export async function getPriorContextPreview(sessionId: string, query: string): Promise { - return requestJSON('/v1/chat/prior-context/preview', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ session_id: sessionId, query }), - }) -} - -export type ChatFileMentionCandidate = { - kind: 'file' | 'directory' - name: string - path: string - root: string - root_label: string - token: string - size?: number - updated_at?: string -} - -export async function listChatFileMentions( - sessionId: string | undefined, - query: string, - limit = 30, -): Promise<{ candidates: ChatFileMentionCandidate[] }> { - const params = new URLSearchParams({ q: query, limit: String(limit) }) - if (sessionId?.trim()) params.set('session_id', sessionId.trim()) - return requestJSON<{ candidates: ChatFileMentionCandidate[] }>( - `/v1/chat/mentions/files?${params}`, - ) -} - -export async function getSessionPrompt(sessionId: string): Promise<{ prompt_override: string }> { - return requestJSON<{ prompt_override: string }>(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/prompt`) -} - -export async function updateSessionPrompt(sessionId: string, promptOverride: string): Promise { - await requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/prompt`, { - method: 'PUT', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ prompt_override: promptOverride }), - }) -} - -export async function getEventsHistory(limit = 30): Promise { - return requestJSON(`/v1/events/history?limit=${limit}`) -} - -export async function markEventsRead(lastId: number): Promise<{ unread_count: number }> { - return requestJSON<{ acknowledged: boolean; read_cursor: number; unread_count: number }>('/v1/events/read', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ last_id: lastId }), - }) -} - -// --- Cron Job CRUD --- - -export async function createCronJob(data: CreateCronJobRequest): Promise { - return requestJSON('/v1/cron/jobs', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(data), - }) -} - -export async function updateCronJob(jobId: string, data: UpdateCronJobRequest): Promise { - return requestJSON(`/v1/cron/jobs/${encodeURIComponent(jobId)}`, { - method: 'PUT', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(data), - }) -} - -export async function deleteCronJob(jobId: string): Promise { - await requestJSON>(`/v1/cron/jobs/${encodeURIComponent(jobId)}`, { - method: 'DELETE', - }) -} - -export async function runCronJob(jobId: string): Promise { - return requestJSON(`/v1/cron/jobs/${encodeURIComponent(jobId)}/run`, { - method: 'POST', - }) -} - -// --- Config --- - -export async function getConfig(): Promise { - return requestJSON('/v1/admin/config') -} - -export async function getConfigSchema(): Promise { - return requestJSON('/v1/admin/config/schema') -} - -export async function getProviderModels(providerAlias = ''): Promise { - const params = new URLSearchParams() - if (providerAlias.trim()) { - params.set('provider_alias', providerAlias.trim()) - } - const suffix = params.toString() - return requestJSON(`/v1/models${suffix ? `?${suffix}` : ''}`) -} - -export async function getProviders(): Promise { - return requestJSON('/v1/providers') -} - -export async function saveConfig(content: string): Promise { - await requestJSON<{ ok: string }>('/v1/admin/config', { - method: 'PUT', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ content }), - }) -} - -export async function restartServer(): Promise<{ ok: string; mode: string; info: string }> { - return requestJSON<{ ok: string; mode: string; info: string }>('/v1/admin/restart', { method: 'POST' }) -} - -export type WorkspaceResetResponse = { - removed: number - removed_items: string[] - failed_items?: { name?: string; path?: string; stage?: string; error: string }[] - reinitialized: boolean - error?: string -} - -export async function resetWorkspace(): Promise { - return requestJSON('/v1/admin/reset/workspace', { method: 'POST' }) -} - -export async function patchConfigValues(updates: Record): Promise { - await requestJSON<{ ok: string }>('/v1/admin/config/values', { - method: 'PATCH', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ updates }), - }) -} - -export async function getRemoteAccessStatus(): Promise { - return requestJSON('/v1/admin/remote-access/status') -} - -export async function enableRemoteAccess(httpsPort?: number): Promise { - return requestJSON('/v1/admin/remote-access/enable', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(httpsPort ? { https_port: httpsPort } : {}), - }) -} - -export async function disableRemoteAccess(httpsPort?: number): Promise { - return requestJSON('/v1/admin/remote-access/disable', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(httpsPort ? { https_port: httpsPort } : {}), - }) -} - -// --- Channels / Telegram --- - -export async function getTelegramPairings(): Promise { - return requestJSON('/v1/channels/telegram/pairings') -} - -export async function approveTelegramPairing(code: string): Promise<{ approved: TelegramAllowedUser }> { - return requestJSON<{ approved: TelegramAllowedUser }>('/v1/channels/telegram/pairings/approve', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ code: code.trim() }), - }) -} - -export async function revokeTelegramPairing(userId: number): Promise<{ revoked: boolean }> { - return requestJSON<{ revoked: boolean }>('/v1/channels/telegram/pairings/revoke', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ user_id: userId }), - }) -} - -// --- Hub / Extensions --- - -export async function getHubRegistry(): Promise { - return requestJSON('/v1/hub/registry') -} - -export async function getHubInstalled(): Promise { - return requestJSON('/v1/hub/installed') -} - -export async function hubInstall( - type: string, - name: string, - opts: { source?: string; yes?: boolean; dry_run?: boolean } = {}, -): Promise { - return requestJSON('/v1/hub/install', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ - type, - name, - source: opts.source, - yes: opts.yes, - dry_run: opts.dry_run, - }), - }) -} - -export async function getHubSources(): Promise { - const data = await requestJSON<{ sources: HubSource[] }>('/v1/hub/sources') - return data.sources ?? [] -} - -export async function searchHubSkills( - opts: { q?: string; source?: string } = {}, -): Promise { - const params = new URLSearchParams() - if (opts.q?.trim()) params.set('q', opts.q.trim()) - if (opts.source?.trim()) params.set('source', opts.source.trim()) - const qs = params.toString() - const data = await requestJSON<{ skills: HubSkillSearchResult[] }>( - `/v1/hub/skills${qs ? `?${qs}` : ''}`, - ) - return data.skills ?? [] -} - -export async function previewHubInstall( - name: string, - source: string, -): Promise { - const resp = await hubInstall('skill', name, { source, dry_run: true }) - return resp.preview ?? null -} - -export async function hubUninstall(type: string, name: string): Promise { - await requestJSON<{ ok: string }>('/v1/hub/uninstall', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ type, name }), - }) -} - -export async function hubUpdate(): Promise<{ updated_skills: string[]; updated_plugins: string[] }> { - return requestJSON<{ updated_skills: string[]; updated_plugins: string[] }>('/v1/hub/update', { method: 'POST' }) -} - -export async function listSkills(sessionId?: string): Promise { - const params = new URLSearchParams() - if (sessionId?.trim()) params.set('session_id', sessionId.trim()) - const qs = params.toString() - return requestJSON(`/v1/skills${qs ? `?${qs}` : ''}`) -} - -export async function listMCPServers(): Promise { - return requestJSON('/v1/mcp/servers') -} - -export async function getExtensionsHealth(): Promise { - return requestJSON('/v1/runtime/extensions/health') -} - -export async function repairExtension(kind: string, name: string): Promise { - return requestJSON('/v1/runtime/extensions/repair', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ kind, name }), - }) -} - -export async function getDisabledExtensions(): Promise<{ skills: string[]; plugins: string[]; mcp_servers: string[] }> { - return requestJSON('/v1/runtime/extensions/disabled') -} - -export async function setExtensionDisabled(kind: string, name: string, disabled: boolean): Promise { - await requestJSON<{ ok: boolean }>('/v1/runtime/extensions/disabled', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ kind, name, disabled }), - }) -} - -export async function getSkillDetail(name: string): Promise { - return requestJSON(`/v1/skills/${encodeURIComponent(name)}`) -} - -export async function getHubSkillContent(name: string): Promise<{ name: string; version: string; content: string }> { - return requestJSON<{ name: string; version: string; content: string }>(`/v1/hub/skill-content?name=${encodeURIComponent(name)}`) -} - -export async function reloadExtensions(): Promise<{ reloaded: boolean; skills: number; plugins: number; mcp_count: number }> { - return requestJSON<{ reloaded: boolean; skills: number; plugins: number; mcp_count: number }>('/v1/runtime/extensions/reload', { method: 'POST' }) -} - -export async function draftSkill(payload: SkillCreatorDraftRequest): Promise { - return requestJSON('/v1/admin/skills/draft', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(payload), - }) -} - -export async function saveLocalSkill(draft: SkillCreatorDraftResponse): Promise { - return requestJSON('/v1/admin/skills/save-local', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(draft), - }) -} - -export async function getWorkspaceSkillContent(name: string): Promise<{ name: string; content: string; path: string }> { - return requestJSON<{ name: string; content: string; path: string }>(`/v1/admin/skills/${encodeURIComponent(name)}`) -} - -export async function updateWorkspaceSkill(name: string, content: string): Promise<{ name: string; path: string }> { - return requestJSON<{ name: string; path: string }>(`/v1/admin/skills/${encodeURIComponent(name)}`, { - method: 'PUT', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ content }), - }) -} - -export async function deleteWorkspaceSkill(name: string): Promise<{ ok: boolean }> { - return requestJSON<{ ok: boolean }>(`/v1/admin/skills/${encodeURIComponent(name)}`, { - method: 'DELETE', - }) -} - -export async function testSkillDraft(draft: SkillCreatorDraftResponse): Promise { - return requestJSON('/v1/admin/skills/test', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(draft), - }) -} - -export async function submitSkillDraftPR(name: string): Promise { - return requestJSON('/v1/admin/skills/submit-pr', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ name }), - }) -} - -export async function listSkillExtractions(status: SkillExtractionCandidateStatus | 'all' = 'pending'): Promise { - const qs = new URLSearchParams() - if (status) qs.set('status', status) - return requestJSON(`/v1/admin/skills/extractions?${qs}`) -} - -export async function extractSkillsFromSession(sessionId: string, maxCandidates = 5): Promise { - return requestJSON('/v1/admin/skills/extractions/extract', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ session_id: sessionId, max_candidates: maxCandidates }), - }) -} - -export async function reviewSkillExtractionCandidate(id: string, action: SkillExtractionCandidateAction): Promise { - return requestJSON('/v1/admin/skills/extractions/review', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ id, action }), - }) -} - -export async function listSessionLocalSkills(sessionId: string): Promise { - return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/local-skills`) -} - -export async function promoteSessionLocalSkills( - sessionId: string, - payload: SessionLocalSkillPromoteRequest, -): Promise { - return requestJSON( - `/v1/admin/sessions/${encodeURIComponent(sessionId)}/local-skills/promote`, - { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(payload), - }, - ) -} - -export async function draftMCPServer(payload: MCPServerCreatorDraftRequest): Promise { - return requestJSON('/v1/admin/mcp-servers/draft', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(payload), - }) -} - -export async function saveLocalMCPServer(draft: MCPServerCreatorDraftResponse): Promise { - return requestJSON('/v1/admin/mcp-servers/save-local', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(draft), - }) -} - -export async function testMCPServerDraft(draft: MCPServerCreatorDraftResponse): Promise { - return requestJSON('/v1/admin/mcp-servers/test', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify(draft), - }) -} - -export async function submitMCPServerDraftPR(name: string): Promise { - return requestJSON('/v1/admin/mcp-servers/submit-pr', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ name }), - }) -} - -// --- Events (singleton SSE) --- -// -// A single EventSource is shared across all components to avoid exhausting the -// browser's per-origin HTTP/1.1 connection limit (typically 6). Components -// call streamEvents() to subscribe and receive a cleanup function that -// unsubscribes without closing the underlying connection. - -type EventListener = { - onEvent: (event: NotificationMessage) => void - onError?: (message: string) => void - onOpen?: () => void - onReopen?: () => void -} - -let sharedStream: EventSource | null = null -let listeners = new Map() -let nextListenerId = 0 -let hasOpenedOnce = false -let reconnectAttempt = 0 -let reconnectTimer: ReturnType | null = null - -function clearReconnectTimer() { - if (reconnectTimer !== null) { - clearTimeout(reconnectTimer) - reconnectTimer = null - } -} - -function scheduleReconnect() { - if (reconnectTimer !== null) return - if (listeners.size === 0) return - // Exponential backoff: 1s, 2s, 4s, 8s, 16s, capped at 30s. - const delay = Math.min(30_000, 1_000 * 2 ** Math.min(reconnectAttempt, 5)) - reconnectAttempt += 1 - reconnectTimer = setTimeout(() => { - reconnectTimer = null - if (listeners.size === 0) return - ensureStream() - }, delay) -} - -function ensureStream() { - if (sharedStream && sharedStream.readyState !== EventSource.CLOSED) return - if (sharedStream) { - sharedStream.close() - sharedStream = null - } - const wasOpenedBefore = hasOpenedOnce - sharedStream = new EventSource('/v1/events/stream', { withCredentials: true }) - sharedStream.onopen = () => { - clearReconnectTimer() - reconnectAttempt = 0 - const isReopen = wasOpenedBefore - hasOpenedOnce = true - for (const l of listeners.values()) { - l.onOpen?.() - if (isReopen) l.onReopen?.() - } - } - sharedStream.onmessage = (message) => { - if (!message.data) return - try { - const payload = JSON.parse(message.data) as NotificationMessage - if (payload.type === 'keepalive') return - for (const l of listeners.values()) l.onEvent(payload) - } catch (error) { - const msg = error instanceof Error ? error.message : 'Failed to parse event stream payload' - for (const l of listeners.values()) l.onError?.(msg) - } - } - sharedStream.onerror = () => { - for (const l of listeners.values()) l.onError?.('Event stream disconnected') - // EventSource auto-reconnects on transient drops (readyState=CONNECTING). - // Only schedule a manual reconnect once it gives up and reaches CLOSED. - if (sharedStream?.readyState === EventSource.CLOSED) { - scheduleReconnect() - } - } -} - -function maybeCloseStream() { - if (listeners.size === 0 && sharedStream) { - sharedStream.close() - sharedStream = null - clearReconnectTimer() - reconnectAttempt = 0 - hasOpenedOnce = false - } -} - -export function streamEvents( - onEvent: (event: NotificationMessage) => void, - onError?: (message: string) => void, - onOpen?: () => void, - onReopen?: () => void, -): () => void { - const id = nextListenerId++ - listeners.set(id, { onEvent, onError, onOpen, onReopen }) - ensureStream() - return () => { - listeners.delete(id) - maybeCloseStream() - } -} - -export async function streamChat( - request: ChatRequest, - onEvent: (event: ChatEvent) => void, - signal?: AbortSignal, -): Promise { - const response = await fetch('/v1/chat', { - method: 'POST', - credentials: 'same-origin', - headers: { - Accept: 'text/event-stream', - 'Content-Type': 'application/json', - }, - body: JSON.stringify(request), - signal, - }) - - if (!response.ok) { - let message = `${response.status} ${response.statusText}`.trim() - try { - const payload = (await response.json()) as APIErrorPayload - if (payload?.error?.trim()) { - message = payload.error.trim() - } - } catch { - // ignore non-JSON error bodies - } - throw new Error(message) - } - - if (!response.body) { - throw new Error('chat stream body missing') - } - - const reader = response.body.getReader() - const decoder = new TextDecoder() - let buffer = '' - - while (true) { - const { value, done } = await reader.read() - buffer += decoder.decode(value ?? new Uint8Array(), { stream: !done }) - const lines = buffer.split(/\r?\n/) - buffer = lines.pop() ?? '' - - for (const line of lines) { - if (!line.startsWith('data:')) { - continue - } - const payload = line.slice(5).trim() - if (!payload) { - continue - } - onEvent(JSON.parse(payload) as ChatEvent) - } - - if (done) { - break - } - } -} - -export async function cancelChat(sessionId: string): Promise { - try { - const result = await requestJSON<{ cancelled: boolean }>( - `/v1/chat/cancel?session_id=${encodeURIComponent(sessionId)}`, - { method: 'POST' }, - ) - return result.cancelled - } catch { - return false - } -} - -// --- Workspace Files --- - -export type WorkspaceFileEntry = { - name: string - path: string - is_dir: boolean - size?: number - updated_at?: string -} - -export type WorkspaceFileContent = { - path: string - name: string - size: number - updated_at: string - kind: 'text' | 'markdown' | 'image' | 'binary' - mime_type: string - encoding?: 'utf-8' | 'base64' - content?: string - content_base64?: string - truncated?: boolean - is_binary?: boolean - message?: string -} - -function workspaceFilesEndpoint(root?: string): string { - return root ? '/v1/filesystem/files' : '/v1/workspace/files' -} - -export async function listWorkspaceFiles(path = '.', root?: string): Promise<{ path: string; files: WorkspaceFileEntry[] }> { - const params = new URLSearchParams({ path }) - if (root) params.set('root', root) - return requestJSON<{ path: string; files: WorkspaceFileEntry[] }>( - `${workspaceFilesEndpoint(root)}?${params}` - ) -} - -export async function readWorkspaceFile(path: string, root?: string): Promise { - const params = new URLSearchParams({ path }) - if (root) params.set('root', root) - return requestJSON( - `${workspaceFilesEndpoint(root)}?${params}` - ) -} - -export async function createWorkspaceDirectory(parentPath: string, name: string, root?: string): Promise<{ path: string; name: string; is_dir: boolean }> { - const params = new URLSearchParams() - if (root) params.set('root', root) - return requestJSON<{ path: string; name: string; is_dir: boolean }>( - `${workspaceFilesEndpoint(root)}?${params}`, - { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ parent_path: parentPath, name }), - }, - ) -} - -export async function renameWorkspaceDirectory(path: string, newName: string, root?: string): Promise<{ path: string; name: string; is_dir: boolean }> { - const params = new URLSearchParams() - if (root) params.set('root', root) - return requestJSON<{ path: string; name: string; is_dir: boolean }>( - `${workspaceFilesEndpoint(root)}?${params}`, - { - method: 'PATCH', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ path, new_name: newName }), - }, - ) -} - -// --- Filesystem --- - -export type FilesystemBrowseResult = { - path: string - parent: string - entries: { name: string; is_dir: boolean; is_git?: boolean }[] -} - -export async function browseFilesystem(path?: string): Promise { - const params = path ? `?path=${encodeURIComponent(path)}` : '' - return requestJSON(`/v1/filesystem/browse${params}`) -} - -export async function createFilesystemDirectory(parentPath: string, name: string): Promise<{ path: string; name: string; is_dir: boolean }> { - return requestJSON('/v1/filesystem/browse', { - method: 'POST', - headers: { 'Content-Type': 'application/json' }, - body: JSON.stringify({ parent_path: parentPath, name }), - }) -} diff --git a/frontend/console/src/lib/api/agentruntime.ts b/frontend/console/src/lib/api/agentruntime.ts new file mode 100644 index 00000000..34b1366c --- /dev/null +++ b/frontend/console/src/lib/api/agentruntime.ts @@ -0,0 +1,134 @@ +import { requestJSON } from './client.ts' +import type { + AgentRuntimeRecoveryMode, + AgentRuntimeProviderOverride, + AgentRuntimeRun, + AgentRuntimeRunEvent, + AgentRuntimeSubagent, + AgentRuntimeSubagentArchiveResponse, + AgentRuntimeSubagentDraft, + AgentRuntimeSubagentDraftResponse, + AgentRuntimeSubagentRecommendationsResponse, + AgentRuntimeSubagentsResponse, +} from '../types' + +export type AgentRuntimeRunsOptions = { + limit?: number + status?: string + since?: string + search?: string +} + +export async function listAgentRuntimeRuns(options: number | AgentRuntimeRunsOptions = 30): Promise { + const params = new URLSearchParams() + const opts = typeof options === 'number' ? { limit: options } : options + params.set('limit', String(opts.limit ?? 30)) + if (opts.status?.trim() && opts.status !== 'all') params.set('status', opts.status.trim()) + if (opts.since?.trim() && opts.since !== 'all') params.set('since', opts.since.trim()) + if (opts.search?.trim()) params.set('search', opts.search.trim()) + const payload = await requestJSON<{ runs: AgentRuntimeRun[] }>(`/v1/agentruntime/runs?${params.toString()}`) + return payload.runs ?? [] +} + +export async function getAgentRuntimeRun(runId: string): Promise { + return requestJSON(`/v1/agentruntime/runs/${encodeURIComponent(runId)}`) +} + +export type AgentRuntimeRestartRequest = { + checkpoint_id?: string + agent?: string + tier?: string + provider_override?: AgentRuntimeProviderOverride + prompt_adjustment?: string + title?: string + mode?: AgentRuntimeRecoveryMode + confirm_unsafe_recovery?: boolean +} + +export async function restartAgentRuntimeRun(runId: string, payload: AgentRuntimeRestartRequest): Promise { + return requestJSON(`/v1/agentruntime/runs/${encodeURIComponent(runId)}/restart`, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + }) +} + +export async function listAgentRuntimeSubagents(): Promise { + return requestJSON('/v1/agentruntime/subagents') +} + +export async function getAgentRuntimeSubagent(name: string): Promise { + return requestJSON(`/v1/agentruntime/subagents/${encodeURIComponent(name)}`) +} + +export async function updateAgentRuntimeSubagentTier(name: string, defaultTier: string): Promise { + return requestJSON(`/v1/agentruntime/subagents/${encodeURIComponent(name)}`, { + method: 'PATCH', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ default_tier: defaultTier }), + }) +} + +export async function draftAgentRuntimeSubagent(payload: { + mode: 'create' | 'edit' + request: string + base_name?: string + default_tier?: string + use_llm?: boolean +}): Promise { + return requestJSON('/v1/agentruntime/subagents/builder/draft', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + }) +} + +export async function applyAgentRuntimeSubagentDraft(draft: AgentRuntimeSubagentDraft): Promise { + return requestJSON('/v1/agentruntime/subagents/builder/apply', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ draft }), + }) +} + +export async function archiveAgentRuntimeSubagent(name: string, confirm: boolean): Promise { + return requestJSON(`/v1/agentruntime/subagents/${encodeURIComponent(name)}/archive`, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ confirm }), + }) +} + +export async function recommendAgentRuntimeSubagents(payload: { + limit?: number + min_runs?: number + include_failed?: boolean +} = {}): Promise { + return requestJSON('/v1/agentruntime/subagents/recommendations', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + }) +} + +export function streamAgentRuntimeRunEvents( + runId: string, + onEvent: (event: AgentRuntimeRunEvent) => void, + onError?: (message: string) => void, + onOpen?: () => void, +): () => void { + const stream = new EventSource(`/v1/agentruntime/runs/${encodeURIComponent(runId)}/events`, { withCredentials: true }) + stream.onopen = () => { + onOpen?.() + } + stream.onmessage = (message) => { + if (!message.data) return + try { + onEvent(JSON.parse(message.data) as AgentRuntimeRunEvent) + } catch { + onError?.('Failed to parse agent runtime run event') + } + } + stream.onerror = () => onError?.('Agent Runtime run event stream disconnected') + return () => stream.close() +} diff --git a/frontend/console/src/lib/api/channels.ts b/frontend/console/src/lib/api/channels.ts new file mode 100644 index 00000000..9a05ff7d --- /dev/null +++ b/frontend/console/src/lib/api/channels.ts @@ -0,0 +1,24 @@ +import { requestJSON } from './client.ts' +import type { TelegramAllowedUser, TelegramPairingsResponse } from '../types' + +// --- Channels / Telegram --- + +export async function getTelegramPairings(): Promise { + return requestJSON('/v1/channels/telegram/pairings') +} + +export async function approveTelegramPairing(code: string): Promise<{ approved: TelegramAllowedUser }> { + return requestJSON<{ approved: TelegramAllowedUser }>('/v1/channels/telegram/pairings/approve', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ code: code.trim() }), + }) +} + +export async function revokeTelegramPairing(userId: number): Promise<{ revoked: boolean }> { + return requestJSON<{ revoked: boolean }>('/v1/channels/telegram/pairings/revoke', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ user_id: userId }), + }) +} diff --git a/frontend/console/src/lib/api/chat.ts b/frontend/console/src/lib/api/chat.ts new file mode 100644 index 00000000..03f0135d --- /dev/null +++ b/frontend/console/src/lib/api/chat.ts @@ -0,0 +1,314 @@ +import { requestJSON } from './client.ts' +import type { + APIErrorPayload, + ChatEvent, + ChatRequest, + ChatTierRecommendationRequest, + CommandDef, + NotificationMessage, + SessionStyleResponse, +} from '../types' + +// --- Events (singleton SSE) --- +// +// A single EventSource is shared across all components to avoid exhausting the +// browser's per-origin HTTP/1.1 connection limit (typically 6). Components +// call streamEvents() to subscribe and receive a cleanup function that +// unsubscribes without closing the underlying connection. + +type EventListener = { + onEvent: (event: NotificationMessage) => void + onError?: (message: string) => void + onOpen?: () => void + onReopen?: () => void +} + +let sharedStream: EventSource | null = null +let listeners = new Map() +let nextListenerId = 0 +let hasOpenedOnce = false +let reconnectAttempt = 0 +let reconnectTimer: ReturnType | null = null + +function clearReconnectTimer() { + if (reconnectTimer !== null) { + clearTimeout(reconnectTimer) + reconnectTimer = null + } +} + +function scheduleReconnect() { + if (reconnectTimer !== null) return + if (listeners.size === 0) return + // Exponential backoff: 1s, 2s, 4s, 8s, 16s, capped at 30s. + const delay = Math.min(30_000, 1_000 * 2 ** Math.min(reconnectAttempt, 5)) + reconnectAttempt += 1 + reconnectTimer = setTimeout(() => { + reconnectTimer = null + if (listeners.size === 0) return + ensureStream() + }, delay) +} + +function ensureStream() { + if (sharedStream && sharedStream.readyState !== EventSource.CLOSED) return + if (sharedStream) { + sharedStream.close() + sharedStream = null + } + const wasOpenedBefore = hasOpenedOnce + sharedStream = new EventSource('/v1/events/stream', { withCredentials: true }) + sharedStream.onopen = () => { + clearReconnectTimer() + reconnectAttempt = 0 + const isReopen = wasOpenedBefore + hasOpenedOnce = true + for (const l of listeners.values()) { + l.onOpen?.() + if (isReopen) l.onReopen?.() + } + } + sharedStream.onmessage = (message) => { + if (!message.data) return + try { + const payload = JSON.parse(message.data) as NotificationMessage + if (payload.type === 'keepalive') return + for (const l of listeners.values()) l.onEvent(payload) + } catch (error) { + const msg = error instanceof Error ? error.message : 'Failed to parse event stream payload' + for (const l of listeners.values()) l.onError?.(msg) + } + } + sharedStream.onerror = () => { + for (const l of listeners.values()) l.onError?.('Event stream disconnected') + // EventSource auto-reconnects on transient drops (readyState=CONNECTING). + // Only schedule a manual reconnect once it gives up and reaches CLOSED. + if (sharedStream?.readyState === EventSource.CLOSED) { + scheduleReconnect() + } + } +} + +function maybeCloseStream() { + if (listeners.size === 0 && sharedStream) { + sharedStream.close() + sharedStream = null + clearReconnectTimer() + reconnectAttempt = 0 + hasOpenedOnce = false + } +} + +export function streamEvents( + onEvent: (event: NotificationMessage) => void, + onError?: (message: string) => void, + onOpen?: () => void, + onReopen?: () => void, +): () => void { + const id = nextListenerId++ + listeners.set(id, { onEvent, onError, onOpen, onReopen }) + ensureStream() + return () => { + listeners.delete(id) + maybeCloseStream() + } +} + +export async function streamChat( + request: ChatRequest, + onEvent: (event: ChatEvent) => void, + signal?: AbortSignal, +): Promise { + const response = await fetch('/v1/chat', { + method: 'POST', + credentials: 'same-origin', + headers: { + Accept: 'text/event-stream', + 'Content-Type': 'application/json', + }, + body: JSON.stringify(request), + signal, + }) + + if (!response.ok) { + let message = `${response.status} ${response.statusText}`.trim() + try { + const payload = (await response.json()) as APIErrorPayload + if (payload?.error?.trim()) { + message = payload.error.trim() + } + } catch { + // ignore non-JSON error bodies + } + throw new Error(message) + } + + if (!response.body) { + throw new Error('chat stream body missing') + } + + const reader = response.body.getReader() + const decoder = new TextDecoder() + let buffer = '' + + while (true) { + const { value, done } = await reader.read() + buffer += decoder.decode(value ?? new Uint8Array(), { stream: !done }) + const lines = buffer.split(/\r?\n/) + buffer = lines.pop() ?? '' + + for (const line of lines) { + if (!line.startsWith('data:')) { + continue + } + const payload = line.slice(5).trim() + if (!payload) { + continue + } + onEvent(JSON.parse(payload) as ChatEvent) + } + + if (done) { + break + } + } +} + +export async function cancelChat(sessionId: string): Promise { + try { + const result = await requestJSON<{ cancelled: boolean }>( + `/v1/chat/cancel?session_id=${encodeURIComponent(sessionId)}`, + { method: 'POST' }, + ) + return result.cancelled + } catch { + return false + } +} + +export type ChatToolInfo = { + name: string + description: string + high_risk: boolean + group?: string +} + +export type ChatToolsResponse = { + tools: ChatToolInfo[] + skills?: string[] + commands?: CommandDef[] + mcp_servers?: string[] +} + +export async function listChatTools(sessionId?: string): Promise { + const params = new URLSearchParams() + if (sessionId?.trim()) params.set('session_id', sessionId.trim()) + const qs = params.toString() + return requestJSON(`/v1/chat/tools${qs ? `?${qs}` : ''}`) +} + +// --- Chat Context --- + +export type ChatContextInfo = { + session_id: string + system_prompt: string + system_prompt_tokens: number + history_tokens: number + history_messages: number + tool_count: number + tool_names: string[] + skill_count?: number + skill_names?: string[] + command_count?: number + command_names?: string[] + memory_count: number + memory_tokens: number + compaction_trigger_tokens?: number + compaction_keep_recent_tokens?: number + compaction_keep_recent_fraction?: number + compaction_last_mode?: string + used_tool_names?: string[] + selected_skill_name?: string + selected_skill_reason?: string + selected_command_name?: string + selected_command_reason?: string + mentioned_path_count?: number + mentioned_paths?: string[] + mentioned_subagent_count?: number + mentioned_subagents?: string[] + llm_tier?: string + tier_recommendation?: ChatTierRecommendationRequest + style_effective?: SessionStyleResponse['effective'] + prompt_override: string +} + +export async function getChatContext(sessionId: string): Promise { + return requestJSON(`/v1/chat/context?session_id=${encodeURIComponent(sessionId)}`) +} + +export type PriorContextPreviewItem = { + source: string + source_tag: string + snippet: string + tokens: number +} + +export type PriorContextPreviewMode = 'default' | 'recent' + +export type PriorContextPreview = { + session_id: string + query: string + mode: PriorContextPreviewMode + section: string + items: PriorContextPreviewItem[] + below_threshold_items: PriorContextPreviewItem[] + recent_fallback_items: PriorContextPreviewItem[] + relevant_tokens: number + relevant_memory_count: number + relevant_budget_tokens: number + budget_percent: number + generated_at: string +} + +export async function getPriorContextPreview(sessionId: string, query: string): Promise { + return requestJSON('/v1/chat/prior-context/preview', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ session_id: sessionId, query }), + }) +} + +export type ChatFileMentionCandidate = { + kind: 'file' | 'directory' + name: string + path: string + root: string + root_label: string + token: string + size?: number + updated_at?: string +} + +export async function listChatFileMentions( + sessionId: string | undefined, + query: string, + limit = 30, +): Promise<{ candidates: ChatFileMentionCandidate[] }> { + const params = new URLSearchParams({ q: query, limit: String(limit) }) + if (sessionId?.trim()) params.set('session_id', sessionId.trim()) + return requestJSON<{ candidates: ChatFileMentionCandidate[] }>( + `/v1/chat/mentions/files?${params}`, + ) +} + +export async function getSessionPrompt(sessionId: string): Promise<{ prompt_override: string }> { + return requestJSON<{ prompt_override: string }>(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/prompt`) +} + +export async function updateSessionPrompt(sessionId: string, promptOverride: string): Promise { + await requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/prompt`, { + method: 'PUT', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ prompt_override: promptOverride }), + }) +} diff --git a/frontend/console/src/lib/api/client.ts b/frontend/console/src/lib/api/client.ts new file mode 100644 index 00000000..cc77e083 --- /dev/null +++ b/frontend/console/src/lib/api/client.ts @@ -0,0 +1,48 @@ +import type { APIErrorPayload } from '../types' + +export class APIRequestError extends Error { + status: number + payload?: APIErrorPayload + + constructor(message: string, status: number, payload?: APIErrorPayload) { + super(message) + this.name = 'APIRequestError' + this.status = status + this.payload = payload + } + + get sandboxReport() { + return this.payload?.sandbox_report + } +} + +export async function requestJSON(input: string, init?: RequestInit): Promise { + const response = await fetch(input, { + credentials: 'same-origin', + headers: { + Accept: 'application/json', + ...(init?.headers ?? {}), + }, + ...init, + }) + + if (!response.ok) { + let message = `${response.status} ${response.statusText}`.trim() + let payload: APIErrorPayload | undefined + try { + payload = (await response.json()) as APIErrorPayload + if (payload?.error?.trim()) { + message = payload.error.trim() + } + } catch { + // ignore non-JSON error bodies + } + throw new APIRequestError(message, response.status, payload) + } + + if (response.status === 204) { + return undefined as T + } + + return (await response.json()) as T +} diff --git a/frontend/console/src/lib/api/config.ts b/frontend/console/src/lib/api/config.ts new file mode 100644 index 00000000..aef18fe3 --- /dev/null +++ b/frontend/console/src/lib/api/config.ts @@ -0,0 +1,81 @@ +import { requestJSON } from './client.ts' +import type { + ConfigFile, + ConfigSchema, + ProviderModelsInfo, + ProvidersAPIInfo, + RemoteAccessResponse, +} from '../types' + +export async function getConfig(): Promise { + return requestJSON('/v1/admin/config') +} + +export async function getConfigSchema(): Promise { + return requestJSON('/v1/admin/config/schema') +} + +export async function getProviderModels(providerAlias = ''): Promise { + const params = new URLSearchParams() + if (providerAlias.trim()) { + params.set('provider_alias', providerAlias.trim()) + } + const suffix = params.toString() + return requestJSON(`/v1/models${suffix ? `?${suffix}` : ''}`) +} + +export async function getProviders(): Promise { + return requestJSON('/v1/providers') +} + +export async function saveConfig(content: string): Promise { + await requestJSON<{ ok: string }>('/v1/admin/config', { + method: 'PUT', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ content }), + }) +} + +export async function restartServer(): Promise<{ ok: string; mode: string; info: string }> { + return requestJSON<{ ok: string; mode: string; info: string }>('/v1/admin/restart', { method: 'POST' }) +} + +export type WorkspaceResetResponse = { + removed: number + removed_items: string[] + failed_items?: { name?: string; path?: string; stage?: string; error: string }[] + reinitialized: boolean + error?: string +} + +export async function resetWorkspace(): Promise { + return requestJSON('/v1/admin/reset/workspace', { method: 'POST' }) +} + +export async function patchConfigValues(updates: Record): Promise { + await requestJSON<{ ok: string }>('/v1/admin/config/values', { + method: 'PATCH', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ updates }), + }) +} + +export async function getRemoteAccessStatus(): Promise { + return requestJSON('/v1/admin/remote-access/status') +} + +export async function enableRemoteAccess(httpsPort?: number): Promise { + return requestJSON('/v1/admin/remote-access/enable', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(httpsPort ? { https_port: httpsPort } : {}), + }) +} + +export async function disableRemoteAccess(httpsPort?: number): Promise { + return requestJSON('/v1/admin/remote-access/disable', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(httpsPort ? { https_port: httpsPort } : {}), + }) +} diff --git a/frontend/console/src/lib/api/extensions.ts b/frontend/console/src/lib/api/extensions.ts new file mode 100644 index 00000000..d054d2ed --- /dev/null +++ b/frontend/console/src/lib/api/extensions.ts @@ -0,0 +1,250 @@ +import { requestJSON } from './client.ts' +import type { + ExtensionHealthResponse, + ExtensionRepairResponse, + HubDryRunResult, + HubInstallResponse, + HubInstalled, + HubRegistry, + HubSkillSearchResult, + HubSource, + MCPServerCreatorDraftRequest, + MCPServerCreatorDraftResponse, + MCPServerCreatorSaveResponse, + MCPServerCreatorSubmitResponse, + MCPServerCreatorTestResponse, + MCPServerStatus, + SkillCreatorDraftRequest, + SkillCreatorDraftResponse, + SkillCreatorSaveResponse, + SkillCreatorTestResponse, + SkillCreatorSubmitResponse, + SkillDef, + SkillExtractionCandidateAction, + SkillExtractionCandidateStatus, + SkillExtractionListResponse, + SkillExtractionReviewResponse, +} from '../types' + +// --- Hub / Extensions --- + +export async function getHubRegistry(): Promise { + return requestJSON('/v1/hub/registry') +} + +export async function getHubInstalled(): Promise { + return requestJSON('/v1/hub/installed') +} + +export async function hubInstall( + type: string, + name: string, + opts: { source?: string; yes?: boolean; dry_run?: boolean } = {}, +): Promise { + return requestJSON('/v1/hub/install', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ + type, + name, + source: opts.source, + yes: opts.yes, + dry_run: opts.dry_run, + }), + }) +} + +export async function getHubSources(): Promise { + const data = await requestJSON<{ sources: HubSource[] }>('/v1/hub/sources') + return data.sources ?? [] +} + +export async function searchHubSkills( + opts: { q?: string; source?: string } = {}, +): Promise { + const params = new URLSearchParams() + if (opts.q?.trim()) params.set('q', opts.q.trim()) + if (opts.source?.trim()) params.set('source', opts.source.trim()) + const qs = params.toString() + const data = await requestJSON<{ skills: HubSkillSearchResult[] }>( + `/v1/hub/skills${qs ? `?${qs}` : ''}`, + ) + return data.skills ?? [] +} + +export async function previewHubInstall( + name: string, + source: string, +): Promise { + const resp = await hubInstall('skill', name, { source, dry_run: true }) + return resp.preview ?? null +} + +export async function hubUninstall(type: string, name: string): Promise { + await requestJSON<{ ok: string }>('/v1/hub/uninstall', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ type, name }), + }) +} + +export async function hubUpdate(): Promise<{ updated_skills: string[]; updated_plugins: string[] }> { + return requestJSON<{ updated_skills: string[]; updated_plugins: string[] }>('/v1/hub/update', { method: 'POST' }) +} + +export async function listSkills(sessionId?: string): Promise { + const params = new URLSearchParams() + if (sessionId?.trim()) params.set('session_id', sessionId.trim()) + const qs = params.toString() + return requestJSON(`/v1/skills${qs ? `?${qs}` : ''}`) +} + +export async function listMCPServers(): Promise { + return requestJSON('/v1/mcp/servers') +} + +export async function getExtensionsHealth(): Promise { + return requestJSON('/v1/runtime/extensions/health') +} + +export async function repairExtension(kind: string, name: string): Promise { + return requestJSON('/v1/runtime/extensions/repair', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ kind, name }), + }) +} + +export async function getDisabledExtensions(): Promise<{ skills: string[]; plugins: string[]; mcp_servers: string[] }> { + return requestJSON('/v1/runtime/extensions/disabled') +} + +export async function setExtensionDisabled(kind: string, name: string, disabled: boolean): Promise { + await requestJSON<{ ok: boolean }>('/v1/runtime/extensions/disabled', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ kind, name, disabled }), + }) +} + +export async function getSkillDetail(name: string): Promise { + return requestJSON(`/v1/skills/${encodeURIComponent(name)}`) +} + +export async function getHubSkillContent(name: string): Promise<{ name: string; version: string; content: string }> { + return requestJSON<{ name: string; version: string; content: string }>(`/v1/hub/skill-content?name=${encodeURIComponent(name)}`) +} + +export async function reloadExtensions(): Promise<{ reloaded: boolean; skills: number; plugins: number; mcp_count: number }> { + return requestJSON<{ reloaded: boolean; skills: number; plugins: number; mcp_count: number }>('/v1/runtime/extensions/reload', { method: 'POST' }) +} + +// --- Skill creator --- + +export async function draftSkill(payload: SkillCreatorDraftRequest): Promise { + return requestJSON('/v1/admin/skills/draft', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + }) +} + +export async function saveLocalSkill(draft: SkillCreatorDraftResponse): Promise { + return requestJSON('/v1/admin/skills/save-local', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(draft), + }) +} + +export async function getWorkspaceSkillContent(name: string): Promise<{ name: string; content: string; path: string }> { + return requestJSON<{ name: string; content: string; path: string }>(`/v1/admin/skills/${encodeURIComponent(name)}`) +} + +export async function updateWorkspaceSkill(name: string, content: string): Promise<{ name: string; path: string }> { + return requestJSON<{ name: string; path: string }>(`/v1/admin/skills/${encodeURIComponent(name)}`, { + method: 'PUT', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ content }), + }) +} + +export async function deleteWorkspaceSkill(name: string): Promise<{ ok: boolean }> { + return requestJSON<{ ok: boolean }>(`/v1/admin/skills/${encodeURIComponent(name)}`, { + method: 'DELETE', + }) +} + +export async function testSkillDraft(draft: SkillCreatorDraftResponse): Promise { + return requestJSON('/v1/admin/skills/test', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(draft), + }) +} + +export async function submitSkillDraftPR(name: string): Promise { + return requestJSON('/v1/admin/skills/submit-pr', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ name }), + }) +} + +// --- Skill extraction inbox --- + +export async function listSkillExtractions(status: SkillExtractionCandidateStatus | 'all' = 'pending'): Promise { + const qs = new URLSearchParams() + if (status) qs.set('status', status) + return requestJSON(`/v1/admin/skills/extractions?${qs}`) +} + +export async function extractSkillsFromSession(sessionId: string, maxCandidates = 5): Promise { + return requestJSON('/v1/admin/skills/extractions/extract', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ session_id: sessionId, max_candidates: maxCandidates }), + }) +} + +export async function reviewSkillExtractionCandidate(id: string, action: SkillExtractionCandidateAction): Promise { + return requestJSON('/v1/admin/skills/extractions/review', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ id, action }), + }) +} + +// --- MCP server creator --- + +export async function draftMCPServer(payload: MCPServerCreatorDraftRequest): Promise { + return requestJSON('/v1/admin/mcp-servers/draft', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + }) +} + +export async function saveLocalMCPServer(draft: MCPServerCreatorDraftResponse): Promise { + return requestJSON('/v1/admin/mcp-servers/save-local', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(draft), + }) +} + +export async function testMCPServerDraft(draft: MCPServerCreatorDraftResponse): Promise { + return requestJSON('/v1/admin/mcp-servers/test', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(draft), + }) +} + +export async function submitMCPServerDraftPR(name: string): Promise { + return requestJSON('/v1/admin/mcp-servers/submit-pr', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ name }), + }) +} diff --git a/frontend/console/src/lib/api/git.ts b/frontend/console/src/lib/api/git.ts new file mode 100644 index 00000000..84220827 --- /dev/null +++ b/frontend/console/src/lib/api/git.ts @@ -0,0 +1,94 @@ +import { requestJSON } from './client.ts' +import type { + GitBranchesResponse, + GitCommitDetail, + GitDiff, + GitLogResponse, + GitMutationPlan, + GitStatus, + GitWorktreesResponse, +} from '../types' + +// --- Git Inspector --- + +type GitQuery = { + sessionId?: string + root?: string +} + +function gitQueryParams(query: GitQuery = {}): URLSearchParams { + const params = new URLSearchParams() + if (query.sessionId?.trim()) params.set('session_id', query.sessionId.trim()) + if (query.root?.trim()) params.set('root', query.root.trim()) + return params +} + +function gitEndpoint(path: string, query: GitQuery = {}): string { + const params = gitQueryParams(query) + const suffix = params.toString() + return `/v1/git/${path}${suffix ? `?${suffix}` : ''}` +} + +export function getGitStatus(query: GitQuery = {}): Promise { + return requestJSON(gitEndpoint('status', query)) +} + +export function getGitDiff(query: GitQuery & { path?: string; staged?: boolean; hash?: string } = {}): Promise { + const params = gitQueryParams(query) + if (query.path?.trim()) params.set('path', query.path.trim()) + if (query.staged) params.set('staged', '1') + if (query.hash?.trim()) params.set('hash', query.hash.trim()) + const suffix = params.toString() + return requestJSON(`/v1/git/diff${suffix ? `?${suffix}` : ''}`) +} + +export function getGitCommit(query: GitQuery & { hash: string }): Promise { + const params = gitQueryParams(query) + params.set('hash', query.hash.trim()) + return requestJSON(`/v1/git/commit?${params.toString()}`) +} + +export function getGitWorktrees(query: GitQuery = {}): Promise { + return requestJSON(gitEndpoint('worktrees', query)) +} + +export function getGitLog(query: GitQuery & { limit?: number } = {}): Promise { + const params = gitQueryParams(query) + if (query.limit) params.set('limit', String(query.limit)) + const suffix = params.toString() + return requestJSON(`/v1/git/log${suffix ? `?${suffix}` : ''}`) +} + +export function getGitBranches(query: GitQuery = {}): Promise { + return requestJSON(gitEndpoint('branches', query)) +} + +export type CreateGitMutationApprovalRequest = { + session_id: string + root?: string + action: + | 'stage' + | 'unstage' + | 'discard' + | 'commit' + | 'switch_branch' + | 'checkout_commit' + | 'worktree_add' + | 'worktree_remove' + | 'fetch' + path?: string + branch?: string + message?: string + hash?: string + worktree_path?: string + new_branch?: string + reason?: string +} + +export function createGitMutationApproval(payload: CreateGitMutationApprovalRequest): Promise { + return requestJSON('/v1/git/mutations', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + }) +} diff --git a/frontend/console/src/lib/api/index.ts b/frontend/console/src/lib/api/index.ts new file mode 100644 index 00000000..23717c1e --- /dev/null +++ b/frontend/console/src/lib/api/index.ts @@ -0,0 +1,19 @@ +// Console API client split by domain (#931). +// +// Each module owns one server domain; this barrel re-exports the full public +// surface so `import { … } from '../lib/api'` keeps working everywhere. + +export { APIRequestError } from './client.ts' + +export * from './system.ts' +export * from './config.ts' +export * from './chat.ts' +export * from './sessions.ts' +export * from './tasks.ts' +export * from './git.ts' +export * from './memory.ts' +export * from './ops.ts' +export * from './extensions.ts' +export * from './channels.ts' +export * from './agentruntime.ts' +export * from './workspace.ts' diff --git a/frontend/console/src/lib/api/memory.ts b/frontend/console/src/lib/api/memory.ts new file mode 100644 index 00000000..146665fe --- /dev/null +++ b/frontend/console/src/lib/api/memory.ts @@ -0,0 +1,96 @@ +import { requestJSON } from './client.ts' +import type { + MemoryAsset, + MemoryCandidateAction, + MemoryCandidateListResponse, + MemoryCandidateReviewResponse, + MemoryCandidateStatus, + MemoryFile, + MemoryPrefetchResult, + MemorySearchResult, + SyspromptFile, + SyspromptPreview, +} from '../types' + +export async function listMemoryAssets(): Promise<{ count: number; items: MemoryAsset[] }> { + return requestJSON<{ count: number; items: MemoryAsset[] }>('/v1/memory/assets') +} + +export async function getMemoryFile(path: string): Promise { + return requestJSON(`/v1/memory/file?path=${encodeURIComponent(path)}`) +} + +export async function saveMemoryFile(path: string, content: string): Promise { + return requestJSON('/v1/memory/file', { + method: 'PUT', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ path, content }), + }) +} + +export async function listMemoryInbox(status: MemoryCandidateStatus | 'all' = 'pending'): Promise { + const params = new URLSearchParams() + if (status) params.set('status', status) + const qs = params.toString() + return requestJSON(`/v1/memory/inbox${qs ? `?${qs}` : ''}`) +} + +export async function reviewMemoryCandidate( + id: string, + action: MemoryCandidateAction, + mergeTarget?: string, +): Promise { + return requestJSON('/v1/memory/inbox/review', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ id, action, merge_target: mergeTarget || '' }), + }) +} + +export async function runMemorySearch(payload: { + query: string + limit?: number + include_memory?: boolean + include_daily?: boolean + include_sessions?: boolean +}): Promise { + return requestJSON('/v1/memory/search', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + }) +} + +export async function runMemoryPrefetch(payload: { + query: string + session_id?: string +}): Promise { + const params = new URLSearchParams({ query: payload.query }) + if (payload.session_id?.trim()) params.set('session_id', payload.session_id.trim()) + return requestJSON(`/v1/memory/prefetch?${params.toString()}`, { + method: 'POST', + }) +} + +// --- System prompt workspace --- + +export async function listSyspromptFiles(scope?: 'workspace' | 'agent'): Promise<{ count: number; items: SyspromptFile[] }> { + const qs = scope ? `?scope=${encodeURIComponent(scope)}` : '' + return requestJSON<{ count: number; items: SyspromptFile[] }>(`/v1/workspace/sysprompt/files${qs}`) +} + +export async function getSyspromptFile(scope: 'workspace' | 'agent', path: string): Promise { + return requestJSON(`/v1/workspace/sysprompt/file?scope=${encodeURIComponent(scope)}&path=${encodeURIComponent(path)}`) +} + +export async function saveSyspromptFile(scope: 'workspace' | 'agent', path: string, content: string): Promise { + return requestJSON('/v1/workspace/sysprompt/file', { + method: 'PUT', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ scope, path, content }), + }) +} + +export async function getSyspromptPreview(target: 'main_agent' | 'sub_agent' = 'main_agent'): Promise { + return requestJSON(`/v1/admin/sysprompt/preview?target=${encodeURIComponent(target)}`) +} diff --git a/frontend/console/src/lib/api/normalize.ts b/frontend/console/src/lib/api/normalize.ts new file mode 100644 index 00000000..de2add69 --- /dev/null +++ b/frontend/console/src/lib/api/normalize.ts @@ -0,0 +1,56 @@ +import type { + PlanArchiveResponse, + GlobalPlansResponse, + SessionTasks, + TaskContract, + TaskEvidence, +} from '../types' + +export function normalizeSessionTasks(data: Partial | null | undefined): SessionTasks { + return { + ...(data?.plan ? { plan: data.plan } : {}), + ...(data?.contract ? { contract: normalizeTaskContract(data.contract) } : {}), + tasks: Array.isArray(data?.tasks) + ? data.tasks.map((task) => ({ + ...task, + evidence: Array.isArray(task.evidence) ? task.evidence.map(normalizeTaskEvidence) : [], + })) + : [], + } +} + +export function normalizeTaskEvidence(data: Partial | null | undefined): TaskEvidence { + return { + ...(data ?? {}), + id: data?.id ?? '', + type: data?.type ?? 'command_output_summary', + } +} + +export function normalizeTaskContract(data: Partial | null | undefined): TaskContract { + return { + ...data, + done_criteria: Array.isArray(data?.done_criteria) ? data.done_criteria : [], + verification_commands: Array.isArray(data?.verification_commands) ? data.verification_commands : [], + artifacts: Array.isArray(data?.artifacts) ? data.artifacts : [], + } +} + +export function normalizePlanArchive(data: Partial | null | undefined): PlanArchiveResponse { + return { + items: Array.isArray(data?.items) ? data.items : [], + count: typeof data?.count === 'number' ? data.count : Array.isArray(data?.items) ? data.items.length : 0, + } +} + +export function normalizeGlobalPlans(data: Partial | null | undefined): GlobalPlansResponse { + return { + items: Array.isArray(data?.items) + ? data.items.map((item) => ({ + ...item, + ...(item.contract ? { contract: normalizeTaskContract(item.contract) } : {}), + })) + : [], + count: typeof data?.count === 'number' ? data.count : Array.isArray(data?.items) ? data.items.length : 0, + } +} diff --git a/frontend/console/src/lib/api/ops.ts b/frontend/console/src/lib/api/ops.ts new file mode 100644 index 00000000..dfccbb51 --- /dev/null +++ b/frontend/console/src/lib/api/ops.ts @@ -0,0 +1,126 @@ +import { requestJSON } from './client.ts' +import type { + Approval, + AutomationAuditListResponse, + CleanupApplyResult, + CleanupPlan, + CreateCronJobRequest, + CronJob, + CronRunRecord, + CronRunResult, + OpsStatus, + PulseConfigView, + PulseSnapshot, + PulseTickOutcome, + ReflectionConfigView, + ReflectionRunSummary, + ReflectionSnapshot, + UpdateCronJobRequest, + WorkerControlPlaneResponse, +} from '../types' + +// --- Pulse (system watchdog, replaces heartbeat) --- + +export async function getPulseStatus(): Promise { + return requestJSON('/v1/pulse/status') +} + +export async function runPulseOnce(): Promise { + return requestJSON('/v1/pulse/run-once', { method: 'POST' }) +} + +export async function getPulseConfig(): Promise { + return requestJSON('/v1/pulse/config') +} + +// --- Reflection (nightly batch runner) --- + +export async function getReflectionStatus(): Promise { + return requestJSON('/v1/reflection/status') +} + +export async function runReflectionOnce(): Promise { + return requestJSON('/v1/reflection/run-once', { method: 'POST' }) +} + +export async function getReflectionConfig(): Promise { + return requestJSON('/v1/reflection/config') +} + +// --- Cron --- + +export async function listCronJobs(): Promise { + return requestJSON('/v1/cron/jobs') +} + +export async function listCronRuns(jobId: string, limit = 5): Promise { + return requestJSON(`/v1/cron/jobs/${encodeURIComponent(jobId)}/runs?limit=${limit}`) +} + +export async function createCronJob(data: CreateCronJobRequest): Promise { + return requestJSON('/v1/cron/jobs', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(data), + }) +} + +export async function updateCronJob(jobId: string, data: UpdateCronJobRequest): Promise { + return requestJSON(`/v1/cron/jobs/${encodeURIComponent(jobId)}`, { + method: 'PUT', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(data), + }) +} + +export async function deleteCronJob(jobId: string): Promise { + await requestJSON>(`/v1/cron/jobs/${encodeURIComponent(jobId)}`, { + method: 'DELETE', + }) +} + +export async function runCronJob(jobId: string): Promise { + return requestJSON(`/v1/cron/jobs/${encodeURIComponent(jobId)}/run`, { + method: 'POST', + }) +} + +// --- Ops / approvals --- + +export async function getOpsStatus(): Promise { + return requestJSON('/v1/ops/status') +} + +export async function createCleanupPlan(): Promise { + return requestJSON('/v1/ops/cleanup/plan', { method: 'POST' }) +} + +export async function applyCleanup(approvalId: string): Promise { + return requestJSON('/v1/ops/cleanup/apply', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ approval_id: approvalId }), + }) +} + +export async function listApprovals(): Promise { + return requestJSON('/v1/ops/approvals') +} + +export async function reviewApproval(approvalId: string, action: 'approve' | 'reject'): Promise { + await requestJSON<{ ok: boolean }>(`/v1/ops/approvals/${encodeURIComponent(approvalId)}/${action}`, { + method: 'POST', + }) +} + +export async function listAutomationAudit(limit = 50, sessionId = ''): Promise { + const params = new URLSearchParams() + if (limit > 0) params.set('limit', String(limit)) + if (sessionId.trim()) params.set('session_id', sessionId.trim()) + const suffix = params.toString() + return requestJSON(`/v1/ops/automation-audit${suffix ? `?${suffix}` : ''}`) +} + +export async function getWorkerControlPlane(): Promise { + return requestJSON('/v1/admin/workers') +} diff --git a/frontend/console/src/lib/api/sessions.ts b/frontend/console/src/lib/api/sessions.ts new file mode 100644 index 00000000..628db28b --- /dev/null +++ b/frontend/console/src/lib/api/sessions.ts @@ -0,0 +1,335 @@ +import { requestJSON } from './client.ts' +import type { + ForkPromotionListResponse, + ForkPromotionResult, + Session, + SessionAutomationConsent, + SessionCleanupMode, + SessionCleanupSuggestionResponse, + SessionCritic, + SessionCwd, + SessionEffectiveConfig, + SessionGoal, + SessionLocalSkillListResponse, + SessionLocalSkillPromoteRequest, + SessionLocalSkillPromoteResponse, + SessionMessage, + SessionStyleControl, + SessionStyleResponse, + SessionWorkDirs, +} from '../types' + +export type SessionArchiveMode = 'active' | 'include' | 'only' + +export async function listSessions(includeHidden = false, archivedMode: SessionArchiveMode = 'active'): Promise { + const params = new URLSearchParams() + if (includeHidden) params.set('hidden', '1') + if (archivedMode !== 'active') params.set('archived', archivedMode) + const query = params.toString() + return requestJSON(`/v1/admin/sessions${query ? `?${query}` : ''}`) +} + +export async function createSession(title?: string): Promise { + return requestJSON('/v1/admin/sessions', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ title: title || 'New Chat' }), + }) +} + +export async function getSession(sessionId: string): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}`) +} + +export async function getSessionHistory(sessionId: string): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/history`) +} + +export async function forkSessionFromMessage(sessionId: string, messageId: string, forkReason?: string): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/fork`, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ message_id: messageId, fork_reason: forkReason || 'Forked from chat transcript' }), + }) +} + +export async function getForkPromotions(sessionId: string): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/promotions`) +} + +export async function promoteForkInsights(sessionId: string, candidateIds: string[]): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/promotions`, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ candidate_ids: candidateIds }), + }) +} + +export async function renameSession(sessionId: string, title: string): Promise { + await requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}`, { + method: 'PATCH', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ title }), + }) +} + +export async function setSessionArchived(sessionId: string, archived: boolean): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}`, { + method: 'PATCH', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ archived }), + }) +} + +export async function setSessionPinned(sessionId: string, pinned: boolean): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}`, { + method: 'PATCH', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ pinned }), + }) +} + +export async function recommendSessionCleanup(request: { mode: SessionCleanupMode; limit?: number }): Promise { + return requestJSON('/v1/admin/sessions/cleanup-suggestions', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(request), + }) +} + +export async function deleteSession(sessionId: string): Promise { + await requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}`, { + method: 'DELETE', + }) +} + +export interface CompactResult { + session_id: string + compacted: boolean + original_count: number + final_count: number + compacted_count: number + tokens_before: number + tokens_after: number + reason: string +} + +export async function compactSession(sessionId: string): Promise { + return requestJSON( + `/v1/admin/sessions/${encodeURIComponent(sessionId)}/compact`, + { method: 'POST' }, + ) +} + +export async function getSessionWorkDirs(sessionId: string): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/workdirs`) +} + +export async function updateSessionWorkDirs(sessionId: string, data: { work_dirs: string[]; current_dir: string }): Promise { + await requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/workdirs`, { + method: 'PUT', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(data), + }) +} + +export async function getSessionCwd(sessionId: string): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/cwd`) +} + +export async function setSessionCwd(sessionId: string, current: string): Promise { + await requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/cwd`, { + method: 'PUT', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ current }), + }) +} + +export async function getSessionGoal(sessionId: string): Promise<{ goal: SessionGoal | null }> { + return requestJSON<{ goal: SessionGoal | null }>( + `/v1/admin/sessions/${encodeURIComponent(sessionId)}/goal`, + ) +} + +export async function setSessionGoal( + sessionId: string, + description: string, + maxAutoContinues?: number, +): Promise<{ goal: SessionGoal | null }> { + const body: Record = { description } + if (typeof maxAutoContinues === 'number' && maxAutoContinues > 0) { + body.max_auto_continues = maxAutoContinues + } + return requestJSON<{ goal: SessionGoal | null }>( + `/v1/admin/sessions/${encodeURIComponent(sessionId)}/goal`, + { + method: 'PUT', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(body), + }, + ) +} + +export async function clearSessionGoal(sessionId: string): Promise<{ goal: SessionGoal | null }> { + return requestJSON<{ goal: SessionGoal | null }>( + `/v1/admin/sessions/${encodeURIComponent(sessionId)}/goal`, + { method: 'DELETE' }, + ) +} + +export async function getSessionCritic( + sessionId: string, +): Promise<{ critic: SessionCritic | null }> { + return requestJSON<{ critic: SessionCritic | null }>( + `/v1/admin/sessions/${encodeURIComponent(sessionId)}/critic`, + ) +} + +export async function setSessionCritic( + sessionId: string, + enabled: boolean, + maxIterations?: number, +): Promise<{ critic: SessionCritic | null }> { + const body: Record = { enabled } + if (typeof maxIterations === 'number' && maxIterations > 0) { + body.max_iterations = maxIterations + } + return requestJSON<{ critic: SessionCritic | null }>( + `/v1/admin/sessions/${encodeURIComponent(sessionId)}/critic`, + { + method: 'PUT', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(body), + }, + ) +} + +export async function clearSessionCritic( + sessionId: string, +): Promise<{ critic: SessionCritic | null }> { + return requestJSON<{ critic: SessionCritic | null }>( + `/v1/admin/sessions/${encodeURIComponent(sessionId)}/critic`, + { method: 'DELETE' }, + ) +} + +export async function getSessionEffectiveConfig(sessionId: string): Promise { + return requestJSON( + `/v1/admin/sessions/${encodeURIComponent(sessionId)}/effective-config`, + ) +} + +// --- Session Config --- + +export type SessionToolConfig = { + tools_enabled?: string[] + tools_custom?: boolean + tools_disabled?: string[] + tools_allow_groups?: string[] + tools_deny_groups?: string[] + skills_enabled?: string[] + skills_custom?: boolean + commands_enabled?: string[] + commands_custom?: boolean + mcp_enabled?: string[] + mcp_custom?: boolean +} + +export async function getSessionConfig(sessionId: string): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/config`) +} + +export async function updateSessionConfig(sessionId: string, config: SessionToolConfig): Promise { + await requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/config`, { + method: 'PATCH', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(config), + }) +} + +export async function updateSessionLocalConfig( + sessionId: string, + config: SessionToolConfig, +): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/local-config`, { + method: 'PATCH', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(config), + }) +} + +export async function getSessionAutomationConsent(sessionId: string): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/automation-consent`) +} + +export async function updateSessionAutomationConsent( + sessionId: string, + consent: SessionAutomationConsent, +): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/automation-consent`, { + method: 'PATCH', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(consent), + }) +} + +export async function getSessionStyle(sessionId: string): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/style`) +} + +export async function updateSessionStyle( + sessionId: string, + style: SessionStyleControl, +): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/style`, { + method: 'PATCH', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(style), + }) +} + +export async function listSessionLocalSkills(sessionId: string): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/local-skills`) +} + +export async function promoteSessionLocalSkills( + sessionId: string, + payload: SessionLocalSkillPromoteRequest, +): Promise { + return requestJSON( + `/v1/admin/sessions/${encodeURIComponent(sessionId)}/local-skills/promote`, + { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + }, + ) +} + +// --- Terminal (session cwd control) --- + +export type OpenTerminalResult = { + ok: boolean + cwd: string + app: string + message?: string +} + +export async function openTerminalHere(sessionId: string, cwd?: string): Promise { + return requestJSON('/v1/terminal/open', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ session_id: sessionId, cwd: cwd || '' }), + }) +} + +export function terminalWebSocketURL(sessionId: string, cwd?: string, cols = 80, rows = 24): string { + const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:' + const params = new URLSearchParams({ + session_id: sessionId, + cols: String(cols), + rows: String(rows), + }) + if (cwd) params.set('cwd', cwd) + return `${protocol}//${window.location.host}/v1/terminal/ws?${params}` +} diff --git a/frontend/console/src/lib/api/system.ts b/frontend/console/src/lib/api/system.ts new file mode 100644 index 00000000..c267c20c --- /dev/null +++ b/frontend/console/src/lib/api/system.ts @@ -0,0 +1,98 @@ +import { requestJSON } from './client.ts' +import type { + AnalyticsResponse, + AuthLoginRequest, + AuthPairingLoginRequest, + AuthWhoamiResponse, + CodexUsageResponse, + EventsHistoryInfo, + HealthzResponse, + LogsResponse, + SetupStatusResponse, + UsageToday, +} from '../types' + +export async function getHealthz(): Promise { + return requestJSON('/v1/healthz') +} + +export async function getSetupStatus(): Promise { + return requestJSON('/v1/setup/status') +} + +export async function getServerStatus(): Promise<{ version: string }> { + return requestJSON<{ version: string }>('/v1/status') +} + +export async function getAuthWhoami(): Promise { + return requestJSON('/v1/auth/whoami') +} + +export async function loginAuth(payload: AuthLoginRequest): Promise { + return requestJSON('/v1/auth/login', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + }) +} + +export async function loginWithPairingCode(payload: AuthPairingLoginRequest): Promise { + return requestJSON('/v1/auth/pairing-login', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + }) +} + +export async function logoutAuth(): Promise { + await requestJSON<{ ok: boolean }>('/v1/auth/logout', { method: 'POST' }) +} + +export async function changeBrowserPassword(role: 'admin' | 'user', payload: { current_password?: string; new_password: string }): Promise { + await requestJSON<{ ok: boolean }>(`/v1/auth/users/${encodeURIComponent(role)}/password`, { + method: 'PATCH', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + }) +} + +export async function getTodayUsage(): Promise { + return requestJSON('/v1/admin/usage/today') +} + +export async function getCodexUsage(): Promise { + return requestJSON('/v1/admin/llm/codex/usage') +} + +export type LogsQuery = { + file?: string + level?: string + component?: string + lines?: number +} + +export async function getLogs(query: LogsQuery = {}): Promise { + const params = new URLSearchParams() + if (query.file?.trim()) params.set('file', query.file.trim()) + if (query.level?.trim()) params.set('level', query.level.trim()) + if (query.component?.trim()) params.set('component', query.component.trim()) + if (query.lines && Number.isFinite(query.lines)) params.set('lines', String(query.lines)) + const suffix = params.toString() + return requestJSON(`/v1/admin/logs${suffix ? `?${suffix}` : ''}`) +} + +export async function getAnalytics(days = 7): Promise { + return requestJSON(`/v1/admin/analytics?days=${days}`) +} + +export async function getEventsHistory(limit = 30): Promise { + return requestJSON(`/v1/events/history?limit=${limit}`) +} + +export async function markEventsRead(lastId: number): Promise<{ unread_count: number }> { + return requestJSON<{ acknowledged: boolean; read_cursor: number; unread_count: number }>('/v1/events/read', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ last_id: lastId }), + }) +} diff --git a/frontend/console/src/lib/api/tasks.ts b/frontend/console/src/lib/api/tasks.ts new file mode 100644 index 00000000..f3c5ff0c --- /dev/null +++ b/frontend/console/src/lib/api/tasks.ts @@ -0,0 +1,119 @@ +import { requestJSON } from './client.ts' +import { normalizeGlobalPlans, normalizePlanArchive, normalizeSessionTasks } from './normalize.ts' +import type { + GlobalPlansResponse, + PlanArchiveResponse, + SessionTasks, + TaskVerificationResponse, + WorkLedgerEvent, + WorkLedgerProjection, + WorkLedgerWork, + WorkLedgerWorksResponse, +} from '../types' + +export async function getSessionTasks(sessionId: string): Promise { + const data = await requestJSON>(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/tasks`) + return normalizeSessionTasks(data) +} + +export async function getSessionWorkLedger(sessionId: string): Promise { + for (const source of ['session', 'legacy-session']) { + const params = new URLSearchParams({ + source, + source_id: sessionId, + limit: '1', + }) + const data = await requestJSON(`/v1/work/works?${params.toString()}`) + if (data.works[0]) return data.works[0] + } + return null +} + +export async function getWorkLedgerTimeline(workId: string): Promise { + return requestJSON(`/v1/work/works/${encodeURIComponent(workId)}/timeline`) +} + +export async function cancelWorkLedger(workId: string, reason: string): Promise { + return requestJSON(`/v1/admin/work/works/${encodeURIComponent(workId)}/cancel`, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ reason }), + }) +} + +export async function resumeWorkLedgerStep(workId: string, stepId: string, reason: string): Promise { + return requestJSON( + `/v1/admin/work/works/${encodeURIComponent(workId)}/steps/${encodeURIComponent(stepId)}/resume`, + { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ reason }), + }, + ) +} + +export function watchWorkLedger( + workId: string, + afterSequence: number, + onEvent: (event: WorkLedgerEvent) => void, + onError?: () => void, +): () => void { + const params = new URLSearchParams({ after_sequence: String(Math.max(0, afterSequence)) }) + const stream = new EventSource( + `/v1/work/works/${encodeURIComponent(workId)}/watch?${params.toString()}`, + { withCredentials: true }, + ) + stream.addEventListener('work_event', (message) => { + if (!(message instanceof MessageEvent) || !message.data) return + try { + onEvent(JSON.parse(message.data) as WorkLedgerEvent) + } catch { + onError?.() + } + }) + stream.onerror = () => onError?.() + return () => stream.close() +} + +export async function getGlobalPlans(active = true): Promise { + const endpoint = active ? '/v1/admin/tasks?active=true' : '/v1/admin/tasks?active=false' + const data = await requestJSON>(endpoint) + return normalizeGlobalPlans(data) +} + +export async function getPlanArchive(limit = 50): Promise { + const data = await requestJSON>(`/v1/admin/plans/archive?limit=${limit}`) + return normalizePlanArchive(data) +} + +export async function getSessionPlanArchive(sessionId: string, limit = 20): Promise { + const data = await requestJSON>( + `/v1/admin/sessions/${encodeURIComponent(sessionId)}/plans/archive?limit=${limit}`, + ) + return normalizePlanArchive(data) +} + +// executeTasksAction drives the plan state machine directly from the +// console — used by the TasksPanel CTA buttons (Approve / Discard / Save +// edits). The body shape mirrors the chat-side `tasks` tool action. +export async function executeTasksAction( + sessionId: string, + payload: Record, +): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/tasks`, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + }) +} + +export async function runTaskVerification( + sessionId: string, + payload: { task_id?: string; timeout_ms?: number } = {}, +): Promise { + return requestJSON(`/v1/admin/sessions/${encodeURIComponent(sessionId)}/tasks/verify`, { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify(payload), + }) +} diff --git a/frontend/console/src/lib/api/workspace.ts b/frontend/console/src/lib/api/workspace.ts new file mode 100644 index 00000000..d60542a7 --- /dev/null +++ b/frontend/console/src/lib/api/workspace.ts @@ -0,0 +1,93 @@ +import { requestJSON } from './client.ts' + +// --- Workspace Files --- + +export type WorkspaceFileEntry = { + name: string + path: string + is_dir: boolean + size?: number + updated_at?: string +} + +export type WorkspaceFileContent = { + path: string + name: string + size: number + updated_at: string + kind: 'text' | 'markdown' | 'image' | 'binary' + mime_type: string + encoding?: 'utf-8' | 'base64' + content?: string + content_base64?: string + truncated?: boolean + is_binary?: boolean + message?: string +} + +function workspaceFilesEndpoint(root?: string): string { + return root ? '/v1/filesystem/files' : '/v1/workspace/files' +} + +export async function listWorkspaceFiles(path = '.', root?: string): Promise<{ path: string; files: WorkspaceFileEntry[] }> { + const params = new URLSearchParams({ path }) + if (root) params.set('root', root) + return requestJSON<{ path: string; files: WorkspaceFileEntry[] }>( + `${workspaceFilesEndpoint(root)}?${params}` + ) +} + +export async function readWorkspaceFile(path: string, root?: string): Promise { + const params = new URLSearchParams({ path }) + if (root) params.set('root', root) + return requestJSON( + `${workspaceFilesEndpoint(root)}?${params}` + ) +} + +export async function createWorkspaceDirectory(parentPath: string, name: string, root?: string): Promise<{ path: string; name: string; is_dir: boolean }> { + const params = new URLSearchParams() + if (root) params.set('root', root) + return requestJSON<{ path: string; name: string; is_dir: boolean }>( + `${workspaceFilesEndpoint(root)}?${params}`, + { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ parent_path: parentPath, name }), + }, + ) +} + +export async function renameWorkspaceDirectory(path: string, newName: string, root?: string): Promise<{ path: string; name: string; is_dir: boolean }> { + const params = new URLSearchParams() + if (root) params.set('root', root) + return requestJSON<{ path: string; name: string; is_dir: boolean }>( + `${workspaceFilesEndpoint(root)}?${params}`, + { + method: 'PATCH', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ path, new_name: newName }), + }, + ) +} + +// --- Filesystem --- + +export type FilesystemBrowseResult = { + path: string + parent: string + entries: { name: string; is_dir: boolean; is_git?: boolean }[] +} + +export async function browseFilesystem(path?: string): Promise { + const params = path ? `?path=${encodeURIComponent(path)}` : '' + return requestJSON(`/v1/filesystem/browse${params}`) +} + +export async function createFilesystemDirectory(parentPath: string, name: string): Promise<{ path: string; name: string; is_dir: boolean }> { + return requestJSON('/v1/filesystem/browse', { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ parent_path: parentPath, name }), + }) +} diff --git a/frontend/console/tests/agentRuntimeRunView.test.ts b/frontend/console/tests/agentRuntimeRunView.test.ts index 23f7fd57..96dd2bab 100644 --- a/frontend/console/tests/agentRuntimeRunView.test.ts +++ b/frontend/console/tests/agentRuntimeRunView.test.ts @@ -3,7 +3,7 @@ import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' const source = readFileSync(new URL('../src/components/AgentRuntimeRunView.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/agentruntime.ts', import.meta.url), 'utf8') const costFlowSource = readFileSync(new URL('../src/components/AgentRuntimeCostFlow.svelte', import.meta.url), 'utf8') const replaySource = readFileSync(new URL('../src/components/AgentRuntimeReplay.svelte', import.meta.url), 'utf8') const flowGraphSource = readFileSync(new URL('../src/components/AgentRuntimeFlowGraph.svelte', import.meta.url), 'utf8') diff --git a/frontend/console/tests/analyticsPage.test.ts b/frontend/console/tests/analyticsPage.test.ts index b5dd4d9d..e1f6c849 100644 --- a/frontend/console/tests/analyticsPage.test.ts +++ b/frontend/console/tests/analyticsPage.test.ts @@ -5,7 +5,7 @@ import { readFileSync } from 'node:fs' import { resolveRoute } from '../src/lib/router.ts' const appSource = readFileSync(new URL('../src/App.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/system.ts', import.meta.url), 'utf8') const navSource = readFileSync(new URL('../src/components/Nav.svelte', import.meta.url), 'utf8') const analyticsSource = readFileSync(new URL('../src/components/Analytics.svelte', import.meta.url), 'utf8') const routeComponentsSource = readFileSync(new URL('../src/lib/routeComponents.ts', import.meta.url), 'utf8') diff --git a/frontend/console/tests/contractPanel.test.ts b/frontend/console/tests/contractPanel.test.ts index 9bfa7948..fcd8e71c 100644 --- a/frontend/console/tests/contractPanel.test.ts +++ b/frontend/console/tests/contractPanel.test.ts @@ -4,7 +4,8 @@ import { readFileSync } from 'node:fs' const chatSource = readFileSync(new URL('../src/components/Chat.svelte', import.meta.url), 'utf8') const tasksPanelSource = readFileSync(new URL('../src/components/TasksPanel.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/tasks.ts', import.meta.url), 'utf8') +const apiNormalizeSource = readFileSync(new URL('../src/lib/api/normalize.ts', import.meta.url), 'utf8') const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') test('Chat mounts the task contract inside the tasks dock panel', () => { @@ -16,7 +17,7 @@ test('Chat mounts the task contract inside the tasks dock panel', () => { test('Tasks panel edits, approves, and verifies the active session contract', () => { assert.match(typesSource, /TaskContract/) assert.match(typesSource, /contract\?: TaskContract/) - assert.match(apiSource, /contract: normalizeTaskContract/) + assert.match(apiNormalizeSource, /contract: normalizeTaskContract/) assert.match(apiSource, /runTaskVerification/) assert.match(tasksPanelSource, /getSessionTasks/) assert.match(tasksPanelSource, /executeTasksAction/) diff --git a/frontend/console/tests/extensionsPluginPolicy.test.ts b/frontend/console/tests/extensionsPluginPolicy.test.ts index 36c1fc83..d56ac5a9 100644 --- a/frontend/console/tests/extensionsPluginPolicy.test.ts +++ b/frontend/console/tests/extensionsPluginPolicy.test.ts @@ -3,7 +3,7 @@ import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' const source = readFileSync(new URL('../src/components/Extensions.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/extensions.ts', import.meta.url), 'utf8') const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') test('Extensions page removes legacy plugin management surfaces', () => { diff --git a/frontend/console/tests/extensionsSkillSandbox.test.ts b/frontend/console/tests/extensionsSkillSandbox.test.ts index 677279a3..b692f303 100644 --- a/frontend/console/tests/extensionsSkillSandbox.test.ts +++ b/frontend/console/tests/extensionsSkillSandbox.test.ts @@ -2,7 +2,8 @@ import test from 'node:test' import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/extensions.ts', import.meta.url), 'utf8') +const apiClientSource = readFileSync(new URL('../src/lib/api/client.ts', import.meta.url), 'utf8') const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') const extensionsSource = readFileSync(new URL('../src/components/Extensions.svelte', import.meta.url), 'utf8') @@ -15,9 +16,9 @@ test('Hub install API returns extension sandbox reports', () => { }) test('API errors preserve sandbox report payloads for failed installs', () => { - assert.match(apiSource, /export class APIRequestError extends Error/) - assert.match(apiSource, /sandbox_report/) - assert.match(apiSource, /throw new APIRequestError/) + assert.match(apiClientSource, /export class APIRequestError extends Error/) + assert.match(apiClientSource, /sandbox_report/) + assert.match(apiClientSource, /throw new APIRequestError/) }) test('Extensions renders the latest extension sandbox report', () => { diff --git a/frontend/console/tests/gitInspector.test.ts b/frontend/console/tests/gitInspector.test.ts index c7427deb..3c09c4cf 100644 --- a/frontend/console/tests/gitInspector.test.ts +++ b/frontend/console/tests/gitInspector.test.ts @@ -3,7 +3,7 @@ import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' const chatSource = readFileSync(new URL('../src/components/Chat.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/git.ts', import.meta.url), 'utf8') const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') const gitInspectorSource = readFileSync(new URL('../src/components/GitInspector.svelte', import.meta.url), 'utf8') diff --git a/frontend/console/tests/gitInspectorMutations.test.ts b/frontend/console/tests/gitInspectorMutations.test.ts index e3284d46..25242423 100644 --- a/frontend/console/tests/gitInspectorMutations.test.ts +++ b/frontend/console/tests/gitInspectorMutations.test.ts @@ -2,7 +2,7 @@ import test from 'node:test' import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/git.ts', import.meta.url), 'utf8') const inspectorSource = readFileSync(new URL('../src/components/GitInspector.svelte', import.meta.url), 'utf8') const opsSource = readFileSync(new URL('../src/components/Ops.svelte', import.meta.url), 'utf8') const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') diff --git a/frontend/console/tests/headerBudgetIndicator.test.ts b/frontend/console/tests/headerBudgetIndicator.test.ts index 4ddcda26..fc1b5506 100644 --- a/frontend/console/tests/headerBudgetIndicator.test.ts +++ b/frontend/console/tests/headerBudgetIndicator.test.ts @@ -7,7 +7,7 @@ import { ko } from '../src/i18n/ko.ts' const headerSource = readFileSync(new URL('../src/components/Header.svelte', import.meta.url), 'utf8') const shellSource = readFileSync(new URL('../src/components/Shell.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/system.ts', import.meta.url), 'utf8') const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') test('Header renders a daily token budget chip backed by the usage today API', () => { diff --git a/frontend/console/tests/logsPage.test.ts b/frontend/console/tests/logsPage.test.ts index 6980eaf4..29cf4635 100644 --- a/frontend/console/tests/logsPage.test.ts +++ b/frontend/console/tests/logsPage.test.ts @@ -5,7 +5,7 @@ import { readFileSync } from 'node:fs' import { resolveRoute } from '../src/lib/router.ts' const appSource = readFileSync(new URL('../src/App.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/system.ts', import.meta.url), 'utf8') const navSource = readFileSync(new URL('../src/components/Nav.svelte', import.meta.url), 'utf8') const logsSource = readFileSync(new URL('../src/components/Logs.svelte', import.meta.url), 'utf8') const routeComponentsSource = readFileSync(new URL('../src/lib/routeComponents.ts', import.meta.url), 'utf8') diff --git a/frontend/console/tests/mcpServerCreator.test.ts b/frontend/console/tests/mcpServerCreator.test.ts index b13368ed..c1b9901e 100644 --- a/frontend/console/tests/mcpServerCreator.test.ts +++ b/frontend/console/tests/mcpServerCreator.test.ts @@ -3,7 +3,7 @@ import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' const extensionsSource = readFileSync(new URL('../src/components/Extensions.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/extensions.ts', import.meta.url), 'utf8') test('Extensions wires an MCP Server Creator wizard into the MCP section', () => { assert.match(extensionsSource, /import MCPServerCreator from '\.\/MCPServerCreator\.svelte'/) diff --git a/frontend/console/tests/memoryAssetMetadata.test.ts b/frontend/console/tests/memoryAssetMetadata.test.ts index 7ed15b82..46e5bfdd 100644 --- a/frontend/console/tests/memoryAssetMetadata.test.ts +++ b/frontend/console/tests/memoryAssetMetadata.test.ts @@ -10,7 +10,7 @@ import { en } from '../src/i18n/en.ts' import type { MemoryAsset } from '../src/lib/types.ts' const memorySource = readFileSync(new URL('../src/components/MemoryCenter.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/memory.ts', import.meta.url), 'utf8') const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') function asset(partial: Partial): MemoryAsset { diff --git a/frontend/console/tests/opsApprovalsFocus.test.ts b/frontend/console/tests/opsApprovalsFocus.test.ts index ccd795db..37f86484 100644 --- a/frontend/console/tests/opsApprovalsFocus.test.ts +++ b/frontend/console/tests/opsApprovalsFocus.test.ts @@ -5,7 +5,7 @@ import { readFileSync } from 'node:fs' import { en } from '../src/i18n/en.ts' const opsSource = readFileSync(new URL('../src/components/Ops.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/ops.ts', import.meta.url), 'utf8') const navSource = readFileSync(new URL('../src/components/Nav.svelte', import.meta.url), 'utf8') const routerSource = readFileSync(new URL('../src/lib/router.ts', import.meta.url), 'utf8') const appSource = readFileSync(new URL('../src/App.svelte', import.meta.url), 'utf8') diff --git a/frontend/console/tests/plansPage.test.ts b/frontend/console/tests/plansPage.test.ts index f34d6da2..4569918b 100644 --- a/frontend/console/tests/plansPage.test.ts +++ b/frontend/console/tests/plansPage.test.ts @@ -12,7 +12,7 @@ import { const appSource = readFileSync(new URL('../src/App.svelte', import.meta.url), 'utf8') const routeComponentsSource = readFileSync(new URL('../src/lib/routeComponents.ts', import.meta.url), 'utf8') const navSource = readFileSync(new URL('../src/components/Nav.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/tasks.ts', import.meta.url), 'utf8') const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') const enSource = readFileSync(new URL('../src/i18n/en.ts', import.meta.url), 'utf8') const koSource = readFileSync(new URL('../src/i18n/ko.ts', import.meta.url), 'utf8') diff --git a/frontend/console/tests/priorContextPanel.test.ts b/frontend/console/tests/priorContextPanel.test.ts index 55c29b46..b24a780f 100644 --- a/frontend/console/tests/priorContextPanel.test.ts +++ b/frontend/console/tests/priorContextPanel.test.ts @@ -4,7 +4,7 @@ import { readFileSync } from 'node:fs' const chatSource = readFileSync(new URL('../src/components/Chat.svelte', import.meta.url), 'utf8') const chatPanelSource = readFileSync(new URL('../src/components/ChatPanel.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/chat.ts', import.meta.url), 'utf8') const panelSource = readFileSync(new URL('../src/components/PriorContextPanel.svelte', import.meta.url), 'utf8') test('Chat surface exposes a Prior Context side panel wired to the draft message', () => { diff --git a/frontend/console/tests/quickStartFields.test.ts b/frontend/console/tests/quickStartFields.test.ts index 9ad0a005..a98447d0 100644 --- a/frontend/console/tests/quickStartFields.test.ts +++ b/frontend/console/tests/quickStartFields.test.ts @@ -10,7 +10,7 @@ import { import type { ConfigFieldMeta } from '../src/lib/types.ts' const configSource = readFileSync(new URL('../src/components/Config.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/config.ts', import.meta.url), 'utf8') function field(key: string, label = key, type = 'string'): ConfigFieldMeta { return { diff --git a/frontend/console/tests/sessionAICleanup.test.ts b/frontend/console/tests/sessionAICleanup.test.ts index 1551a614..042a86d4 100644 --- a/frontend/console/tests/sessionAICleanup.test.ts +++ b/frontend/console/tests/sessionAICleanup.test.ts @@ -3,7 +3,7 @@ import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' const sidebarSource = readFileSync(new URL('../src/components/SessionSidebar.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/sessions.ts', import.meta.url), 'utf8') const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') test('session cleanup API exposes AI archive and delete suggestion modes', () => { diff --git a/frontend/console/tests/sessionAutomationConsent.test.ts b/frontend/console/tests/sessionAutomationConsent.test.ts index a9accae1..e25fdd80 100644 --- a/frontend/console/tests/sessionAutomationConsent.test.ts +++ b/frontend/console/tests/sessionAutomationConsent.test.ts @@ -2,7 +2,7 @@ import test from 'node:test' import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/sessions.ts', import.meta.url), 'utf8') const panelSource = readFileSync(new URL('../src/components/SessionConfigPanel.svelte', import.meta.url), 'utf8') const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') diff --git a/frontend/console/tests/sessionHealth.test.ts b/frontend/console/tests/sessionHealth.test.ts index 08c42099..f1e4e71c 100644 --- a/frontend/console/tests/sessionHealth.test.ts +++ b/frontend/console/tests/sessionHealth.test.ts @@ -2,7 +2,8 @@ import test from 'node:test' import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' import { buildSessionHealthReport } from '../src/lib/sessionHealth.ts' -import type { ChatToolInfo, SessionToolConfig } from '../src/lib/api.ts' +import type { ChatToolInfo } from '../src/lib/api/chat.ts' +import type { SessionToolConfig } from '../src/lib/api/sessions.ts' import type { Session, SessionMessage, SessionTasks } from '../src/lib/types.ts' const chatSource = readFileSync(new URL('../src/components/Chat.svelte', import.meta.url), 'utf8') diff --git a/frontend/console/tests/sessionLineageGraph.test.ts b/frontend/console/tests/sessionLineageGraph.test.ts index 4f13d83c..fb390527 100644 --- a/frontend/console/tests/sessionLineageGraph.test.ts +++ b/frontend/console/tests/sessionLineageGraph.test.ts @@ -86,7 +86,7 @@ test('session lineage graph page loads sessions, parent history previews, and ch }) test('session lineage graph exposes fork insight promotion controls', () => { - const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') + const apiSource = readFileSync(new URL('../src/lib/api/sessions.ts', import.meta.url), 'utf8') const i18nEnSource = readFileSync(new URL('../src/i18n/en.ts', import.meta.url), 'utf8') assert.match(apiSource, /getForkPromotions/) diff --git a/frontend/console/tests/sessionPermissionPreview.test.ts b/frontend/console/tests/sessionPermissionPreview.test.ts index 5958c750..8849ceff 100644 --- a/frontend/console/tests/sessionPermissionPreview.test.ts +++ b/frontend/console/tests/sessionPermissionPreview.test.ts @@ -1,7 +1,8 @@ import test from 'node:test' import assert from 'node:assert/strict' import { buildSessionPermissionPreview } from '../src/lib/sessionPermissionPreview.ts' -import type { ChatToolInfo, SessionToolConfig } from '../src/lib/api.ts' +import type { ChatToolInfo } from '../src/lib/api/chat.ts' +import type { SessionToolConfig } from '../src/lib/api/sessions.ts' const tools: ChatToolInfo[] = [ { name: 'read_file', description: 'read files', high_risk: false, group: 'files' }, diff --git a/frontend/console/tests/sessionStyleControl.test.ts b/frontend/console/tests/sessionStyleControl.test.ts index 5b0be51a..12046166 100644 --- a/frontend/console/tests/sessionStyleControl.test.ts +++ b/frontend/console/tests/sessionStyleControl.test.ts @@ -5,7 +5,7 @@ import { readFileSync } from 'node:fs' import { buildSessionStylePreview, sessionStylePayload } from '../src/lib/sessionStyle.ts' const panelSource = readFileSync(new URL('../src/components/SessionConfigPanel.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/sessions.ts', import.meta.url), 'utf8') const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') test('session style preview describes behavioral axes and consent limits', () => { diff --git a/frontend/console/tests/sessionTranscriptSearch.test.ts b/frontend/console/tests/sessionTranscriptSearch.test.ts index 5c86a085..e68e9c3b 100644 --- a/frontend/console/tests/sessionTranscriptSearch.test.ts +++ b/frontend/console/tests/sessionTranscriptSearch.test.ts @@ -5,7 +5,7 @@ import { readFileSync } from 'node:fs' const sessionsSource = readFileSync(new URL('../src/components/Sessions.svelte', import.meta.url), 'utf8') const sessionSidebarSource = readFileSync(new URL('../src/components/SessionSidebar.svelte', import.meta.url), 'utf8') const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/sessions.ts', import.meta.url), 'utf8') const chatMessagesSource = readFileSync(new URL('../src/lib/chatMessages.ts', import.meta.url), 'utf8') const chatPanelSource = readFileSync(new URL('../src/components/ChatPanel.svelte', import.meta.url), 'utf8') const chatMessageItemSource = readFileSync(new URL('../src/components/ChatMessageItem.svelte', import.meta.url), 'utf8') diff --git a/frontend/console/tests/skillCreator.test.ts b/frontend/console/tests/skillCreator.test.ts index 0e1442c2..e3e783fc 100644 --- a/frontend/console/tests/skillCreator.test.ts +++ b/frontend/console/tests/skillCreator.test.ts @@ -3,7 +3,7 @@ import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' const extensionsSource = readFileSync(new URL('../src/components/Extensions.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/extensions.ts', import.meta.url), 'utf8') test('Extensions wires a Skill Creator wizard into the installed Skills section', () => { assert.match(extensionsSource, /import SkillCreator from '\.\/SkillCreator\.svelte'/) diff --git a/frontend/console/tests/skillExtractionInbox.test.ts b/frontend/console/tests/skillExtractionInbox.test.ts index 304a11b4..abdcddbb 100644 --- a/frontend/console/tests/skillExtractionInbox.test.ts +++ b/frontend/console/tests/skillExtractionInbox.test.ts @@ -2,7 +2,7 @@ import test from 'node:test' import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/extensions.ts', import.meta.url), 'utf8') const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') const panelSource = readFileSync(new URL('../src/components/SkillExtractionPanel.svelte', import.meta.url), 'utf8') const chatSource = readFileSync(new URL('../src/components/Chat.svelte', import.meta.url), 'utf8') diff --git a/frontend/console/tests/syspromptImpactPreview.test.ts b/frontend/console/tests/syspromptImpactPreview.test.ts index c6b139fc..a76285d5 100644 --- a/frontend/console/tests/syspromptImpactPreview.test.ts +++ b/frontend/console/tests/syspromptImpactPreview.test.ts @@ -3,7 +3,7 @@ import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' const syspromptSource = readFileSync(new URL('../src/components/SyspromptCenter.svelte', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/memory.ts', import.meta.url), 'utf8') const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') test('System Prompt page surfaces prompt impact metadata and reloadable preview', () => { diff --git a/frontend/console/tests/taskEvidence.test.ts b/frontend/console/tests/taskEvidence.test.ts index f431e7f6..8d3bda24 100644 --- a/frontend/console/tests/taskEvidence.test.ts +++ b/frontend/console/tests/taskEvidence.test.ts @@ -3,7 +3,7 @@ import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/normalize.ts', import.meta.url), 'utf8') const tasksPanelSource = readFileSync(new URL('../src/components/TasksPanel.svelte', import.meta.url), 'utf8') test('task evidence is typed, normalized, and rendered in task surfaces', () => { diff --git a/frontend/console/tests/tasksArchive.test.ts b/frontend/console/tests/tasksArchive.test.ts index e66ffbde..5a3f697c 100644 --- a/frontend/console/tests/tasksArchive.test.ts +++ b/frontend/console/tests/tasksArchive.test.ts @@ -2,7 +2,7 @@ import test from 'node:test' import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/tasks.ts', import.meta.url), 'utf8') const typesSource = readFileSync(new URL('../src/lib/types.ts', import.meta.url), 'utf8') const tasksPanelSource = readFileSync(new URL('../src/components/TasksPanel.svelte', import.meta.url), 'utf8') const enSource = readFileSync(new URL('../src/i18n/en.ts', import.meta.url), 'utf8') diff --git a/frontend/console/tests/workLedgerTimeline.test.ts b/frontend/console/tests/workLedgerTimeline.test.ts index cbac0d79..6cfb73b2 100644 --- a/frontend/console/tests/workLedgerTimeline.test.ts +++ b/frontend/console/tests/workLedgerTimeline.test.ts @@ -8,10 +8,10 @@ import { resumableWorkLedgerSteps, workLedgerCanCancel, } from '../src/lib/workLedger.ts' -import { cancelWorkLedger, getSessionWorkLedger, resumeWorkLedgerStep } from '../src/lib/api.ts' +import { cancelWorkLedger, getSessionWorkLedger, resumeWorkLedgerStep } from '../src/lib/api/tasks.ts' import type { WorkLedgerProjection } from '../src/lib/types.ts' -const apiSource = readFileSync(new URL('../src/lib/api.ts', import.meta.url), 'utf8') +const apiSource = readFileSync(new URL('../src/lib/api/tasks.ts', import.meta.url), 'utf8') const tasksPanelSource = readFileSync(new URL('../src/components/TasksPanel.svelte', import.meta.url), 'utf8') test('work ledger timeline orders durable events and exposes operator labels', () => { diff --git a/frontend/console/tests/workerControlPlane.test.ts b/frontend/console/tests/workerControlPlane.test.ts index 12c0b617..0a67dd9c 100644 --- a/frontend/console/tests/workerControlPlane.test.ts +++ b/frontend/console/tests/workerControlPlane.test.ts @@ -2,7 +2,7 @@ import test from 'node:test' import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' -import { getWorkerControlPlane } from '../src/lib/api.ts' +import { getWorkerControlPlane } from '../src/lib/api/ops.ts' import { controlEventPresentation, placementStateBadge, diff --git a/frontend/console/tsconfig.app.json b/frontend/console/tsconfig.app.json index acfd2e5b..07c168bb 100644 --- a/frontend/console/tsconfig.app.json +++ b/frontend/console/tsconfig.app.json @@ -7,6 +7,7 @@ "module": "ESNext", "types": ["svelte", "vite/client"], "noEmit": true, + "allowImportingTsExtensions": true, /** * Typecheck JS in `.svelte` and `.js` files by default. * Disable checkJs if you'd like to use dynamic types in JS. From 9097ed4d40c9a6cd8a0503a89ecbebfe5ca2814b Mon Sep 17 00:00:00 2001 From: devlikebear Date: Mon, 24 Aug 2026 10:29:14 +0900 Subject: [PATCH 5/5] refactor(console): record CLI deprecation candidates and orphan-route findings Part of #919. Refs #931. Steps 5-7: shared-form-primitive extraction documented as follow-up; five CLI command groups marked as deprecation candidates (analysis only, nothing removed); PUT /v1/admin/config and GET /v1/providers noted as console-orphaned but retained API routes. --- frontend/console/DESIGN.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/frontend/console/DESIGN.md b/frontend/console/DESIGN.md index d01d3776..62be7e9e 100644 --- a/frontend/console/DESIGN.md +++ b/frontend/console/DESIGN.md @@ -295,6 +295,33 @@ Server schema exposes 165 fields (`internal/config/schema.go`) grouped into 15 s - All four heavyweight modal editors: generic JSON editor, LLM tier editor, LLM provider editor, embodiment provider preset editor. - Consequence table: `llm_providers` / `llm_tiers` → deep link to onboarding wizard sections (capability preserved). `embodiment_providers_json`, `llm_role_defaults`, `usage_price_overrides_json`, `mcp_servers_json`, `agentruntime_agents_json`, `agentruntime_task_override`, and every other `json`/`string_list` field → read-only summary plus documented YAML key (`config/tars.config.example.yaml`). If a dedicated UI for embodiment presets proves necessary later, it should be a follow-up issue scoped against this policy. +### Shared form primitives (#931 first cut: deferred) + +After narrowing, the remaining editors are the Quick Start card controls in `Config.svelte`, `SessionConfigPanel.svelte`, and the onboarding section components. Extracting shared primitives (`FormField`, `BoolToggleButton`, structured-row editors) across all three is a cross-cutting visual change that this first cut deliberately does not attempt — Playwright and manual walkthrough coverage for it is deferred. **Follow-up:** extract primitives once, then migrate the three surfaces in separate PRs with visual verification. + +### CLI deprecation candidates (#931 — analysis only, nothing removed) + +The 37 CLI subcommands overlap with console-only paths in a few places. Candidates marked for a future deprecation decision; each has a working replacement path today: + +| Command | Why candidate | Replacement path | +|---|---|---| +| `tars approve list / run / reject` | Mirrors Ops page approvals workflow one-to-one (`/v1/ops/approvals`) | Console Ops page | +| `tars cron list / get / runs / run` | Mirrors Cron page CRUD + run history (`/v1/cron/*`) | Console Cron page | +| `tars auth passwd` | Mirrors RemoteAccessCard password change (`PATCH /v1/auth/users/{role}/password`) | Console Remote Access card | +| `tars remote status / enable / disable / url` | Mirrors RemoteAccessCard Tailscale controls (`/v1/admin/remote-access/*`) | Console Remote Access card (CLI keeps `url` value for scripts) | +| `tars skill / plugin / mcp search · install · uninstall · update · info` | Hub operations duplicated by Extensions page (`/v1/hub/*`) | Console Extensions page | + +Keep-list rationale: `serve/service/status/health/doctor/init/version/worker/assistant/pack/reset/auth init|pairing-code` have no console equivalent or are needed when the console is unavailable (headless recovery, scripting, CI). Deprecation of any candidate above should be its own issue with an exit survey of scripts using them. + +### Orphaned-route check (#931 first cut) + +Endpoints the console stopped calling in this cut: + +- `PUT /v1/admin/config` (was YAML-tab save): no longer called from any component. Server route retained at `internal/tarsserver/main_serve_api.go`; reachable via HTTP API for scripts/tooling. No CLI equivalent exists (`tars serve --config-check` only validates). Follow-up candidate if it stays uncalled, not removed now. +- `GET /v1/providers` (was tier-editor provider metadata): no longer called from any component. Route retained; useful as a raw API for integrations. Same disposition. +- `PATCH /v1/admin/config/values`: still called (Quick Start saves). Unchanged. +- All other endpoints previously called by the console remain called; nothing was deleted server-side. + ## Colors The palette is rooted in deep neutrals, a single warm accent, and four semantic states.