@pickle-pee/runtime 0.0.0

package/dist/create-app-runtime.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * The single entry point for creating the product-layer runtime.
+ *
+ * `createAppRuntime()` initializes the runtime with configuration, model,
+ * tool set, and adapter provisioning. All four CLI modes (interactive,
+ * print, json, rpc) use the same factory and the same AppRuntime interface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAppRuntime = createAppRuntime;
+const event_bus_js_1 = require("./events/event-bus.js");
+const tool_governor_js_1 = require("./governance/tool-governor.js");
+const plan_engine_js_1 = require("./planning/plan-engine.js");
+const runtime_context_js_1 = require("./runtime-context.js");
+const session_events_js_1 = require("./session/session-events.js");
+const session_facade_js_1 = require("./session/session-facade.js");
+const session_state_js_1 = require("./session/session-state.js");
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+function createAppRuntime(config) {
+    const globalBus = (0, event_bus_js_1.createEventBus)();
+    const governor = (0, tool_governor_js_1.createToolGovernor)();
+    const planEngine = (0, plan_engine_js_1.createPlanEngine)();
+    const toolSet = new Set(config.toolSet ?? []);
+    registerBuiltinToolDefinitions(governor, toolSet);
+    const sessions = new Set();
+    let shutdown = false;
+    let staticAdapterClaimed = false;
+    function assertNotShutdown() {
+        if (shutdown) {
+            throw new Error("Runtime has been shut down");
+        }
+    }
+    function getAdapter() {
+        if (config.createAdapter) {
+            return config.createAdapter();
+        }
+        if (config.adapter) {
+            if (staticAdapterClaimed) {
+                throw new Error("AppRuntimeConfig.adapter can only back a single session. Use createAdapter() to provision a fresh adapter per session.");
+            }
+            staticAdapterClaimed = true;
+            return config.adapter;
+        }
+        throw new Error("No KernelSessionAdapter provided. Pass adapter for a single session or createAdapter for multi-session runtimes.");
+    }
+    return {
+        get events() {
+            return globalBus;
+        },
+        get governor() {
+            return governor;
+        },
+        get planEngine() {
+            return planEngine;
+        },
+        createSession() {
+            assertNotShutdown();
+            const sessionId = { value: crypto.randomUUID() };
+            const state = (0, session_state_js_1.createInitialSessionState)(sessionId, config.model, toolSet);
+            const context = (0, runtime_context_js_1.createRuntimeContext)({
+                sessionId,
+                workingDirectory: config.workingDirectory,
+                agentDir: config.agentDir,
+                configSources: config.configSources,
+                mode: config.mode,
+                model: config.model,
+                toolSet,
+            });
+            const facade = new session_facade_js_1.SessionFacadeImpl(getAdapter(), state, context, globalBus, governor, planEngine);
+            // Emit session_created on the global bus
+            const event = (0, session_events_js_1.sessionCreated)(sessionId, config.model, [...toolSet]);
+            globalBus.emit(event);
+            sessions.add(facade);
+            return facade;
+        },
+        recoverSession(data) {
+            assertNotShutdown();
+            const state = (0, session_state_js_1.recoverSessionState)(data);
+            const context = (0, runtime_context_js_1.createRuntimeContext)({
+                sessionId: data.sessionId,
+                workingDirectory: config.workingDirectory,
+                agentDir: data.agentDir ?? config.agentDir,
+                configSources: config.configSources,
+                mode: config.mode,
+                model: data.model,
+                toolSet: new Set(data.toolSet),
+            });
+            const adapter = getAdapter();
+            // Tell the adapter about the recovery so it can restore its own state.
+            adapter.resume(data);
+            const facade = new session_facade_js_1.SessionFacadeImpl(adapter, state, context, globalBus, governor, planEngine);
+            // Emit session_resumed on the global bus
+            const event = (0, session_events_js_1.sessionResumed)(data.sessionId, data);
+            globalBus.emit(event);
+            sessions.add(facade);
+            return facade;
+        },
+        async shutdown() {
+            if (shutdown)
+                return;
+            shutdown = true;
+            // Close all active sessions
+            for (const session of sessions) {
+                try {
+                    await session.close();
+                }
+                catch {
+                    // Best-effort close during shutdown
+                }
+            }
+            sessions.clear();
+            globalBus.removeAllListeners();
+        },
+    };
+}
+function registerBuiltinToolDefinitions(governor, toolSet) {
+    for (const toolName of toolSet) {
+        const definition = builtinToolDefinition(toolName);
+        if (definition && !governor.catalog.has(toolName)) {
+            governor.catalog.register(definition);
+        }
+    }
+}
+function builtinToolDefinition(toolName) {
+    switch (toolName) {
+        case "read":
+            return makeBuiltinToolDefinition("read", "file-read", "L0", true, "never", "unlimited", 30_000);
+        case "grep":
+        case "find":
+        case "ls":
+            return makeBuiltinToolDefinition(toolName, "file-read", "L0", true, "never", "unlimited", 30_000);
+        case "write":
+            return makeBuiltinToolDefinition("write", "file-mutation", "L1", false, "always", "per_target", 30_000);
+        case "edit":
+            return makeBuiltinToolDefinition("edit", "file-mutation", "L2", false, "on_write", "per_target", 30_000);
+        case "bash":
+            return makeBuiltinToolDefinition("bash", "command-execution", "L3", false, "always", "unlimited", 120_000);
+        default:
+            return null;
+    }
+}
+function makeBuiltinToolDefinition(name, category, riskLevel, readOnly, confirmation, concurrency, timeoutMs) {
+    return {
+        identity: { name, category },
+        contract: {
+            parameterSchema: { type: "object", properties: {} },
+            output: { type: "text" },
+            errorTypes: [],
+        },
+        policy: {
+            riskLevel,
+            readOnly,
+            concurrency,
+            confirmation,
+            subAgentAllowed: true,
+            timeoutMs,
+        },
+        executorTag: name,
+    };
+}
+//# sourceMappingURL=create-app-runtime.js.map

