pi-harness-runtime 0.9.4 → 0.9.6

package/packages/prompt-compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/prompt-compiler",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "Deterministic prompt compiler for pi-harness-runtime",
   "type": "module",
   "main": "./dist/index.js",

package/packages/prompt-versioning/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Prompt Versioning — Main Entry (RFC-0019)
+ */
+export { PromptVersioning } from "./versioning.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/prompt-versioning/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,mBAAmB,YAAY,CAAC"}

package/packages/prompt-versioning/dist/index.js

@@ -0,0 +1,5 @@
+/**
+ * Prompt Versioning — Main Entry (RFC-0019)
+ */
+export { PromptVersioning } from "./versioning.js";
+//# sourceMappingURL=index.js.map

package/packages/prompt-versioning/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/packages/prompt-versioning/dist/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Prompt Versioning — Types (RFC-0019)
+ */
+export interface PromptVersion {
+    version: string;
+    prompt: string;
+    createdAt: string;
+    createdBy?: string;
+    tags?: string[];
+    metadata?: Record<string, string>;
+}
+export interface PromptRecord {
+    id: string;
+    name: string;
+    versions: PromptVersion[];
+    activeVersion: string;
+}
+export interface VersionDiff {
+    from: string;
+    to: string;
+    added: number;
+    removed: number;
+    addedLines: string[];
+    removedLines: string[];
+}
+export interface RollbackResult {
+    promptId: string;
+    rolledBackTo: string;
+    currentVersion: string;
+    previousVersion: string;
+}
+export interface PromptVersioningConfig {
+    maxVersions?: number;
+    allowDelete?: boolean;
+    onVersionCreated?: (v: PromptVersion) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/prompt-versioning/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;CAC9C"}

package/packages/prompt-versioning/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Prompt Versioning — Types (RFC-0019)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/prompt-versioning/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/packages/prompt-versioning/dist/versioning.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Prompt Versioning — Core (RFC-0019)
+ */
+import type { PromptVersion, PromptRecord, VersionDiff, RollbackResult, PromptVersioningConfig } from "./types.js";
+export declare class PromptVersioning {
+    private prompts;
+    private config;
+    constructor(config?: PromptVersioningConfig);
+    createPrompt(name: string, initialPrompt: string, createdBy?: string): PromptRecord;
+    addVersion(promptId: string, prompt: string, createdBy?: string, tags?: string[]): PromptVersion;
+    getVersion(promptId: string, version?: string): PromptVersion | null;
+    listVersions(promptId: string): PromptVersion[];
+    diff(promptId: string, from: string, to: string): VersionDiff | null;
+    rollback(promptId: string, targetVersion: string): RollbackResult | null;
+    delete(promptId: string): boolean;
+    listPrompts(): PromptRecord[];
+    getStats(promptId: string): {
+        versionCount: number;
+        activeVersion: string;
+    } | null;
+    private makeVersion;
+    private enforceMaxVersions;
+    private get;
+    private getOrThrow;
+}
+//# sourceMappingURL=versioning.d.ts.map

package/packages/prompt-versioning/dist/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../src/versioning.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,cAAc,EACd,sBAAsB,EACtB,MAAM,YAAY,CAAC;AAOpB,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,MAAM,CAAmC;IAEjD,YAAY,MAAM,GAAE,sBAA2B,EAM9C;IAED,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,CAUlF;IAED,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,aAAa,CAQ/F;IAED,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAOnE;IAED,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAE9C;IAED,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAuBnE;IAED,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAcvE;IAED,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGhC;IAED,WAAW,IAAI,YAAY,EAAE,CAE5B;IAED,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAGjF;IAED,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,UAAU;CAKlB"}

package/packages/prompt-versioning/dist/versioning.js

@@ -0,0 +1,130 @@
+/**
+ * Prompt Versioning — Core (RFC-0019)
+ */
+let _counter = 0;
+function nextId() {
+    return `pv-${Date.now()}-${++_counter}`;
+}
+export class PromptVersioning {
+    prompts = new Map();
+    config;
+    constructor(config = {}) {
+        this.config = {
+            maxVersions: config.maxVersions ?? 50,
+            allowDelete: config.allowDelete ?? false,
+            onVersionCreated: config.onVersionCreated ?? (() => { }),
+        };
+    }
+    createPrompt(name, initialPrompt, createdBy) {
+        const v = this.makeVersion(initialPrompt, createdBy);
+        const record = {
+            id: nextId(),
+            name,
+            versions: [v],
+            activeVersion: v.version,
+        };
+        this.prompts.set(record.id, record);
+        return record;
+    }
+    addVersion(promptId, prompt, createdBy, tags) {
+        const record = this.getOrThrow(promptId);
+        const v = this.makeVersion(prompt, createdBy, tags);
+        record.versions.push(v);
+        record.activeVersion = v.version;
+        this.enforceMaxVersions(record);
+        this.config.onVersionCreated(v);
+        return v;
+    }
+    getVersion(promptId, version) {
+        const record = this.prompts.get(promptId);
+        if (!record)
+            return null;
+        if (!version) {
+            return record.versions.find((v) => v.version === record.activeVersion) ?? null;
+        }
+        return record.versions.find((v) => v.version === version) ?? null;
+    }
+    listVersions(promptId) {
+        return this.get(promptId)?.versions ?? [];
+    }
+    diff(promptId, from, to) {
+        const record = this.prompts.get(promptId);
+        if (!record)
+            return null;
+        const fromV = record.versions.find((v) => v.version === from);
+        const toV = record.versions.find((v) => v.version === to);
+        if (!fromV || !toV)
+            return null;
+        const fromLines = fromV.prompt.split("\n");
+        const toLines = toV.prompt.split("\n");
+        const fromSet = new Set(fromLines);
+        const toSet = new Set(toLines);
+        const addedLines = toLines.filter((l) => !fromSet.has(l));
+        const removedLines = fromLines.filter((l) => !toSet.has(l));
+        return {
+            from,
+            to,
+            added: addedLines.length,
+            removed: removedLines.length,
+            addedLines: addedLines.slice(0, 20),
+            removedLines: removedLines.slice(0, 20),
+        };
+    }
+    rollback(promptId, targetVersion) {
+        const record = this.prompts.get(promptId);
+        if (!record)
+            return null;
+        const target = record.versions.find((v) => v.version === targetVersion);
+        if (!target)
+            return null;
+        const previous = record.activeVersion;
+        record.activeVersion = targetVersion;
+        return {
+            promptId,
+            rolledBackTo: targetVersion,
+            currentVersion: record.activeVersion,
+            previousVersion: previous,
+        };
+    }
+    delete(promptId) {
+        if (!this.config.allowDelete)
+            return false;
+        return this.prompts.delete(promptId);
+    }
+    listPrompts() {
+        return [...this.prompts.values()];
+    }
+    getStats(promptId) {
+        const r = this.prompts.get(promptId);
+        return r ? { versionCount: r.versions.length, activeVersion: r.activeVersion } : null;
+    }
+    makeVersion(prompt, createdBy, tags) {
+        const version = `v${Date.now()}-${++_counter}`;
+        const v = {
+            version,
+            prompt,
+            createdAt: new Date().toISOString(),
+            createdBy,
+            tags,
+        };
+        return v;
+    }
+    enforceMaxVersions(record) {
+        while (record.versions.length > this.config.maxVersions) {
+            const oldest = record.versions[0];
+            if (oldest.version === record.activeVersion)
+                break;
+            record.versions.shift();
+        }
+    }
+    get(promptId) {
+        return this.prompts.get(promptId);
+    }
+    getOrThrow(promptId) {
+        const r = this.prompts.get(promptId);
+        if (!r)
+            throw new Error(`Prompt not found: ${promptId}`);
+        return r;
+    }
+}
+//# sourceMappingURL=versioning.js.map

package/packages/prompt-versioning/dist/versioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.js","sourceRoot":"","sources":["../src/versioning.ts"],"names":[],"mappings":"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"}

package/packages/prompt-versioning/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@pi/prompt-versioning",
+  "version": "0.9.6",
+  "type": "module",
+  "description": "Version control for prompts with rollback support (RFC-0019)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "bun-types": "^1.0.0"
+  }
+}

