@principles/core 1.73.0

package/dist/runtime-v2/adapter/test-double-runtime-adapter.js

@@ -0,0 +1,94 @@
+export class TestDoubleRuntimeAdapter {
+    overrides;
+    defaultTaskId;
+    runCounter = 0;
+    constructor(overrides, defaultTaskId) {
+        this.overrides = overrides ?? {};
+        this.defaultTaskId = defaultTaskId ?? 'td-task-default';
+    }
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    kind() {
+        return 'test-double';
+    }
+    async getCapabilities() {
+        if (this.overrides.onGetCapabilities) {
+            return this.overrides.onGetCapabilities();
+        }
+        return {
+            supportsStructuredJsonOutput: true,
+            supportsToolUse: false,
+            supportsWorkingDirectory: false,
+            supportsModelSelection: false,
+            supportsLongRunningSessions: false,
+            supportsCancellation: true,
+            supportsArtifactWriteBack: false,
+            supportsConcurrentRuns: false,
+            supportsStreaming: false,
+        };
+    }
+    async healthCheck() {
+        if (this.overrides.onHealthCheck) {
+            return this.overrides.onHealthCheck();
+        }
+        return {
+            healthy: true,
+            degraded: false,
+            warnings: [],
+            lastCheckedAt: new Date().toISOString(),
+        };
+    }
+    async startRun(input) {
+        if (this.overrides.onStartRun) {
+            return this.overrides.onStartRun(input);
+        }
+        this.runCounter += 1;
+        return {
+            runId: `td-${this.runCounter}`,
+            runtimeKind: 'test-double',
+            startedAt: new Date().toISOString(),
+        };
+    }
+    async pollRun(runId) {
+        if (this.overrides.onPollRun) {
+            return this.overrides.onPollRun(runId);
+        }
+        const now = new Date().toISOString();
+        return { runId, status: 'succeeded', startedAt: now, endedAt: now };
+    }
+    async cancelRun(runId) {
+        if (this.overrides.onCancelRun) {
+            return this.overrides.onCancelRun(runId);
+        }
+    }
+    async fetchOutput(runId) {
+        if (this.overrides.onFetchOutput) {
+            return this.overrides.onFetchOutput(runId);
+        }
+        return {
+            runId,
+            payload: {
+                valid: true,
+                diagnosisId: 'td-diag-default',
+                taskId: this.defaultTaskId,
+                summary: 'TestDouble default summary',
+                rootCause: 'TestDouble default root cause',
+                violatedPrinciples: [],
+                evidence: [],
+                recommendations: [],
+                confidence: 0.9,
+            },
+        };
+    }
+    async fetchArtifacts(runId) {
+        if (this.overrides.onFetchArtifacts) {
+            return this.overrides.onFetchArtifacts(runId);
+        }
+        return [];
+    }
+    async appendContext(runId, items) {
+        if (this.overrides.onAppendContext) {
+            return this.overrides.onAppendContext(runId, items);
+        }
+    }
+}
+//# sourceMappingURL=test-double-runtime-adapter.js.map

package/dist/runtime-v2/adapter/test-double-runtime-adapter.js.map

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

package/dist/runtime-v2/adapter/tools/diagnostician-tool.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Diagnostician tool definition for provider-level structured output (PRI-271 B2).
+ *
+ * Defines `record_diagnosis_v1` tool whose parameters schema is derived from
+ * `DiagnosticianOutputV1Schema`. When a provider supports tool calling, the
+ * adapter passes this tool via `context.tools` and extracts the structured
+ * arguments from the `ToolCall` response — bypassing JSON extraction entirely.
+ *
+ * Design decisions (PRI-271):
+ *   D2: Tool definition in dedicated file, shared TypeBox schema source
+ *   D4: Lineage fields protected via preserveLineageFields() after extraction
+ */
+import type { Tool } from '@mariozechner/pi-ai';
+/**
+ * Tool definition for diagnostician structured output via function calling.
+ *
+ * The `parameters` field uses the canonical TypeBox schema so the provider
+ * receives the same schema that PD validates against — single source of truth.
+ */
+export declare const RECORD_DIAGNOSIS_V1_TOOL: Tool;
+//# sourceMappingURL=diagnostician-tool.d.ts.map

package/dist/runtime-v2/adapter/tools/diagnostician-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostician-tool.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/adapter/tools/diagnostician-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAGhD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,IAYtC,CAAC"}

