dsh-deeppilot 0.8.1 → 0.8.3

package/lib/index.d.ts

@@ -30,7 +30,7 @@ declare class PromptDeliveryJournal {
 }
 //#endregion
 //#region src/device-auth.d.ts
-declare const DEVICE_SCOPES: readonly ['sessions.read', 'prompt.send', 'sessions.manage', 'interactions.respond', 'notifications.register'];
+declare const DEVICE_SCOPES: readonly ['sessions.read', 'prompt.send', 'sessions.manage', 'interactions.respond', 'notifications.register', 'schedule.manage'];
 type DeviceScope = (typeof DEVICE_SCOPES)[number];
 //#endregion
 //#region src/protocol.d.ts
@@ -233,6 +233,12 @@ interface SessionsApiLike {
     sessionId: string;
     agentPreset?: string;
   }>>;
+  fork?(req: RpcRequestLike<{
+    sessionId: string;
+    atSeq?: number;
+  }>): Promise<RpcResponseLike<{
+    sessionId: string;
+  }>>;
   models?(req: RpcRequestLike<{
     sessionId: string;
   }>): Promise<RpcResponseLike<HostSessionModels>>;
@@ -264,8 +270,8 @@ interface SessionsApiLike {
     };
     data: string;
   }>>;
-  /** DSH 0.1.7+: complete projection baseline for one session; null when the session is gone. */
-  projections?(req: RpcRequestLike<{
+  /** Complete projection baseline for one session; null when it is gone. */
+  projections(req: RpcRequestLike<{
     sessionId: string;
   }>): Promise<RpcResponseLike<{
     asOfSeq: number;
@@ -294,6 +300,82 @@ interface WorkspaceApiLike {
     archivedSessionIds: string[];
   }>>;
 }
+type ScheduleKind = 'after' | 'at' | 'every' | 'daily' | 'weekly' | 'cron';
+interface ScheduleTaskViewLike {
+  id: string;
+  kind: ScheduleKind;
+  title: string;
+  prompt: string;
+  scheduledAt: string;
+  state: 'scheduled' | 'overdue';
+  deliveryMode: 'host';
+  afterSeconds?: number;
+  everySeconds?: number;
+  time?: string;
+  timeZone?: string;
+  weekdays?: number[];
+  expression?: string;
+}
+interface ScheduleHistoryViewLike {
+  id: string;
+  records: Array<{
+    scheduledAt: string;
+    deliveredAt: string;
+    messageId: string;
+    prompt?: string;
+  }>;
+  earlierRecordsUnavailable: boolean;
+  earlierRecordsPruned?: boolean;
+  retention: {
+    days: number;
+    records: number;
+  };
+  nextBefore?: string;
+}
+interface ScheduleApiLike {
+  list(req: RpcRequestLike<{
+    sessionId: string;
+  }>): Promise<RpcResponseLike<{
+    sessionId: string;
+    tasks: ScheduleTaskViewLike[];
+  }>>;
+  history(req: RpcRequestLike<{
+    sessionId: string;
+    id: string;
+    limit: number;
+    before?: string;
+  }>): Promise<RpcResponseLike<{
+    sessionId: string;
+    history: ScheduleHistoryViewLike;
+  }>>;
+  create(req: RpcRequestLike<{
+    sessionId: string;
+    title: string;
+    prompt: string;
+    [key: string]: unknown;
+  }>): Promise<RpcResponseLike<ScheduleTaskViewLike>>;
+  update(req: RpcRequestLike<{
+    sessionId: string;
+    id: string;
+    expected: unknown;
+    title?: string;
+    prompt?: string;
+    change?: unknown;
+  }>): Promise<RpcResponseLike<{
+    id: string;
+    updated: boolean;
+    record?: ScheduleTaskViewLike;
+    code?: string;
+  }>>;
+  delete(req: RpcRequestLike<{
+    sessionId: string;
+    id: string;
+  }>): Promise<RpcResponseLike<{
+    id: string;
+    deleted: boolean;
+    code?: string;
+  }>>;
+}
 interface HostApiLike {
   listDirectory?(req: RpcRequestLike<{
     path?: string;
@@ -445,13 +527,8 @@ interface ApiStreamItemLike {
 interface ApiProxyLike {
   sessions: SessionsApiLike;
   workspace?: WorkspaceApiLike;
+  schedule?: ScheduleApiLike;
   host?: HostApiLike;
-  /**
-   * DSH 0.1.7 added `session.projections`. Absent/false keeps the bridge on
-   * its existing list-row projection hints — the call is gated on this flag so
-   * older hosts never see a failing RPC.
-   */
-  supportsProjections?: boolean;
   respond(message: {
     type: 'client-response';
     rpcId: string;
@@ -520,7 +597,59 @@ interface PromptDocument {
   truncated?: boolean;
 }
 //#endregion
+//#region src/mutation-journal.d.ts
+type MutationErrorCode = 'E_PROTOCOL' | 'E_NOT_FOUND' | 'E_BUSY' | 'E_UNSUPPORTED' | 'E_INTERNAL';
+type MutationOperationResult<T> = {
+  ok: true;
+  value: T;
+} | {
+  ok: false;
+  code: MutationErrorCode;
+  message?: string;
+};
+type MutationDispatchResult<T> = {
+  ok: true;
+  value?: T;
+  replayed?: boolean;
+} | {
+  ok: false;
+  code: MutationErrorCode;
+  message?: string;
+  replayed?: boolean;
+};
+/**
+ * Small durable at-most-once journal for non-prompt mutations.
+ *
+ * Only a hash of the request content is persisted. The successful value is
+ * kept in memory for the current process so a concurrent retry can receive the
+ * same response; after a restart a replay is acknowledged and the client
+ * refetches the authoritative resource. This avoids duplicating reminder
+ * prompts or conversation data in a second journal.
+ */
+declare class MutationJournal {
+  private readonly path?;
+  private readonly persistValues;
+  private readonly entries;
+  private readonly inFlight;
+  private healthy;
+  constructor(path?: string | undefined, persistValues?: boolean);
+  private key;
+  private expired;
+  private save;
+  dispatch<T>(deviceId: string, id: string, content: unknown, operation: () => Promise<MutationOperationResult<T>>): Promise<MutationDispatchResult<T>>;
+}
+//#endregion
 //#region src/host-bridge.d.ts
+type ScheduleBridgeResult<T> = {
+  ok: true;
+  value: T;
+  replayed?: boolean;
+} | {
+  ok: false;
+  kind: 'unsupported' | 'not-found' | 'invalid' | 'conflict' | 'busy' | 'internal';
+  message: string;
+  replayed?: boolean;
+};
 declare class HostBridge {
   private readonly apiProxy;
   private readonly historyBufferMax;
@@ -542,7 +671,9 @@ declare class HostBridge {
   private started;
   private disposed;
   readonly promptDeliveries: PromptDeliveryJournal;
-  constructor(apiProxy: ApiProxyLike, historyBufferMax?: number, deliveryJournalPath?: string);
+  readonly scheduleMutations: MutationJournal;
+  readonly forkMutations: MutationJournal;
+  constructor(apiProxy: ApiProxyLike, historyBufferMax?: number, deliveryJournalPath?: string, scheduleJournalPath?: string, forkJournalPath?: string);
   private pushOutlet;
   private widgetFingerprint;
   /**
@@ -560,8 +691,10 @@ declare class HostBridge {
     notifyAllCategories: boolean;
     models: boolean;
     sessionManagement: boolean;
+    sessionFork: boolean;
     sessionRestore: boolean;
     projectSelection: boolean;
+    schedules: boolean;
     push: boolean;
     widgetPush: boolean;
     liveActivityPush: boolean;
@@ -639,7 +772,7 @@ declare class HostBridge {
   /** Tail history for an opened session; pushes s2c.session.tail to the sink. */
   openSession(sink: BridgeSink, sessionId: string, tailCount: number): Promise<boolean>;
   /**
-   * Pull one session's projection baseline (DSH 0.1.7+) and fold every key
+   * Pull one session's projection baseline and fold every key
    * through applyProjection — unknown keys are ignored there, `null` means the
    * session no longer exists, and any failure degrades to a diagnostic: opening
    * a session must never fail because a baseline could not be read.
@@ -683,6 +816,35 @@ declare class HostBridge {
     workspaceId?: string;
     cwd?: string;
   }): Promise<string | null>;
+  forkSession(deviceId: string, payload: {
+    clientRequestId: string;
+    sessionId: string;
+    atSeq?: number;
+  }): Promise<ScheduleBridgeResult<{
+    sessionId: string;
+  }>>;
+  listSchedules(sessionId: string): Promise<ScheduleBridgeResult<ScheduleTaskViewLike[]>>;
+  scheduleHistory(sessionId: string, id: string, limit: number, before?: string): Promise<ScheduleBridgeResult<ScheduleHistoryViewLike>>;
+  createSchedule(deviceId: string, payload: Record<string, unknown> & {
+    sessionId: string;
+    clientRequestId: string;
+    title: string;
+    prompt: string;
+  }): Promise<ScheduleBridgeResult<ScheduleTaskViewLike>>;
+  updateSchedule(deviceId: string, payload: Record<string, unknown> & {
+    sessionId: string;
+    id: string;
+    clientRequestId: string;
+    expected: unknown;
+  }): Promise<ScheduleBridgeResult<ScheduleTaskViewLike>>;
+  deleteSchedule(deviceId: string, payload: {
+    sessionId: string;
+    id: string;
+    clientRequestId: string;
+  }): Promise<ScheduleBridgeResult<{
+    id: string;
+    deleted: true;
+  }>>;
   sendPrompt(sessionId: string, text: string, images?: Array<{
     mediaType: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif';
     data: string;
@@ -744,18 +906,18 @@ interface Config {
   };
 }
 declare const Config: z<Schemastery.ObjectS<NoInfer<{
-  enabled: z<boolean, boolean, "defined">;
+  enabled: z<boolean, boolean, "volatile-defined">;
   devicesPath: z<string, string, "defined">;
   historyBufferMax: z<number, number, "defined">;
-  debug: z<boolean, boolean, "defined">;
-  local: z<Schemastery.ObjectS<NoInfer<{
+  debug: z<boolean, boolean, "volatile-defined">;
+  local: z<NoInfer<Schemastery.ObjectS<NoInfer<{
     enabled: z<boolean, boolean, "defined">;
     port: z<number, number, "defined">;
-  }>>, Schemastery.ObjectT<NoInfer<{
+  }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
     enabled: z<boolean, boolean, "defined">;
     port: z<number, number, "defined">;
-  }>>, "defined">;
-  remote: z<Schemastery.ObjectS<NoInfer<{
+  }>>>, "volatile-defined">;
+  remote: z<NoInfer<Schemastery.ObjectS<NoInfer<{
     enabled: z<boolean, boolean, "defined">;
     provider: z<"tailscale-funnel", "tailscale-funnel", "defined">;
     hostname: z<string, string, "defined">;
@@ -763,7 +925,7 @@ declare const Config: z<Schemastery.ObjectS<NoInfer<{
     helperPath: z<string, string, "defined">;
     funnelPort: z<443 | 8443 | 10000, 443 | 8443 | 10000, "defined">;
     maxConnectionsPerSource: z<number, number, "defined">;
-  }>>, Schemastery.ObjectT<NoInfer<{
+  }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
     enabled: z<boolean, boolean, "defined">;
     provider: z<"tailscale-funnel", "tailscale-funnel", "defined">;
     hostname: z<string, string, "defined">;
@@ -771,7 +933,7 @@ declare const Config: z<Schemastery.ObjectS<NoInfer<{
     helperPath: z<string, string, "defined">;
     funnelPort: z<443 | 8443 | 10000, 443 | 8443 | 10000, "defined">;
     maxConnectionsPerSource: z<number, number, "defined">;
-  }>>, "defined">;
+  }>>>, "volatile-defined">;
   push: z<Schemastery.ObjectS<NoInfer<{
     provider: z<"apns" | "none" | "relay", "apns" | "none" | "relay", "defined">;
     contentMode: z<"generic" | "preview", "generic" | "preview", "defined">;
@@ -792,18 +954,18 @@ declare const Config: z<Schemastery.ObjectS<NoInfer<{
     relayToken: z<string, string, "defined">;
   }>>, "defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
-  enabled: z<boolean, boolean, "defined">;
+  enabled: z<boolean, boolean, "volatile-defined">;
   devicesPath: z<string, string, "defined">;
   historyBufferMax: z<number, number, "defined">;
-  debug: z<boolean, boolean, "defined">;
-  local: z<Schemastery.ObjectS<NoInfer<{
+  debug: z<boolean, boolean, "volatile-defined">;
+  local: z<NoInfer<Schemastery.ObjectS<NoInfer<{
     enabled: z<boolean, boolean, "defined">;
     port: z<number, number, "defined">;
-  }>>, Schemastery.ObjectT<NoInfer<{
+  }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
     enabled: z<boolean, boolean, "defined">;
     port: z<number, number, "defined">;
-  }>>, "defined">;
-  remote: z<Schemastery.ObjectS<NoInfer<{
+  }>>>, "volatile-defined">;
+  remote: z<NoInfer<Schemastery.ObjectS<NoInfer<{
     enabled: z<boolean, boolean, "defined">;
     provider: z<"tailscale-funnel", "tailscale-funnel", "defined">;
     hostname: z<string, string, "defined">;
@@ -811,7 +973,7 @@ declare const Config: z<Schemastery.ObjectS<NoInfer<{
     helperPath: z<string, string, "defined">;
     funnelPort: z<443 | 8443 | 10000, 443 | 8443 | 10000, "defined">;
     maxConnectionsPerSource: z<number, number, "defined">;
-  }>>, Schemastery.ObjectT<NoInfer<{
+  }>>>, NoInfer<Schemastery.ObjectT<NoInfer<{
     enabled: z<boolean, boolean, "defined">;
     provider: z<"tailscale-funnel", "tailscale-funnel", "defined">;
     hostname: z<string, string, "defined">;
@@ -819,7 +981,7 @@ declare const Config: z<Schemastery.ObjectS<NoInfer<{
     helperPath: z<string, string, "defined">;
     funnelPort: z<443 | 8443 | 10000, 443 | 8443 | 10000, "defined">;
     maxConnectionsPerSource: z<number, number, "defined">;
-  }>>, "defined">;
+  }>>>, "volatile-defined">;
   push: z<Schemastery.ObjectS<NoInfer<{
     provider: z<"apns" | "none" | "relay", "apns" | "none" | "relay", "defined">;
     contentMode: z<"generic" | "preview", "generic" | "preview", "defined">;
@@ -867,8 +1029,8 @@ declare function shouldReEnrollRelayToken(transport: 'apns' | 'relay', outcome:
  * devices) and loopback Funnel-origin listeners. The web UI and the rest of
  * DSH's API are never exposed by these listeners.
  *
- * Data plane: an in-process HostBridge consumes a local compatibility façade
- * over DSH 0.1.2 Session/Workspace controllers, mirrors session summaries,
+ * Data plane: an in-process HostBridge consumes a local adapter over DSH
+ * Session/Workspace controllers, mirrors session summaries,
  * tracks pending approvals/questions, and fans projected protocol-v2 pushes
  * out to every connected device.
  *