pi-harness-runtime 1.1.398 → 1.1.402

package/packages/autonomous-runtime/dist/worker.js

@@ -1,133 +0,0 @@
-/**
- * Worker Stub — RFC-0101 §4
- *
- * A worker is a pi session that owns tasks from the inbox.
- * This is the lightweight worker-side of the lease protocol.
- *
- * The worker picks up work via the inbox's `claim()` method
- * and reports results via `complete()`.
- */
-/**
- * Worker — picks up tasks from the inbox and processes them.
- *
- * Lifecycle:
- * 1. Construct with inbox + workerId
- * 2. `start()` — begins polling/claiming tasks
- * 3. `stop()` — stops claiming, expires held leases
- *
- * The worker does NOT run tasks itself — it delegates to the harness
- * loop runtime. It just manages the lease lifecycle.
- */
-export class Worker {
-    config;
-    events = {};
-    running = false;
-    heartbeatTimer = null;
-    constructor(config) {
-        this.config = {
-            heartbeatIntervalMs: 30_000,
-            ...config,
-        };
-    }
-    on(event, handler) {
-        this.events[event] = handler;
-    }
-    /**
-     * Start the worker — begins polling for available tasks.
-     */
-    async start() {
-        if (this.running)
-            return;
-        this.running = true;
-        // Start heartbeat
-        this.heartbeatTimer = setInterval(() => this._heartbeat(), this.config.heartbeatIntervalMs);
-        // Claim any immediately available tasks
-        await this._poll();
-    }
-    /**
-     * Stop the worker — stops polling and expires any held leases.
-     */
-    async stop() {
-        if (!this.running)
-            return;
-        this.running = false;
-        if (this.heartbeatTimer) {
-            clearInterval(this.heartbeatTimer);
-            this.heartbeatTimer = null;
-        }
-        // Expire all leases held by this worker
-        // (inbox.expireLease is idempotent — safe to call repeatedly)
-    }
-    /**
-     * Status of this worker.
-     */
-    status() {
-        return {
-            workerId: this.config.workerId,
-            running: this.running,
-            heartbeatIntervalMs: this.config.heartbeatIntervalMs ?? 30_000,
-        };
-    }
-    async _poll() {
-        if (!this.running)
-            return;
-        try {
-            // Try to claim one task
-            const lease = await this.config.inbox.claim({
-                workerId: this.config.workerId,
-                heartbeatIntervalMs: this.config.heartbeatIntervalMs ?? 30_000,
-            });
-            if (lease) {
-                this.events.onLease?.(lease);
-                await this._processTask(lease);
-            }
-        }
-        catch (err) {
-            this.config.onError?.("__poll__", err);
-        }
-    }
-    async _processTask(lease) {
-        const task = lease.task;
-        try {
-            // Delegate to harness loop runtime (stub — will be wired in Phase 2)
-            const result = await this._runTask(task);
-            // Report completion
-            await this.config.inbox.complete(lease.taskId, result);
-            this.events.onComplete?.(lease.taskId, result);
-        }
-        catch (err) {
-            this.events.onError?.(lease.taskId, err);
-            await this.config.inbox.complete(lease.taskId, {
-                ok: false,
-                error: String(err),
-                completedAt: new Date().toISOString(),
-            });
-        }
-        // Continue polling for more work
-        if (this.running)
-            void this._poll();
-    }
-    /**
-     * Run a single task. Stub — replaces with actual harness loop integration.
-     */
-    async _runTask(task) {
-        // TODO(Phase 2): Wire to harness loop runtime
-        // For now, return a stub result so the lease protocol works end-to-end.
-        return {
-            ok: true,
-            summary: `[stub] Processed ${task.id}`,
-            completedAt: new Date().toISOString(),
-        };
-    }
-    async _heartbeat() {
-        // Refresh leases held by this worker
-        // The inbox tracks which leases this worker holds and refreshes them.
-        try {
-            await this.config.inbox.refreshLeases(this.config.workerId);
-        }
-        catch {
-            // Non-fatal — lease will expire naturally
-        }
-    }
-}
-//# sourceMappingURL=worker.js.map

package/packages/capability-registry/src/types.d.ts