package/dist/runtime-v2/adapter/tools/diagnostician-tool.js

@@ -0,0 +1,20 @@
+import { DiagnosticianOutputV1Schema } from '../../diagnostician-output.js';
+/**
+ * Tool definition for diagnostician structured output via function calling.
+ *
+ * The `parameters` field uses the canonical TypeBox schema so the provider
+ * receives the same schema that PD validates against — single source of truth.
+ */
+export const RECORD_DIAGNOSIS_V1_TOOL = {
+    name: 'record_diagnosis_v1',
+    description: 'Record a root cause analysis diagnosis result. ' +
+        'Call this tool with the complete diagnosis output including: ' +
+        'summary, rootCause (with category prefix like "Design:" or "People:"), ' +
+        'violatedPrinciples, evidence (with sourceRef and note), ' +
+        'recommendations (kind must be one of: principle, rule, implementation, prompt, defer), ' +
+        'and confidence (0.0-1.0). ' +
+        'All recommendations of kind "principle" must include abstractedPrinciple. ' +
+        'All recommendations of kind "rule" must include triggerPattern and action.',
+    parameters: DiagnosticianOutputV1Schema,
+};
+//# sourceMappingURL=diagnostician-tool.js.map

package/dist/runtime-v2/adapter/tools/diagnostician-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostician-tool.js","sourceRoot":"","sources":["../../../../src/runtime-v2/adapter/tools/diagnostician-tool.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAS;IAC5C,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,iDAAiD;QACjD,+DAA+D;QAC/D,yEAAyE;QACzE,0DAA0D;QAC1D,yFAAyF;QACzF,4BAA4B;QAC5B,4EAA4E;QAC5E,4EAA4E;IAC9E,UAAU,EAAE,2BAA2B;CACxC,CAAC"}

package/dist/runtime-v2/admission-gate.d.ts

@@ -0,0 +1,27 @@
+import type { DiagnosticianOutputV1, RecommendationKind } from './diagnostician-output.js';
+export type PainProvenance = 'openclaw_context_bound' | 'owner_reported_no_host_trace' | 'automatic_hook';
+export type AdmissionDecision = 'admitted' | 'needs_evidence' | 'deferred';
+export declare const ADMISSION_CONFIDENCE_THRESHOLD = 0.5;
+export interface AdmissionGateInput {
+    recommendationKind: RecommendationKind;
+    confidence: number;
+    evidenceCount: number;
+    provenance: PainProvenance | undefined;
+}
+export interface AdmissionGateResult {
+    decision: AdmissionDecision;
+    reason: string;
+    nextAction: string;
+    evidenceStatus: string;
+}
+export declare function evaluateAdmission(input: AdmissionGateInput): AdmissionGateResult;
+export interface CandidateAdmissionResult {
+    candidateId: string;
+    recommendationKind: RecommendationKind;
+    admission: AdmissionGateResult;
+}
+export declare function evaluateCandidateAdmissions(candidates: readonly {
+    candidateId: string;
+    recommendationKind: RecommendationKind;
+}[], output: DiagnosticianOutputV1, provenance: PainProvenance | undefined): CandidateAdmissionResult[];
+//# sourceMappingURL=admission-gate.d.ts.map

package/dist/runtime-v2/admission-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission-gate.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/admission-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE3F,MAAM,MAAM,cAAc,GACtB,wBAAwB,GACxB,8BAA8B,GAC9B,gBAAgB,CAAC;AAErB,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,gBAAgB,GAAG,UAAU,CAAC;AAE3E,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,cAAc,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CA2ChF;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,SAAS,EAAE,mBAAmB,CAAC;CAChC;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,SAAS;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,kBAAkB,CAAA;CAAE,EAAE,EACtF,MAAM,EAAE,qBAAqB,EAC7B,UAAU,EAAE,cAAc,GAAG,SAAS,GACrC,wBAAwB,EAAE,CAc5B"}

package/dist/runtime-v2/admission-gate.js

