@earendil-works/pi-server 0.84.0

package/dist/types.d.ts

@@ -0,0 +1,56 @@
+import type { Command, ModelMetadata, ModelRef, SessionMetadata, SessionPhase, SessionSnapshot, ThinkingLevel, TranscriptProgress } from "@earendil-works/pi-protocol";
+import type { PiServerError } from "./errors.ts";
+import type { PiServerListener } from "./listener.ts";
+export interface PiServerOptions {
+    listeners: readonly PiServerListener[];
+    maxFrameLength?: number;
+    handshakeTimeoutMs?: number;
+    serverId?: string;
+    onError?: (error: Error) => void;
+}
+export type MaybePromise<T> = T | Promise<T>;
+export type PromptInput = Omit<Extract<Command, {
+    command: "prompt";
+}>, "command" | "sessionId">;
+export type SteerInput = Omit<Extract<Command, {
+    command: "steer";
+}>, "command" | "sessionId">;
+export interface CreateSessionOptions {
+    /** A collision-resistant ID assigned by PiServer. The service must persist this exact ID. */
+    id: string;
+    cwd?: string;
+    name?: string;
+    model?: ModelRef;
+    thinkingLevel?: ThinkingLevel;
+}
+export type PiSessionRuntimeEvent = {
+    type: "snapshot";
+} | {
+    type: "progress";
+    progress: TranscriptProgress;
+} | {
+    type: "error";
+    error: PiServerError;
+};
+/** One acquired durable session. Conflicting operations must reject rather than queue. */
+export interface PiSessionRuntime {
+    snapshot(): MaybePromise<SessionSnapshot>;
+    getPhase(): SessionPhase;
+    prompt(input: PromptInput): Promise<void>;
+    steer(input: SteerInput): Promise<void>;
+    abort(): Promise<void>;
+    setModel(model: ModelRef): Promise<void>;
+    setThinking(thinkingLevel: ThinkingLevel): Promise<void>;
+    subscribe(listener: (event: PiSessionRuntimeEvent) => void): () => void;
+    dispose(): Promise<void>;
+}
+/** Service boundary for durable sessions and exclusively acquired runtimes. */
+export interface PiServerService {
+    listSessions(): Promise<SessionMetadata[]>;
+    listModels(): Promise<ModelMetadata[]>;
+    createSession(options: CreateSessionOptions): Promise<PiSessionRuntime>;
+    openSession(sessionId: string): Promise<PiSessionRuntime>;
+}
+export type SessionRuntime = PiSessionRuntime;
+export type SessionRuntimeEvent = PiSessionRuntimeEvent;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,OAAO,EACP,aAAa,EACb,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7C,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC,CAAC;AACjG,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC,CAAC;AAE/F,MAAM,WAAW,oBAAoB;IACpC,6FAA6F;IAC7F,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,MAAM,qBAAqB,GAC9B;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,kBAAkB,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAE3C,0FAA0F;AAC1F,MAAM,WAAW,gBAAgB;IAChC,QAAQ,IAAI,YAAY,CAAC,eAAe,CAAC,CAAC;IAC1C,QAAQ,IAAI,YAAY,CAAC;IACzB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,WAAW,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACxE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC/B,YAAY,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC3C,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACvC,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACxE,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC1D;AAED,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAC9C,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC","sourcesContent":["import type {\n\tCommand,\n\tModelMetadata,\n\tModelRef,\n\tSessionMetadata,\n\tSessionPhase,\n\tSessionSnapshot,\n\tThinkingLevel,\n\tTranscriptProgress,\n} from \"@earendil-works/pi-protocol\";\nimport type { PiServerError } from \"./errors.ts\";\nimport type { PiServerListener } from \"./listener.ts\";\n\nexport interface PiServerOptions {\n\tlisteners: readonly PiServerListener[];\n\tmaxFrameLength?: number;\n\thandshakeTimeoutMs?: number;\n\tserverId?: string;\n\tonError?: (error: Error) => void;\n}\n\nexport type MaybePromise<T> = T | Promise<T>;\n\nexport type PromptInput = Omit<Extract<Command, { command: \"prompt\" }>, \"command\" | \"sessionId\">;\nexport type SteerInput = Omit<Extract<Command, { command: \"steer\" }>, \"command\" | \"sessionId\">;\n\nexport interface CreateSessionOptions {\n\t/** A collision-resistant ID assigned by PiServer. The service must persist this exact ID. */\n\tid: string;\n\tcwd?: string;\n\tname?: string;\n\tmodel?: ModelRef;\n\tthinkingLevel?: ThinkingLevel;\n}\n\nexport type PiSessionRuntimeEvent =\n\t| { type: \"snapshot\" }\n\t| { type: \"progress\"; progress: TranscriptProgress }\n\t| { type: \"error\"; error: PiServerError };\n\n/** One acquired durable session. Conflicting operations must reject rather than queue. */\nexport interface PiSessionRuntime {\n\tsnapshot(): MaybePromise<SessionSnapshot>;\n\tgetPhase(): SessionPhase;\n\tprompt(input: PromptInput): Promise<void>;\n\tsteer(input: SteerInput): Promise<void>;\n\tabort(): Promise<void>;\n\tsetModel(model: ModelRef): Promise<void>;\n\tsetThinking(thinkingLevel: ThinkingLevel): Promise<void>;\n\tsubscribe(listener: (event: PiSessionRuntimeEvent) => void): () => void;\n\tdispose(): Promise<void>;\n}\n\n/** Service boundary for durable sessions and exclusively acquired runtimes. */\nexport interface PiServerService {\n\tlistSessions(): Promise<SessionMetadata[]>;\n\tlistModels(): Promise<ModelMetadata[]>;\n\tcreateSession(options: CreateSessionOptions): Promise<PiSessionRuntime>;\n\topenSession(sessionId: string): Promise<PiSessionRuntime>;\n}\n\nexport type SessionRuntime = PiSessionRuntime;\nexport type SessionRuntimeEvent = PiSessionRuntimeEvent;\n"]}

