@principles/core 1.73.0

package/dist/runtime-v2/observer/__tests__/agent-scheduler.test.d.ts

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

package/dist/runtime-v2/observer/__tests__/agent-scheduler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-scheduler.test.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/observer/__tests__/agent-scheduler.test.ts"],"names":[],"mappings":""}

package/dist/runtime-v2/observer/__tests__/agent-scheduler.test.js

@@ -0,0 +1,49 @@
+import { describe, it, expect, vi } from 'vitest';
+import { AgentScheduler } from '../agent-scheduler.js';
+describe('AgentScheduler', () => {
+    it('registers and dispatches agents with strong typing', async () => {
+        const scheduler = new AgentScheduler();
+        const mockEmpathyRunner = {
+            run: vi.fn().mockResolvedValue({
+                damageDetected: true,
+                severity: 'mild',
+                confidence: 0.7,
+                reason: 'Keyword trigger matched',
+            }),
+        };
+        scheduler.register({
+            agentId: 'empathy-observer',
+            mode: 'realtime',
+            runner: mockEmpathyRunner,
+        });
+        const registered = scheduler.getRegisteredAgents();
+        expect(registered).toEqual([
+            { agentId: 'empathy-observer', mode: 'realtime' },
+        ]);
+        const result = await scheduler.dispatch('empathy-observer', { userMessage: 'test message' });
+        expect(mockEmpathyRunner.run).toHaveBeenCalledWith({ userMessage: 'test message' });
+        expect(result.damageDetected).toBe(true);
+        expect(result.severity).toBe('mild');
+    });
+    it('throws error when dispatching non-registered agent', async () => {
+        const scheduler = new AgentScheduler();
+        await expect(scheduler.dispatch('empathy-observer', { userMessage: 'test' })).rejects.toThrow('Agent empathy-observer is not registered in AgentScheduler');
+    });
+    it('allows overriding an existing agent registration (Map.set override)', async () => {
+        const scheduler = new AgentScheduler();
+        const runner1 = { run: vi.fn().mockResolvedValue({ damageDetected: false, severity: 'mild', confidence: 0.1, reason: 'r1' }) };
+        const runner2 = { run: vi.fn().mockResolvedValue({ damageDetected: true, severity: 'severe', confidence: 0.9, reason: 'r2' }) };
+        scheduler.register({ agentId: 'empathy-observer', mode: 'realtime', runner: runner1 });
+        scheduler.register({ agentId: 'empathy-observer', mode: 'realtime', runner: runner2 });
+        const result = await scheduler.dispatch('empathy-observer', { userMessage: 'test' });
+        expect(runner1.run).not.toHaveBeenCalled();
+        expect(runner2.run).toHaveBeenCalledWith({ userMessage: 'test' });
+        expect(result.damageDetected).toBe(true);
+        expect(result.severity).toBe('severe');
+    });
+    it('returns empty array when no agents are registered', () => {
+        const scheduler = new AgentScheduler();
+        expect(scheduler.getRegisteredAgents()).toEqual([]);
+    });
+});
+//# sourceMappingURL=agent-scheduler.test.js.map

package/dist/runtime-v2/observer/__tests__/agent-scheduler.test.js.map

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

package/dist/runtime-v2/observer/__tests__/correction-observer.test.d.ts

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

package/dist/runtime-v2/observer/__tests__/correction-observer.test.d.ts.map

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

package/dist/runtime-v2/observer/__tests__/correction-observer.test.js

