dsh-plugin-dshm 0.0.0-stage → 0.1.0

package/lib/protocol/THIRD_PARTY_LICENSES.txt

@@ -0,0 +1,135 @@
+ajv 8.17.1
+The MIT License (MIT)
+
+Copyright (c) 2015-2021 Evgeny Poberezkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+
+---
+
+ajv-formats 3.0.1
+MIT License
+
+Copyright (c) 2020 Evgeny Poberezkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+---
+
+fast-deep-equal 3.1.3
+MIT License
+
+Copyright (c) 2017 Evgeny Poberezkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+---
+
+fast-uri 3.1.9
+Copyright (c) 2011-2021, Gary Court until https://github.com/garycourt/uri-js/commit/a1acf730b4bba3f1097c9f52e7d9d3aba8cdcaae
+Copyright (c) 2021-present The Fastify team <https://github.com/fastify/fastify#team>
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * The names of any contributors may not be used to endorse or promote
+      products derived from this software without specific prior written
+      permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+                                  *   *   *
+
+The complete list of contributors can be found at:
+- https://github.com/garycourt/uri-js/graphs/contributors
+
+---
+
+json-schema-traverse 1.0.0
+MIT License
+
+Copyright (c) 2017 Evgeny Poberezkin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/lib/protocol/dmp.d.ts

