@earendil-works/pi-server 0.84.0

package/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+## [Unreleased]
+
+## [0.84.0] - 2026-08-06
+
+### Breaking Changes
+
+- Changed `toProtocolToolResultMessage()` to require the original `ToolCall` and verify tool result association.
+- Changed `PiServerService.listSessions()` to return durable `SessionMetadata` instead of runtime `SessionSummary` values ([#7708](https://github.com/earendil-works/pi/pull/7708)).
+
+### Fixed
+
+- Hardened protocol adapters against contradictory lifecycle states, invalid identifiers and timestamps, sparse execution arrays, and additive `pi-ai` contract drift.
+- Sanitized service and runtime failures into stable `not_implemented` and `internal_error` responses without exposing private error details ([#7644](https://github.com/earendil-works/pi/pull/7644)).
+
+## [0.83.0] - 2026-07-29
+
+## [0.82.1] - 2026-07-25
+
+## [0.82.0] - 2026-07-24
+
+## [0.81.1] - 2026-07-21
+
+## [0.81.0] - 2026-07-21
+
+### Changed
+
+- Renamed the orchestrator workspace package and internal server references to server ([#6898](https://github.com/earendil-works/pi/pull/6898) by [@cristinaponcela](https://github.com/cristinaponcela)).
+
+## [0.80.10] - 2026-07-16
+
+## [0.80.9] - 2026-07-16
+
+## [0.80.8] - 2026-07-16
+
+## [0.80.7] - 2026-07-14
+
+## [0.80.6] - 2026-07-09
+
+## [0.80.5] - 2026-07-09
+
+## [0.80.4] - 2026-07-09
+
+## [0.80.3] - 2026-06-30

package/README.md

@@ -0,0 +1,50 @@
+# @earendil-works/pi-server
+
+Experimental. This package is under active development and may change or be removed without notice. Its APIs and behavior are not yet stable.
+
+Server package for pi.
+
+## Session server core
+
+The package exports the `PiServer` session server.
+
+```ts
+import type { PiServerService } from "@earendil-works/pi-server";
+import { createUnixServer } from "@earendil-works/pi-server/unix";
+
+const service: PiServerService = {
+  async listSessions() {
+    return storage.listSessions();
+  },
+  async listModels() {
+    return modelRegistry.listModels();
+  },
+  async createSession(options) {
+    return storage.createAndOpen(options);
+  },
+  async openSession(sessionId) {
+    return storage.open(sessionId);
+  },
+};
+
+const server = createUnixServer(service, {
+  path: "/tmp/pi/server.sock",
+});
+await server.start();
+```
+
+`PiServer` composes transport listeners through the `PiServerListener` interface. Each listener must complete any transport-specific authentication and authorization before passing a connection to `PiServer`. For example, a WebSocket listener can validate credentials during the HTTP upgrade, while the Unix listener relies on socket filesystem permissions. The Unix submodule exports the `createUnixListener()` building block and `createUnixServer()` preset, keeping the common case concise without coupling the primary server to Unix sockets. The listener uses length-prefixed CBOR messages from `@earendil-works/pi-protocol`.
+
+This package does not provide a standalone CLI or coding-agent service. Applications supply the `PiServerService` implementation.
+
+`PiServerService.listSessions()` returns protocol `SessionMetadata`, not acquired runtime state. Services should map the durable fields their storage supports and may omit `updatedAt`, `parentSessionId`, `sessionName`, and `cwd`. `PiServer` refreshes available metadata from live snapshots without requiring stored sessions to fabricate phase, model, thinking-level, attachment, or lock values.
+
+## Transport testing
+
+Custom transports can use `@earendil-works/pi-server/testing` for deterministic protocol conformance tests. It exports `createTestServer()`, `TestServerService`, `ProtocolTestClient`, and the transport-neutral `WireChannel` contract. `connectUnixTestClient()` is provided for Unix transport tests.
+
+## `pi-ai` protocol bridge
+
+`@earendil-works/pi-ai` domain objects and `@earendil-works/pi-protocol` wire DTOs remain independent. This package owns their boundary and exports `toProtocolModelMetadata()`, `toProtocolAssistantMessage()`, `toProtocolUserMessage()`, and `toProtocolToolResultMessage()`.
+
+The adapters reject invalid tool inputs, identifiers, timestamps, and mismatched tool results; `toProtocolToolResultMessage()` requires the original `ToolCall` so it can verify the association and convert its arguments itself. Diagnostic details are explicitly sanitized. Closed `pi-ai` unions are mapped exhaustively, and compile-time field manifests enumerate current `pi-ai` properties so additions require an explicit review. The protocol mirrors `pi-ai` vocabulary such as `toolCall` and `toolUse` where the semantics are identical. Protocol schemas enforce consistent lifecycle states, and tests encode adapter output through the runtime schemas so incompatible changes fail in the bridging package.

package/dist/connection.d.ts

@@ -0,0 +1,28 @@
+import type { ClientMessageDecoder } from "@earendil-works/pi-protocol";
+import type { MaybePromise } from "./types.ts";
+/** An established, authorized ordered byte connection. */
+export interface ByteConnection {
+    readonly closed: boolean;
+    send(chunk: Uint8Array): Promise<void>;
+    close(finalChunk?: Uint8Array): MaybePromise<void>;
+}
+export interface ByteConnectionHandler {
+    onData(chunk: Uint8Array): void;
+    onClose(): void;
+    onError(error: Error): void;
+}
+export type ByteConnectionAcceptor = (connection: ByteConnection) => ByteConnectionHandler;
+export type ConnectionStage = "awaitingHello" | "handshaking" | "ready" | "closing" | "closed";
+export interface ConnectionState {
+    id: string;
+    connection: ByteConnection;
+    decoder: ClientMessageDecoder;
+    sessionIds: Set<string>;
+    stage: ConnectionStage;
+    disconnected: boolean;
+    handshakeComplete: boolean;
+    handshake?: Promise<void>;
+    handshakeTimeout: NodeJS.Timeout;
+}
+export declare function isTerminalConnection(state: ConnectionState): boolean;
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,qBAAqB;IACrC,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,OAAO,IAAI,IAAI,CAAC;IAChB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,UAAU,EAAE,cAAc,KAAK,qBAAqB,CAAC;AAE3F,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/F,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,cAAc,CAAC;IAC3B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,KAAK,EAAE,eAAe,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC;CACjC;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAEpE","sourcesContent":["import type { ClientMessageDecoder } from \"@earendil-works/pi-protocol\";\n\nimport type { MaybePromise } from \"./types.ts\";\n\n/** An established, authorized ordered byte connection. */\nexport interface ByteConnection {\n\treadonly closed: boolean;\n\tsend(chunk: Uint8Array): Promise<void>;\n\tclose(finalChunk?: Uint8Array): MaybePromise<void>;\n}\n\nexport interface ByteConnectionHandler {\n\tonData(chunk: Uint8Array): void;\n\tonClose(): void;\n\tonError(error: Error): void;\n}\n\nexport type ByteConnectionAcceptor = (connection: ByteConnection) => ByteConnectionHandler;\n\nexport type ConnectionStage = \"awaitingHello\" | \"handshaking\" | \"ready\" | \"closing\" | \"closed\";\n\nexport interface ConnectionState {\n\tid: string;\n\tconnection: ByteConnection;\n\tdecoder: ClientMessageDecoder;\n\tsessionIds: Set<string>;\n\tstage: ConnectionStage;\n\tdisconnected: boolean;\n\thandshakeComplete: boolean;\n\thandshake?: Promise<void>;\n\thandshakeTimeout: NodeJS.Timeout;\n}\n\nexport function isTerminalConnection(state: ConnectionState): boolean {\n\treturn state.disconnected || state.stage === \"closing\" || state.stage === \"closed\";\n}\n"]}

package/dist/connection.js

@@ -0,0 +1,4 @@
+export function isTerminalConnection(state) {
+    return state.disconnected || state.stage === "closing" || state.stage === "closed";
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAiCA,MAAM,UAAU,oBAAoB,CAAC,KAAsB,EAAW;IACrE,OAAO,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC;AAAA,CACnF","sourcesContent":["import type { ClientMessageDecoder } from \"@earendil-works/pi-protocol\";\n\nimport type { MaybePromise } from \"./types.ts\";\n\n/** An established, authorized ordered byte connection. */\nexport interface ByteConnection {\n\treadonly closed: boolean;\n\tsend(chunk: Uint8Array): Promise<void>;\n\tclose(finalChunk?: Uint8Array): MaybePromise<void>;\n}\n\nexport interface ByteConnectionHandler {\n\tonData(chunk: Uint8Array): void;\n\tonClose(): void;\n\tonError(error: Error): void;\n}\n\nexport type ByteConnectionAcceptor = (connection: ByteConnection) => ByteConnectionHandler;\n\nexport type ConnectionStage = \"awaitingHello\" | \"handshaking\" | \"ready\" | \"closing\" | \"closed\";\n\nexport interface ConnectionState {\n\tid: string;\n\tconnection: ByteConnection;\n\tdecoder: ClientMessageDecoder;\n\tsessionIds: Set<string>;\n\tstage: ConnectionStage;\n\tdisconnected: boolean;\n\thandshakeComplete: boolean;\n\thandshake?: Promise<void>;\n\thandshakeTimeout: NodeJS.Timeout;\n}\n\nexport function isTerminalConnection(state: ConnectionState): boolean {\n\treturn state.disconnected || state.stage === \"closing\" || state.stage === \"closed\";\n}\n"]}

package/dist/errors.d.ts

@@ -0,0 +1,27 @@
+import type { JsonValue, ProtocolErrorCode } from "@earendil-works/pi-protocol";
+export type PiServerOperationErrorCode = Extract<ProtocolErrorCode, "busy" | "session_locked" | "not_found" | "invalid_request" | "not_implemented">;
+export declare const INTERNAL_SERVER_ERROR_MESSAGE = "Internal server error";
+export declare const NOT_IMPLEMENTED_MESSAGE = "Operation is not implemented";
+/** A service/runtime error that can safely cross the protocol boundary. */
+export declare class PiServerError extends Error {
+    readonly code: PiServerOperationErrorCode;
+    readonly details: JsonValue | undefined;
+    constructor(code: PiServerOperationErrorCode, message: string, details?: JsonValue);
+}
+export declare class SessionBusyError extends PiServerError {
+    constructor(message?: string, details?: JsonValue);
+}
+export declare class SessionLockedError extends PiServerError {
+    constructor(message?: string, details?: JsonValue);
+}
+export declare class SessionNotFoundError extends PiServerError {
+    constructor(message?: string, details?: JsonValue);
+}
+export declare class NotImplementedError extends PiServerError {
+    constructor();
+}
+/** An unsafe failure whose cause is retained for reporting but never serialized. */
+export declare class InternalServerError extends Error {
+    constructor(cause: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhF,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAC/C,iBAAiB,EACjB,MAAM,GAAG,gBAAgB,GAAG,WAAW,GAAG,iBAAiB,GAAG,iBAAiB,CAC/E,CAAC;AAEF,eAAO,MAAM,6BAA6B,0BAA0B,CAAC;AACrE,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AAEtE,2EAA2E;AAC3E,qBAAa,aAAc,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAExC,YAAY,IAAI,EAAE,0BAA0B,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAKjF;CACD;AAED,qBAAa,gBAAiB,SAAQ,aAAa;IAClD,YAAY,OAAO,SAAoB,EAAE,OAAO,CAAC,EAAE,SAAS,EAG3D;CACD;AAED,qBAAa,kBAAmB,SAAQ,aAAa;IACpD,YAAY,OAAO,SAAsB,EAAE,OAAO,CAAC,EAAE,SAAS,EAG7D;CACD;AAED,qBAAa,oBAAqB,SAAQ,aAAa;IACtD,YAAY,OAAO,SAA0B,EAAE,OAAO,CAAC,EAAE,SAAS,EAGjE;CACD;AAED,qBAAa,mBAAoB,SAAQ,aAAa;IACrD,cAGC;CACD;AAED,oFAAoF;AACpF,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,YAAY,KAAK,EAAE,OAAO,EAGzB;CACD","sourcesContent":["import type { JsonValue, ProtocolErrorCode } from \"@earendil-works/pi-protocol\";\n\nexport type PiServerOperationErrorCode = Extract<\n\tProtocolErrorCode,\n\t\"busy\" | \"session_locked\" | \"not_found\" | \"invalid_request\" | \"not_implemented\"\n>;\n\nexport const INTERNAL_SERVER_ERROR_MESSAGE = \"Internal server error\";\nexport const NOT_IMPLEMENTED_MESSAGE = \"Operation is not implemented\";\n\n/** A service/runtime error that can safely cross the protocol boundary. */\nexport class PiServerError extends Error {\n\treadonly code: PiServerOperationErrorCode;\n\treadonly details: JsonValue | undefined;\n\n\tconstructor(code: PiServerOperationErrorCode, message: string, details?: JsonValue) {\n\t\tsuper(message);\n\t\tthis.name = \"PiServerError\";\n\t\tthis.code = code;\n\t\tthis.details = details;\n\t}\n}\n\nexport class SessionBusyError extends PiServerError {\n\tconstructor(message = \"Session is busy\", details?: JsonValue) {\n\t\tsuper(\"busy\", message, details);\n\t\tthis.name = \"SessionBusyError\";\n\t}\n}\n\nexport class SessionLockedError extends PiServerError {\n\tconstructor(message = \"Session is locked\", details?: JsonValue) {\n\t\tsuper(\"session_locked\", message, details);\n\t\tthis.name = \"SessionLockedError\";\n\t}\n}\n\nexport class SessionNotFoundError extends PiServerError {\n\tconstructor(message = \"Session was not found\", details?: JsonValue) {\n\t\tsuper(\"not_found\", message, details);\n\t\tthis.name = \"SessionNotFoundError\";\n\t}\n}\n\nexport class NotImplementedError extends PiServerError {\n\tconstructor() {\n\t\tsuper(\"not_implemented\", NOT_IMPLEMENTED_MESSAGE);\n\t\tthis.name = \"NotImplementedError\";\n\t}\n}\n\n/** An unsafe failure whose cause is retained for reporting but never serialized. */\nexport class InternalServerError extends Error {\n\tconstructor(cause: unknown) {\n\t\tsuper(INTERNAL_SERVER_ERROR_MESSAGE, { cause });\n\t\tthis.name = \"InternalServerError\";\n\t}\n}\n"]}

package/dist/errors.js

@@ -0,0 +1,45 @@
+export const INTERNAL_SERVER_ERROR_MESSAGE = "Internal server error";
+export const NOT_IMPLEMENTED_MESSAGE = "Operation is not implemented";
+/** A service/runtime error that can safely cross the protocol boundary. */
+export class PiServerError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = "PiServerError";
+        this.code = code;
+        this.details = details;
+    }
+}
+export class SessionBusyError extends PiServerError {
+    constructor(message = "Session is busy", details) {
+        super("busy", message, details);
+        this.name = "SessionBusyError";
+    }
+}
+export class SessionLockedError extends PiServerError {
+    constructor(message = "Session is locked", details) {
+        super("session_locked", message, details);
+        this.name = "SessionLockedError";
+    }
+}
+export class SessionNotFoundError extends PiServerError {
+    constructor(message = "Session was not found", details) {
+        super("not_found", message, details);
+        this.name = "SessionNotFoundError";
+    }
+}
+export class NotImplementedError extends PiServerError {
+    constructor() {
+        super("not_implemented", NOT_IMPLEMENTED_MESSAGE);
+        this.name = "NotImplementedError";
+    }
+}
+/** An unsafe failure whose cause is retained for reporting but never serialized. */
+export class InternalServerError extends Error {
+    constructor(cause) {
+        super(INTERNAL_SERVER_ERROR_MESSAGE, { cause });
+        this.name = "InternalServerError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,6BAA6B,GAAG,uBAAuB,CAAC;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,8BAA8B,CAAC;AAEtE,2EAA2E;AAC3E,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC9B,IAAI,CAA6B;IACjC,OAAO,CAAwB;IAExC,YAAY,IAAgC,EAAE,OAAe,EAAE,OAAmB,EAAE;QACnF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAAA,CACvB;CACD;AAED,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IAClD,YAAY,OAAO,GAAG,iBAAiB,EAAE,OAAmB,EAAE;QAC7D,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IAAA,CAC/B;CACD;AAED,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACpD,YAAY,OAAO,GAAG,mBAAmB,EAAE,OAAmB,EAAE;QAC/D,KAAK,CAAC,gBAAgB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IAAA,CACjC;CACD;AAED,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IACtD,YAAY,OAAO,GAAG,uBAAuB,EAAE,OAAmB,EAAE;QACnE,KAAK,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IAAA,CACnC;CACD;AAED,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACrD,cAAc;QACb,KAAK,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IAAA,CAClC;CACD;AAED,oFAAoF;AACpF,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC7C,YAAY,KAAc,EAAE;QAC3B,KAAK,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IAAA,CAClC;CACD","sourcesContent":["import type { JsonValue, ProtocolErrorCode } from \"@earendil-works/pi-protocol\";\n\nexport type PiServerOperationErrorCode = Extract<\n\tProtocolErrorCode,\n\t\"busy\" | \"session_locked\" | \"not_found\" | \"invalid_request\" | \"not_implemented\"\n>;\n\nexport const INTERNAL_SERVER_ERROR_MESSAGE = \"Internal server error\";\nexport const NOT_IMPLEMENTED_MESSAGE = \"Operation is not implemented\";\n\n/** A service/runtime error that can safely cross the protocol boundary. */\nexport class PiServerError extends Error {\n\treadonly code: PiServerOperationErrorCode;\n\treadonly details: JsonValue | undefined;\n\n\tconstructor(code: PiServerOperationErrorCode, message: string, details?: JsonValue) {\n\t\tsuper(message);\n\t\tthis.name = \"PiServerError\";\n\t\tthis.code = code;\n\t\tthis.details = details;\n\t}\n}\n\nexport class SessionBusyError extends PiServerError {\n\tconstructor(message = \"Session is busy\", details?: JsonValue) {\n\t\tsuper(\"busy\", message, details);\n\t\tthis.name = \"SessionBusyError\";\n\t}\n}\n\nexport class SessionLockedError extends PiServerError {\n\tconstructor(message = \"Session is locked\", details?: JsonValue) {\n\t\tsuper(\"session_locked\", message, details);\n\t\tthis.name = \"SessionLockedError\";\n\t}\n}\n\nexport class SessionNotFoundError extends PiServerError {\n\tconstructor(message = \"Session was not found\", details?: JsonValue) {\n\t\tsuper(\"not_found\", message, details);\n\t\tthis.name = \"SessionNotFoundError\";\n\t}\n}\n\nexport class NotImplementedError extends PiServerError {\n\tconstructor() {\n\t\tsuper(\"not_implemented\", NOT_IMPLEMENTED_MESSAGE);\n\t\tthis.name = \"NotImplementedError\";\n\t}\n}\n\n/** An unsafe failure whose cause is retained for reporting but never serialized. */\nexport class InternalServerError extends Error {\n\tconstructor(cause: unknown) {\n\t\tsuper(INTERNAL_SERVER_ERROR_MESSAGE, { cause });\n\t\tthis.name = \"InternalServerError\";\n\t}\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./errors.ts";
+export * from "./listener.ts";
+export * from "./protocol.ts";
+export * from "./server.ts";
+export * from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC","sourcesContent":["export * from \"./errors.ts\";\nexport * from \"./listener.ts\";\nexport * from \"./protocol.ts\";\nexport * from \"./server.ts\";\nexport * from \"./types.ts\";\n"]}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./errors.js";
+export * from "./listener.js";
+export * from "./protocol.js";
+export * from "./server.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC","sourcesContent":["export * from \"./errors.ts\";\nexport * from \"./listener.ts\";\nexport * from \"./protocol.ts\";\nexport * from \"./server.ts\";\nexport * from \"./types.ts\";\n"]}

package/dist/listener.d.ts

@@ -0,0 +1,10 @@
+import type { ByteConnectionAcceptor } from "./connection.ts";
+/** Supplies established byte connections after any required transport authentication. */
+export interface PiServerListener {
+    /** Human-readable bound address after startup, when the transport has one. */
+    readonly address?: string;
+    /** Starts listening and passes authorized connections to accept. */
+    start(accept: ByteConnectionAcceptor): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=listener.d.ts.map

package/dist/listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listener.d.ts","sourceRoot":"","sources":["../src/listener.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,KAAK,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB","sourcesContent":["import type { ByteConnectionAcceptor } from \"./connection.ts\";\n\n/** Supplies established byte connections after any required transport authentication. */\nexport interface PiServerListener {\n\t/** Human-readable bound address after startup, when the transport has one. */\n\treadonly address?: string;\n\t/** Starts listening and passes authorized connections to accept. */\n\tstart(accept: ByteConnectionAcceptor): Promise<void>;\n\tclose(): Promise<void>;\n}\n"]}