package/packages/prompt-versioning/src/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Prompt Versioning — Main Entry (RFC-0019)
+ */
+
+export { PromptVersioning } from "./versioning.js";
+export type * from "./types.js";

package/packages/prompt-versioning/src/types.ts

@@ -0,0 +1,41 @@
+/**
+ * Prompt Versioning — Types (RFC-0019)
+ */
+
+export interface PromptVersion {
+	version: string;
+	prompt: string;
+	createdAt: string;
+	createdBy?: string;
+	tags?: string[];
+	metadata?: Record<string, string>;
+}
+
+export interface PromptRecord {
+	id: string;
+	name: string;
+	versions: PromptVersion[];
+	activeVersion: string;
+}
+
+export interface VersionDiff {
+	from: string;
+	to: string;
+	added: number;
+	removed: number;
+	addedLines: string[];
+	removedLines: string[];
+}
+
+export interface RollbackResult {
+	promptId: string;
+	rolledBackTo: string;
+	currentVersion: string;
+	previousVersion: string;
+}
+
+export interface PromptVersioningConfig {
+	maxVersions?: number;
+	allowDelete?: boolean;
+	onVersionCreated?: (v: PromptVersion) => void;
+}

package/packages/prompt-versioning/src/versioning.ts

@@ -0,0 +1,149 @@
+/**
+ * Prompt Versioning — Core (RFC-0019)
+ */
+
+import type {
+	PromptVersion,
+	PromptRecord,
+	VersionDiff,
+	RollbackResult,
+	PromptVersioningConfig,
+} from "./types.js";
+
+let _counter = 0;
+function nextId(): string {
+	return `pv-${Date.now()}-${++_counter}`;
+}
+
+export class PromptVersioning {
+	private prompts = new Map<string, PromptRecord>();
+	private config: Required<PromptVersioningConfig>;
+
+	constructor(config: PromptVersioningConfig = {}) {
+		this.config = {
+			maxVersions: config.maxVersions ?? 50,
+			allowDelete: config.allowDelete ?? false,
+			onVersionCreated: config.onVersionCreated ?? (() => {}),
+		};
+	}
+
+	createPrompt(name: string, initialPrompt: string, createdBy?: string): PromptRecord {
+		const v = this.makeVersion(initialPrompt, createdBy);
+		const record: PromptRecord = {
+			id: nextId(),
+			name,
+			versions: [v],
+			activeVersion: v.version,
+		};
+		this.prompts.set(record.id, record);
+		return record;
+	}
+
+	addVersion(promptId: string, prompt: string, createdBy?: string, tags?: string[]): PromptVersion {
+		const record = this.getOrThrow(promptId);
+		const v = this.makeVersion(prompt, createdBy, tags);
+		record.versions.push(v);
+		record.activeVersion = v.version;
+		this.enforceMaxVersions(record);
+		this.config.onVersionCreated(v);
+		return v;
+	}
+
+	getVersion(promptId: string, version?: string): PromptVersion | null {
+		const record = this.prompts.get(promptId);
+		if (!record) return null;
+		if (!version) {
+			return record.versions.find((v) => v.version === record.activeVersion) ?? null;
+		}
+		return record.versions.find((v) => v.version === version) ?? null;
+	}
+
+	listVersions(promptId: string): PromptVersion[] {
+		return this.get(promptId)?.versions ?? [];
+	}
+
+	diff(promptId: string, from: string, to: string): VersionDiff | null {
+		const record = this.prompts.get(promptId);
+		if (!record) return null;
+		const fromV = record.versions.find((v) => v.version === from);
+		const toV = record.versions.find((v) => v.version === to);
+		if (!fromV || !toV) return null;
+
+		const fromLines = fromV.prompt.split("\n");
+		const toLines = toV.prompt.split("\n");
+		const fromSet = new Set(fromLines);
+		const toSet = new Set(toLines);
+
+		const addedLines = toLines.filter((l) => !fromSet.has(l));
+		const removedLines = fromLines.filter((l) => !toSet.has(l));
+
+		return {
+			from,
+			to,
+			added: addedLines.length,
+			removed: removedLines.length,
+			addedLines: addedLines.slice(0, 20),
+			removedLines: removedLines.slice(0, 20),
+		};
+	}
+
+	rollback(promptId: string, targetVersion: string): RollbackResult | null {
+		const record = this.prompts.get(promptId);
+		if (!record) return null;
+		const target = record.versions.find((v) => v.version === targetVersion);
+		if (!target) return null;
+
+		const previous = record.activeVersion;
+		record.activeVersion = targetVersion;
+		return {
+			promptId,
+			rolledBackTo: targetVersion,
+			currentVersion: record.activeVersion,
+			previousVersion: previous,
+		};
+	}
+
+	delete(promptId: string): boolean {
+		if (!this.config.allowDelete) return false;
+		return this.prompts.delete(promptId);
+	}
+
+	listPrompts(): PromptRecord[] {
+		return [...this.prompts.values()];
+	}
+
+	getStats(promptId: string): { versionCount: number; activeVersion: string } | null {
+		const r = this.prompts.get(promptId);
+		return r ? { versionCount: r.versions.length, activeVersion: r.activeVersion } : null;
+	}
+
+	private makeVersion(prompt: string, createdBy?: string, tags?: string[]): PromptVersion {
+		const version = `v${Date.now()}-${++_counter}`;
+		const v: PromptVersion = {
+			version,
+			prompt,
+			createdAt: new Date().toISOString(),
+			createdBy,
+			tags,
+		};
+		return v;
+	}
+
+	private enforceMaxVersions(record: PromptRecord): void {
+		while (record.versions.length > this.config.maxVersions) {
+			const oldest = record.versions[0];
+			if (oldest.version === record.activeVersion) break;
+			record.versions.shift();
+		}
+	}
+
+	private get(promptId: string): PromptRecord | undefined {
+		return this.prompts.get(promptId);
+	}
+
+	private getOrThrow(promptId: string): PromptRecord {
+		const r = this.prompts.get(promptId);
+		if (!r) throw new Error(`Prompt not found: ${promptId}`);
+		return r;
+	}
+}