package/dist/types.js

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

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n\tCommand,\n\tModelMetadata,\n\tModelRef,\n\tSessionMetadata,\n\tSessionPhase,\n\tSessionSnapshot,\n\tThinkingLevel,\n\tTranscriptProgress,\n} from \"@earendil-works/pi-protocol\";\nimport type { PiServerError } from \"./errors.ts\";\nimport type { PiServerListener } from \"./listener.ts\";\n\nexport interface PiServerOptions {\n\tlisteners: readonly PiServerListener[];\n\tmaxFrameLength?: number;\n\thandshakeTimeoutMs?: number;\n\tserverId?: string;\n\tonError?: (error: Error) => void;\n}\n\nexport type MaybePromise<T> = T | Promise<T>;\n\nexport type PromptInput = Omit<Extract<Command, { command: \"prompt\" }>, \"command\" | \"sessionId\">;\nexport type SteerInput = Omit<Extract<Command, { command: \"steer\" }>, \"command\" | \"sessionId\">;\n\nexport interface CreateSessionOptions {\n\t/** A collision-resistant ID assigned by PiServer. The service must persist this exact ID. */\n\tid: string;\n\tcwd?: string;\n\tname?: string;\n\tmodel?: ModelRef;\n\tthinkingLevel?: ThinkingLevel;\n}\n\nexport type PiSessionRuntimeEvent =\n\t| { type: \"snapshot\" }\n\t| { type: \"progress\"; progress: TranscriptProgress }\n\t| { type: \"error\"; error: PiServerError };\n\n/** One acquired durable session. Conflicting operations must reject rather than queue. */\nexport interface PiSessionRuntime {\n\tsnapshot(): MaybePromise<SessionSnapshot>;\n\tgetPhase(): SessionPhase;\n\tprompt(input: PromptInput): Promise<void>;\n\tsteer(input: SteerInput): Promise<void>;\n\tabort(): Promise<void>;\n\tsetModel(model: ModelRef): Promise<void>;\n\tsetThinking(thinkingLevel: ThinkingLevel): Promise<void>;\n\tsubscribe(listener: (event: PiSessionRuntimeEvent) => void): () => void;\n\tdispose(): Promise<void>;\n}\n\n/** Service boundary for durable sessions and exclusively acquired runtimes. */\nexport interface PiServerService {\n\tlistSessions(): Promise<SessionMetadata[]>;\n\tlistModels(): Promise<ModelMetadata[]>;\n\tcreateSession(options: CreateSessionOptions): Promise<PiSessionRuntime>;\n\topenSession(sessionId: string): Promise<PiSessionRuntime>;\n}\n\nexport type SessionRuntime = PiSessionRuntime;\nexport type SessionRuntimeEvent = PiSessionRuntimeEvent;\n"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+	"name": "@earendil-works/pi-server",
+	"version": "0.84.0",
+	"description": "experimental server package for pi",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./testing": {
+			"types": "./dist/testing/index.d.ts",
+			"import": "./dist/testing/index.js"
+		},
+		"./unix": {
+			"types": "./dist/transports/unix/index.d.ts",
+			"import": "./dist/transports/unix/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"CHANGELOG.md"
+	],
+	"scripts": {
+		"clean": "shx rm -rf dist",
+		"dev": "tsgo -p tsconfig.build.json --watch --preserveWatchOutput",
+		"build": "tsgo -p tsconfig.build.json",
+		"test": "vitest --run",
+		"typecheck": "tsgo -p tsconfig.test.json",
+		"prepublishOnly": "npm run clean && npm run build"
+	},
+	"keywords": [
+		"pi",
+		"server"
+	],
+	"author": "Earendil Works",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/earendil-works/pi.git",
+		"directory": "packages/server"
+	},
+	"engines": {
+		"node": ">=22.19.0"
+	},
+	"dependencies": {
+		"@earendil-works/pi-ai": "^0.84.0",
+		"@earendil-works/pi-protocol": "^0.84.0"
+	},
+	"devDependencies": {
+		"shx": "0.4.0",
+		"vitest": "4.1.9"
+	}
+}