@@ -1,47 +0,0 @@
-/**
- * Capability Registry Types (RFC-0051)
- */
-export type Capability = "code_generation" | "code_review" | "planning" | "test_generation" | "e2e_testing" | "refactoring" | "analysis" | "debugging" | "documentation" | "vision" | "function_calling" | "json_mode" | "streaming";
-export type Latency = "fast" | "medium" | "slow";
-export interface CapabilityProfile {
-    capability: Capability;
-    score: number;
-    latency: Latency;
-    contextWindow: number;
-    maxOutputTokens: number;
-}
-export interface CapabilityQuery {
-    minScore?: number;
-    maxLatency?: Latency;
-    requiresContextWindow?: number;
-    requiresMaxOutput?: number;
-}
-export interface ModelWithCapability {
-    providerId: string;
-    modelId: string;
-    profile: CapabilityProfile;
-}
-export interface CapabilityRegistry {
-    register(providerId: string, modelId: string, capabilities: CapabilityProfile[]): void;
-    unregister(providerId: string, modelId: string): void;
-    getCapabilities(providerId: string, modelId: string): CapabilityProfile[];
-    query(capability: Capability, requirements?: CapabilityQuery): ModelWithCapability[];
-    listProviders(): string[];
-    listModels(providerId: string): string[];
-}
-export type CapabilityRegistryEvent = {
-    type: "capability.registered";
-    providerId: string;
-    modelId: string;
-    count: number;
-} | {
-    type: "capability.unregistered";
-    providerId: string;
-    modelId: string;
-} | {
-    type: "capability.queried";
-    capability: Capability;
-    results: number;
-};
-export declare const LATENCY_RANK: Record<Latency, number>;
-//# sourceMappingURL=types.d.ts.map

package/packages/clipboard/dist/clipboard.d.ts

@@ -1,11 +0,0 @@
-/**
- * Clipboard — System clipboard integration
- */
-import type { ClipboardOptions } from "./types.js";
-/** Write text to system clipboard. */
-export declare function copy(text: string, _options?: ClipboardOptions): Promise<void>;
-/** Read text from system clipboard. */
-export declare function read(): Promise<string>;
-/** Copy the last assistant message from session service. */
-export declare function copyLastResponse(_sessionApi: unknown, _options?: ClipboardOptions): Promise<void>;
-//# sourceMappingURL=clipboard.d.ts.map

package/packages/clipboard/dist/clipboard.js