package/packages/prompt-versioning/test/versioning.test.ts

@@ -0,0 +1,112 @@
+/**
+ * Prompt Versioning Tests (RFC-0019)
+ */
+
+import { describe, it, expect, beforeEach } from "bun:test";
+import { PromptVersioning } from "../src/index.js";
+
+describe("PromptVersioning", () => {
+  let pv: PromptVersioning;
+
+  beforeEach(() => { pv = new PromptVersioning(); });
+
+  it("creates a prompt with initial version", () => {
+    const record = pv.createPrompt("login-prompt", "Hello {{name}}");
+    expect(record.name).toBe("login-prompt");
+    expect(record.versions).toHaveLength(1);
+    expect(record.activeVersion).toBe(record.versions[0].version);
+  });
+
+  it("addVersion creates a new version", () => {
+    const record = pv.createPrompt("greet", "Hi {{name}}");
+    const v2 = pv.addVersion(record.id, "Hello {{name}}");
+    expect(v2.version).not.toBe(record.versions[0].version);
+    expect(record.versions).toHaveLength(2);
+    expect(record.activeVersion).toBe(v2.version);
+  });
+
+  it("getVersion returns correct version", () => {
+    const record = pv.createPrompt("test", "v1");
+    const v2 = pv.addVersion(record.id, "v2");
+    const found = pv.getVersion(record.id, v2.version);
+    expect(found?.prompt).toBe("v2");
+  });
+
+  it("getVersion returns active when no version specified", () => {
+    const record = pv.createPrompt("test", "v1");
+    pv.addVersion(record.id, "v2");
+    const found = pv.getVersion(record.id);
+    expect(found?.prompt).toBe("v2");
+  });
+
+  it("listVersions returns all versions", () => {
+    const record = pv.createPrompt("test", "v1");
+    pv.addVersion(record.id, "v2");
+    pv.addVersion(record.id, "v3");
+    const versions = pv.listVersions(record.id);
+    expect(versions).toHaveLength(3);
+  });
+
+  it("diff shows added and removed lines", () => {
+    const record = pv.createPrompt("test", "line1\nline2\nline3");
+    pv.addVersion(record.id, "line1\nnewLine\nline3");
+    const d = pv.diff(record.id, record.versions[0].version, record.versions[1].version);
+    expect(d).not.toBeNull();
+    expect(d!.added).toBe(1);
+    expect(d!.removed).toBe(1);
+  });
+
+  it("rollback reverts to previous version", () => {
+    const record = pv.createPrompt("test", "v1");
+    const v2 = pv.addVersion(record.id, "v2");
+    const result = pv.rollback(record.id, record.versions[0].version);
+    expect(result?.rolledBackTo).toBe(record.versions[0].version);
+    expect(result?.previousVersion).toBe(v2.version);
+  });
+
+  it("rollback returns null for unknown version", () => {
+    const record = pv.createPrompt("test", "v1");
+    const result = pv.rollback(record.id, "nonexistent");
+    expect(result).toBeNull();
+  });
+
+  it("delete removes prompt when allowed", () => {
+    pv = new PromptVersioning({ allowDelete: true });
+    const record = pv.createPrompt("test", "content");
+    expect(pv.delete(record.id)).toBe(true);
+    expect(pv.getVersion(record.id)).toBeNull();
+  });
+
+  it("delete returns false when not allowed", () => {
+    const record = pv.createPrompt("test", "content");
+    expect(pv.delete(record.id)).toBe(false);
+  });
+
+  it("enforces maxVersions", () => {
+    pv = new PromptVersioning({ maxVersions: 3 });
+    const record = pv.createPrompt("test", "v1");
+    for (let i = 2; i <= 10; i++) pv.addVersion(record.id, `v${i}`);
+    expect(record.versions).toHaveLength(3);
+  });
+
+  it("getStats returns correct stats", () => {
+    const record = pv.createPrompt("test", "v1");
+    pv.addVersion(record.id, "v2");
+    const stats = pv.getStats(record.id);
+    expect(stats?.versionCount).toBe(2);
+  });
+
+  it("getStats returns null for unknown prompt", () => {
+    expect(pv.getStats("nonexistent")).toBeNull();
+  });
+
+  it("listPrompts returns all prompts", () => {
+    pv.createPrompt("a", "content a");
+    pv.createPrompt("b", "content b");
+    expect(pv.listPrompts()).toHaveLength(2);
+  });
+
+  it("throws for unknown promptId on addVersion", () => {
+    expect(() => pv.addVersion("nonexistent", "content")).toThrow();
+  });
+});

