@principles/core 1.73.0

package/dist/runtime-v2/runner/runner-phase.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Internal execution phases for DiagnosticianRunner.
+ *
+ * Per CONTEXT.md D-01: Phase-based step pipeline.
+ * These phases are runner-local tracking, NOT persisted to TaskStore.
+ * Only PDTaskStatus values (pending/leased/succeeded/retry_wait/failed) are persisted.
+ */
+export declare enum RunnerPhase {
+    Idle = "idle",
+    BuildingContext = "building_context",
+    CreatingRun = "creating_run",
+    Invoking = "invoking",
+    Polling = "polling",
+    FetchingOutput = "fetching_output",
+    Validating = "validating",
+    Committing = "committing",
+    Completed = "completed",
+    Failed = "failed",
+    RetryWaiting = "retry_waiting"
+}
+//# sourceMappingURL=runner-phase.d.ts.map

package/dist/runtime-v2/runner/runner-phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-phase.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/runner/runner-phase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,eAAe,qBAAqB;IACpC,WAAW,iBAAiB;IAC5B,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,cAAc,oBAAoB;IAClC,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,YAAY,kBAAkB;CAC/B"}

package/dist/runtime-v2/runner/runner-phase.js

@@ -0,0 +1,22 @@
+/**
+ * Internal execution phases for DiagnosticianRunner.
+ *
+ * Per CONTEXT.md D-01: Phase-based step pipeline.
+ * These phases are runner-local tracking, NOT persisted to TaskStore.
+ * Only PDTaskStatus values (pending/leased/succeeded/retry_wait/failed) are persisted.
+ */
+export var RunnerPhase;
+(function (RunnerPhase) {
+    RunnerPhase["Idle"] = "idle";
+    RunnerPhase["BuildingContext"] = "building_context";
+    RunnerPhase["CreatingRun"] = "creating_run";
+    RunnerPhase["Invoking"] = "invoking";
+    RunnerPhase["Polling"] = "polling";
+    RunnerPhase["FetchingOutput"] = "fetching_output";
+    RunnerPhase["Validating"] = "validating";
+    RunnerPhase["Committing"] = "committing";
+    RunnerPhase["Completed"] = "completed";
+    RunnerPhase["Failed"] = "failed";
+    RunnerPhase["RetryWaiting"] = "retry_waiting";
+})(RunnerPhase || (RunnerPhase = {}));
+//# sourceMappingURL=runner-phase.js.map

package/dist/runtime-v2/runner/runner-phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-phase.js","sourceRoot":"","sources":["../../../src/runtime-v2/runner/runner-phase.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,WAYX;AAZD,WAAY,WAAW;IACrB,4BAAa,CAAA;IACb,mDAAoC,CAAA;IACpC,2CAA4B,CAAA;IAC5B,oCAAqB,CAAA;IACrB,kCAAmB,CAAA;IACnB,iDAAkC,CAAA;IAClC,wCAAyB,CAAA;IACzB,wCAAyB,CAAA;IACzB,sCAAuB,CAAA;IACvB,gCAAiB,CAAA;IACjB,6CAA8B,CAAA;AAChC,CAAC,EAZW,WAAW,KAAX,WAAW,QAYtB"}

package/dist/runtime-v2/runner/runner-result.d.ts

@@ -0,0 +1,20 @@
+import type { PDErrorCategory } from '../error-categories.js';
+import type { DiagnosticianOutputV1 } from '../diagnostician-output.js';
+export type RunnerResultStatus = 'succeeded' | 'failed' | 'retried';
+export interface RunnerResult {
+    /** Final status of the run attempt. */
+    readonly status: RunnerResultStatus;
+    /** The task this result pertains to. */
+    readonly taskId: string;
+    /** SHA-256 hash of the assembled context (set if context was built). */
+    readonly contextHash?: string;
+    /** The validated diagnostician output (set only when status=succeeded). */
+    readonly output?: DiagnosticianOutputV1;
+    /** Error category for the failure (set when status=failed or status=retried). */
+    readonly errorCategory?: PDErrorCategory;
+    /** Human-readable failure explanation. */
+    readonly failureReason?: string;
+    /** Number of attempts made on this task so far. */
+    readonly attemptCount: number;
+}
+//# sourceMappingURL=runner-result.d.ts.map