@@ -0,0 +1,144 @@
+import { describe, it, expect } from 'vitest';
+import { CorrectionObserver } from '../correction-observer.js';
+import { TestDoubleRuntimeAdapter } from '../../adapter/test-double-runtime-adapter.js';
+describe('CorrectionObserver', () => {
+    const mockPayload = {
+        parentSessionId: 'session-123',
+        workspaceDir: '/test/workspace',
+        keywordStoreSummary: {
+            totalKeywords: 2,
+            terms: [
+                { term: 'wrong', weight: 0.5, hitCount: 10, truePositiveCount: 8, falsePositiveCount: 2 },
+                { term: 'error', weight: 0.6, hitCount: 5, truePositiveCount: 4, falsePositiveCount: 1 },
+            ],
+        },
+        recentMessages: ['help me', 'something is wrong here'],
+        trajectoryHistory: [
+            { sessionId: 'session-123', timestamp: '2026-05-30T16:00:00Z', term: 'wrong', userMessage: 'this is wrong' },
+        ],
+    };
+    it('correctly builds prompt', () => {
+        const prompt = CorrectionObserver.buildPrompt(mockPayload);
+        expect(prompt).toContain('You are a correction keyword optimizer.');
+        expect(prompt).toContain('wrong');
+        expect(prompt).toContain('error');
+    });
+    it('runs successfully with valid output', async () => {
+        const adapter = new TestDoubleRuntimeAdapter({
+            onFetchOutput: (runId) => ({
+                runId,
+                payload: {
+                    updated: true,
+                    updates: {
+                        wrong: {
+                            action: 'update',
+                            weight: 0.4,
+                            reasoning: 'FP rate is low but weight can be adjusted',
+                        },
+                    },
+                    fpTerms: ['error'],
+                    fpAnalysisStatus: 'completed',
+                    summary: 'Decreased weight on wrong and noted FP on error',
+                },
+            }),
+        });
+        const observer = new CorrectionObserver({ runtimeAdapter: adapter });
+        const result = await observer.run(mockPayload);
+        expect(result.updated).toBe(true);
+        expect(result.updates).toBeDefined();
+        expect(result.updates?.wrong?.action).toBe('update');
+        expect(result.fpTerms).toEqual(['error']);
+        expect(result.fpAnalysisStatus).toBe('completed');
+    });
+    it('throws error when validation fails', async () => {
+        const adapter = new TestDoubleRuntimeAdapter({
+            onFetchOutput: (runId) => ({
+                runId,
+                payload: {
+                    updated: 'not-a-boolean',
+                    summary: 123,
+                },
+            }),
+        });
+        const observer = new CorrectionObserver({ runtimeAdapter: adapter });
+        await expect(observer.run(mockPayload)).rejects.toThrow('CorrectionObserver output validation failed');
+    });
+    it('throws error when updates record has invalid action', async () => {
+        const adapter = new TestDoubleRuntimeAdapter({
+            onFetchOutput: (runId) => ({
+                runId,
+                payload: {
+                    updated: true,
+                    updates: {
+                        wrong: {
+                            action: 'invalid-action',
+                            reasoning: 'test',
+                        },
+                    },
+                    summary: 'Test',
+                },
+            }),
+        });
+        const observer = new CorrectionObserver({ runtimeAdapter: adapter });
+        await expect(observer.run(mockPayload)).rejects.toThrow('updates["wrong"].action must be add|update|remove');
+    });
+    it('throws error when updates entry has non-string reasoning', async () => {
+        const adapter = new TestDoubleRuntimeAdapter({
+            onFetchOutput: (runId) => ({
+                runId,
+                payload: {
+                    updated: true,
+                    updates: {
+                        wrong: {
+                            action: 'update',
+                            reasoning: 42,
+                        },
+                    },
+                    summary: 'Test',
+                },
+            }),
+        });
+        const observer = new CorrectionObserver({ runtimeAdapter: adapter });
+        await expect(observer.run(mockPayload)).rejects.toThrow('updates["wrong"].reasoning must be a string');
+    });
+    it('throws error when fpTerms contains non-string', async () => {
+        const adapter = new TestDoubleRuntimeAdapter({
+            onFetchOutput: (runId) => ({
+                runId,
+                payload: {
+                    updated: false,
+                    fpTerms: [123],
+                    summary: 'Test',
+                },
+            }),
+        });
+        const observer = new CorrectionObserver({ runtimeAdapter: adapter });
+        await expect(observer.run(mockPayload)).rejects.toThrow('fpTerms[0] must be a string');
+    });
+    it('throws error when fpAnalysisStatus is invalid', async () => {
+        const adapter = new TestDoubleRuntimeAdapter({
+            onFetchOutput: (runId) => ({
+                runId,
+                payload: {
+                    updated: false,
+                    fpAnalysisStatus: 'unknown',
+                    summary: 'Test',
+                },
+            }),
+        });
+        const observer = new CorrectionObserver({ runtimeAdapter: adapter });
+        await expect(observer.run(mockPayload)).rejects.toThrow('fpAnalysisStatus must be completed|skipped');
+    });
+    it('throws error when run times out', async () => {
+        const adapter = new TestDoubleRuntimeAdapter({
+            onPollRun: (runId) => ({
+                runId,
+                status: 'running',
+                startedAt: new Date().toISOString(),
+            }),
+        });
+        const observer = new CorrectionObserver({ runtimeAdapter: adapter }, { timeoutMs: 50 });
+        await expect(observer.run(mockPayload)).rejects.toThrow('CorrectionObserver run timed out after 50ms');
+    });
+});
+//# sourceMappingURL=correction-observer.test.js.map