package/packages/prompt-versioning/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": { "outDir": "dist", "rootDir": "src" },
+  "include": ["src/**/*"]
+}

package/packages/provider-adapter-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/provider-adapter-sdk",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "SDK for building, testing, and registering AI provider adapters",
   "type": "module",
   "main": "./dist/index.js",

package/packages/provider-router/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/provider-router",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "Enhanced Provider Router for pi-harness-runtime — intelligent routing with capabilities, costs, and quotas",
   "type": "module",
   "main": "./dist/provider-router.js",

package/packages/provider-selector/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Provider Selector — Main Entry (RFC-0012)
+ */
+export { selectProvider, rank, compareCost, compareLatency, filterByCapability, filterByRegion, } from "./selector.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/provider-selector/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,cAAc,EACd,IAAI,EACJ,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,cAAc,GACd,MAAM,eAAe,CAAC;AACvB,mBAAmB,YAAY,CAAC"}

package/packages/provider-selector/dist/index.js

@@ -0,0 +1,5 @@
+/**
+ * Provider Selector — Main Entry (RFC-0012)
+ */
+export { selectProvider, rank, compareCost, compareLatency, filterByCapability, filterByRegion, } from "./selector.js";
+//# sourceMappingURL=index.js.map

package/packages/provider-selector/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,cAAc,EACd,IAAI,EACJ,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,cAAc,GACd,MAAM,eAAe,CAAC"}