package/dist/runtime-v2/runner/runner-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-result.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/runner/runner-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IACxC,iFAAiF;IACjF,QAAQ,CAAC,aAAa,CAAC,EAAE,eAAe,CAAC;IACzC,0CAA0C;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,mDAAmD;IACnD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B"}

package/dist/runtime-v2/runner/runner-result.js

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

package/dist/runtime-v2/runner/runner-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-result.js","sourceRoot":"","sources":["../../../src/runtime-v2/runner/runner-result.ts"],"names":[],"mappings":""}

package/dist/runtime-v2/runtime-protocol.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Canonical Runtime Protocol for PD Runtime v2.
+ *
+ * Source: PD Runtime Protocol SPEC v1, Sections 5-10, 10A
+ * Source: PD Runtime-Agnostic Architecture v2, Sections 8-9
+ *
+ * This is the core decoupling layer between PD logic and external runtimes.
+ * All adapters must implement PDRuntimeAdapter.
+ */
+import { type Static } from '@sinclair/typebox';
+export declare const RuntimeKindSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"openclaw">, import("@sinclair/typebox").TLiteral<"openclaw-cli">, import("@sinclair/typebox").TLiteral<"openclaw-history">, import("@sinclair/typebox").TLiteral<"claude-cli">, import("@sinclair/typebox").TLiteral<"codex-cli">, import("@sinclair/typebox").TLiteral<"gemini-cli">, import("@sinclair/typebox").TLiteral<"local-worker">, import("@sinclair/typebox").TLiteral<"test-double">, import("@sinclair/typebox").TLiteral<"pi-ai">]>;
+export type RuntimeKind = Static<typeof RuntimeKindSchema>;
+export declare const RuntimeCapabilitiesSchema: import("@sinclair/typebox").TObject<{
+    supportsStructuredJsonOutput: import("@sinclair/typebox").TBoolean;
+    supportsToolUse: import("@sinclair/typebox").TBoolean;
+    supportsWorkingDirectory: import("@sinclair/typebox").TBoolean;
+    supportsModelSelection: import("@sinclair/typebox").TBoolean;
+    supportsLongRunningSessions: import("@sinclair/typebox").TBoolean;
+    supportsCancellation: import("@sinclair/typebox").TBoolean;
+    supportsArtifactWriteBack: import("@sinclair/typebox").TBoolean;
+    supportsConcurrentRuns: import("@sinclair/typebox").TBoolean;
+    supportsStreaming: import("@sinclair/typebox").TBoolean;
+    /** ISO timestamp when these capabilities were last probed. */
+    capabilitiesValidUntil: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /** Dynamic capabilities that may vary per session or invocation. */
+    dynamicCapabilities: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        toolsAvailable: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        modelOptions: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    }>>;
+}>;
+export type RuntimeCapabilities = Static<typeof RuntimeCapabilitiesSchema>;
+export declare const RuntimeHealthSchema: import("@sinclair/typebox").TObject<{
+    /** Runtime is fully operational. */
+    healthy: import("@sinclair/typebox").TBoolean;
+    /** Runtime is usable but degraded; prefer alternatives. */
+    degraded: import("@sinclair/typebox").TBoolean;
+    /** Human-readable warning messages. */
+    warnings: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    /** ISO timestamp of last health check. */
+    lastCheckedAt: import("@sinclair/typebox").TString;
+}>;
+export type RuntimeHealth = Static<typeof RuntimeHealthSchema>;
+export declare const RunHandleSchema: import("@sinclair/typebox").TObject<{
+    runId: import("@sinclair/typebox").TString;
+    runtimeKind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"openclaw">, import("@sinclair/typebox").TLiteral<"openclaw-cli">, import("@sinclair/typebox").TLiteral<"openclaw-history">, import("@sinclair/typebox").TLiteral<"claude-cli">, import("@sinclair/typebox").TLiteral<"codex-cli">, import("@sinclair/typebox").TLiteral<"gemini-cli">, import("@sinclair/typebox").TLiteral<"local-worker">, import("@sinclair/typebox").TLiteral<"test-double">, import("@sinclair/typebox").TLiteral<"pi-ai">]>;
+    startedAt: import("@sinclair/typebox").TString;
+}>;
+export type RunHandle = Static<typeof RunHandleSchema>;
+export declare const RunExecutionStatusSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"queued">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"succeeded">, import("@sinclair/typebox").TLiteral<"failed">, import("@sinclair/typebox").TLiteral<"timed_out">, import("@sinclair/typebox").TLiteral<"cancelled">]>;
+export type RunExecutionStatus = Static<typeof RunExecutionStatusSchema>;
+export declare const RunStatusSchema: import("@sinclair/typebox").TObject<{
+    runId: import("@sinclair/typebox").TString;
+    status: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"queued">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"succeeded">, import("@sinclair/typebox").TLiteral<"failed">, import("@sinclair/typebox").TLiteral<"timed_out">, import("@sinclair/typebox").TLiteral<"cancelled">]>;
+    startedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    endedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type RunStatus = Static<typeof RunStatusSchema>;
+/**
+ * Full run record used by SqliteRunStore.
+ * Extends RunHandle with task linkage, attempt tracking, and payload fields.
+ */
+export declare const RunRecordSchema: import("@sinclair/typebox").TObject<{
+    runId: import("@sinclair/typebox").TString;
+    runtimeKind: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"openclaw">, import("@sinclair/typebox").TLiteral<"openclaw-cli">, import("@sinclair/typebox").TLiteral<"openclaw-history">, import("@sinclair/typebox").TLiteral<"claude-cli">, import("@sinclair/typebox").TLiteral<"codex-cli">, import("@sinclair/typebox").TLiteral<"gemini-cli">, import("@sinclair/typebox").TLiteral<"local-worker">, import("@sinclair/typebox").TLiteral<"test-double">, import("@sinclair/typebox").TLiteral<"pi-ai">]>;
+    startedAt: import("@sinclair/typebox").TString;
+    taskId: import("@sinclair/typebox").TString;
+    attemptNumber: import("@sinclair/typebox").TInteger;
+    executionStatus: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"queued">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"succeeded">, import("@sinclair/typebox").TLiteral<"failed">, import("@sinclair/typebox").TLiteral<"timed_out">, import("@sinclair/typebox").TLiteral<"cancelled">]>;
+    endedAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    reason: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    outputRef: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    createdAt: import("@sinclair/typebox").TString;
+    updatedAt: import("@sinclair/typebox").TString;
+    inputPayload: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    outputPayload: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    errorCategory: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"runtime_unavailable">, import("@sinclair/typebox").TLiteral<"capability_missing">, import("@sinclair/typebox").TLiteral<"input_invalid">, import("@sinclair/typebox").TLiteral<"lease_conflict">, import("@sinclair/typebox").TLiteral<"lease_expired">, import("@sinclair/typebox").TLiteral<"execution_failed">, import("@sinclair/typebox").TLiteral<"timeout">, import("@sinclair/typebox").TLiteral<"cancelled">, import("@sinclair/typebox").TLiteral<"output_invalid">, import("@sinclair/typebox").TLiteral<"artifact_commit_failed">, import("@sinclair/typebox").TLiteral<"max_attempts_exceeded">, import("@sinclair/typebox").TLiteral<"context_assembly_failed">, import("@sinclair/typebox").TLiteral<"history_not_found">, import("@sinclair/typebox").TLiteral<"trajectory_ambiguous">, import("@sinclair/typebox").TLiteral<"storage_unavailable">, import("@sinclair/typebox").TLiteral<"workspace_invalid">, import("@sinclair/typebox").TLiteral<"workspace_dirty">, import("@sinclair/typebox").TLiteral<"query_invalid">]>>;
+}>;
+export type RunRecord = Static<typeof RunRecordSchema>;
+export declare const ContextItemSchema: import("@sinclair/typebox").TObject<{
+    role: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user">, import("@sinclair/typebox").TLiteral<"system">, import("@sinclair/typebox").TLiteral<"tool">]>;
+    content: import("@sinclair/typebox").TString;
+}>;
+export type ContextItem = Static<typeof ContextItemSchema>;
+export declare const AgentSpecRefSchema: import("@sinclair/typebox").TObject<{
+    agentId: import("@sinclair/typebox").TString;
+    schemaVersion: import("@sinclair/typebox").TString;
+}>;
+export type AgentSpecRef = Static<typeof AgentSpecRefSchema>;
+export declare const WorkflowRefSchema: import("@sinclair/typebox").TObject<{
+    workflowId: import("@sinclair/typebox").TString;
+}>;
+export type WorkflowRef = Static<typeof WorkflowRefSchema>;
+export declare const TaskRefSchema: import("@sinclair/typebox").TObject<{
+    taskId: import("@sinclair/typebox").TString;
+}>;
+export type TaskRef = Static<typeof TaskRefSchema>;
+export declare const StartRunInputSchema: import("@sinclair/typebox").TObject<{
+    agentSpec: import("@sinclair/typebox").TObject<{
+        agentId: import("@sinclair/typebox").TString;
+        schemaVersion: import("@sinclair/typebox").TString;
+    }>;
+    workflowRef: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        workflowId: import("@sinclair/typebox").TString;
+    }>>;
+    taskRef: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        taskId: import("@sinclair/typebox").TString;
+    }>>;
+    inputPayload: import("@sinclair/typebox").TUnknown;
+    contextItems: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        role: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user">, import("@sinclair/typebox").TLiteral<"system">, import("@sinclair/typebox").TLiteral<"tool">]>;
+        content: import("@sinclair/typebox").TString;
+    }>>;
+    outputSchemaRef: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    artifactContractRef: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    timeoutMs: import("@sinclair/typebox").TNumber;
+    idempotencyKey: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    preferredModel: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    preferredRuntimeProfile: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type StartRunInput = Static<typeof StartRunInputSchema>;
+export declare const StructuredRunOutputSchema: import("@sinclair/typebox").TObject<{
+    runId: import("@sinclair/typebox").TString;
+    payload: import("@sinclair/typebox").TUnknown;
+}>;
+export type StructuredRunOutput = Static<typeof StructuredRunOutputSchema>;
+export declare const RuntimeArtifactRefSchema: import("@sinclair/typebox").TObject<{
+    artifactType: import("@sinclair/typebox").TString;
+    ref: import("@sinclair/typebox").TString;
+}>;
+export type RuntimeArtifactRef = Static<typeof RuntimeArtifactRefSchema>;
+/**
+ * The canonical runtime adapter interface.
+ *
+ * Every supported runtime (OpenClaw, Codex CLI, Gemini CLI, etc.)
+ * must implement this interface.
+ *
+ * Adapters MUST NOT:
+ *   - commit PD artifacts directly into PD stores
+ *   - mutate task status directly
+ *   - leak host-specific state into PD core
+ */
+export interface PDRuntimeAdapter {
+    /** Identify which runtime this adapter wraps. */
+    kind(): RuntimeKind;
+    /** Probe the runtime's current capabilities. */
+    getCapabilities(): Promise<RuntimeCapabilities>;
+    /** Re-probe capabilities (optional, for runtimes with dynamic capabilities). */
+    refreshCapabilities?(): Promise<RuntimeCapabilities>;
+    /** Check runtime health. */
+    healthCheck(): Promise<RuntimeHealth>;
+    /** Start a new run. */
+    startRun(input: StartRunInput): Promise<RunHandle>;
+    /** Poll the status of an existing run. */
+    pollRun(runId: string): Promise<RunStatus>;
+    /** Cancel a running execution. */
+    cancelRun(runId: string): Promise<void>;
+    /** Fetch structured output from a completed run. */
+    fetchOutput(runId: string): Promise<StructuredRunOutput | null>;
+    /** Fetch artifact references produced by a run. */
+    fetchArtifacts(runId: string): Promise<RuntimeArtifactRef[]>;
+    /** Append additional context to an in-progress run (optional). */
+    appendContext?(runId: string, items: ContextItem[]): Promise<void>;
+}
+//# sourceMappingURL=runtime-protocol.d.ts.map

