@ai-matrx/desktop-protocol 0.21.95 → 0.21.96

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { O as OpName } from './models-BfCwxx-G.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 EmbeddingVector, v as EndMsg, E as EndReason, w as ErrorCode, x as ErrorCodeName, y as ErrorData, z as ErrorMsg, A as ErrorReason, F as ErrorReasonName, G as EventMsg, H as EventName, I as FsPatchEditFailure, J as HelloMsg, L as Limits, K as LlamaServerBuild, N as LlmEmbeddingSlot, P as LlmRunning, Q as LlmServerState, R as LlmSlot, U as LocalModelKind, V as LocalModelRow, X as MlCatalogSetParams, Y as MlCatalogSetResult, Z as MlInstallPhase, _ as MlInstallProgress, f as MlProgress, $ as MlRuntimeState, a0 as MlServiceState, a1 as MlServiceStatus, a2 as MlStatusParams, a3 as MlStatusResult, a4 as ModelKey, a5 as ModelsDownloadsCancelParams, a6 as ModelsDownloadsCancelResult, a7 as ModelsDownloadsListParams, a8 as ModelsDownloadsListResult, a9 as ModelsEmbedParams, aa as ModelsEmbedResult, ab as ModelsInstallParams, ac as ModelsInstallResult, ad as ModelsLlmChatParams, ae as ModelsLlmChatResult, af as ModelsLlmInstallParams, ag as ModelsLlmInstallResult, ah as ModelsLlmStartParams, ai as ModelsLlmStartResult, aj as ModelsLlmStatusParams, ak as ModelsLlmStatusResult, al as ModelsLlmStopParams, am as ModelsLlmStopResult, an as ModelsLocalListParams, ao as ModelsLocalListResult, ap as ModelsLocalRemoveParams, aq as ModelsLocalRemoveResult, ar as ModelsProgressEvent, as as ModelsStatusParams, at as ModelsStatusResult, au as ModelsTranscribeParams, M as ModelsTranscribeResult, av as ModelsTtsInstallParams, aw as ModelsTtsInstallResult, ax as ModelsTtsSpeakParams, ay as ModelsTtsSpeakResult, az as ModelsTtsStatusParams, aA as ModelsTtsStatusResult, aB as ModelsTtsVoiceRemoveParams, aC as ModelsTtsVoiceRemoveResult, aD as ModelsTtsVoiceSaveParams, aE as ModelsTtsVoiceSaveResult, aF as ModelsWakeCloseParams, aG as ModelsWakeCloseResult, aH as ModelsWakeDetectParams, aI as ModelsWakeDetectResult, aJ as ModelsWakeInstallParams, aK as ModelsWakeInstallResult, aL as ModelsWakeStatusParams, aM as ModelsWakeStatusResult, aN as NAMED_SCHEMAS, aO as NamedSchemaId, c as OPS, aP as OpDescriptor, a as OpParams, b as OpResult, aQ as OpSpec, aR as PING_TEXT, aS as PONG_TEXT, aT as ProtocolErrorBody, aU as RelayMsg, aV as RequestMsg, aW as ResponseMsg, aX as SERVICES, aY as SUBPROTOCOL, aZ as ServiceId, a_ as ServiceOpName, a$ as ServiceOpSpec, b0 as ServiceSpec, b1 as Sha256Hex, S as StreamMeta, b2 as StreamMsg, b3 as TextModelId, b4 as TextModelInfo, b5 as TranscriptSegment, T as TranscriptionModelId, b6 as TranscriptionModelInfo, b7 as TtsAudioChunk, b8 as TtsBlendPart, b9 as TtsModelInfo, ba as TtsVoice, bb as TtsVoiceId, bc as UnusableTextModel, bd as WAKE_PCM_MAX_CHARS, be as WakeEngine, bf as WakeModelInfo, W as Welcome, bg as closeRule, i as isDesktopProtocolError, bh as isTerminalClose } from './models-BfCwxx-G.cjs';
+import { O as OpName } from './models-CW7-r8m4.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 EmbeddingVector, v as EndMsg, E as EndReason, w as ErrorCode, x as ErrorCodeName, y as ErrorData, z as ErrorMsg, A as ErrorReason, F as ErrorReasonName, G as EventMsg, H as EventName, I as FsPatchEditFailure, J as HelloMsg, L as Limits, K as LlamaServerBuild, N as LlmEmbeddingSlot, P as LlmRunning, Q as LlmServerState, R as LlmSlot, U as LocalModelKind, V as LocalModelRow, X as MlCatalogSetParams, Y as MlCatalogSetResult, Z as MlInstallPhase, _ as MlInstallProgress, f as MlProgress, $ as MlRuntimeState, a0 as MlServiceState, a1 as MlServiceStatus, a2 as MlStatusParams, a3 as MlStatusResult, a4 as ModelKey, a5 as ModelsDownloadsCancelParams, a6 as ModelsDownloadsCancelResult, a7 as ModelsDownloadsListParams, a8 as ModelsDownloadsListResult, a9 as ModelsEmbedParams, aa as ModelsEmbedResult, ab as ModelsInstallParams, ac as ModelsInstallResult, ad as ModelsLlmChatParams, ae as ModelsLlmChatResult, af as ModelsLlmInstallParams, ag as ModelsLlmInstallResult, ah as ModelsLlmStartParams, ai as ModelsLlmStartResult, aj as ModelsLlmStatusParams, ak as ModelsLlmStatusResult, al as ModelsLlmStopParams, am as ModelsLlmStopResult, an as ModelsLocalListParams, ao as ModelsLocalListResult, ap as ModelsLocalRemoveParams, aq as ModelsLocalRemoveResult, ar as ModelsProgressEvent, as as ModelsStatusParams, at as ModelsStatusResult, au as ModelsTranscribeParams, M as ModelsTranscribeResult, av as ModelsTtsInstallParams, aw as ModelsTtsInstallResult, ax as ModelsTtsSpeakParams, ay as ModelsTtsSpeakResult, az as ModelsTtsStatusParams, aA as ModelsTtsStatusResult, aB as ModelsTtsVoiceRemoveParams, aC as ModelsTtsVoiceRemoveResult, aD as ModelsTtsVoiceSaveParams, aE as ModelsTtsVoiceSaveResult, aF as ModelsWakeCloseParams, aG as ModelsWakeCloseResult, aH as ModelsWakeDetectParams, aI as ModelsWakeDetectResult, aJ as ModelsWakeInstallParams, aK as ModelsWakeInstallResult, aL as ModelsWakeStatusParams, aM as ModelsWakeStatusResult, aN as NAMED_SCHEMAS, aO as NamedSchemaId, c as OPS, aP as OpDescriptor, a as OpParams, b as OpResult, aQ as OpSpec, aR as PING_TEXT, aS as PONG_TEXT, aT as ProtocolErrorBody, aU as RelayMsg, aV as RequestMsg, aW as ResponseMsg, aX as SERVICES, aY as SUBPROTOCOL, aZ as ServiceId, a_ as ServiceOpName, a$ as ServiceOpSpec, b0 as ServiceSpec, b1 as Sha256Hex, S as StreamMeta, b2 as StreamMsg, b3 as TextModelId, b4 as TextModelInfo, b5 as TranscriptSegment, T as TranscriptionModelId, b6 as TranscriptionModelInfo, b7 as TtsAudioChunk, b8 as TtsBlendPart, b9 as TtsModelInfo, ba as TtsVoice, bb as TtsVoiceId, bc as UnusableTextModel, bd as WAKE_PCM_MAX_CHARS, be as WakeEngine, bf as WakeModelInfo, W as Welcome, bg as closeRule, i as isDesktopProtocolError, bh as isTerminalClose } from './models-CW7-r8m4.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. */

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { O as OpName } from './models-BfCwxx-G.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 EmbeddingVector, v as EndMsg, E as EndReason, w as ErrorCode, x as ErrorCodeName, y as ErrorData, z as ErrorMsg, A as ErrorReason, F as ErrorReasonName, G as EventMsg, H as EventName, I as FsPatchEditFailure, J as HelloMsg, L as Limits, K as LlamaServerBuild, N as LlmEmbeddingSlot, P as LlmRunning, Q as LlmServerState, R as LlmSlot, U as LocalModelKind, V as LocalModelRow, X as MlCatalogSetParams, Y as MlCatalogSetResult, Z as MlInstallPhase, _ as MlInstallProgress, f as MlProgress, $ as MlRuntimeState, a0 as MlServiceState, a1 as MlServiceStatus, a2 as MlStatusParams, a3 as MlStatusResult, a4 as ModelKey, a5 as ModelsDownloadsCancelParams, a6 as ModelsDownloadsCancelResult, a7 as ModelsDownloadsListParams, a8 as ModelsDownloadsListResult, a9 as ModelsEmbedParams, aa as ModelsEmbedResult, ab as ModelsInstallParams, ac as ModelsInstallResult, ad as ModelsLlmChatParams, ae as ModelsLlmChatResult, af as ModelsLlmInstallParams, ag as ModelsLlmInstallResult, ah as ModelsLlmStartParams, ai as ModelsLlmStartResult, aj as ModelsLlmStatusParams, ak as ModelsLlmStatusResult, al as ModelsLlmStopParams, am as ModelsLlmStopResult, an as ModelsLocalListParams, ao as ModelsLocalListResult, ap as ModelsLocalRemoveParams, aq as ModelsLocalRemoveResult, ar as ModelsProgressEvent, as as ModelsStatusParams, at as ModelsStatusResult, au as ModelsTranscribeParams, M as ModelsTranscribeResult, av as ModelsTtsInstallParams, aw as ModelsTtsInstallResult, ax as ModelsTtsSpeakParams, ay as ModelsTtsSpeakResult, az as ModelsTtsStatusParams, aA as ModelsTtsStatusResult, aB as ModelsTtsVoiceRemoveParams, aC as ModelsTtsVoiceRemoveResult, aD as ModelsTtsVoiceSaveParams, aE as ModelsTtsVoiceSaveResult, aF as ModelsWakeCloseParams, aG as ModelsWakeCloseResult, aH as ModelsWakeDetectParams, aI as ModelsWakeDetectResult, aJ as ModelsWakeInstallParams, aK as ModelsWakeInstallResult, aL as ModelsWakeStatusParams, aM as ModelsWakeStatusResult, aN as NAMED_SCHEMAS, aO as NamedSchemaId, c as OPS, aP as OpDescriptor, a as OpParams, b as OpResult, aQ as OpSpec, aR as PING_TEXT, aS as PONG_TEXT, aT as ProtocolErrorBody, aU as RelayMsg, aV as RequestMsg, aW as ResponseMsg, aX as SERVICES, aY as SUBPROTOCOL, aZ as ServiceId, a_ as ServiceOpName, a$ as ServiceOpSpec, b0 as ServiceSpec, b1 as Sha256Hex, S as StreamMeta, b2 as StreamMsg, b3 as TextModelId, b4 as TextModelInfo, b5 as TranscriptSegment, T as TranscriptionModelId, b6 as TranscriptionModelInfo, b7 as TtsAudioChunk, b8 as TtsBlendPart, b9 as TtsModelInfo, ba as TtsVoice, bb as TtsVoiceId, bc as UnusableTextModel, bd as WAKE_PCM_MAX_CHARS, be as WakeEngine, bf as WakeModelInfo, W as Welcome, bg as closeRule, i as isDesktopProtocolError, bh as isTerminalClose } from './models-BfCwxx-G.js';
+import { O as OpName } from './models-CW7-r8m4.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 EmbeddingVector, v as EndMsg, E as EndReason, w as ErrorCode, x as ErrorCodeName, y as ErrorData, z as ErrorMsg, A as ErrorReason, F as ErrorReasonName, G as EventMsg, H as EventName, I as FsPatchEditFailure, J as HelloMsg, L as Limits, K as LlamaServerBuild, N as LlmEmbeddingSlot, P as LlmRunning, Q as LlmServerState, R as LlmSlot, U as LocalModelKind, V as LocalModelRow, X as MlCatalogSetParams, Y as MlCatalogSetResult, Z as MlInstallPhase, _ as MlInstallProgress, f as MlProgress, $ as MlRuntimeState, a0 as MlServiceState, a1 as MlServiceStatus, a2 as MlStatusParams, a3 as MlStatusResult, a4 as ModelKey, a5 as ModelsDownloadsCancelParams, a6 as ModelsDownloadsCancelResult, a7 as ModelsDownloadsListParams, a8 as ModelsDownloadsListResult, a9 as ModelsEmbedParams, aa as ModelsEmbedResult, ab as ModelsInstallParams, ac as ModelsInstallResult, ad as ModelsLlmChatParams, ae as ModelsLlmChatResult, af as ModelsLlmInstallParams, ag as ModelsLlmInstallResult, ah as ModelsLlmStartParams, ai as ModelsLlmStartResult, aj as ModelsLlmStatusParams, ak as ModelsLlmStatusResult, al as ModelsLlmStopParams, am as ModelsLlmStopResult, an as ModelsLocalListParams, ao as ModelsLocalListResult, ap as ModelsLocalRemoveParams, aq as ModelsLocalRemoveResult, ar as ModelsProgressEvent, as as ModelsStatusParams, at as ModelsStatusResult, au as ModelsTranscribeParams, M as ModelsTranscribeResult, av as ModelsTtsInstallParams, aw as ModelsTtsInstallResult, ax as ModelsTtsSpeakParams, ay as ModelsTtsSpeakResult, az as ModelsTtsStatusParams, aA as ModelsTtsStatusResult, aB as ModelsTtsVoiceRemoveParams, aC as ModelsTtsVoiceRemoveResult, aD as ModelsTtsVoiceSaveParams, aE as ModelsTtsVoiceSaveResult, aF as ModelsWakeCloseParams, aG as ModelsWakeCloseResult, aH as ModelsWakeDetectParams, aI as ModelsWakeDetectResult, aJ as ModelsWakeInstallParams, aK as ModelsWakeInstallResult, aL as ModelsWakeStatusParams, aM as ModelsWakeStatusResult, aN as NAMED_SCHEMAS, aO as NamedSchemaId, c as OPS, aP as OpDescriptor, a as OpParams, b as OpResult, aQ as OpSpec, aR as PING_TEXT, aS as PONG_TEXT, aT as ProtocolErrorBody, aU as RelayMsg, aV as RequestMsg, aW as ResponseMsg, aX as SERVICES, aY as SUBPROTOCOL, aZ as ServiceId, a_ as ServiceOpName, a$ as ServiceOpSpec, b0 as ServiceSpec, b1 as Sha256Hex, S as StreamMeta, b2 as StreamMsg, b3 as TextModelId, b4 as TextModelInfo, b5 as TranscriptSegment, T as TranscriptionModelId, b6 as TranscriptionModelInfo, b7 as TtsAudioChunk, b8 as TtsBlendPart, b9 as TtsModelInfo, ba as TtsVoice, bb as TtsVoiceId, bc as UnusableTextModel, bd as WAKE_PCM_MAX_CHARS, be as WakeEngine, bf as WakeModelInfo, W as Welcome, bg as closeRule, i as isDesktopProtocolError, bh as isTerminalClose } from './models-CW7-r8m4.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. */

