@forgeax/engine-intelligence-dsh 0.0.0-dev.8d955ade1c79

package/dist/index.mjs

@@ -0,0 +1,143 @@
+import { DeepSeekHarness } from '@deepseek-ai/dsh-sdk-client';
+import { IntelligenceError } from '@forgeax/engine-intelligence';
+import { err, ok } from '@forgeax/engine-types';
+
+// src/index.ts
+function closeActivity(activity) {
+  if (activity.closeTask !== void 0) return activity.closeTask;
+  activity.closeTask = (async () => {
+    try {
+      await activity.harness.close();
+    } catch {
+      try {
+        await activity.harness.close();
+      } catch {
+        return;
+      }
+    }
+  })();
+  return activity.closeTask;
+}
+function textDelta(notification) {
+  if (notification.method !== "session.event") return void 0;
+  const event = notification.params.event;
+  if (typeof event !== "object" || event === null || Array.isArray(event)) return void 0;
+  if (Reflect.get(event, "type") !== "assistant/chunk") return void 0;
+  const data = Reflect.get(event, "data");
+  if (typeof data !== "object" || data === null || Array.isArray(data)) return void 0;
+  const chunk = Reflect.get(data, "chunk");
+  if (typeof chunk !== "object" || chunk === null || Array.isArray(chunk)) return void 0;
+  if (Reflect.get(chunk, "type") !== "text-delta") return void 0;
+  const text = Reflect.get(chunk, "text");
+  return typeof text === "string" ? text : void 0;
+}
+function defaultHarness(options) {
+  const launch = {
+    command: options.launch.command,
+    ...options.launch.args === void 0 ? {} : { args: [...options.launch.args] },
+    ...options.launch.env === void 0 ? {} : { env: { ...options.launch.env } },
+    ...options.launch.cwd === void 0 ? {} : { cwd: options.launch.cwd },
+    ...options.launch.requestTimeoutMs === void 0 ? {} : { requestTimeoutMs: options.launch.requestTimeoutMs },
+    ...options.launch.shutdownTimeoutMs === void 0 ? {} : { shutdownTimeoutMs: options.launch.shutdownTimeoutMs },
+    ...options.launch.disposeEofGraceMs === void 0 ? {} : { disposeEofGraceMs: options.launch.disposeEofGraceMs },
+    ...options.launch.disposeGraceMs === void 0 ? {} : { disposeGraceMs: options.launch.disposeGraceMs }
+  };
+  return new DeepSeekHarness({
+    launch,
+    ...options.cwd === void 0 ? {} : { cwd: options.cwd },
+    ...options.provider === void 0 ? {} : { provider: options.provider },
+    ...options.model === void 0 ? {} : { model: options.model },
+    ...options.maxTokens === void 0 ? {} : { maxTokens: options.maxTokens }
+  });
+}
+function createDshIntelligenceProvider(options) {
+  const activities = /* @__PURE__ */ new Map();
+  const createHarness = options.createHarness ?? defaultHarness;
+  let closed = false;
+  const provider = {
+    id: "deepseek-harness",
+    start(submission, sink) {
+      if (closed) {
+        return err(new IntelligenceError({ code: "intelligence-closed", detail: {} }));
+      }
+      let harness;
+      try {
+        harness = createHarness({
+          launch: options.launch,
+          ...options.cwd === void 0 ? {} : { cwd: options.cwd },
+          ...options.provider === void 0 ? {} : { provider: options.provider },
+          ...options.model === void 0 ? {} : { model: options.model },
+          ...options.maxTokens === void 0 ? {} : { maxTokens: options.maxTokens }
+        });
+      } catch (cause) {
+        return err(
+          new IntelligenceError({
+            code: "intelligence-provider-failed",
+            detail: { providerId: provider.id, cause }
+          })
+        );
+      }
+      const activity = {
+        harness,
+        sink,
+        task: Promise.resolve(),
+        cancelRequested: false
+      };
+      activities.set(submission.id, activity);
+      activity.task = runActivity(submission, activity);
+      return ok(void 0);
+    },
+    cancel(id) {
+      const activity = activities.get(id);
+      if (activity === void 0) {
+        return err(
+          new IntelligenceError({
+            code: "intelligence-activity-not-found",
+            detail: { activityId: id }
+          })
+        );
+      }
+      activity.cancelRequested = true;
+      void closeActivity(activity);
+      return ok(void 0);
+    },
+    async close() {
+      if (closed) return;
+      closed = true;
+      const current = [...activities.values()];
+      for (const activity of current) {
+        activity.cancelRequested = true;
+      }
+      const closeTasks = current.map(closeActivity);
+      await Promise.allSettled(current.map((activity) => activity.task));
+      await Promise.allSettled(closeTasks);
+      activities.clear();
+    }
+  };
+  async function runActivity(submission, activity) {
+    try {
+      const result = await activity.harness.run(submission.input, {
+        sessionId: submission.session.id,
+        onNotification(notification) {
+          if (activity.cancelRequested) return;
+          const delta = textDelta(notification);
+          if (delta !== void 0) activity.sink.text(delta);
+        }
+      });
+      await closeActivity(activity);
+      if (activity.cancelRequested) activity.sink.cancelled();
+      else activity.sink.complete(result.finalResponse);
+    } catch (cause) {
+      await closeActivity(activity);
+      if (activity.cancelRequested) activity.sink.cancelled();
+      else activity.sink.fail(cause);
+    } finally {
+      activities.delete(submission.id);
+    }
+  }
+  return provider;
+}
+
+export { createDshIntelligenceProvider, textDelta as extractDshTextDelta };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["IntelligenceErrorValue"],"mappings":"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","file":"index.mjs","sourcesContent":["import {\n  DeepSeekHarness,\n  type HarnessClientOptions,\n  type HarnessNotification,\n} from '@deepseek-ai/dsh-sdk-client';\nimport type {\n  ActivityId,\n  ActivitySink,\n  ActivitySubmission,\n  IntelligenceError,\n  IntelligenceProvider,\n} from '@forgeax/engine-intelligence';\nimport { IntelligenceError as IntelligenceErrorValue } from '@forgeax/engine-intelligence';\nimport { err, ok, type Result } from '@forgeax/engine-types';\n\nexport interface DshLaunchOptions {\n  readonly command: string;\n  readonly args?: readonly string[];\n  readonly cwd?: string;\n  readonly env?: Readonly<Record<string, string | undefined>>;\n  readonly requestTimeoutMs?: number;\n  readonly shutdownTimeoutMs?: number;\n  readonly disposeEofGraceMs?: number;\n  readonly disposeGraceMs?: number;\n}\n\nexport interface DshIntelligenceProviderOptions {\n  readonly launch: DshLaunchOptions;\n  readonly cwd?: string;\n  readonly provider?: string;\n  readonly model?: string;\n  readonly maxTokens?: number;\n  /** Test/integration seam; production uses the pinned SDK client. */\n  readonly createHarness?: (options: DshHarnessOptions) => DshHarness;\n}\n\nexport interface DshHarnessOptions {\n  readonly launch: DshLaunchOptions;\n  readonly cwd?: string;\n  readonly provider?: string;\n  readonly model?: string;\n  readonly maxTokens?: number;\n}\n\nexport interface DshRunResult {\n  readonly finalResponse: string;\n}\n\nexport interface DshHarness {\n  run(\n    input: string,\n    options: {\n      readonly sessionId: string;\n      readonly onNotification: (notification: DshNotification) => void;\n    },\n  ): Promise<DshRunResult>;\n  close(): Promise<void>;\n}\n\nexport interface DshNotification {\n  readonly method: string;\n  readonly params: Record<string, unknown>;\n}\n\ninterface DshActivity {\n  readonly harness: DshHarness;\n  readonly sink: ActivitySink;\n  task: Promise<void>;\n  cancelRequested: boolean;\n  closeTask?: Promise<void>;\n}\n\nfunction closeActivity(activity: DshActivity): Promise<void> {\n  if (activity.closeTask !== undefined) return activity.closeTask;\n  activity.closeTask = (async () => {\n    try {\n      await activity.harness.close();\n    } catch {\n      try {\n        await activity.harness.close();\n      } catch {\n        return;\n      }\n    }\n  })();\n  return activity.closeTask;\n}\n\nfunction textDelta(notification: DshNotification): string | undefined {\n  if (notification.method !== 'session.event') return undefined;\n  const event = notification.params.event;\n  if (typeof event !== 'object' || event === null || Array.isArray(event)) return undefined;\n  if (Reflect.get(event, 'type') !== 'assistant/chunk') return undefined;\n  const data = Reflect.get(event, 'data');\n  if (typeof data !== 'object' || data === null || Array.isArray(data)) return undefined;\n  const chunk = Reflect.get(data, 'chunk');\n  if (typeof chunk !== 'object' || chunk === null || Array.isArray(chunk)) return undefined;\n  if (Reflect.get(chunk, 'type') !== 'text-delta') return undefined;\n  const text = Reflect.get(chunk, 'text');\n  return typeof text === 'string' ? text : undefined;\n}\n\nfunction defaultHarness(options: DshHarnessOptions): DshHarness {\n  const launch = {\n    command: options.launch.command,\n    ...(options.launch.args === undefined ? {} : { args: [...options.launch.args] }),\n    ...(options.launch.env === undefined ? {} : { env: { ...options.launch.env } }),\n    ...(options.launch.cwd === undefined ? {} : { cwd: options.launch.cwd }),\n    ...(options.launch.requestTimeoutMs === undefined\n      ? {}\n      : { requestTimeoutMs: options.launch.requestTimeoutMs }),\n    ...(options.launch.shutdownTimeoutMs === undefined\n      ? {}\n      : { shutdownTimeoutMs: options.launch.shutdownTimeoutMs }),\n    ...(options.launch.disposeEofGraceMs === undefined\n      ? {}\n      : { disposeEofGraceMs: options.launch.disposeEofGraceMs }),\n    ...(options.launch.disposeGraceMs === undefined\n      ? {}\n      : { disposeGraceMs: options.launch.disposeGraceMs }),\n  } satisfies HarnessClientOptions;\n  return new DeepSeekHarness({\n    launch,\n    ...(options.cwd === undefined ? {} : { cwd: options.cwd }),\n    ...(options.provider === undefined ? {} : { provider: options.provider }),\n    ...(options.model === undefined ? {} : { model: options.model }),\n    ...(options.maxTokens === undefined ? {} : { maxTokens: options.maxTokens }),\n  });\n}\n\n/**\n * Create a Host-only DSH provider. Each Activity owns one runtime process.\n * DSH 0.1 has process close but no wire-level turn cancel; process-per-Activity\n * preserves honest cancellation without terminating unrelated work.\n */\nexport function createDshIntelligenceProvider(\n  options: DshIntelligenceProviderOptions,\n): IntelligenceProvider {\n  const activities = new Map<ActivityId, DshActivity>();\n  const createHarness = options.createHarness ?? defaultHarness;\n  let closed = false;\n\n  const provider: IntelligenceProvider = {\n    id: 'deepseek-harness',\n    start(submission, sink): Result<void, IntelligenceError> {\n      if (closed) {\n        return err(new IntelligenceErrorValue({ code: 'intelligence-closed', detail: {} }));\n      }\n      let harness: DshHarness;\n      try {\n        harness = createHarness({\n          launch: options.launch,\n          ...(options.cwd === undefined ? {} : { cwd: options.cwd }),\n          ...(options.provider === undefined ? {} : { provider: options.provider }),\n          ...(options.model === undefined ? {} : { model: options.model }),\n          ...(options.maxTokens === undefined ? {} : { maxTokens: options.maxTokens }),\n        });\n      } catch (cause) {\n        return err(\n          new IntelligenceErrorValue({\n            code: 'intelligence-provider-failed',\n            detail: { providerId: provider.id, cause },\n          }),\n        );\n      }\n      const activity: DshActivity = {\n        harness,\n        sink,\n        task: Promise.resolve(),\n        cancelRequested: false,\n      };\n      activities.set(submission.id, activity);\n      activity.task = runActivity(submission, activity);\n      return ok(undefined);\n    },\n    cancel(id): Result<void, IntelligenceError> {\n      const activity = activities.get(id);\n      if (activity === undefined) {\n        return err(\n          new IntelligenceErrorValue({\n            code: 'intelligence-activity-not-found',\n            detail: { activityId: id },\n          }),\n        );\n      }\n      activity.cancelRequested = true;\n      void closeActivity(activity);\n      return ok(undefined);\n    },\n    async close(): Promise<void> {\n      if (closed) return;\n      closed = true;\n      const current = [...activities.values()];\n      for (const activity of current) {\n        activity.cancelRequested = true;\n      }\n      const closeTasks = current.map(closeActivity);\n      await Promise.allSettled(current.map((activity) => activity.task));\n      await Promise.allSettled(closeTasks);\n      activities.clear();\n    },\n  };\n\n  async function runActivity(submission: ActivitySubmission, activity: DshActivity): Promise<void> {\n    try {\n      const result = await activity.harness.run(submission.input, {\n        sessionId: submission.session.id,\n        onNotification(notification: HarnessNotification) {\n          if (activity.cancelRequested) return;\n          const delta = textDelta(notification);\n          if (delta !== undefined) activity.sink.text(delta);\n        },\n      });\n      await closeActivity(activity);\n      if (activity.cancelRequested) activity.sink.cancelled();\n      else activity.sink.complete(result.finalResponse);\n    } catch (cause) {\n      await closeActivity(activity);\n      if (activity.cancelRequested) activity.sink.cancelled();\n      else activity.sink.fail(cause);\n    } finally {\n      activities.delete(submission.id);\n    }\n  }\n\n  return provider;\n}\n\nexport { textDelta as extractDshTextDelta };\n"]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@forgeax/engine-intelligence-dsh",
+  "version": "0.0.0-dev.8d955ade1c79",
+  "private": false,
+  "type": "module",
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "description": "Host-side DeepSeek Harness provider for ForgeaX intelligence Activities.",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "dependencies": {
+    "@deepseek-ai/dsh-sdk-client": "0.1.0-rc.6",
+    "@forgeax/engine-intelligence": "0.0.0-dev.8d955ade1c79",
+    "@forgeax/engine-types": "0.0.0-dev.8d955ade1c79"
+  },
+  "devDependencies": {
+    "@forgeax/engine-intelligence-fake": "0.0.0-dev.8d955ade1c79",
+    "@types/node": "^20.14.0"
+  },
+  "forgeax": {
+    "metrics": {
+      "bundle-size": {
+        "enabled": true,
+        "path": "dist/index.mjs",
+        "compression": "gzip"
+      },
+      "fps": {
+        "enabled": false,
+        "reason": "Host-side subprocess adapter never runs in the frame loop"
+      },
+      "bench": {
+        "enabled": false,
+        "reason": "provider latency is external and frame polling remains in engine-intelligence"
+      },
+      "gate": {
+        "enabled": false,
+        "reason": "adapter lifecycle is gated by package integration tests"
+      },
+      "spike-report": {
+        "enabled": false,
+        "reason": "not a spike package"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run"
+  }
+}

package/src/__tests__/dsh-provider.test.ts

@@ -0,0 +1,314 @@
+import { mkdtemp, readFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import {
+  type ActivityEvent,
+  createIntelligenceRuntime,
+  type IntelligenceService,
+  type SessionRef,
+} from '@forgeax/engine-intelligence';
+import { createFakeIntelligenceProvider } from '@forgeax/engine-intelligence-fake';
+import { describe, expect, it } from 'vitest';
+import { createDshIntelligenceProvider, type DshHarness, extractDshTextDelta } from '../index';
+
+const fixture = join(dirname(fileURLToPath(import.meta.url)), 'fixtures/fake-dsh-runtime.mjs');
+
+function turn(): Promise<void> {
+  return new Promise((resolve) => setImmediate(resolve));
+}
+
+interface DialogueView {
+  text: string;
+  terminal: boolean;
+  session?: SessionRef;
+}
+
+function updateDialogue(service: IntelligenceService, view: DialogueView): void {
+  for (const event of service.poll()) {
+    if (event.type === 'text-delta') view.text += event.text;
+    else if (event.type === 'completed') {
+      view.terminal = true;
+      view.session = event.session;
+    } else if (event.type === 'failed' || event.type === 'cancelled') {
+      view.terminal = true;
+    }
+  }
+}
+
+async function waitForTerminal(service: IntelligenceService, view: DialogueView): Promise<void> {
+  for (let attempt = 0; attempt < 200 && !view.terminal; attempt += 1) {
+    updateDialogue(service, view);
+    await new Promise((resolve) => setTimeout(resolve, 10));
+  }
+  expect(view.terminal).toBe(true);
+}
+
+describe('DeepSeek Harness intelligence provider', () => {
+  it('projects only text deltas from DSH notifications', () => {
+    expect(
+      extractDshTextDelta({
+        method: 'session.event',
+        params: {
+          event: {
+            type: 'assistant/chunk',
+            data: { chunk: { type: 'text-delta', text: 'token' } },
+          },
+        },
+      }),
+    ).toBe('token');
+    expect(extractDshTextDelta({ method: 'session.status', params: {} })).toBeUndefined();
+  });
+
+  it('lets one dialogue consumer swap fake and DSH providers', async () => {
+    const fake = createFakeIntelligenceProvider({
+      script: () => ({ deltas: ['same'], output: 'same' }),
+    });
+    const fakeService = createIntelligenceRuntime(fake);
+    const fakeView: DialogueView = { text: '', terminal: false };
+    fakeService.submit({ input: 'prompt' });
+    fake.advance();
+    fake.advance();
+    updateDialogue(fakeService, fakeView);
+
+    let closeCount = 0;
+    const harness: DshHarness = {
+      async run(_input, options) {
+        options.onNotification({
+          method: 'session.event',
+          params: {
+            event: {
+              type: 'assistant/chunk',
+              data: { chunk: { type: 'text-delta', text: 'same' } },
+            },
+          },
+        });
+        return { finalResponse: 'same' };
+      },
+      async close() {
+        closeCount += 1;
+      },
+    };
+    const dshService = createIntelligenceRuntime(
+      createDshIntelligenceProvider({
+        launch: { command: 'unused' },
+        createHarness: () => harness,
+      }),
+    );
+    const dshView: DialogueView = { text: '', terminal: false };
+    dshService.submit({ input: 'prompt' });
+    await turn();
+    updateDialogue(dshService, dshView);
+
+    expect(fakeView.text).toBe('same');
+    expect(dshView.text).toBe('same');
+    expect(fakeView.terminal).toBe(true);
+    expect(dshView.terminal).toBe(true);
+    expect(closeCount).toBeGreaterThan(0);
+  });
+
+  it('streams through the real SDK transport and reaps the runtime on completion', async () => {
+    const root = await mkdtemp(join(tmpdir(), 'forgeax-intelligence-dsh-'));
+    const lifecycle = join(root, 'lifecycle.log');
+    const provider = createDshIntelligenceProvider({
+      launch: {
+        command: process.execPath,
+        args: [fixture],
+        env: { DSH_FAKE_LIFECYCLE: lifecycle },
+        requestTimeoutMs: 2_000,
+        shutdownTimeoutMs: 500,
+        disposeEofGraceMs: 500,
+        disposeGraceMs: 500,
+      },
+    });
+    const service = createIntelligenceRuntime(provider);
+    const view: DialogueView = { text: '', terminal: false };
+    const started = service.submit({ input: 'complete' });
+    if (!started.ok) throw started.error;
+    await waitForTerminal(service, view);
+    await service.close();
+
+    expect(view.text).toBe('hello');
+    expect(view.session).toEqual(started.value.session);
+    const lines = (await readFile(lifecycle, 'utf8')).trim().split('\n');
+    expect(lines).toHaveLength(2);
+    expect(lines[0]?.replace('started:', '')).toBe(lines[1]?.replace('closed:', ''));
+  }, 10_000);
+
+  it('cancels one Activity by closing only its owned DSH runtime', async () => {
+    const root = await mkdtemp(join(tmpdir(), 'forgeax-intelligence-dsh-cancel-'));
+    const lifecycle = join(root, 'lifecycle.log');
+    const service = createIntelligenceRuntime(
+      createDshIntelligenceProvider({
+        launch: {
+          command: process.execPath,
+          args: [fixture],
+          env: { DSH_FAKE_LIFECYCLE: lifecycle },
+          requestTimeoutMs: 2_000,
+          shutdownTimeoutMs: 500,
+          disposeEofGraceMs: 500,
+          disposeGraceMs: 500,
+        },
+      }),
+    );
+    const started = service.submit({ input: 'hang' });
+    if (!started.ok) throw started.error;
+    await new Promise((resolve) => setTimeout(resolve, 100));
+    expect(service.cancel(started.value.id).ok).toBe(true);
+    const view: DialogueView = { text: '', terminal: false };
+    await waitForTerminal(service, view);
+    await service.close();
+
+    const lines = (await readFile(lifecycle, 'utf8')).trim().split('\n');
+    expect(lines).toHaveLength(2);
+    expect(lines[0]?.replace('started:', '')).toBe(lines[1]?.replace('closed:', ''));
+  }, 10_000);
+
+  it('contains a refused cancellation close without affecting a sibling', async () => {
+    const harnesses: Array<{
+      active: boolean;
+      closeCalls: number;
+      closed: boolean;
+      input?: string;
+      rejectRun?: (cause: Error) => void;
+      resolveClose?: () => void;
+      resolveRun?: () => void;
+    }> = [];
+    const provider = createDshIntelligenceProvider({
+      launch: {
+        command: process.execPath,
+        args: [],
+      },
+      createHarness: () => {
+        const state: (typeof harnesses)[number] = {
+          active: false,
+          closeCalls: 0,
+          closed: false,
+        };
+        harnesses.push(state);
+        return {
+          run: (input: string) => {
+            state.input = input;
+            state.active = true;
+            if (input === 'activity-a') {
+              return new Promise<never>((_resolve, reject) => {
+                state.rejectRun = reject;
+              });
+            }
+            return new Promise((resolve) => {
+              state.resolveRun = () => resolve({ finalResponse: 'activity-b-complete' });
+            });
+          },
+          close: async () => {
+            state.closeCalls += 1;
+            if (state.input === 'activity-a' && state.closeCalls === 1) {
+              state.active = false;
+              state.rejectRun?.(new Error('activity A close refused'));
+              throw new Error('activity A close refused');
+            }
+            if (state.input === 'activity-a' && state.closeCalls === 2) {
+              await new Promise<void>((resolve) => {
+                state.resolveClose = () => {
+                  state.closed = true;
+                  resolve();
+                };
+              });
+              state.active = false;
+              return;
+            }
+            state.active = false;
+            state.closed = true;
+          },
+        } satisfies DshHarness;
+      },
+    });
+    const service = createIntelligenceRuntime(provider);
+    const events: ActivityEvent[] = [];
+    const unhandledRejections: unknown[] = [];
+    const onUnhandledRejection = (reason: unknown) => {
+      unhandledRejections.push(reason);
+    };
+
+    const activityA = service.submit({ input: 'activity-a' });
+    const activityB = service.submit({ input: 'activity-b' });
+    expect(activityA.ok).toBe(true);
+    expect(activityB.ok).toBe(true);
+    if (!activityA.ok || !activityB.ok) {
+      throw new Error('expected both activities to be accepted');
+    }
+
+    await turn();
+    expect(harnesses).toHaveLength(2);
+    expect(harnesses[0]).toMatchObject({ active: true, closeCalls: 0 });
+    expect(harnesses[1]).toMatchObject({ active: true, closeCalls: 0 });
+
+    process.on('unhandledRejection', onUnhandledRejection);
+    try {
+      const cancelled = service.cancel(activityA.value.id);
+      expect(cancelled.ok).toBe(true);
+
+      expect(harnesses[1]).toMatchObject({ active: true, closeCalls: 0 });
+      harnesses[1]?.resolveRun?.();
+      for (let attempt = 0; attempt < 10; attempt += 1) {
+        events.push(...service.poll());
+        if (
+          events.some(
+            (event) => event.activityId === activityB.value.id && event.type === 'completed',
+          )
+        ) {
+          break;
+        }
+        await turn();
+      }
+
+      let providerClosed = false;
+      const providerCloseTask = provider.close().then(() => {
+        providerClosed = true;
+      });
+      await turn();
+      expect(providerClosed).toBe(false);
+      harnesses[0]?.resolveClose?.();
+      await providerCloseTask;
+      events.push(...service.poll());
+      await provider.close();
+      await service.close();
+      await service.close();
+      await turn();
+    } finally {
+      process.off('unhandledRejection', onUnhandledRejection);
+    }
+
+    const activityATerminals = events.filter(
+      (event) =>
+        event.activityId === activityA.value.id &&
+        (event.type === 'cancelled' || event.type === 'completed' || event.type === 'failed'),
+    );
+    const activityBTerminals = events.filter(
+      (event) =>
+        event.activityId === activityB.value.id &&
+        (event.type === 'cancelled' || event.type === 'completed' || event.type === 'failed'),
+    );
+
+    expect(activityATerminals).toHaveLength(1);
+    expect(activityATerminals[0]?.type).toBe('cancelled');
+    expect(activityBTerminals).toEqual([
+      expect.objectContaining({
+        activityId: activityB.value.id,
+        type: 'completed',
+        output: 'activity-b-complete',
+      }),
+    ]);
+    expect(unhandledRejections).toEqual([]);
+    expect(harnesses).toHaveLength(2);
+    expect(harnesses[0]).toMatchObject({
+      closeCalls: 2,
+      closed: true,
+      active: false,
+    });
+    expect(harnesses[1]).toMatchObject({
+      closeCalls: 1,
+      closed: true,
+      active: false,
+    });
+  });
+});

package/src/__tests__/fixtures/fake-dsh-runtime.mjs

@@ -0,0 +1,77 @@
+import { appendFileSync } from 'node:fs';
+
+const lifecyclePath = process.env.DSH_FAKE_LIFECYCLE;
+if (lifecyclePath) appendFileSync(lifecyclePath, `started:${process.pid}\n`);
+process.on('exit', () => {
+  if (lifecyclePath) appendFileSync(lifecyclePath, `closed:${process.pid}\n`);
+});
+
+process.stdin.setEncoding('utf8');
+let buffered = '';
+
+function write(message) {
+  process.stdout.write(`${JSON.stringify(message)}\n`);
+}
+
+function notify(method, params) {
+  write({ jsonrpc: '2.0', method, params });
+}
+
+function handle(request) {
+  if (request.method === 'initialize') {
+    write({
+      jsonrpc: '2.0',
+      id: request.id,
+      result: { serverInfo: { name: 'forgeax-fake-dsh-runtime', version: '0.1.0' } },
+    });
+    return;
+  }
+  if (request.method === 'session/prompt') {
+    const sessionId = request.params.sessionId;
+    const messageId = `message-${request.id}`;
+    write({ jsonrpc: '2.0', id: request.id, result: { messageId } });
+    queueMicrotask(() => {
+      notify('session.event', {
+        sessionId,
+        event: { type: 'agent/inbox/spliced', data: { inserted: [{ id: messageId }] } },
+      });
+      notify('session.event', {
+        sessionId,
+        event: {
+          type: 'assistant/chunk',
+          data: { turn: 1, step: 1, chunk: { type: 'text-delta', index: 0, text: 'hello' } },
+        },
+      });
+      const text = request.params.contentBlocks?.[0]?.text;
+      if (text === 'hang') return;
+      notify('session.event', {
+        sessionId,
+        event: {
+          type: 'assistant/message',
+          data: {
+            turn: 1,
+            step: 1,
+            message: { role: 'assistant', content: [{ type: 'text', text: 'hello' }] },
+          },
+        },
+      });
+      notify('session.status', { sessionId, status: 'idle' });
+    });
+    return;
+  }
+  if (request.method === 'shutdown') {
+    write({ jsonrpc: '2.0', id: request.id, result: {} });
+    setImmediate(() => process.exit(0));
+  }
+}
+
+process.stdin.on('data', (chunk) => {
+  buffered += chunk;
+  while (true) {
+    const newline = buffered.indexOf('\n');
+    if (newline < 0) break;
+    const line = buffered.slice(0, newline);
+    buffered = buffered.slice(newline + 1);
+    if (line.trim()) handle(JSON.parse(line));
+  }
+});