@ai-matrx/desktop-protocol 0.21.42 → 0.21.44

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { O as OpName } from './models-Ut2nuRzV.cjs';
-export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, q as DownloadKind, r as DownloadRow, d as EVENTS, s as EndMsg, E as EndReason, t as ErrorCode, u as ErrorCodeName, v as ErrorData, w as ErrorMsg, x as ErrorReason, y as ErrorReasonName, z as EventMsg, A as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, G as LlmRunning, I as LlmServerState, J as MlInstallPhase, K as MlInstallProgress, f as MlProgress, N as MlRuntimeState, P as MlServiceState, Q as MlServiceStatus, R as MlStatusParams, U as MlStatusResult, V as ModelsDownloadsCancelParams, X as ModelsDownloadsCancelResult, Y as ModelsDownloadsListParams, Z as ModelsDownloadsListResult, _ as ModelsInstallParams, $ as ModelsInstallResult, a0 as ModelsLlmInstallParams, a1 as ModelsLlmInstallResult, a2 as ModelsLlmStartParams, a3 as ModelsLlmStartResult, a4 as ModelsLlmStatusParams, a5 as ModelsLlmStatusResult, a6 as ModelsLlmStopParams, a7 as ModelsLlmStopResult, a8 as ModelsProgressEvent, a9 as ModelsStatusParams, aa as ModelsStatusResult, ab as ModelsTranscribeParams, M as ModelsTranscribeResult, ac as NAMED_SCHEMAS, ad as NamedSchemaId, c as OPS, ae as OpDescriptor, a as OpParams, b as OpResult, af as OpSpec, ag as PING_TEXT, ah as PONG_TEXT, ai as ProtocolErrorBody, aj as RelayMsg, ak as RequestMsg, al as ResponseMsg, am as SERVICES, an as SUBPROTOCOL, ao as ServiceId, ap as ServiceOpName, aq as ServiceOpSpec, ar as ServiceSpec, S as StreamMeta, as as StreamMsg, at as TextModelId, au as TextModelInfo, av as TranscriptSegment, T as TranscriptionModelId, aw as TranscriptionModelInfo, W as Welcome, ax as closeRule, i as isDesktopProtocolError, ay as isTerminalClose } from './models-Ut2nuRzV.cjs';
+import { O as OpName } from './models-CCRnwbz8.cjs';
+export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as CatalogFile, k as CatalogModelEntry, l as ClientToCoreMsg, e as ClientType, m as CloseAction, n as CloseCode, o as CloseCodeValue, C as CloseOutcome, p as CloseRule, q as CoreToClientMsg, r as CreditMsg, D as DesktopProtocolError, s as DownloadKind, t as DownloadRow, d as EVENTS, u as EndMsg, E as EndReason, v as ErrorCode, w as ErrorCodeName, x as ErrorData, y as ErrorMsg, z as ErrorReason, A as ErrorReasonName, F as EventMsg, G as EventName, H as FsPatchEditFailure, I as HelloMsg, L as Limits, J as LlamaServerBuild, K as LlmRunning, N as LlmServerState, P as MlCatalogSetParams, Q as MlCatalogSetResult, R as MlInstallPhase, U as MlInstallProgress, f as MlProgress, V as MlRuntimeState, X as MlServiceState, Y as MlServiceStatus, Z as MlStatusParams, _ as MlStatusResult, $ as ModelKey, a0 as ModelsDownloadsCancelParams, a1 as ModelsDownloadsCancelResult, a2 as ModelsDownloadsListParams, a3 as ModelsDownloadsListResult, a4 as ModelsInstallParams, a5 as ModelsInstallResult, a6 as ModelsLlmInstallParams, a7 as ModelsLlmInstallResult, a8 as ModelsLlmStartParams, a9 as ModelsLlmStartResult, aa as ModelsLlmStatusParams, ab as ModelsLlmStatusResult, ac as ModelsLlmStopParams, ad as ModelsLlmStopResult, ae as ModelsProgressEvent, af as ModelsStatusParams, ag as ModelsStatusResult, ah as ModelsTranscribeParams, M as ModelsTranscribeResult, ai as NAMED_SCHEMAS, aj as NamedSchemaId, c as OPS, ak as OpDescriptor, a as OpParams, b as OpResult, al as OpSpec, am as PING_TEXT, an as PONG_TEXT, ao as ProtocolErrorBody, ap as RelayMsg, aq as RequestMsg, ar as ResponseMsg, as as SERVICES, at as SUBPROTOCOL, au as ServiceId, av as ServiceOpName, aw as ServiceOpSpec, ax as ServiceSpec, ay as Sha256Hex, S as StreamMeta, az as StreamMsg, aA as TextModelId, aB as TextModelInfo, aC as TranscriptSegment, T as TranscriptionModelId, aD as TranscriptionModelInfo, W as Welcome, aE as closeRule, i as isDesktopProtocolError, aF as isTerminalClose } from './models-CCRnwbz8.cjs';
 export { BROADCAST_CID, DecodedFrame, FRAME_HEADER_BYTES, FRAME_STRUCT_FORMAT, FRAME_VERSION, FrameChannel, FrameChannelValue, FrameFlag, assertFrameHeader, connectionEndFrame, decodeFrame, encodeFrame, hasFlag, isConnectionEnd, readCid, stampCid } from './frame.cjs';
 
 /** @ai-matrx/desktop-protocol — version and primitive schemas. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
@@ -123,10 +123,15 @@ declare const PROTOCOL_MAJOR: 1;
  *          models.downloads.list (every running model download and every half-done one) and
  *          models.downloads.cancel. A 1.44 core omits graphics and answers UNKNOWN_OPERATION.
  *   1.46 — a failed download stays listed with why: DownloadRow `error`. A 1.45 core omits it.
+ *   1.49 — local models come from the platform catalog: TextModelId and TranscriptionModelId are
+ *          string keys (`ModelKey`; every 1.48 id stays valid), and the service op ml.catalog_set
+ *          hands the ml service the selected files to fetch (URL + SHA-256 each) and the
+ *          llama-server build. A 1.48 peer still refuses keys outside its enum; the catalog's
+ *          min_app_version keeps new keys away from it.
  */