package/dist/create-app-runtime.js.map

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

package/dist/domain/index.d.ts

@@ -0,0 +1 @@
+export type { CliMode, CompactionSummary, ModelDescriptor, PlanStatus, PlanStep, PlanSummary, RuntimeContext, SessionId, SessionRecoveryData, SessionState, SessionStatus, TaskState, TaskStatus, ToolSetDescriptor, } from "../types/index.js";

package/dist/domain/index.js

@@ -0,0 +1,5 @@
+"use strict";
+// domain/ — Pure domain models for session, plan, and event.
+// No dependencies on UI or external services.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/domain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,8CAA8C"}

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

@@ -0,0 +1,23 @@
+/**
+ * Typed event bus for the product-layer runtime.
+ *
+ * Enforces the RuntimeEvent contract: only standardized events can be emitted
+ * and consumed. No raw upstream events leak through.
+ */
+import type { RuntimeEvent } from "./runtime-event.js";
+export type Unsubscribe = () => void;
+export type EventListener<T extends RuntimeEvent = RuntimeEvent> = (event: T) => void;
+export interface EventBus {
+    /** Emit a standardized event to all matching listeners. */
+    emit(event: RuntimeEvent): void;
+    /** Subscribe to events of a specific `type`. Returns an unsubscribe function. */
+    on(type: string, listener: EventListener): Unsubscribe;
+    /** Subscribe to all events of a given `category`. Returns an unsubscribe function. */
+    onCategory(category: string, listener: EventListener): Unsubscribe;
+    /** Remove a specific type-level listener. */
+    off(type: string, listener: EventListener): void;
+    /** Remove all listeners. */
+    removeAllListeners(): void;
+    onAny(listener: EventListener): Unsubscribe;
+}
+export declare function createEventBus(): EventBus;