package/dist/runtime-v2/runtime-protocol.d.ts.map

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

package/dist/runtime-v2/runtime-protocol.js

@@ -0,0 +1,130 @@
+/**
+ * Canonical Runtime Protocol for PD Runtime v2.
+ *
+ * Source: PD Runtime Protocol SPEC v1, Sections 5-10, 10A
+ * Source: PD Runtime-Agnostic Architecture v2, Sections 8-9
+ *
+ * This is the core decoupling layer between PD logic and external runtimes.
+ * All adapters must implement PDRuntimeAdapter.
+ */
+import { Type } from '@sinclair/typebox';
+import { PDErrorCategorySchema } from './error-categories.js';
+// ── Runtime Kind ──
+export const RuntimeKindSchema = Type.Union([
+    Type.Literal('openclaw'),
+    Type.Literal('openclaw-cli'),
+    Type.Literal('openclaw-history'), // compatibility import from OpenClaw trajectory.db
+    Type.Literal('claude-cli'),
+    Type.Literal('codex-cli'),
+    Type.Literal('gemini-cli'),
+    Type.Literal('local-worker'),
+    Type.Literal('test-double'),
+    Type.Literal('pi-ai'), // M9: direct LLM completion via @mariozechner/pi-ai
+]);
+// ── Runtime Capabilities ──
+export const RuntimeCapabilitiesSchema = Type.Object({
+    supportsStructuredJsonOutput: Type.Boolean(),
+    supportsToolUse: Type.Boolean(),
+    supportsWorkingDirectory: Type.Boolean(),
+    supportsModelSelection: Type.Boolean(),
+    supportsLongRunningSessions: Type.Boolean(),
+    supportsCancellation: Type.Boolean(),
+    supportsArtifactWriteBack: Type.Boolean(),
+    supportsConcurrentRuns: Type.Boolean(),
+    supportsStreaming: Type.Boolean(),
+    /** ISO timestamp when these capabilities were last probed. */
+    capabilitiesValidUntil: Type.Optional(Type.String()),
+    /** Dynamic capabilities that may vary per session or invocation. */
+    dynamicCapabilities: Type.Optional(Type.Object({
+        toolsAvailable: Type.Optional(Type.Array(Type.String())),
+        modelOptions: Type.Optional(Type.Array(Type.String())),
+    })),
+});
+// ── Runtime Health ──
+export const RuntimeHealthSchema = Type.Object({
+    /** Runtime is fully operational. */
+    healthy: Type.Boolean(),
+    /** Runtime is usable but degraded; prefer alternatives. */
+    degraded: Type.Boolean(),
+    /** Human-readable warning messages. */
+    warnings: Type.Array(Type.String()),
+    /** ISO timestamp of last health check. */
+    lastCheckedAt: Type.String(),
+});
+// ── Run Lifecycle ──
+export const RunHandleSchema = Type.Object({
+    runId: Type.String({ minLength: 1 }),
+    runtimeKind: RuntimeKindSchema,
+    startedAt: Type.String(),
+});
+export const RunExecutionStatusSchema = Type.Union([
+    Type.Literal('queued'),
+    Type.Literal('running'),
+    Type.Literal('succeeded'),
+    Type.Literal('failed'),
+    Type.Literal('timed_out'),
+    Type.Literal('cancelled'),
+]);
+export const RunStatusSchema = Type.Object({
+    runId: Type.String({ minLength: 1 }),
+    status: RunExecutionStatusSchema,
+    startedAt: Type.Optional(Type.String()),
+    endedAt: Type.Optional(Type.String()),
+    reason: Type.Optional(Type.String()),
+});
+/**
+ * Full run record used by SqliteRunStore.
+ * Extends RunHandle with task linkage, attempt tracking, and payload fields.
+ */
+export const RunRecordSchema = Type.Object({
+    runId: Type.String({ minLength: 1 }),
+    runtimeKind: RuntimeKindSchema,
+    startedAt: Type.String(),
+    taskId: Type.String({ minLength: 1 }),
+    attemptNumber: Type.Integer({ minimum: 0 }),
+    executionStatus: RunExecutionStatusSchema,
+    endedAt: Type.Optional(Type.String()),
+    reason: Type.Optional(Type.String()),
+    outputRef: Type.Optional(Type.String()),
+    createdAt: Type.String(),
+    updatedAt: Type.String(),
+    inputPayload: Type.Optional(Type.String()),
+    outputPayload: Type.Optional(Type.String()),
+    errorCategory: Type.Optional(PDErrorCategorySchema),
+});
+// ── Context Item (for runtime context injection) ──
+export const ContextItemSchema = Type.Object({
+    role: Type.Union([Type.Literal('user'), Type.Literal('system'), Type.Literal('tool')]),
+    content: Type.String(),
+});
+// ── References (lightweight refs, not full objects) ──
+export const AgentSpecRefSchema = Type.Object({
+    agentId: Type.String({ minLength: 1 }),
+    schemaVersion: Type.String({ minLength: 1 }),
+});
+export const WorkflowRefSchema = Type.Object({ workflowId: Type.String({ minLength: 1 }) });
+export const TaskRefSchema = Type.Object({ taskId: Type.String({ minLength: 1 }) });
+// ── StartRunInput ──
+export const StartRunInputSchema = Type.Object({
+    agentSpec: AgentSpecRefSchema,
+    workflowRef: Type.Optional(WorkflowRefSchema),
+    taskRef: Type.Optional(TaskRefSchema),
+    inputPayload: Type.Unknown(),
+    contextItems: Type.Array(ContextItemSchema),
+    outputSchemaRef: Type.Optional(Type.String()),
+    artifactContractRef: Type.Optional(Type.String()),
+    timeoutMs: Type.Number({ minimum: 0 }),
+    idempotencyKey: Type.Optional(Type.String()),
+    preferredModel: Type.Optional(Type.String()),
+    preferredRuntimeProfile: Type.Optional(Type.String()),
+});
+// ── Run Output ──
+export const StructuredRunOutputSchema = Type.Object({
+    runId: Type.String(),
+    payload: Type.Unknown(),
+});
+export const RuntimeArtifactRefSchema = Type.Object({
+    artifactType: Type.String(),
+    ref: Type.String(),
+});
+//# sourceMappingURL=runtime-protocol.js.map