@@ -0,0 +1,57 @@
+export const ADMISSION_CONFIDENCE_THRESHOLD = 0.5;
+export function evaluateAdmission(input) {
+    if (input.recommendationKind === 'defer') {
+        return {
+            decision: 'deferred',
+            reason: 'recommendation_kind_defer_not_actionable',
+            nextAction: 'review_defer_disposition_manually',
+            evidenceStatus: input.provenance ?? 'unknown',
+        };
+    }
+    if (input.provenance === 'owner_reported_no_host_trace') {
+        return {
+            decision: 'needs_evidence',
+            reason: 'provenance_owner_reported_no_host_trace',
+            nextAction: 'provide_host_session_evidence_or_manual_review',
+            evidenceStatus: 'owner_reported_no_host_trace',
+        };
+    }
+    if (input.confidence < ADMISSION_CONFIDENCE_THRESHOLD) {
+        return {
+            decision: 'needs_evidence',
+            reason: `confidence_below_threshold:${input.confidence.toFixed(2)}<${ADMISSION_CONFIDENCE_THRESHOLD}`,
+            nextAction: 'provide_additional_evidence_or_manual_review',
+            evidenceStatus: input.provenance ?? 'unknown',
+        };
+    }
+    if (input.evidenceCount === 0) {
+        return {
+            decision: 'needs_evidence',
+            reason: 'evidence_array_empty',
+            nextAction: 'provide_source_evidence_for_diagnosis',
+            evidenceStatus: input.provenance ?? 'unknown',
+        };
+    }
+    return {
+        decision: 'admitted',
+        reason: 'evidence_sufficient',
+        nextAction: 'none',
+        evidenceStatus: input.provenance ?? 'unknown',
+    };
+}
+export function evaluateCandidateAdmissions(candidates, output, provenance) {
+    return candidates.map((candidate) => {
+        const gateInput = {
+            recommendationKind: candidate.recommendationKind,
+            confidence: output.confidence,
+            evidenceCount: output.evidence.length,
+            provenance,
+        };
+        return {
+            candidateId: candidate.candidateId,
+            recommendationKind: candidate.recommendationKind,
+            admission: evaluateAdmission(gateInput),
+        };
+    });
+}
+//# sourceMappingURL=admission-gate.js.map