package/dist/events/event-bus.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Typed event bus for the product-layer runtime.
+ *
+ * Enforces the RuntimeEvent contract: only standardized events can be emitted
+ * and consumed. No raw upstream events leak through.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEventBus = createEventBus;
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+function createEventBus() {
+    const typeListeners = new Map();
+    const categoryListeners = new Map();
+    const anyListeners = new Set();
+    return {
+        emit(event) {
+            for (const listener of anyListeners) {
+                listener(event);
+            }
+            const typed = typeListeners.get(event.type);
+            if (typed) {
+                for (const listener of typed) {
+                    listener(event);
+                }
+            }
+            const categorized = categoryListeners.get(event.category);
+            if (categorized) {
+                for (const listener of categorized) {
+                    listener(event);
+                }
+            }
+        },
+        on(type, listener) {
+            let set = typeListeners.get(type);
+            if (!set) {
+                set = new Set();
+                typeListeners.set(type, set);
+            }
+            set.add(listener);
+            return () => {
+                set.delete(listener);
+                if (set.size === 0) {
+                    typeListeners.delete(type);
+                }
+            };
+        },
+        onCategory(category, listener) {
+            let set = categoryListeners.get(category);
+            if (!set) {
+                set = new Set();
+                categoryListeners.set(category, set);
+            }
+            set.add(listener);
+            return () => {
+                set.delete(listener);
+                if (set.size === 0) {
+                    categoryListeners.delete(category);
+                }
+            };
+        },
+        off(type, listener) {
+            const set = typeListeners.get(type);
+            if (set) {
+                set.delete(listener);
+                if (set.size === 0) {
+                    typeListeners.delete(type);
+                }
+            }
+        },
+        removeAllListeners() {
+            typeListeners.clear();
+            categoryListeners.clear();
+            anyListeners.clear();
+        },
+        onAny(listener) {
+            anyListeners.add(listener);
+            return () => {
+                anyListeners.delete(listener);
+            };
+        },
+    };
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/events/event-bus.js.map

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

package/dist/events/index.d.ts

@@ -0,0 +1,3 @@
+export type { EventBus, EventListener, Unsubscribe } from "./event-bus.js";
+export { createEventBus } from "./event-bus.js";
+export type { BaseEvent, CompactionCompletedEvent, CompactionEvent, CompactionStartedEvent, PermissionDecisionEvent, PermissionRequestedEvent, PermissionResolvedEvent, PlanCompletedEvent, PlanCreatedEvent, PlanProgressEvent, PlanStepCompletedEvent, PlanStepStartedEvent, RuntimeEvent, SessionClosedEvent, SessionClosingEvent, SessionCreatedEvent, SessionLifecycleEvent, SessionResumedEvent, SessionSuspendedEvent, TextDeltaEvent, TextStreamEvent, ThinkingDeltaEvent, ToolCompletedEvent, ToolDeniedEvent, ToolExecutionEvent, ToolStartedEvent, ToolUpdateEvent, } from "./runtime-event.js";

package/dist/events/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEventBus = void 0;
+var event_bus_js_1 = require("./event-bus.js");
+Object.defineProperty(exports, "createEventBus", { enumerable: true, get: function () { return event_bus_js_1.createEventBus; } });
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";;;AACA,+CAAgD;AAAvC,8GAAA,cAAc,OAAA"}