package/dist/runtime-v2/runtime-protocol.js.map

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

package/dist/runtime-v2/runtime-selector.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Runtime Selector contract for PD Runtime v2.
+ *
+ * Source: PD Runtime Protocol SPEC v1, Section 10A
+ * Source: PD Runtime-Agnostic Architecture v2, Section 9.5
+ *
+ * The RuntimeSelector deterministically chooses a runtime backend
+ * for a given agent execution request.
+ *
+ * M1 ONLY: defines the interface. Implementation belongs to later milestones.
+ */
+import { type Static } from '@sinclair/typebox';
+import type { PDRuntimeAdapter, RuntimeCapabilities, RuntimeHealth, RuntimeKind } from './runtime-protocol.js';
+export declare const RuntimeSelectionCriteriaSchema: import("@sinclair/typebox").TObject<{
+    agentSpec: import("@sinclair/typebox").TObject<{
+        agentId: import("@sinclair/typebox").TString;
+        role: import("@sinclair/typebox").TString;
+        schemaVersion: import("@sinclair/typebox").TString;
+        inputSchemaRef: import("@sinclair/typebox").TString;
+        outputSchemaRef: import("@sinclair/typebox").TString;
+        artifactContractRef: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        timeoutPolicy: import("@sinclair/typebox").TObject<{
+            defaultTimeoutMs: import("@sinclair/typebox").TNumber;
+        }>;
+        retryPolicy: import("@sinclair/typebox").TObject<{
+            maxAttempts: import("@sinclair/typebox").TInteger;
+        }>;
+        capabilitiesRequired: import("@sinclair/typebox").TObject<{
+            structuredJson: import("@sinclair/typebox").TBoolean;
+            toolUse: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+            workingDirectory: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        }>;
+        preferredRuntimeKinds: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"openclaw">, import("@sinclair/typebox").TLiteral<"openclaw-cli">, import("@sinclair/typebox").TLiteral<"openclaw-history">, import("@sinclair/typebox").TLiteral<"claude-cli">, import("@sinclair/typebox").TLiteral<"codex-cli">, import("@sinclair/typebox").TLiteral<"gemini-cli">, import("@sinclair/typebox").TLiteral<"local-worker">, import("@sinclair/typebox").TLiteral<"test-double">, import("@sinclair/typebox").TLiteral<"pi-ai">]>>>;
+        preferredModelProfile: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    workspacePolicy: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        allowedRuntimes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"openclaw">, import("@sinclair/typebox").TLiteral<"openclaw-cli">, import("@sinclair/typebox").TLiteral<"openclaw-history">, import("@sinclair/typebox").TLiteral<"claude-cli">, import("@sinclair/typebox").TLiteral<"codex-cli">, import("@sinclair/typebox").TLiteral<"gemini-cli">, import("@sinclair/typebox").TLiteral<"local-worker">, import("@sinclair/typebox").TLiteral<"test-double">, import("@sinclair/typebox").TLiteral<"pi-ai">]>>>;
+        blockedRuntimes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"openclaw">, import("@sinclair/typebox").TLiteral<"openclaw-cli">, import("@sinclair/typebox").TLiteral<"openclaw-history">, import("@sinclair/typebox").TLiteral<"claude-cli">, import("@sinclair/typebox").TLiteral<"codex-cli">, import("@sinclair/typebox").TLiteral<"gemini-cli">, import("@sinclair/typebox").TLiteral<"local-worker">, import("@sinclair/typebox").TLiteral<"test-double">, import("@sinclair/typebox").TLiteral<"pi-ai">]>>>;
+    }>>;
+    fallbackEnabled: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+}>;
+export type RuntimeSelectionCriteria = Static<typeof RuntimeSelectionCriteriaSchema>;
+export interface RuntimeSelectionResult {
+    /** The selected runtime adapter. */
+    adapter: PDRuntimeAdapter;
+    /** Why this runtime was selected. */
+    reason: string;
+    /** Whether this is a fallback selection (not the agent's preferred runtime). */
+    isFallback: boolean;
+}
+/**
+ * Selects a runtime adapter for a given agent execution request.
+ *
+ * The selector considers:
+ *   - AgentSpec.preferredRuntimeKinds
+ *   - runtime capability probe results
+ *   - runtime health state
+ *   - workspace policy
+ *   - fallback policy
+ *
+ * If no runtime satisfies the required capabilities, selection must fail
+ * explicitly rather than silently degrading into an unsafe runtime.
+ */
+export interface RuntimeSelector {
+    /**
+     * Select the best available runtime for the given criteria.
+     * Throws PDRuntimeError('capability_missing') if no suitable runtime exists.
+     */
+    select(criteria: RuntimeSelectionCriteria): Promise<RuntimeSelectionResult>;
+    /** Register a runtime adapter for selection. */
+    register(adapter: PDRuntimeAdapter): void;
+    /** Get a snapshot of all registered runtimes' health. */
+    getHealthSnapshot(): Promise<Map<RuntimeKind, RuntimeHealth>>;
+    /** Get a snapshot of all registered runtimes' capabilities. */
+    getCapabilitiesSnapshot(): Promise<Map<RuntimeKind, RuntimeCapabilities>>;
+}
+//# sourceMappingURL=runtime-selector.d.ts.map