@@ -0,0 +1,402 @@
+// Generated by protocol/scripts/generate.mjs. Do not edit.
+// Schema SHA-256: 5293e9a818170e796653c3dcda5de84aadf198e57bd005ab63f54d06d90dd8c7
+
+export type JSONValue = null | boolean | number | string | JSONValue[] | { [key: string]: JSONValue };
+
+export type Id = string;
+
+export type Timestamp = string;
+
+export type Seq = number;
+
+export type Base64 = string;
+
+export type Base64Url = string;
+
+export type Uuid = string;
+
+export type RelativePath = string;
+
+export type ErrorCode = "bad-frame" | "version-unsupported" | "unauthorized" | "revoked" | "pairing-closed" | "bad-otp" | "unknown-method" | "unsupported" | "invalid-params" | "not-found" | "expired" | "conflict" | "busy" | "forbidden-path" | "too-large" | "dsh-unavailable" | "dsh-incompatible" | "cancelled" | "timeout" | "internal" | (string & {});
+
+export type Error = { "code": ErrorCode; "message": string; "retryable": boolean; "details"?: Record<string, JSONValue>; };
+
+export type Capability = "sessions" | "timeline" | "timeline.stream" | "send" | "send.steer" | "queue.edit" | "interactions.approval" | "interactions.question" | "model.select" | "permission.select" | "files.read" | "files.download" | "changes" | "deliverables" | "jobs" | "attachments" | "push" | "devices" | (string & {});
+
+export type ModelSelection = { "provider": Id; "model": Id; "effort"?: string; };
+
+export type Empty = {  };
+
+export type Accepted = { "accepted": true; };
+
+export type WorkspaceUpsert = { "workspace": Workspace; };
+
+export type WorkspaceRemove = { "workspaceId": Id; };
+
+export type SessionUpsert = { "session": SessionSummary; };
+
+export type SessionRemove = { "sessionId": Id; };
+
+export type TimelineUpsert = { "item": TimelineItem; "throughSeq": Seq; };
+
+export type TimelineRemove = { "itemId": Id; "throughSeq": Seq; };
+
+export type TimelineDelta = { "itemId": Id; "field": "text"; "append": string; };
+
+export type SessionUpdate = { "session": SessionDetail; };
+
+export type InteractionOpen = { "interaction": Interaction; };
+
+export type InteractionClose = { "interactionId": Id; "reason": "answered" | "cancelled" | "expired"; };
+
+export type QueueUpdate = { "queue": Array<QueueItem>; };
+
+export type SessionReset = { "reason": "rewritten" | "removed" | "dsh-restarted" | (string & {}); };
+
+export type JobsReplace = { "jobs": Array<Job>; };
+
+export type JobOutput = { "chunks": Array<JobChunk>; "next": number; };
+
+export type JobStatus = { "job": Job; };
+
+export type DevicesReplace = { "devices": Array<Device>; };
+
+export type ServerFrame = (ServerHello) | (AuthChallenge) | (PairResult) | (AuthOk) | (Res) | (Ev) | (Err) | (StreamAck) | (StreamAbort) | (Ping) | (Pong);
+
+export type ClientFrame = (ClientHello) | (PairRequest) | (AuthResponse) | (Req) | (Cancel) | (StreamAck) | (StreamAbort) | (Ping) | (Pong);
+
+export type ServerHello = { "t": "hello"; "v": Array<number>; "host": HostInfo; "bridge": { "version": string; "instanceId": Id; }; "dsh": { "version"?: string; "status": "ok" | "incompatible" | "unavailable"; }; "caps": Array<Capability>; "limits": { "maxTextFrameBytes": number; "maxChunkBytes": number; "streamWindowBytes": number; }; };
+
+export type ClientHello = { "t": "hello"; "v": number; "app": { "version": string; "build": string; "platform": "ios" | "ipados"; }; "caps"?: Array<string>; };
+
+export type AuthChallenge = { "t": "auth.challenge"; "nonce": Base64Url; };
+
+export type PairRequest = { "t": "pair.request"; "otp": Base64Url; "devicePublicKey": Base64; "deviceName": string; "deviceModel": string; "secureEnclave": boolean; };
+
+export type PairResult = { "t": "pair.result"; "deviceId": Id; "hostId": Id; };
+
+export type AuthResponse = { "t": "auth.response"; "deviceId": Id; "sig": Base64; };
+
+export type AuthOk = { "t": "auth.ok"; "deviceId": Id; "connectionId": Id; "via": "lan" | "tailscale" | "other"; };
+
+export type Req = { "t": "req"; "id": number; "method": string; "params": Record<string, JSONValue>; };
+
+export type Res = ({ "t": "res"; "id": number; "ok": true; "result": Record<string, JSONValue>; }) | ({ "t": "res"; "id": number; "ok": false; "error": Error; });
+
+export type Cancel = { "t": "cancel"; "id": number; };
+
+export type Ev = { "t": "ev"; "sub": Id; "kind": string; "data": Record<string, JSONValue>; };
+
+export type Err = { "t": "err"; "code": ErrorCode; "message": string; "retryable": boolean; };
+
+export type StreamAck = { "t": "stream.ack"; "streamId": number; "bytes": number; };
+
+export type StreamAbort = { "t": "stream.abort"; "streamId": number; "code": ErrorCode; };
+
+export type Ping = { "t": "ping"; };
+
+export type Pong = { "t": "pong"; };
+
+export type SessionRef = { "sessionId": Id; };
+
+export type Download = { "streamId": number; "size": number; "mime"?: string; "version"?: string; };
+
+export type Cursor = { "throughSeq": Seq; };
+
+export type HostInfoParams = Empty;
+
+export type HostInfoResult = { "host": HostInfo; "bridgeVersion": string; "dshVersion"?: string; "dshStatus": "ok" | "incompatible" | "unavailable"; "caps": Array<Capability>; "time": Timestamp; };
+
+export type UnsubscribeParams = { "subId": Id; };
+
+export type UnsubscribeResult = Empty;
+
+export type SessionsListParams = { "includeArchived"?: boolean; };
+
+export type SessionsListResult = { "workspaces": Array<Workspace>; "sessions": Array<SessionSummary>; };
+
+export type SessionsWatchParams = SessionsListParams;
+
+export type SessionsWatchResult = { "subId": Id; "workspaces": Array<Workspace>; "sessions": Array<SessionSummary>; };
+
+export type WorkspacesListParams = Empty;
+
+export type WorkspacesListResult = { "workspaces": Array<Workspace>; };
+
+export type SessionsCreateParams = { "workspaceId": Id; "sendId": Uuid; "text"?: string; };
+
+export type SessionsCreateResult = { "sessionId": Id; };
+
+export type SessionWatchParams = { "sessionId": Id; "sinceSeq"?: Seq; "window"?: { "turns"?: number; "minItems"?: number; }; };
+
+export type SessionWatchResult = { "subId": Id; "session": SessionDetail; "items": Array<TimelineItem>; "removedItemIds": Array<Id>; "cursor": Cursor; "hasMoreBefore": boolean; "resumed": boolean; "interactions": Array<Interaction>; "queue": Array<QueueItem>; };
+
+export type SessionHistoryParams = { "sessionId": Id; "beforeSeq": number; "throughSeq": Seq; "limit"?: number; };
+
+export type SessionHistoryResult = { "items": Array<TimelineItem>; "hasMoreBefore": boolean; };
+
+export type SessionSendParams = { "sessionId": Id; "sendId": Uuid; "text": string; "attachments"?: Array<Id>; "mode"?: "queue" | "steer"; };
+
+export type SessionSendResult = Accepted;
+
+export type SessionQueueUpdateParams = { "sessionId": Id; "queueItemId": Id; "action": "remove" | "steer" | "edit"; "text"?: string; };
+
+export type SessionQueueUpdateResult = Accepted;
+
+export type SessionInterruptParams = SessionRef;
+
+export type SessionInterruptResult = Accepted;
+
+export type SessionSetModelParams = { "sessionId": Id; "provider": Id; "model": Id; "effort"?: string; };
+
+export type SessionSetModelResult = { "selected": ModelSelection; "defaultUpdated": boolean; };
+
+export type SessionSetPermissionParams = { "sessionId": Id; "preset": string; };
+
+export type SessionSetPermissionResult = { "current": string; };
+
+export type ModelsCatalogParams = Empty;
+
+export type ModelsCatalogResult = ModelCatalog;
+
+export type PermissionsCatalogParams = Empty;
+
+export type PermissionsCatalogResult = PermissionCatalog;
+
+export type ToolOutputParams = { "sessionId": Id; "callId": Id; };
+
+export type ToolOutputResult = Download;
+
+export type TimelineTextParams = { "sessionId": Id; "itemId": Id; };
+
+export type TimelineTextResult = Download;
+
+export type InteractionsListParams = Empty;
+
+export type InteractionsListResult = { "interactions": Array<Interaction>; };
+
+export type InteractionAnswerParams = { "interactionId": Id; "answer": InteractionAnswer; };
+
+export type InteractionAnswerResult = { "settled": true; };
+
+export type FilesListParams = { "sessionId": Id; "path": RelativePath; };
+
+export type FilesListResult = { "path": RelativePath; "entries": Array<FileEntry>; "truncated": boolean; };
+
+export type FilesReadParams = { "sessionId": Id; "path": RelativePath; "offset"?: number; "limit"?: number; };
+
+export type FilesReadResult = { "path": RelativePath; "text": string; "offset": number; "lines": number; "eof": boolean; "version": string; };
+
+export type FilesStatParams = FilesListParams;
+
+export type FilesStatResult = { "type": "file" | "dir" | "symlink" | "other"; "size"?: number; "version": string; };
+
+export type FilesDownloadParams = FilesListParams;
+
+export type FilesDownloadResult = Download;
+
+export type ChangesSummaryParams = { "sessionId": Id; "changeId": Id; };
+
+export type ChangesSummaryResult = { "files": Array<ChangeFile>; "added": number; "deleted": number; };
+
+export type ChangesDiffParams = { "sessionId": Id; "changeId": Id; "index": number; };
+
+export type ChangesDiffResult = { "diff": Diff; };
+
+export type DeliverablesListParams = SessionRef;
+
+export type DeliverablesListResult = { "deliverables": Array<Deliverable>; };
+
+export type DeliverablesDownloadParams = { "deliverableId": Id; };
+
+export type DeliverablesDownloadResult = Download;
+
+export type AttachmentsBeginParams = { "sessionId": Id; "name": string; "mime": string; "size": number; "sha256": string; };
+
+export type AttachmentsBeginResult = { "uploadId": Id; "streamId": number; };
+
+export type AttachmentsFinishParams = { "uploadId": Id; };
+
+export type AttachmentsFinishResult = { "attachmentId": Id; };
+
+export type JobsWatchParams = SessionRef;
+
+export type JobsWatchResult = { "subId": Id; "jobs": Array<Job>; };
+
+export type JobWatchParams = { "sessionId": Id; "jobId": Id; "fromByte"?: number; };
+
+export type JobWatchResult = { "subId": Id; "job": Job; "from": number; };
+
+export type DevicesListParams = Empty;
+
+export type DevicesListResult = { "devices": Array<Device>; };
+
+export type DevicesWatchParams = Empty;
+
+export type DevicesWatchResult = { "subId": Id; "devices": Array<Device>; };
+
+export type DevicesRevokeParams = { "deviceId": Id; };
+
+export type DevicesRevokeResult = Empty;
+
+export type DevicesRenameParams = { "deviceId": Id; "name": string; };
+
+export type DevicesRenameResult = { "device": Device; };
+
+export type PushRegisterParams = { "pushId": Id; "pushSecret": Base64; "notifKey": Base64; "env": "sandbox" | "production"; "prefs": PushPrefs; };
+
+export type PushRegisterResult = Empty;
+
+export type PushUnregisterParams = Empty;
+
+export type PushUnregisterResult = Empty;
+
+export type PushPrefs = { "approvals": boolean; "turnFinished": boolean; "errors": boolean; };
+
+export type PushUpdatePrefsParams = { "prefs": PushPrefs; };
+
+export type PushUpdatePrefsResult = Empty;
+
+export type HostInfo = { "hostId": Id; "name": string; "platform": "macos" | "windows" | "linux"; };
+
+export type Workspace = { "workspaceId": Id; "title": string; "path": string; "updatedAt": Timestamp; };
+
+export type SessionStatus = "idle" | "running" | "needs-input" | "error" | (string & {});
+
+export type SessionSummary = { "sessionId": Id; "workspaceId"?: Id; "parentSessionId"?: Id; "title": string | null; "preview"?: string; "status": SessionStatus; "pendingInteractions": number; "updatedAt": Timestamp; "lastActivityAt"?: Timestamp; "archived": boolean; "pinned": boolean; "model"?: ModelSelection; };
+
+export type SessionDetail = { "summary": SessionSummary; "cwd"?: string; "permission"?: { "current": string; }; };
+
+export type Attachment = { "name": string; "mime"?: string; "size"?: number; };
+
+export type ItemState = "streaming" | "complete" | "failed" | "cancelled";
+
+export type ToolKind = "shell" | "edit" | "read" | "search" | "web" | "mcp" | "subagent" | "question" | "present" | "plan" | "other" | (string & {});
+
+export type ToolStatus = "pending" | "awaiting-approval" | "running" | "succeeded" | "failed" | "denied" | "cancelled" | (string & {});
+
+export type DiffHunk = { "oldStart": number; "oldLines": number; "newStart": number; "newLines": number; "lines": Array<string>; };
+
+export type Diff = ({ "kind": "text"; "path": string; "hunks": Array<DiffHunk>; "coarse": boolean; }) | ({ "kind": "binary"; "path": string; }) | ({ "kind": "oversized"; "path": string; });
+
+export type ToolOutput = { "text": string; "truncated": boolean; "totalBytes"?: number; "isError": boolean; };
+
+export type Todo = { "text": string; "status": "pending" | "in_progress" | "completed"; };
+
+export type DeliverableRef = { "deliverableId": Id; "name": string; "path": string; "description"?: string; };
+
+export type Deliverable = { "deliverableId": Id; "name": string; "path": string; "description"?: string; "turn": number; "presentedAt": Timestamp; };
+
+export type ItemOrder = { "seq": Seq; "index": number; };
+
+export type TextTruncation = { "totalBytes": number; };
+
+export type ItemBase = { "itemId": Id; "seq": Seq; "order": ItemOrder; "turn"?: number; "time": Timestamp; "kind": string; };
+
+export type TimelineItem = (UserMessageItem) | (AssistantMessageItem) | (ReasoningItem) | (ToolCallItem) | (InteractionItem) | (PlanItem) | (GoalItem) | (ChangesItem) | (DeliverablesItem) | (TurnEndItem) | (NoticeItem);
+
+export type UserMessageItem = { "itemId": Id; "seq": Seq; "order": ItemOrder; "turn"?: number; "time": Timestamp; "kind": "user_message"; "text": string; "truncated"?: TextTruncation; "attachments": Array<Attachment>; };
+
+export type AssistantMessageItem = { "itemId": Id; "seq": Seq; "order": ItemOrder; "turn"?: number; "time": Timestamp; "kind": "assistant_message"; "text": string; "truncated"?: TextTruncation; "state": ItemState; "model"?: ModelSelection; };
+
+export type ReasoningItem = { "itemId": Id; "seq": Seq; "order": ItemOrder; "turn"?: number; "time": Timestamp; "kind": "reasoning"; "text": string; "truncated"?: TextTruncation; "state": ItemState; "durationMs"?: number; };
+
+export type ToolCallItem = { "itemId": Id; "seq": Seq; "order": ItemOrder; "turn"?: number; "time": Timestamp; "kind": "tool_call"; "callId": Id; "tool": { "name": string; "kind": ToolKind; }; "title": string; "input": { "command"?: string; "path"?: string; "query"?: string; "url"?: string; "raw"?: string; }; "status": ToolStatus; "output"?: ToolOutput; "diff"?: Diff; "jobId"?: Id; "childSessionId"?: Id; "durationMs"?: number; };
+
+export type InteractionItem = { "itemId": Id; "seq": Seq; "order": ItemOrder; "turn"?: number; "time": Timestamp; "kind": "interaction"; "interactionId"?: Id; "interactionKind": "approval" | "question"; "state": "pending" | "answered" | "cancelled" | "expired"; "summary": string; "outcome"?: string; "toolCallId"?: Id; };
+
+export type PlanItem = { "itemId": Id; "seq": Seq; "order": ItemOrder; "turn"?: number; "time": Timestamp; "kind": "plan"; "todos": Array<Todo>; };
+
+export type GoalItem = { "itemId": Id; "seq": Seq; "order": ItemOrder; "turn"?: number; "time": Timestamp; "kind": "goal"; "objective": string; "state": "active" | "achieved" | "abandoned" | (string & {}); };
+
+export type ChangesItem = { "itemId": Id; "seq": Seq; "order": ItemOrder; "turn"?: number; "time": Timestamp; "kind": "changes"; "changeId": Id; "fileCount": number; "added": number; "deleted": number; "available": boolean; };
+
+export type DeliverablesItem = { "itemId": Id; "seq": Seq; "order": ItemOrder; "turn"?: number; "time": Timestamp; "kind": "deliverables"; "deliverables": Array<DeliverableRef>; };
+
+export type TurnEndItem = { "itemId": Id; "seq": Seq; "order": ItemOrder; "turn"?: number; "time": Timestamp; "kind": "turn_end"; "reason": "completed" | "cancelled" | "error"; "errorMessage"?: string; };
+
+export type NoticeItem = { "itemId": Id; "seq": Seq; "order": ItemOrder; "turn"?: number; "time": Timestamp; "kind": "notice"; "level": "info" | "warning" | "error"; "text": string; "code"?: "model-changed" | "permission-changed" | "title-changed" | "session-forked" | "other" | (string & {}); };
+
+export type ApprovalRequest = { "toolName": string; "toolKind": ToolKind; "title": string; "command"?: string; "path"?: string; "reason"?: string; "preview"?: ({ "kind": "diff"; "diff": Diff; }) | ({ "kind": "text"; "text": string; }); };
+
+export type Question = { "questionId": Id; "question": string; "header"?: string; "options": Array<{ "label": string; "description"?: string; }>; "multiSelect": boolean; };
+
+export type Interaction = ({ "interactionId": Id; "sessionId": Id; "kind": "approval"; "blocking": true; "createdAt": Timestamp; "toolCallId"?: Id; "approval": ApprovalRequest; }) | ({ "interactionId": Id; "sessionId": Id; "kind": "question"; "blocking": boolean; "createdAt": Timestamp; "toolCallId"?: Id; "questions": Array<Question>; });
+
+export type InteractionAnswer = ({ "kind": "approval"; "decision": "allow-once" | "deny"; }) | ({ "kind": "question"; "answers": Array<{ "questionId": Id; "selected": Array<string>; "custom"?: string; }>; });
+
+export type QueueItem = { "queueItemId": Id; "text": string; "mode": "next-turn" | "next-step"; "createdAt"?: Timestamp; };
+
+export type Job = { "jobId": Id; "sessionId"?: Id; "toolCallId"?: Id; "title": string; "status": "running" | "completed" | "failed" | "killed" | (string & {}); "startedAt"?: Timestamp; "endedAt"?: Timestamp; "output": { "earliest": number; "total": number; }; };
+
+export type JobChunk = { "at": number; "text": string; "channel": "stdout" | "stderr"; "gapBefore"?: boolean; "lossy"?: boolean; };
+
+export type Device = { "deviceId": Id; "name": string; "model": string; "pairedAt": Timestamp; "lastSeenAt"?: Timestamp; "secureEnclave": boolean; "current": boolean; };
+
+export type ModelCatalog = { "providers": Array<{ "provider": Id; "label": string; "error"?: string; "models": Array<{ "model": Id; "label": string; "efforts": Array<string>; }>; }>; "default"?: ModelSelection; };
+
+export type PermissionCatalog = { "options": Array<{ "preset": string; "label": string; "description"?: string; "approval": "ask" | "never" | "auto" | (string & {}); }>; "defaultPreset": string; };
+
+export type FileEntry = { "name": string; "type": "file" | "dir" | "symlink" | "other"; "size"?: number; };
+
+export type ChangeFile = { "index": number; "path": string; "display": string; "status": "added" | "modified" | "deleted" | "renamed" | (string & {}); "added": number; "deleted": number; };
+
+export interface MethodMap {
+  "host.info": { params: HostInfoParams; result: HostInfoResult; };
+  "unsubscribe": { params: UnsubscribeParams; result: UnsubscribeResult; };
+  "sessions.list": { params: SessionsListParams; result: SessionsListResult; };
+  "sessions.watch": { params: SessionsWatchParams; result: SessionsWatchResult; };
+  "workspaces.list": { params: WorkspacesListParams; result: WorkspacesListResult; };
+  "sessions.create": { params: SessionsCreateParams; result: SessionsCreateResult; };
+  "session.watch": { params: SessionWatchParams; result: SessionWatchResult; };
+  "session.history": { params: SessionHistoryParams; result: SessionHistoryResult; };
+  "session.send": { params: SessionSendParams; result: SessionSendResult; };
+  "session.queue.update": { params: SessionQueueUpdateParams; result: SessionQueueUpdateResult; };
+  "session.interrupt": { params: SessionInterruptParams; result: SessionInterruptResult; };
+  "session.setModel": { params: SessionSetModelParams; result: SessionSetModelResult; };
+  "session.setPermission": { params: SessionSetPermissionParams; result: SessionSetPermissionResult; };
+  "models.catalog": { params: ModelsCatalogParams; result: ModelsCatalogResult; };
+  "permissions.catalog": { params: PermissionsCatalogParams; result: PermissionsCatalogResult; };
+  "tool.output": { params: ToolOutputParams; result: ToolOutputResult; };
+  "timeline.text": { params: TimelineTextParams; result: TimelineTextResult; };
+  "interactions.list": { params: InteractionsListParams; result: InteractionsListResult; };
+  "interaction.answer": { params: InteractionAnswerParams; result: InteractionAnswerResult; };
+  "files.list": { params: FilesListParams; result: FilesListResult; };
+  "files.read": { params: FilesReadParams; result: FilesReadResult; };
+  "files.stat": { params: FilesStatParams; result: FilesStatResult; };
+  "files.download": { params: FilesDownloadParams; result: FilesDownloadResult; };
+  "changes.summary": { params: ChangesSummaryParams; result: ChangesSummaryResult; };
+  "changes.diff": { params: ChangesDiffParams; result: ChangesDiffResult; };
+  "deliverables.list": { params: DeliverablesListParams; result: DeliverablesListResult; };
+  "deliverables.download": { params: DeliverablesDownloadParams; result: DeliverablesDownloadResult; };
+  "attachments.begin": { params: AttachmentsBeginParams; result: AttachmentsBeginResult; };
+  "attachments.finish": { params: AttachmentsFinishParams; result: AttachmentsFinishResult; };
+  "jobs.watch": { params: JobsWatchParams; result: JobsWatchResult; };
+  "job.watch": { params: JobWatchParams; result: JobWatchResult; };
+  "devices.list": { params: DevicesListParams; result: DevicesListResult; };
+  "devices.watch": { params: DevicesWatchParams; result: DevicesWatchResult; };
+  "devices.revoke": { params: DevicesRevokeParams; result: DevicesRevokeResult; };
+  "devices.rename": { params: DevicesRenameParams; result: DevicesRenameResult; };
+  "push.register": { params: PushRegisterParams; result: PushRegisterResult; };
+  "push.unregister": { params: PushUnregisterParams; result: PushUnregisterResult; };
+  "push.updatePrefs": { params: PushUpdatePrefsParams; result: PushUpdatePrefsResult; };
+}
+
+export interface EventMap {
+  "workspace.upsert": WorkspaceUpsert;
+  "workspace.remove": WorkspaceRemove;
+  "session.upsert": SessionUpsert;
+  "session.remove": SessionRemove;
+  "timeline.upsert": TimelineUpsert;
+  "timeline.remove": TimelineRemove;
+  "timeline.delta": TimelineDelta;
+  "session.update": SessionUpdate;
+  "interaction.open": InteractionOpen;
+  "interaction.close": InteractionClose;
+  "queue.update": QueueUpdate;
+  "session.reset": SessionReset;
+  "jobs.replace": JobsReplace;
+  "job.output": JobOutput;
+  "job.status": JobStatus;
+  "devices.replace": DevicesReplace;
+}

