@pickle-pee/runtime 0.0.0

package/dist/test/task-validator.test.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const task_validator_js_1 = require("../subagent/task-validator.js");
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeTask(overrides) {
+    return {
+        taskId: "task-001",
+        goal: "Implement feature X",
+        scope: {
+            allowedPaths: ["packages/app-runtime/**"],
+            forbiddenPaths: ["packages/app-ui/**"],
+        },
+        inputs: { docs: [], files: [], assumptions: [] },
+        deliverables: ["code"],
+        verification: [{ name: "build", type: "command", command: "npm run build", description: "Build passes" }],
+        stopConditions: [{ type: "boundary_violation", description: "Stop on boundary violation" }],
+        ...overrides,
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)("TaskValidator", () => {
+    (0, vitest_1.describe)("validateTask", () => {
+        (0, vitest_1.it)("accepts a valid task", () => {
+            const result = (0, task_validator_js_1.validateTask)(makeTask());
+            (0, vitest_1.expect)(result.valid).toBe(true);
+            (0, vitest_1.expect)(result.errors).toHaveLength(0);
+        });
+        (0, vitest_1.it)("rejects task without taskId", () => {
+            const result = (0, task_validator_js_1.validateTask)(makeTask({ taskId: "" }));
+            (0, vitest_1.expect)(result.valid).toBe(false);
+            (0, vitest_1.expect)(result.errors).toContain("taskId must be non-empty");
+        });
+        (0, vitest_1.it)("rejects task with whitespace-only taskId", () => {
+            const result = (0, task_validator_js_1.validateTask)(makeTask({ taskId: "   " }));
+            (0, vitest_1.expect)(result.valid).toBe(false);
+        });
+        (0, vitest_1.it)("rejects task without goal", () => {
+            const result = (0, task_validator_js_1.validateTask)(makeTask({ goal: "" }));
+            (0, vitest_1.expect)(result.valid).toBe(false);
+            (0, vitest_1.expect)(result.errors).toContain("goal must be non-empty");
+        });
+        (0, vitest_1.it)("rejects task without allowedPaths", () => {
+            const result = (0, task_validator_js_1.validateTask)(makeTask({ scope: { allowedPaths: [], forbiddenPaths: [] } }));
+            (0, vitest_1.expect)(result.valid).toBe(false);
+            (0, vitest_1.expect)(result.errors.some((e) => e.includes("allowedPaths"))).toBe(true);
+        });
+        (0, vitest_1.it)("rejects task without verification", () => {
+            const result = (0, task_validator_js_1.validateTask)(makeTask({ verification: [] }));
+            (0, vitest_1.expect)(result.valid).toBe(false);
+            (0, vitest_1.expect)(result.errors.some((e) => e.includes("verification"))).toBe(true);
+        });
+        (0, vitest_1.it)("rejects task without stopConditions", () => {
+            const result = (0, task_validator_js_1.validateTask)(makeTask({ stopConditions: [] }));
+            (0, vitest_1.expect)(result.valid).toBe(false);
+            (0, vitest_1.expect)(result.errors.some((e) => e.includes("stopConditions"))).toBe(true);
+        });
+        (0, vitest_1.it)("collects multiple errors at once", () => {
+            const result = (0, task_validator_js_1.validateTask)(makeTask({ taskId: "", goal: "", verification: [], stopConditions: [] }));
+            (0, vitest_1.expect)(result.valid).toBe(false);
+            (0, vitest_1.expect)(result.errors.length).toBeGreaterThanOrEqual(4);
+        });
+    });
+    (0, vitest_1.describe)("hasRequiredFields", () => {
+        (0, vitest_1.it)("returns valid for complete task", () => {
+            const result = (0, task_validator_js_1.hasRequiredFields)(makeTask());
+            (0, vitest_1.expect)(result.valid).toBe(true);
+        });
+        (0, vitest_1.it)("lists missing field names", () => {
+            const result = (0, task_validator_js_1.hasRequiredFields)(makeTask({ taskId: "", verification: [] }));
+            (0, vitest_1.expect)(result.valid).toBe(false);
+            (0, vitest_1.expect)(result.errors).toContain("taskId");
+            (0, vitest_1.expect)(result.errors).toContain("verification");
+        });
+    });
+    (0, vitest_1.describe)("hasConsistentScope", () => {
+        (0, vitest_1.it)("returns valid for non-overlapping scope", () => {
+            const scope = {
+                allowedPaths: ["packages/a/**"],
+                forbiddenPaths: ["packages/b/**"],
+            };
+            (0, vitest_1.expect)((0, task_validator_js_1.hasConsistentScope)(scope).valid).toBe(true);
+        });
+        (0, vitest_1.it)("detects overlapping scope", () => {
+            const scope = {
+                allowedPaths: ["packages/a/**"],
+                forbiddenPaths: ["packages/a/**"],
+            };
+            (0, vitest_1.expect)((0, task_validator_js_1.hasConsistentScope)(scope).valid).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=task-validator.test.js.map

package/dist/test/task-validator.test.js.map

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

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

@@ -0,0 +1 @@
+export {};

package/dist/test/tool-governor.test.js

@@ -0,0 +1,379 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const tool_governor_js_1 = require("../governance/tool-governor.js");
+// ---------------------------------------------------------------------------
+// Test helpers
+// ---------------------------------------------------------------------------
+function makeToolDef(overrides = {}) {
+    return {
+        identity: {
+            name: "test_tool",
+            category: "file-read",
+        },
+        contract: {
+            parameterSchema: { type: "object", properties: {} },
+            output: { type: "text" },
+            errorTypes: [],
+        },
+        policy: {
+            riskLevel: "L0",
+            readOnly: true,
+            concurrency: "unlimited",
+            confirmation: "never",
+            subAgentAllowed: true,
+            timeoutMs: 0,
+        },
+        executorTag: "test_tool",
+        ...overrides,
+    };
+}
+const L0_READ = makeToolDef();
+const L2_EDIT = makeToolDef({
+    identity: { name: "edit", category: "file-mutation" },
+    policy: {
+        riskLevel: "L2",
+        readOnly: false,
+        concurrency: "per_target",
+        confirmation: "on_write",
+        subAgentAllowed: true,
+        timeoutMs: 30_000,
+    },
+    executorTag: "edit",
+});
+const L3_BASH = makeToolDef({
+    identity: { name: "bash", category: "command-execution" },
+    policy: {
+        riskLevel: "L3",
+        readOnly: false,
+        concurrency: "unlimited",
+        confirmation: "always",
+        subAgentAllowed: false,
+        timeoutMs: 120_000,
+    },
+    executorTag: "bash",
+});
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)("ToolGovernor", () => {
+    function executionContext(overrides = {}) {
+        return {
+            sessionId: "session-1",
+            toolName: "test_tool",
+            toolCallId: "call_1",
+            workingDirectory: "/project",
+            sessionMode: "interactive",
+            isSubAgent: false,
+            ...overrides,
+        };
+    }
+    (0, vitest_1.describe)("beforeExecution", () => {
+        (0, vitest_1.it)("allows a registered L0 tool", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L0_READ);
+            const decision = governor.beforeExecution(executionContext());
+            (0, vitest_1.expect)(decision.type).toBe("allow");
+        });
+        (0, vitest_1.it)("denies an unregistered tool", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            const decision = governor.beforeExecution(executionContext({ toolName: "unknown_tool" }));
+            (0, vitest_1.expect)(decision.type).toBe("deny");
+            if (decision.type === "deny") {
+                (0, vitest_1.expect)(decision.reason).toContain("not registered");
+            }
+        });
+        (0, vitest_1.it)("returns ask_user for L2 tool without prior approval", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L2_EDIT);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "edit",
+                targetPath: "/project/src/main.ts",
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("ask_user");
+            if (decision.type === "ask_user") {
+                (0, vitest_1.expect)(decision.riskLevel).toBe("L2");
+            }
+        });
+        (0, vitest_1.it)("denies when mutation queue has conflict for per_target tool", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L2_EDIT);
+            // First call: approve via session approval
+            governor.recordSessionApproval({
+                sessionId: "session-1",
+                toolName: "edit",
+                riskLevel: "L2",
+                targetPattern: "/project/src/main.ts",
+                verdict: "allow_for_session",
+                grantedAt: Date.now(),
+            });
+            // First execution: accepted
+            const first = governor.beforeExecution(executionContext({
+                toolName: "edit",
+                toolCallId: "call_1",
+                targetPath: "/project/src/main.ts",
+            }));
+            (0, vitest_1.expect)(first.type).toBe("allow");
+            // Second execution to same file: conflict
+            const second = governor.beforeExecution(executionContext({
+                toolName: "edit",
+                toolCallId: "call_2",
+                targetPath: "/project/src/main.ts",
+            }));
+            (0, vitest_1.expect)(second.type).toBe("deny");
+            if (second.type === "deny") {
+                (0, vitest_1.expect)(second.reason).toContain("already being mutated");
+            }
+        });
+        (0, vitest_1.it)("denies sub-agent restricted tool", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L3_BASH);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "bash",
+                isSubAgent: true,
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("deny");
+        });
+        (0, vitest_1.it)("mentions outside-cwd paths using the real working directory", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L2_EDIT);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "edit",
+                targetPath: "/etc/passwd",
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("ask_user");
+            if (decision.type === "ask_user") {
+                (0, vitest_1.expect)(decision.reason).toContain("outside working directory");
+            }
+        });
+        (0, vitest_1.it)("escalates destructive commands to L4 before permission evaluation", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L3_BASH);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "bash",
+                parameters: { command: "rm -rf /tmp/danger" },
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("deny");
+            if (decision.type === "deny") {
+                (0, vitest_1.expect)(decision.riskLevel).toBe("L4");
+            }
+        });
+        (0, vitest_1.it)("auto-allows read-only pwd commands for bash", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L3_BASH);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "bash",
+                parameters: { command: "pwd -P" },
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("allow");
+        });
+        (0, vitest_1.it)("auto-allows read-only ls commands for bash", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L3_BASH);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "bash",
+                parameters: { command: "ls -lah src" },
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("allow");
+        });
+        (0, vitest_1.it)("auto-allows cat for bash", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L3_BASH);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "bash",
+                toolCallId: "call_cat",
+                parameters: { command: "cat README.md" },
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("allow");
+        });
+        (0, vitest_1.it)("auto-allows head for bash", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L3_BASH);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "bash",
+                toolCallId: "call_head",
+                parameters: { command: "head -n 10 README.md" },
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("allow");
+        });
+        (0, vitest_1.it)("auto-allows tail for bash", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L3_BASH);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "bash",
+                toolCallId: "call_tail",
+                parameters: { command: 'tail -f "logs/app.log"' },
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("allow");
+        });
+        (0, vitest_1.it)("auto-allows wc for bash", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L3_BASH);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "bash",
+                toolCallId: "call_wc",
+                parameters: { command: "wc -l src/index.ts" },
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("allow");
+        });
+        (0, vitest_1.it)("auto-allows grep for bash", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L3_BASH);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "bash",
+                toolCallId: "call_grep",
+                parameters: { command: 'grep -n "Genesis CLI" README.md' },
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("allow");
+        });
+        (0, vitest_1.it)("auto-allows rg for bash", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L3_BASH);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "bash",
+                toolCallId: "call_rg",
+                parameters: { command: 'rg -n --glob "*.ts" "createToolGovernor" packages' },
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("allow");
+        });
+        (0, vitest_1.it)("auto-allows find for bash", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L3_BASH);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "bash",
+                toolCallId: "call_find",
+                parameters: { command: 'find . -name "*.ts" -type f' },
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("allow");
+        });
+        (0, vitest_1.it)("auto-allows fd for bash", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L3_BASH);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "bash",
+                toolCallId: "call_fd",
+                parameters: { command: 'fd -t f "governor" packages' },
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("allow");
+        });
+        (0, vitest_1.it)("still asks for non-allowlisted bash commands", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L3_BASH);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "bash",
+                parameters: { command: "echo hello" },
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("ask_user");
+        });
+        (0, vitest_1.it)("still asks for risky rg forms even though rg is readonly by default", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L3_BASH);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "bash",
+                toolCallId: "call_rg_risky",
+                parameters: { command: 'rg --pre "bash" foo' },
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("ask_user");
+        });
+        (0, vitest_1.it)("still asks for risky find forms", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L3_BASH);
+            const decision = governor.beforeExecution(executionContext({
+                toolName: "bash",
+                toolCallId: "call_find_risky",
+                parameters: { command: 'find . -name "*.ts" -delete' },
+            }));
+            (0, vitest_1.expect)(decision.type).toBe("ask_user");
+        });
+    });
+    (0, vitest_1.describe)("afterExecution", () => {
+        (0, vitest_1.it)("records in audit log", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L0_READ);
+            governor.beforeExecution(executionContext());
+            governor.afterExecution({
+                toolName: "test_tool",
+                toolCallId: "call_1",
+                status: "success",
+                durationMs: 100,
+            });
+            (0, vitest_1.expect)(governor.audit.size).toBe(1);
+            const entries = governor.audit.getByTool("test_tool");
+            (0, vitest_1.expect)(entries).toHaveLength(1);
+            (0, vitest_1.expect)(entries[0].status).toBe("success");
+            (0, vitest_1.expect)(entries[0].toolCallId).toBe("call_1");
+        });
+        (0, vitest_1.it)("releases mutation queue entry for per_target tool", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L2_EDIT);
+            governor.recordSessionApproval({
+                sessionId: "session-1",
+                toolName: "edit",
+                riskLevel: "L2",
+                targetPattern: "/project/src/main.ts",
+                verdict: "allow_for_session",
+                grantedAt: Date.now(),
+            });
+            // First execution
+            governor.beforeExecution(executionContext({
+                toolName: "edit",
+                toolCallId: "call_1",
+                targetPath: "/project/src/main.ts",
+            }));
+            (0, vitest_1.expect)(governor.mutations.isPending("/project/src/main.ts")).toBe(true);
+            // Complete the first execution
+            governor.afterExecution({
+                toolName: "edit",
+                toolCallId: "call_1",
+                status: "success",
+                durationMs: 100,
+            });
+            (0, vitest_1.expect)(governor.mutations.isPending("/project/src/main.ts")).toBe(false);
+            // Second execution should now succeed
+            const second = governor.beforeExecution(executionContext({
+                toolName: "edit",
+                toolCallId: "call_2",
+                targetPath: "/project/src/main.ts",
+            }));
+            (0, vitest_1.expect)(second.type).toBe("allow");
+        });
+    });
+    (0, vitest_1.describe)("recordSessionApproval", () => {
+        (0, vitest_1.it)("enables subsequent allow for L2 tool", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            governor.catalog.register(L2_EDIT);
+            // Without approval: ask_user
+            const first = governor.beforeExecution(executionContext({
+                toolName: "edit",
+                targetPath: "/project/src/main.ts",
+            }));
+            (0, vitest_1.expect)(first.type).toBe("ask_user");
+            // Record approval
+            governor.recordSessionApproval({
+                sessionId: "session-1",
+                toolName: "edit",
+                riskLevel: "L2",
+                targetPattern: "/project/src/main.ts",
+                verdict: "allow_for_session",
+                grantedAt: Date.now(),
+            });
+            // With approval: allow
+            const second = governor.beforeExecution(executionContext({
+                toolName: "edit",
+                toolCallId: "call_2",
+                targetPath: "/project/src/main.ts",
+            }));
+            (0, vitest_1.expect)(second.type).toBe("allow");
+        });
+    });
+    (0, vitest_1.describe)("governance components", () => {
+        (0, vitest_1.it)("exposes catalog, permissions, mutations, and audit", () => {
+            const governor = (0, tool_governor_js_1.createToolGovernor)();
+            (0, vitest_1.expect)(governor.catalog).toBeDefined();
+            (0, vitest_1.expect)(governor.permissions).toBeDefined();
+            (0, vitest_1.expect)(governor.mutations).toBeDefined();
+            (0, vitest_1.expect)(governor.audit).toBeDefined();
+        });
+    });
+});
+//# sourceMappingURL=tool-governor.test.js.map