package/dist/runtime-v2/runtime-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-selector.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/runtime-selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAItD,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAE/G,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAErF,MAAM,WAAW,sBAAsB;IACrC,oCAAoC;IACpC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAE5E,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAE1C,yDAAyD;IACzD,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;IAE9D,+DAA+D;IAC/D,uBAAuB,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC,CAAC;CAC3E"}

package/dist/runtime-v2/runtime-selector.js

@@ -0,0 +1,23 @@
+/**
+ * Runtime Selector contract for PD Runtime v2.
+ *
+ * Source: PD Runtime Protocol SPEC v1, Section 10A
+ * Source: PD Runtime-Agnostic Architecture v2, Section 9.5
+ *
+ * The RuntimeSelector deterministically chooses a runtime backend
+ * for a given agent execution request.
+ *
+ * M1 ONLY: defines the interface. Implementation belongs to later milestones.
+ */
+import { Type } from '@sinclair/typebox';
+import { RuntimeKindSchema } from './runtime-protocol.js';
+import { AgentSpecSchema } from './agent-spec.js';
+export const RuntimeSelectionCriteriaSchema = Type.Object({
+    agentSpec: AgentSpecSchema,
+    workspacePolicy: Type.Optional(Type.Object({
+        allowedRuntimes: Type.Optional(Type.Array(RuntimeKindSchema)),
+        blockedRuntimes: Type.Optional(Type.Array(RuntimeKindSchema)),
+    })),
+    fallbackEnabled: Type.Optional(Type.Boolean()),
+});
+//# sourceMappingURL=runtime-selector.js.map