package/dist/listener.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=listener.js.map

package/dist/listener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listener.js","sourceRoot":"","sources":["../src/listener.ts"],"names":[],"mappings":"","sourcesContent":["import type { ByteConnectionAcceptor } from \"./connection.ts\";\n\n/** Supplies established byte connections after any required transport authentication. */\nexport interface PiServerListener {\n\t/** Human-readable bound address after startup, when the transport has one. */\n\treadonly address?: string;\n\t/** Starts listening and passes authorized connections to accept. */\n\tstart(accept: ByteConnectionAcceptor): Promise<void>;\n\tclose(): Promise<void>;\n}\n"]}

package/dist/protocol.d.ts

@@ -0,0 +1,22 @@
+import { type Usage as AiUsage, type Api, type AssistantMessage, type Model, type ToolCall, type ToolResultMessage, type UserMessage } from "@earendil-works/pi-ai";
+import type { AssistantTranscriptItem, JsonValue, ModelMetadata, ToolTranscriptItem, Usage, UserTranscriptItem } from "@earendil-works/pi-protocol";
+export interface AssistantTranscriptOptions {
+    id: string;
+}
+export interface UserTranscriptOptions {
+    id: string;
+}
+export interface ToolTranscriptOptions {
+    id: string;
+    call: ToolCall;
+}
+/** Validate and copy a value from an execution boundary into the protocol's JSON-compatible subset. */
+export declare function toProtocolJsonValue(value: unknown, seen?: Set<object>): JsonValue;
+/** Lossily sanitize diagnostic tool details that must not affect execution semantics. */
+export declare function sanitizeProtocolDetails(value: unknown, seen?: Set<object>): JsonValue | undefined;
+export declare function toProtocolUsage(usage: AiUsage | undefined): Usage | undefined;
+export declare function toProtocolModelMetadata(model: Model<Api>, authenticated: boolean): ModelMetadata;
+export declare function toProtocolUserMessage(message: UserMessage, options: UserTranscriptOptions): UserTranscriptItem;
+export declare function toProtocolAssistantMessage(message: AssistantMessage, options: AssistantTranscriptOptions): AssistantTranscriptItem;
+export declare function toProtocolToolResultMessage(message: ToolResultMessage, options: ToolTranscriptOptions): ToolTranscriptItem;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,KAAK,IAAI,OAAO,EACrB,KAAK,GAAG,EACR,KAAK,gBAAgB,EAErB,KAAK,KAAK,EAEV,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACX,uBAAuB,EACvB,SAAS,EACT,aAAa,EAEb,kBAAkB,EAClB,KAAK,EACL,kBAAkB,EAClB,MAAM,6BAA6B,CAAC;AAqFrC,MAAM,WAAW,0BAA0B;IAC1C,EAAE,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,qBAAqB;IACrC,EAAE,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,qBAAqB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CACf;AAsBD,uGAAuG;AACvG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,cAAoB,GAAG,SAAS,CAqBvF;AAED,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,cAAoB,GAAG,SAAS,GAAG,SAAS,CAoBvG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,CAmB7E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,aAAa,EAAE,OAAO,GAAG,aAAa,CAoBhG;AAkBD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,qBAAqB,GAAG,kBAAkB,CAQ9G;AA4BD,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,0BAA0B,GACjC,uBAAuB,CAmDzB;AAiBD,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,qBAAqB,GAC5B,kBAAkB,CAyBpB","sourcesContent":["import {\n\ttype ImageContent as AiImageContent,\n\ttype TextContent as AiTextContent,\n\ttype Usage as AiUsage,\n\ttype Api,\n\ttype AssistantMessage,\n\tgetSupportedThinkingLevels,\n\ttype Model,\n\ttype ModelThinkingLevel,\n\ttype ToolCall,\n\ttype ToolResultMessage,\n\ttype UserMessage,\n} from \"@earendil-works/pi-ai\";\nimport type {\n\tAssistantTranscriptItem,\n\tJsonValue,\n\tModelMetadata,\n\tThinkingLevel,\n\tToolTranscriptItem,\n\tUsage,\n\tUserTranscriptItem,\n} from \"@earendil-works/pi-protocol\";\n\ntype Assert<T extends true> = T;\ntype ExactKeys<T, Keys extends keyof T> = keyof T extends Keys ? true : false;\ntype _AiThinkingLevelsFitProtocol = Assert<ModelThinkingLevel extends ThinkingLevel ? true : false>;\ntype _ProtocolThinkingLevelsFitAi = Assert<ThinkingLevel extends ModelThinkingLevel ? true : false>;\ntype AiModelInput = Model<Api>[\"input\"][number];\ntype ProtocolModelInput = ModelMetadata[\"input\"][number];\ntype _AiModelInputsFitProtocol = Assert<AiModelInput extends ProtocolModelInput ? true : false>;\ntype _ProtocolModelInputsFitAi = Assert<ProtocolModelInput extends AiModelInput ? true : false>;\n/**\n * Enumerate mapped and intentionally omitted pi-ai fields so additions fail compilation here.\n * Provider replay metadata, diagnostics, cache-write retention splits, model transport settings,\n * model sampling defaults, pricing tiers, and deferred-tool availability remain intentionally\n * server-side.\n */\ntype _AiTextContentFieldsAccountedFor = Assert<ExactKeys<AiTextContent, \"type\" | \"text\" | \"textSignature\">>;\ntype _AiThinkingContentFieldsAccountedFor = Assert<\n\tExactKeys<\n\t\tExtract<AssistantMessage[\"content\"][number], { type: \"thinking\" }>,\n\t\t\"type\" | \"thinking\" | \"thinkingSignature\" | \"redacted\"\n\t>\n>;\ntype _AiImageContentFieldsAccountedFor = Assert<ExactKeys<AiImageContent, \"type\" | \"data\" | \"mimeType\">>;\ntype _AiToolCallFieldsAccountedFor = Assert<\n\tExactKeys<ToolCall, \"type\" | \"id\" | \"name\" | \"arguments\" | \"thoughtSignature\">\n>;\ntype _AiUsageFieldsAccountedFor = Assert<\n\tExactKeys<\n\t\tAiUsage,\n\t\t\"input\" | \"output\" | \"cacheRead\" | \"cacheWrite\" | \"cacheWrite1h\" | \"reasoning\" | \"totalTokens\" | \"cost\"\n\t>\n>;\ntype _AiUsageCostFieldsAccountedFor = Assert<\n\tExactKeys<AiUsage[\"cost\"], \"input\" | \"output\" | \"cacheRead\" | \"cacheWrite\" | \"total\">\n>;\ntype _AiModelFieldsAccountedFor = Assert<\n\tExactKeys<\n\t\tModel<Api>,\n\t\t| \"id\"\n\t\t| \"name\"\n\t\t| \"api\"\n\t\t| \"provider\"\n\t\t| \"baseUrl\"\n\t\t| \"reasoning\"\n\t\t| \"thinkingLevelMap\"\n\t\t| \"input\"\n\t\t| \"cost\"\n\t\t| \"contextWindow\"\n\t\t| \"maxTokens\"\n\t\t| \"samplingParams\"\n\t\t| \"headers\"\n\t\t| \"compat\"\n\t>\n>;\ntype _AiModelCostFieldsAccountedFor = Assert<\n\tExactKeys<Model<Api>[\"cost\"], \"input\" | \"output\" | \"cacheRead\" | \"cacheWrite\" | \"tiers\">\n>;\ntype _AiUserMessageFieldsAccountedFor = Assert<ExactKeys<UserMessage, \"role\" | \"content\" | \"timestamp\">>;\ntype _AiAssistantMessageFieldsAccountedFor = Assert<\n\tExactKeys<\n\t\tAssistantMessage,\n\t\t| \"role\"\n\t\t| \"content\"\n\t\t| \"api\"\n\t\t| \"provider\"\n\t\t| \"model\"\n\t\t| \"responseModel\"\n\t\t| \"responseId\"\n\t\t| \"diagnostics\"\n\t\t| \"usage\"\n\t\t| \"stopReason\"\n\t\t| \"deferred\"\n\t\t| \"errorMessage\"\n\t\t| \"rawStopReason\"\n\t\t| \"timestamp\"\n\t>\n>;\ntype _AiToolResultMessageFieldsAccountedFor = Assert<\n\tExactKeys<\n\t\tToolResultMessage,\n\t\t\"role\" | \"toolCallId\" | \"toolName\" | \"content\" | \"details\" | \"usage\" | \"addedToolNames\" | \"isError\" | \"timestamp\"\n\t>\n>;\n\nexport interface AssistantTranscriptOptions {\n\tid: string;\n}\n\nexport interface UserTranscriptOptions {\n\tid: string;\n}\n\nexport interface ToolTranscriptOptions {\n\tid: string;\n\tcall: ToolCall;\n}\n\nfunction nonNegativeInteger(value: number | undefined): number | undefined {\n\tif (value === undefined || !Number.isFinite(value)) return undefined;\n\treturn Math.max(0, Math.floor(value));\n}\n\nfunction nonNegativeNumber(value: number): number {\n\treturn Number.isFinite(value) ? Math.max(0, value) : 0;\n}\n\nfunction identifier(value: string, label: string): string {\n\tif (typeof value !== \"string\" || value.length === 0) throw new TypeError(`${label} must be a non-empty string`);\n\treturn value;\n}\n\nfunction timestamp(value: number): number {\n\tif (!Number.isSafeInteger(value) || value < 0)\n\t\tthrow new TypeError(\"Protocol timestamps must be non-negative integers\");\n\treturn value;\n}\n\n/** Validate and copy a value from an execution boundary into the protocol's JSON-compatible subset. */\nexport function toProtocolJsonValue(value: unknown, seen = new Set<object>()): JsonValue {\n\tif (value === null || typeof value === \"string\" || typeof value === \"boolean\") return value;\n\tif (typeof value === \"number\") {\n\t\tif (!Number.isFinite(value)) throw new TypeError(\"Protocol JSON numbers must be finite\");\n\t\treturn value;\n\t}\n\tif (typeof value !== \"object\") throw new TypeError(`Unsupported protocol JSON value: ${typeof value}`);\n\tif (seen.has(value)) throw new TypeError(\"Protocol JSON values must not contain circular references\");\n\tconst prototype = Object.getPrototypeOf(value);\n\tif (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null) {\n\t\tthrow new TypeError(\"Protocol JSON objects must be plain objects\");\n\t}\n\tseen.add(value);\n\ttry {\n\t\tif (Array.isArray(value)) return Array.from(value, (entry) => toProtocolJsonValue(entry, seen));\n\t\tconst result: Record<string, JsonValue> = {};\n\t\tfor (const [key, entry] of Object.entries(value)) result[key] = toProtocolJsonValue(entry, seen);\n\t\treturn result;\n\t} finally {\n\t\tseen.delete(value);\n\t}\n}\n\n/** Lossily sanitize diagnostic tool details that must not affect execution semantics. */\nexport function sanitizeProtocolDetails(value: unknown, seen = new Set<object>()): JsonValue | undefined {\n\tif (value === null || typeof value === \"string\" || typeof value === \"boolean\") return value;\n\tif (typeof value === \"number\") return Number.isFinite(value) ? value : String(value);\n\tif (typeof value === \"bigint\") return value.toString();\n\tif (value === undefined || typeof value === \"function\" || typeof value === \"symbol\") return undefined;\n\tif (value instanceof Date) return value.toISOString();\n\tif (typeof value !== \"object\") return String(value);\n\tif (seen.has(value)) return \"[Circular]\";\n\tseen.add(value);\n\ttry {\n\t\tif (Array.isArray(value)) return Array.from(value, (entry) => sanitizeProtocolDetails(entry, seen) ?? null);\n\t\tconst result: Record<string, JsonValue> = {};\n\t\tfor (const [key, entry] of Object.entries(value)) {\n\t\t\tconst normalized = sanitizeProtocolDetails(entry, seen);\n\t\t\tif (normalized !== undefined) result[key] = normalized;\n\t\t}\n\t\treturn result;\n\t} finally {\n\t\tseen.delete(value);\n\t}\n}\n\nexport function toProtocolUsage(usage: AiUsage | undefined): Usage | undefined {\n\tif (!usage) return undefined;\n\tconst reasoning = nonNegativeInteger(usage.reasoning);\n\tconst result = {\n\t\tinput: nonNegativeInteger(usage.input) ?? 0,\n\t\toutput: nonNegativeInteger(usage.output) ?? 0,\n\t\tcacheRead: nonNegativeInteger(usage.cacheRead) ?? 0,\n\t\tcacheWrite: nonNegativeInteger(usage.cacheWrite) ?? 0,\n\t\t...(reasoning === undefined ? {} : { reasoning }),\n\t\ttotalTokens: nonNegativeInteger(usage.totalTokens) ?? 0,\n\t\tcost: {\n\t\t\tinput: nonNegativeNumber(usage.cost.input),\n\t\t\toutput: nonNegativeNumber(usage.cost.output),\n\t\t\tcacheRead: nonNegativeNumber(usage.cost.cacheRead),\n\t\t\tcacheWrite: nonNegativeNumber(usage.cost.cacheWrite),\n\t\t\ttotal: nonNegativeNumber(usage.cost.total),\n\t\t},\n\t} satisfies Usage;\n\treturn result;\n}\n\nexport function toProtocolModelMetadata(model: Model<Api>, authenticated: boolean): ModelMetadata {\n\tconst result = {\n\t\tprovider: identifier(model.provider, \"Model provider\"),\n\t\tid: identifier(model.id, \"Model id\"),\n\t\tname: identifier(model.name, \"Model name\"),\n\t\tapi: identifier(model.api, \"Model API\"),\n\t\treasoning: model.reasoning,\n\t\tinput: [...model.input],\n\t\tcontextWindow: Math.max(1, Math.floor(model.contextWindow)),\n\t\tmaxTokens: Math.max(1, Math.floor(model.maxTokens)),\n\t\tcost: {\n\t\t\tinput: nonNegativeNumber(model.cost.input),\n\t\t\toutput: nonNegativeNumber(model.cost.output),\n\t\t\tcacheRead: nonNegativeNumber(model.cost.cacheRead),\n\t\t\tcacheWrite: nonNegativeNumber(model.cost.cacheWrite),\n\t\t},\n\t\tsupportedThinkingLevels: getSupportedThinkingLevels(model),\n\t\tauthenticated,\n\t} satisfies ModelMetadata;\n\treturn result;\n}\n\nfunction toProtocolUserContent(content: UserMessage[\"content\"]): UserTranscriptItem[\"content\"] {\n\tif (typeof content === \"string\") return [{ type: \"text\", text: content }];\n\treturn content.map((part) => {\n\t\tswitch (part.type) {\n\t\t\tcase \"text\":\n\t\t\t\treturn { type: \"text\", text: part.text };\n\t\t\tcase \"image\":\n\t\t\t\treturn { type: \"image\", data: part.data, mimeType: part.mimeType };\n\t\t\tdefault: {\n\t\t\t\tconst exhaustive: never = part;\n\t\t\t\treturn exhaustive;\n\t\t\t}\n\t\t}\n\t});\n}\n\nexport function toProtocolUserMessage(message: UserMessage, options: UserTranscriptOptions): UserTranscriptItem {\n\tconst result = {\n\t\tid: identifier(options.id, \"Transcript item id\"),\n\t\trole: \"user\",\n\t\tcontent: toProtocolUserContent(message.content),\n\t\ttimestamp: timestamp(message.timestamp),\n\t} satisfies UserTranscriptItem;\n\treturn result;\n}\n\nfunction toProtocolAssistantContent(message: AssistantMessage): AssistantTranscriptItem[\"content\"] {\n\treturn message.content.map((part) => {\n\t\tswitch (part.type) {\n\t\t\tcase \"text\":\n\t\t\t\treturn { type: \"text\", text: part.text };\n\t\t\tcase \"thinking\":\n\t\t\t\treturn {\n\t\t\t\t\ttype: \"thinking\",\n\t\t\t\t\tthinking: part.thinking,\n\t\t\t\t\t...(part.redacted === undefined ? {} : { redacted: part.redacted }),\n\t\t\t\t};\n\t\t\tcase \"toolCall\":\n\t\t\t\treturn {\n\t\t\t\t\ttype: \"toolCall\",\n\t\t\t\t\ttoolCallId: identifier(part.id, \"Tool call id\"),\n\t\t\t\t\ttoolName: identifier(part.name, \"Tool call name\"),\n\t\t\t\t\tinput: toProtocolJsonValue(part.arguments),\n\t\t\t\t};\n\t\t\tdefault: {\n\t\t\t\tconst exhaustive: never = part;\n\t\t\t\treturn exhaustive;\n\t\t\t}\n\t\t}\n\t});\n}\n\nexport function toProtocolAssistantMessage(\n\tmessage: AssistantMessage,\n\toptions: AssistantTranscriptOptions,\n): AssistantTranscriptItem {\n\tconst usage = toProtocolUsage(message.usage);\n\tconst common = {\n\t\tid: identifier(options.id, \"Transcript item id\"),\n\t\trole: \"assistant\",\n\t\tcontent: toProtocolAssistantContent(message),\n\t\tmodel: {\n\t\t\tprovider: identifier(message.provider, \"Assistant provider\"),\n\t\t\tid: identifier(message.model, \"Assistant model\"),\n\t\t},\n\t\t...(message.responseModel === undefined\n\t\t\t? {}\n\t\t\t: { responseModel: identifier(message.responseModel, \"Assistant response model\") }),\n\t\t...(usage ? { usage } : {}),\n\t\ttimestamp: timestamp(message.timestamp),\n\t} as const;\n\tswitch (message.stopReason) {\n\t\tcase \"pending\":\n\t\t\treturn { ...common, status: \"streaming\" } satisfies AssistantTranscriptItem;\n\t\tcase \"stop\":\n\t\tcase \"length\":\n\t\tcase \"toolUse\":\n\t\t\treturn {\n\t\t\t\t...common,\n\t\t\t\tstatus: \"complete\",\n\t\t\t\tstopReason: message.stopReason,\n\t\t\t} satisfies AssistantTranscriptItem;\n\t\tcase \"deferred\":\n\t\t\tthrow new TypeError(\"Deferred assistant messages are not supported by protocol v1\");\n\t\tcase \"error\":\n\t\t\tif (message.errorMessage?.length === 0) {\n\t\t\t\tthrow new TypeError(\"Assistant error messages must not be empty\");\n\t\t\t}\n\t\t\treturn {\n\t\t\t\t...common,\n\t\t\t\tstatus: \"error\",\n\t\t\t\tstopReason: \"error\",\n\t\t\t\t...(message.errorMessage === undefined ? {} : { errorMessage: message.errorMessage }),\n\t\t\t} satisfies AssistantTranscriptItem;\n\t\tcase \"aborted\":\n\t\t\treturn {\n\t\t\t\t...common,\n\t\t\t\tstatus: \"aborted\",\n\t\t\t\tstopReason: \"aborted\",\n\t\t\t\t...(message.errorMessage === undefined ? {} : { errorMessage: message.errorMessage }),\n\t\t\t} satisfies AssistantTranscriptItem;\n\t\tdefault: {\n\t\t\tconst exhaustive: never = message.stopReason;\n\t\t\treturn exhaustive;\n\t\t}\n\t}\n}\n\nfunction toProtocolToolContent(content: Array<AiTextContent | AiImageContent>): ToolTranscriptItem[\"content\"] {\n\treturn content.map((part) => {\n\t\tswitch (part.type) {\n\t\t\tcase \"text\":\n\t\t\t\treturn { type: \"text\", text: part.text };\n\t\t\tcase \"image\":\n\t\t\t\treturn { type: \"image\", data: part.data, mimeType: part.mimeType };\n\t\t\tdefault: {\n\t\t\t\tconst exhaustive: never = part;\n\t\t\t\treturn exhaustive;\n\t\t\t}\n\t\t}\n\t});\n}\n\nexport function toProtocolToolResultMessage(\n\tmessage: ToolResultMessage,\n\toptions: ToolTranscriptOptions,\n): ToolTranscriptItem {\n\tconst callId = identifier(options.call.id, \"Tool call id\");\n\tconst callName = identifier(options.call.name, \"Tool call name\");\n\tif (identifier(message.toolCallId, \"Tool result call id\") !== callId) {\n\t\tthrow new TypeError(`Tool result ${message.toolCallId} does not match tool call ${callId}`);\n\t}\n\tif (identifier(message.toolName, \"Tool result name\") !== callName) {\n\t\tthrow new TypeError(`Tool result ${message.toolName} does not match tool call ${callName}`);\n\t}\n\tconst details = sanitizeProtocolDetails(message.details);\n\tconst usage = toProtocolUsage(message.usage);\n\tconst common = {\n\t\tid: identifier(options.id, \"Transcript item id\"),\n\t\trole: \"tool\",\n\t\ttoolCallId: callId,\n\t\ttoolName: callName,\n\t\tinput: toProtocolJsonValue(options.call.arguments),\n\t\tcontent: toProtocolToolContent(message.content),\n\t\t...(details === undefined ? {} : { details }),\n\t\t...(usage ? { usage } : {}),\n\t\ttimestamp: timestamp(message.timestamp),\n\t} as const;\n\treturn message.isError\n\t\t? ({ ...common, status: \"error\", isError: true } satisfies ToolTranscriptItem)\n\t\t: ({ ...common, status: \"complete\", isError: false } satisfies ToolTranscriptItem);\n}\n"]}

