@ai-matrx/desktop-protocol 0.17.11 → 0.17.12

package/dist/react.d.ts

@@ -2687,6 +2687,121 @@ declare const OPS: {
         readonly since: "1.6";
         readonly errors: readonly ["NOT_FOUND", "INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"];
     };
+    readonly "stack.state": {
+        readonly params: z.ZodObject<{}, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            config_path: z.ZodNullable<z.ZodString>;
+            problem: z.ZodNullable<z.ZodString>;
+            stack_up: z.ZodBoolean;
+            stack_started_at_ms: z.ZodNullable<z.ZodInt>;
+            servers: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                label: z.ZodString;
+                tone: z.ZodEnum<{
+                    good: "good";
+                    wait: "wait";
+                    bad: "bad";
+                    off: "off";
+                }>;
+                sentence: z.ZodString;
+                description: z.ZodString;
+                open_url: z.ZodNullable<z.ZodString>;
+                log_file: z.ZodString;
+                last_output_at_ms: z.ZodNullable<z.ZodInt>;
+                started_at_ms: z.ZodNullable<z.ZodInt>;
+                restarts: z.ZodInt;
+                exit_code: z.ZodNullable<z.ZodInt>;
+                pid: z.ZodNullable<z.ZodInt>;
+            }, z.core.$strict>>;
+            setup_note: z.ZodNullable<z.ZodString>;
+            pending: z.ZodNullable<z.ZodObject<{
+                verb: z.ZodEnum<{
+                    stop: "stop";
+                    start: "start";
+                }>;
+                label: z.ZodString;
+                since_ms: z.ZodInt;
+            }, z.core.$strict>>;
+            events: z.ZodArray<z.ZodObject<{
+                at_ms: z.ZodInt;
+                server: z.ZodString;
+                kind: z.ZodString;
+                text: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.16";
+        readonly errors: readonly ["INTERNAL"];
+    };
+    readonly "stack.start": {
+        readonly params: z.ZodObject<{}, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            accepted: z.ZodBoolean;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.16";
+        readonly errors: readonly ["RESOURCE_BUSY", "PLATFORM_UNSUPPORTED", "INTERNAL"];
+    };
+    readonly "stack.stop": {
+        readonly params: z.ZodObject<{}, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            accepted: z.ZodBoolean;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.16";
+        readonly errors: readonly ["RESOURCE_BUSY", "PLATFORM_UNSUPPORTED", "INTERNAL"];
+    };
+    readonly "stack.server.action": {
+        readonly params: z.ZodObject<{
+            name: z.ZodString;
+            verb: z.ZodEnum<{
+                stop: "stop";
+                start: "start";
+                restart: "restart";
+            }>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            message: z.ZodString;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.16";
+        readonly errors: readonly ["NOT_FOUND", "CONFLICT", "INTERNAL"];
+    };
+    readonly "stack.logs": {
+        readonly params: z.ZodObject<{
+            name: z.ZodString;
+            lines: z.ZodDefault<z.ZodInt>;
+            offset: z.ZodOptional<z.ZodInt>;
+            since: z.ZodOptional<z.ZodInt>;
+            wait_ms: z.ZodDefault<z.ZodInt>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            lines: z.ZodArray<z.ZodString>;
+            offset: z.ZodInt;
+            since_valid: z.ZodBoolean;
+            reset: z.ZodBoolean;
+            log_file: z.ZodString;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.16";
+        readonly errors: readonly ["NOT_FOUND", "INTERNAL"];
+    };
+    readonly "stack.errors": {
+        readonly params: z.ZodObject<{
+            window_minutes: z.ZodDefault<z.ZodInt>;
+        }, z.core.$strict>;
+        readonly result: z.ZodObject<{
+            sections: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                heading: z.ZodString;
+                lines: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>;
+            window_minutes: z.ZodInt;
+        }, z.core.$strict>;
+        readonly kind: "unary";
+        readonly since: "1.16";
+        readonly errors: readonly ["INTERNAL"];
+    };
     readonly "coding.history.import_missing": {
         readonly params: z.ZodObject<{}, z.core.$strict>;
         readonly result: z.ZodObject<{

package/generated/desktop-protocol.schema.json

@@ -5279,6 +5279,454 @@
       ],
       "additionalProperties": false
     },
+    "StackServerName": {
+      "type": "string",
+      "pattern": "^[a-z0-9_-]{1,64}$"
+    },
+    "StackTone": {
+      "type": "string",
+      "enum": [
+        "good",
+        "wait",
+        "bad",
+        "off"
+      ]
+    },
+    "StackServer": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "$ref": "#/$defs/StackServerName"
+        },
+        "label": {
+          "type": "string",
+          "maxLength": 32
+        },
+        "tone": {
+          "$ref": "#/$defs/StackTone"
+        },
+        "sentence": {
+          "type": "string",
+          "maxLength": 2000
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 512
+        },
+        "open_url": {
+          "anyOf": [
+            {
+              "type": "string",
+              "maxLength": 2048
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "log_file": {
+          "type": "string",
+          "maxLength": 4096
+        },
+        "last_output_at_ms": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "started_at_ms": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "restarts": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "exit_code": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "pid": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "required": [
+        "name",
+        "label",
+        "tone",
+        "sentence",
+        "description",
+        "open_url",
+        "log_file",
+        "last_output_at_ms",
+        "started_at_ms",
+        "restarts",
+        "exit_code",
+        "pid"
+      ],
+      "additionalProperties": false
+    },
+    "StackEvent": {
+      "type": "object",
+      "properties": {
+        "at_ms": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "server": {
+          "type": "string",
+          "maxLength": 64
+        },
+        "kind": {
+          "type": "string",
+          "maxLength": 32
+        },
+        "text": {
+          "type": "string",
+          "maxLength": 4000
+        }
+      },
+      "required": [
+        "at_ms",
+        "server",
+        "kind",
+        "text"
+      ],
+      "additionalProperties": false
+    },
+    "StackStateParams": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false
+    },
+    "StackStateResult": {
+      "type": "object",
+      "properties": {
+        "config_path": {
+          "anyOf": [
+            {
+              "type": "string",
+              "maxLength": 4096
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "problem": {
+          "anyOf": [
+            {
+              "type": "string",
+              "maxLength": 1000
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "stack_up": {
+          "type": "boolean"
+        },
+        "stack_started_at_ms": {
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "servers": {
+          "maxItems": 64,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/StackServer"
+          }
+        },
+        "setup_note": {
+          "anyOf": [
+            {
+              "type": "string",
+              "maxLength": 500
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "pending": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": {
+                "verb": {
+                  "type": "string",
+                  "enum": [
+                    "start",
+                    "stop"
+                  ]
+                },
+                "label": {
+                  "type": "string",
+                  "maxLength": 64
+                },
+                "since_ms": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                }
+              },
+              "required": [
+                "verb",
+                "label",
+                "since_ms"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "events": {
+          "maxItems": 300,
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/StackEvent"
+          }
+        }
+      },
+      "required": [
+        "config_path",
+        "problem",
+        "stack_up",
+        "stack_started_at_ms",
+        "servers",
+        "setup_note",
+        "pending",
+        "events"
+      ],
+      "additionalProperties": false
+    },
+    "StackStartParams": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false
+    },
+    "StackStopParams": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false
+    },
+    "StackRunResult": {
+      "type": "object",
+      "properties": {
+        "accepted": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "accepted"
+      ],
+      "additionalProperties": false
+    },
+    "StackServerActionParams": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "$ref": "#/$defs/StackServerName"
+        },
+        "verb": {
+          "type": "string",
+          "enum": [
+            "start",
+            "stop",
+            "restart"
+          ]
+        }
+      },
+      "required": [
+        "name",
+        "verb"
+      ],
+      "additionalProperties": false
+    },
+    "StackServerActionResult": {
+      "type": "object",
+      "properties": {
+        "message": {
+          "type": "string",
+          "maxLength": 1000
+        }
+      },
+      "required": [
+        "message"
+      ],
+      "additionalProperties": false
+    },
+    "StackLogsParams": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "$ref": "#/$defs/StackServerName"
+        },
+        "lines": {
+          "default": 2000,
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 200000
+        },
+        "offset": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "since": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "wait_ms": {
+          "default": 0,
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 25000
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "additionalProperties": false
+    },
+    "StackLogsResult": {
+      "type": "object",
+      "properties": {
+        "lines": {
+          "maxItems": 200000,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "maxLength": 65536
+          }
+        },
+        "offset": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "since_valid": {
+          "type": "boolean"
+        },
+        "reset": {
+          "type": "boolean"
+        },
+        "log_file": {
+          "type": "string",
+          "maxLength": 4096
+        }
+      },
+      "required": [
+        "lines",
+        "offset",
+        "since_valid",
+        "reset",
+        "log_file"
+      ],
+      "additionalProperties": false
+    },
+    "StackErrorsParams": {
+      "type": "object",
+      "properties": {
+        "window_minutes": {
+          "default": 60,
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 1440
+        }
+      },
+      "additionalProperties": false
+    },
+    "StackErrorsResult": {
+      "type": "object",
+      "properties": {
+        "sections": {
+          "maxItems": 64,
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "$ref": "#/$defs/StackServerName"
+              },
+              "heading": {
+                "type": "string",
+                "maxLength": 4096
+              },
+              "lines": {
+                "maxItems": 5000,
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "maxLength": 65536
+                }
+              }
+            },
+            "required": [
+              "name",
+              "heading",
+              "lines"
+            ],
+            "additionalProperties": false
+          }
+        },
+        "window_minutes": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 1440
+        }
+      },
+      "required": [
+        "sections",
+        "window_minutes"
+      ],
+      "additionalProperties": false
+    },
     "FsWatchId": {
       "type": "string",
       "pattern": "^fw_[A-Za-z0-9]{12,40}$"
@@ -9455,6 +9903,67 @@
         "INTERNAL"
       ]
     },