package/dist/runtime-v2/observer/__tests__/correction-observer.test.js.map

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

package/dist/runtime-v2/observer/__tests__/empathy-observer.real-e2e.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=empathy-observer.real-e2e.test.d.ts.map

package/dist/runtime-v2/observer/__tests__/empathy-observer.real-e2e.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"empathy-observer.real-e2e.test.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/observer/__tests__/empathy-observer.real-e2e.test.ts"],"names":[],"mappings":""}

package/dist/runtime-v2/observer/__tests__/empathy-observer.real-e2e.test.js

@@ -0,0 +1,67 @@
+import { describe, it, expect } from 'vitest';
+import { EmpathyObserver } from '../empathy-observer.js';
+import { PiAiRuntimeAdapter } from '../../adapter/pi-ai-runtime-adapter.js';
+import { TestDoubleRuntimeAdapter } from '../../adapter/test-double-runtime-adapter.js';
+describe('EmpathyObserver Real E2E & Mock Fallback', () => {
+    it('runs E2E against local LM Studio if available, otherwise falls back to stable mock validation', async () => {
+        const provider = process.env.PD_EMPATHY_PROVIDER || 'lm-studio';
+        const model = process.env.PD_EMPATHY_MODEL || 'qwen3.6-27b-mtp';
+        const baseUrl = process.env.PD_EMPATHY_BASE_URL || 'http://localhost:12341/v1';
+        const apiKeyEnv = 'LM_STUDIO_API_KEY';
+        // Temporary set key if absent
+        if (!process.env[apiKeyEnv]) {
+            process.env[apiKeyEnv] = 'lm-studio-dummy-key';
+        }
+        // Initialize with stable mock adapter to satisfy ESLint constraints
+        let adapter = new TestDoubleRuntimeAdapter({
+            onFetchOutput: (runId) => ({
+                runId,
+                payload: {
+                    damageDetected: true,
+                    severity: 'moderate',
+                    confidence: 0.85,
+                    reason: 'Frustration detected via stable mock fallback',
+                },
+            }),
+        });
+        let isRealLlm = false;
+        // Detect if LM Studio is running by trying a quick fetch
+        try {
+            const response = await fetch(`${baseUrl}/models`, { method: 'GET', signal: AbortSignal.timeout(2000) });
+            if (response.ok) {
+                // LM Studio is running! Use the real LLM adapter.
+                adapter = new PiAiRuntimeAdapter({
+                    provider,
+                    model,
+                    apiKeyEnv,
+                    baseUrl,
+                    timeoutMs: 15000,
+                });
+                isRealLlm = true;
+                console.log(`[E2E Test] LM Studio detected at ${baseUrl}. Running E2E test with real model: ${model}`);
+            }
+            else {
+                console.log(`[E2E Test] LM Studio not running at ${baseUrl}. Falling back to stable mock validation.`);
+            }
+        }
+        catch {
+            console.log(`[E2E Test] LM Studio not running at ${baseUrl}. Falling back to stable mock validation.`);
+        }
+        const observer = new EmpathyObserver({ runtimeAdapter: adapter });
+        const result = await observer.run({ userMessage: 'I am extremely frustrated! This is not working!' });
+        // Assert structured schema shape and type bounds to tolerate LLM output variance
+        expect(typeof result.damageDetected).toBe('boolean');
+        expect(['mild', 'moderate', 'severe']).toContain(result.severity);
+        expect(result.confidence).toBeGreaterThanOrEqual(0);
+        expect(result.confidence).toBeLessThanOrEqual(1);
+        expect(typeof result.reason).toBe('string');
+        if (isRealLlm) {
+            console.log(`[E2E Test] Real LLM result:`, JSON.stringify(result, null, 2));
+        }
+        else {
+            expect(result.damageDetected).toBe(true);
+            expect(result.reason).toBe('Frustration detected via stable mock fallback');
+        }
+    }, 30000);
+});
+//# sourceMappingURL=empathy-observer.real-e2e.test.js.map