package/lib/protocol/dmp.js

@@ -0,0 +1 @@
+export {};

package/lib/protocol/schema/dmp-v1/common.schema.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dmp://v1/common.schema.json",
+  "title": "DMP v1 common types",
+  "$defs": {
+    "Id": {
+      "description": "Opaque identifier. Clients must not parse it.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "Timestamp": {
+      "description": "RFC 3339 / ISO 8601 UTC timestamp.",
+      "type": "string",
+      "format": "date-time"
+    },
+    "Seq": {
+      "description": "DSH session-log sequence number as seen through the bridge. -1 means 'before the first event'.",
+      "type": "integer",
+      "minimum": -1
+    },
+    "Base64": {
+      "type": "string",
+      "contentEncoding": "base64",
+      "pattern": "^[A-Za-z0-9+/]*={0,2}$"
+    },
+    "Base64Url": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]+$"
+    },
+    "Uuid": {
+      "type": "string",
+      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
+    },
+    "RelativePath": {
+      "description": "Slash-separated path relative to the session workspace root. '' or '.' is the root.",
+      "type": "string",
+      "maxLength": 4096
+    },
+    "ErrorCode": {
+      "x-dmp-open-enum": true,
+      "enum": [
+        "bad-frame", "version-unsupported", "unauthorized", "revoked", "pairing-closed", "bad-otp",
+        "unknown-method", "unsupported", "invalid-params", "not-found", "expired", "conflict", "busy",
+        "forbidden-path", "too-large", "dsh-unavailable", "dsh-incompatible", "cancelled", "timeout", "internal"
+      ]
+    },
+    "Error": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "message", "retryable"],
+      "properties": {
+        "code": { "$ref": "#/$defs/ErrorCode" },
+        "message": { "type": "string" },
+        "retryable": { "type": "boolean" },
+        "details": { "type": "object" }
+      }
+    },
+    "Capability": {
+      "x-dmp-open-enum": true,
+      "enum": [
+        "sessions", "timeline", "timeline.stream", "send", "send.steer", "queue.edit",
+        "interactions.approval", "interactions.question", "model.select", "permission.select",
+        "files.read", "files.download", "changes", "deliverables", "jobs", "attachments", "push", "devices"
+      ]
+    },
+    "ModelSelection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["provider", "model"],
+      "properties": {
+        "provider": { "$ref": "#/$defs/Id" },
+        "model": { "$ref": "#/$defs/Id" },
+        "effort": { "description": "Adapter-owned reasoning effort; opaque.", "type": "string" }
+      }
+    },
+    "Empty": {
+      "type": "object",
+      "additionalProperties": false
+    },
+    "Accepted": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["accepted"],
+      "properties": { "accepted": { "const": true } }
+    }
+  }
+}