package/dist/protocol.js

@@ -0,0 +1,266 @@
+import { getSupportedThinkingLevels, } from "@earendil-works/pi-ai";
+function nonNegativeInteger(value) {
+    if (value === undefined || !Number.isFinite(value))
+        return undefined;
+    return Math.max(0, Math.floor(value));
+}
+function nonNegativeNumber(value) {
+    return Number.isFinite(value) ? Math.max(0, value) : 0;
+}
+function identifier(value, label) {
+    if (typeof value !== "string" || value.length === 0)
+        throw new TypeError(`${label} must be a non-empty string`);
+    return value;
+}
+function timestamp(value) {
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new TypeError("Protocol timestamps must be non-negative integers");
+    return value;
+}
+/** Validate and copy a value from an execution boundary into the protocol's JSON-compatible subset. */
+export function toProtocolJsonValue(value, seen = new Set()) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return value;
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new TypeError("Protocol JSON numbers must be finite");
+        return value;
+    }
+    if (typeof value !== "object")
+        throw new TypeError(`Unsupported protocol JSON value: ${typeof value}`);
+    if (seen.has(value))
+        throw new TypeError("Protocol JSON values must not contain circular references");
+    const prototype = Object.getPrototypeOf(value);
+    if (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null) {
+        throw new TypeError("Protocol JSON objects must be plain objects");
+    }
+    seen.add(value);
+    try {
+        if (Array.isArray(value))
+            return Array.from(value, (entry) => toProtocolJsonValue(entry, seen));
+        const result = {};
+        for (const [key, entry] of Object.entries(value))
+            result[key] = toProtocolJsonValue(entry, seen);
+        return result;
+    }
+    finally {
+        seen.delete(value);
+    }
+}
+/** Lossily sanitize diagnostic tool details that must not affect execution semantics. */
+export function sanitizeProtocolDetails(value, seen = new Set()) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return value;
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : String(value);
+    if (typeof value === "bigint")
+        return value.toString();
+    if (value === undefined || typeof value === "function" || typeof value === "symbol")
+        return undefined;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value !== "object")
+        return String(value);
+    if (seen.has(value))
+        return "[Circular]";
+    seen.add(value);
+    try {
+        if (Array.isArray(value))
+            return Array.from(value, (entry) => sanitizeProtocolDetails(entry, seen) ?? null);
+        const result = {};
+        for (const [key, entry] of Object.entries(value)) {
+            const normalized = sanitizeProtocolDetails(entry, seen);
+            if (normalized !== undefined)
+                result[key] = normalized;
+        }
+        return result;
+    }
+    finally {
+        seen.delete(value);
+    }
+}
+export function toProtocolUsage(usage) {
+    if (!usage)
+        return undefined;
+    const reasoning = nonNegativeInteger(usage.reasoning);
+    const result = {
+        input: nonNegativeInteger(usage.input) ?? 0,
+        output: nonNegativeInteger(usage.output) ?? 0,
+        cacheRead: nonNegativeInteger(usage.cacheRead) ?? 0,
+        cacheWrite: nonNegativeInteger(usage.cacheWrite) ?? 0,
+        ...(reasoning === undefined ? {} : { reasoning }),
+        totalTokens: nonNegativeInteger(usage.totalTokens) ?? 0,
+        cost: {
+            input: nonNegativeNumber(usage.cost.input),
+            output: nonNegativeNumber(usage.cost.output),
+            cacheRead: nonNegativeNumber(usage.cost.cacheRead),
+            cacheWrite: nonNegativeNumber(usage.cost.cacheWrite),
+            total: nonNegativeNumber(usage.cost.total),
+        },
+    };
+    return result;
+}
+export function toProtocolModelMetadata(model, authenticated) {
+    const result = {
+        provider: identifier(model.provider, "Model provider"),
+        id: identifier(model.id, "Model id"),
+        name: identifier(model.name, "Model name"),
+        api: identifier(model.api, "Model API"),
+        reasoning: model.reasoning,
+        input: [...model.input],
+        contextWindow: Math.max(1, Math.floor(model.contextWindow)),
+        maxTokens: Math.max(1, Math.floor(model.maxTokens)),
+        cost: {
+            input: nonNegativeNumber(model.cost.input),
+            output: nonNegativeNumber(model.cost.output),
+            cacheRead: nonNegativeNumber(model.cost.cacheRead),
+            cacheWrite: nonNegativeNumber(model.cost.cacheWrite),
+        },
+        supportedThinkingLevels: getSupportedThinkingLevels(model),
+        authenticated,
+    };
+    return result;
+}
+function toProtocolUserContent(content) {
+    if (typeof content === "string")
+        return [{ type: "text", text: content }];
+    return content.map((part) => {
+        switch (part.type) {
+            case "text":
+                return { type: "text", text: part.text };
+            case "image":
+                return { type: "image", data: part.data, mimeType: part.mimeType };
+            default: {
+                const exhaustive = part;
+                return exhaustive;
+            }
+        }
+    });
+}
+export function toProtocolUserMessage(message, options) {
+    const result = {
+        id: identifier(options.id, "Transcript item id"),
+        role: "user",
+        content: toProtocolUserContent(message.content),
+        timestamp: timestamp(message.timestamp),
+    };
+    return result;
+}
+function toProtocolAssistantContent(message) {
+    return message.content.map((part) => {
+        switch (part.type) {
+            case "text":
+                return { type: "text", text: part.text };
+            case "thinking":
+                return {
+                    type: "thinking",
+                    thinking: part.thinking,
+                    ...(part.redacted === undefined ? {} : { redacted: part.redacted }),
+                };
+            case "toolCall":
+                return {
+                    type: "toolCall",
+                    toolCallId: identifier(part.id, "Tool call id"),
+                    toolName: identifier(part.name, "Tool call name"),
+                    input: toProtocolJsonValue(part.arguments),
+                };
+            default: {
+                const exhaustive = part;
+                return exhaustive;
+            }
+        }
+    });
+}
+export function toProtocolAssistantMessage(message, options) {
+    const usage = toProtocolUsage(message.usage);
+    const common = {
+        id: identifier(options.id, "Transcript item id"),
+        role: "assistant",
+        content: toProtocolAssistantContent(message),
+        model: {
+            provider: identifier(message.provider, "Assistant provider"),
+            id: identifier(message.model, "Assistant model"),
+        },
+        ...(message.responseModel === undefined
+            ? {}
+            : { responseModel: identifier(message.responseModel, "Assistant response model") }),
+        ...(usage ? { usage } : {}),
+        timestamp: timestamp(message.timestamp),
+    };
+    switch (message.stopReason) {
+        case "pending":
+            return { ...common, status: "streaming" };
+        case "stop":
+        case "length":
+        case "toolUse":
+            return {
+                ...common,
+                status: "complete",
+                stopReason: message.stopReason,
+            };
+        case "deferred":
+            throw new TypeError("Deferred assistant messages are not supported by protocol v1");
+        case "error":
+            if (message.errorMessage?.length === 0) {
+                throw new TypeError("Assistant error messages must not be empty");
+            }
+            return {
+                ...common,
+                status: "error",
+                stopReason: "error",
+                ...(message.errorMessage === undefined ? {} : { errorMessage: message.errorMessage }),
+            };
+        case "aborted":
+            return {
+                ...common,
+                status: "aborted",
+                stopReason: "aborted",
+                ...(message.errorMessage === undefined ? {} : { errorMessage: message.errorMessage }),
+            };
+        default: {
+            const exhaustive = message.stopReason;
+            return exhaustive;
+        }
+    }
+}
+function toProtocolToolContent(content) {
+    return content.map((part) => {
+        switch (part.type) {
+            case "text":
+                return { type: "text", text: part.text };
+            case "image":
+                return { type: "image", data: part.data, mimeType: part.mimeType };
+            default: {
+                const exhaustive = part;
+                return exhaustive;
+            }
+        }
+    });
+}
+export function toProtocolToolResultMessage(message, options) {
+    const callId = identifier(options.call.id, "Tool call id");
+    const callName = identifier(options.call.name, "Tool call name");
+    if (identifier(message.toolCallId, "Tool result call id") !== callId) {
+        throw new TypeError(`Tool result ${message.toolCallId} does not match tool call ${callId}`);
+    }
+    if (identifier(message.toolName, "Tool result name") !== callName) {
+        throw new TypeError(`Tool result ${message.toolName} does not match tool call ${callName}`);
+    }
+    const details = sanitizeProtocolDetails(message.details);
+    const usage = toProtocolUsage(message.usage);
+    const common = {
+        id: identifier(options.id, "Transcript item id"),
+        role: "tool",
+        toolCallId: callId,
+        toolName: callName,
+        input: toProtocolJsonValue(options.call.arguments),
+        content: toProtocolToolContent(message.content),
+        ...(details === undefined ? {} : { details }),
+        ...(usage ? { usage } : {}),
+        timestamp: timestamp(message.timestamp),
+    };
+    return message.isError
+        ? { ...common, status: "error", isError: true }
+        : { ...common, status: "complete", isError: false };
+}
+//# sourceMappingURL=protocol.js.map