create-principles-disciple 1.0.0 → 1.74.0

package/core/dist/runtime-v2/adapter/structured-output-repair.js

@@ -0,0 +1,259 @@
+/**
+ * Structured output repair module — reusable, runtime-agnostic schema repair loop.
+ *
+ * When an LLM returns valid JSON that fails TypeBox schema validation, this module
+ * generates a bounded repair prompt containing the previous output and specific
+ * validation errors, then calls the LLM again for a corrected response.
+ *
+ * Design principles:
+ *   - Generic over T — no Diagnostician-specific knowledge
+ *   - Callback-based — schemaCheck and llmCaller are injected, no pi-ai imports
+ *   - Bounded — all prompts and error summaries are size-limited
+ *   - Fail-closed — if repair output still fails schemaCheck, return repaired=false
+ *   - Lineage-safe — repair must not silently override lineage fields (PRI-200)
+ *
+ * PRI-71: First integration target is Diagnostician via PiAiRuntimeAdapter.
+ * PRI-200: Evidence pack, schemaRef in prompt, lineage protection, repairAttempts[].
+ * Future peer runners (Dreamer, Philosopher, etc.) can reuse the same module.
+ */
+import { REPAIR_PROMPT_VERSION, preserveLineageFields, truncatePreview, formatValidationErrorEntry, normalizeMaxRepairAttempts, safeStringifyPreview } from './output-repair-contract.js';
+/** Sensible defaults for repair configuration. */
+export const DEFAULT_REPAIR_CONFIG = {
+    maxRepairAttempts: 3,
+    maxErrorsInPrompt: 10,
+    maxErrorChars: 200,
+    maxRawOutputChars: 2000,
+};
+// Re-export from json-extractor so callers can use a single import path
+export { extractJsonObject } from './json-extractor.js';
+import { extractJsonObject } from './json-extractor.js';
+/**
+ * Derive a human-readable schema summary from a TypeBox schema (PRI-271 A2).
+ *
+ * Produces a compact text description of field names, types, required status,
+ * and enum values — suitable for inclusion in repair prompts so the LLM knows
+ * the target schema structure without needing the full JSON Schema.
+ */
+export function deriveSchemaSummary(schema) {
+    if (!schema || typeof schema !== 'object')
+        return '(unknown schema)';
+    // Handle Object schemas
+    if (schema.type === 'object' && schema.properties) {
+        const required = Array.isArray(schema.required) ? new Set(schema.required) : new Set();
+        const lines = [];
+        const props = schema.properties;
+        for (const [key, propSchema] of Object.entries(props)) {
+            if (typeof propSchema !== 'object' || propSchema === null)
+                continue;
+            const isReq = required.has(key);
+            const reqMark = isReq ? ' (required)' : ' (optional)';
+            if (propSchema.type === 'array') {
+                const items = propSchema.items;
+                const itemType = items?.type ?? 'unknown';
+                lines.push(`  ${key}: ${itemType}[]${reqMark}`);
+            }
+            else if (propSchema.enum) {
+                const values = propSchema.enum.map(String).join(' | ');
+                lines.push(`  ${key}: enum(${values})${reqMark}`);
+            }
+            else if (propSchema.type) {
+                const typeStr = typeof propSchema.type === 'string' ? propSchema.type : 'unknown';
+                const constraints = [];
+                if (typeof propSchema.minimum === 'number')
+                    constraints.push(`min: ${propSchema.minimum}`);
+                if (typeof propSchema.maximum === 'number')
+                    constraints.push(`max: ${propSchema.maximum}`);
+                if (typeof propSchema.minLength === 'number')
+                    constraints.push(`minLength: ${propSchema.minLength}`);
+                const constraintStr = constraints.length > 0 ? ` {${constraints.join(', ')}}` : '';
+                lines.push(`  ${key}: ${typeStr}${constraintStr}${reqMark}`);
+            }
+            else if (propSchema.anyOf || propSchema.allOf || propSchema.oneOf) {
+                lines.push(`  ${key}: union${reqMark}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    // Fallback for non-object schemas
+    if (schema.type)
+        return `type: ${schema.type}`;
+    return '(complex schema)';
+}
+/**
+ * Compute jitter delay for repair attempt backoff (PRI-271 A3).
+ * Returns delay in milliseconds: 200-500ms random jitter.
+ * Overridable via config._testJitterMs for deterministic tests.
+ */
+function computeJitterDelay(config) {
+    if (config._testJitterMs !== undefined)
+        return config._testJitterMs;
+    return 200 + Math.random() * 300;
+}
+/**
+ * Format TypeBox schema errors into a bounded, human-readable repair prompt.
+ *
+ * PRI-200: Includes schemaRef when available.
+ */
+export function formatRepairPrompt(invalidJson, errors, config = {}) {
+    const cfg = { ...DEFAULT_REPAIR_CONFIG, ...config };
+    let rawJson = safeStringifyPreview(invalidJson, cfg.maxRawOutputChars);
+    if (rawJson.length > cfg.maxRawOutputChars) {
+        rawJson = rawJson.slice(0, cfg.maxRawOutputChars) + '\n...[truncated]';
+    }
+    const boundedErrors = errors.slice(0, cfg.maxErrorsInPrompt);
+    const errorLines = boundedErrors.map(e => {
+        const msg = e.message.length > cfg.maxErrorChars
+            ? e.message.slice(0, cfg.maxErrorChars) + '...'
+            : e.message;
+        return `- ${e.path}: ${msg}`;
+    });
+    const skippedCount = errors.length > cfg.maxErrorsInPrompt
+        ? errors.length - cfg.maxErrorsInPrompt
+        : 0;
+    const schemaRefLine = cfg.schemaRef
+        ? [`SCHEMA REF: ${cfg.schemaRef}`, '']
+        : [];
+    const schemaSummaryBlock = cfg.schemaSummary
+        ? ['EXPECTED SCHEMA:', cfg.schemaSummary, '']
+        : [];
+    return [
+        'This is a schema validation repair loop. Your previous JSON output still has errors. Fix ALL remaining errors and return the complete corrected JSON object.',
+        '',
+        ...schemaRefLine,
+        ...schemaSummaryBlock,
+        'PREVIOUS OUTPUT:',
+        rawJson,
+        '',
+        'SCHEMA ERRORS:',
+        ...errorLines,
+        ...(skippedCount > 0 ? [`${skippedCount} more error(s) omitted`] : []),
+        '',
+        'INSTRUCTION: Output ONLY the complete corrected JSON object. No markdown, no explanation.',
+    ].join('\n');
+}
+function buildValidationErrorEntries(errors) {
+    return errors.slice(0, 10).map(e => formatValidationErrorEntry(e.path, e.message, e.value));
+}
+/**
+ * Attempt to repair structurally invalid LLM output by re-prompting
+ * the LLM with specific validation errors.
+ *
+ * Returns RepairResult<T> — either repaired+validated output or null.
+ * Bounded by maxRepairAttempts (default 3).
+ *
+ * PRI-200: Returns repairAttempts[] for evidence pack, protects lineage fields.
+ */
+// eslint-disable-next-line @typescript-eslint/max-params -- callbacks and config are intentionally separate for clarity
+export async function attemptStructuredOutputRepair(invalidOutput, schemaErrors, callbacks, config) {
+    const cfg = { ...DEFAULT_REPAIR_CONFIG, ...config, maxRepairAttempts: normalizeMaxRepairAttempts(config?.maxRepairAttempts, DEFAULT_REPAIR_CONFIG.maxRepairAttempts) };
+    const repairAttempts = [];
+    let currentErrors = schemaErrors;
+    if (currentErrors.length === 0 || cfg.maxRepairAttempts <= 0) {
+        return {
+            repaired: false,
+            output: null,
+            attemptsUsed: 0,
+            repairSummary: `Repair skipped: ${currentErrors.length === 0 ? 'no errors' : 'maxRepairAttempts=0'}`,
+            repairAttempts,
+        };
+    }
+    const errorSummary = `${currentErrors.length} errors: ${currentErrors.slice(0, 3).map(e => e.path).join(', ')}`;
+    for (let attempt = 0; attempt < cfg.maxRepairAttempts; attempt++) {
+        const attemptValidationErrors = buildValidationErrorEntries(currentErrors);
+        const prompt = formatRepairPrompt(invalidOutput, currentErrors, cfg);
+        // eslint-disable-next-line @typescript-eslint/init-declarations -- assigned in try block below
+        let rawResponse;
+        try {
+            rawResponse = await callbacks.llmCaller(prompt);
+        }
+        catch (err) {
+            const errorDetail = err instanceof Error ? err.message : String(err);
+            repairAttempts.push({
+                schemaRef: cfg.schemaRef ?? 'unknown',
+                attempt: attempt + 1,
+                rawOutputPreview: safeStringifyPreview(invalidOutput),
+                validationErrors: attemptValidationErrors,
+                repairPromptVersion: REPAIR_PROMPT_VERSION,
+                repaired: false,
+            });
+            return {
+                repaired: false,
+                output: null,
+                attemptsUsed: attempt + 1,
+                repairSummary: `Repair failed at attempt ${attempt + 1}: llmCaller threw "${errorDetail}". ${errorSummary}`,
+                repairAttempts,
+            };
+        }
+        if (!rawResponse) {
+            repairAttempts.push({
+                schemaRef: cfg.schemaRef ?? 'unknown',
+                attempt: attempt + 1,
+                rawOutputPreview: safeStringifyPreview(invalidOutput),
+                validationErrors: attemptValidationErrors,
+                repairPromptVersion: REPAIR_PROMPT_VERSION,
+                repaired: false,
+            });
+            continue;
+        }
+        const repairedCandidate = extractJsonObject(rawResponse);
+        if (!repairedCandidate) {
+            repairAttempts.push({
+                schemaRef: cfg.schemaRef ?? 'unknown',
+                attempt: attempt + 1,
+                rawOutputPreview: truncatePreview(rawResponse),
+                validationErrors: attemptValidationErrors,
+                repairPromptVersion: REPAIR_PROMPT_VERSION,
+                repaired: false,
+            });
+            continue;
+        }
+        // PRI-200: Protect lineage fields — if originalOutput provided, preserve lineage
+        let candidateWithLineage = repairedCandidate;
+        if (cfg.originalOutput && typeof repairedCandidate === 'object' && repairedCandidate !== null) {
+            candidateWithLineage = preserveLineageFields(cfg.originalOutput, repairedCandidate);
+        }
+        if (callbacks.schemaCheck(candidateWithLineage)) {
+            repairAttempts.push({
+                schemaRef: cfg.schemaRef ?? 'unknown',
+                attempt: attempt + 1,
+                rawOutputPreview: truncatePreview(rawResponse),
+                validationErrors: attemptValidationErrors,
+                repairPromptVersion: REPAIR_PROMPT_VERSION,
+                repaired: true,
+            });
+            return {
+                repaired: true,
+                output: candidateWithLineage,
+                attemptsUsed: attempt + 1,
+                repairSummary: `Repair succeeded at attempt ${attempt + 1}. ${errorSummary}`,
+                repairAttempts,
+            };
+        }
+        const nextErrors = callbacks.schemaErrors
+            ? callbacks.schemaErrors(candidateWithLineage)
+            : currentErrors;
+        repairAttempts.push({
+            schemaRef: cfg.schemaRef ?? 'unknown',
+            attempt: attempt + 1,
+            rawOutputPreview: truncatePreview(rawResponse),
+            validationErrors: attemptValidationErrors,
+            repairPromptVersion: REPAIR_PROMPT_VERSION,
+            repaired: false,
+        });
+        invalidOutput = candidateWithLineage;
+        currentErrors = nextErrors;
+        // PRI-271 A3: Jitter between repair attempts to avoid provider rate limits
+        if (attempt < cfg.maxRepairAttempts - 1) {
+            const jitterMs = computeJitterDelay(cfg);
+            await new Promise(r => setTimeout(r, jitterMs));
+        }
+    }
+    return {
+        repaired: false,
+        output: null,
+        attemptsUsed: cfg.maxRepairAttempts,
+        repairSummary: `Repair failed after ${cfg.maxRepairAttempts} attempt(s). ${errorSummary}`,
+        repairAttempts,
+    };
+}
+//# sourceMappingURL=structured-output-repair.js.map

package/core/dist/runtime-v2/adapter/structured-output-repair.js.map

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

package/core/dist/runtime-v2/adapter/test-double-runtime-adapter.d.ts

@@ -0,0 +1,35 @@
+/**
+ * TestDoubleRuntimeAdapter — test double for PDRuntimeAdapter.
+ *
+ * First real implementation of the M1 PDRuntimeAdapter interface.
+ * Default behavior: succeed-on-first-poll with valid DiagnosticianOutputV1.
+ * All methods overridable via TestDoubleBehaviorOverrides callbacks.
+ */
+import type { PDRuntimeAdapter, RuntimeKind, RuntimeCapabilities, RuntimeHealth, RunHandle, RunStatus, StartRunInput, StructuredRunOutput, RuntimeArtifactRef, ContextItem } from '../runtime-protocol.js';
+/** Optional callbacks to override default TestDoubleRuntimeAdapter behavior. */
+export interface TestDoubleBehaviorOverrides {
+    readonly onStartRun?: (input: StartRunInput) => RunHandle | Promise<RunHandle>;
+    readonly onPollRun?: (runId: string) => RunStatus | Promise<RunStatus>;
+    readonly onFetchOutput?: (runId: string) => StructuredRunOutput | null | Promise<StructuredRunOutput | null>;
+    readonly onCancelRun?: (runId: string) => void | Promise<void>;
+    readonly onGetCapabilities?: () => RuntimeCapabilities | Promise<RuntimeCapabilities>;
+    readonly onHealthCheck?: () => RuntimeHealth | Promise<RuntimeHealth>;
+    readonly onFetchArtifacts?: (runId: string) => RuntimeArtifactRef[] | Promise<RuntimeArtifactRef[]>;
+    readonly onAppendContext?: (runId: string, items: ContextItem[]) => void | Promise<void>;
+}
+export declare class TestDoubleRuntimeAdapter implements PDRuntimeAdapter {
+    private readonly overrides;
+    private readonly defaultTaskId;
+    private runCounter;
+    constructor(overrides?: TestDoubleBehaviorOverrides, defaultTaskId?: string);
+    kind(): RuntimeKind;
+    getCapabilities(): Promise<RuntimeCapabilities>;
+    healthCheck(): Promise<RuntimeHealth>;
+    startRun(input: StartRunInput): Promise<RunHandle>;
+    pollRun(runId: string): Promise<RunStatus>;
+    cancelRun(runId: string): Promise<void>;
+    fetchOutput(runId: string): Promise<StructuredRunOutput | null>;
+    fetchArtifacts(runId: string): Promise<RuntimeArtifactRef[]>;
+    appendContext(runId: string, items: ContextItem[]): Promise<void>;
+}
+//# sourceMappingURL=test-double-runtime-adapter.d.ts.map

package/core/dist/runtime-v2/adapter/test-double-runtime-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-double-runtime-adapter.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/adapter/test-double-runtime-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAEhC,gFAAgF;AAChF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/E,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACvE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,mBAAmB,GAAG,IAAI,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IAC7G,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACtE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,kBAAkB,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACpG,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1F;AAED,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,UAAU,CAAK;gBAEX,SAAS,CAAC,EAAE,2BAA2B,EAAE,aAAa,CAAC,EAAE,MAAM;IAM3E,IAAI,IAAI,WAAW;IAIb,eAAe,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAiB/C,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC;IAYrC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;IAYlD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAQ1C,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAoB/D,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAO5D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAKxE"}

package/core/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/core/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/core/dist/runtime-v2/adapter/tools/diagnostician-tool.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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';
+import type { TSchema } from '@sinclair/typebox';
+import type { SchemaPromptAdapter } from '../schema-prompt-adapter.js';
+export declare function buildRecordDiagnosisV1Tool(adapter: SchemaPromptAdapter, schema: TSchema): Tool;
+//# sourceMappingURL=diagnostician-tool.d.ts.map

package/core/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;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,OAAO,GACd,IAAI,CAMN"}

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

@@ -0,0 +1,8 @@
+export function buildRecordDiagnosisV1Tool(adapter, schema) {
+    return {
+        name: 'record_diagnosis_v1',
+        description: `Record a root cause analysis diagnosis result. ${adapter.generateConstraints(schema)}`,
+        parameters: schema,
+    };
+}
+//# sourceMappingURL=diagnostician-tool.js.map

package/core/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":"AAgBA,MAAM,UAAU,0BAA0B,CACxC,OAA4B,EAC5B,MAAe;IAEf,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,kDAAkD,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE;QACpG,UAAU,EAAE,MAAM;KACnB,CAAC;AACJ,CAAC"}

package/core/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/core/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/core/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/core/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/core/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/core/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"}