package/dist/runtime-v2/observer/__tests__/empathy-observer.real-e2e.test.js.map

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

package/dist/runtime-v2/observer/__tests__/empathy-observer.test.d.ts

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

package/dist/runtime-v2/observer/__tests__/empathy-observer.test.d.ts.map

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

package/dist/runtime-v2/observer/__tests__/empathy-observer.test.js

@@ -0,0 +1,84 @@
+import { describe, it, expect } from 'vitest';
+import { EmpathyObserver } from '../empathy-observer.js';
+import { TestDoubleRuntimeAdapter } from '../../adapter/test-double-runtime-adapter.js';
+describe('EmpathyObserver', () => {
+    it('correctly builds prompt', () => {
+        const prompt = EmpathyObserver.buildPrompt('I am frustrated');
+        expect(prompt).toContain('You are an empathy observer.');
+        expect(prompt).toContain('I am frustrated');
+    });
+    it('runs successfully with valid output', async () => {
+        const adapter = new TestDoubleRuntimeAdapter({
+            onFetchOutput: (runId) => ({
+                runId,
+                payload: {
+                    damageDetected: true,
+                    severity: 'moderate',
+                    confidence: 0.9,
+                    reason: 'Frustration detected',
+                },
+            }),
+        });
+        const observer = new EmpathyObserver({ runtimeAdapter: adapter });
+        const result = await observer.run({ userMessage: 'I am frustrated' });
+        expect(result.damageDetected).toBe(true);
+        expect(result.severity).toBe('moderate');
+        expect(result.confidence).toBe(0.9);
+        expect(result.reason).toBe('Frustration detected');
+    });
+    it('throws error when output schema validation fails', async () => {
+        const adapter = new TestDoubleRuntimeAdapter({
+            onFetchOutput: (runId) => ({
+                runId,
+                payload: {
+                    damageDetected: 'not-a-boolean', // Should fail schema check
+                    severity: 'unknown-severity',
+                    confidence: 1.5,
+                    reason: 123,
+                },
+            }),
+        });
+        const observer = new EmpathyObserver({ runtimeAdapter: adapter });
+        await expect(observer.run({ userMessage: 'I am frustrated' })).rejects.toThrow('EmpathyObserver output validation failed');
+    });
+    it('throws error when adapter run fails', async () => {
+        const adapter = new TestDoubleRuntimeAdapter({
+            onPollRun: (runId) => ({
+                runId,
+                status: 'failed',
+                startedAt: new Date().toISOString(),
+                endedAt: new Date().toISOString(),
+                reason: 'LLM crashed',
+            }),
+        });
+        const observer = new EmpathyObserver({ runtimeAdapter: adapter });
+        await expect(observer.run({ userMessage: 'I am frustrated' })).rejects.toThrow('EmpathyObserver run failed: failed');
+    });
+    it('throws error when run times out', async () => {
+        const adapter = new TestDoubleRuntimeAdapter({
+            onPollRun: (runId) => ({
+                runId,
+                status: 'running',
+                startedAt: new Date().toISOString(),
+            }),
+        });
+        const observer = new EmpathyObserver({ runtimeAdapter: adapter }, { timeoutMs: 50 });
+        await expect(observer.run({ userMessage: 'I am frustrated' })).rejects.toThrow('EmpathyObserver run timed out after 50ms');
+    });
+    it('throws error when confidence is out of range', async () => {
+        const adapter = new TestDoubleRuntimeAdapter({
+            onFetchOutput: (runId) => ({
+                runId,
+                payload: {
+                    damageDetected: true,
+                    severity: 'moderate',
+                    confidence: 5.0,
+                    reason: 'Out of range confidence',
+                },
+            }),
+        });
+        const observer = new EmpathyObserver({ runtimeAdapter: adapter });
+        await expect(observer.run({ userMessage: 'I am frustrated' })).rejects.toThrow('EmpathyObserver output validation failed');
+    });
+});
+//# sourceMappingURL=empathy-observer.test.js.map