@@ -1,40 +0,0 @@
-/**
- * Clipboard — System clipboard integration
- */
-import { writeFileSync, readFileSync } from "node:fs";
-/** Write text to system clipboard. */
-export async function copy(text, _options) {
-    try {
-        // Linux: prefer xclip, fall back to /dev/clipboard
-        const { execSync } = require("node:child_process");
-        try {
-            execSync(`echo '${text.replace(/'/g, "'\"'\"'")}' | xclip -selection clipboard`, { stdio: "ignore" });
-        }
-        catch {
-            writeFileSync("/dev/clipboard", text);
-        }
-    }
-    catch {
-        // Silently fail if clipboard unavailable
-    }
-}
-/** Read text from system clipboard. */
-export async function read() {
-    try {
-        const { execSync } = require("node:child_process");
-        return execSync("xclip -selection clipboard -o", { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
-    }
-    catch {
-        try {
-            return readFileSync("/dev/clipboard", "utf8");
-        }
-        catch {
-            return "";
-        }
-    }
-}
-/** Copy the last assistant message from session service. */
-export async function copyLastResponse(_sessionApi, _options) {
-    await copy("[session-api not yet integrated]", _options);
-}
-//# sourceMappingURL=clipboard.js.map

package/packages/clipboard/dist/index.d.ts

@@ -1,2 +0,0 @@
-export type { ClipboardContent, ClipboardOptions } from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/packages/clipboard/dist/index.js

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

package/packages/clipboard/dist/types.d.ts

@@ -1,13 +0,0 @@
-/**
- * Clipboard — Types
- */
-export interface ClipboardContent {
-    text: string;
-    html?: string;
-    source?: string;
-}
-export interface ClipboardOptions {
-    notify?: boolean;
-    format?: "text" | "html";
-}
-//# sourceMappingURL=types.d.ts.map

package/packages/clipboard/dist/types.js

@@ -1,5 +0,0 @@
-/**
- * Clipboard — Types
- */
-export {};
-//# sourceMappingURL=types.js.map

package/packages/context-discovery/dist/discover.d.ts

@@ -1,3 +0,0 @@
-import type { ContextCandidate, DiscoveryOptions } from "./types.js";
-export declare function discoverContext(root: string, options?: Omit<DiscoveryOptions, "root">): ContextCandidate[];
-//# sourceMappingURL=discover.d.ts.map

package/packages/context-discovery/dist/discover.js

@@ -1,42 +0,0 @@
-import { readdirSync, readFileSync } from "node:fs";
-import { join, extname } from "node:path";
-const CODE_EXTS = new Set([".ts", ".tsx", ".js", ".jsx", ".py", ".go", ".rs", ".java"]);
-function estimateTokens(text) {
-    return Math.ceil(text.length / 4);
-}
-function scanDir(dir, limit) {
-    const results = [];
-    try {
-        for (const entry of readdirSync(dir, { withFileTypes: true })) {
-            if (results.length >= limit)
-                break;
-            const full = join(dir, entry.name);
-            if (entry.isDirectory() && !entry.name.startsWith(".") && entry.name !== "node_modules") {
-                results.push(...scanDir(full, limit - results.length));
-            }
-            else if (entry.isFile() && CODE_EXTS.has(extname(entry.name))) {
-                try {
-                    const content = readFileSync(full, "utf8").slice(0, 8000);
-                    results.push({
-                        id: full,
-                        kind: "source",
-                        path: full,
-                        title: entry.name,
-                        content,
-                        tokens: estimateTokens(content),
-                        trust: "high",
-                        tags: [extname(entry.name).replace(".", "")],
-                    });
-                }
-                catch { /* skip unreadable */ }
-            }
-        }
-    }
-    catch { /* skip inaccessible */ }
-    return results;
-}
-export function discoverContext(root, options = {}) {
-    const limit = options.limit ?? 50;
-    return scanDir(root, limit);
-}
-//# sourceMappingURL=discover.js.map

package/packages/context-discovery/dist/discovery.d.ts

@@ -1,28 +0,0 @@
-/**
- * Context Discovery — Orchestrates context collection
- */
-interface DiscoveredContext {
-    intent: unknown;
-    workspace: unknown;
-    dependencies: unknown;
-    knowledge: unknown;
-    files: string[];
-    estimatedTokens: number;
-}
-interface DiscoveryOptions {
-    rootPath: string;
-    task: string;
-    intent?: unknown;
-    maximumTokens?: number;
-}
-interface DiscoveryResult {
-    context: DiscoveredContext;
-    discovered: unknown[];
-    omitted: unknown[];
-    estimatedTokens: number;
-}
-export declare class ContextDiscovery {
-    discover(options: DiscoveryOptions): Promise<DiscoveryResult>;
-}
-export {};
-//# sourceMappingURL=discovery.d.ts.map

package/packages/context-discovery/dist/discovery.js

@@ -1,21 +0,0 @@
-/**
- * Context Discovery — Orchestrates context collection
- */
-export class ContextDiscovery {
-    async discover(options) {
-        return {
-            context: {
-                intent: options.intent ?? null,
-                workspace: null,
-                dependencies: null,
-                knowledge: null,
-                files: [],
-                estimatedTokens: 0,
-            },
-            discovered: [],
-            omitted: [],
-            estimatedTokens: 0,
-        };
-    }
-}
-//# sourceMappingURL=discovery.js.map

package/packages/context-discovery/dist/index.d.ts

@@ -1,3 +0,0 @@
-export type { ContextCandidate, DiscoveryOptions } from "./types.js";
-export { discoverContext } from "./discover.js";
-//# sourceMappingURL=index.d.ts.map

package/packages/context-discovery/dist/index.js

@@ -1,2 +0,0 @@
-export { discoverContext } from "./discover.js";
-//# sourceMappingURL=index.js.map

package/packages/context-discovery/dist/types.d.ts

@@ -1,16 +0,0 @@
-export interface ContextCandidate {
-    id: string;
-    kind: "source" | "doc" | "okf" | "skill" | "test" | "config";
-    path: string;
-    title: string;
-    content: string;
-    tokens: number;
-    trust: "high" | "medium" | "low";
-    tags: string[];
-}
-export interface DiscoveryOptions {
-    root: string;
-    task?: string;
-    limit?: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/packages/context-discovery/dist/types.js

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

package/packages/event-bus/dist/bus.d.ts

@@ -1,15 +0,0 @@
-/**
- * Event Bus — pub/sub implementation
- */
-import type { Subscriber, Subscription, EventPayload } from "./types.js";
-export declare class EventBus {
-    private readonly subs;
-    private readonly byTopic;
-    publish<T>(topic: string, data: T, source?: string): string;
-    subscribe<T>(topic: string, subscriber: Subscriber<T>, filter?: (data: T) => boolean, priority?: number): string;
-    unsubscribe(subscriptionId: string): void;
-    unsubscribeAll(topic?: string): void;
-    replay(topic: string, events: EventPayload<unknown>[]): void;
-    getSubscribers(topic?: string): Subscription[];
-}
-//# sourceMappingURL=bus.d.ts.map

package/packages/event-bus/dist/bus.js

@@ -1,90 +0,0 @@
-/**
- * Event Bus — pub/sub implementation
- */
-import { randomUUID } from "node:crypto";
-export class EventBus {
-    subs = new Map();
-    byTopic = new Map();
-    publish(topic, data, source = "system") {
-        const eventId = randomUUID();
-        const timestamp = new Date().toISOString();
-        const payload = { topic, data, timestamp, eventId, source };
-        const topicIds = this.byTopic.get(topic) ?? new Set();
-        const wildcardIds = this.byTopic.get("*") ?? new Set();
-        const matches = [];
-        for (const sid of [...topicIds, ...wildcardIds]) {
-            const sub = this.subs.get(sid);
-            if (!sub || !sub.active)
-                continue;
-            if (sub.filter && !sub.filter(data))
-                continue;
-            matches.push({ sub, payload });
-        }
-        matches.sort((a, b) => b.sub.priority - a.sub.priority);
-        for (const { sub } of matches) {
-            try {
-                sub.subscriber(payload);
-            }
-            catch {
-                sub.active = false;
-                this.subs.delete(sub.id);
-                this.byTopic.get(sub.topic)?.delete(sub.id);
-            }
-        }
-        return eventId;
-    }
-    subscribe(topic, subscriber, filter, priority = 0) {
-        const id = randomUUID();
-        const sub = {
-            id,
-            topic,
-            subscriber: subscriber,
-            filter: filter,
-            priority,
-            active: true,
-        };
-        this.subs.set(id, sub);
-        if (!this.byTopic.has(topic))
-            this.byTopic.set(topic, new Set());
-        this.byTopic.get(topic).add(id);
-        return id;
-    }
-    unsubscribe(subscriptionId) {
-        const sub = this.subs.get(subscriptionId);
-        if (!sub)
-            return;
-        sub.active = false;
-        this.subs.delete(subscriptionId);
-        this.byTopic.get(sub.topic)?.delete(subscriptionId);
-    }
-    unsubscribeAll(topic) {
-        if (topic) {
-            const ids = this.byTopic.get(topic);
-            if (ids) {
-                for (const id of ids)
-                    this.unsubscribe(id);
-                this.byTopic.delete(topic);
-            }
-        }
-        else {
-            for (const id of this.subs.keys())
-                this.unsubscribe(id);
-            this.byTopic.clear();
-        }
-    }
-    replay(topic, events) {
-        for (const event of events) {
-            if (event.topic === topic || topic === "*") {
-                this.publish(event.topic, event.data, event.source);
-            }
-        }
-    }
-    getSubscribers(topic) {
-        if (topic) {
-            const ids = this.byTopic.get(topic) ?? new Set();
-            return [...ids].map((id) => this.subs.get(id)).filter((s) => s !== undefined);
-        }
-        return [...this.subs.values()].filter((s) => s.active);
-    }
-}
-//# sourceMappingURL=bus.js.map

package/packages/event-bus/dist/index.d.ts

@@ -1,4 +0,0 @@
-export { EventBus } from "./bus.js";
-export { EventBusError } from "./types.js";
-export type { Topic, EventPayload, Subscriber, Subscription, BusOptions } from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/packages/event-bus/dist/index.js

@@ -1,3 +0,0 @@
-export { EventBus } from "./bus.js";
-export { EventBusError } from "./types.js";
-//# sourceMappingURL=index.js.map

package/packages/event-bus/dist/test/bus.test.js

@@ -1,52 +0,0 @@
-import { describe, it } from "node:test";
-import { equal, deepEqual } from "node:assert";
-import { EventBus } from "../src/bus.js";
-describe("EventBus", () => {
-    const bus = new EventBus();
-    it("publish returns eventId", () => {
-        const id = bus.publish("test.topic", { msg: "hello" });
-        equal(typeof id, "string");
-        equal(id.length > 0, true);
-    });
-    it("subscriber receives event", () => {
-        let received = null;
-        bus.subscribe("test.1", (p) => { received = p; });
-        bus.publish("test.1", { data: "hello" });
-        equal(received.data, "hello");
-    });
-    it("multiple subscribers all called", () => {
-        const calls = [];
-        bus.subscribe("test.2", () => { calls.push(1); });
-        bus.subscribe("test.2", () => { calls.push(2); });
-        bus.publish("test.2", { x: 1 });
-        deepEqual(calls, [1, 2]);
-    });
-    it("unsubscribe stops notifications", () => {
-        let called = false;
-        const id = bus.subscribe("test.3", () => { called = true; });
-        bus.unsubscribe(id);
-        bus.publish("test.3", {});
-        equal(called, false);
-    });
-    it("filter predicates work", () => {
-        let called = false;
-        bus.subscribe("test.4", () => { called = true; }, (d) => d.ok === true);
-        bus.publish("test.4", { ok: false });
-        equal(called, false);
-        bus.publish("test.4", { ok: true });
-        equal(called, true);
-    });
-    it("priority ordering respected", () => {
-        const order = [];
-        bus.subscribe("test.5", () => { order.push(1); }, undefined, 1);
-        bus.subscribe("test.5", () => { order.push(2); }, undefined, 2);
-        bus.publish("test.5", {});
-        deepEqual(order, [2, 1]); // higher priority first
-    });
-    it("unsubscribeAll(topic) removes all for topic", () => {
-        bus.subscribe("test.6", () => { });
-        bus.subscribe("test.6", () => { });
-        bus.unsubscribeAll("test.6");
-        equal(bus.getSubscribers("test.6").length, 0);
-    });
-});

package/packages/event-bus/dist/types.d.ts

@@ -1,27 +0,0 @@
-/**
- * Event Bus — Types
- */
-export type Topic = "session.message" | "session.assistant_start" | "session.assistant_end" | "session.tool_start" | "session.tool_end" | "session.checkpoint" | "session.compact" | "task.assigned" | "task.started" | "task.completed" | "task.failed" | "review.requested" | "review.completed" | "decision.made" | "approval.requested" | "approval.granted" | "workflow.started" | "workflow.finished" | "knowledge.extracted" | "system.quota_exceeded" | "system.checkpoint_saved" | "system.error";
-export interface EventPayload<T = unknown> {
-    topic: string;
-    data: T;
-    timestamp: string;
-    eventId: string;
-    source: string;
-}
-export type Subscriber<T = unknown> = (payload: EventPayload<T>) => void | Promise<void>;
-export interface Subscription {
-    id: string;
-    topic: string;
-    subscriber: Subscriber<unknown>;
-    filter?: (data: unknown) => boolean;
-    priority: number;
-    active: boolean;
-}
-export interface BusOptions {
-    deliveryGuarantee?: "at_least_once" | "at_most_once" | "exactly_once";
-}
-export declare class EventBusError extends Error {
-    constructor(message: string);
-}
-//# sourceMappingURL=types.d.ts.map

package/packages/event-bus/dist/types.js

@@ -1,10 +0,0 @@
-/**
- * Event Bus — Types
- */
-export class EventBusError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = "EventBusError";
-    }
-}
-//# sourceMappingURL=types.js.map

package/packages/event-store/dist/index.d.ts

@@ -1,3 +0,0 @@
-export { EventStore } from "./store.js";
-export type { SessionEvent, SessionEventType, EventMetadata, StoreOptions, StoreStats, WriteResult, ReadOptions, SearchOptions } from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/packages/event-store/dist/index.js

@@ -1,2 +0,0 @@
-export { EventStore } from "./store.js";
-//# sourceMappingURL=index.js.map

package/packages/event-store/dist/store.d.ts

@@ -1,15 +0,0 @@
-/**
- * Event Store — JSONL-backed immutable event store
- */
-import type { SessionEvent, WriteResult, ReadOptions, SearchOptions, StoreOptions, StoreStats } from "./types.js";
-export declare class EventStore {
-    private readonly sessionsDir;
-    constructor(opts?: StoreOptions);
-    getPath(sessionId: string): string;
-    append(event: Omit<SessionEvent, "id" | "timestamp">): Promise<WriteResult>;
-    read(opts?: ReadOptions): Promise<SessionEvent[]>;
-    search(opts: SearchOptions): Promise<SessionEvent[]>;
-    stats(sessionId: string): StoreStats;
-    list(): string[];
-}
-//# sourceMappingURL=store.d.ts.map