package/dist/events/runtime-event.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Standardized product-layer event taxonomy.
+ *
+ * All events consumed by UI, tools, and extensions must be one of these types.
+ * Raw upstream events from pi-mono are translated here by the EventNormalizer —
+ * they are never exposed directly.
+ *
+ * Events use a dual discriminant: `category` (broad area) and `type` (specific event).
+ * Consumers can filter at either granularity.
+ */
+import type { CompactionSummary, ModelDescriptor, PlanSummary, SessionId, SessionRecoveryData } from "../types/index.js";
+/** Fields shared by every product-layer event. */
+export interface BaseEvent {
+    readonly id: string;
+    readonly timestamp: number;
+    readonly sessionId: SessionId;
+}
+export interface SessionCreatedEvent extends BaseEvent {
+    readonly category: "session";
+    readonly type: "session_created";
+    readonly model: ModelDescriptor;
+    readonly toolSet: readonly string[];
+}
+export interface SessionResumedEvent extends BaseEvent {
+    readonly category: "session";
+    readonly type: "session_resumed";
+    readonly recoveryData: SessionRecoveryData;
+}
+export interface SessionSuspendedEvent extends BaseEvent {
+    readonly category: "session";
+    readonly type: "session_suspended";
+}
+export interface SessionClosingEvent extends BaseEvent {
+    readonly category: "session";
+    readonly type: "session_closing";
+}
+export interface SessionClosedEvent extends BaseEvent {
+    readonly category: "session";
+    readonly type: "session_closed";
+    readonly recoveryData: SessionRecoveryData;
+}
+export type SessionLifecycleEvent = SessionCreatedEvent | SessionResumedEvent | SessionSuspendedEvent | SessionClosingEvent | SessionClosedEvent;
+export interface ToolStartedEvent extends BaseEvent {
+    readonly category: "tool";
+    readonly type: "tool_started";
+    readonly toolName: string;
+    readonly toolCallId: string;
+    readonly parameters: Readonly<Record<string, unknown>>;
+}
+export interface ToolUpdateEvent extends BaseEvent {
+    readonly category: "tool";
+    readonly type: "tool_update";
+    readonly toolName: string;
+    readonly toolCallId: string;
+    readonly update: string;
+}
+export interface ToolCompletedEvent extends BaseEvent {
+    readonly category: "tool";
+    readonly type: "tool_completed";
+    readonly toolName: string;
+    readonly toolCallId: string;
+    readonly status: "success" | "failure";
+    readonly result?: string;
+    readonly durationMs: number;
+}
+export interface ToolDeniedEvent extends BaseEvent {
+    readonly category: "tool";
+    readonly type: "tool_denied";
+    readonly toolName: string;
+    readonly toolCallId: string;
+    readonly reason: string;
+}
+export type ToolExecutionEvent = ToolStartedEvent | ToolUpdateEvent | ToolCompletedEvent | ToolDeniedEvent;
+export interface PlanCreatedEvent extends BaseEvent {
+    readonly category: "plan";
+    readonly type: "plan_created";
+    readonly planId: string;
+    readonly goal: string;
+    readonly stepCount: number;
+}
+export interface PlanStepStartedEvent extends BaseEvent {
+    readonly category: "plan";
+    readonly type: "plan_step_started";
+    readonly planId: string;
+    readonly stepId: string;
+    readonly stepDescription: string;
+}
+export interface PlanStepCompletedEvent extends BaseEvent {
+    readonly category: "plan";
+    readonly type: "plan_step_completed";
+    readonly planId: string;
+    readonly stepId: string;
+    readonly success: boolean;
+}
+export interface PlanStepFailedEvent extends BaseEvent {
+    readonly category: "plan";
+    readonly type: "plan_step_failed";
+    readonly planId: string;
+    readonly stepId: string;
+    readonly reason: string;
+    readonly reworkScheduled: boolean;
+}
+export interface PlanReworkEvent extends BaseEvent {
+    readonly category: "plan";
+    readonly type: "plan_rework";
+    readonly planId: string;
+    readonly stepId: string;
+    readonly reworkAttempt: number;
+    readonly focusAreas: readonly string[];
+}
+export interface PlanCompletedEvent extends BaseEvent {
+    readonly category: "plan";
+    readonly type: "plan_completed";
+    readonly planId: string;
+    readonly goal: string;
+    readonly success: boolean;
+    readonly summary: PlanSummary;
+}
+export type PlanProgressEvent = PlanCreatedEvent | PlanStepStartedEvent | PlanStepCompletedEvent | PlanStepFailedEvent | PlanReworkEvent | PlanCompletedEvent;
+export interface CompactionStartedEvent extends BaseEvent {
+    readonly category: "compaction";
+    readonly type: "compaction_started";
+}
+export interface CompactionCompletedEvent extends BaseEvent {
+    readonly category: "compaction";
+    readonly type: "compaction_completed";
+    readonly summary: CompactionSummary;
+}
+export type CompactionEvent = CompactionStartedEvent | CompactionCompletedEvent;
+export interface PermissionRequestedEvent extends BaseEvent {
+    readonly category: "permission";
+    readonly type: "permission_requested";
+    readonly toolName: string;
+    readonly toolCallId: string;
+    readonly riskLevel: string;
+    readonly reason?: string;
+    readonly targetPath?: string;
+}
+export interface PermissionResolvedEvent extends BaseEvent {
+    readonly category: "permission";
+    readonly type: "permission_resolved";
+    readonly toolName: string;
+    readonly toolCallId: string;
+    readonly decision: "allow" | "allow_for_session" | "allow_once" | "deny";
+}
+export type PermissionDecisionEvent = PermissionRequestedEvent | PermissionResolvedEvent;
+export interface TextDeltaEvent extends BaseEvent {
+    readonly category: "text";
+    readonly type: "text_delta";
+    readonly content: string;
+}
+export interface ThinkingDeltaEvent extends BaseEvent {
+    readonly category: "text";
+    readonly type: "thinking_delta";
+    readonly content: string;
+}
+export type TextStreamEvent = TextDeltaEvent | ThinkingDeltaEvent;
+export type RuntimeEvent = SessionLifecycleEvent | ToolExecutionEvent | PlanProgressEvent | CompactionEvent | PermissionDecisionEvent | TextStreamEvent;

