dsh-deeppilot 0.4.0 → 0.5.0

package/lib/index.d.ts

@@ -1,4 +1,3 @@
-import { IncomingMessage } from "node:http";
 import z from "@deepseek-ai/schemastery";
 import { Context } from "@deepseek-ai/cordis";
 //#region src/protocol.d.ts
@@ -26,6 +25,51 @@ interface SessionSummary {
   workspaceId?: string | null;
   workspacePath?: string | null;
 }
+type MessageRole = 'user' | 'assistant' | 'tool' | 'system' | 'error';
+type ToolState = 'running' | 'ok' | 'error';
+/** Provenance of host-injected context; present only on `role: "system"` rows.
+ * Mirrors the durable DSH message source (`dsh-llm` MessageSource): `label`
+ * names the producer (plugin name, skill name, instruction paths…), `form` is
+ * the semantic ContextForm vocabulary ('instructions' | 'catalog' | 'snapshot'
+ * | 'notice' | 'relay' | 'recall'). Both degrade gracefully — clients must
+ * tolerate absent fields and unknown values. */
+interface MessageContextInfo {
+  label?: string;
+  form?: string;
+}
+/** One image carried by a user message. `attachmentId` keys the read-back RPC
+ * (c2s.session.attachment); width/height let clients reserve layout space. */
+interface MessageAttachment {
+  kind: 'image';
+  name?: string;
+  mediaType?: string;
+  attachmentId?: string;
+  width?: number;
+  height?: number;
+}
+interface MessageProjection {
+  /** Durable row identity; unique within one session/page. */
+  seq: number;
+  role: MessageRole;
+  text?: string;
+  /** Reasoning ("thinking") text accompanying the answer, when present. */
+  thinking?: string;
+  streaming?: boolean;
+  tool?: {
+    name: string;
+    state: ToolState;
+    summary: string;
+  };
+  attachments?: MessageAttachment[];
+  /** Present only on system rows: provenance of the injected context.
+   * The DSH host logs synthetic agent.inject() content (runtime-context
+   * snapshots, background-job notices, workspace instructions…) as user-role
+   * messages whose `source.kind` is not 'user'; those project here as
+   * `role: "system"` so clients never show them as human prompts. */
+  context?: MessageContextInfo;
+  ts: number;
+  truncated?: boolean;
+}
 type NotifyCategory = 'turn.completed' | 'approval.required' | 'question.asked' | 'session.error';
 /**
  * One offline-push-worthy event (same facts as s2c.notify / pending frames,
@@ -452,7 +496,11 @@ declare class HostBridge {
   pendingSnapshot(): PendingSnapshotPayload;
   /** Tail history for an opened session; pushes s2c.session.tail to the sink. */
   openSession(sink: BridgeSink, sessionId: string, tailCount: number): Promise<boolean>;
