@deepseek-ai/dsh-client-connection 0.1.5-rc.2 → 0.1.6-alpha.2

package/lib/index.js

@@ -775,7 +775,7 @@ async function apply(ctx, config) {
 					res.end(rejection === 401 ? "unauthorized" : "forbidden");
 					return;
 				}
-				await bridge(req, res, fetchHandler, maxRequestBodyBytes);
+				await webCtx.waterfall("connection/request", req, res, () => bridge(req, res, fetchHandler, maxRequestBodyBytes));
 			}
 		};
 		webCtx.effect(() => webCtx.webServer.register(route), "client-connection: /api route");

package/lib/types/client/api.d.ts

@@ -6,8 +6,8 @@ export type { MessageId } from '@deepseek-ai/dsh-llm/brand';
 export type { ContentBlock, StreamChunk } from '@deepseek-ai/dsh-llm/types';
 import type { RpcResponse, RpcResult } from '../rpc.ts';
 /**
- * Return the business result carried by a narrow fixture response.
- * @param response - fixture response to unwrap.
+ * Return the business result carried by an RPC response.
+ * @param response - RPC response to unwrap.
  * @returns the response's business result.
  */
 export declare function resultOf<T>(response: RpcResponse<T>): RpcResult<T>;

package/lib/types/client/index.d.ts

