@renseiai/agentfactory 0.8.18 → 0.8.20

package/dist/src/orchestrator/quality-ratchet.test.d.ts

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

package/dist/src/orchestrator/quality-ratchet.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-ratchet.test.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/quality-ratchet.test.ts"],"names":[],"mappings":""}

package/dist/src/orchestrator/quality-ratchet.test.js

@@ -0,0 +1,335 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { loadQualityRatchet, checkQualityRatchet, updateQualityRatchet, initializeQualityRatchet, formatRatchetResult, } from './quality-ratchet.js';
+vi.mock('node:fs', () => ({
+    readFileSync: vi.fn(),
+    writeFileSync: vi.fn(),
+    existsSync: vi.fn(),
+}));
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+const mockReadFileSync = vi.mocked(readFileSync);
+const mockWriteFileSync = vi.mocked(writeFileSync);
+const mockExistsSync = vi.mocked(existsSync);
+beforeEach(() => {
+    vi.resetAllMocks();
+});
+function makeRatchet(overrides) {
+    return {
+        version: 1,
+        updatedAt: '2026-01-01T00:00:00Z',
+        updatedBy: 'SUP-100',
+        thresholds: {
+            testCount: { min: 100 },
+            testFailures: { max: 0 },
+            typecheckErrors: { max: 5 },
+            lintErrors: { max: 10 },
+        },
+        ...overrides,
+    };
+}
+function makeBaseline(overrides) {
+    return {
+        timestamp: '2026-03-30T00:00:00Z',
+        commitSha: 'abc123',
+        tests: { total: 100, passed: 100, failed: 0, skipped: 0 },
+        typecheck: { errorCount: 5, exitCode: 0 },
+        lint: { errorCount: 10, warningCount: 20 },
+        ...overrides,
+    };
+}
+// ---------------------------------------------------------------------------
+// loadQualityRatchet
+// ---------------------------------------------------------------------------
+describe('loadQualityRatchet', () => {
+    it('loads and parses a valid ratchet file', () => {
+        const ratchet = makeRatchet();
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(JSON.stringify(ratchet));
+        const result = loadQualityRatchet('/repo');
+        expect(result).toEqual(ratchet);
+    });
+    it('returns null when file does not exist', () => {
+        mockExistsSync.mockReturnValue(false);
+        expect(loadQualityRatchet('/repo')).toBeNull();
+    });
+    it('throws on invalid JSON', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue('not json');
+        expect(() => loadQualityRatchet('/repo')).toThrow();
+    });
+    it('throws on missing version', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(JSON.stringify({ thresholds: {} }));
+        expect(() => loadQualityRatchet('/repo')).toThrow('Invalid quality ratchet');
+    });
+    it('throws on missing thresholds', () => {
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(JSON.stringify({ version: 1 }));
+        expect(() => loadQualityRatchet('/repo')).toThrow('Invalid quality ratchet');
+    });
+});
+// ---------------------------------------------------------------------------
+// checkQualityRatchet
+// ---------------------------------------------------------------------------
+describe('checkQualityRatchet', () => {
+    it('passes when all metrics are within thresholds', () => {
+        const ratchet = makeRatchet();
+        const current = makeBaseline();
+        const result = checkQualityRatchet(ratchet, current);
+        expect(result.passed).toBe(true);
+        expect(result.violations).toHaveLength(0);
+    });
+    it('fails when test count drops below minimum', () => {
+        const ratchet = makeRatchet();
+        const current = makeBaseline({ tests: { total: 90, passed: 90, failed: 0, skipped: 0 } });
+        const result = checkQualityRatchet(ratchet, current);
+        expect(result.passed).toBe(false);
+        expect(result.violations).toHaveLength(1);
+        expect(result.violations[0].metric).toBe('testCount');
+        expect(result.violations[0].direction).toBe('below-min');
+    });
+    it('fails when test failures exceed maximum', () => {
+        const ratchet = makeRatchet();
+        const current = makeBaseline({ tests: { total: 100, passed: 97, failed: 3, skipped: 0 } });
+        const result = checkQualityRatchet(ratchet, current);
+        expect(result.passed).toBe(false);
+        expect(result.violations[0].metric).toBe('testFailures');
+    });
+    it('fails when typecheck errors exceed maximum', () => {
+        const ratchet = makeRatchet();
+        const current = makeBaseline({ typecheck: { errorCount: 8, exitCode: 1 } });
+        const result = checkQualityRatchet(ratchet, current);
+        expect(result.passed).toBe(false);
+        expect(result.violations[0].metric).toBe('typecheckErrors');
+    });
+    it('fails when lint errors exceed maximum', () => {
+        const ratchet = makeRatchet();
+        const current = makeBaseline({ lint: { errorCount: 15, warningCount: 20 } });
+        const result = checkQualityRatchet(ratchet, current);
+        expect(result.passed).toBe(false);
+        expect(result.violations[0].metric).toBe('lintErrors');
+    });
+    it('reports multiple violations', () => {
+        const ratchet = makeRatchet();
+        const current = makeBaseline({
+            tests: { total: 80, passed: 75, failed: 5, skipped: 0 },
+            typecheck: { errorCount: 10, exitCode: 1 },
+        });
+        const result = checkQualityRatchet(ratchet, current);
+        expect(result.passed).toBe(false);
+        expect(result.violations.length).toBeGreaterThanOrEqual(3);
+    });
+    it('passes when metrics exactly equal thresholds (boundary)', () => {
+        const ratchet = makeRatchet({
+            thresholds: {
+                testCount: { min: 100 },
+                testFailures: { max: 2 },
+                typecheckErrors: { max: 5 },
+                lintErrors: { max: 10 },
+            },
+        });
+        const current = makeBaseline({
+            tests: { total: 100, passed: 98, failed: 2, skipped: 0 },
+            typecheck: { errorCount: 5, exitCode: 0 },
+            lint: { errorCount: 10, warningCount: 0 },
+        });
+        const result = checkQualityRatchet(ratchet, current);
+        expect(result.passed).toBe(true);
+        expect(result.violations).toHaveLength(0);
+    });
+    it('fails when metric is one over the max threshold (boundary)', () => {
+        const ratchet = makeRatchet({
+            thresholds: {
+                testCount: { min: 100 },
+                testFailures: { max: 0 },
+                typecheckErrors: { max: 5 },
+                lintErrors: { max: 10 },
+            },
+        });
+        const current = makeBaseline({
+            tests: { total: 100, passed: 99, failed: 1, skipped: 0 },
+        });
+        const result = checkQualityRatchet(ratchet, current);
+        expect(result.passed).toBe(false);
+        expect(result.violations).toHaveLength(1);
+        expect(result.violations[0].metric).toBe('testFailures');
+        expect(result.violations[0].actual).toBe(1);
+        expect(result.violations[0].threshold).toBe(0);
+    });
+    it('fails when test count is one below the min threshold (boundary)', () => {
+        const ratchet = makeRatchet();
+        const current = makeBaseline({
+            tests: { total: 99, passed: 99, failed: 0, skipped: 0 },
+        });
+        const result = checkQualityRatchet(ratchet, current);
+        expect(result.passed).toBe(false);
+        expect(result.violations[0].metric).toBe('testCount');
+        expect(result.violations[0].actual).toBe(99);
+    });
+    it('passes with zero-threshold ratchet when metrics are zero', () => {
+        const ratchet = makeRatchet({
+            thresholds: {
+                testCount: { min: 0 },
+                testFailures: { max: 0 },
+                typecheckErrors: { max: 0 },
+                lintErrors: { max: 0 },
+            },
+        });
+        const current = makeBaseline({
+            tests: { total: 0, passed: 0, failed: 0, skipped: 0 },
+            typecheck: { errorCount: 0, exitCode: 0 },
+            lint: { errorCount: 0, warningCount: 0 },
+        });
+        const result = checkQualityRatchet(ratchet, current);
+        expect(result.passed).toBe(true);
+    });
+});
+// ---------------------------------------------------------------------------
+// updateQualityRatchet
+// ---------------------------------------------------------------------------
+describe('updateQualityRatchet', () => {
+    it('tightens thresholds when metrics improve', () => {
+        const ratchet = makeRatchet();
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(JSON.stringify(ratchet));
+        const improved = makeBaseline({
+            tests: { total: 110, passed: 110, failed: 0, skipped: 0 },
+            typecheck: { errorCount: 2, exitCode: 0 },
+            lint: { errorCount: 5, warningCount: 10 },
+        });
+        const updated = updateQualityRatchet('/repo', improved, 'SUP-200');
+        expect(updated).toBe(true);
+        expect(mockWriteFileSync).toHaveBeenCalled();
+        const written = JSON.parse(mockWriteFileSync.mock.calls[0][1]);
+        expect(written.thresholds.testCount.min).toBe(110);
+        expect(written.thresholds.typecheckErrors.max).toBe(2);
+        expect(written.thresholds.lintErrors.max).toBe(5);
+        expect(written.updatedBy).toBe('SUP-200');
+    });
+    it('does not update when metrics are worse or equal', () => {
+        const ratchet = makeRatchet();
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(JSON.stringify(ratchet));
+        const same = makeBaseline();
+        const updated = updateQualityRatchet('/repo', same, 'SUP-200');
+        expect(updated).toBe(false);
+        expect(mockWriteFileSync).not.toHaveBeenCalled();
+    });
+    it('returns false when ratchet file does not exist', () => {
+        mockExistsSync.mockReturnValue(false);
+        const updated = updateQualityRatchet('/repo', makeBaseline(), 'SUP-200');
+        expect(updated).toBe(false);
+    });
+    it('tightens only the metrics that improved (partial improvement)', () => {
+        const ratchet = makeRatchet({
+            thresholds: {
+                testCount: { min: 100 },
+                testFailures: { max: 5 },
+                typecheckErrors: { max: 10 },
+                lintErrors: { max: 20 },
+            },
+        });
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(JSON.stringify(ratchet));
+        // Only typecheck improved, rest is same or worse
+        const partial = makeBaseline({
+            tests: { total: 100, passed: 95, failed: 5, skipped: 0 },
+            typecheck: { errorCount: 3, exitCode: 0 },
+            lint: { errorCount: 20, warningCount: 0 },
+        });
+        const updated = updateQualityRatchet('/repo', partial, 'SUP-300');
+        expect(updated).toBe(true);
+        const written = JSON.parse(mockWriteFileSync.mock.calls[0][1]);
+        expect(written.thresholds.testCount.min).toBe(100); // unchanged
+        expect(written.thresholds.testFailures.max).toBe(5); // unchanged (equal)
+        expect(written.thresholds.typecheckErrors.max).toBe(3); // tightened
+        expect(written.thresholds.lintErrors.max).toBe(20); // unchanged (equal)
+    });
+    it('sets updatedAt to a recent timestamp', () => {
+        const ratchet = makeRatchet();
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(JSON.stringify(ratchet));
+        const improved = makeBaseline({
+            tests: { total: 200, passed: 200, failed: 0, skipped: 0 },
+        });
+        const before = new Date().toISOString();
+        updateQualityRatchet('/repo', improved, 'SUP-400');
+        const after = new Date().toISOString();
+        const written = JSON.parse(mockWriteFileSync.mock.calls[0][1]);
+        expect(written.updatedAt >= before).toBe(true);
+        expect(written.updatedAt <= after).toBe(true);
+    });
+});
+// ---------------------------------------------------------------------------
+// initializeQualityRatchet
+// ---------------------------------------------------------------------------
+describe('initializeQualityRatchet', () => {
+    it('creates ratchet file from baseline', () => {
+        const baseline = makeBaseline({
+            tests: { total: 50, passed: 48, failed: 2, skipped: 0 },
+            typecheck: { errorCount: 3, exitCode: 0 },
+            lint: { errorCount: 7, warningCount: 15 },
+        });
+        const ratchet = initializeQualityRatchet('/repo', baseline);
+        expect(ratchet.version).toBe(1);
+        expect(ratchet.thresholds.testCount.min).toBe(50);
+        expect(ratchet.thresholds.testFailures.max).toBe(2);
+        expect(ratchet.thresholds.typecheckErrors.max).toBe(3);
+        expect(ratchet.thresholds.lintErrors.max).toBe(7);
+        expect(mockWriteFileSync).toHaveBeenCalled();
+    });
+    it('initializes from a zero-metric baseline', () => {
+        const baseline = makeBaseline({
+            tests: { total: 0, passed: 0, failed: 0, skipped: 0 },
+            typecheck: { errorCount: 0, exitCode: 0 },
+            lint: { errorCount: 0, warningCount: 0 },
+        });
+        const ratchet = initializeQualityRatchet('/repo', baseline);
+        expect(ratchet.thresholds.testCount.min).toBe(0);
+        expect(ratchet.thresholds.testFailures.max).toBe(0);
+        expect(ratchet.thresholds.typecheckErrors.max).toBe(0);
+        expect(ratchet.thresholds.lintErrors.max).toBe(0);
+    });
+    it('sets updatedBy to "manual"', () => {
+        const ratchet = initializeQualityRatchet('/repo', makeBaseline());
+        expect(ratchet.updatedBy).toBe('manual');
+    });
+    it('writes JSON with trailing newline', () => {
+        initializeQualityRatchet('/repo', makeBaseline());
+        const written = mockWriteFileSync.mock.calls[0][1];
+        expect(written.endsWith('\n')).toBe(true);
+    });
+});
+// ---------------------------------------------------------------------------
+// formatRatchetResult
+// ---------------------------------------------------------------------------
+describe('formatRatchetResult', () => {
+    it('formats a passing result', () => {
+        expect(formatRatchetResult({ passed: true, violations: [] })).toContain('passed');
+    });
+    it('formats a failing result with violations', () => {
+        const result = formatRatchetResult({
+            passed: false,
+            violations: [
+                { metric: 'testCount', threshold: 100, actual: 90, direction: 'below-min' },
+                { metric: 'typecheckErrors', threshold: 5, actual: 8, direction: 'above-max' },
+            ],
+        });
+        expect(result).toContain('**FAILED**');
+        expect(result).toContain('testCount');
+        expect(result).toContain('below minimum');
+        expect(result).toContain('typecheckErrors');
+        expect(result).toContain('exceeds maximum');
+    });
+    it('formats a single violation', () => {
+        const result = formatRatchetResult({
+            passed: false,
+            violations: [
+                { metric: 'lintErrors', threshold: 10, actual: 15, direction: 'above-max' },
+            ],
+        });
+        expect(result).toContain('**FAILED**');
+        expect(result).toContain('lintErrors');
+        expect(result).toContain('15');
+        expect(result).toContain('10');
+    });
+});