package/dist/index.js

@@ -951,7 +951,7 @@ import {
   WindowsServiceControlResult,
   WindowsServicesParams,
   WindowsServicesResult
-} from "./chunk-server-BQQPFQSL.js";
+} from "./chunk-server-HU5BCBEF.js";
 import {
   AbsPath,
   BEARER_PREFIX,

package/dist/{models-BfCwxx-G.d.cts → models-CW7-r8m4.d.cts}

@@ -10589,9 +10589,16 @@ type EventName = keyof typeof EVENTS;
  * from this table (scripts/gen_pydantic.py); the core's service client is typed by it. A Router
  * op that a capability owner forwards uses the same params/result schemas as its service op.
  */
+/**
+ * `planned`: declared for the clients' types, but no desktop handler serves it yet. A planned op is
+ * kept out of the served contract (the Python handler Protocol and the SERVICES table the service
+ * boots against), so publishing it never stops a relocked desktop's service from starting. It moves
+ * to SERVED_SERVICE_OPS (src/schema/served-service-ops.ts) in the change that lands its handler.
+ */
 type ServiceOpSpec = {
     readonly params: z.ZodType;
     readonly result: z.ZodType;
+    readonly planned?: true;
 };
 type ServiceSpec = {
     readonly progress: z.ZodType;

package/dist/{models-BfCwxx-G.d.ts → models-CW7-r8m4.d.ts}

@@ -10589,9 +10589,16 @@ type EventName = keyof typeof EVENTS;
  * from this table (scripts/gen_pydantic.py); the core's service client is typed by it. A Router
  * op that a capability owner forwards uses the same params/result schemas as its service op.
  */
+/**
+ * `planned`: declared for the clients' types, but no desktop handler serves it yet. A planned op is
+ * kept out of the served contract (the Python handler Protocol and the SERVICES table the service
+ * boots against), so publishing it never stops a relocked desktop's service from starting. It moves
+ * to SERVED_SERVICE_OPS (src/schema/served-service-ops.ts) in the change that lands its handler.
+ */
 type ServiceOpSpec = {
     readonly params: z.ZodType;
     readonly result: z.ZodType;
+    readonly planned?: true;
 };
 type ServiceSpec = {
     readonly progress: z.ZodType;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/desktop-protocol",
-  "version": "0.21.95",
+  "version": "0.21.96",
   "description": "The one wire contract between Matrx 2 (the desktop app) and every client that drives it — phone, web app, extension, server: zod schemas for the envelope and every cap.op, the 16-byte binary frame codec, a reconnecting request/stream/credit/reattach client, React hooks, and a generated JSON Schema + Pydantic twin that CI keeps byte-identical.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -98,5 +98,5 @@
     "node": ">=20"
   },
   "sideEffects": false,
-  "gitHead": "141397109f2ac696e1b507056f3cb0bedee9ba0f"
+  "gitHead": "cf96f355636de937738b2161490614a412f9e775"
 }

package/scripts/gen_pydantic.py

@@ -299,6 +299,9 @@ def services(doc: dict, contract_sha256: str) -> str:
         ]
         table.append(f"    {service!r}: {{")
         for op, o in spec["ops"].items():
+            if o.get("planned"):
+                # A planned op has no desktop handler yet: it stays out of the served contract.
+                continue
             prefix = f"{service}."
             if not op.startswith(prefix):
                 raise SystemExit(f"gen_pydantic: service op {op} does not start with {prefix}")