package/dist/runtime-v2/observer/__tests__/empathy-observer.test.js.map

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

package/dist/runtime-v2/observer/agent-scheduler.d.ts

@@ -0,0 +1,40 @@
+import type { EmpathyObserverInput, EmpathyObserverOutputV1 } from './empathy-observer.js';
+import type { CorrectionObserverPayload, CorrectionObserverOutputV1 } from './correction-observer.js';
+export interface AgentTypeMap {
+    'empathy-observer': {
+        input: EmpathyObserverInput;
+        output: EmpathyObserverOutputV1;
+    };
+    'correction-observer': {
+        input: CorrectionObserverPayload;
+        output: CorrectionObserverOutputV1;
+    };
+}
+export type AgentScheduleMode = 'realtime' | 'periodic';
+export interface ScheduledAgent<K extends keyof AgentTypeMap = keyof AgentTypeMap> {
+    agentId: K;
+    mode: AgentScheduleMode;
+    runner: {
+        run: (input: AgentTypeMap[K]['input']) => Promise<AgentTypeMap[K]['output']>;
+    };
+}
+export declare class AgentScheduler {
+    private readonly registry;
+    /**
+     * Register a strongly-typed runner with its ID and execution mode
+     */
+    register<K extends keyof AgentTypeMap>(agent: ScheduledAgent<K>): void;
+    /**
+     * Dispatch execution to the registered runner with 100% type-safe input/output contracts.
+     * Guarantees zero "as" casts in the public caller boundary (internal engine uses safe covariance casts).
+     */
+    dispatch<K extends keyof AgentTypeMap>(agentId: K, input: AgentTypeMap[K]['input']): Promise<AgentTypeMap[K]['output']>;
+    /**
+     * List all currently registered agents and their modes
+     */
+    getRegisteredAgents(): readonly {
+        agentId: string;
+        mode: AgentScheduleMode;
+    }[];
+}
+//# sourceMappingURL=agent-scheduler.d.ts.map

package/dist/runtime-v2/observer/agent-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-scheduler.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/observer/agent-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,KAAK,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAItG,MAAM,WAAW,YAAY;IAC3B,kBAAkB,EAAE;QAAE,KAAK,EAAE,oBAAoB,CAAC;QAAC,MAAM,EAAE,uBAAuB,CAAA;KAAE,CAAC;IACrF,qBAAqB,EAAE;QAAE,KAAK,EAAE,yBAAyB,CAAC;QAAC,MAAM,EAAE,0BAA0B,CAAA;KAAE,CAAC;CACjG;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,CAAC;AAExD,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM,YAAY,GAAG,MAAM,YAAY;IAC/E,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE;QACN,GAAG,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;KAC9E,CAAC;CACH;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyD;IAElF;;OAEG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAItE;;;OAGG;IACG,QAAQ,CAAC,CAAC,SAAS,MAAM,YAAY,EACzC,OAAO,EAAE,CAAC,EACV,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAC9B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAQrC;;OAEG;IACH,mBAAmB,IAAI,SAAS;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,iBAAiB,CAAA;KAAE,EAAE;CAM/E"}

package/dist/runtime-v2/observer/agent-scheduler.js

@@ -0,0 +1,30 @@
+export class AgentScheduler {
+    registry = new Map();
+    /**
+     * Register a strongly-typed runner with its ID and execution mode
+     */
+    register(agent) {
+        this.registry.set(agent.agentId, agent);
+    }
+    /**
+     * Dispatch execution to the registered runner with 100% type-safe input/output contracts.
+     * Guarantees zero "as" casts in the public caller boundary (internal engine uses safe covariance casts).
+     */
+    async dispatch(agentId, input) {
+        const agent = this.registry.get(agentId);
+        if (!agent) {
+            throw new Error(`Agent ${agentId} is not registered in AgentScheduler`);
+        }
+        return agent.runner.run(input);
+    }
+    /**
+     * List all currently registered agents and their modes
+     */
+    getRegisteredAgents() {
+        return Array.from(this.registry.values()).map((agent) => ({
+            agentId: agent.agentId,
+            mode: agent.mode,
+        }));
+    }
+}
+//# sourceMappingURL=agent-scheduler.js.map

