@aexol/spectral 0.9.246 → 0.9.247

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to `@aexol/spectral` are documented here. Format follows
 
 ## [Unreleased]
 
+## [0.9.247] - 2026-10-04
+
+### Added
+
+- Added a public built-in model catalog: new `publicModelCatalog` GraphQL
+  query (`BuiltInModelCatalogEntry`) exposing built-in UserModels with credit
+  pricing per 1M tokens, measured average TPS (output tokens over measured
+  duration rows only), owner-configured fallback tok/s on BaseModel,
+  last-request time, 30-day request count, and status. The `/models` landing
+  page was rebuilt around `models-catalog-section.tsx`.
+- Added `durationMs` capture on CreditUsageEvent in the backend generate and
+  refine flows, with database migrations `20261004122612` and
+  `20261004135152`.
+- Added cli-node attachment support: persist and cleanup in
+  `src/server/attachments` with tests, plus serve, agent-bridge,
+  session-stream, and storage changes.
+- Added a Fallback tok/s input to the admin base-models tab.
+
 ## [0.9.231] - 2026-09-23
 
 ### Added

package/dist/commands/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAwBH,OAAO,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AAclE,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAmB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAsBrE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAazD;AAED,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CA6B9D;AAED,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IAC9E;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,KAAK,EAAE,YAAY,CAAC;IACpB,wDAAwD;IACxD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,4CAA4C;IAC5C,KAAK,EAAE,WAAW,CAAC;IACnB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAoqBlF;AAmFD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAsB5E"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAwBH,OAAO,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AAgBlE,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAmB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAsBrE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAazD;AAED,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CA6B9D;AAED,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IAC9E;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,KAAK,EAAE,YAAY,CAAC;IACpB,wDAAwD;IACxD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,4CAA4C;IAC5C,KAAK,EAAE,WAAW,CAAC;IACnB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAurBlF;AAmFD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAsB5E"}

package/dist/commands/serve.js

@@ -43,6 +43,8 @@ import { getFanoutManager } from "../server/fanout/fanout-manager.js";
 import { detachAllSubscribers, handleAutoOptimizeFrame, handleAutoResearchFrame, handleCancelTurn, handleClientMessage, handleRestRequest, handleStopToolCall, handleSubscribe, } from "../relay/dispatcher.js";
 import { ensureMachineRegistered } from "../relay/registration.js";
 import { saveMachine } from "../relay/machine-store.js";
+import { sweepAttachments } from "../server/attachments/cleanup.js";
+import { attachmentsRootFor } from "../server/attachments/persist.js";
 import { SessionStreamManager } from "../server/session-stream.js";
 import { gracefulShutdown } from "../server/shutdown.js";
 import { getLiveMcpState } from "../mcp/state-getter.js";
@@ -175,6 +177,25 @@ export async function runServe(opts = {}) {
             // Best-effort.
         }
     });
+    // GC for stale persisted chat attachments (`.spectral/attachments/<id>/`).
+    // Fire-and-forget like the offload sweep: never blocks server startup and
+    // never takes down serving. Sweeps every known project root (attachments
+    // live under the session's project cwd) plus the fallback cwd.
+    setImmediate(() => {
+        try {
+            const activeSessionIds = new Set(store.listAllSessionIds());
+            const roots = new Set([attachmentsRootFor(cwd)]);
+            for (const project of store.listProjects()) {
+                roots.add(attachmentsRootFor(project.path));
+            }
+            for (const root of roots) {
+                sweepAttachments({ root, activeSessionIds });
+            }
+        }
+        catch {
+            // Best-effort.
+        }
+    });
     // Mutable holder for the meta-event publisher. Bound below once we
     // have both `relay` (the send target) and `registration.record.machineId`
     // (the canonical machineId the backend uses to fan out). The manager