+    "stack.state": {
+      "params": "StackStateParams",
+      "result": "StackStateResult",
+      "kind": "unary",
+      "since": "1.16",
+      "errors": [
+        "INTERNAL"
+      ]
+    },
+    "stack.start": {
+      "params": "StackStartParams",
+      "result": "StackRunResult",
+      "kind": "unary",
+      "since": "1.16",
+      "errors": [
+        "RESOURCE_BUSY",
+        "PLATFORM_UNSUPPORTED",
+        "INTERNAL"
+      ]
+    },
+    "stack.stop": {
+      "params": "StackStopParams",
+      "result": "StackRunResult",
+      "kind": "unary",
+      "since": "1.16",
+      "errors": [
+        "RESOURCE_BUSY",
+        "PLATFORM_UNSUPPORTED",
+        "INTERNAL"
+      ]
+    },
+    "stack.server.action": {
+      "params": "StackServerActionParams",
+      "result": "StackServerActionResult",
+      "kind": "unary",
+      "since": "1.16",
+      "errors": [
+        "NOT_FOUND",
+        "CONFLICT",
+        "INTERNAL"
+      ]
+    },
+    "stack.logs": {
+      "params": "StackLogsParams",
+      "result": "StackLogsResult",
+      "kind": "unary",
+      "since": "1.16",
+      "errors": [
+        "NOT_FOUND",
+        "INTERNAL"
+      ]
+    },
+    "stack.errors": {
+      "params": "StackErrorsParams",
+      "result": "StackErrorsResult",
+      "kind": "unary",
+      "since": "1.16",
+      "errors": [
+        "INTERNAL"
+      ]
+    },
     "coding.history.import_missing": {
       "params": "CodingHistoryImportMissingParams",
       "result": "CodingHistoryImportMissingResult",
@@ -9561,5 +10070,5 @@
       "olderPeersGet": 0
     }
   },
-  "x-protocol-version": "1.15"
+  "x-protocol-version": "1.16"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/desktop-protocol",
-  "version": "0.17.11",
+  "version": "0.17.12",
   "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",