@principles/core 1.73.0

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

@@ -0,0 +1,123 @@
+/**
+ * TestDoubleRuntimeAdapter unit tests.
+ *
+ * Verifies default behavior (succeed-on-first-poll) and callback override mechanism.
+ */
+import { describe, it, expect } from 'vitest';
+import { TestDoubleRuntimeAdapter } from '../test-double-runtime-adapter.js';
+describe('TestDoubleRuntimeAdapter', () => {
+    describe('default behavior', () => {
+        it('returns kind "test-double"', () => {
+            const adapter = new TestDoubleRuntimeAdapter();
+            expect(adapter.kind()).toBe('test-double');
+        });
+        it('startRun returns RunHandle with runId, runtimeKind, and valid ISO startedAt', async () => {
+            const adapter = new TestDoubleRuntimeAdapter();
+            const handle = await adapter.startRun({
+                agentSpec: { agentId: 'test', schemaVersion: 'v1' },
+                inputPayload: {},
+                contextItems: [],
+                timeoutMs: 5000,
+            });
+            expect(handle.runId).toMatch(/^td-\d+$/);
+            expect(handle.runtimeKind).toBe('test-double');
+            expect(new Date(handle.startedAt).toISOString()).toBe(handle.startedAt);
+        });
+        it('pollRun returns succeeded status on first call', async () => {
+            const adapter = new TestDoubleRuntimeAdapter();
+            const status = await adapter.pollRun('td-1');
+            expect(status.runId).toBe('td-1');
+            expect(status.status).toBe('succeeded');
+            expect(status.endedAt).toBeDefined();
+        });
+        it('fetchOutput returns valid DiagnosticianOutputV1 payload by default', async () => {
+            const adapter = new TestDoubleRuntimeAdapter({}, 'task-42');
+            const output = await adapter.fetchOutput('td-1');
+            expect(output).not.toBeNull();
+            const result = output;
+            expect(result.runId).toBe('td-1');
+            const { payload } = result;
+            expect(payload.valid).toBe(true);
+            expect(payload.taskId).toBe('task-42');
+            expect(payload.summary).toBeTruthy();
+            expect(payload.rootCause).toBeTruthy();
+            expect(payload.confidence).toBeGreaterThanOrEqual(0);
+            expect(payload.confidence).toBeLessThanOrEqual(1);
+        });
+        it('getCapabilities returns capabilities with structuredJsonOutput=true and cancellation=true', async () => {
+            const adapter = new TestDoubleRuntimeAdapter();
+            const caps = await adapter.getCapabilities();
+            expect(caps.supportsStructuredJsonOutput).toBe(true);
+            expect(caps.supportsCancellation).toBe(true);
+            expect(caps.supportsToolUse).toBe(false);
+        });
+        it('healthCheck returns healthy=true, degraded=false', async () => {
+            const adapter = new TestDoubleRuntimeAdapter();
+            const health = await adapter.healthCheck();
+            expect(health.healthy).toBe(true);
+            expect(health.degraded).toBe(false);
+            expect(health.warnings).toEqual([]);
+        });
+        it('cancelRun resolves without error', async () => {
+            const adapter = new TestDoubleRuntimeAdapter();
+            await expect(adapter.cancelRun('td-1')).resolves.toBeUndefined();
+        });
+        it('fetchArtifacts returns empty array', async () => {
+            const adapter = new TestDoubleRuntimeAdapter();
+            const artifacts = await adapter.fetchArtifacts('td-1');
+            expect(artifacts).toEqual([]);
+        });
+    });
+    describe('behavior overrides', () => {
+        it('onStartRun callback overrides default startRun behavior', async () => {
+            const overrides = {
+                onStartRun: (_input) => ({
+                    runId: 'custom-run-999',
+                    runtimeKind: 'test-double',
+                    startedAt: '2026-01-01T00:00:00.000Z',
+                }),
+            };
+            const adapter = new TestDoubleRuntimeAdapter(overrides);
+            const handle = await adapter.startRun({
+                agentSpec: { agentId: 'test', schemaVersion: 'v1' },
+                inputPayload: {},
+                contextItems: [],
+                timeoutMs: 5000,
+            });
+            expect(handle.runId).toBe('custom-run-999');
+        });
+        it('onPollRun callback overrides default pollRun behavior', async () => {
+            const overrides = {
+                onPollRun: (runId) => ({
+                    runId,
+                    status: 'failed',
+                    startedAt: '2026-01-01T00:00:00.000Z',
+                    endedAt: '2026-01-01T00:01:00.000Z',
+                    reason: 'Injected failure',
+                }),
+            };
+            const adapter = new TestDoubleRuntimeAdapter(overrides);
+            const status = await adapter.pollRun('td-1');
+            expect(status.status).toBe('failed');
+            expect(status.reason).toBe('Injected failure');
+        });
+        it('onFetchOutput callback overrides default fetchOutput behavior', async () => {
+            const overrides = {
+                onFetchOutput: () => null,
+            };
+            const adapter = new TestDoubleRuntimeAdapter(overrides);
+            const output = await adapter.fetchOutput('td-1');
+            expect(output).toBeNull();
+        });
+        it('onCancelRun callback is invoked when cancelRun is called', async () => {
+            const cancelledRunIds = [];
+            const overrides = {
+                onCancelRun: (runId) => { cancelledRunIds.push(runId); },
+            };
+            const adapter = new TestDoubleRuntimeAdapter(overrides);
+            await adapter.cancelRun('td-42');
+            expect(cancelledRunIds).toEqual(['td-42']);
+        });
+    });
+});
+//# sourceMappingURL=test-double-runtime-adapter.test.js.map

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

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

