@agentdock/wire 0.0.90 → 0.0.91

package/dist/inboundEvents.d.ts

@@ -0,0 +1,531 @@
+/**
+ * Inbound Socket.IO event payload schemas (daemon/web → server).
+ *
+ * These validate the HIGHEST-FREQUENCY channel in the system: every session
+ * create / state change / message / machine register flows through here. Unlike
+ * REST bodies (validated by `.strict()` schemas in their own modules), these
+ * events were historically validated by hand-written `is*` type predicates in
+ * server's `sessionPayloads.ts` — which drift from the wire contract silently.
+ *
+ * Mode choice — `.passthrough()`, NOT `.strict()`:
+ *   The daemon runs on the user's machine and upgrades lag the server. A newer
+ *   daemon may add fields an older server hasn't learned yet; strict rejection
+ *   would fail the whole session-create over an additive field. Passthrough lets
+ *   additive fields ride along while still enforcing that REQUIRED fields exist
+ *   with the right type — which is the actual defense against silent drops.
+ *   Same principle already applied in envelope.ts / machine.ts.
+ *
+ * When a field is intentionally NOT consumed by the server (daemon-only
+ * bookkeeping), that's fine — passthrough carries it. Required fields the server
+ * relies on are listed explicitly below.
+ */
+import { z } from 'zod';
+/** session-create — createSession() in daemon serverClient. */
+export declare const SessionCreatePayloadSchema: z.ZodObject<{
+    tag: z.ZodString;
+    metadata: z.ZodOptional<z.ZodString>;
+    dataEncryptionKey: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+    claudeSessionId: z.ZodOptional<z.ZodString>;
+    projectPath: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    tag: z.ZodString;
+    metadata: z.ZodOptional<z.ZodString>;
+    dataEncryptionKey: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+    claudeSessionId: z.ZodOptional<z.ZodString>;
+    projectPath: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    tag: z.ZodString;
+    metadata: z.ZodOptional<z.ZodString>;
+    dataEncryptionKey: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+    claudeSessionId: z.ZodOptional<z.ZodString>;
+    projectPath: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export type SessionCreatePayload = z.infer<typeof SessionCreatePayloadSchema>;
+/** update-metadata — optimistic-concurrency metadata write. */
+export declare const UpdateMetadataPayloadSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    metadata: z.ZodString;
+    expectedVersion: z.ZodNumber;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    sessionId: z.ZodString;
+    metadata: z.ZodString;
+    expectedVersion: z.ZodNumber;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    sessionId: z.ZodString;
+    metadata: z.ZodString;
+    expectedVersion: z.ZodNumber;
+}, z.ZodTypeAny, "passthrough">>;
+export type UpdateMetadataPayload = z.infer<typeof UpdateMetadataPayloadSchema>;
+/** context-usage-update — best-effort context-usage snapshot write (no CAS). */
+export declare const ContextUsageUpdatePayloadSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    contextUsage: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    sessionId: z.ZodString;
+    contextUsage: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    sessionId: z.ZodString;
+    contextUsage: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.ZodTypeAny, "passthrough">>;
+export type ContextUsageUpdatePayload = z.infer<typeof ContextUsageUpdatePayloadSchema>;
+/** update-state — optimistic-concurrency agent-state write. */
+export declare const UpdateStatePayloadSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    agentState: z.ZodString;
+    expectedVersion: z.ZodNumber;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    sessionId: z.ZodString;
+    agentState: z.ZodString;
+    expectedVersion: z.ZodNumber;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    sessionId: z.ZodString;
+    agentState: z.ZodString;
+    expectedVersion: z.ZodNumber;
+}, z.ZodTypeAny, "passthrough">>;
+export type UpdateStatePayload = z.infer<typeof UpdateStatePayloadSchema>;
+/** session-alive optionally consumes a server-issued resume takeover reservation. */
+export declare const SessionAlivePayloadSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    takeoverToken: z.ZodOptional<z.ZodString>;
+    runtimeStatus: z.ZodOptional<z.ZodEnum<["idle", "thinking", "tool_running", "permission_required", "disconnected"]>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    sessionId: z.ZodString;
+    takeoverToken: z.ZodOptional<z.ZodString>;
+    runtimeStatus: z.ZodOptional<z.ZodEnum<["idle", "thinking", "tool_running", "permission_required", "disconnected"]>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    sessionId: z.ZodString;
+    takeoverToken: z.ZodOptional<z.ZodString>;
+    runtimeStatus: z.ZodOptional<z.ZodEnum<["idle", "thinking", "tool_running", "permission_required", "disconnected"]>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type SessionAlivePayload = z.infer<typeof SessionAlivePayloadSchema>;
+/** Read-only web query for the server's short-lived daemon runtime snapshot. */
+export declare const GetSessionRuntimeStatusPayloadSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    sessionId: string;
+}, {
+    sessionId: string;
+}>;
+export type GetSessionRuntimeStatusPayload = z.infer<typeof GetSessionRuntimeStatusPayloadSchema>;
+export declare const SessionDeletePayloadSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    sessionId: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    sessionId: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+export type SessionDeletePayload = z.infer<typeof SessionDeletePayloadSchema>;
+/** session-end — carries optional summary (was silently dropped by old predicate). */
+export declare const SessionEndPayloadSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    sessionId: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    sessionId: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export type SessionEndPayload = z.infer<typeof SessionEndPayloadSchema>;
+/** rename-session. */
+export declare const RenameSessionPayloadSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    displayName: z.ZodEffects<z.ZodString, string, string>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    sessionId: z.ZodString;
+    displayName: z.ZodEffects<z.ZodString, string, string>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    sessionId: z.ZodString;
+    displayName: z.ZodEffects<z.ZodString, string, string>;
+}, z.ZodTypeAny, "passthrough">>;
+export type RenameSessionPayload = z.infer<typeof RenameSessionPayloadSchema>;
+/** message — single message insert. `content` shape validated downstream. */
+export declare const MessagePayloadSchema: z.ZodEffects<z.ZodObject<{
+    sessionId: z.ZodString;
+    localId: z.ZodString;
+    content: z.ZodUnknown;
+    skipBroadcast: z.ZodOptional<z.ZodBoolean>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    sessionId: z.ZodString;
+    localId: z.ZodString;
+    content: z.ZodUnknown;
+    skipBroadcast: z.ZodOptional<z.ZodBoolean>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    sessionId: z.ZodString;
+    localId: z.ZodString;
+    content: z.ZodUnknown;
+    skipBroadcast: z.ZodOptional<z.ZodBoolean>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
+    sessionId: z.ZodString;
+    localId: z.ZodString;
+    content: z.ZodUnknown;
+    skipBroadcast: z.ZodOptional<z.ZodBoolean>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    sessionId: z.ZodString;
+    localId: z.ZodString;
+    content: z.ZodUnknown;
+    skipBroadcast: z.ZodOptional<z.ZodBoolean>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">>;
+export type MessagePayload = z.infer<typeof MessagePayloadSchema>;
+export declare const BatchMessagePayloadSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    messages: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        localId: z.ZodString;
+        content: z.ZodUnknown;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        localId: z.ZodString;
+        content: z.ZodUnknown;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        localId: z.ZodString;
+        content: z.ZodUnknown;
+    }, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
+        localId: z.ZodString;
+        content: z.ZodUnknown;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        localId: z.ZodString;
+        content: z.ZodUnknown;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    skipBroadcast: z.ZodOptional<z.ZodBoolean>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    sessionId: z.ZodString;
+    messages: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        localId: z.ZodString;
+        content: z.ZodUnknown;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        localId: z.ZodString;
+        content: z.ZodUnknown;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        localId: z.ZodString;
+        content: z.ZodUnknown;
+    }, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
+        localId: z.ZodString;
+        content: z.ZodUnknown;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        localId: z.ZodString;
+        content: z.ZodUnknown;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    skipBroadcast: z.ZodOptional<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    sessionId: z.ZodString;
+    messages: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        localId: z.ZodString;
+        content: z.ZodUnknown;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        localId: z.ZodString;
+        content: z.ZodUnknown;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        localId: z.ZodString;
+        content: z.ZodUnknown;
+    }, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
+        localId: z.ZodString;
+        content: z.ZodUnknown;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        localId: z.ZodString;
+        content: z.ZodUnknown;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    skipBroadcast: z.ZodOptional<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">>;
+export type BatchMessagePayload = z.infer<typeof BatchMessagePayloadSchema>;
+/** get-messages — paginated read. */
+export declare const GetMessagesPayloadSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    fromSeq: z.ZodOptional<z.ZodNumber>;
+    beforeSeq: z.ZodOptional<z.ZodNumber>;
+    order: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    sessionId: z.ZodString;
+    fromSeq: z.ZodOptional<z.ZodNumber>;
+    beforeSeq: z.ZodOptional<z.ZodNumber>;
+    order: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    sessionId: z.ZodString;
+    fromSeq: z.ZodOptional<z.ZodNumber>;
+    beforeSeq: z.ZodOptional<z.ZodNumber>;
+    order: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">>;
+export type GetMessagesPayload = z.infer<typeof GetMessagesPayloadSchema>;
+/**
+ * session-status — daemon's fire-and-forget status ping.
+ *
+ * NOTE: `status` here is a free string, NOT the `SessionStatusSchema` enum in
+ * machine.ts — that enum omits `turn-completed`, which the daemon DOES send.
+ * The set below is the daemon's actual vocabulary.
+ *
+ * SECURITY — this schema is `.strict()` ON PURPOSE (the only inbound schema that
+ * is). IM notifications derived from this event are delivered to third-party
+ * webhooks (Feishu/DingTalk). This channel must carry NOTHING but the two fields
+ * below — no conversation content, no summary, no message text, no future field
+ * that might smuggle sensitive data out. `.strict()` REJECTS any extra field
+ * (loudly, not silently), so the day someone tries to attach `summary` /
+ * `context` / `lastMessage` / anything else, their code fails here and they are
+ * forced to ask "can this field leave the machine?". Default-deny, then allow.
+ * Do NOT relax this to `.passthrough()`. See docs/spec/notification-im.md.
+ */
+export declare const INBOUND_SESSION_STATUSES: readonly ["idle", "thinking", "tool_running", "permission_required", "disconnected", "turn-completed"];
+export declare const SessionStatusPayloadSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    status: z.ZodEnum<["idle", "thinking", "tool_running", "permission_required", "disconnected", "turn-completed"]>;
+}, "strict", z.ZodTypeAny, {
+    status: "idle" | "thinking" | "tool_running" | "permission_required" | "disconnected" | "turn-completed";
+    sessionId: string;
+}, {
+    status: "idle" | "thinking" | "tool_running" | "permission_required" | "disconnected" | "turn-completed";
+    sessionId: string;
+}>;
+export type SessionStatusPayload = z.infer<typeof SessionStatusPayloadSchema>;
+/**
+ * machine-register — daemon reports its identity + capabilities on connect.
+ * Mirrors daemon's MachineRegisterInfo; only hostname/platform are required.
+ * All capability fields are optional and additive (passthrough tolerates new
+ * ones a newer daemon may add).
+ */
+export declare const MachineRegisterPayloadSchema: z.ZodObject<{
+    hostname: z.ZodString;
+    platform: z.ZodString;
+    arch: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodOptional<z.ZodString>;
+    daemonVersion: z.ZodOptional<z.ZodString>;
+    availableAgents: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    agentVersions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    terminalHost: z.ZodOptional<z.ZodString>;
+    terminalPort: z.ZodOptional<z.ZodNumber>;
+    upgradeStatus: z.ZodOptional<z.ZodString>;
+    upgradeError: z.ZodOptional<z.ZodString>;
+    lastUpgradeError: z.ZodOptional<z.ZodString>;
+    derivationVersion: z.ZodOptional<z.ZodNumber>;
+    autoUpgradeDaemon: z.ZodOptional<z.ZodBoolean>;
+    notifyFeishu: z.ZodOptional<z.ZodBoolean>;
+    notifyDingtalk: z.ZodOptional<z.ZodBoolean>;
+    agentModels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        isDefault: z.ZodBoolean;
+        hidden: z.ZodBoolean;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        isDefault: z.ZodBoolean;
+        hidden: z.ZodBoolean;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        isDefault: z.ZodBoolean;
+        hidden: z.ZodBoolean;
+    }, z.ZodTypeAny, "passthrough">>, "many">>>;
+    agentModes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    hostname: z.ZodString;
+    platform: z.ZodString;
+    arch: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodOptional<z.ZodString>;
+    daemonVersion: z.ZodOptional<z.ZodString>;
+    availableAgents: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    agentVersions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    terminalHost: z.ZodOptional<z.ZodString>;
+    terminalPort: z.ZodOptional<z.ZodNumber>;
+    upgradeStatus: z.ZodOptional<z.ZodString>;
+    upgradeError: z.ZodOptional<z.ZodString>;
+    lastUpgradeError: z.ZodOptional<z.ZodString>;
+    derivationVersion: z.ZodOptional<z.ZodNumber>;
+    autoUpgradeDaemon: z.ZodOptional<z.ZodBoolean>;
+    notifyFeishu: z.ZodOptional<z.ZodBoolean>;
+    notifyDingtalk: z.ZodOptional<z.ZodBoolean>;
+    agentModels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        isDefault: z.ZodBoolean;
+        hidden: z.ZodBoolean;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        isDefault: z.ZodBoolean;
+        hidden: z.ZodBoolean;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        isDefault: z.ZodBoolean;
+        hidden: z.ZodBoolean;
+    }, z.ZodTypeAny, "passthrough">>, "many">>>;
+    agentModes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    hostname: z.ZodString;
+    platform: z.ZodString;
+    arch: z.ZodOptional<z.ZodString>;
+    displayName: z.ZodOptional<z.ZodString>;
+    daemonVersion: z.ZodOptional<z.ZodString>;
+    availableAgents: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    agentVersions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    terminalHost: z.ZodOptional<z.ZodString>;
+    terminalPort: z.ZodOptional<z.ZodNumber>;
+    upgradeStatus: z.ZodOptional<z.ZodString>;
+    upgradeError: z.ZodOptional<z.ZodString>;
+    lastUpgradeError: z.ZodOptional<z.ZodString>;
+    derivationVersion: z.ZodOptional<z.ZodNumber>;
+    autoUpgradeDaemon: z.ZodOptional<z.ZodBoolean>;
+    notifyFeishu: z.ZodOptional<z.ZodBoolean>;
+    notifyDingtalk: z.ZodOptional<z.ZodBoolean>;
+    agentModels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        isDefault: z.ZodBoolean;
+        hidden: z.ZodBoolean;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        isDefault: z.ZodBoolean;
+        hidden: z.ZodBoolean;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        isDefault: z.ZodBoolean;
+        hidden: z.ZodBoolean;
+    }, z.ZodTypeAny, "passthrough">>, "many">>>;
+    agentModes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type MachineRegisterPayload = z.infer<typeof MachineRegisterPayloadSchema>;
+/** register-history-sessions — RFC-016 history sync batch. */
+export declare const HistorySessionEntrySchema: z.ZodObject<{
+    claudeSessionId: z.ZodString;
+    projectPath: z.ZodString;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    messageCount: z.ZodNumber;
+    createdAt: z.ZodString;
+    agentType: z.ZodString;
+    isSubagent: z.ZodOptional<z.ZodBoolean>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    claudeSessionId: z.ZodString;
+    projectPath: z.ZodString;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    messageCount: z.ZodNumber;
+    createdAt: z.ZodString;
+    agentType: z.ZodString;
+    isSubagent: z.ZodOptional<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    claudeSessionId: z.ZodString;
+    projectPath: z.ZodString;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    messageCount: z.ZodNumber;
+    createdAt: z.ZodString;
+    agentType: z.ZodString;
+    isSubagent: z.ZodOptional<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">>;
+export type HistorySessionEntry = z.infer<typeof HistorySessionEntrySchema>;
+export declare const RegisterHistorySessionsPayloadSchema: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        claudeSessionId: z.ZodString;
+        projectPath: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        messageCount: z.ZodNumber;
+        createdAt: z.ZodString;
+        agentType: z.ZodString;
+        isSubagent: z.ZodOptional<z.ZodBoolean>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        claudeSessionId: z.ZodString;
+        projectPath: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        messageCount: z.ZodNumber;
+        createdAt: z.ZodString;
+        agentType: z.ZodString;
+        isSubagent: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        claudeSessionId: z.ZodString;
+        projectPath: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        messageCount: z.ZodNumber;
+        createdAt: z.ZodString;
+        agentType: z.ZodString;
+        isSubagent: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    entries: z.ZodArray<z.ZodObject<{
+        claudeSessionId: z.ZodString;
+        projectPath: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        messageCount: z.ZodNumber;
+        createdAt: z.ZodString;
+        agentType: z.ZodString;
+        isSubagent: z.ZodOptional<z.ZodBoolean>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        claudeSessionId: z.ZodString;
+        projectPath: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        messageCount: z.ZodNumber;
+        createdAt: z.ZodString;
+        agentType: z.ZodString;
+        isSubagent: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        claudeSessionId: z.ZodString;
+        projectPath: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        messageCount: z.ZodNumber;
+        createdAt: z.ZodString;
+        agentType: z.ZodString;
+        isSubagent: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    entries: z.ZodArray<z.ZodObject<{
+        claudeSessionId: z.ZodString;
+        projectPath: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        messageCount: z.ZodNumber;
+        createdAt: z.ZodString;
+        agentType: z.ZodString;
+        isSubagent: z.ZodOptional<z.ZodBoolean>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        claudeSessionId: z.ZodString;
+        projectPath: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        messageCount: z.ZodNumber;
+        createdAt: z.ZodString;
+        agentType: z.ZodString;
+        isSubagent: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        claudeSessionId: z.ZodString;
+        projectPath: z.ZodString;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        messageCount: z.ZodNumber;
+        createdAt: z.ZodString;
+        agentType: z.ZodString;
+        isSubagent: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+}, z.ZodTypeAny, "passthrough">>;
+export type RegisterHistorySessionsPayload = z.infer<typeof RegisterHistorySessionsPayloadSchema>;
+//# sourceMappingURL=inboundEvents.d.ts.map

package/dist/inboundEvents.js

@@ -0,0 +1 @@
+"use strict";import{z as o}from"zod";const t=o.string().min(1);export const SessionCreatePayloadSchema=o.object({tag:t,metadata:o.string().optional(),dataEncryptionKey:o.string().optional(),source:o.string().optional(),claudeSessionId:o.string().optional(),projectPath:o.string().optional()}).passthrough(),UpdateMetadataPayloadSchema=o.object({sessionId:t,metadata:o.string(),expectedVersion:o.number().int().min(0)}).passthrough(),ContextUsageUpdatePayloadSchema=o.object({sessionId:t,contextUsage:o.record(o.unknown())}).passthrough(),UpdateStatePayloadSchema=o.object({sessionId:t,agentState:o.string(),expectedVersion:o.number().int().min(0)}).passthrough(),SessionAlivePayloadSchema=o.object({sessionId:t,takeoverToken:t.optional(),runtimeStatus:o.enum(["idle","thinking","tool_running","permission_required","disconnected"]).optional()}).passthrough(),GetSessionRuntimeStatusPayloadSchema=o.object({sessionId:t}).strict(),SessionDeletePayloadSchema=o.object({sessionId:t}).passthrough(),SessionEndPayloadSchema=o.object({sessionId:t,summary:o.string().optional()}).passthrough(),RenameSessionPayloadSchema=o.object({sessionId:t,displayName:o.string().refine(e=>e.trim()!=="","displayName must not be blank")}).passthrough(),MessagePayloadSchema=o.object({sessionId:t,localId:t,content:o.unknown(),skipBroadcast:o.boolean().optional(),ephemeral:o.boolean().optional()}).passthrough().refine(e=>"content"in e,{message:"content is required",path:["content"]});const n=o.object({localId:t,content:o.unknown()}).passthrough().refine(e=>"content"in e,{message:"content is required",path:["content"]});export const BatchMessagePayloadSchema=o.object({sessionId:t,messages:o.array(n).min(1).max(100),skipBroadcast:o.boolean().optional()}).passthrough(),GetMessagesPayloadSchema=o.object({sessionId:t,fromSeq:o.number().int().min(0).optional(),beforeSeq:o.number().int().min(1).optional(),order:o.enum(["asc","desc"]).optional(),limit:o.number().int().min(1).optional()}).passthrough(),INBOUND_SESSION_STATUSES=["idle","thinking","tool_running","permission_required","disconnected","turn-completed"],SessionStatusPayloadSchema=o.object({sessionId:t,status:o.enum(INBOUND_SESSION_STATUSES)}).strict(),MachineRegisterPayloadSchema=o.object({hostname:t,platform:t,arch:o.string().optional(),displayName:o.string().optional(),daemonVersion:o.string().optional(),availableAgents:o.array(o.string()).optional(),agentVersions:o.record(o.string()).optional(),terminalHost:o.string().optional(),terminalPort:o.number().optional(),upgradeStatus:o.string().optional(),upgradeError:o.string().optional(),lastUpgradeError:o.string().optional(),derivationVersion:o.number().optional(),autoUpgradeDaemon:o.boolean().optional(),notifyFeishu:o.boolean().optional(),notifyDingtalk:o.boolean().optional(),agentModels:o.record(o.array(o.object({id:o.string(),displayName:o.string(),isDefault:o.boolean(),hidden:o.boolean()}).passthrough())).optional(),agentModes:o.record(o.array(o.object({id:o.string(),label:o.string()}).passthrough())).optional()}).passthrough(),HistorySessionEntrySchema=o.object({claudeSessionId:t,projectPath:o.string(),title:o.string().nullable().optional(),messageCount:o.number(),createdAt:o.string(),agentType:o.string(),isSubagent:o.boolean().optional()}).passthrough(),RegisterHistorySessionsPayloadSchema=o.object({entries:o.array(HistorySessionEntrySchema)}).passthrough();

package/dist/index.d.ts

@@ -1,9 +1,11 @@
-export { SessionTextEventSchema, SessionServiceEventSchema, SessionToolCallStartEventSchema, SessionToolCallEndEventSchema, SessionFileEventSchema, SessionTurnStartEventSchema, SessionTurnEndEventSchema, SessionTurnEndStatusSchema, TurnUsageSchema, SessionStartEventSchema, SessionStopEventSchema, SessionEventSchema, SessionPermissionResolvedEventSchema, PermissionActionSchema, SessionImageEventSchema, ImageAttachmentSchema, } from './events.js';
-export type { SessionEvent, SessionTurnEndStatus, TurnUsage, SessionQuestionEvent, SessionPermissionRequestEvent, SessionAnswerEvent, SessionPermissionResolvedEvent, PermissionAction, ImageAttachment, } from './events.js';
+export { SessionTextEventSchema, SessionServiceEventSchema, SessionToolCallStartEventSchema, SessionToolCallEndEventSchema, SessionFileEventSchema, SessionTurnStartEventSchema, SessionTurnEndEventSchema, SessionTurnEndStatusSchema, TurnUsageSchema, SessionStartEventSchema, SessionStopEventSchema, SessionEventSchema, SessionPermissionResolvedEventSchema, PermissionActionSchema, SessionImageEventSchema, ImageAttachmentSchema, SessionContextUsageEventSchema, SessionCompactBoundaryEventSchema, emptyContextUsageSnapshot, } from './events.js';
+export type { SessionEvent, SessionTurnEndStatus, TurnUsage, SessionQuestionEvent, SessionPermissionRequestEvent, SessionAnswerEvent, SessionPermissionResolvedEvent, PermissionAction, ImageAttachment, SessionContextUsageEvent, SessionCompactBoundaryEvent, } from './events.js';
 export { QuestionOptionSchema, SessionQuestionEventSchema, SessionPermissionRequestEventSchema, SessionAnswerEventSchema, AnswerQuestionParamsSchema, ApprovePermissionParamsSchema, DenyPermissionParamsSchema, PermissionModeSchema, } from './interactionEvents.js';
 export type { QuestionOption, AnswerQuestionParams, ApprovePermissionParams, DenyPermissionParams, PermissionModeValue, } from './interactionEvents.js';
 export { SessionRoleSchema, SessionEnvelopeSchema, createEnvelope } from './envelope.js';
 export type { SessionRole, SessionEnvelope, CreateEnvelopeOptions } from './envelope.js';
+export { NotificationEventTypeSchema, DispatchNotificationParamsSchema } from './notification.js';
+export type { NotificationEventType, DispatchNotificationParams } from './notification.js';
 export { AgentTypeSchema, MessageMetaSchema, AGENT_TYPES, SPAWNABLE_AGENTS, CLI_AGENT_TYPES, } from './messageMeta.js';
 export { AGENT_SUPPORTS_IMAGES } from './messageMeta.js';
 export type { AgentType, MessageMeta, CliAgentType } from './messageMeta.js';
@@ -13,7 +15,7 @@ export { UserMessageSchema, AgentMessageSchema, LegacyMessageContentSchema, } fr
 export type { UserMessage, AgentMessage, LegacyMessageContent } from './legacyProtocol.js';
 export { VersionedEncryptedValueSchema, VersionedNullableEncryptedValueSchema, VersionedMachineEncryptedValueSchema, UpdateNewMessageBodySchema, UpdateSessionBodySchema, UpdateMachineBodySchema, UpdateSessionResetBodySchema, CoreUpdateBodySchema, CoreUpdateContainerSchema, } from './sync.js';
 export type { VersionedEncryptedValue, VersionedNullableEncryptedValue, VersionedMachineEncryptedValue, UpdateNewMessageBody, UpdateSessionBody, UpdateMachineBody, UpdateSessionResetBody, CoreUpdateBody, CoreUpdateContainer, } from './sync.js';
-export { RpcMethod, type RpcMethodType, SESSION_RPC_METHODS, MACHINE_RPC_METHODS, DAEMON_REQUIRED_RPC_METHODS, RpcCallSchema, RpcResultSchema, SpawnSessionParamsSchema, GetMessagesParamsSchema, GetMessagesResponseSchema, MachineInfoResponseSchema, CheckPathParamsSchema, AGENT_ENV_NONE, AgentEnvConfigSchema, AgentSettingsSchema, LabsSettingsSchema, CustomModelSchema, SkillDefinitionSchema, } from './rpc.js';
+export { RpcMethod, type RpcMethodType, SESSION_RPC_METHODS, MACHINE_RPC_METHODS, DAEMON_REQUIRED_RPC_METHODS, RpcCallSchema, RpcResultSchema, SpawnSessionParamsSchema, GetMessagesParamsSchema, GetMessagesResponseSchema, MachineInfoResponseSchema, CheckPathParamsSchema, AGENT_ENV_NONE, AgentEnvConfigSchema, AgentEnvConfigSetSchema, AgentSettingsSchema, SetAgentSettingsSchema, LabsSettingsSchema, CustomModelSchema, SkillDefinitionSchema, } from './rpc.js';
 export type { RpcCall, RpcResult, SpawnSessionParams, CheckPathParams, GetMessagesParams, GetMessagesResponse, MachineInfoResponse, AgentEnvConfig, AgentSettings, LabsSettings, CustomModel, SkillDefinition, } from './rpc.js';
 export { AGENT_CAPABILITIES, getAgentCapability, updateDynamicModes, getDynamicModes, normalizeModelId, } from './agentCapabilities.js';
 export type { AgentCapability, AgentPermissionMode, AgentModelOption, ModelSource, } from './agentCapabilities.js';
@@ -30,6 +32,8 @@ export { PairingState, PairingRequestSchema, PairingResponseSchema, PairingExcha
 export type { PairingRequest, PairingResponse, PairingExchange, PairingDeliver, PairingStatus, } from './pairing.js';
 export { PlatformSchema, SessionStatusSchema, MachineSummarySchema, MachineRegisterResultSchema, } from './machine.js';
 export type { Platform, SessionStatus, MachineSummary, MachineRegisterResult } from './machine.js';
+export { SessionCreatePayloadSchema, UpdateMetadataPayloadSchema, UpdateStatePayloadSchema, ContextUsageUpdatePayloadSchema, SessionAlivePayloadSchema, GetSessionRuntimeStatusPayloadSchema, SessionDeletePayloadSchema, SessionEndPayloadSchema, RenameSessionPayloadSchema, MessagePayloadSchema, BatchMessagePayloadSchema, GetMessagesPayloadSchema, SessionStatusPayloadSchema, MachineRegisterPayloadSchema, RegisterHistorySessionsPayloadSchema, HistorySessionEntrySchema, INBOUND_SESSION_STATUSES, } from './inboundEvents.js';
+export type { SessionCreatePayload, UpdateMetadataPayload, UpdateStatePayload, ContextUsageUpdatePayload, SessionAlivePayload, GetSessionRuntimeStatusPayload, SessionDeletePayload, SessionEndPayload, RenameSessionPayload, MessagePayload, BatchMessagePayload, GetMessagesPayload, SessionStatusPayload, MachineRegisterPayload, RegisterHistorySessionsPayload, HistorySessionEntry, } from './inboundEvents.js';
 export { FEATURE_REGISTRY, isFeatureAvailable, getUnavailableFeatures, isSubFeatureAvailable, getSubFeatureMinVersion, } from './features.js';
 export type { FeatureDefinition, SubFeatureDefinition } from './features.js';
 export { SessionResultSchema } from './sessionResult.js';
@@ -53,9 +57,11 @@ export type { BgTaskAction, ParsedBgTask, EncodeBgTaskInput } from './bgTask.js'
 export { BASH_TOOL_NAMES, isBashToolName, extractCommandSubject, MIN_SUBJECT_LENGTH, } from './permissionSubject.js';
 export { SOCKET_EVENTS, type SocketEventName } from './socketEvents.js';
 export { TelemetryEventTypeSchema, TelemetryEventSchema, TelemetryReportPayloadSchema, sanitizeContext, } from './telemetry.js';
-export type { TelemetryEventType, TelemetryEvent, TelemetryReportPayload } from './telemetry.js';
+export type { TelemetryEventType, TelemetryEvent, TelemetryEventStrict, TelemetryReportPayload, } from './telemetry.js';
 export * from './checkpointSchemas.js';
-export { OpsRpcMessageSchema, OpsMethodSchema, OpsRpcTypeSchema, FileEntrySchema, FileStatSchema, StorageUsageSchema, SyncUserSchema, SyncFullPayloadSchema, SyncUserCreatedPayloadSchema, SyncContainerStatusPayloadSchema, SyncUserPairedPayloadSchema, type OpsRpcMessage, type OpsMethod, type OpsRpcType, type OpsTunnelMetrics, type FileEntry, type FileStat, type StorageUsage, type SyncUser, type SyncFullPayload, type SyncUserCreatedPayload, type SyncContainerStatusPayload, type SyncUserPairedPayload, } from './ops.js';
+export { SourceMetadataSchema } from './sourceMetadata.js';
+export type { SourceMetadata } from './sourceMetadata.js';
+export { OpsRpcMessageSchema, OpsMethodSchema, OpsRpcTypeSchema, DockerImageRefSchema, FileEntrySchema, FileStatSchema, StorageUsageSchema, SyncUserSchema, SyncFullPayloadSchema, SyncUserCreatedPayloadSchema, SyncContainerStatusPayloadSchema, SyncUserPairedPayloadSchema, type OpsRpcMessage, type OpsMethod, type OpsRpcType, type DockerImageRef, type OpsTunnelMetrics, type FileEntry, type FileStat, type StorageUsage, type SyncUser, type SyncFullPayload, type SyncUserCreatedPayload, type SyncContainerStatusPayload, type SyncUserPairedPayload, } from './ops.js';
 export * from './edition.js';
 export { LicensePayloadSchema, LicenseFileSchema, EnterpriseLicenseSchema, PrivateLicenseSchema, } from './license.js';
 export type { LicensePayload, LicenseFile, EnterpriseLicensePayload, PrivateLicensePayload, } from './license.js';