create-principles-disciple 1.104.0 → 1.104.2

package/core/dist/evolution-store.test.js

@@ -0,0 +1,291 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { join } from 'path';
+import { mkdirSync, rmSync } from 'fs';
+import Database from 'better-sqlite3';
+import { listEvolutionTasks, getEvolutionTask, } from './evolution-store.js';
+describe('evolution-store', () => {
+    let tmpDir;
+    let stateDir;
+    beforeEach(() => {
+        tmpDir = join(process.cwd(), 'tmp-test-evolution-store-' + Date.now());
+        stateDir = join(tmpDir, '.state');
+        mkdirSync(stateDir, { recursive: true });
+    });
+    afterEach(() => {
+        try {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+        catch {
+            // Best-effort cleanup; ignore errors on tmp teardown.
+        }
+    });
+    function setupTestDb(dbPath) {
+        const db = new Database(dbPath);
+        db.exec(`
+      CREATE TABLE evolution_tasks (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        task_id TEXT UNIQUE NOT NULL,
+        trace_id TEXT NOT NULL,
+        source TEXT NOT NULL,
+        reason TEXT,
+        score INTEGER DEFAULT 0,
+        status TEXT DEFAULT 'pending',
+        enqueued_at TEXT,
+        started_at TEXT,
+        completed_at TEXT,
+        resolution TEXT,
+        task_kind TEXT,
+        priority TEXT,
+        retry_count INTEGER,
+        max_retries INTEGER,
+        last_error TEXT,
+        result_ref TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+    `);
+        const now = '2026-06-01T00:00:00.000Z';
+        db.prepare(`
+      INSERT INTO evolution_tasks (
+        task_id, trace_id, source, reason, score, status,
+        enqueued_at, started_at, completed_at, resolution,
+        task_kind, priority, retry_count, max_retries, last_error, result_ref,
+        created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run('task-001', 'trace-001', 'pain_signal', 'High pain detected', 85, 'completed', '2026-06-01T00:01:00.000Z', '2026-06-01T00:02:00.000Z', '2026-06-01T00:05:00.000Z', 'resolved', 'debugging', 'high', 0, 3, null, 'result-001', now, now);
+        db.prepare(`
+      INSERT INTO evolution_tasks (
+        task_id, trace_id, source, reason, score, status,
+        enqueued_at, started_at, completed_at, resolution,
+        task_kind, priority, retry_count, max_retries, last_error, result_ref,
+        created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run('task-002', 'trace-002', 'code_review', null, 42, 'pending', null, null, null, null, 'coding', 'low', 1, 5, 'timeout', null, '2026-06-02T00:00:00.000Z', '2026-06-02T00:00:00.000Z');
+        db.prepare(`
+      INSERT INTO evolution_tasks (
+        task_id, trace_id, source, reason, score, status,
+        enqueued_at, started_at, completed_at, resolution,
+        task_kind, priority, retry_count, max_retries, last_error, result_ref,
+        created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run('task-003', 'trace-003', 'manual', 'User reported issue', 0, 'failed', '2026-06-03T00:01:00.000Z', '2026-06-03T00:02:00.000Z', '2026-06-03T00:03:00.000Z', 'failed', 'reasoning', 'critical', 2, 2, 'max retries exceeded', null, '2026-06-03T00:00:00.000Z', '2026-06-03T00:00:00.000Z');
+        db.close();
+    }
+    describe('listEvolutionTasks', () => {
+        it('returns empty array when DB does not exist', () => {
+            const result = listEvolutionTasks(tmpDir);
+            expect(result).toEqual([]);
+        });
+        it('returns all tasks when no filters provided', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = listEvolutionTasks(tmpDir);
+            expect(result).toHaveLength(3);
+            expect(result[0]?.taskId).toBe('task-003');
+            expect(result[1]?.taskId).toBe('task-002');
+            expect(result[2]?.taskId).toBe('task-001');
+        });
+        it('filters by status', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const completed = listEvolutionTasks(tmpDir, { status: 'completed' });
+            expect(completed).toHaveLength(1);
+            expect(completed[0]?.taskId).toBe('task-001');
+            const pending = listEvolutionTasks(tmpDir, { status: 'pending' });
+            expect(pending).toHaveLength(1);
+            expect(pending[0]?.taskId).toBe('task-002');
+        });
+        it('filters by dateFrom', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = listEvolutionTasks(tmpDir, { dateFrom: '2026-06-02T00:00:00.000Z' });
+            expect(result).toHaveLength(2);
+            expect(result[0]?.taskId).toBe('task-003');
+            expect(result[1]?.taskId).toBe('task-002');
+        });
+        it('filters by dateTo', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = listEvolutionTasks(tmpDir, { dateTo: '2026-06-02T00:00:00.000Z' });
+            expect(result).toHaveLength(2);
+            expect(result[0]?.taskId).toBe('task-002');
+            expect(result[1]?.taskId).toBe('task-001');
+        });
+        it('filters by date range', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = listEvolutionTasks(tmpDir, {
+                dateFrom: '2026-06-01T12:00:00.000Z',
+                dateTo: '2026-06-02T12:00:00.000Z',
+            });
+            expect(result).toHaveLength(1);
+            expect(result[0]?.taskId).toBe('task-002');
+        });
+        it('respects limit', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = listEvolutionTasks(tmpDir, { limit: 2 });
+            expect(result).toHaveLength(2);
+            expect(result[0]?.taskId).toBe('task-003');
+            expect(result[1]?.taskId).toBe('task-002');
+        });
+        it('respects offset', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = listEvolutionTasks(tmpDir, { offset: 1 });
+            expect(result).toHaveLength(2);
+            expect(result[0]?.taskId).toBe('task-002');
+            expect(result[1]?.taskId).toBe('task-001');
+        });
+        it('combines limit and offset for pagination', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const page1 = listEvolutionTasks(tmpDir, { limit: 2, offset: 0 });
+            const page2 = listEvolutionTasks(tmpDir, { limit: 2, offset: 2 });
+            expect(page1).toHaveLength(2);
+            expect(page2).toHaveLength(1);
+            expect(page1[0]?.taskId).toBe('task-003');
+            expect(page2[0]?.taskId).toBe('task-001');
+        });
+        it('applies status filter with limit and offset', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = listEvolutionTasks(tmpDir, {
+                status: 'completed',
+                limit: 1,
+                offset: 0,
+            });
+            expect(result).toHaveLength(1);
+            expect(result[0]?.status).toBe('completed');
+        });
+        it('returns empty array when status matches nothing', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = listEvolutionTasks(tmpDir, { status: 'nonexistent' });
+            expect(result).toEqual([]);
+        });
+        it('maps all fields correctly from DB rows', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = listEvolutionTasks(tmpDir, { status: 'completed' });
+            expect(result).toHaveLength(1);
+            const task = result[0];
+            expect(task.id).toBe(1);
+            expect(task.taskId).toBe('task-001');
+            expect(task.traceId).toBe('trace-001');
+            expect(task.source).toBe('pain_signal');
+            expect(task.reason).toBe('High pain detected');
+            expect(task.score).toBe(85);
+            expect(task.status).toBe('completed');
+            expect(task.enqueuedAt).toBe('2026-06-01T00:01:00.000Z');
+            expect(task.startedAt).toBe('2026-06-01T00:02:00.000Z');
+            expect(task.completedAt).toBe('2026-06-01T00:05:00.000Z');
+            expect(task.resolution).toBe('resolved');
+            expect(task.taskKind).toBe('debugging');
+            expect(task.priority).toBe('high');
+            expect(task.retryCount).toBe(0);
+            expect(task.maxRetries).toBe(3);
+            expect(task.lastError).toBeNull();
+            expect(task.resultRef).toBe('result-001');
+            expect(task.createdAt).toBe('2026-06-01T00:00:00.000Z');
+            expect(task.updatedAt).toBe('2026-06-01T00:00:00.000Z');
+        });
+        it('handles NULL fields correctly', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = listEvolutionTasks(tmpDir, { status: 'pending' });
+            expect(result).toHaveLength(1);
+            const task = result[0];
+            expect(task.reason).toBeNull();
+            expect(task.enqueuedAt).toBeNull();
+            expect(task.startedAt).toBeNull();
+            expect(task.completedAt).toBeNull();
+            expect(task.resolution).toBeNull();
+            expect(task.resultRef).toBeNull();
+            expect(task.lastError).toBe('timeout');
+        });
+        it('orders by created_at DESC by default', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = listEvolutionTasks(tmpDir);
+            expect(result).toHaveLength(3);
+            const dates = result.map(r => r.createdAt);
+            expect(dates[0] > dates[1]).toBe(true);
+            expect(dates[1] > dates[2]).toBe(true);
+        });
+        it('throws when table does not exist in DB', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            const db = new Database(dbPath);
+            db.exec('CREATE TABLE some_other_table (id INTEGER PRIMARY KEY)');
+            db.close();
+            expect(() => listEvolutionTasks(tmpDir)).toThrow(/no such table/);
+        });
+    });
+    describe('getEvolutionTask', () => {
+        it('returns null when DB does not exist', () => {
+            const result = getEvolutionTask(tmpDir, 'task-001');
+            expect(result).toBeNull();
+        });
+        it('returns task by numeric id', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = getEvolutionTask(tmpDir, 1);
+            expect(result).not.toBeNull();
+            expect(result?.taskId).toBe('task-001');
+        });
+        it('returns task by string taskId', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = getEvolutionTask(tmpDir, 'task-002');
+            expect(result).not.toBeNull();
+            expect(result?.taskId).toBe('task-002');
+            expect(result?.source).toBe('code_review');
+        });
+        it('returns null when task not found by taskId', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = getEvolutionTask(tmpDir, 'nonexistent-task');
+            expect(result).toBeNull();
+        });
+        it('returns null when numeric id not found', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = getEvolutionTask(tmpDir, 999);
+            expect(result).toBeNull();
+        });
+        it('maps all fields correctly when getting by taskId', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const task = getEvolutionTask(tmpDir, 'task-003');
+            expect(task).not.toBeNull();
+            if (!task)
+                return;
+            expect(task.id).toBe(3);
+            expect(task.taskId).toBe('task-003');
+            expect(task.traceId).toBe('trace-003');
+            expect(task.source).toBe('manual');
+            expect(task.reason).toBe('User reported issue');
+            expect(task.score).toBe(0);
+            expect(task.status).toBe('failed');
+            expect(task.taskKind).toBe('reasoning');
+            expect(task.priority).toBe('critical');
+            expect(task.retryCount).toBe(2);
+            expect(task.maxRetries).toBe(2);
+            expect(task.lastError).toBe('max retries exceeded');
+        });
+        it('throws when table does not exist in DB', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            const db = new Database(dbPath);
+            db.exec('CREATE TABLE some_other_table (id INTEGER PRIMARY KEY)');
+            db.close();
+            expect(() => getEvolutionTask(tmpDir, 'task-001')).toThrow(/no such table/);
+        });
+        it('handles empty string taskId', () => {
+            const dbPath = join(stateDir, '.trajectory.db');
+            setupTestDb(dbPath);
+            const result = getEvolutionTask(tmpDir, '');
+            expect(result).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=evolution-store.test.js.map

package/core/dist/evolution-store.test.js.map

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

package/core/dist/host/__tests__/host-adapter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=host-adapter.test.d.ts.map

package/core/dist/host/__tests__/host-adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-adapter.test.d.ts","sourceRoot":"","sources":["../../../src/host/__tests__/host-adapter.test.ts"],"names":[],"mappings":""}

package/core/dist/host/__tests__/host-adapter.test.js

@@ -0,0 +1,96 @@
+/**
+ * Host adapter type guard tests (ADR-0020 §2.2)
+ *
+ * Verifies the pure type guards correctly discriminate valid/invalid inputs.
+ * These tests live in principles-core because the type guards are pure logic
+ * (no I/O). The actual CodexHooksHostAdapter implementation has its own
+ * tests in packages/codex-adapter/.
+ */
+import { describe, it, expect } from 'vitest';
+import { HOST_EVENT_KINDS, isHostEventKind, isHostDecision, isHostEventContext, isHostEvent, isHostEventResult, } from '../index.js';
+describe('HostAdapter type guards (ADR-0020)', () => {
+    describe('isHostEventKind', () => {
+        it('accepts all canonical kinds', () => {
+            for (const kind of HOST_EVENT_KINDS) {
+                expect(isHostEventKind(kind)).toBe(true);
+            }
+        });
+        it.each([[''], ['unknown'], ['BeforeToolCall'], ['pre_tool_use'], [42], [null], [undefined]])('rejects non-canonical value %p', (value) => {
+            expect(isHostEventKind(value)).toBe(false);
+        });
+    });
+    describe('isHostDecision', () => {
+        it.each(['allow', 'deny', 'modify', 'observe'])('accepts %p', (value) => {
+            expect(isHostDecision(value)).toBe(true);
+        });
+        it.each(['', 'block', 'ask', 1, null, undefined])('rejects %p', (value) => {
+            expect(isHostDecision(value)).toBe(false);
+        });
+    });
+    describe('isHostEventContext', () => {
+        const valid = {
+            workspaceDir: '/ws',
+            sessionId: 'sess-1',
+        };
+        it('accepts minimal valid context', () => {
+            expect(isHostEventContext(valid)).toBe(true);
+        });
+        it('accepts context with optional fields', () => {
+            expect(isHostEventContext({ ...valid, turnId: 'turn-1', toolName: 'Bash' })).toBe(true);
+        });
+        it.each([
+            [null],
+            [undefined],
+            [[]],
+            ['string'],
+            [{ workspaceDir: '/ws' }], // missing sessionId
+            [{ sessionId: 'sess-1' }], // missing workspaceDir
+            [{ workspaceDir: 1, sessionId: 'sess-1' }], // wrong type
+        ])('rejects %p', (value) => {
+            expect(isHostEventContext(value)).toBe(false);
+        });
+    });
+    describe('isHostEvent', () => {
+        const ctx = { workspaceDir: '/ws', sessionId: 'sess-1' };
+        const valid = {
+            kind: 'before_tool_call',
+            context: ctx,
+            rawPayload: { foo: 'bar' },
+            source: 'codex:pre_tool_use',
+        };
+        it('accepts a valid event', () => {
+            expect(isHostEvent(valid)).toBe(true);
+        });
+        it.each([
+            [null],
+            [undefined],
+            [[]],
+            [{ kind: 'unknown', context: ctx, rawPayload: null, source: 'x' }],
+            [{ kind: 'before_tool_call', context: null, rawPayload: null, source: 'x' }],
+            [{ kind: 'before_tool_call', context: ctx, source: 'x' }], // missing rawPayload
+            [{ kind: 'before_tool_call', context: ctx, rawPayload: null }], // missing source
+        ])('rejects %p', (value) => {
+            expect(isHostEvent(value)).toBe(false);
+        });
+    });
+    describe('isHostEventResult', () => {
+        const valid = {
+            decision: 'allow',
+            source: 'codex:pre_tool_use',
+        };
+        it('accepts a valid result', () => {
+            expect(isHostEventResult(valid)).toBe(true);
+        });
+        it.each([
+            [null],
+            [undefined],
+            [[]],
+            [{ decision: 'block', source: 'x' }],
+            [{ decision: 'allow' }], // missing source
+            [{ source: 'x' }], // missing decision
+        ])('rejects %p', (value) => {
+            expect(isHostEventResult(value)).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=host-adapter.test.js.map

package/core/dist/host/__tests__/host-adapter.test.js.map

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

package/core/dist/host/host-adapter.d.ts

@@ -0,0 +1,185 @@
+/**
+ * HostAdapter — Multi-platform host abstraction (ADR-0020 §2.2)
+ *
+ * Pure types and type guards only. No I/O. Lives in @principles/core so that
+ * any host-specific adapter (Codex, OpenClaw, future Claude Code/OpenCode/Pi)
+ * can depend on the interface without depending on each other.
+ *
+ * Product boundary (docs/product/PRODUCT_IDENTITY.md): PD owns owner-reviewed,
+ * reversible behavior internalization. The HostAdapter only normalizes the
+ * inbound hook event shape; it does not implement task execution, memory,
+ * or autonomous value decisions.
+ *
+ * MVP scope (ADR-0014 / ADR-0020):
+ * - Only `CodexHooksHostAdapter` implements this interface (in packages/codex-adapter/).
+ * - `OpenClawHostAdapter` is deferred to Post-MVP (OpenClaw keeps direct api.on() registration).
+ * - The interface exists to make the abstraction boundary explicit, not to be immediately polyglot.
+ *
+ * Runtime Contract Rules (AGENTS.md):
+ * - rc-1-treat-as-unknown: rawPayload is `unknown`; consumers must validate before use.
+ * - rc-2-no-as-bypass: use the provided type guards, not `as` casts.
+ * - rc-3-fail-loud-missing: decoders must fail loud on missing required fields.
+ * - rc-6-lineage-consistency: source/sessionId/turnId must come from the same raw payload.
+ */
+/**
+ * The normalized set of hook event kinds PD subscribes to across all hosts.
+ *
+ * Naming is host-agnostic (e.g. `before_tool_call` maps to Codex `PreToolUse`
+ * and OpenClaw `before_tool_call`). The host-specific adapter is responsible
+ * for translating its native event names into these kinds.
+ */
+export type HostEventKind = 'before_tool_call' | 'after_tool_call' | 'before_prompt_build' | 'session_start' | 'session_end';
+export declare const HOST_EVENT_KINDS: readonly HostEventKind[];
+/**
+ * Normalized context extracted from a host's raw hook payload.
+ *
+ * Lineage fields (sessionId, turnId) MUST come from the same raw payload —
+ * never mix sources (rc-6-lineage-consistency).
+ *
+ * NOTE on turnId: Codex `SessionStart` input lacks `turn_id` (verified in
+ * schema.rs:486-497, SPEC v4.1 §5.3.4). Decoders MUST set `turnId = undefined`
+ * for session_start events rather than synthesizing a placeholder.
+ */
+export interface HostEventContext {
+    /** Absolute path to the workspace PD is operating on. */
+    readonly workspaceDir: string;
+    /** Host-assigned session identifier. */
+    readonly sessionId: string;
+    /**
+     * Host-assigned turn identifier. Undefined when the host does not provide
+     * one (e.g. Codex SessionStart per SPEC v4.1 §5.3.4).
+     */
+    readonly turnId?: string;
+    /** Tool name for tool-call events (before_tool_call / after_tool_call). */
+    readonly toolName?: string;
+    /** Raw tool input for before_tool_call (untrusted — rc-1). */
+    readonly toolInput?: unknown;
+    /** Raw tool output for after_tool_call (untrusted — rc-1). */
+    readonly toolOutput?: unknown;
+    /** Prompt content for prompt events (before_prompt_build). */
+    readonly promptContent?: string;
+    /** Session start source (e.g. Codex SessionStart.source). */
+    readonly source?: string;
+}
+/**
+ * A normalized hook event produced by a HostAdapter.decodeEvent().
+ *
+ * `rawPayload` is retained for traceability and host-specific debugging, but
+ * consumers MUST NOT access it without re-validating (rc-1-treat-as-unknown).
+ */
+export interface HostEvent {
+    readonly kind: HostEventKind;
+    readonly context: HostEventContext;
+    /**
+     * The original host-specific payload. Treated as `unknown` per rc-1.
+     * Used only for telemetry/trace; business logic MUST use `context`.
+     */
+    readonly rawPayload: unknown;
+    /**
+     * Host-scoped source identifier for telemetry, e.g.
+     * 'codex:pre_tool_use' or 'openclaw:before_tool_call'.
+     * Lineage-consistent with `context.sessionId` (rc-6).
+     */
+    readonly source: string;
+}
+/**
+ * The decision a PD hook returns to the host.
+ *
+ * `allow` — proceed with the original input.
+ * `deny`  — block the action with a reason (gate).
+ * `modify` — proceed with modified input (e.g. injected context, sanitized args).
+ * `observe` — no decision; record only (used by after_tool_call pain capture).
+ */
+export type HostDecision = 'allow' | 'deny' | 'modify' | 'observe';
+/**
+ * Normalized result returned by PD's hook business logic. The HostAdapter
+ * encodes this into the host-specific output format (e.g. Codex camelCase JSON
+ * on stdout, OpenClaw api return value).
+ *
+ * IMPORTANT (Codex fail-OPEN risk, ADR-0020 §6):
+ * Codex's `deny_unknown_fields` is strict. A CodexHostAdapter.encodeOutput()
+ * MUST NOT emit fields outside the Codex schema. `additionalContext` and
+ * `modifiedInput` must be translated into the exact Codex output fields
+ * (`additionalContext`, `updatedInput`). An invalid field generates
+ * `invalid_reason`, which is fail-OPEN (the tool PROCEEDS).
+ */
+export interface HostEventResult {
+    readonly decision: HostDecision;
+    /** Human-readable reason (shown to the operator). Required for `deny`. */
+    readonly reason?: string;
+    /** Modified input for `modify` decision (untrusted shape — host-specific encoding). */
+    readonly modifiedInput?: unknown;
+    /** Additional context to inject into the prompt (for before_prompt_build). */
+    readonly additionalContext?: string;
+    /** Telemetry source, lineaged with the originating HostEvent.source (rc-6). */
+    readonly source: string;
+}
+/**
+ * Abstraction over a host platform's hook extension model.
+ *
+ * - OpenClaw: in-process `api.on(eventName, handler)` — host calls PD directly.
+ * - Codex CLI: out-of-process stdin/stdout JSON — host spawns `pd-hook.js`.
+ *
+ * The adapter owns:
+ * 1. Decoding the host's raw payload into a unified {@link HostEvent}.
+ * 2. Encoding a unified {@link HostEventResult} into the host's output format.
+ *
+ * The adapter does NOT own business logic (pain detection, principle injection,
+ * gate enforcement). That logic consumes HostEvent and produces HostEventResult.
+ */
+export interface HostAdapter {
+    /** Stable host identifier, e.g. 'codex', 'openclaw'. */
+    readonly hostId: string;
+    /** Extension model: in-process (OpenClaw) vs subprocess (Codex). */
+    readonly hostKind: 'inprocess' | 'subprocess';
+    /** List of hook event kinds this adapter subscribes to. */
+    subscribedEvents(): readonly HostEventKind[];
+    /**
+     * Decode a host-specific raw payload into a unified HostEvent.
+     *
+     * Implementations MUST:
+     * - Treat `raw` as `unknown` (rc-1) and use type guards (rc-2), never `as`.
+     * - Fail loud on missing required fields (rc-3) by throwing a structured error.
+     * - Preserve lineage consistency (rc-6): sessionId/turnId from same payload.
+     */
+    decodeEvent(raw: unknown): HostEvent;
+    /**
+     * Encode a unified HostEventResult into the host's output format.
+     *
+     * Implementations MUST:
+     * - Respect host-specific `deny_unknown_fields` constraints (Codex schema.rs).
+     * - Never emit `permissionDecision: "ask"` (unconditionally generates
+     *   `invalid_reason` per output_parser.rs:445-447 — fail-OPEN).
+     * - Hardcode safe defaults (e.g. `continue: true` for Codex universal output).
+     *
+     * @param result the unified result to encode
+     * @param kind the originating event kind. Required because some hosts
+     *  (Codex) have per-event output schemas — the same decision produces a
+     *  different field set for PreToolUse vs PostToolUse vs SessionStart.
+     */
+    encodeOutput(result: HostEventResult, kind: HostEventKind): unknown;
+}
+/**
+ * Type guard: is the value a valid HostEventKind?
+ * Use this instead of `as HostEventKind` (rc-2-no-as-bypass).
+ */
+export declare function isHostEventKind(value: unknown): value is HostEventKind;
+/**
+ * Type guard: is the value a valid HostDecision?
+ */
+export declare function isHostDecision(value: unknown): value is HostDecision;
+/**
+ * Type guard: is the value a HostEventContext-shaped object?
+ * Validates only structural presence; field-level semantic validation is
+ * the decoder's responsibility (rc-4-validate-array-elements where applicable).
+ */
+export declare function isHostEventContext(value: unknown): value is HostEventContext;
+/**
+ * Type guard: is the value a HostEvent-shaped object?
+ */
+export declare function isHostEvent(value: unknown): value is HostEvent;
+/**
+ * Type guard: is the value a HostEventResult-shaped object?
+ */
+export declare function isHostEventResult(value: unknown): value is HostEventResult;
+//# sourceMappingURL=host-adapter.d.ts.map

package/core/dist/host/host-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-adapter.d.ts","sourceRoot":"","sources":["../../src/host/host-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GACrB,kBAAkB,GAClB,iBAAiB,GACjB,qBAAqB,GACrB,eAAe,GACf,aAAa,CAAC;AAElB,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAM3C,CAAC;AAGX;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAGD;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAGD;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAGnE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAGD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,YAAY,CAAC;IAE9C,2DAA2D;IAC3D,gBAAgB,IAAI,SAAS,aAAa,EAAE,CAAC;IAE7C;;;;;;;OAOG;IACH,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAAC;IAErC;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC;CACrE;AAGD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAGtE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAO5E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAS9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAO1E"}