@ai-matrx/desktop-protocol 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,935 @@
+import { z } from 'zod';
+export { e as CancelMsg, f as ClientToCoreMsg, C as ClientType, g as CloseCode, h as CoreToClientMsg, j as CreditMsg, D as DesktopProtocolError, d as EVENTS, k as EndMsg, E as EndReason, l as ErrorCode, m as ErrorCodeName, n as ErrorData, o as ErrorMsg, p as ErrorReason, q as ErrorReasonName, r as EventMsg, s as EventName, H as HelloMsg, L as Limits, N as NAMED_SCHEMAS, t as NamedSchemaId, c as OPS, u as OpDescriptor, O as OpName, a as OpParams, b as OpResult, v as OpSpec, P as PING_TEXT, w as PONG_TEXT, x as ProtocolErrorBody, R as RelayMsg, y as RequestMsg, z as ResponseMsg, S as StreamMeta, A as StreamMsg, W as Welcome, i as isDesktopProtocolError } from './registry-DTcTGycI.cjs';
+export { DecodedFrame, FRAME_HEADER_BYTES, FRAME_STRUCT_FORMAT, FRAME_VERSION, FrameChannel, FrameChannelValue, FrameFlag, assertFrameHeader, decodeFrame, encodeFrame, hasFlag, readCid, stampCid } from './frame.cjs';
+
+/** @ai-matrx/desktop-protocol — version and primitive schemas. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
+
+declare const PROTOCOL_MAJOR: 1;
+declare const PROTOCOL_MINOR: 0;
+/** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
+declare const u32: z.ZodInt;
+declare const nonNegInt: z.ZodInt;
+/** Unix epoch milliseconds. */
+declare const epochMs: z.ZodInt;
+/** "major.minor". Same major = compatible (minor adds optional fields/ops only). */
+declare const ProtocolVersion: z.ZodString;
+type ProtocolVersion = z.output<typeof ProtocolVersion>;
+/** Client-generated request id, unique per session. */
+declare const RequestId: z.ZodString;
+type RequestId = z.output<typeof RequestId>;
+/** Long-lived resource handle minted by the core: "<kind>_<base62>" (pty_…, watch_…). */
+declare const ResourceId: z.ZodString;
+type ResourceId = z.output<typeof ResourceId>;
+/**
+ * = app_instances.id. A plain pattern, NOT z.uuid(): z.uuid() emits `format: uuid` + `pattern`,
+ * which datamodel-codegen renders as `Annotated[UUID, Field(pattern=...)]` — a model Pydantic can
+ * never validate ("Unable to apply constraint 'pattern' … of type 'uuid'"). generate.ts now
+ * refuses format+pattern on one node so this class cannot come back.
+ */
+declare const DeviceId: z.ZodString;
+type DeviceId = z.output<typeof DeviceId>;
+/**
+ * Absolute, normalized path: forward slashes on every OS, NFC. POSIX "/..." or Windows "C:/...".
+ * Normalization happens once, in the fs owner (SPEC §9); the wire never carries backslashes.
+ */
+declare const AbsPath: z.ZodString;
+type AbsPath = z.output<typeof AbsPath>;
+
+/** @ai-matrx/desktop-protocol — binary frame header and flow-control constants. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
+
+/** Zod twin of the codec's FrameHeader (layout documented in src/frame.ts) — for $defs and Pydantic. */
+declare const FrameHeader: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    flags: z.ZodInt;
+    channel: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<255>]>;
+    cid: z.ZodInt;
+    sid: z.ZodInt;
+    seq: z.ZodInt;
+}, z.core.$strict>;
+type FrameHeader = z.infer<typeof FrameHeader>;
+declare const DEFAULT_WINDOW_BYTES: 262144;
+declare const DEFAULT_MAX_FRAME_PAYLOAD_BYTES: 65536;
+declare const DEFAULT_MAX_MESSAGE_BYTES: 8388608;
+
+/** @ai-matrx/desktop-protocol — cap sysinfo. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
+
+declare const OsPermissionName: z.ZodEnum<{
+    full_disk_access: "full_disk_access";
+    accessibility: "accessibility";
+    screen_recording: "screen_recording";
+    microphone: "microphone";
+    camera: "camera";
+    automation: "automation";
+    contacts: "contacts";
+    calendars: "calendars";
+    photos: "photos";
+    location: "location";
+    local_network: "local_network";
+    bluetooth: "bluetooth";
+    notifications: "notifications";
+}>;
+type OsPermissionName = z.output<typeof OsPermissionName>;
+declare const SysinfoGetParams: z.ZodObject<{}, z.core.$strict>;
+type SysinfoGetParams = z.output<typeof SysinfoGetParams>;
+declare const SysinfoGetResult: z.ZodObject<{
+    device_id: z.ZodString;
+    device_name: z.ZodString;
+    hostname: z.ZodString;
+    platform: z.ZodEnum<{
+        darwin: "darwin";
+        win32: "win32";
+        linux: "linux";
+    }>;
+    os_version: z.ZodString;
+    arch: z.ZodEnum<{
+        arm64: "arm64";
+        x64: "x64";
+    }>;
+    app_version: z.ZodString;
+    protocol_version: z.ZodString;
+    user: z.ZodObject<{
+        username: z.ZodString;
+        shell: z.ZodString;
+    }, z.core.$strict>;
+    paths: z.ZodObject<{
+        home: z.ZodString;
+        desktop: z.ZodString;
+        documents: z.ZodString;
+        downloads: z.ZodString;
+        app_data: z.ZodString;
+        temp: z.ZodString;
+    }, z.core.$strict>;
+    cpu: z.ZodObject<{
+        model: z.ZodString;
+        cores: z.ZodInt;
+    }, z.core.$strict>;
+    memory: z.ZodObject<{
+        total_bytes: z.ZodInt;
+        free_bytes: z.ZodInt;
+    }, z.core.$strict>;
+    uptime_seconds: z.ZodInt;
+    on_battery: z.ZodNullable<z.ZodBoolean>;
+    sleep_prevented: z.ZodBoolean;
+    permissions: z.ZodArray<z.ZodObject<{
+        name: z.ZodEnum<{
+            full_disk_access: "full_disk_access";
+            accessibility: "accessibility";
+            screen_recording: "screen_recording";
+            microphone: "microphone";
+            camera: "camera";
+            automation: "automation";
+            contacts: "contacts";
+            calendars: "calendars";
+            photos: "photos";
+            location: "location";
+            local_network: "local_network";
+            bluetooth: "bluetooth";
+            notifications: "notifications";
+        }>;
+        state: z.ZodEnum<{
+            granted: "granted";
+            denied: "denied";
+            not_determined: "not_determined";
+            not_applicable: "not_applicable";
+        }>;
+        settings_url: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type SysinfoGetResult = z.output<typeof SysinfoGetResult>;
+
+/** @ai-matrx/desktop-protocol — cap fs. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
+
+declare const FsKind: z.ZodEnum<{
+    file: "file";
+    dir: "dir";
+    symlink: "symlink";
+}>;
+type FsKind = z.output<typeof FsKind>;
+/** = daemon get_stat_dict(), plus mtime in ms and hidden. */
+declare const FsEntry: z.ZodObject<{
+    name: z.ZodString;
+    path: z.ZodString;
+    kind: z.ZodEnum<{
+        file: "file";
+        dir: "dir";
+        symlink: "symlink";
+    }>;
+    size: z.ZodInt;
+    mtime: z.ZodNumber;
+    mtime_ms: z.ZodInt;
+    mode: z.ZodInt;
+    target: z.ZodNullable<z.ZodString>;
+    hidden: z.ZodBoolean;
+}, z.core.$strict>;
+type FsEntry = z.output<typeof FsEntry>;
+declare const FsListParams: z.ZodObject<{
+    path: z.ZodString;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+    depth: z.ZodDefault<z.ZodInt>;
+    pattern: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodInt>;
+    page_token: z.ZodOptional<z.ZodString>;
+    show_hidden: z.ZodDefault<z.ZodBoolean>;
+    sort: z.ZodDefault<z.ZodEnum<{
+        kind: "kind";
+        name: "name";
+        size: "size";
+        mtime: "mtime";
+    }>>;
+}, z.core.$strict>;
+type FsListParams = z.output<typeof FsListParams>;
+declare const FsListResult: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+        kind: z.ZodEnum<{
+            file: "file";
+            dir: "dir";
+            symlink: "symlink";
+        }>;
+        size: z.ZodInt;
+        mtime: z.ZodNumber;
+        mtime_ms: z.ZodInt;
+        mode: z.ZodInt;
+        target: z.ZodNullable<z.ZodString>;
+        hidden: z.ZodBoolean;
+    }, z.core.$strict>>;
+    truncated: z.ZodBoolean;
+    next_page_token: z.ZodNullable<z.ZodString>;
+    scanned: z.ZodInt;
+}, z.core.$strict>;
+type FsListResult = z.output<typeof FsListResult>;
+declare const FsStatParams: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strict>;
+type FsStatParams = z.output<typeof FsStatParams>;
+declare const FsStatResult: z.ZodObject<{
+    name: z.ZodString;
+    path: z.ZodString;
+    kind: z.ZodEnum<{
+        file: "file";
+        dir: "dir";
+        symlink: "symlink";
+    }>;
+    size: z.ZodInt;
+    mtime: z.ZodNumber;
+    mtime_ms: z.ZodInt;
+    mode: z.ZodInt;
+    target: z.ZodNullable<z.ZodString>;
+    hidden: z.ZodBoolean;
+}, z.core.$strict>;
+type FsStatResult = z.output<typeof FsStatResult>;
+declare const FsEncoding: z.ZodEnum<{
+    utf8: "utf8";
+    base64: "base64";
+}>;
+type FsEncoding = z.output<typeof FsEncoding>;
+/** Bounded read. offset = byte offset; limit = chars (utf8) or bytes (base64), as the daemon. */
+declare const FsReadParams: z.ZodObject<{
+    path: z.ZodString;
+    encoding: z.ZodDefault<z.ZodEnum<{
+        utf8: "utf8";
+        base64: "base64";
+    }>>;
+    offset: z.ZodDefault<z.ZodInt>;
+    limit: z.ZodDefault<z.ZodInt>;
+}, z.core.$strict>;
+type FsReadParams = z.output<typeof FsReadParams>;
+declare const FsReadResult: z.ZodObject<{
+    content: z.ZodString;
+    encoding: z.ZodEnum<{
+        utf8: "utf8";
+        base64: "base64";
+    }>;
+    size: z.ZodInt;
+    offset: z.ZodInt;
+    next_offset: z.ZodInt;
+    truncated: z.ZodBoolean;
+    mime: z.ZodNullable<z.ZodString>;
+    mtime_ms: z.ZodInt;
+}, z.core.$strict>;
+type FsReadResult = z.output<typeof FsReadResult>;
+/** Whole-file or ranged download as binary frames (channel DATA, credited). */
+declare const FsReadStreamParams: z.ZodObject<{
+    path: z.ZodString;
+    offset: z.ZodDefault<z.ZodInt>;
+    length: z.ZodOptional<z.ZodInt>;
+    window_bytes: z.ZodOptional<z.ZodInt>;
+}, z.core.$strict>;
+type FsReadStreamParams = z.output<typeof FsReadStreamParams>;
+/** Unary result arrives first (size/mime), then stream{open} + DATA frames + end. */
+declare const FsReadStreamResult: z.ZodObject<{
+    size: z.ZodInt;
+    mime: z.ZodNullable<z.ZodString>;
+    mtime_ms: z.ZodInt;
+}, z.core.$strict>;
+type FsReadStreamResult = z.output<typeof FsReadStreamResult>;
+declare const FsWriteParams: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+    encoding: z.ZodDefault<z.ZodEnum<{
+        utf8: "utf8";
+        base64: "base64";
+    }>>;
+    mode: z.ZodOptional<z.ZodInt>;
+    create_parents: z.ZodDefault<z.ZodBoolean>;
+    if_match_mtime_ms: z.ZodOptional<z.ZodInt>;
+    exclusive: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type FsWriteParams = z.output<typeof FsWriteParams>;
+/** Writes are atomic: temp file in the same directory + rename (daemon parity). */
+declare const FsWriteResult: z.ZodObject<{
+    path: z.ZodString;
+    size: z.ZodInt;
+    mtime_ms: z.ZodInt;
+    created: z.ZodBoolean;
+}, z.core.$strict>;
+type FsWriteResult = z.output<typeof FsWriteResult>;
+declare const FsMkdirParams: z.ZodObject<{
+    path: z.ZodString;
+    parents: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type FsMkdirParams = z.output<typeof FsMkdirParams>;
+declare const FsMkdirResult: z.ZodObject<{
+    path: z.ZodString;
+    created: z.ZodBoolean;
+}, z.core.$strict>;
+type FsMkdirResult = z.output<typeof FsMkdirResult>;
+/** = daemon RenameRequest (/fs/rename). */
+declare const FsMoveParams: z.ZodObject<{
+    from_path: z.ZodString;
+    to_path: z.ZodString;
+    overwrite: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type FsMoveParams = z.output<typeof FsMoveParams>;
+declare const FsMoveResult: z.ZodObject<{
+    from_path: z.ZodString;
+    to_path: z.ZodString;
+}, z.core.$strict>;
+type FsMoveResult = z.output<typeof FsMoveResult>;
+/**
+ * Delete. Default goes to the OS Trash (Finder/Explorer semantics: undoable from the phone's
+ * "Undo" toast via fs.move back). to_trash:false is a permanent delete — the daemon's behaviour,
+ * used by agents through _sandbox_proxy.
+ */
+declare const FsDeleteParams: z.ZodObject<{
+    path: z.ZodString;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+    to_trash: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type FsDeleteParams = z.output<typeof FsDeleteParams>;
+declare const FsDeleteResult: z.ZodObject<{
+    deleted: z.ZodLiteral<true>;
+    trashed_to: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type FsDeleteResult = z.output<typeof FsDeleteResult>;
+/** Opens a watch resource; changes arrive as event fs.changed with resourceId. */
+declare const FsWatchParams: z.ZodObject<{
+    path: z.ZodString;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+    ignore: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    debounce_ms: z.ZodDefault<z.ZodInt>;
+}, z.core.$strict>;
+type FsWatchParams = z.output<typeof FsWatchParams>;
+declare const FsWatchResult: z.ZodObject<{
+    resource_id: z.ZodString;
+    path: z.ZodString;
+}, z.core.$strict>;
+type FsWatchResult = z.output<typeof FsWatchResult>;
+/** = daemon EditChunk / PatchRequest (/fs/patch). */
+declare const FsPatchParams: z.ZodObject<{
+    path: z.ZodString;
+    edits: z.ZodArray<z.ZodObject<{
+        old_text: z.ZodString;
+        new_text: z.ZodString;
+        replace_all: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    create_if_missing: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+type FsPatchParams = z.output<typeof FsPatchParams>;
+declare const FsPatchResult: z.ZodObject<{
+    path: z.ZodString;
+    applied: z.ZodInt;
+    size: z.ZodInt;
+    mtime_ms: z.ZodInt;
+}, z.core.$strict>;
+type FsPatchResult = z.output<typeof FsPatchResult>;
+/** = daemon SearchPathRequest (/search/paths). */
+declare const FsSearchPathsParams: z.ZodObject<{
+    pattern: z.ZodString;
+    cwd: z.ZodString;
+    hidden: z.ZodDefault<z.ZodBoolean>;
+    max_results: z.ZodDefault<z.ZodInt>;
+}, z.core.$strict>;
+type FsSearchPathsParams = z.output<typeof FsSearchPathsParams>;
+declare const FsSearchPathsResult: z.ZodObject<{
+    paths: z.ZodArray<z.ZodString>;
+    truncated: z.ZodBoolean;
+}, z.core.$strict>;
+type FsSearchPathsResult = z.output<typeof FsSearchPathsResult>;
+/** = daemon SearchContentRequest (/search/content). */
+declare const FsSearchContentParams: z.ZodObject<{
+    query: z.ZodString;
+    cwd: z.ZodString;
+    regex: z.ZodDefault<z.ZodBoolean>;
+    case_sensitive: z.ZodDefault<z.ZodBoolean>;
+    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    max_results: z.ZodDefault<z.ZodInt>;
+}, z.core.$strict>;
+type FsSearchContentParams = z.output<typeof FsSearchContentParams>;
+declare const FsSearchContentResult: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        lines: z.ZodString;
+        line_number: z.ZodInt;
+        submatches: z.ZodArray<z.ZodObject<{
+            match: z.ZodString;
+            start: z.ZodInt;
+            end: z.ZodInt;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    truncated: z.ZodBoolean;
+}, z.core.$strict>;
+type FsSearchContentResult = z.output<typeof FsSearchContentResult>;
+declare const FsChange: z.ZodObject<{
+    type: z.ZodEnum<{
+        created: "created";
+        deleted: "deleted";
+        modified: "modified";
+        moved: "moved";
+    }>;
+    path: z.ZodString;
+    to_path: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<{
+        unknown: "unknown";
+        file: "file";
+        dir: "dir";
+        symlink: "symlink";
+    }>;
+}, z.core.$strict>;
+type FsChange = z.output<typeof FsChange>;
+declare const FsChangedEvent: z.ZodObject<{
+    changes: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            created: "created";
+            deleted: "deleted";
+            modified: "modified";
+            moved: "moved";
+        }>;
+        path: z.ZodString;
+        to_path: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<{
+            unknown: "unknown";
+            file: "file";
+            dir: "dir";
+            symlink: "symlink";
+        }>;
+    }, z.core.$strict>>;
+    overflow: z.ZodBoolean;
+}, z.core.$strict>;
+type FsChangedEvent = z.output<typeof FsChangedEvent>;
+
+/** @ai-matrx/desktop-protocol — cap exec. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
+
+declare const Signal: z.ZodEnum<{
+    SIGINT: "SIGINT";
+    SIGTERM: "SIGTERM";
+    SIGKILL: "SIGKILL";
+    SIGHUP: "SIGHUP";
+    SIGQUIT: "SIGQUIT";
+    SIGTSTP: "SIGTSTP";
+    SIGCONT: "SIGCONT";
+    SIGUSR1: "SIGUSR1";
+    SIGUSR2: "SIGUSR2";
+}>;
+type Signal = z.output<typeof Signal>;
+/**
+ * Start a PTY. Response result = PtyInfo; the same request id then carries the output stream:
+ * stream{meta:{kind:"open",sid,resource_id}} → DATA frames (credited) → end{reason}.
+ * Input goes as STDIN frames on that sid (cheap per keystroke) or via exec.pty.write.
+ */
+declare const ExecPtyStartParams: z.ZodObject<{
+    cols: z.ZodInt;
+    rows: z.ZodInt;
+    cwd: z.ZodOptional<z.ZodString>;
+    shell: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    name: z.ZodOptional<z.ZodString>;
+    window_bytes: z.ZodOptional<z.ZodInt>;
+}, z.core.$strict>;
+type ExecPtyStartParams = z.output<typeof ExecPtyStartParams>;
+declare const PtyInfo: z.ZodObject<{
+    resource_id: z.ZodString;
+    pid: z.ZodInt;
+    shell: z.ZodString;
+    cwd: z.ZodString;
+    title: z.ZodString;
+    name: z.ZodNullable<z.ZodString>;
+    cols: z.ZodInt;
+    rows: z.ZodInt;
+    state: z.ZodEnum<{
+        running: "running";
+        exited: "exited";
+    }>;
+    exit_code: z.ZodNullable<z.ZodInt>;
+    exit_signal: z.ZodNullable<z.ZodEnum<{
+        SIGINT: "SIGINT";
+        SIGTERM: "SIGTERM";
+        SIGKILL: "SIGKILL";
+        SIGHUP: "SIGHUP";
+        SIGQUIT: "SIGQUIT";
+        SIGTSTP: "SIGTSTP";
+        SIGCONT: "SIGCONT";
+        SIGUSR1: "SIGUSR1";
+        SIGUSR2: "SIGUSR2";
+    }>>;
+    last_seq: z.ZodInt;
+    created_at_ms: z.ZodInt;
+    controller_client_id: z.ZodNullable<z.ZodString>;
+    attached_clients: z.ZodInt;
+    orphan_expires_at_ms: z.ZodNullable<z.ZodInt>;
+}, z.core.$strict>;
+type PtyInfo = z.output<typeof PtyInfo>;
+declare const ExecPtyStartResult: z.ZodObject<{
+    resource_id: z.ZodString;
+    pid: z.ZodInt;
+    shell: z.ZodString;
+    cwd: z.ZodString;
+    title: z.ZodString;
+    name: z.ZodNullable<z.ZodString>;
+    cols: z.ZodInt;
+    rows: z.ZodInt;
+    state: z.ZodEnum<{
+        running: "running";
+        exited: "exited";
+    }>;
+    exit_code: z.ZodNullable<z.ZodInt>;
+    exit_signal: z.ZodNullable<z.ZodEnum<{
+        SIGINT: "SIGINT";
+        SIGTERM: "SIGTERM";
+        SIGKILL: "SIGKILL";
+        SIGHUP: "SIGHUP";
+        SIGQUIT: "SIGQUIT";
+        SIGTSTP: "SIGTSTP";
+        SIGCONT: "SIGCONT";
+        SIGUSR1: "SIGUSR1";
+        SIGUSR2: "SIGUSR2";
+    }>>;
+    last_seq: z.ZodInt;
+    created_at_ms: z.ZodInt;
+    controller_client_id: z.ZodNullable<z.ZodString>;
+    attached_clients: z.ZodInt;
+    orphan_expires_at_ms: z.ZodNullable<z.ZodInt>;
+}, z.core.$strict>;
+type ExecPtyStartResult = z.output<typeof ExecPtyStartResult>;
+declare const ExecPtyWriteParams: z.ZodObject<{
+    resource_id: z.ZodString;
+    data: z.ZodString;
+}, z.core.$strict>;
+type ExecPtyWriteParams = z.output<typeof ExecPtyWriteParams>;
+declare const ExecPtyWriteResult: z.ZodObject<{
+    written: z.ZodInt;
+}, z.core.$strict>;
+type ExecPtyWriteResult = z.output<typeof ExecPtyWriteResult>;
+declare const ExecPtyResizeParams: z.ZodObject<{
+    resource_id: z.ZodString;
+    cols: z.ZodInt;
+    rows: z.ZodInt;
+}, z.core.$strict>;
+type ExecPtyResizeParams = z.output<typeof ExecPtyResizeParams>;
+declare const ExecPtyResizeResult: z.ZodObject<{
+    cols: z.ZodInt;
+    rows: z.ZodInt;
+}, z.core.$strict>;
+type ExecPtyResizeResult = z.output<typeof ExecPtyResizeResult>;
+/** Delivered to the PTY's foreground process group (daemon parity: tcgetpgrp + killpg). */
+declare const ExecPtySignalParams: z.ZodObject<{
+    resource_id: z.ZodString;
+    signal: z.ZodEnum<{
+        SIGINT: "SIGINT";
+        SIGTERM: "SIGTERM";
+        SIGKILL: "SIGKILL";
+        SIGHUP: "SIGHUP";
+        SIGQUIT: "SIGQUIT";
+        SIGTSTP: "SIGTSTP";
+        SIGCONT: "SIGCONT";
+        SIGUSR1: "SIGUSR1";
+        SIGUSR2: "SIGUSR2";
+    }>;
+}, z.core.$strict>;
+type ExecPtySignalParams = z.output<typeof ExecPtySignalParams>;
+declare const ExecPtySignalResult: z.ZodObject<{
+    delivered: z.ZodBoolean;
+}, z.core.$strict>;
+type ExecPtySignalResult = z.output<typeof ExecPtySignalResult>;
+/** SIGHUP the session, SIGKILL after grace_ms, reap, free the resource. Idempotent. */
+declare const ExecPtyKillParams: z.ZodObject<{
+    resource_id: z.ZodString;
+    grace_ms: z.ZodDefault<z.ZodInt>;
+}, z.core.$strict>;
+type ExecPtyKillParams = z.output<typeof ExecPtyKillParams>;
+declare const ExecPtyKillResult: z.ZodObject<{
+    exit_code: z.ZodNullable<z.ZodInt>;
+    exit_signal: z.ZodNullable<z.ZodEnum<{
+        SIGINT: "SIGINT";
+        SIGTERM: "SIGTERM";
+        SIGKILL: "SIGKILL";
+        SIGHUP: "SIGHUP";
+        SIGQUIT: "SIGQUIT";
+        SIGTSTP: "SIGTSTP";
+        SIGCONT: "SIGCONT";
+        SIGUSR1: "SIGUSR1";
+        SIGUSR2: "SIGUSR2";
+    }>>;
+}, z.core.$strict>;
+type ExecPtyKillResult = z.output<typeof ExecPtyKillResult>;
+declare const ExecListParams: z.ZodObject<{}, z.core.$strict>;
+type ExecListParams = z.output<typeof ExecListParams>;
+declare const ExecListResult: z.ZodObject<{
+    sessions: z.ZodArray<z.ZodObject<{
+        resource_id: z.ZodString;
+        pid: z.ZodInt;
+        shell: z.ZodString;
+        cwd: z.ZodString;
+        title: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        cols: z.ZodInt;
+        rows: z.ZodInt;
+        state: z.ZodEnum<{
+            running: "running";
+            exited: "exited";
+        }>;
+        exit_code: z.ZodNullable<z.ZodInt>;
+        exit_signal: z.ZodNullable<z.ZodEnum<{
+            SIGINT: "SIGINT";
+            SIGTERM: "SIGTERM";
+            SIGKILL: "SIGKILL";
+            SIGHUP: "SIGHUP";
+            SIGQUIT: "SIGQUIT";
+            SIGTSTP: "SIGTSTP";
+            SIGCONT: "SIGCONT";
+            SIGUSR1: "SIGUSR1";
+            SIGUSR2: "SIGUSR2";
+        }>>;
+        last_seq: z.ZodInt;
+        created_at_ms: z.ZodInt;
+        controller_client_id: z.ZodNullable<z.ZodString>;
+        attached_clients: z.ZodInt;
+        orphan_expires_at_ms: z.ZodNullable<z.ZodInt>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type ExecListResult = z.output<typeof ExecListResult>;
+/**
+ * One-shot command (agents, via _sandbox_proxy → /exec). Timeout ENFORCED (exit 124, daemon
+ * convention). cwd is sticky per cwd_key: a later run with the same key and no cwd starts where
+ * the last one ended (SPEC §6.1: "cd sub && pwd" then "pwd").
+ */
+declare const ExecRunParams: z.ZodObject<{
+    command: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    cwd_key: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    stdin: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodDefault<z.ZodInt>;
+    max_output_bytes: z.ZodDefault<z.ZodInt>;
+}, z.core.$strict>;
+type ExecRunParams = z.output<typeof ExecRunParams>;
+declare const ExecRunResult: z.ZodObject<{
+    exit_code: z.ZodInt;
+    stdout: z.ZodString;
+    stderr: z.ZodString;
+    cwd: z.ZodString;
+    duration_ms: z.ZodInt;
+    timed_out: z.ZodBoolean;
+    output_truncated: z.ZodBoolean;
+}, z.core.$strict>;
+type ExecRunResult = z.output<typeof ExecRunResult>;
+declare const ExecExitedEvent: z.ZodObject<{
+    exit_code: z.ZodNullable<z.ZodInt>;
+    exit_signal: z.ZodNullable<z.ZodEnum<{
+        SIGINT: "SIGINT";
+        SIGTERM: "SIGTERM";
+        SIGKILL: "SIGKILL";
+        SIGHUP: "SIGHUP";
+        SIGQUIT: "SIGQUIT";
+        SIGTSTP: "SIGTSTP";
+        SIGCONT: "SIGCONT";
+        SIGUSR1: "SIGUSR1";
+        SIGUSR2: "SIGUSR2";
+    }>>;
+}, z.core.$strict>;
+type ExecExitedEvent = z.output<typeof ExecExitedEvent>;
+declare const ExecTitleEvent: z.ZodObject<{
+    title: z.ZodString;
+}, z.core.$strict>;
+type ExecTitleEvent = z.output<typeof ExecTitleEvent>;
+declare const ExecCwdEvent: z.ZodObject<{
+    cwd: z.ZodString;
+}, z.core.$strict>;
+type ExecCwdEvent = z.output<typeof ExecCwdEvent>;
+
+/** @ai-matrx/desktop-protocol — cap session. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
+
+/**
+ * Reattach after a drop. mode "control" by the same user takes control (previous controller is
+ * demoted to read_only and gets session.control_changed). since_seq = last seq the client
+ * rendered: frames (since_seq, last_seq] are replayed from the ring with the REPLAY flag; if they
+ * have left the ring, stream{gap} + stream{snapshot} + SNAPSHOT frames come first.
+ * Response = PtyInfo|FsWatchResult-shaped ResourceInfo; then the stream continues on a new sid.
+ */
+declare const SessionAttachParams: z.ZodObject<{
+    resource_id: z.ZodString;
+    mode: z.ZodDefault<z.ZodEnum<{
+        control: "control";
+        read_only: "read_only";
+    }>>;
+    since_seq: z.ZodOptional<z.ZodInt>;
+    window_bytes: z.ZodOptional<z.ZodInt>;
+}, z.core.$strict>;
+type SessionAttachParams = z.output<typeof SessionAttachParams>;
+declare const ResourceInfo: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"pty">;
+    pty: z.ZodObject<{
+        resource_id: z.ZodString;
+        pid: z.ZodInt;
+        shell: z.ZodString;
+        cwd: z.ZodString;
+        title: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        cols: z.ZodInt;
+        rows: z.ZodInt;
+        state: z.ZodEnum<{
+            running: "running";
+            exited: "exited";
+        }>;
+        exit_code: z.ZodNullable<z.ZodInt>;
+        exit_signal: z.ZodNullable<z.ZodEnum<{
+            SIGINT: "SIGINT";
+            SIGTERM: "SIGTERM";
+            SIGKILL: "SIGKILL";
+            SIGHUP: "SIGHUP";
+            SIGQUIT: "SIGQUIT";
+            SIGTSTP: "SIGTSTP";
+            SIGCONT: "SIGCONT";
+            SIGUSR1: "SIGUSR1";
+            SIGUSR2: "SIGUSR2";
+        }>>;
+        last_seq: z.ZodInt;
+        created_at_ms: z.ZodInt;
+        controller_client_id: z.ZodNullable<z.ZodString>;
+        attached_clients: z.ZodInt;
+        orphan_expires_at_ms: z.ZodNullable<z.ZodInt>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"watch">;
+    resource_id: z.ZodString;
+    path: z.ZodString;
+    orphan_expires_at_ms: z.ZodNullable<z.ZodInt>;
+}, z.core.$strict>], "kind">;
+type ResourceInfo = z.output<typeof ResourceInfo>;
+declare const SessionAttachResult: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"pty">;
+    pty: z.ZodObject<{
+        resource_id: z.ZodString;
+        pid: z.ZodInt;
+        shell: z.ZodString;
+        cwd: z.ZodString;
+        title: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        cols: z.ZodInt;
+        rows: z.ZodInt;
+        state: z.ZodEnum<{
+            running: "running";
+            exited: "exited";
+        }>;
+        exit_code: z.ZodNullable<z.ZodInt>;
+        exit_signal: z.ZodNullable<z.ZodEnum<{
+            SIGINT: "SIGINT";
+            SIGTERM: "SIGTERM";
+            SIGKILL: "SIGKILL";
+            SIGHUP: "SIGHUP";
+            SIGQUIT: "SIGQUIT";
+            SIGTSTP: "SIGTSTP";
+            SIGCONT: "SIGCONT";
+            SIGUSR1: "SIGUSR1";
+            SIGUSR2: "SIGUSR2";
+        }>>;
+        last_seq: z.ZodInt;
+        created_at_ms: z.ZodInt;
+        controller_client_id: z.ZodNullable<z.ZodString>;
+        attached_clients: z.ZodInt;
+        orphan_expires_at_ms: z.ZodNullable<z.ZodInt>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"watch">;
+    resource_id: z.ZodString;
+    path: z.ZodString;
+    orphan_expires_at_ms: z.ZodNullable<z.ZodInt>;
+}, z.core.$strict>], "kind">;
+type SessionAttachResult = z.output<typeof SessionAttachResult>;
+/** Leave the resource running (orphan grace starts if no other client controls it). */
+declare const SessionDetachParams: z.ZodObject<{
+    resource_id: z.ZodString;
+}, z.core.$strict>;
+type SessionDetachParams = z.output<typeof SessionDetachParams>;
+declare const SessionDetachResult: z.ZodObject<{
+    orphan_expires_at_ms: z.ZodNullable<z.ZodInt>;
+}, z.core.$strict>;
+type SessionDetachResult = z.output<typeof SessionDetachResult>;
+/** Free a resource through its owner's cancel path (watch → unwatch; pty → exec.pty.kill). */
+declare const SessionReleaseParams: z.ZodObject<{
+    resource_id: z.ZodString;
+}, z.core.$strict>;
+type SessionReleaseParams = z.output<typeof SessionReleaseParams>;
+declare const SessionReleaseResult: z.ZodObject<{
+    released: z.ZodLiteral<true>;
+}, z.core.$strict>;
+type SessionReleaseResult = z.output<typeof SessionReleaseResult>;
+declare const SessionListParams: z.ZodObject<{}, z.core.$strict>;
+type SessionListParams = z.output<typeof SessionListParams>;
+declare const SessionListResult: z.ZodObject<{
+    resources: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"pty">;
+        pty: z.ZodObject<{
+            resource_id: z.ZodString;
+            pid: z.ZodInt;
+            shell: z.ZodString;
+            cwd: z.ZodString;
+            title: z.ZodString;
+            name: z.ZodNullable<z.ZodString>;
+            cols: z.ZodInt;
+            rows: z.ZodInt;
+            state: z.ZodEnum<{
+                running: "running";
+                exited: "exited";
+            }>;
+            exit_code: z.ZodNullable<z.ZodInt>;
+            exit_signal: z.ZodNullable<z.ZodEnum<{
+                SIGINT: "SIGINT";
+                SIGTERM: "SIGTERM";
+                SIGKILL: "SIGKILL";
+                SIGHUP: "SIGHUP";
+                SIGQUIT: "SIGQUIT";
+                SIGTSTP: "SIGTSTP";
+                SIGCONT: "SIGCONT";
+                SIGUSR1: "SIGUSR1";
+                SIGUSR2: "SIGUSR2";
+            }>>;
+            last_seq: z.ZodInt;
+            created_at_ms: z.ZodInt;
+            controller_client_id: z.ZodNullable<z.ZodString>;
+            attached_clients: z.ZodInt;
+            orphan_expires_at_ms: z.ZodNullable<z.ZodInt>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"watch">;
+        resource_id: z.ZodString;
+        path: z.ZodString;
+        orphan_expires_at_ms: z.ZodNullable<z.ZodInt>;
+    }, z.core.$strict>], "kind">>;
+}, z.core.$strict>;
+type SessionListResult = z.output<typeof SessionListResult>;
+declare const SessionControlChangedEvent: z.ZodObject<{
+    controller_client_id: z.ZodNullable<z.ZodString>;
+    your_mode: z.ZodEnum<{
+        control: "control";
+        read_only: "read_only";
+    }>;
+}, z.core.$strict>;
+type SessionControlChangedEvent = z.output<typeof SessionControlChangedEvent>;
+
+/** @ai-matrx/desktop-protocol — cap relay. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
+
+declare const RelayDeviceStatusEvent: z.ZodObject<{
+    online: z.ZodBoolean;
+    since_ms: z.ZodInt;
+    app_version: z.ZodNullable<z.ZodString>;
+    protocol_version: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type RelayDeviceStatusEvent = z.output<typeof RelayDeviceStatusEvent>;
+declare const RelayAuthExpiringEvent: z.ZodObject<{
+    expires_at_ms: z.ZodInt;
+}, z.core.$strict>;
+type RelayAuthExpiringEvent = z.output<typeof RelayAuthExpiringEvent>;
+/** HTTP POST https://relay.matrxserver.com/v1/devices/{device_id}/call — unary ops only (lane F). */
+declare const RelayCallRequest: z.ZodObject<{
+    cap: z.ZodString;
+    op: z.ZodString;
+    params: z.ZodUnknown;
+    timeout_ms: z.ZodDefault<z.ZodInt>;
+}, z.core.$strict>;
+type RelayCallRequest = z.output<typeof RelayCallRequest>;
+declare const RelayCallResponse: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    result: z.ZodUnknown;
+}, z.core.$strict>, z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<{
+            AUTH_REQUIRED: "AUTH_REQUIRED";
+            AUTH_INVALID: "AUTH_INVALID";
+            AUTH_EXPIRED: "AUTH_EXPIRED";
+            AUTH_FORBIDDEN: "AUTH_FORBIDDEN";
+            AUTH_DEVICE_REVOKED: "AUTH_DEVICE_REVOKED";
+            PERMISSION_DENIED_OS: "PERMISSION_DENIED_OS";
+            NOT_FOUND: "NOT_FOUND";
+            CONFLICT: "CONFLICT";
+            INVALID_PARAMS: "INVALID_PARAMS";
+            RESOURCE_BUSY: "RESOURCE_BUSY";
+            RESOURCE_GONE: "RESOURCE_GONE";
+            CANCELLED: "CANCELLED";
+            TIMEOUT: "TIMEOUT";
+            PLATFORM_UNSUPPORTED: "PLATFORM_UNSUPPORTED";
+            RATE_LIMITED: "RATE_LIMITED";
+            INTERNAL: "INTERNAL";
+            PROTOCOL_VERSION_UNSUPPORTED: "PROTOCOL_VERSION_UNSUPPORTED";
+            PROTOCOL_ERROR: "PROTOCOL_ERROR";
+            UNKNOWN_OPERATION: "UNKNOWN_OPERATION";
+            DEVICE_OFFLINE: "DEVICE_OFFLINE";
+            PAYLOAD_TOO_LARGE: "PAYLOAD_TOO_LARGE";
+        }>;
+        message: z.ZodString;
+        retryable: z.ZodBoolean;
+        data: z.ZodOptional<z.ZodObject<{
+            reason: z.ZodOptional<z.ZodEnum<{
+                not_a_directory: "not_a_directory";
+                is_a_directory: "is_a_directory";
+                directory_not_empty: "directory_not_empty";
+                already_exists: "already_exists";
+                stale_write: "stale_write";
+                binary_content: "binary_content";
+                not_utf8_boundary: "not_utf8_boundary";
+                patch_no_match: "patch_no_match";
+                patch_ambiguous: "patch_ambiguous";
+                resource_exited: "resource_exited";
+                resource_expired: "resource_expired";
+                control_taken: "control_taken";
+                window_exhausted: "window_exhausted";
+            }>>;
+            cap: z.ZodOptional<z.ZodString>;
+            op: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+            settings_url: z.ZodOptional<z.ZodString>;
+            retry_after_ms: z.ZodOptional<z.ZodInt>;
+            limit_bytes: z.ZodOptional<z.ZodInt>;
+            upgrade: z.ZodOptional<z.ZodObject<{
+                min_version: z.ZodString;
+                max_version: z.ZodString;
+                download_url: z.ZodOptional<z.ZodURL>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>], "ok">;
+type RelayCallResponse = z.output<typeof RelayCallResponse>;
+/** HTTP GET /v1/devices/{device_id}/status (owner JWT). */
+declare const RelayStatusResponse: z.ZodObject<{
+    online: z.ZodBoolean;
+    since_ms: z.ZodInt;
+    app_version: z.ZodNullable<z.ZodString>;
+    protocol_version: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type RelayStatusResponse = z.output<typeof RelayStatusResponse>;
+
+export { AbsPath, DEFAULT_MAX_FRAME_PAYLOAD_BYTES, DEFAULT_MAX_MESSAGE_BYTES, DEFAULT_WINDOW_BYTES, DeviceId, ExecCwdEvent, ExecExitedEvent, ExecListParams, ExecListResult, ExecPtyKillParams, ExecPtyKillResult, ExecPtyResizeParams, ExecPtyResizeResult, ExecPtySignalParams, ExecPtySignalResult, ExecPtyStartParams, ExecPtyStartResult, ExecPtyWriteParams, ExecPtyWriteResult, ExecRunParams, ExecRunResult, ExecTitleEvent, FrameHeader, FsChange, FsChangedEvent, FsDeleteParams, FsDeleteResult, FsEncoding, FsEntry, FsKind, FsListParams, FsListResult, FsMkdirParams, FsMkdirResult, FsMoveParams, FsMoveResult, FsPatchParams, FsPatchResult, FsReadParams, FsReadResult, FsReadStreamParams, FsReadStreamResult, FsSearchContentParams, FsSearchContentResult, FsSearchPathsParams, FsSearchPathsResult, FsStatParams, FsStatResult, FsWatchParams, FsWatchResult, FsWriteParams, FsWriteResult, OsPermissionName, PROTOCOL_MAJOR, PROTOCOL_MINOR, ProtocolVersion, PtyInfo, RelayAuthExpiringEvent, RelayCallRequest, RelayCallResponse, RelayDeviceStatusEvent, RelayStatusResponse, RequestId, ResourceId, ResourceInfo, SessionAttachParams, SessionAttachResult, SessionControlChangedEvent, SessionDetachParams, SessionDetachResult, SessionListParams, SessionListResult, SessionReleaseParams, SessionReleaseResult, Signal, SysinfoGetParams, SysinfoGetResult, epochMs, nonNegInt, u32 };