-declare const PROTOCOL_MINOR: 47;
+declare const PROTOCOL_MINOR: 49;
 /** This package's version as the wire spells it ("major.minor"): hello, welcome, relay status. */
-declare const PROTOCOL_VERSION: "1.47";
+declare const PROTOCOL_VERSION: "1.49";
 /** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
 declare const u32: z.ZodInt;
 declare const nonNegInt: z.ZodInt;
@@ -4006,9 +4011,9 @@ type ServiceWelcome = z.output<typeof ServiceWelcome>;
 /** Tool names are the platform registry's (`tool.definition.name`): `fs_read`, `shell_execute`… */
 declare const ToolName: z.ZodString;
 declare const ToolLevel: z.ZodEnum<{
+    protocol: "protocol";
     chat: "chat";
     programmatic: "programmatic";
-    protocol: "protocol";
 }>;
 type ToolLevel = z.output<typeof ToolLevel>;
 declare const ToolOutcome: z.ZodEnum<{
@@ -4038,9 +4043,9 @@ type ToolTransport = z.output<typeof ToolTransport>;
 declare const ToolLevelResult: z.ZodObject<{
     tool: z.ZodString;
     level: z.ZodEnum<{
+        protocol: "protocol";
         chat: "chat";
         programmatic: "programmatic";
-        protocol: "protocol";
     }>;
     platform: z.ZodEnum<{
         darwin: "darwin";
@@ -4072,9 +4077,9 @@ declare const ToolResultsFile: z.ZodObject<{
     results: z.ZodArray<z.ZodObject<{
         tool: z.ZodString;
         level: z.ZodEnum<{
+            protocol: "protocol";
             chat: "chat";
             programmatic: "programmatic";
-            protocol: "protocol";
         }>;
         platform: z.ZodEnum<{
             darwin: "darwin";
@@ -10314,6 +10319,16 @@ type EntitiesPiiResult = z.output<typeof EntitiesPiiResult>;
  * inside one (`ProtocolErrorBody.data`), or a union branch (`RelayCallResponse|0`).
  */
 declare const FIELDS_SINCE: {
+    readonly LlmRunning: {
+        readonly context_length: "1.48";
+        readonly gpu_layers: "1.48";
+        readonly threads: "1.48";
+    };
+    readonly ModelsLlmStartParams: {
+        readonly gpu_layers: "1.48";
+        readonly threads: "1.48";
+        readonly load_timeout_s: "1.48";
+    };
     readonly FsPatchResult: {
         readonly edits_applied: "1.1";
         readonly edits_failed: "1.1";
@@ -10506,7 +10521,7 @@ declare function forPeer(op: OpName | null, part: "error", value: unknown, versi
 declare const VERSIONED_RESULT_OPS: readonly OpName[];
 
 /** SHA-256 of generated/desktop-protocol.schema.json: the contract both sides of a service connection were built from. */
-declare const CONTRACT_SHA256: "502c8718b1d2fd0fde43daed047da5a7b158f81ffa3846c7d73cda879777fe37";
+declare const CONTRACT_SHA256: "783487638685c921a761d27c5c6dca3103d1d6d5ae0ec38ffd59086b68a2207a";
 
 /**
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { O as OpName } from './models-Ut2nuRzV.js';
-export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, q as DownloadKind, r as DownloadRow, d as EVENTS, s as EndMsg, E as EndReason, t as ErrorCode, u as ErrorCodeName, v as ErrorData, w as ErrorMsg, x as ErrorReason, y as ErrorReasonName, z as EventMsg, A as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, G as LlmRunning, I as LlmServerState, J as MlInstallPhase, K as MlInstallProgress, f as MlProgress, N as MlRuntimeState, P as MlServiceState, Q as MlServiceStatus, R as MlStatusParams, U as MlStatusResult, V as ModelsDownloadsCancelParams, X as ModelsDownloadsCancelResult, Y as ModelsDownloadsListParams, Z as ModelsDownloadsListResult, _ as ModelsInstallParams, $ as ModelsInstallResult, a0 as ModelsLlmInstallParams, a1 as ModelsLlmInstallResult, a2 as ModelsLlmStartParams, a3 as ModelsLlmStartResult, a4 as ModelsLlmStatusParams, a5 as ModelsLlmStatusResult, a6 as ModelsLlmStopParams, a7 as ModelsLlmStopResult, a8 as ModelsProgressEvent, a9 as ModelsStatusParams, aa as ModelsStatusResult, ab as ModelsTranscribeParams, M as ModelsTranscribeResult, ac as NAMED_SCHEMAS, ad as NamedSchemaId, c as OPS, ae as OpDescriptor, a as OpParams, b as OpResult, af as OpSpec, ag as PING_TEXT, ah as PONG_TEXT, ai as ProtocolErrorBody, aj as RelayMsg, ak as RequestMsg, al as ResponseMsg, am as SERVICES, an as SUBPROTOCOL, ao as ServiceId, ap as ServiceOpName, aq as ServiceOpSpec, ar as ServiceSpec, S as StreamMeta, as as StreamMsg, at as TextModelId, au as TextModelInfo, av as TranscriptSegment, T as TranscriptionModelId, aw as TranscriptionModelInfo, W as Welcome, ax as closeRule, i as isDesktopProtocolError, ay as isTerminalClose } from './models-Ut2nuRzV.js';
+import { O as OpName } from './models-CCRnwbz8.js';
+export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as CatalogFile, k as CatalogModelEntry, l as ClientToCoreMsg, e as ClientType, m as CloseAction, n as CloseCode, o as CloseCodeValue, C as CloseOutcome, p as CloseRule, q as CoreToClientMsg, r as CreditMsg, D as DesktopProtocolError, s as DownloadKind, t as DownloadRow, d as EVENTS, u as EndMsg, E as EndReason, v as ErrorCode, w as ErrorCodeName, x as ErrorData, y as ErrorMsg, z as ErrorReason, A as ErrorReasonName, F as EventMsg, G as EventName, H as FsPatchEditFailure, I as HelloMsg, L as Limits, J as LlamaServerBuild, K as LlmRunning, N as LlmServerState, P as MlCatalogSetParams, Q as MlCatalogSetResult, R as MlInstallPhase, U as MlInstallProgress, f as MlProgress, V as MlRuntimeState, X as MlServiceState, Y as MlServiceStatus, Z as MlStatusParams, _ as MlStatusResult, $ as ModelKey, a0 as ModelsDownloadsCancelParams, a1 as ModelsDownloadsCancelResult, a2 as ModelsDownloadsListParams, a3 as ModelsDownloadsListResult, a4 as ModelsInstallParams, a5 as ModelsInstallResult, a6 as ModelsLlmInstallParams, a7 as ModelsLlmInstallResult, a8 as ModelsLlmStartParams, a9 as ModelsLlmStartResult, aa as ModelsLlmStatusParams, ab as ModelsLlmStatusResult, ac as ModelsLlmStopParams, ad as ModelsLlmStopResult, ae as ModelsProgressEvent, af as ModelsStatusParams, ag as ModelsStatusResult, ah as ModelsTranscribeParams, M as ModelsTranscribeResult, ai as NAMED_SCHEMAS, aj as NamedSchemaId, c as OPS, ak as OpDescriptor, a as OpParams, b as OpResult, al as OpSpec, am as PING_TEXT, an as PONG_TEXT, ao as ProtocolErrorBody, ap as RelayMsg, aq as RequestMsg, ar as ResponseMsg, as as SERVICES, at as SUBPROTOCOL, au as ServiceId, av as ServiceOpName, aw as ServiceOpSpec, ax as ServiceSpec, ay as Sha256Hex, S as StreamMeta, az as StreamMsg, aA as TextModelId, aB as TextModelInfo, aC as TranscriptSegment, T as TranscriptionModelId, aD as TranscriptionModelInfo, W as Welcome, aE as closeRule, i as isDesktopProtocolError, aF as isTerminalClose } from './models-CCRnwbz8.js';
 export { BROADCAST_CID, DecodedFrame, FRAME_HEADER_BYTES, FRAME_STRUCT_FORMAT, FRAME_VERSION, FrameChannel, FrameChannelValue, FrameFlag, assertFrameHeader, connectionEndFrame, decodeFrame, encodeFrame, hasFlag, isConnectionEnd, readCid, stampCid } from './frame.js';
 
 /** @ai-matrx/desktop-protocol — version and primitive schemas. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
@@ -123,10 +123,15 @@ declare const PROTOCOL_MAJOR: 1;
  *          models.downloads.list (every running model download and every half-done one) and
  *          models.downloads.cancel. A 1.44 core omits graphics and answers UNKNOWN_OPERATION.
  *   1.46 — a failed download stays listed with why: DownloadRow `error`. A 1.45 core omits it.
+ *   1.49 — local models come from the platform catalog: TextModelId and TranscriptionModelId are
+ *          string keys (`ModelKey`; every 1.48 id stays valid), and the service op ml.catalog_set
+ *          hands the ml service the selected files to fetch (URL + SHA-256 each) and the
+ *          llama-server build. A 1.48 peer still refuses keys outside its enum; the catalog's
+ *          min_app_version keeps new keys away from it.
  */
-declare const PROTOCOL_MINOR: 47;
+declare const PROTOCOL_MINOR: 49;
 /** This package's version as the wire spells it ("major.minor"): hello, welcome, relay status. */
-declare const PROTOCOL_VERSION: "1.47";
+declare const PROTOCOL_VERSION: "1.49";
 /** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
 declare const u32: z.ZodInt;
 declare const nonNegInt: z.ZodInt;
@@ -4006,9 +4011,9 @@ type ServiceWelcome = z.output<typeof ServiceWelcome>;
 /** Tool names are the platform registry's (`tool.definition.name`): `fs_read`, `shell_execute`… */
 declare const ToolName: z.ZodString;
 declare const ToolLevel: z.ZodEnum<{
+    protocol: "protocol";
     chat: "chat";
     programmatic: "programmatic";
-    protocol: "protocol";
 }>;
 type ToolLevel = z.output<typeof ToolLevel>;
 declare const ToolOutcome: z.ZodEnum<{
@@ -4038,9 +4043,9 @@ type ToolTransport = z.output<typeof ToolTransport>;
 declare const ToolLevelResult: z.ZodObject<{
     tool: z.ZodString;
     level: z.ZodEnum<{
+        protocol: "protocol";
         chat: "chat";
         programmatic: "programmatic";
-        protocol: "protocol";
     }>;
     platform: z.ZodEnum<{
         darwin: "darwin";
@@ -4072,9 +4077,9 @@ declare const ToolResultsFile: z.ZodObject<{
     results: z.ZodArray<z.ZodObject<{
         tool: z.ZodString;
         level: z.ZodEnum<{
+            protocol: "protocol";
             chat: "chat";
             programmatic: "programmatic";
-            protocol: "protocol";
         }>;
         platform: z.ZodEnum<{
             darwin: "darwin";
@@ -10314,6 +10319,16 @@ type EntitiesPiiResult = z.output<typeof EntitiesPiiResult>;
  * inside one (`ProtocolErrorBody.data`), or a union branch (`RelayCallResponse|0`).
  */
 declare const FIELDS_SINCE: {
+    readonly LlmRunning: {
+        readonly context_length: "1.48";
+        readonly gpu_layers: "1.48";
+        readonly threads: "1.48";
+    };
+    readonly ModelsLlmStartParams: {
+        readonly gpu_layers: "1.48";
+        readonly threads: "1.48";
+        readonly load_timeout_s: "1.48";
+    };
     readonly FsPatchResult: {
         readonly edits_applied: "1.1";
         readonly edits_failed: "1.1";
@@ -10506,7 +10521,7 @@ declare function forPeer(op: OpName | null, part: "error", value: unknown, versi
 declare const VERSIONED_RESULT_OPS: readonly OpName[];
 
 /** SHA-256 of generated/desktop-protocol.schema.json: the contract both sides of a service connection were built from. */
-declare const CONTRACT_SHA256: "502c8718b1d2fd0fde43daed047da5a7b158f81ffa3846c7d73cda879777fe37";
+declare const CONTRACT_SHA256: "783487638685c921a761d27c5c6dca3103d1d6d5ae0ec38ffd59086b68a2207a";
 
 /**
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the

package/dist/index.js

@@ -2,7 +2,7 @@
 import { z } from "zod";
 import { UUID_SHAPE_PATTERN } from "@ai-matrx/kit/uuid";
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 47;
+var PROTOCOL_MINOR = 49;
 var PROTOCOL_VERSION = `${PROTOCOL_MAJOR}.${PROTOCOL_MINOR}`;
 var ProtocolVersion = z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
 var RequestId = z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
@@ -815,7 +815,8 @@ var RelayStatusResponse = RelayDeviceStatusEvent;
 
 // src/schema/models.ts
 import { z as z10 } from "zod";
-var TranscriptionModelId = z10.enum(["tiny", "base", "small", "large-v3-turbo"]);
+var ModelKey = z10.string().min(1).max(128).regex(/^[a-z0-9][a-z0-9._-]*(\/[a-z0-9][a-z0-9._-]*)?$/);
+var TranscriptionModelId = ModelKey;
 var MlRuntimeState = z10.enum(["not_installed", "installing", "installed", "failed"]);
 var MlInstallPhase = z10.enum(["packages", "model", "verifying"]);
 var MlInstallProgress = z10.strictObject({
@@ -875,18 +876,7 @@ var MlProgress = z10.strictObject({
   /** The segment just transcribed (transcribe only): text appears as it is recognised. */
   segment: TranscriptSegment.nullable()
 });
-var TextModelId = z10.enum([
-  "smollm2-135m",
-  "llama-3.2-3b",
-  "phi-4-mini",
-  "gemma-3-4b",
-  "llama-3.1-8b",
-  "qwen-2.5-7b",
-  "mistral-small-3.1",
-  "gpt-oss-20b",
-  "qwen-2.5-coder-7b",
-  "qwen-2.5-coder-14b"
-]);
+var TextModelId = ModelKey;
 var TextModelInfo = z10.strictObject({
   id: TextModelId,
   /** Download size of the weights. */
@@ -894,7 +884,14 @@ var TextModelInfo = z10.strictObject({
   installed: z10.boolean()
 });
 var LlmServerState = z10.enum(["stopped", "starting", "running", "failed"]);
-var LlmRunning = z10.strictObject({ id: TextModelId, port: z10.int().min(1024).max(65535) });
+var LlmRunning = z10.strictObject({
+  id: TextModelId,
+  port: z10.int().min(1024).max(65535),
+  /** (1.48) What the service actually applied, echoed so the app can attest "read and applied". Optional until the service sends them. */
+  context_length: z10.int().min(512).max(131072).optional(),
+  gpu_layers: z10.int().min(-1).max(999).optional(),
+  threads: z10.int().min(1).max(512).optional()
+});
 var ModelsLlmStatusParams = z10.strictObject({});
 var ModelsLlmStatusResult = z10.strictObject({
   state: LlmServerState,
@@ -912,12 +909,57 @@ var ModelsLlmInstallParams = z10.strictObject({ model: TextModelId });
 var ModelsLlmInstallResult = z10.strictObject({ model: TextModelId, elapsed_ms: nonNegInt });
 var ModelsLlmStartParams = z10.strictObject({
   model: TextModelId,
-  /** Tokens of context; the service picks a size that fits this computer when omitted. */
-  context_length: z10.int().min(512).max(131072).optional()
+  /** Tokens of context, from the knob desktop.models/context_length. Omitted today means the service's fixed 4096 (optional until callers send it). */
+  context_length: z10.int().min(512).max(131072).optional(),
+  /** (1.48) Layers offloaded to the GPU; -1 = all. From the knob desktop.models/gpu_layers. */
+  gpu_layers: z10.int().min(-1).max(999).optional(),
+  /** (1.48) CPU threads, computed by the app from the knobs. */
+  threads: z10.int().min(1).max(512).optional(),
+  /** (1.48) Seconds to wait for the model to load, computed by the app from the knobs. */
+  load_timeout_s: z10.int().min(10).max(3600).optional()
 });
 var ModelsLlmStartResult = z10.strictObject({ running: LlmRunning, elapsed_ms: nonNegInt });
 var ModelsLlmStopParams = z10.strictObject({});
 var ModelsLlmStopResult = z10.strictObject({ stopped: z10.boolean() });
+var Sha256Hex = z10.string().regex(/^[0-9a-f]{64}$/);
+var CatalogFile = z10.strictObject({
+  /** Path inside the model's folder (the artifact's path_in_repo). */
+  path: z10.string().min(1).max(512),
+  /** The pinned https URL it is downloaded from. */
+  url: z10.string().url().max(2048),
+  size_bytes: nonNegInt,
+  sha256: Sha256Hex,
+  /** weights, weights_shard, mmproj, config, tokenizer, … (ai.model_artifact.role). */
+  role: z10.string().max(32)
+});
+var CatalogModelEntry = z10.strictObject({
+  /** The key callers name this model by (the 1.48 id for a seeded model). */
+  key: ModelKey,
+  /** The selected variant's key (`q4_k_m`, `ct2`). */
+  variant: z10.string().min(1).max(64),
+  /** The upstream revision (or the variant id when there is none): a change re-downloads. */
+  revision: z10.string().min(1).max(64),
+  multilingual: z10.boolean(),
+  /** Exactly the files this computer fetches for this model: never more, never fewer. */
+  files: z10.array(CatalogFile).min(1).max(256)
+});
+var LlamaServerBuild = z10.strictObject({
+  version: z10.string().min(1).max(32),
+  url: z10.string().url().max(2048),
+  size_bytes: nonNegInt,
+  sha256: Sha256Hex
+});
+var MlCatalogSetParams = z10.strictObject({
+  text: z10.array(CatalogModelEntry).max(512),
+  transcription: z10.array(CatalogModelEntry).max(64),
+  /** Null where the catalog has no build for this os/arch (installs then say so). */
+  llama_server: LlamaServerBuild.nullable(),
+  /** The knob desktop.models/default_transcription_model. */
+  default_transcription: TranscriptionModelId,
+  /** When the catalog was last changed (catalog_updated_at), for the service's log. */
+  catalog_updated_at: z10.string().max(40)
+});
+var MlCatalogSetResult = z10.strictObject({ text: nonNegInt, transcription: nonNegInt });
 var DownloadKind = z10.enum(["speech_model", "text_model", "runtime"]);
 var DownloadRow = z10.strictObject({
   /** The job's key in the service: "model:base", "llm:smollm2-135m", "llm-server", "runtime". */
@@ -4589,7 +4631,8 @@ var SERVICES = {
       "ml.llm_start": { params: ModelsLlmStartParams, result: ModelsLlmStartResult },
       "ml.llm_stop": { params: ModelsLlmStopParams, result: ModelsLlmStopResult },
       "ml.downloads": { params: ModelsDownloadsListParams, result: ModelsDownloadsListResult },
-      "ml.download_cancel": { params: ModelsDownloadsCancelParams, result: ModelsDownloadsCancelResult }
+      "ml.download_cancel": { params: ModelsDownloadsCancelParams, result: ModelsDownloadsCancelResult },
+      "ml.catalog_set": { params: MlCatalogSetParams, result: MlCatalogSetResult }
     }
   },
   coding: {
@@ -4741,6 +4784,13 @@ var NAMED_SCHEMAS = {
   ModelsProgressEvent,
   TextModelId,
   TextModelInfo,
+  ModelKey,
+  Sha256Hex,
+  CatalogFile,
+  CatalogModelEntry,
+  LlamaServerBuild,
+  MlCatalogSetParams,
+  MlCatalogSetResult,
   LlmServerState,
   LlmRunning,
   ModelsLlmStatusParams,
@@ -5388,6 +5438,8 @@ var NAMED_SCHEMAS = {
 
 // src/versioning.ts
 var FIELDS_SINCE = {
+  LlmRunning: { context_length: "1.48", gpu_layers: "1.48", threads: "1.48" },
+  ModelsLlmStartParams: { gpu_layers: "1.48", threads: "1.48", load_timeout_s: "1.48" },
   FsPatchResult: { edits_applied: "1.1", edits_failed: "1.1" },
   "ProtocolErrorBody.data": { edits_failed: "1.1" },
   "RelayCallResponse|0": { protocol_version: "1.1" },
@@ -5584,7 +5636,7 @@ function forPeer(op, part, value, version) {
 var VERSIONED_RESULT_OPS = [.../* @__PURE__ */ new Set([...RESULT_PATH.keys(), ...WINDOW_RESULTS.keys(), ...NESTED_RESULTS.keys()])];
 
 // src/contract.ts
-var CONTRACT_SHA256 = "502c8718b1d2fd0fde43daed047da5a7b158f81ffa3846c7d73cda879777fe37";
+var CONTRACT_SHA256 = "783487638685c921a761d27c5c6dca3103d1d6d5ae0ec38ffd59086b68a2207a";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -6154,6 +6206,8 @@ export {
   CalendarListParams,
   CalendarListResult,
   CancelMsg,
+  CatalogFile,
+  CatalogModelEntry,
   ChatAppProject,
   ChatFamily,
   ChatHidden,
@@ -6439,6 +6493,7 @@ export {
   LEGACY_ACTIONS,
   LEGACY_DISPATCHERS,
   Limits,
+  LlamaServerBuild,
   LlmRunning,
   LlmServerState,
   LocationGetParams,
@@ -6460,6 +6515,8 @@ export {
   MessagesMessage,
   MessagesSendParams,
   MessagesSendResult,
+  MlCatalogSetParams,
+  MlCatalogSetResult,
   MlInstallPhase,
   MlInstallProgress,
   MlProgress,
@@ -6468,6 +6525,7 @@ export {
   MlServiceStatus,
   MlStatusParams,
   MlStatusResult,
+  ModelKey,
   ModelsDownloadsCancelParams,
   ModelsDownloadsCancelResult,
   ModelsDownloadsListParams,
@@ -6657,6 +6715,7 @@ export {
   SessionListResult,
   SessionReleaseParams,
   SessionReleaseResult,
+  Sha256Hex,
   ShownSection,
   Signal,
   SpendAccount,