package/dist/runtime-v2/runtime-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-selector.js","sourceRoot":"","sources":["../../src/runtime-v2/runtime-selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,CAAC,MAAM,CAAC;IACxD,SAAS,EAAE,eAAe;IAC1B,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QACzC,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC7D,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;KAC9D,CAAC,CAAC;IACH,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;CAC/C,CAAC,CAAC"}

package/dist/runtime-v2/runtime-state-handle.d.ts

@@ -0,0 +1,10 @@
+import { RuntimeStateManager } from './store/runtime-state-manager.js';
+export interface RuntimeStateHandle {
+    stateManager: RuntimeStateManager;
+    close(): Promise<void>;
+}
+export declare function createRuntimeStateHandle(opts: {
+    workspaceDir: string;
+    readonly?: boolean;
+}): Promise<RuntimeStateHandle>;
+//# sourceMappingURL=runtime-state-handle.d.ts.map

package/dist/runtime-v2/runtime-state-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-state-handle.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/runtime-state-handle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,mBAAmB,CAAC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2B9B"}

package/dist/runtime-v2/runtime-state-handle.js

@@ -0,0 +1,30 @@
+import { RuntimeStateManager } from './store/runtime-state-manager.js';
+export async function createRuntimeStateHandle(opts) {
+    const stateManager = new RuntimeStateManager({
+        workspaceDir: opts.workspaceDir,
+        readonly: opts.readonly ?? false,
+    });
+    let closed = false;
+    try {
+        await stateManager.initialize();
+    }
+    catch (error) {
+        try {
+            await stateManager.close();
+        }
+        catch {
+            // swallow close error during cleanup — original error is more important
+        }
+        throw error;
+    }
+    return {
+        stateManager,
+        close: async () => {
+            if (closed)
+                return;
+            closed = true;
+            await stateManager.close();
+        },
+    };
+}
+//# sourceMappingURL=runtime-state-handle.js.map