package/dist/runtime-v2/adapter/index.d.ts

@@ -0,0 +1,10 @@
+export { TestDoubleRuntimeAdapter } from './test-double-runtime-adapter.js';
+export type { TestDoubleBehaviorOverrides } from './test-double-runtime-adapter.js';
+export { OpenClawCliRuntimeAdapter } from './openclaw-cli-runtime-adapter.js';
+export type { OpenClawCliRuntimeAdapterOptions } from './openclaw-cli-runtime-adapter.js';
+export { PiAiRuntimeAdapter } from './pi-ai-runtime-adapter.js';
+export type { PiAiRuntimeAdapterConfig } from './pi-ai-runtime-adapter.js';
+export { extractJsonObject } from './json-extractor.js';
+export { attemptStructuredOutputRepair, formatRepairPrompt, DEFAULT_REPAIR_CONFIG } from './structured-output-repair.js';
+export type { RepairConfig, RepairResult, SchemaValidationError, RepairLLMCaller, RepairCallbacks } from './structured-output-repair.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime-v2/adapter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/adapter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,YAAY,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,YAAY,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,YAAY,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACzH,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/runtime-v2/adapter/index.js

@@ -0,0 +1,6 @@
+export { TestDoubleRuntimeAdapter } from './test-double-runtime-adapter.js';
+export { OpenClawCliRuntimeAdapter } from './openclaw-cli-runtime-adapter.js';
+export { PiAiRuntimeAdapter } from './pi-ai-runtime-adapter.js';
+export { extractJsonObject } from './json-extractor.js';
+export { attemptStructuredOutputRepair, formatRepairPrompt, DEFAULT_REPAIR_CONFIG } from './structured-output-repair.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime-v2/adapter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime-v2/adapter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,6BAA6B,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/runtime-v2/adapter/json-extractor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Balanced-bracket JSON extraction from LLM output.
+ *
+ * Handles prose-wrapped and code-fenced JSON (```json ... ```).
+ * Shared utility imported by both pi-ai-runtime-adapter.ts and
+ * structured-output-repair.ts — kept in adapter/ to avoid a new
+ * top-level directory for one small function.
+ */
+/**
+ * Extract JSON object from text (handles prose-wrapped and code-fenced JSON).
+ * Returns the parsed object, or null if no valid JSON found.
+ */
+export declare function extractJsonObject(text: string): Record<string, unknown> | null;
+//# sourceMappingURL=json-extractor.d.ts.map

package/dist/runtime-v2/adapter/json-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-extractor.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/adapter/json-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CA6D9E"}

package/dist/runtime-v2/adapter/json-extractor.js