package/dist/events/runtime-event.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Standardized product-layer event taxonomy.
+ *
+ * All events consumed by UI, tools, and extensions must be one of these types.
+ * Raw upstream events from pi-mono are translated here by the EventNormalizer —
+ * they are never exposed directly.
+ *
+ * Events use a dual discriminant: `category` (broad area) and `type` (specific event).
+ * Consumers can filter at either granularity.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=runtime-event.js.map

package/dist/events/runtime-event.js.map

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

package/dist/governance/tool-governor.d.ts

@@ -0,0 +1,63 @@
+/**
+ * ToolGovernor — the runtime integration point for tool governance.
+ *
+ * Wraps ToolCatalog, PermissionEngine, MutationQueue, and AuditLog into a
+ * single object that the SessionFacade uses to enforce governance on every
+ * tool execution event. The governor is created once per AppRuntime and
+ * shared across all sessions.
+ *
+ * Lifecycle:
+ *   1. beforeExecution()  — called when a tool_starts event arrives
+ *   2. afterExecution()   — called when a tool_completed event arrives
+ *   3. recordSessionApproval() — called when user grants session approval
+ */
+import type { ApprovalCacheEntry, AuditLog, MutationQueue, PermissionEngine, RiskLevel, ToolCatalog } from "@pickle-pee/tools";
+/** Input for a pre-execution governance check. */
+export interface ToolExecutionContext {
+    readonly sessionId: string;
+    readonly toolName: string;
+    readonly toolCallId: string;
+    readonly workingDirectory: string;
+    readonly sessionMode: string;
+    readonly isSubAgent: boolean;
+    readonly targetPath?: string;
+    readonly commandDigest?: string;
+    readonly parameters?: Readonly<Record<string, unknown>>;
+}
+/** Input for a post-execution governance record. */
+export interface ToolExecutionResult {
+    readonly toolName: string;
+    readonly toolCallId: string;
+    readonly status: "success" | "failure";
+    readonly targetPath?: string;
+    readonly durationMs?: number;
+}
+/** Outcome of a pre-execution governance check. */
+export type GovernorDecision = {
+    readonly type: "allow";
+} | {
+    readonly type: "deny";
+    readonly reason: string;
+    readonly riskLevel: RiskLevel;
+} | {
+    readonly type: "ask_user";
+    readonly reason: string;
+    readonly riskLevel: RiskLevel;
+};
+export interface ToolGovernor {
+    /** Check whether a tool invocation is permitted before execution. */
+    beforeExecution(context: ToolExecutionContext): GovernorDecision;
+    /** Record the outcome of a tool invocation after execution. */
+    afterExecution(result: ToolExecutionResult): void;
+    /** Record a session-scoped user approval. */
+    recordSessionApproval(entry: ApprovalCacheEntry): void;
+    /** Tool catalog — callers may register tools or query definitions. */
+    readonly catalog: ToolCatalog;
+    /** Permission engine — direct access for advanced use. */
+    readonly permissions: PermissionEngine;
+    /** Mutation queue — direct access for advanced use. */
+    readonly mutations: MutationQueue;
+    /** Audit log — query past tool invocations. */
+    readonly audit: AuditLog;
+}
+export declare function createToolGovernor(): ToolGovernor;