package/dist/runtime-v2/runtime-state-handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-state-handle.js","sourceRoot":"","sources":["../../src/runtime-v2/runtime-state-handle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAOvE,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAG9C;IACC,MAAM,YAAY,GAAG,IAAI,mBAAmB,CAAC;QAC3C,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK;KACjC,CAAC,CAAC;IAEH,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YACH,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,wEAAwE;QAC1E,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,OAAO;QACL,YAAY;QACZ,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,IAAI,MAAM;gBAAE,OAAO;YACnB,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime-v2/schema-conformance-read-model.d.ts

@@ -0,0 +1,24 @@
+export interface SchemaConformanceTableResult {
+    exists: boolean;
+    missingColumns: string[];
+    extraInfo?: string;
+}
+export interface SchemaConformanceResult {
+    overallStatus: 'ok' | 'degraded' | 'error';
+    checkedDatabasePath: string;
+    tables: Record<string, SchemaConformanceTableResult>;
+    indexes: {
+        missingIndexes: string[];
+    };
+    migrationsNeeded: string[];
+    generatedAt: string;
+}
+export interface SchemaConformanceReadModelOptions {
+    workspaceDir: string;
+}
+export declare class SchemaConformanceReadModel {
+    private readonly dbPath;
+    constructor(opts: SchemaConformanceReadModelOptions);
+    check(): SchemaConformanceResult;
+}
+//# sourceMappingURL=schema-conformance-read-model.d.ts.map

package/dist/runtime-v2/schema-conformance-read-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-conformance-read-model.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/schema-conformance-read-model.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,IAAI,GAAG,UAAU,GAAG,OAAO,CAAC;IAC3C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;IACrD,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iCAAiC;IAChD,YAAY,EAAE,MAAM,CAAC;CACtB;AA4ED,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,IAAI,EAAE,iCAAiC;IAInD,KAAK,IAAI,uBAAuB;CAwGjC"}