@@ -0,0 +1,97 @@
+/**
+ * Balanced-bracket JSON extraction from LLM output.
+ *
+ * Handles prose-wrapped and code-fenced JSON (```json ... ```).
+ * Shared utility imported by both pi-ai-runtime-adapter.ts and
+ * structured-output-repair.ts — kept in adapter/ to avoid a new
+ * top-level directory for one small function.
+ */
+/**
+ * Extract JSON object from text (handles prose-wrapped and code-fenced JSON).
+ * Returns the parsed object, or null if no valid JSON found.
+ */
+export function extractJsonObject(text) {
+    const fencedMatch = /```(?:json)?\s*\n?([\s\S]*?)\n?```/.exec(text);
+    if (fencedMatch) {
+        const [, fencedContent] = fencedMatch;
+        if (fencedContent) {
+            try {
+                const parsed = JSON.parse(fencedContent.trim());
+                if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                    return parsed;
+                }
+                return null;
+            }
+            catch { /* fall through */ }
+        }
+    }
+    const trimmed = text.trimStart();
+    if (trimmed.length > 0 && trimmed[0] === '[') {
+        let depth = 0;
+        let inStr = false;
+        let esc = false;
+        let end = -1;
+        for (let i = 0; i < trimmed.length; i++) {
+            const ch = trimmed[i];
+            if (esc) {
+                esc = false;
+                continue;
+            }
+            if (ch === '\\' && inStr) {
+                esc = true;
+                continue;
+            }
+            if (ch === '"') {
+                inStr = !inStr;
+                continue;
+            }
+            if (inStr)
+                continue;
+            if (ch === '[' || ch === '{')
+                depth++;
+            else if (ch === ']' || ch === '}')
+                depth--;
+            if (depth === 0) {
+                end = i;
+                break;
+            }
+        }
+        if (end >= 0) {
+            try {
+                const parsed = JSON.parse(trimmed.slice(0, end + 1));
+                if (Array.isArray(parsed))
+                    return null;
+                if (typeof parsed === 'object' && parsed !== null)
+                    return parsed;
+            }
+            catch { /* fall through to brace scan */ }
+        }
+    }
+    let depth = 0;
+    let start = -1;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (ch === '{') {
+            if (depth === 0)
+                start = i;
+            depth++;
+        }
+        else if (ch === '}') {
+            depth--;
+            if (depth === 0 && start >= 0) {
+                try {
+                    const parsed = JSON.parse(text.slice(start, i + 1));
+                    if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                        return parsed;
+                    }
+                    start = -1;
+                }
+                catch {
+                    start = -1;
+                }
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=json-extractor.js.map

package/dist/runtime-v2/adapter/json-extractor.js.map

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

package/dist/runtime-v2/adapter/openclaw-cli-runtime-adapter.d.ts

@@ -0,0 +1,66 @@
+import type { StoreEventEmitter } from '../store/event-emitter.js';
+import type { PDRuntimeAdapter, RuntimeKind, RuntimeCapabilities, RuntimeHealth, RunHandle, RunStatus, StartRunInput, StructuredRunOutput, RuntimeArtifactRef } from '../runtime-protocol.js';
+/**
+ * OpenClawCliRuntimeAdapterOptions — constructor options for OpenClawCliRuntimeAdapter.
+ *
+ * Per DPB-09 (LOCKED): No silent fallback. Calling code must specify runtimeMode.
+ * Per HG-03 (HARD GATE): --openclaw-local/--openclaw-gateway must be explicit.
+ */
+export interface OpenClawCliRuntimeAdapterOptions {
+    /**
+     * Runtime mode — must be explicitly 'local' or 'gateway'.
+     * Per DPB-09 (LOCKED): No silent fallback. Calling code must specify.
+     * Per HG-03 (HARD GATE): --openclaw-local/--openclaw-gateway must be explicit.
+     */
+    runtimeMode: 'local' | 'gateway';
+    /**
+     * PD workspace directory — used as cwd for the CLI process.
+     * Per DPB-08 (LOCKED): Three-layer control includes cwd passed to CliProcessRunner.
+     * Per HG-02 (HARD GATE): Two distinct boundaries — PD workspace vs OpenClaw workspace.
+     * If undefined, runCliProcess uses process.cwd() as default.
+     */
+    workspaceDir?: string;
+    /**
+     * Agent ID to invoke when running the diagnostician (default: 'main').
+     * Used in healthCheck to verify the agent is available.
+     */
+    agentId?: string;
+    /**
+     * Optional StoreEventEmitter for telemetry event emission.
+     * If not provided, falls back to the global storeEmitter singleton.
+     */
+    eventEmitter?: StoreEventEmitter;
+}
+export declare class OpenClawCliRuntimeAdapter implements PDRuntimeAdapter {
+    private readonly runStateMap;
+    private readonly runtimeMode;
+    private readonly workspaceDir?;
+    private readonly agentId;
+    private readonly eventEmitter;
+    constructor(options: OpenClawCliRuntimeAdapterOptions);
+    kind(): RuntimeKind;
+    getCapabilities(): Promise<RuntimeCapabilities>;
+    /**
+     * Probe runtime health by running a minimal openclaw command.
+     *
+     * Verifies:
+     *  1. openclaw binary is executable (run `openclaw --version`)
+     *  2. The configured agent is available (run `openclaw agents list --json`)
+     *  3. The agent can actually respond (one-shot minimal probe with --agent)
+     *
+     * Returns healthy=false with appropriate error category when checks fail.
+     * Per DPB-09: No silent fallback — failures are reported accurately.
+     * Per P1 hard gate: Binary-only check is insufficient; must verify real invocation.
+     */
+    healthCheck(): Promise<RuntimeHealth>;
+    /**
+     * Map CLI output to telemetry event type and error category.
+     */
+    private static mapCliResultToTelemetry;
+    startRun(input: StartRunInput): Promise<RunHandle>;
+    pollRun(runId: string): Promise<RunStatus>;
+    fetchOutput(runId: string): Promise<StructuredRunOutput>;
+    cancelRun(runId: string): Promise<void>;
+    fetchArtifacts(_runId: string): Promise<RuntimeArtifactRef[]>;
+}
+//# sourceMappingURL=openclaw-cli-runtime-adapter.d.ts.map

package/dist/runtime-v2/adapter/openclaw-cli-runtime-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-cli-runtime-adapter.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/adapter/openclaw-cli-runtime-adapter.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,iBAAiB,EAAC,MAAM,2BAA2B,CAAC;AAElE,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;;;OAIG;IACH,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC;AA8ND,qBAAa,yBAA0B,YAAW,gBAAgB;IAChE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;gBAErC,OAAO,EAAE,gCAAgC;IASrD,IAAI,IAAI,WAAW;IAKb,eAAe,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAcrD;;;;;;;;;;;OAWG;IACG,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC;IAqP3C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAsBhC,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;IA6FlD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IA8C1C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA2DxD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;CAIpE"}