@@ -35,15 +35,21 @@ export interface ConnectionStateSource {
 /** Required services (none — this is the wire root). */
 export declare const inject: string[];
 /**
- * Carrier override installed on the page global before plugin boot. The served
- * web app leaves it unset and gets HTTP + WebSocket; a shell that owns a
- * different physical transport (the worker preview's postMessage tunnel)
- * provides both halves here instead of forking this plugin.
+ * Physical carrier selected when the Connection service is installed. The
+ * served web app omits it and gets HTTP + WebSocket; a shell that owns a
+ * different transport (the worker preview's postMessage tunnel) provides both
+ * halves instead of forking this plugin.
  */
 export interface ClientTransportHooks {
-    /** Transport for generic unary RPC channels (the Typert gateway). */
-    fetch: RpcFetch;
-    /** Worker-local Gateway stream carrier; absent when the page uses the Gateway WebSocket. */
+    /**
+     * Already decoded logical RPC carrier. When present it replaces the HTTP
+     * caller outright: no envelopes, no `fetch`, no `openStream` (an in-process
+     * Host such as a test mock plugs in here).
+     */
+    rpc?: ClientConnectionRpc;
+    /** Transport for generic unary RPC channels (the Typert gateway); unused when `rpc` is present. */
+    fetch?: RpcFetch;
+    /** Worker-local Gateway stream carrier; absent when the page uses the Gateway WebSocket or `rpc` is present. */
     openStream?: RpcStreamOpen;
     /**
      * Bundle transport for the module system, present when the carrier also owns
@@ -60,6 +66,21 @@ export interface ClientTransportHooks {
      * transport can set this; served pages never carry the global at all.
      */
     ownsHost?: boolean;
+    /** HTTP origin of a shell-owned Host when its WebSocket uses a different page origin. */
+    streamBaseUrl?: string;
+}
+/** Browser location fields used to classify loopback authority. */
+export interface ConnectionLocation {
+    readonly hostname: string;
+}
+/** Instance-local inputs for installing a Connection service. */
+export interface ConnectionInstallOptions {
+    /** Explicit physical carrier; omit for the browser HTTP + WebSocket carrier. */
+    readonly transport?: ClientTransportHooks;
+    /** Reconnect timing overrides; omitted fields use controller defaults. */
+    readonly recovery?: ConnectionRecoveryConfig;
+    /** Page location; omit for a non-browser composition. */
+    readonly location?: ConnectionLocation;
 }
 /**
  * The ctx.connection service API. API Gateway supplies generation readiness
@@ -102,8 +123,14 @@ export interface ConnectionLoop {
     stop(): void;
 }
 /**
- * Client plugin body: pick physical carriers by page mode and provide ctx.connection.
- * @param ctx - client cordis context.
+ * Install one Context-owned Connection service from explicit composition inputs.
+ * @param ctx - client Cordis context.
+ * @param options - physical carrier, reconnect timing, and page location.
+ */
+export declare function installConnection(ctx: Context, options?: ConnectionInstallOptions): void;
+/**
+ * Client plugin body: read the page composition and install its Connection service.
+ * @param ctx - client Cordis context.
  */
 export declare function apply(ctx: Context): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts

@@ -1,5 +1,6 @@
 /** Host HTTP bridge for browser-client RPC. */
 import type { Context } from '@deepseek-ai/cordis';
+import type { IncomingMessage, ServerResponse } from 'node:http';
 import z from '@deepseek-ai/schemastery';
 import { type ConnectionRecoveryConfig } from './recovery-config.ts';
 export type { ConnectionFetchMethod, ConnectionFetchHandler, ConnectionFetchRoute, ConnectionIndexRequest, ConnectionIndexResponse, ConnectionRpcEndpointMatcher, ConnectionRpcFailure, ConnectionRpcHandler, ConnectionRequestRejection, ConnectionRpcResult, ConnectionRequestBodyMode, ConnectionTrustRequest, ClientRequest, HostConnectionHandle, HostConnectionFetch, HostConnectionRpc, RpcMessage, ServerResponse, } from './rpc.ts';
@@ -9,6 +10,19 @@ export { HostConnectionService } from './rpc-host.ts';
 export { API_PATH } from './api-path.ts';
 /** Stable Cordis plugin name. */
 export declare const name = "client-connection";
+declare module '@deepseek-ai/cordis' {
+    interface Events {
+        /**
+         * Admit or wrap an authenticated shared API request, including body transfer.
+         * Existing requests continue when a listener refuses subsequent requests.
+         * @param request - Authenticated incoming HTTP request.
+         * @param response - Response owned until the delegated bridge settles.
+         * @param next - Delegate to the next listener or the shared API bridge.
+         * @mode waterfall
+         */
+        'connection/request'(request: IncomingMessage, response: ServerResponse, next: () => Promise<void>): Promise<void>;
+    }
+}
 /** Services required before providing Connection. */
 export declare const inject: string[];
 /** Browser authentication, request limits, and connection recovery configuration. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-connection",
-  "description": "Authenticated RPC transport, generation lifecycle, and browser fixture",
-  "version": "0.1.5-rc.2",
+  "description": "Authenticated RPC transport and generation lifecycle",
+  "version": "0.1.6-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -35,8 +35,8 @@
   "license": "MIT",
   "dependencies": {
     "zod": "^4.4.3",
-    "@deepseek-ai/schemastery": "^3.18.2",
-    "@deepseek-ai/dsh-credentials": "^0.1.5-rc.2"
+    "@deepseek-ai/dsh-credentials": "^0.1.6-alpha.2",
+    "@deepseek-ai/schemastery": "^3.18.2"
   },
   "files": [
     "lib/index.js",
@@ -47,17 +47,11 @@
     "@deepseek-ai/cordis": "^4.0.2"
   },
   "devDependencies": {
+    "@deepseek-ai/dsh-attachment": "^0.1.6-alpha.2",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-attachment": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-brand": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-commands": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-host-directory-picker": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-tool-todo": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-util-values": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2"
+    "@deepseek-ai/dsh-brand": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.6-alpha.2"
   }
 }

package/lib/types/client/fixture.d.ts

@@ -1,64 +0,0 @@
-import { LlmAttemptId } from '@deepseek-ai/dsh-llm/brand';
-import type { SessionSeqCursor } from '@deepseek-ai/dsh-session/types';
-import type { JsonValue } from '@deepseek-ai/dsh-util-values';
-import type { ClientConnectionRpc } from '../rpc.ts';
-/** Assistant frame emitted by the standalone fixture; tests pin it to the controller wire type. */
-export type FixtureAssistantStreamFrame = {
-    readonly type: 'start';
-    readonly attemptId: ReturnType<typeof LlmAttemptId>;
-    readonly revision: number;
-    readonly startedAfterSeq: SessionSeqCursor;
-    readonly turn: number;
-    readonly step: number;
-} | {
-    readonly type: 'chunk';
-    readonly attemptId: ReturnType<typeof LlmAttemptId>;
-    readonly revision: number;
-    readonly index: number;
-    readonly time: number;
-    readonly chunk: JsonValue;
-} | {
-    readonly type: 'end';
-    readonly attemptId: ReturnType<typeof LlmAttemptId>;
-    readonly revision: number;
-    readonly index: number;
-    readonly outcome: {
-        readonly kind: 'committed';
-        readonly eventType: 'assistant/message' | 'assistant/attempt';
-        readonly seq: number;
-    } | {
-        readonly kind: 'abandoned';
-    };
-};
-/** Deterministic fixture branches used by keyless Web assembly tests. */
-export interface FixtureOptions {
-    /** Start with no real Workspace or Session. */
-    empty?: boolean;
-    /** Reject every prompt before appending its user event. */
-    rejectPrompt?: boolean;
-    /** Publish the Session but fail its Workspace account write. */
-    failWorkspaceAttach?: boolean;
-    /** Publish and frame the Session, then throw instead of returning create. */
-    dropSessionCreateResponse?: boolean;
-    /** Order of the two successful create frames. */
-    createFrameOrder?: 'session-first' | 'workspace-first';
-    /** Announce one Agent write to `notes/demo.txt` shortly after a `workspaceFiles/changes` stream opens. */
-    fileChanges?: boolean;
-}
-/** Fixture RPC face over one in-memory state graph. */
-export interface FixtureWorld {
-    /** Generic Remote caller for the endpoints business services own. */
-    readonly rpc: ClientConnectionRpc;
-}
-/**
- * Build the fixture RPC face over one in-memory state graph.
- * @param options - fixture branches for empty state and failure timing.
- * @returns the Remote RPC face.
- */
-export declare function createFixtureFaces(options?: FixtureOptions): FixtureWorld;
-/**
- * Build the browser fixture transport from the current page's query switches.
- * @returns an in-memory Connection RPC transport.
- */
-export declare function createFixtureConnectionRpc(): ClientConnectionRpc;
-//# sourceMappingURL=fixture.d.ts.map