@cat-factory/app 0.7.4 → 0.9.0

package/app/composables/api/models.ts

@@ -1,7 +1,6 @@
 import type {
   AddApiKeyInput,
   ApiKey,
-  ModelDefaults,
   ModelOption,
   PersonalSubscriptionStatus,
   ServiceFragmentDefaults,
@@ -16,6 +15,11 @@ import type {
   TestLocalModelEndpointInput,
   UpsertLocalModelEndpointInput,
 } from '~/types/localModels'
+import type {
+  OpenRouterCatalog,
+  OpenRouterRefreshResult,
+  UpsertOpenRouterCatalogInput,
+} from '~/types/openrouter'
 import type { ApiContext } from './context'
 
 /**
@@ -100,18 +104,18 @@ export function modelsApi({ http, ws }: ApiContext) {
         body,
       }),
 
-    // ---- per-agent-kind default models (workspace routing overrides) ------
-    // The workspace's map of agentKind → model id; a kind absent from the map
-    // falls back to the deployment's env routing. `setModelDefaults` replaces the
-    // whole map (the settings panel sends the full set on every change).
-    getModelDefaults: (workspaceId: string) =>
-      http<ModelDefaults>(`${ws(workspaceId)}/model-defaults`),
+    // ---- OpenRouter dynamic catalog (per-workspace gateway models) --------
+    // Browse OpenRouter's live catalog (`refresh`, leasing the workspace's pooled
+    // OpenRouter key server-side) and enable a subset; enabled models then surface
+    // in the per-workspace `/models` catalog with their context + price.
+    getOpenRouterCatalog: (workspaceId: string) =>
+      http<OpenRouterCatalog>(`${ws(workspaceId)}/openrouter/catalog`),
 
-    setModelDefaults: (workspaceId: string, defaults: Record<string, string>) =>
-      http<ModelDefaults>(`${ws(workspaceId)}/model-defaults`, {
-        method: 'PUT',
-        body: { defaults },
-      }),
+    setOpenRouterCatalog: (workspaceId: string, body: UpsertOpenRouterCatalogInput) =>
+      http<OpenRouterCatalog>(`${ws(workspaceId)}/openrouter/catalog`, { method: 'PUT', body }),
+
+    refreshOpenRouterCatalog: (workspaceId: string) =>
+      http<OpenRouterRefreshResult>(`${ws(workspaceId)}/openrouter/refresh`, { method: 'POST' }),
 
     // The workspace's default service-fragment selection (the fragment ids new
     // services inherit). `setServiceFragmentDefaults` replaces the whole list.

package/app/composables/api/presets.ts

@@ -3,9 +3,14 @@ import type {
   MergeThresholdPreset,
   UpdateMergePresetInput,
 } from '~/types/merge'
+import type {
+  CreateModelPresetInput,
+  ModelPreset,
+  UpdateModelPresetInput,
+} from '~/types/model-presets'
 import type { ApiContext } from './context'
 
-/** The per-workspace merge-threshold preset library (per-task auto-merge policy). */
+/** The per-workspace preset libraries: merge-threshold policy + model->agent mapping. */
 export function presetsApi({ http, ws }: ApiContext) {
   return {
     // ---- merge threshold presets (per-task auto-merge policy library) -----
@@ -25,5 +30,23 @@ export function presetsApi({ http, ws }: ApiContext) {
       http(`${ws(workspaceId)}/merge-presets/${encodeURIComponent(presetId)}`, {
         method: 'DELETE',
       }),
+
+    // ---- model presets (per-task model->agent mapping library) ------------
+    listModelPresets: (workspaceId: string) =>
+      http<ModelPreset[]>(`${ws(workspaceId)}/model-presets`),
+
+    createModelPreset: (workspaceId: string, body: CreateModelPresetInput) =>
+      http<ModelPreset>(`${ws(workspaceId)}/model-presets`, { method: 'POST', body }),
+
+    updateModelPreset: (workspaceId: string, presetId: string, body: UpdateModelPresetInput) =>
+      http<ModelPreset>(`${ws(workspaceId)}/model-presets/${encodeURIComponent(presetId)}`, {
+        method: 'PATCH',
+        body,
+      }),
+
+    deleteModelPreset: (workspaceId: string, presetId: string) =>
+      http(`${ws(workspaceId)}/model-presets/${encodeURIComponent(presetId)}`, {
+        method: 'DELETE',
+      }),
   }
 }

package/app/pages/index.vue

@@ -29,9 +29,12 @@ import MergeThresholdsPanel from '~/components/settings/MergeThresholdsPanel.vue
 import IssueTrackerWritebackPanel from '~/components/settings/IssueTrackerWritebackPanel.vue'
 import WorkspaceSettingsPanel from '~/components/settings/WorkspaceSettingsPanel.vue'
 import DatadogPanel from '~/components/settings/DatadogPanel.vue'
-import ModelDefaultsPanel from '~/components/settings/ModelDefaultsPanel.vue'
+import ModelConfigurationPanel from '~/components/settings/ModelConfigurationPanel.vue'
 import ServiceFragmentDefaultsPanel from '~/components/settings/ServiceFragmentDefaultsPanel.vue'
 import LocalModelEndpointsPanel from '~/components/settings/LocalModelEndpointsPanel.vue'
+import OpenRouterCatalogPanel from '~/components/settings/OpenRouterCatalogPanel.vue'
+import VendorCredentialsModal from '~/components/providers/VendorCredentialsModal.vue'
+import PersonalCredentialModal from '~/components/providers/PersonalCredentialModal.vue'
 
 const workspace = useWorkspaceStore()
 const github = useGitHubStore()
@@ -119,9 +122,12 @@ watch(
       <IssueTrackerWritebackPanel />
       <WorkspaceSettingsPanel />
       <DatadogPanel />
-      <ModelDefaultsPanel />
+      <ModelConfigurationPanel />
       <ServiceFragmentDefaultsPanel />
       <LocalModelEndpointsPanel />
+      <OpenRouterCatalogPanel />
+      <VendorCredentialsModal />
+      <PersonalCredentialModal />
     </template>
 
     <!-- Backend unreachable / bootstrap failed -->

package/app/stores/board.ts

@@ -77,6 +77,7 @@ export const useBoardStore = defineStore('board', () => {
       taskType?: CreateTaskType
       taskTypeFields?: TaskTypeFields
       mergePresetId?: string
+      modelPresetId?: string
       pipelineId?: string
       agentConfig?: Record<string, string>
     },
@@ -88,6 +89,7 @@ export const useBoardStore = defineStore('board', () => {
       ...(options?.taskType ? { taskType: options.taskType } : {}),
       ...(options?.taskTypeFields ? { taskTypeFields: options.taskTypeFields } : {}),
       ...(options?.mergePresetId ? { mergePresetId: options.mergePresetId } : {}),
+      ...(options?.modelPresetId ? { modelPresetId: options.modelPresetId } : {}),
       ...(options?.pipelineId ? { pipelineId: options.pipelineId } : {}),
       ...(options?.agentConfig ? { agentConfig: options.agentConfig } : {}),
     })

package/app/stores/modelPresets.ts

@@ -0,0 +1,65 @@
+import { defineStore } from 'pinia'
+import { computed, ref } from 'vue'
+import type {
+  CreateModelPresetInput,
+  ModelPreset,
+  UpdateModelPresetInput,
+} from '~/types/model-presets'
+import { useWorkspaceStore } from '~/stores/workspace'
+
+/**
+ * The workspace's model presets — the library a task picks its model→agent mapping
+ * from (each preset is a base model applied to every agent kind plus per-kind
+ * overrides). Hydrated from the workspace snapshot; managed via the Model Configuration
+ * settings screen. The backend always keeps at least one default preset (the built-in
+ * "Kimi K2.7", everything Kimi).
+ */
+export const useModelPresetsStore = defineStore('modelPresets', () => {
+  const api = useApi()
+
+  const presets = ref<ModelPreset[]>([])
+
+  function hydrate(list: ModelPreset[]) {
+    presets.value = [...list].sort((a, b) => a.createdAt - b.createdAt)
+  }
+
+  /** The workspace default (fallback for a task that picks none). */
+  const defaultPreset = computed(() => presets.value.find((p) => p.isDefault) ?? null)
+
+  /** Resolve a task's effective preset by id, falling back to the default. */
+  function resolve(presetId: string | undefined): ModelPreset | null {
+    if (presetId) {
+      const picked = presets.value.find((p) => p.id === presetId)
+      if (picked) return picked
+    }
+    return defaultPreset.value
+  }
+
+  /** The model id a preset assigns to an agent kind (`overrides[kind] ?? baseModelId`). */
+  function modelForKind(preset: ModelPreset | null, agentKind: string): string | undefined {
+    if (!preset) return undefined
+    return preset.overrides[agentKind] ?? preset.baseModelId
+  }
+
+  async function create(input: CreateModelPresetInput) {
+    const ws = useWorkspaceStore()
+    const created = await api.createModelPreset(ws.requireId(), input)
+    await ws.refresh()
+    return created
+  }
+
+  async function update(presetId: string, patch: UpdateModelPresetInput) {
+    const ws = useWorkspaceStore()
+    const updated = await api.updateModelPreset(ws.requireId(), presetId, patch)
+    await ws.refresh()
+    return updated
+  }
+
+  async function remove(presetId: string) {
+    const ws = useWorkspaceStore()
+    await api.deleteModelPreset(ws.requireId(), presetId)
+    await ws.refresh()
+  }
+
+  return { presets, defaultPreset, resolve, modelForKind, hydrate, create, update, remove }
+})

package/app/stores/openrouter.ts

@@ -0,0 +1,52 @@
+import { defineStore } from 'pinia'
+import { ref } from 'vue'
+import type { OpenRouterModelMeta, OpenRouterRefreshResult } from '~/types/openrouter'
+
+// The workspace's OpenRouter dynamic catalog: the enabled subset of OpenRouter's 300+
+// gateway models. `enabled` is what's persisted (and surfaced in the model picker);
+// `browse` is the live catalog from the last `refresh` (not persisted) the user picks from.
+// Scoped to the workspace (its key lives in the workspace API-key pool).
+export const useOpenRouterStore = defineStore('openrouter', () => {
+  const api = useApi()
+  const enabled = ref<OpenRouterModelMeta[]>([])
+  const browse = ref<OpenRouterModelMeta[]>([])
+  const loading = ref(false)
+  const refreshing = ref(false)
+  const refreshError = ref<string | null>(null)
+
+  async function load(workspaceId: string) {
+    loading.value = true
+    try {
+      const catalog = await api.getOpenRouterCatalog(workspaceId)
+      enabled.value = catalog.models
+    } catch {
+      // Auth disabled / not signed in / feature off → nothing surfaces.
+      enabled.value = []
+    } finally {
+      loading.value = false
+    }
+  }
+
+  /** Probe OpenRouter's live catalog (leases the workspace's pooled key server-side). */
+  async function refresh(workspaceId: string): Promise<OpenRouterRefreshResult> {
+    refreshing.value = true
+    refreshError.value = null
+    try {
+      const result = await api.refreshOpenRouterCatalog(workspaceId)
+      browse.value = result.models
+      if (!result.reachable) refreshError.value = result.error ?? 'OpenRouter is unreachable'
+      return result
+    } finally {
+      refreshing.value = false
+    }
+  }
+
+  /** Persist the enabled subset (the supplied models carry their browse-list metadata). */
+  async function save(workspaceId: string, models: OpenRouterModelMeta[]) {
+    const catalog = await api.setOpenRouterCatalog(workspaceId, { models })
+    enabled.value = catalog.models
+    return catalog
+  }
+
+  return { enabled, browse, loading, refreshing, refreshError, load, refresh, save }
+})

package/app/stores/ui.ts

@@ -73,7 +73,7 @@ export const useUiStore = defineStore('ui', () => {
   // Workspace-settings panel: issue-tracker writeback toggles (comment on PR open,
   // close linked issue on merge).
   const issueWritebackOpen = ref(false)
-  const modelDefaultsOpen = ref(false)
+  const modelConfigOpen = ref(false)
   // Workspace-settings panel: the default service-fragment selection new services inherit.
   const serviceFragmentDefaultsOpen = ref(false)
   // LLM-vendor subscription credentials (the token pool powering the Claude Code
@@ -81,6 +81,8 @@ export const useUiStore = defineStore('ui', () => {
   const vendorCredentialsOpen = ref(false)
   // Per-user settings panel: the signed-in user's own-machine local model runners.
   const localModelsOpen = ref(false)
+  // Per-workspace settings panel: the OpenRouter dynamic catalog (browse/enable gateway models).
+  const openRouterOpen = ref(false)
 
   // Dedicated result-view overlay: a step whose agent kind declares a bespoke
   // visualization (via the archetype's `resultView`) opens here instead of the generic
@@ -302,11 +304,11 @@ export const useUiStore = defineStore('ui', () => {
   function closeDatadog() {
     datadogOpen.value = false
   }
-  function openModelDefaults() {
-    modelDefaultsOpen.value = true
+  function openModelConfig() {
+    modelConfigOpen.value = true
   }
-  function closeModelDefaults() {
-    modelDefaultsOpen.value = false
+  function closeModelConfig() {
+    modelConfigOpen.value = false
   }
   function openServiceFragmentDefaults() {
     serviceFragmentDefaultsOpen.value = true
@@ -326,6 +328,12 @@ export const useUiStore = defineStore('ui', () => {
   function closeLocalModels() {
     localModelsOpen.value = false
   }
+  function openOpenRouter() {
+    openRouterOpen.value = true
+  }
+  function closeOpenRouter() {
+    openRouterOpen.value = false
+  }
   function openRequirementReview(blockId: string) {
     resultView.value = { view: 'requirements-review', blockId, instanceId: null, stepIndex: null }
   }
@@ -372,10 +380,11 @@ export const useUiStore = defineStore('ui', () => {
     issueWritebackOpen,
     workspaceSettingsOpen,
     datadogOpen,
-    modelDefaultsOpen,
+    modelConfigOpen,
     serviceFragmentDefaultsOpen,
     vendorCredentialsOpen,
     localModelsOpen,
+    openRouterOpen,
     resultView,
     closeResultView,
     stepDetail,
@@ -427,14 +436,16 @@ export const useUiStore = defineStore('ui', () => {
     closeWorkspaceSettings,
     openDatadog,
     closeDatadog,
-    openModelDefaults,
-    closeModelDefaults,
+    openModelConfig,
+    closeModelConfig,
     openServiceFragmentDefaults,
     closeServiceFragmentDefaults,
     openVendorCredentials,
     closeVendorCredentials,
     openLocalModels,
     closeLocalModels,
+    openOpenRouter,
+    closeOpenRouter,
     openRequirementReview,
     openClarityReview,
     closeRequirementReview,

package/app/stores/workspace.ts

@@ -10,7 +10,7 @@ import { useNotificationsStore } from '~/stores/notifications'
 import { useMergePresetsStore } from '~/stores/mergePresets'
 import { useWorkspaceSettingsStore } from '~/stores/workspaceSettings'
 import { useAgentConfigStore } from '~/stores/agentConfig'
-import { useModelDefaultsStore } from '~/stores/modelDefaults'
+import { useModelPresetsStore } from '~/stores/modelPresets'
 import { useServiceFragmentDefaultsStore } from '~/stores/serviceFragmentDefaults'
 import { useRecurringPipelinesStore } from '~/stores/recurringPipelines'
 import { useServicesStore } from '~/stores/services'
@@ -71,8 +71,7 @@ export const useWorkspaceStore = defineStore(
       useMergePresetsStore().hydrate(snapshot.mergePresets ?? [])
       useWorkspaceSettingsStore().hydrate(snapshot.settings)
       useAgentConfigStore().hydrate(snapshot.agentConfigCatalog ?? [])
-      useModelDefaultsStore().hydrate(snapshot.modelDefaults?.defaults)
-      useModelDefaultsStore().hydrateDeployment(snapshot.deploymentModelDefaults)
+      useModelPresetsStore().hydrate(snapshot.modelPresets ?? [])
       useServiceFragmentDefaultsStore().hydrate(snapshot.serviceFragmentDefaults?.fragmentIds)
       useRecurringPipelinesStore().hydrate(snapshot.recurringPipelines ?? [])
       useTrackerStore().hydrate(snapshot.trackerSettings)

package/app/types/domain.ts

@@ -21,6 +21,7 @@ import type { RequirementReview } from './requirements'
 import type { ConsensusSession, ConsensusStepConfig, StepGating, TaskEstimate } from './consensus'
 import type { ClarityReview } from './clarity'
 import type { MergeThresholdPreset } from './merge'
+import type { ModelPreset } from './model-presets'
 import type { PipelineSchedule } from './recurring'
 import type { Service, WorkspaceMount } from './services'
 import type { TrackerSettings, WritebackOverride } from './tracker'
@@ -126,6 +127,8 @@ export interface Block {
   pullRequest?: PullRequestRef
   /** task-only: selected merge threshold preset id; absent = workspace default. */
   mergePresetId?: string
+  /** task-only: selected model preset id (which model each agent runs); absent = workspace default. */
+  modelPresetId?: string
   /** task-only: pinned default pipeline id picked at creation; absent = none. */
   pipelineId?: string
   /** task-only: agent-contributed config values (id→value), e.g. the Tester's environment. */
@@ -385,8 +388,8 @@ export interface WorkspaceSnapshot {
   mergePresets?: MergeThresholdPreset[]
   /** Agent config-contribution descriptors (the task-level fields the board renders). */
   agentConfigCatalog?: AgentConfigDescriptor[]
-  /** Per-agent-kind default model overrides for this workspace (agentKind → model id). */
-  modelDefaults?: ModelDefaults
+  /** The workspace's model presets (the Model Configuration library + per-task picker). */
+  modelPresets?: ModelPreset[]
   /**
    * The deployment's env-routing defaults as `provider:model` refs: the model a
    * kind runs on when neither the task nor the workspace pins one. `default` is the
@@ -435,15 +438,6 @@ export interface UpdateWorkspaceSettingsInput {
   taskLimitPerType?: Partial<Record<CreateTaskType, number>> | null
 }
 
-/**
- * A workspace's per-agent-kind default model choice. Keys are agent kinds, values
- * are model catalog ids (`ModelOption.id`). A kind absent from the map falls back
- * to the deployment's env-configured routing. Mirrors `@cat-factory/contracts`.
- */
-export interface ModelDefaults {
-  defaults: Record<string, string>
-}
-
 /**
  * A workspace's default service-fragment selection: the best-practice fragment ids
  * new services inherit onto their `serviceFragmentIds`. Mirrors `@cat-factory/contracts`.

package/app/types/model-presets.ts

@@ -0,0 +1,33 @@
+// Model-preset shapes, mirroring `@cat-factory/contracts` (model-presets.ts). A preset
+// is a named, per-workspace model->agent mapping: one base model applied to every
+// agent kind plus per-kind overrides. A task selects one (Block.modelPresetId); none
+// resolves to the workspace default preset.
+
+/** A named, per-workspace model preset a task can select. */
+export interface ModelPreset {
+  id: string
+  name: string
+  /** The model every agent kind defaults to under this preset (a catalog id). */
+  baseModelId: string
+  /** Per-agent-kind model overrides on top of the base (agent kind → model id). */
+  overrides: Record<string, string>
+  /** The workspace's fallback preset, used by tasks that pick none. */
+  isDefault: boolean
+  createdAt: number
+}
+
+/** Create a model preset. */
+export interface CreateModelPresetInput {
+  name: string
+  baseModelId: string
+  overrides?: Record<string, string>
+  isDefault?: boolean
+}
+
+/** Patch a model preset (all fields optional; `overrides` replaces the map). */
+export interface UpdateModelPresetInput {
+  name?: string
+  baseModelId?: string
+  overrides?: Record<string, string>
+  isDefault?: boolean
+}

package/app/types/models.ts

@@ -19,15 +19,15 @@ export interface ModelCost {
  * A selectable LLM model, resolved to the flavour in use for this deployment
  * (served by `GET /models`). Mirrors `ModelOption` in `@cat-factory/contracts`.
  * The base `flavor`/`provider`/`model` is the always-available fallback
- * (cloudflare/direct), or the subscription itself for subscription-only models.
- * `subscription` (when present) is the alternative the picker prefers once the
- * workspace has a token for its vendor.
+ * (cloudflare/direct/openrouter), or the subscription itself for subscription-only
+ * models. `subscription` (when present) is the alternative the picker prefers once
+ * the workspace has a token for its vendor.
  */
 export interface ModelOption {
   id: string
   label: string
   description: string
-  flavor: 'cloudflare' | 'direct' | 'subscription'
+  flavor: 'cloudflare' | 'direct' | 'openrouter' | 'subscription'
   /**
    * Whether this model is actually selectable for the workspace: a direct API key for
    * its provider, a connected subscription vendor, or Cloudflare AI enabled. Absent on

package/app/types/openrouter.ts

@@ -0,0 +1,45 @@
+// ---------------------------------------------------------------------------
+// Per-workspace OpenRouter dynamic catalog. OpenRouter is a single OpenAI-
+// compatible gateway to 300+ models reached via the workspace's API-key pool. A
+// workspace browses the live catalog and enables a subset; the enabled models
+// surface automatically in the per-workspace model picker (with their context +
+// price) and feed the spend budget.
+//
+// Mirrors the `@cat-factory/contracts` `openrouter` schemas exactly, so a payload
+// returned by the backend drops straight into the Pinia store without translation.
+// ---------------------------------------------------------------------------
+
+/** Metadata for one OpenRouter model (prices per 1M tokens, in the spend currency). */
+export interface OpenRouterModelMeta {
+  /** OpenRouter `vendor/model` slug, e.g. `anthropic/claude-opus-4.8`. */
+  id: string
+  /** Human-readable model name from OpenRouter's catalog. */
+  name: string
+  /** Total context window (input + output tokens), when reported. */
+  contextLength?: number
+  /** Input price per 1M tokens, in the spend currency. */
+  inputPerMillion: number
+  /** Output price per 1M tokens, in the spend currency. */
+  outputPerMillion: number
+}
+
+/** A workspace's enabled OpenRouter models (the persisted subset). */
+export interface OpenRouterCatalog {
+  models: OpenRouterModelMeta[]
+  createdAt: number
+  updatedAt: number
+}
+
+/** Replace a workspace's enabled OpenRouter models with this subset (+ metadata). */
+export interface UpsertOpenRouterCatalogInput {
+  models: OpenRouterModelMeta[]
+}
+
+/** The result of probing OpenRouter's live `/models` for the browse list. */
+export interface OpenRouterRefreshResult {
+  reachable: boolean
+  /** Every model OpenRouter currently serves (empty when unreachable). */
+  models: OpenRouterModelMeta[]
+  /** Human-readable failure reason when `reachable` is false. */
+  error?: string
+}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.7.4",
+  "version": "0.9.0",
+  "description": "Reusable Nuxt layer for the Agent Architecture Board SPA (components, stores, composables, pages). Consume it from a thin deployment app via `extends: ['@cat-factory/app']` and point it at your backend with NUXT_PUBLIC_API_BASE. See deploy/frontend for an example.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/kibertoad/cat-factory.git",
     "directory": "frontend/app"
   },
-  "description": "Reusable Nuxt layer for the Agent Architecture Board SPA (components, stores, composables, pages). Consume it from a thin deployment app via `extends: ['@cat-factory/app']` and point it at your backend with NUXT_PUBLIC_API_BASE. See deploy/frontend for an example.",
   "files": [
     "app",
     "nuxt.config.ts"