@stackstackstack/dsh-llm-pi-ai 0.1.5

package/lib/types/replay.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Durable pi-ai replay metadata and assistant-history reconstruction.
+ *
+ * Harness content remains the durable source for text and tool calls. This
+ * module stores only the provider-native metadata needed to reconstruct a
+ * pi-ai assistant message on a later request.
+ *
+ * @module dsh-llm-pi-ai/replay
+ */
+import type { Message } from '@stackstackstack/dsh-llm';
+import type { Api, AssistantMessage } from '@earendil-works/pi-ai';
+type PiAiReplayBlock = {
+    type: 'text';
+    textSignature?: string;
+} | {
+    type: 'reasoning';
+    thinkingSignature?: string;
+    redacted?: boolean;
+} | {
+    type: 'tool-call';
+    thoughtSignature?: string;
+};
+/** Versioned adapter-private projection required to replay a pi-ai response. */
+export interface PiAiReplayState {
+    kind: 'pi-ai';
+    version: 1;
+    api: Api;
+    provider: string;
+    model: string;
+    responseModel?: string;
+    responseId?: string;
+    stopReason: AssistantMessage['stopReason'];
+    blocks: PiAiReplayBlock[];
+}
+/**
+ * Project a successful pi-ai response into the minimal durable replay state.
+ * @param message - completed native pi-ai assistant response.
+ * @returns the versioned lossless-JSON replay projection.
+ */
+export declare function toPiReplayState(message: AssistantMessage): PiAiReplayState;
+/**
+ * Convert one durable Harness assistant message into pi-ai history.
+ * @param message - assistant content with required source and optional adapter-owned replay metadata.
+ * @returns a native pi-ai assistant message reconstructed from durable content.
+ */
+export declare function toPiAssistant(message: Message): AssistantMessage;
+export {};
+//# sourceMappingURL=replay.d.ts.map

package/lib/types/stream.d.ts

@@ -0,0 +1,38 @@
+/**
+ * pi-ai assistant event translation into the Harness streaming protocol.
+ *
+ * pi-ai tool-call arguments are parsed objects while the Harness keeps their
+ * raw JSON representation. pi-ai also reports failures as terminal stream
+ * events, which this module maps into Harness finish chunks.
+ *
+ * @module dsh-llm-pi-ai/stream
+ */
+import type { FinishReason, StreamChunk, TokenUsage } from '@stackstackstack/dsh-llm';
+import type { AssistantMessage, AssistantMessageEvent, Usage as PiUsage } from '@earendil-works/pi-ai';
+/**
+ * Map pi-ai usage (reasoning folded into output by pi-ai).
+ * @param usage - cumulative usage from the terminal pi-ai event.
+ * @returns harness counts; cache fields appear only when non-zero (pi-ai reports zeros, not absence).
+ */
+export declare function mapUsage(usage: PiUsage): TokenUsage;
+/**
+ * Map a terminal pi-ai event to the harness finish reason.
+ * @param message - the assistant message carried by the `done` or `error` event.
+ * @param contextWindow - resolved catalog capacity for usage-based overflow detection.
+ * @returns the mapped harness reason. Recognized error text, `stop` usage above
+ *   `contextWindow`, and zero-output `length` usage that fills the window map
+ *   to `CONTEXT_WINDOW_EXCEEDED`; a `stop` with no content blocks maps to an
+ *   `EMPTY_RESPONSE` error.
+ */
+export declare function mapStopReason(message: AssistantMessage, contextWindow?: number): FinishReason;
+/**
+ * Translate the pi-ai event stream into StreamChunks. pi-ai never throws
+ * mid-stream — failures arrive as `error` events, which become error/aborted
+ * `finish` chunks (the harness protocol's other error-delivery style).
+ * @param events - one assistant turn's pi-ai event stream.
+ * @param contextWindow - resolved catalog capacity for usage-based overflow detection.
+ * @returns the harness chunks, ending with `usage` then `finish`; throws
+ *   `LlmError` (`STREAM_CLOSED`) if the source ends without a terminal event.
+ */
+export declare function toStreamChunks(events: AsyncIterable<AssistantMessageEvent>, contextWindow?: number): AsyncGenerator<StreamChunk>;
+//# sourceMappingURL=stream.d.ts.map

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@stackstackstack/dsh-llm-pi-ai",
+  "description": "pi-ai-backed DeepSeek adapter for the DeepSeek Harness LLM seam (design-verification twin of dsh-llm-deepseek)",
+  "version": "0.1.5",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/llm/llm-pi-ai"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@stackstackstack/dsh-credentials": "^0.1.5",
+    "@stackstackstack/dsh-attachment": "^0.1.5",
+    "@stackstackstack/dsh-launch-environment": "^0.1.5",
+    "@stackstackstack/dsh-invariants": "^0.1.5",
+    "@stackstackstack/dsh-llm": "^0.1.5",
+    "@stackstackstack/dsh-timeout": "^0.1.5",
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@stackstackstack/dsh-settings": "^0.1.5"
+  },
+  "dependencies": {
+    "@earendil-works/pi-ai": "^0.82.1",
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
+  "devDependencies": {
+    "@stackstackstack/dsh-attachment": "^0.1.5",
+    "@stackstackstack/dsh-launch-environment": "^0.1.5",
+    "@stackstackstack/dsh-invariants": "^0.1.5",
+    "@stackstackstack/dsh-llm": "^0.1.5",
+    "@stackstackstack/dsh-credentials": "^0.1.5",
+    "@stackstackstack/dsh-llm-deepseek": "^0.1.5",
+    "@stackstackstack/dsh-settings": "^0.1.5",
+    "@stackstackstack/dsh-timeout": "^0.1.5",
+    "@deepseek-ai/cordis": "^4.0.1"
+  }
+}