package/packages/provider-selector/dist/selector.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Provider Selector — multi-criteria provider ranking and selection (RFC-0012)
+ */
+import type { Provider, SelectionCriteria, SelectionResult } from "./types.js";
+/** Select the best provider based on criteria. */
+export declare function selectProvider(providers: Provider[], criteria?: SelectionCriteria): SelectionResult | null;
+/** Rank all providers by score. */
+export declare function rank(providers: Provider[], criteria?: SelectionCriteria): Provider[];
+/** Compare two providers by cost. Returns negative if a is cheaper. */
+export declare function compareCost(a: Provider, b: Provider): number;
+/** Compare two providers by latency. Returns negative if a is faster. */
+export declare function compareLatency(a: Provider, b: Provider): number;
+/** Filter providers by capability. */
+export declare function filterByCapability(providers: Provider[], capability: Provider["capabilities"][number]): Provider[];
+/** Filter providers by region. */
+export declare function filterByRegion(providers: Provider[], region: Provider["region"]): Provider[];
+//# sourceMappingURL=selector.d.ts.map

package/packages/provider-selector/dist/selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../src/selector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAoD/E,kDAAkD;AAClD,wBAAgB,cAAc,CAC7B,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,GAAE,iBAA8B,GACtC,eAAe,GAAG,IAAI,CAkBxB;AAED,mCAAmC;AACnC,wBAAgB,IAAI,CACnB,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,GAAE,iBAA8B,GACtC,QAAQ,EAAE,CAMZ;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAI5D;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAE/D;AAED,sCAAsC;AACtC,wBAAgB,kBAAkB,CACjC,SAAS,EAAE,QAAQ,EAAE,EACrB,UAAU,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,GAC1C,QAAQ,EAAE,CAEZ;AAED,kCAAkC;AAClC,wBAAgB,cAAc,CAC7B,SAAS,EAAE,QAAQ,EAAE,EACrB,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GACxB,QAAQ,EAAE,CAGZ"}