-  historyPage(sink: BridgeSink, sessionId: string, beforeSeq: number, limit: number): Promise<boolean>;
+  historyPage(sessionId: string, beforeSeq: number, limit: number): Promise<{
+    sessionId: string;
+    messages: MessageProjection[];
+    hasMore: boolean;
+  } | null>;
   /** Result of one attachment read-back for the phone. */
   attachmentData(sessionId: string, attachmentId: string): Promise<{
     mediaType?: string;
@@ -498,9 +546,7 @@ declare class HostBridge {
 interface Config {
   /** Master switch; when false the plugin activates and does nothing. */
   enabled?: boolean;
-  /** Pairing token file (0600); generated on first boot when missing. */
-  authTokenPath?: string;
-  /** Paired-device registry JSON path. */
+  /** Protocol-v2 device registry JSON path. */
   devicesPath?: string;
   /** Replay ring buffer bound (frames) per deployment. */
   historyBufferMax?: number;
@@ -514,6 +560,8 @@ interface Config {
     statePath?: string;
     helperPath?: string;
     funnelPort?: 443 | 8443 | 10000;
+    /** Concurrent Funnel WebSockets allowed from one public source address. */
+    maxConnectionsPerSource?: number;
   };
   /**
    * Offline push (F-9). `apns` sends directly from the Mac with the user's
@@ -540,7 +588,6 @@ interface Config {
 }
 declare const Config: z<Schemastery.ObjectS<{
   enabled: z<boolean, boolean>;
-  authTokenPath: z<string, string>;
   devicesPath: z<string, string>;
   historyBufferMax: z<number, number>;
   debug: z<boolean, boolean>;
@@ -551,6 +598,7 @@ declare const Config: z<Schemastery.ObjectS<{
     statePath: z<string, string>;
     helperPath: z<string, string>;
     funnelPort: z<443 | 8443 | 10000, 443 | 8443 | 10000>;
+    maxConnectionsPerSource: z<number, number>;
   }>, Schemastery.ObjectT<{
     enabled: z<boolean, boolean>;
     provider: z<"tailscale-funnel", "tailscale-funnel">;
@@ -558,6 +606,7 @@ declare const Config: z<Schemastery.ObjectS<{
     statePath: z<string, string>;
     helperPath: z<string, string>;
     funnelPort: z<443 | 8443 | 10000, 443 | 8443 | 10000>;
+    maxConnectionsPerSource: z<number, number>;
   }>>;
   push: z<Schemastery.ObjectS<{
     provider: z<"none" | "apns" | "relay", "none" | "apns" | "relay">;
@@ -578,7 +627,6 @@ declare const Config: z<Schemastery.ObjectS<{
   }>>;
 }>, Schemastery.ObjectT<{
   enabled: z<boolean, boolean>;
-  authTokenPath: z<string, string>;
   devicesPath: z<string, string>;
   historyBufferMax: z<number, number>;
   debug: z<boolean, boolean>;
@@ -589,6 +637,7 @@ declare const Config: z<Schemastery.ObjectS<{
     statePath: z<string, string>;
     helperPath: z<string, string>;
     funnelPort: z<443 | 8443 | 10000, 443 | 8443 | 10000>;
+    maxConnectionsPerSource: z<number, number>;
   }>, Schemastery.ObjectT<{
     enabled: z<boolean, boolean>;
     provider: z<"tailscale-funnel", "tailscale-funnel">;
@@ -596,6 +645,7 @@ declare const Config: z<Schemastery.ObjectS<{
     statePath: z<string, string>;
     helperPath: z<string, string>;
     funnelPort: z<443 | 8443 | 10000, 443 | 8443 | 10000>;
+    maxConnectionsPerSource: z<number, number>;
   }>>;
   push: z<Schemastery.ObjectS<{
     provider: z<"none" | "apns" | "relay", "none" | "apns" | "relay">;
@@ -616,10 +666,6 @@ declare const Config: z<Schemastery.ObjectS<{
   }>>;
 }>>;
 //#endregion
-//#region src/phone-http.d.ts
-/** Authorization is preferred; the query form remains for older app builds. */
-declare function requestToken(req: Pick<IncomingMessage, 'url' | 'headers'>): string | null;
-//#endregion
 //#region src/push-policy.d.ts
 /** Prune only when the provider supplies an authoritative token-lifecycle verdict. */
 declare function shouldPrunePushToken(outcome: 'sent' | 'invalid-token' | 'failed', reason?: string): boolean;
@@ -642,17 +688,18 @@ declare function shouldReEnrollRelayToken(transport: 'apns' | 'relay', outcome:
  * optional health probe (/phone/health) on the existing web server. The web
  * UI is never touched.
  *
- * Data plane: an in-process HostBridge consumes apiProxy.events.mux()/host()
- * streams, mirrors session summaries, tracks pending approvals/questions,
- * and fans projected protocol-v1 pushes out to every connected device.
+ * Data plane: an in-process HostBridge consumes a local compatibility façade
+ * over DSH 0.1.2 Session/Workspace controllers, mirrors session summaries,
+ * tracks pending approvals/questions, and fans projected protocol-v2 pushes
+ * out to every connected device.
  *
  * Protocol: PROTOCOL.md is normative; src/protocol.ts and the private app's
- * Swift models mirror that v1 contract.
+ * Swift models mirror that v2 contract.
  */
 declare const name = "deeppilot";
 /** No eager service requirement: profiles without a web stack simply skip. */
 declare const inject: string[];
 declare function apply(ctx: Context, options: unknown): void;
 //#endregion
-export { Config, HostBridge, apply, inject, name, requestToken, shouldPrunePushToken, shouldReEnrollRelayToken };
+export { Config, HostBridge, apply, inject, name, shouldPrunePushToken, shouldReEnrollRelayToken };
 //# sourceMappingURL=index.d.ts.map