package/dist/runtime-v2/admission-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission-gate.js","sourceRoot":"","sources":["../../src/runtime-v2/admission-gate.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAgBlD,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,IAAI,KAAK,CAAC,kBAAkB,KAAK,OAAO,EAAE,CAAC;QACzC,OAAO;YACL,QAAQ,EAAE,UAAU;YACpB,MAAM,EAAE,0CAA0C;YAClD,UAAU,EAAE,mCAAmC;YAC/C,cAAc,EAAE,KAAK,CAAC,UAAU,IAAI,SAAS;SAC9C,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,UAAU,KAAK,8BAA8B,EAAE,CAAC;QACxD,OAAO;YACL,QAAQ,EAAE,gBAAgB;YAC1B,MAAM,EAAE,yCAAyC;YACjD,UAAU,EAAE,gDAAgD;YAC5D,cAAc,EAAE,8BAA8B;SAC/C,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,UAAU,GAAG,8BAA8B,EAAE,CAAC;QACtD,OAAO;YACL,QAAQ,EAAE,gBAAgB;YAC1B,MAAM,EAAE,8BAA8B,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,8BAA8B,EAAE;YACrG,UAAU,EAAE,8CAA8C;YAC1D,cAAc,EAAE,KAAK,CAAC,UAAU,IAAI,SAAS;SAC9C,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,QAAQ,EAAE,gBAAgB;YAC1B,MAAM,EAAE,sBAAsB;YAC9B,UAAU,EAAE,uCAAuC;YACnD,cAAc,EAAE,KAAK,CAAC,UAAU,IAAI,SAAS;SAC9C,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,qBAAqB;QAC7B,UAAU,EAAE,MAAM;QAClB,cAAc,EAAE,KAAK,CAAC,UAAU,IAAI,SAAS;KAC9C,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,2BAA2B,CACzC,UAAsF,EACtF,MAA6B,EAC7B,UAAsC;IAEtC,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;QAClC,MAAM,SAAS,GAAuB;YACpC,kBAAkB,EAAE,SAAS,CAAC,kBAAkB;YAChD,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YACrC,UAAU;SACX,CAAC;QACF,OAAO;YACL,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,kBAAkB,EAAE,SAAS,CAAC,kBAAkB;YAChD,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAC;SACxC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/runtime-v2/agent-spec.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Canonical AgentSpec definition for PD Runtime v2.
+ *
+ * Source: PD Runtime Protocol SPEC v1, Section 11
+ * Source: PD Runtime-Agnostic Architecture v2, Section 7.3
+ * Source: Agent Execution Modes Appendix
+ *
+ * PD specialized agents are first-class objects, not prompt aliases.
+ * Each agent defines its own input/output contracts, capability needs,
+ * timeout/retry policies, and runtime preferences.
+ */
+import { type Static } from '@sinclair/typebox';
+export declare const AgentCapabilityRequirementsSchema: import("@sinclair/typebox").TObject<{
+    /** Agent requires structured JSON output from the runtime. */
+    structuredJson: import("@sinclair/typebox").TBoolean;
+    /** Agent needs to invoke tools during execution. */
+    toolUse: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    /** Agent needs a specific working directory context. */
+    workingDirectory: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+}>;
+export type AgentCapabilityRequirements = Static<typeof AgentCapabilityRequirementsSchema>;
+export declare const AgentTimeoutPolicySchema: import("@sinclair/typebox").TObject<{
+    /** Default timeout in milliseconds for a single execution attempt. */
+    defaultTimeoutMs: import("@sinclair/typebox").TNumber;
+}>;
+export type AgentTimeoutPolicy = Static<typeof AgentTimeoutPolicySchema>;
+export declare const AgentRetryPolicySchema: import("@sinclair/typebox").TObject<{
+    /** Maximum number of execution attempts before marking the task as failed. */
+    maxAttempts: import("@sinclair/typebox").TInteger;
+}>;
+export type AgentRetryPolicy = Static<typeof AgentRetryPolicySchema>;
+export declare const AgentSpecSchema: import("@sinclair/typebox").TObject<{
+    /** Unique agent identifier (e.g., "diagnostician", "explorer"). */
+    agentId: import("@sinclair/typebox").TString;
+    /** Human-readable role name. */
+    role: import("@sinclair/typebox").TString;
+    /**
+     * Schema version for this AgentSpec.
+     * Allows explicit evolution of agent contracts.
+     */
+    schemaVersion: import("@sinclair/typebox").TString;
+    /** Reference to the input schema this agent expects. */
+    inputSchemaRef: import("@sinclair/typebox").TString;
+    /** Reference to the output schema this agent produces. */
+    outputSchemaRef: import("@sinclair/typebox").TString;
+    /** Reference to the artifact contract, if the agent produces artifacts. */
+    artifactContractRef: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /** Timeout policy for this agent's executions. */
+    timeoutPolicy: import("@sinclair/typebox").TObject<{
+        /** Default timeout in milliseconds for a single execution attempt. */
+        defaultTimeoutMs: import("@sinclair/typebox").TNumber;
+    }>;
+    /** Retry policy for failed executions. */
+    retryPolicy: import("@sinclair/typebox").TObject<{
+        /** Maximum number of execution attempts before marking the task as failed. */
+        maxAttempts: import("@sinclair/typebox").TInteger;
+    }>;
+    /** Capability requirements that the runtime must satisfy. */
+    capabilitiesRequired: import("@sinclair/typebox").TObject<{
+        /** Agent requires structured JSON output from the runtime. */
+        structuredJson: import("@sinclair/typebox").TBoolean;
+        /** Agent needs to invoke tools during execution. */
+        toolUse: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+        /** Agent needs a specific working directory context. */
+        workingDirectory: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    }>;
+    /** Preferred runtime kinds, in order of preference. */
+    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">]>>>;
+    /** Preferred model profile (e.g., "strong-reasoning", "fast-lightweight"). */
+    preferredModelProfile: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type AgentSpec = Static<typeof AgentSpecSchema>;
+export declare const AGENT_IDS: {
+    readonly DIAGNOSTICIAN: "diagnostician";
+    readonly EXPLORER: "explorer";
+    readonly DREAMER: "dreamer";
+    readonly PHILOSOPHER: "philosopher";
+    readonly SCRIBE: "scribe";
+    readonly ARTIFICER: "artificer";
+    readonly REPLAY_JUDGE: "replay-judge";
+    readonly RULE_AUTHOR: "rule-author";
+    readonly EMPATHY_OBSERVER: "empathy-observer";
+    readonly CORRECTION_OBSERVER: "correction-observer";
+};
+export type WellKnownAgentId = (typeof AGENT_IDS)[keyof typeof AGENT_IDS];
+//# sourceMappingURL=agent-spec.d.ts.map

package/dist/runtime-v2/agent-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-spec.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/agent-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAMtD,eAAO,MAAM,iCAAiC;IAC5C,8DAA8D;;IAE9D,oDAAoD;;IAEpD,wDAAwD;;EAExD,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAI3F,eAAO,MAAM,wBAAwB;IACnC,sEAAsE;;EAEtE,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAIzE,eAAO,MAAM,sBAAsB;IACjC,8EAA8E;;EAE9E,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAIrE,eAAO,MAAM,eAAe;IAC1B,mEAAmE;;IAGnE,gCAAgC;;IAGhC;;;OAGG;;IAGH,wDAAwD;;IAGxD,0DAA0D;;IAG1D,2EAA2E;;IAG3E,kDAAkD;;QAvClD,sEAAsE;;;IA0CtE,0CAA0C;;QAjC1C,8EAA8E;;;IAoC9E,6DAA6D;;QA1D7D,8DAA8D;;QAE9D,oDAAoD;;QAEpD,wDAAwD;;;IAyDxD,uDAAuD;;IAGvD,8EAA8E;;EAE9E,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AAIvD,eAAO,MAAM,SAAS;;;;;;;;;;;CAWZ,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC"}

package/dist/runtime-v2/agent-spec.js

@@ -0,0 +1,74 @@
+/**
+ * Canonical AgentSpec definition for PD Runtime v2.
+ *
+ * Source: PD Runtime Protocol SPEC v1, Section 11
+ * Source: PD Runtime-Agnostic Architecture v2, Section 7.3
+ * Source: Agent Execution Modes Appendix
+ *
+ * PD specialized agents are first-class objects, not prompt aliases.
+ * Each agent defines its own input/output contracts, capability needs,
+ * timeout/retry policies, and runtime preferences.
+ */
+import { Type } from '@sinclair/typebox';
+import { RuntimeKindSchema } from './runtime-protocol.js';
+// ── Capability requirements that an agent declares it needs ──
+export const AgentCapabilityRequirementsSchema = Type.Object({
+    /** Agent requires structured JSON output from the runtime. */
+    structuredJson: Type.Boolean(),
+    /** Agent needs to invoke tools during execution. */
+    toolUse: Type.Optional(Type.Boolean()),
+    /** Agent needs a specific working directory context. */
+    workingDirectory: Type.Optional(Type.Boolean()),
+});
+// ── Timeout policy ──
+export const AgentTimeoutPolicySchema = Type.Object({
+    /** Default timeout in milliseconds for a single execution attempt. */
+    defaultTimeoutMs: Type.Number({ minimum: 0 }),
+});
+// ── Retry policy ──
+export const AgentRetryPolicySchema = Type.Object({
+    /** Maximum number of execution attempts before marking the task as failed. */
+    maxAttempts: Type.Integer({ minimum: 1 }),
+});
+// ── AgentSpec: the canonical agent description ──
+export const AgentSpecSchema = Type.Object({
+    /** Unique agent identifier (e.g., "diagnostician", "explorer"). */
+    agentId: Type.String({ minLength: 1 }),
+    /** Human-readable role name. */
+    role: Type.String({ minLength: 1 }),
+    /**
+     * Schema version for this AgentSpec.
+     * Allows explicit evolution of agent contracts.
+     */
+    schemaVersion: Type.String({ minLength: 1 }),
+    /** Reference to the input schema this agent expects. */
+    inputSchemaRef: Type.String({ minLength: 1 }),
+    /** Reference to the output schema this agent produces. */
+    outputSchemaRef: Type.String({ minLength: 1 }),
+    /** Reference to the artifact contract, if the agent produces artifacts. */
+    artifactContractRef: Type.Optional(Type.String()),
+    /** Timeout policy for this agent's executions. */
+    timeoutPolicy: AgentTimeoutPolicySchema,
+    /** Retry policy for failed executions. */
+    retryPolicy: AgentRetryPolicySchema,
+    /** Capability requirements that the runtime must satisfy. */
+    capabilitiesRequired: AgentCapabilityRequirementsSchema,
+    /** Preferred runtime kinds, in order of preference. */
+    preferredRuntimeKinds: Type.Optional(Type.Array(RuntimeKindSchema)),
+    /** Preferred model profile (e.g., "strong-reasoning", "fast-lightweight"). */
+    preferredModelProfile: Type.Optional(Type.String()),
+});
+// ── Well-known agent IDs ──
+export const AGENT_IDS = {
+    DIAGNOSTICIAN: 'diagnostician',
+    EXPLORER: 'explorer',
+    DREAMER: 'dreamer',
+    PHILOSOPHER: 'philosopher',
+    SCRIBE: 'scribe',
+    ARTIFICER: 'artificer',
+    REPLAY_JUDGE: 'replay-judge',
+    RULE_AUTHOR: 'rule-author',
+    EMPATHY_OBSERVER: 'empathy-observer',
+    CORRECTION_OBSERVER: 'correction-observer',
+};
+//# sourceMappingURL=agent-spec.js.map

package/dist/runtime-v2/agent-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-spec.js","sourceRoot":"","sources":["../../src/runtime-v2/agent-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,gEAAgE;AAEhE,MAAM,CAAC,MAAM,iCAAiC,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3D,8DAA8D;IAC9D,cAAc,EAAE,IAAI,CAAC,OAAO,EAAE;IAC9B,oDAAoD;IACpD,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IACtC,wDAAwD;IACxD,gBAAgB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;CAChD,CAAC,CAAC;AAIH,uBAAuB;AAEvB,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC,MAAM,CAAC;IAClD,sEAAsE;IACtE,gBAAgB,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;CAC9C,CAAC,CAAC;AAIH,qBAAqB;AAErB,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,MAAM,CAAC;IAChD,8EAA8E;IAC9E,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;CAC1C,CAAC,CAAC;AAIH,mDAAmD;AAEnD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC;IACzC,mEAAmE;IACnE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAEtC,gCAAgC;IAChC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAEnC;;;OAGG;IACH,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAE5C,wDAAwD;IACxD,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAE7C,0DAA0D;IAC1D,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAE9C,2EAA2E;IAC3E,mBAAmB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAEjD,kDAAkD;IAClD,aAAa,EAAE,wBAAwB;IAEvC,0CAA0C;IAC1C,WAAW,EAAE,sBAAsB;IAEnC,6DAA6D;IAC7D,oBAAoB,EAAE,iCAAiC;IAEvD,uDAAuD;IACvD,qBAAqB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAEnE,8EAA8E;IAC9E,qBAAqB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;CACpD,CAAC,CAAC;AAIH,6BAA6B;AAE7B,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,aAAa,EAAE,eAAe;IAC9B,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,aAAa;IAC1B,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,gBAAgB,EAAE,kBAAkB;IACpC,mBAAmB,EAAE,qBAAqB;CAClC,CAAC"}

package/dist/runtime-v2/candidate-audit.d.ts

@@ -0,0 +1,8 @@
+export interface CandidateAuditResult {
+    status: 'ok' | 'degraded' | 'error';
+    consumedCount: number;
+    orphanCandidateCount: number;
+    missingLedgerCount: number;
+}
+export declare function auditCandidateLedgerConsistency(workspaceDir: string): Promise<CandidateAuditResult>;
+//# sourceMappingURL=candidate-audit.d.ts.map

package/dist/runtime-v2/candidate-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-audit.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/candidate-audit.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,OAAO,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAsB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAwCzG"}

package/dist/runtime-v2/candidate-audit.js

@@ -0,0 +1,47 @@
+/**
+ * Candidate/ledger consistency audit — extracted from CLI for core reuse.
+ *
+ * Checks that every consumed candidate in state.db has a corresponding
+ * ledger entry in principle_training_state.json.
+ *
+ * PRI-28: Extracted so OperatorHealthReadModel can reuse without CLI side effects.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import Database from 'better-sqlite3';
+import { loadLedger } from '../principle-tree-ledger.js';
+export async function auditCandidateLedgerConsistency(workspaceDir) {
+    const pdDbPath = path.join(workspaceDir, '.pd', 'state.db');
+    const stateDir = path.join(workspaceDir, '.state');
+    if (!fs.existsSync(pdDbPath)) {
+        return { status: 'error', consumedCount: 0, orphanCandidateCount: 0, missingLedgerCount: 0 };
+    }
+    try {
+        const db = new Database(pdDbPath, { readonly: true });
+        try {
+            const consumedRows = db.prepare("SELECT candidate_id FROM principle_candidates WHERE status = 'consumed'").all();
+            const consumedIds = consumedRows.map(r => r.candidate_id);
+            const ledger = loadLedger(stateDir);
+            const ledgerPrinciples = Object.values(ledger.tree.principles);
+            let missingCount = 0;
+            for (const candidateId of consumedIds) {
+                const found = ledgerPrinciples.some(p => p.derivedFromPainIds?.includes(candidateId));
+                if (!found)
+                    missingCount++;
+            }
+            return {
+                status: missingCount === 0 ? 'ok' : 'degraded',
+                consumedCount: consumedIds.length,
+                orphanCandidateCount: missingCount,
+                missingLedgerCount: missingCount,
+            };
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch {
+        return { status: 'error', consumedCount: 0, orphanCandidateCount: 0, missingLedgerCount: 0 };
+    }
+}
+//# sourceMappingURL=candidate-audit.js.map

package/dist/runtime-v2/candidate-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-audit.js","sourceRoot":"","sources":["../../src/runtime-v2/candidate-audit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AASzD,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,YAAoB;IACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAEnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,oBAAoB,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC;IAC/F,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,EAAE,CAAC,OAAO,CAC7B,yEAAyE,CAC1E,CAAC,GAAG,EAAgC,CAAC;YAEtC,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;YAE1D,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YACpC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAE/D,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,KAAK,MAAM,WAAW,IAAI,WAAW,EAAE,CAAC;gBACtC,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACtC,CAAC,CAAC,kBAAkB,EAAE,QAAQ,CAAC,WAAW,CAAC,CAC5C,CAAC;gBACF,IAAI,CAAC,KAAK;oBAAE,YAAY,EAAE,CAAC;YAC7B,CAAC;YAED,OAAO;gBACL,MAAM,EAAE,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU;gBAC9C,aAAa,EAAE,WAAW,CAAC,MAAM;gBACjC,oBAAoB,EAAE,YAAY;gBAClC,kBAAkB,EAAE,YAAY;aACjC,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,oBAAoB,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAAC;IAC/F,CAAC;AACH,CAAC"}

package/dist/runtime-v2/candidate-intake-service.d.ts

@@ -0,0 +1,43 @@
+/**
+ * CandidateIntakeService — consumes pending candidates and writes ledger entries.
+ *
+ * Workflow:
+ *   1. Validate input
+ *   2. Check idempotency (existsForCandidate) — O(1) lookup
+ *   3. Load candidate from DB (RuntimeStateManager)
+ *   4. Load artifact from DB and parse recommendation
+ *   5. Build 11-field LedgerPrincipleEntry
+ *   6. Write via adapter.writeProbationEntry()
+ *
+ * On error: candidate stays `pending`, throws CandidateIntakeError.
+ * Idempotent: if adapter already has entry for candidate, returns it (no-op).
+ *
+ * Non-goals (M7):
+ *   - No DB status update to 'consumed' (m7-04 CLI handler does that)
+ *   - No promotion to active principle (M8+)
+ *   - No pain signal bridge
+ */
+import type { LedgerAdapter, LedgerPrincipleEntry } from './candidate-intake.js';
+import type { RuntimeStateManager } from './store/runtime-state-manager.js';
+export interface CandidateIntakeServiceOptions {
+    stateManager: RuntimeStateManager;
+    ledgerAdapter: LedgerAdapter;
+}
+export declare class CandidateIntakeService {
+    #private;
+    constructor(opts: CandidateIntakeServiceOptions);
+    /**
+     * Consume a pending candidate: load it and its artifact, build a
+     * LedgerPrincipleEntry, and write it to the ledger via the adapter.
+     *
+     * @param candidateId - The candidate ID to intake.
+     * @returns The written (or existing) LedgerPrincipleEntry.
+     * @throws CandidateIntakeError with code:
+     *   - INPUT_INVALID when candidateId is empty/invalid
+     *   - CANDIDATE_NOT_FOUND when candidate does not exist
+     *   - ARTIFACT_NOT_FOUND when artifact is missing or unreadable
+     *   - LEDGER_WRITE_FAILED when ledger write fails
+     */
+    intake(candidateId: string): Promise<LedgerPrincipleEntry>;
+}
+//# sourceMappingURL=candidate-intake-service.d.ts.map

package/dist/runtime-v2/candidate-intake-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-intake-service.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/candidate-intake-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAU5E,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,mBAAmB,CAAC;IAClC,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,qBAAa,sBAAsB;;gBAIrB,IAAI,EAAE,6BAA6B;IAK/C;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAmGjE"}