package/dist/generated/zeus/const.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../../../src/generated/zeus/const.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAC,GAAG,CAy0B5C,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAC,GAAG,CAqoC1C,CAAA;AAED,eAAO,MAAM,GAAG;;;;CAIf,CAAA"}
+{"version":3,"file":"const.d.ts","sourceRoot":"","sources":["../../../src/generated/zeus/const.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAC,GAAG,CAy0B5C,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAC,GAAG,CAqpC1C,CAAA;AAED,eAAO,MAAM,GAAG;;;;CAIf,CAAA"}

package/dist/generated/zeus/const.js

@@ -1018,6 +1018,7 @@ export const ReturnTypes = {
         subscriptionCompatibleModels: "UserModel",
         baseModelCatalog: "CatalogModel",
         availableModels: "AvailableModel",
+        publicModelCatalog: "BuiltInModelCatalogEntry",
         availablePlans: "PlanInfo",
         availableCreditPacks: "CreditPack",
         teamSubscription: "BillingSubscription",
@@ -1524,6 +1525,20 @@ export const ReturnTypes = {
         supportsImages: "Boolean",
         supportsReasoning: "Boolean"
     },
+    BuiltInModelCatalogEntry: {
+        slug: "String",
+        name: "String",
+        baseModel: "String",
+        contextWindow: "Int",
+        creditInputPer1M: "Int",
+        creditOutputPer1M: "Int",
+        visibleInStudio: "Boolean",
+        agentEnabled: "Boolean",
+        lastRequestAt: "DateTime",
+        avgTps: "Float",
+        fallbackTps: "Float",
+        requestCount30d: "Int"
+    },
     AvailableModel: {
         name: "String",
         provider: "String",
@@ -1561,6 +1576,7 @@ export const ReturnTypes = {
         creditCacheWritePer1M: "Int",
         creditPerImage: "Float",
         creditPerVideoSecond: "Float",
+        fallbackTps: "Float",
         capabilities: "JSON",
         family: "String",
         enabled: "Boolean",

package/dist/generated/zeus/index.d.ts

@@ -1246,6 +1246,7 @@ export type ValueTypes = {
             scope?: ValueTypes["ModelScope"] | undefined | null | Variable<any, string>;
             teamId?: ValueTypes["ID"] | undefined | null | Variable<any, string>;
         }, ValueTypes["AvailableModel"]];
+        publicModelCatalog?: ValueTypes["BuiltInModelCatalogEntry"];
         availablePlans?: ValueTypes["PlanInfo"];
         availableCreditPacks?: ValueTypes["CreditPack"];
         teamSubscription?: [{
@@ -2460,6 +2461,22 @@ export type ValueTypes = {
         __typename?: boolean | `@${string}`;
         ['...on CatalogModel']?: Omit<ValueTypes["CatalogModel"], "...on CatalogModel">;
     }>;
+    ["BuiltInModelCatalogEntry"]: AliasType<{
+        slug?: boolean | `@${string}`;
+        name?: boolean | `@${string}`;
+        baseModel?: boolean | `@${string}`;
+        contextWindow?: boolean | `@${string}`;
+        creditInputPer1M?: boolean | `@${string}`;
+        creditOutputPer1M?: boolean | `@${string}`;
+        visibleInStudio?: boolean | `@${string}`;
+        agentEnabled?: boolean | `@${string}`;
+        lastRequestAt?: boolean | `@${string}`;
+        avgTps?: boolean | `@${string}`;
+        fallbackTps?: boolean | `@${string}`;
+        requestCount30d?: boolean | `@${string}`;
+        __typename?: boolean | `@${string}`;
+        ['...on BuiltInModelCatalogEntry']?: Omit<ValueTypes["BuiltInModelCatalogEntry"], "...on BuiltInModelCatalogEntry">;
+    }>;
     ["AvailableModel"]: AliasType<{
         name?: boolean | `@${string}`;
         provider?: boolean | `@${string}`;
@@ -2499,6 +2516,7 @@ export type ValueTypes = {
         creditCacheWritePer1M?: boolean | `@${string}`;
         creditPerImage?: boolean | `@${string}`;
         creditPerVideoSecond?: boolean | `@${string}`;
+        fallbackTps?: boolean | `@${string}`;
         capabilities?: boolean | `@${string}`;
         family?: boolean | `@${string}`;
         enabled?: boolean | `@${string}`;
@@ -2534,6 +2552,7 @@ export type ValueTypes = {
         creditCacheWritePer1M?: number | undefined | null | Variable<any, string>;
         creditPerImage?: number | undefined | null | Variable<any, string>;
         creditPerVideoSecond?: number | undefined | null | Variable<any, string>;
+        fallbackTps?: number | undefined | null | Variable<any, string>;
         family?: string | undefined | null | Variable<any, string>;
         isDefault?: boolean | undefined | null | Variable<any, string>;
         isVisionDefault?: boolean | undefined | null | Variable<any, string>;
@@ -3597,6 +3616,7 @@ export type ResolverInputTypes = {
             scope?: ResolverInputTypes["ModelScope"] | undefined | null;
             teamId?: ResolverInputTypes["ID"] | undefined | null;
         }, ResolverInputTypes["AvailableModel"]];
+        publicModelCatalog?: ResolverInputTypes["BuiltInModelCatalogEntry"];
         availablePlans?: ResolverInputTypes["PlanInfo"];
         availableCreditPacks?: ResolverInputTypes["CreditPack"];
         teamSubscription?: [{
@@ -4783,6 +4803,21 @@ export type ResolverInputTypes = {
         supportsReasoning?: boolean | `@${string}`;
         __typename?: boolean | `@${string}`;
     }>;
+    ["BuiltInModelCatalogEntry"]: AliasType<{
+        slug?: boolean | `@${string}`;
+        name?: boolean | `@${string}`;
+        baseModel?: boolean | `@${string}`;
+        contextWindow?: boolean | `@${string}`;
+        creditInputPer1M?: boolean | `@${string}`;
+        creditOutputPer1M?: boolean | `@${string}`;
+        visibleInStudio?: boolean | `@${string}`;
+        agentEnabled?: boolean | `@${string}`;
+        lastRequestAt?: boolean | `@${string}`;
+        avgTps?: boolean | `@${string}`;
+        fallbackTps?: boolean | `@${string}`;
+        requestCount30d?: boolean | `@${string}`;
+        __typename?: boolean | `@${string}`;
+    }>;
     ["AvailableModel"]: AliasType<{
         name?: boolean | `@${string}`;
         provider?: boolean | `@${string}`;
@@ -4821,6 +4856,7 @@ export type ResolverInputTypes = {
         creditCacheWritePer1M?: boolean | `@${string}`;
         creditPerImage?: boolean | `@${string}`;
         creditPerVideoSecond?: boolean | `@${string}`;
+        fallbackTps?: boolean | `@${string}`;
         capabilities?: boolean | `@${string}`;
         family?: boolean | `@${string}`;
         enabled?: boolean | `@${string}`;
@@ -4854,6 +4890,7 @@ export type ResolverInputTypes = {
         creditCacheWritePer1M?: number | undefined | null;
         creditPerImage?: number | undefined | null;
         creditPerVideoSecond?: number | undefined | null;
+        fallbackTps?: number | undefined | null;
         family?: string | undefined | null;
         isDefault?: boolean | undefined | null;
         isVisionDefault?: boolean | undefined | null;
@@ -5774,6 +5811,7 @@ export type ModelTypes = {
         subscriptionCompatibleModels: Array<ModelTypes["UserModel"]>;
         baseModelCatalog: Array<ModelTypes["CatalogModel"]>;
         availableModels: Array<ModelTypes["AvailableModel"]>;
+        publicModelCatalog: Array<ModelTypes["BuiltInModelCatalogEntry"]>;
         availablePlans: Array<ModelTypes["PlanInfo"]>;
         availableCreditPacks: Array<ModelTypes["CreditPack"]>;
         teamSubscription?: ModelTypes["BillingSubscription"] | undefined | null;
@@ -6432,6 +6470,20 @@ export type ModelTypes = {
         supportsImages?: boolean | undefined | null;
         supportsReasoning?: boolean | undefined | null;
     };
+    ["BuiltInModelCatalogEntry"]: {
+        slug: string;
+        name: string;
+        baseModel: string;
+        contextWindow?: number | undefined | null;
+        creditInputPer1M?: number | undefined | null;
+        creditOutputPer1M?: number | undefined | null;
+        visibleInStudio: boolean;
+        agentEnabled: boolean;
+        lastRequestAt?: ModelTypes["DateTime"] | undefined | null;
+        avgTps?: number | undefined | null;
+        fallbackTps?: number | undefined | null;
+        requestCount30d: number;
+    };
     ["AvailableModel"]: {
         name: string;
         provider: string;
@@ -6469,6 +6521,7 @@ export type ModelTypes = {
         creditCacheWritePer1M?: number | undefined | null;
         creditPerImage?: number | undefined | null;
         creditPerVideoSecond?: number | undefined | null;
+        fallbackTps?: number | undefined | null;
         capabilities?: ModelTypes["JSON"] | undefined | null;
         family?: string | undefined | null;
         enabled: boolean;
@@ -6500,6 +6553,7 @@ export type ModelTypes = {
         creditCacheWritePer1M?: number | undefined | null;
         creditPerImage?: number | undefined | null;
         creditPerVideoSecond?: number | undefined | null;
+        fallbackTps?: number | undefined | null;
         family?: string | undefined | null;
         isDefault?: boolean | undefined | null;
         isVisionDefault?: boolean | undefined | null;
@@ -7518,6 +7572,7 @@ export type GraphQLTypes = {
         subscriptionCompatibleModels: Array<GraphQLTypes["UserModel"]>;
         baseModelCatalog: Array<GraphQLTypes["CatalogModel"]>;
         availableModels: Array<GraphQLTypes["AvailableModel"]>;
+        publicModelCatalog: Array<GraphQLTypes["BuiltInModelCatalogEntry"]>;
         availablePlans: Array<GraphQLTypes["PlanInfo"]>;
         availableCreditPacks: Array<GraphQLTypes["CreditPack"]>;
         teamSubscription?: GraphQLTypes["BillingSubscription"] | undefined | null;
@@ -8237,6 +8292,22 @@ export type GraphQLTypes = {
         supportsReasoning?: boolean | undefined | null;
         ['...on CatalogModel']: Omit<GraphQLTypes["CatalogModel"], "...on CatalogModel">;
     };
+    ["BuiltInModelCatalogEntry"]: {
+        __typename: "BuiltInModelCatalogEntry";
+        slug: string;
+        name: string;
+        baseModel: string;
+        contextWindow?: number | undefined | null;
+        creditInputPer1M?: number | undefined | null;
+        creditOutputPer1M?: number | undefined | null;
+        visibleInStudio: boolean;
+        agentEnabled: boolean;
+        lastRequestAt?: GraphQLTypes["DateTime"] | undefined | null;
+        avgTps?: number | undefined | null;
+        fallbackTps?: number | undefined | null;
+        requestCount30d: number;
+        ['...on BuiltInModelCatalogEntry']: Omit<GraphQLTypes["BuiltInModelCatalogEntry"], "...on BuiltInModelCatalogEntry">;
+    };
     ["AvailableModel"]: {
         __typename: "AvailableModel";
         name: string;
@@ -8277,6 +8348,7 @@ export type GraphQLTypes = {
         creditCacheWritePer1M?: number | undefined | null;
         creditPerImage?: number | undefined | null;
         creditPerVideoSecond?: number | undefined | null;
+        fallbackTps?: number | undefined | null;
         capabilities?: GraphQLTypes["JSON"] | undefined | null;
         family?: string | undefined | null;
         enabled: boolean;
@@ -8311,6 +8383,7 @@ export type GraphQLTypes = {
         creditCacheWritePer1M?: number | undefined | null;
         creditPerImage?: number | undefined | null;
         creditPerVideoSecond?: number | undefined | null;
+        fallbackTps?: number | undefined | null;
         family?: string | undefined | null;
         isDefault?: boolean | undefined | null;
         isVisionDefault?: boolean | undefined | null;