package/dist/test/tool-governor.test.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Core type definitions for the product-layer runtime.
+ *
+ * All public types consumed by app-tools, app-ui, app-extensions,
+ * app-evaluation, and app-cli are defined here.
+ */
+/** Determines how input is received and output is formatted. All modes share the same runtime. */
+export type CliMode = "interactive" | "print" | "json" | "rpc";
+/** Branded session identifier for type-safe session references. */
+export interface SessionId {
+    readonly value: string;
+}
+export type SessionStatus = "creating" | "active" | "suspended" | "recovering" | "closing" | "closed";
+/** Describes the active LLM model for a session. */
+export interface ModelDescriptor {
+    readonly id: string;
+    readonly provider: string;
+    readonly displayName?: string;
+}
+/** Set of enabled tool names. ReadonlySet ensures immutability at the type level. */
+export type ToolSetDescriptor = ReadonlySet<string>;
+export type TaskStatus = "idle" | "running" | "paused" | "completed" | "failed";
+export interface TaskState {
+    readonly status: TaskStatus;
+    readonly currentTaskId: string | null;
+    readonly startedAt: number | null;
+}
+/** Summary of the most recent context compaction operation. */
+export interface CompactionSummary {
+    readonly compressedAt: number;
+    readonly originalMessageCount: number;
+    readonly retainedMessageCount: number;
+    readonly estimatedTokensSaved: number;
+}
+export type { PlanOutcomeReason, PlanStatus, PlanStep, PlanStepDetail, PlanStepStatus, PlanSummary, } from "../planning/plan-types.js";
+import type { PlanSummary as _PlanSummary } from "../planning/plan-types.js";
+export interface SessionState {
+    readonly id: SessionId;
+    readonly status: SessionStatus;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly model: ModelDescriptor;
+    readonly toolSet: ToolSetDescriptor;
+    readonly planSummary: _PlanSummary | null;
+    readonly compactionSummary: CompactionSummary | null;
+    readonly taskState: TaskState;
+}
+/**
+ * Serializable snapshot used to persist and restore a session.
+ *
+ * Uses `readonly string[]` for the tool set instead of `ReadonlySet`
+ * so that the payload can round-trip through `JSON.stringify`.
+ */
+export interface SessionRecoveryData {
+    readonly sessionId: SessionId;
+    readonly model: ModelDescriptor;
+    readonly toolSet: readonly string[];
+    readonly planSummary: _PlanSummary | null;
+    readonly compactionSummary: CompactionSummary | null;
+    readonly taskState: TaskState;
+    readonly workingDirectory?: string;
+    readonly sessionFile?: string;
+    readonly agentDir?: string;
+}
+export interface RuntimeContext {
+    readonly sessionId: SessionId;
+    readonly workingDirectory: string;
+    readonly agentDir?: string;
+    readonly configSources?: Readonly<Record<string, {
+        layer: string;
+        detail: string;
+    }>>;
+    readonly mode: CliMode;
+    readonly model: ModelDescriptor;
+    readonly toolSet: ToolSetDescriptor;
+    readonly taskState: TaskState;
+}

package/dist/types/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Core type definitions for the product-layer runtime.
+ *
+ * All public types consumed by app-tools, app-ui, app-extensions,
+ * app-evaluation, and app-cli are defined here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@pickle-pee/runtime",
+  "version": "0.0.0",
+  "description": "Product-layer runtime: session facade, plan execution, event normalization",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "node -e \"const fs = require('node:fs'); fs.rmSync('dist', { recursive: true, force: true }); fs.rmSync('tsconfig.build.tsbuildinfo', { force: true });\" && tsc -p tsconfig.build.json",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@pickle-pee/kernel": "0.0.0",
+    "@pickle-pee/tools": "0.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}