package/dist/runtime-v2/observer/agent-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-scheduler.js","sourceRoot":"","sources":["../../../src/runtime-v2/observer/agent-scheduler.ts"],"names":[],"mappings":"AAoBA,MAAM,OAAO,cAAc;IACR,QAAQ,GAAG,IAAI,GAAG,EAA8C,CAAC;IAElF;;OAEG;IACH,QAAQ,CAA+B,KAAwB;QAC7D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,KAAsD,CAAC,CAAC;IAC3F,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CACZ,OAAU,EACV,KAA+B;QAE/B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,sCAAsC,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAuC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACxD,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/runtime-v2/observer/correction-observer.d.ts

@@ -0,0 +1,59 @@
+import { type Static } from '@sinclair/typebox';
+import type { PDRuntimeAdapter } from '../runtime-protocol.js';
+export declare const CorrectionObserverPayloadSchema: import("@sinclair/typebox").TObject<{
+    parentSessionId: import("@sinclair/typebox").TString;
+    workspaceDir: import("@sinclair/typebox").TString;
+    keywordStoreSummary: import("@sinclair/typebox").TObject<{
+        totalKeywords: import("@sinclair/typebox").TNumber;
+        terms: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            term: import("@sinclair/typebox").TString;
+            weight: import("@sinclair/typebox").TNumber;
+            hitCount: import("@sinclair/typebox").TNumber;
+            truePositiveCount: import("@sinclair/typebox").TNumber;
+            falsePositiveCount: import("@sinclair/typebox").TNumber;
+        }>>;
+    }>;
+    recentMessages: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    trajectoryHistory: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        sessionId: import("@sinclair/typebox").TString;
+        timestamp: import("@sinclair/typebox").TString;
+        term: import("@sinclair/typebox").TString;
+        userMessage: import("@sinclair/typebox").TString;
+    }>>;
+}>;
+export type CorrectionObserverPayload = Static<typeof CorrectionObserverPayloadSchema>;
+export declare const CorrectionObserverOutputV1Schema: import("@sinclair/typebox").TObject<{
+    updated: import("@sinclair/typebox").TBoolean;
+    updates: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TObject<{
+        action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"add">, import("@sinclair/typebox").TLiteral<"update">, import("@sinclair/typebox").TLiteral<"remove">]>;
+        weight: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        falsePositiveRate: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        reasoning: import("@sinclair/typebox").TString;
+    }>>>;
+    fpTerms: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    fpAnalysisStatus: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"completed">, import("@sinclair/typebox").TLiteral<"skipped">]>>;
+    summary: import("@sinclair/typebox").TString;
+}>;
+export type CorrectionObserverOutputV1 = Static<typeof CorrectionObserverOutputV1Schema>;
+export interface CorrectionObserverDeps {
+    readonly runtimeAdapter: PDRuntimeAdapter;
+}
+export interface CorrectionObserverOptions {
+    readonly timeoutMs?: number;
+    readonly agentId?: string;
+}
+export declare class CorrectionObserver {
+    private readonly runtimeAdapter;
+    private readonly timeoutMs;
+    private readonly agentId;
+    constructor(deps: CorrectionObserverDeps, options?: CorrectionObserverOptions);
+    /**
+     * Replicates prompt construction from correctionObserverWorkflowSpec
+     */
+    static buildPrompt(payload: CorrectionObserverPayload): string;
+    /**
+     * Run the simplified one-shot Correction Observer.
+     */
+    run(input: CorrectionObserverPayload): Promise<CorrectionObserverOutputV1>;
+}
+//# sourceMappingURL=correction-observer.d.ts.map

package/dist/runtime-v2/observer/correction-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correction-observer.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/observer/correction-observer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;EAoB1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAEvF,eAAO,MAAM,gCAAgC;;;;;;;;;;;EAW3C,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAIzF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,yBAAyB;IAM7E;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM;IAiD9D;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;CA+FjF"}