package/dist/src/orchestrator/types.d.ts

@@ -115,6 +115,8 @@ export interface OrchestratorConfig {
     repository?: string;
     /** Merge queue adapter for automated merge operations */
     mergeQueueAdapter?: import('../merge-queue/types.js').MergeQueueAdapter;
+    /** Storage backend for the local merge queue adapter (required when provider is 'local') */
+    mergeQueueStorage?: import('../merge-queue/adapters/local.js').LocalMergeQueueStorage;
 }
 export interface OrchestratorIssue {
     id: string;

package/dist/src/orchestrator/types.d.ts.map

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

package/dist/src/providers/claude-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,WAAW,EAEZ,MAAM,YAAY,CAAA;AAiFnB,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAS;IACjC,QAAQ,CAAC,YAAY;;;MAGX;IAEV,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW;IAI5C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,WAAW;IAIhE,OAAO,CAAC,YAAY;CA8KrB;AAsND;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}
+{"version":3,"file":"claude-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,WAAW,EAEZ,MAAM,YAAY,CAAA;AA6FnB,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAS;IACjC,QAAQ,CAAC,YAAY;;;MAGX;IAEV,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW;IAI5C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,WAAW;IAIhE,OAAO,CAAC,YAAY;CA8KrB;AAsND;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

package/dist/src/providers/claude-provider.js

@@ -26,6 +26,17 @@ const autonomousCanUseTool = async (toolName, input) => {
     if (['Write', 'Edit', 'NotebookEdit'].includes(toolName)) {
         return { behavior: 'allow', updatedInput: input };
     }
+    // Agent tool: always force foreground execution.
+    // Coordinators that spawn sub-agents with run_in_background=true exit
+    // before sub-agents finish, orphaning work. Strip the flag so the Agent
+    // tool blocks until the sub-agent completes.
+    if (toolName === 'Agent') {
+        if (input.run_in_background) {
+            const { run_in_background: _, ...rest } = input;
+            return { behavior: 'allow', updatedInput: rest };
+        }
+        return { behavior: 'allow', updatedInput: input };
+    }
     // Task management and planning
     if (['Task', 'TaskCreate', 'TaskUpdate', 'TaskGet', 'TaskList',
         'EnterPlanMode', 'ExitPlanMode', 'Skill'].includes(toolName)) {

package/dist/src/providers/codex-app-server-provider.d.ts

@@ -0,0 +1,237 @@
+/**
+ * Codex App Server Provider
+ *
+ * Manages a long-lived `codex app-server` process communicating via JSON-RPC 2.0
+ * over stdio. Supports multiple concurrent threads on a single process.
+ *
+ * Architecture:
+ *   orchestrator → codex app-server (long-lived, one process)
+ *                    ├── thread_1 (agent session A)
+ *                    ├── thread_2 (agent session B)
+ *                    └── thread_3 (agent session C)
+ *
+ * Falls back to `codex exec` CLI mode when app-server is unavailable.
+ *
+ * JSON-RPC 2.0 protocol (over stdio JSONL):
+ *   1. initialize + initialized handshake
+ *   2. thread/start or thread/resume
+ *   3. turn/start with prompt
+ *   4. Stream item/*, turn/*, thread/* notifications
+ *   5. thread/unsubscribe on completion
+ *
+ * @see https://developers.openai.com/codex/app-server
+ */
+import type { AgentProvider, AgentSpawnConfig, AgentHandle, AgentEvent } from './types.js';
+interface JsonRpcNotification {
+    method: string;
+    params?: Record<string, unknown>;
+}
+/** Status of a registered MCP server as reported by mcpServerStatus/list */
+export interface McpServerStatusResult {
+    name: string;
+    status: 'connected' | 'connecting' | 'disconnected' | 'error';
+    toolCount?: number;
+    error?: string;
+}
+interface AppServerItem {
+    id: string;
+    type: string;
+    text?: string;
+    summary?: string;
+    content?: string;
+    command?: string;
+    cwd?: string;
+    status?: string;
+    exitCode?: number;
+    durationMs?: number;
+    changes?: Array<{
+        path: string;
+        kind: string;
+    }>;
+    server?: string;
+    tool?: string;
+    arguments?: unknown;
+    result?: {
+        content?: unknown[];
+    };
+    error?: {
+        message?: string;
+    };
+    items?: Array<{
+        text: string;
+        completed: boolean;
+    }>;
+    phase?: string;
+}
+interface AppServerTurn {
+    id: string;
+    status?: string;
+    usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+        cached_input_tokens?: number;
+    };
+    error?: {
+        message?: string;
+        codexErrorInfo?: string;
+        httpStatusCode?: number;
+    };
+}
+interface AppServerThread {
+    id: string;
+    status?: string;
+}
+/**
+ * Manages a single long-lived `codex app-server` process.
+ *
+ * Handles:
+ * - Process spawning and stdio communication
+ * - JSON-RPC 2.0 initialization handshake
+ * - Request/response correlation
+ * - Notification routing to thread subscribers
+ * - Health monitoring and graceful shutdown
+ */
+export declare class AppServerProcessManager {
+    private process;
+    private readline;
+    private nextId;
+    private pendingRequests;
+    private initialized;
+    private shutdownPromise;
+    /** Notification listeners keyed by threadId */
+    private threadListeners;
+    /** Global notification listeners (for notifications without a threadId) */
+    private globalListeners;
+    private readonly codexBin;
+    private readonly cwd;
+    private readonly env;
+    constructor(options: {
+        codexBin?: string;
+        cwd: string;
+        env?: Record<string, string>;
+    });
+    /**
+     * Start the app-server process and complete the initialization handshake.
+     * Idempotent — returns immediately if already initialized.
+     */
+    start(): Promise<void>;
+    /**
+     * JSON-RPC 2.0 initialization handshake:
+     * 1. Send `initialize` request
+     * 2. Receive response
+     * 3. Send `initialized` notification
+     */
+    private initialize;
+    /**
+     * Send a JSON-RPC request and wait for the response.
+     */
+    request(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<unknown>;
+    /**
+     * Send a JSON-RPC message (request or notification) to the app-server.
+     */
+    private send;
+    /**
+     * Handle an incoming JSON-RPC response.
+     */
+    private handleResponse;
+    /**
+     * Handle an incoming JSON-RPC notification.
+     * Routes to the appropriate thread listener based on threadId in params.
+     */
+    private handleNotification;
+    /**
+     * Subscribe to notifications for a specific thread.
+     */
+    subscribeThread(threadId: string, listener: (notification: JsonRpcNotification) => void): void;
+    /**
+     * Unsubscribe from notifications for a specific thread.
+     */
+    unsubscribeThread(threadId: string): void;
+    /**
+     * Check if the app-server process is alive and initialized.
+     */
+    isHealthy(): boolean;
+    /** Whether MCP servers have been configured on this process */
+    private mcpConfigured;
+    /**
+     * Register MCP servers with the app-server via config/batchWrite.
+     * Called once after initialization to tell Codex about the stdio
+     * MCP tool servers (af-linear, af-code-intelligence, etc.).
+     *
+     * Uses the Codex app-server `config/batchWrite` JSON-RPC method
+     * to register multiple MCP server configurations in a single call.
+     */
+    configureMcpServers(servers: Array<{
+        name: string;
+        command: string;
+        args: string[];
+        env?: Record<string, string>;
+    }>): Promise<void>;
+    /**
+     * Query MCP server health via mcpServerStatus/list.
+     * Returns the status of all registered MCP servers.
+     */
+    getMcpServerStatus(): Promise<McpServerStatusResult[]>;
+    /**
+     * Get the PID of the app-server process.
+     */
+    get pid(): number | undefined;
+    /**
+     * Graceful shutdown: unsubscribe all threads, kill process.
+     */
+    shutdown(): Promise<void>;
+    private performShutdown;
+    private rejectAllPending;
+}
+export interface AppServerEventMapperState {
+    sessionId: string | null;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    turnCount: number;
+}
+/**
+ * Map an App Server notification to normalized AgentEvents.
+ * Exported for unit testing.
+ */
+export declare function mapAppServerNotification(notification: JsonRpcNotification, state: AppServerEventMapperState): AgentEvent[];
+/**
+ * Map item/started and item/completed notifications to AgentEvents.
+ * Exported for unit testing.
+ */
+export declare function mapAppServerItemEvent(method: string, params: Record<string, unknown>): AgentEvent[];
+/**
+ * Normalize Codex MCP tool names to the `mcp__{server}__{tool}` format
+ * used by the orchestrator and Claude provider for consistent tool tracking.
+ *
+ * Codex reports MCP tools as `server` + `tool` (e.g., server='af-linear',
+ * tool='af_linear_get_issue'). We normalize to 'mcp__af-linear__af_linear_get_issue'.
+ */
+export declare function normalizeMcpToolName(server?: string, tool?: string): string;
+/**
+ * Codex App Server Provider
+ *
+ * Uses a long-lived `codex app-server` process with JSON-RPC 2.0 over stdio.
+ * Falls back to `codex exec` CLI mode when CODEX_USE_APP_SERVER is not set
+ * or when the app-server binary is unavailable.
+ */
+export declare class CodexAppServerProvider implements AgentProvider {
+    readonly name: "codex";
+    readonly capabilities: {
+        readonly supportsMessageInjection: true;
+        readonly supportsSessionResume: true;
+    };
+    /** Shared process manager — one app-server process serves all threads */
+    private processManager;
+    spawn(config: AgentSpawnConfig): AgentHandle;
+    resume(sessionId: string, config: AgentSpawnConfig): AgentHandle;
+    /**
+     * Shut down the shared app-server process.
+     * Called when the orchestrator is done with this provider.
+     */
+    shutdown(): Promise<void>;
+    private getOrCreateProcessManager;
+}
+export declare function createCodexAppServerProvider(): CodexAppServerProvider;
+/** Exported for testing */
+export type { JsonRpcNotification, AppServerItem, AppServerTurn, AppServerThread };
+//# sourceMappingURL=codex-app-server-provider.d.ts.map

package/dist/src/providers/codex-app-server-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-app-server-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/codex-app-server-provider.ts"],"names":[],"mappings":"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"}