@renseiai/agentfactory 0.8.2 → 0.8.4

package/dist/src/orchestrator/state-recovery.test.js

@@ -0,0 +1,425 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+vi.mock('fs', () => ({
+    existsSync: vi.fn(),
+    readFileSync: vi.fn(),
+    writeFileSync: vi.fn(),
+    mkdirSync: vi.fn(),
+}));
+import { existsSync, readFileSync } from 'fs';
+import { resolve } from 'path';
+import { getAgentDir, getStatePath, getHeartbeatPath, getTodosPath, isHeartbeatFresh, readWorktreeState, readHeartbeat, checkRecovery, createInitialState, buildRecoveryPrompt, getHeartbeatTimeoutFromEnv, getMaxRecoveryAttemptsFromEnv, } from './state-recovery.js';
+const WORKTREE = '/tmp/test-worktree';
+function makeState(overrides = {}) {
+    return {
+        issueId: 'uuid-123',
+        issueIdentifier: 'SUP-42',
+        linearSessionId: 'session-1',
+        providerSessionId: null,
+        workType: 'development',
+        prompt: 'Fix the bug',
+        startedAt: 1000,
+        status: 'running',
+        currentPhase: null,
+        lastUpdatedAt: 2000,
+        recoveryAttempts: 0,
+        workerId: null,
+        pid: 1234,
+        taskListId: 'SUP-42-DEV',
+        ...overrides,
+    };
+}
+function makeHeartbeat(overrides = {}) {
+    return {
+        timestamp: Date.now(),
+        pid: 1234,
+        memoryUsageMB: 128,
+        uptime: 60,
+        lastActivityType: 'tool_use',
+        lastActivityTimestamp: Date.now(),
+        toolCallsCount: 10,
+        currentOperation: null,
+        ...overrides,
+    };
+}
+beforeEach(() => {
+    vi.clearAllMocks();
+});
+describe('getAgentDir', () => {
+    it('returns .agent directory under worktree path', () => {
+        expect(getAgentDir(WORKTREE)).toBe(resolve(WORKTREE, '.agent'));
+    });
+});
+describe('getStatePath', () => {
+    it('returns state.json path under .agent directory', () => {
+        expect(getStatePath(WORKTREE)).toBe(resolve(WORKTREE, '.agent', 'state.json'));
+    });
+});
+describe('getHeartbeatPath', () => {
+    it('returns heartbeat.json path under .agent directory', () => {
+        expect(getHeartbeatPath(WORKTREE)).toBe(resolve(WORKTREE, '.agent', 'heartbeat.json'));
+    });
+});
+describe('getTodosPath', () => {
+    it('returns todos.json path under .agent directory', () => {
+        expect(getTodosPath(WORKTREE)).toBe(resolve(WORKTREE, '.agent', 'todos.json'));
+    });
+});
+describe('isHeartbeatFresh', () => {
+    it('returns false for null heartbeat', () => {
+        expect(isHeartbeatFresh(null)).toBe(false);
+    });
+    it('returns true when heartbeat is within timeout', () => {
+        const heartbeat = makeHeartbeat({ timestamp: Date.now() - 1000 });
+        expect(isHeartbeatFresh(heartbeat, 30000)).toBe(true);
+    });
+    it('returns false when heartbeat is older than timeout', () => {
+        const heartbeat = makeHeartbeat({ timestamp: Date.now() - 60000 });
+        expect(isHeartbeatFresh(heartbeat, 30000)).toBe(false);
+    });
+    it('uses default timeout of 30000ms when not specified', () => {
+        const fresh = makeHeartbeat({ timestamp: Date.now() - 10000 });
+        const stale = makeHeartbeat({ timestamp: Date.now() - 31000 });
+        expect(isHeartbeatFresh(fresh)).toBe(true);
+        expect(isHeartbeatFresh(stale)).toBe(false);
+    });
+});
+describe('readWorktreeState', () => {
+    it('returns parsed state when file exists', () => {
+        const state = makeState();
+        vi.mocked(existsSync).mockReturnValue(true);
+        vi.mocked(readFileSync).mockReturnValue(JSON.stringify(state));
+        const result = readWorktreeState(WORKTREE);
+        expect(result).toEqual(state);
+        expect(existsSync).toHaveBeenCalledWith(getStatePath(WORKTREE));
+    });
+    it('returns null when file does not exist', () => {
+        vi.mocked(existsSync).mockReturnValue(false);
+        expect(readWorktreeState(WORKTREE)).toBeNull();
+    });
+    it('returns null when file contains invalid JSON', () => {
+        vi.mocked(existsSync).mockReturnValue(true);
+        vi.mocked(readFileSync).mockReturnValue('not json');
+        expect(readWorktreeState(WORKTREE)).toBeNull();
+    });
+});
+describe('readHeartbeat', () => {
+    it('returns parsed heartbeat when file exists', () => {
+        const heartbeat = makeHeartbeat();
+        vi.mocked(existsSync).mockReturnValue(true);
+        vi.mocked(readFileSync).mockReturnValue(JSON.stringify(heartbeat));
+        const result = readHeartbeat(WORKTREE);
+        expect(result).toEqual(heartbeat);
+        expect(existsSync).toHaveBeenCalledWith(getHeartbeatPath(WORKTREE));
+    });
+    it('returns null when file does not exist', () => {
+        vi.mocked(existsSync).mockReturnValue(false);
+        expect(readHeartbeat(WORKTREE)).toBeNull();
+    });
+});
+describe('checkRecovery', () => {
+    it('returns no_state when .agent directory does not exist', () => {
+        vi.mocked(existsSync).mockReturnValue(false);
+        const result = checkRecovery(WORKTREE);
+        expect(result.canRecover).toBe(false);
+        expect(result.agentAlive).toBe(false);
+        expect(result.reason).toBe('no_state');
+        expect(result.message).toContain('No .agent directory');
+    });
+    it('returns no_state when state.json does not exist', () => {
+        // .agent dir exists, but state.json does not
+        vi.mocked(existsSync).mockImplementation((path) => {
+            if (String(path).endsWith('.agent'))
+                return true;
+            return false;
+        });
+        const result = checkRecovery(WORKTREE);
+        expect(result.canRecover).toBe(false);
+        expect(result.reason).toBe('no_state');
+        expect(result.message).toContain('No state.json');
+    });
+    it('returns invalid_state when issueId is missing', () => {
+        const state = makeState({ issueId: '' });
+        vi.mocked(existsSync).mockReturnValue(true);
+        vi.mocked(readFileSync).mockReturnValue(JSON.stringify(state));
+        const result = checkRecovery(WORKTREE);
+        expect(result.canRecover).toBe(false);
+        expect(result.reason).toBe('invalid_state');
+        expect(result.state).toEqual(state);
+    });
+    it('returns invalid_state when issueIdentifier is missing', () => {
+        const state = makeState({ issueIdentifier: '' });
+        vi.mocked(existsSync).mockReturnValue(true);
+        vi.mocked(readFileSync).mockReturnValue(JSON.stringify(state));
+        const result = checkRecovery(WORKTREE);
+        expect(result.canRecover).toBe(false);
+        expect(result.reason).toBe('invalid_state');
+    });
+    it('returns agent_alive when heartbeat is fresh', () => {
+        const state = makeState();
+        const heartbeat = makeHeartbeat({ timestamp: Date.now(), pid: 9999 });
+        vi.mocked(existsSync).mockReturnValue(true);
+        vi.mocked(readFileSync).mockImplementation((path) => {
+            if (String(path).includes('heartbeat'))
+                return JSON.stringify(heartbeat);
+            return JSON.stringify(state);
+        });
+        const result = checkRecovery(WORKTREE);
+        expect(result.canRecover).toBe(false);
+        expect(result.agentAlive).toBe(true);
+        expect(result.reason).toBe('agent_alive');
+        expect(result.message).toContain('PID: 9999');
+    });
+    it('returns max_attempts when recovery attempts exhausted', () => {
+        const state = makeState({ recoveryAttempts: 3 });
+        const heartbeat = makeHeartbeat({ timestamp: Date.now() - 60000 });
+        vi.mocked(existsSync).mockReturnValue(true);
+        vi.mocked(readFileSync).mockImplementation((path) => {
+            if (String(path).includes('heartbeat'))
+                return JSON.stringify(heartbeat);
+            return JSON.stringify(state);
+        });
+        const result = checkRecovery(WORKTREE);
+        expect(result.canRecover).toBe(false);
+        expect(result.reason).toBe('max_attempts');
+        expect(result.message).toContain('3/3');
+    });
+    it('respects custom maxRecoveryAttempts', () => {
+        const state = makeState({ recoveryAttempts: 1 });
+        const heartbeat = makeHeartbeat({ timestamp: Date.now() - 60000 });
+        vi.mocked(existsSync).mockReturnValue(true);
+        vi.mocked(readFileSync).mockImplementation((path) => {
+            if (String(path).includes('heartbeat'))
+                return JSON.stringify(heartbeat);
+            return JSON.stringify(state);
+        });
+        const result = checkRecovery(WORKTREE, { maxRecoveryAttempts: 1 });
+        expect(result.canRecover).toBe(false);
+        expect(result.reason).toBe('max_attempts');
+    });
+    it('returns recoverable when state is valid and agent is not alive', () => {
+        const state = makeState({ recoveryAttempts: 0 });
+        const heartbeat = makeHeartbeat({ timestamp: Date.now() - 60000 });
+        vi.mocked(existsSync).mockImplementation((path) => {
+            // todos.json does not exist
+            if (String(path).includes('todos'))
+                return false;
+            return true;
+        });
+        vi.mocked(readFileSync).mockImplementation((path) => {
+            if (String(path).includes('heartbeat'))
+                return JSON.stringify(heartbeat);
+            return JSON.stringify(state);
+        });
+        const result = checkRecovery(WORKTREE);
+        expect(result.canRecover).toBe(true);
+        expect(result.agentAlive).toBe(false);
+        expect(result.state).toEqual(state);
+        expect(result.message).toContain('Recovery possible');
+        expect(result.message).toContain('1/3');
+    });
+    it('includes todos when present in recoverable result', () => {
+        const state = makeState({ recoveryAttempts: 1 });
+        const heartbeat = makeHeartbeat({ timestamp: Date.now() - 60000 });
+        const todos = {
+            updatedAt: Date.now(),
+            items: [{ content: 'Fix tests', status: 'pending', activeForm: 'Fixing tests' }],
+        };
+        vi.mocked(existsSync).mockReturnValue(true);
+        vi.mocked(readFileSync).mockImplementation((path) => {
+            if (String(path).includes('heartbeat'))
+                return JSON.stringify(heartbeat);
+            if (String(path).includes('todos'))
+                return JSON.stringify(todos);
+            return JSON.stringify(state);
+        });
+        const result = checkRecovery(WORKTREE);
+        expect(result.canRecover).toBe(true);
+        expect(result.todos).toEqual(todos);
+        expect(result.message).toContain('2/3');
+    });
+});
+describe('createInitialState', () => {
+    it('creates state with all required fields', () => {
+        const before = Date.now();
+        const state = createInitialState({
+            issueId: 'uuid-1',
+            issueIdentifier: 'SUP-10',
+            linearSessionId: 'sess-1',
+            workType: 'development',
+            prompt: 'Do the thing',
+        });
+        const after = Date.now();
+        expect(state.issueId).toBe('uuid-1');
+        expect(state.issueIdentifier).toBe('SUP-10');
+        expect(state.linearSessionId).toBe('sess-1');
+        expect(state.providerSessionId).toBeNull();
+        expect(state.workType).toBe('development');
+        expect(state.prompt).toBe('Do the thing');
+        expect(state.startedAt).toBeGreaterThanOrEqual(before);
+        expect(state.startedAt).toBeLessThanOrEqual(after);
+        expect(state.status).toBe('initializing');
+        expect(state.currentPhase).toBeNull();
+        expect(state.lastUpdatedAt).toBe(state.startedAt);
+        expect(state.recoveryAttempts).toBe(0);
+        expect(state.workerId).toBeNull();
+        expect(state.pid).toBeNull();
+        expect(state.taskListId).toBe('SUP-10-DEV');
+    });
+    it('sets workerId and pid when provided', () => {
+        const state = createInitialState({
+            issueId: 'uuid-2',
+            issueIdentifier: 'SUP-20',
+            linearSessionId: null,
+            workType: 'qa',
+            prompt: 'Run QA',
+            workerId: 'worker-1',
+            pid: 5678,
+        });
+        expect(state.workerId).toBe('worker-1');
+        expect(state.pid).toBe(5678);
+        expect(state.taskListId).toBe('SUP-20-QA');
+    });
+    it('generates correct taskListId for different work types', () => {
+        const cases = [
+            ['research', 'RES'],
+            ['backlog-creation', 'BC'],
+            ['development', 'DEV'],
+            ['coordination', 'COORD'],
+            ['qa', 'QA'],
+            ['acceptance', 'AC'],
+            ['refinement', 'REF'],
+        ];
+        for (const [workType, suffix] of cases) {
+            const state = createInitialState({
+                issueId: 'id',
+                issueIdentifier: 'X-1',
+                linearSessionId: null,
+                workType: workType,
+                prompt: 'test',
+            });
+            expect(state.taskListId).toBe(`X-1-${suffix}`);
+        }
+    });
+});
+describe('buildRecoveryPrompt', () => {
+    it('includes issue identifier and work type', () => {
+        const state = makeState();
+        const prompt = buildRecoveryPrompt(state);
+        expect(prompt).toContain('SUP-42');
+        expect(prompt).toContain('development');
+    });
+    it('includes recovery attempt number', () => {
+        const state = makeState({ recoveryAttempts: 2 });
+        const prompt = buildRecoveryPrompt(state);
+        expect(prompt).toContain('Recovery attempt: 3');
+    });
+    it('includes current phase when present', () => {
+        const state = makeState({ currentPhase: 'testing' });
+        const prompt = buildRecoveryPrompt(state);
+        expect(prompt).toContain('Last phase: testing');
+    });
+    it('omits phase line when currentPhase is null', () => {
+        const state = makeState({ currentPhase: null });
+        const prompt = buildRecoveryPrompt(state);
+        expect(prompt).not.toContain('Last phase:');
+    });
+    it('includes original prompt', () => {
+        const state = makeState({ prompt: 'Implement feature X' });
+        const prompt = buildRecoveryPrompt(state);
+        expect(prompt).toContain('Original prompt: Implement feature X');
+    });
+    it('includes task list ID', () => {
+        const state = makeState();
+        const prompt = buildRecoveryPrompt(state);
+        expect(prompt).toContain('Task list ID: SUP-42-DEV');
+    });
+    it('includes todos when provided', () => {
+        const state = makeState();
+        const todos = {
+            updatedAt: Date.now(),
+            items: [
+                { content: 'Write tests', status: 'completed', activeForm: 'Writing tests' },
+                { content: 'Update docs', status: 'in_progress', activeForm: 'Updating docs' },
+                { content: 'Deploy', status: 'pending', activeForm: 'Deploying' },
+            ],
+        };
+        const prompt = buildRecoveryPrompt(state, todos);
+        expect(prompt).toContain('PREVIOUS TODO LIST');
+        expect(prompt).toContain('[completed] Write tests');
+        expect(prompt).toContain('[in_progress] Update docs');
+        expect(prompt).toContain('[pending] Deploy');
+    });
+    it('omits todo section when todos is undefined', () => {
+        const state = makeState();
+        const prompt = buildRecoveryPrompt(state);
+        expect(prompt).not.toContain('PREVIOUS TODO LIST');
+    });
+    it('omits todo section when todos has no items', () => {
+        const state = makeState();
+        const todos = { updatedAt: Date.now(), items: [] };
+        const prompt = buildRecoveryPrompt(state, todos);
+        expect(prompt).not.toContain('PREVIOUS TODO LIST');
+    });
+});
+describe('getHeartbeatTimeoutFromEnv', () => {
+    const originalEnv = process.env.AGENT_HEARTBEAT_TIMEOUT_MS;
+    afterEach(() => {
+        if (originalEnv === undefined) {
+            delete process.env.AGENT_HEARTBEAT_TIMEOUT_MS;
+        }
+        else {
+            process.env.AGENT_HEARTBEAT_TIMEOUT_MS = originalEnv;
+        }
+    });
+    it('returns default 30000 when env var is not set', () => {
+        delete process.env.AGENT_HEARTBEAT_TIMEOUT_MS;
+        expect(getHeartbeatTimeoutFromEnv()).toBe(30000);
+    });
+    it('parses valid integer from env var', () => {
+        process.env.AGENT_HEARTBEAT_TIMEOUT_MS = '60000';
+        expect(getHeartbeatTimeoutFromEnv()).toBe(60000);
+    });
+    it('returns default for non-numeric env var', () => {
+        process.env.AGENT_HEARTBEAT_TIMEOUT_MS = 'abc';
+        expect(getHeartbeatTimeoutFromEnv()).toBe(30000);
+    });
+    it('returns default for zero value', () => {
+        process.env.AGENT_HEARTBEAT_TIMEOUT_MS = '0';
+        expect(getHeartbeatTimeoutFromEnv()).toBe(30000);
+    });
+    it('returns default for negative value', () => {
+        process.env.AGENT_HEARTBEAT_TIMEOUT_MS = '-5000';
+        expect(getHeartbeatTimeoutFromEnv()).toBe(30000);
+    });
+});
+describe('getMaxRecoveryAttemptsFromEnv', () => {
+    const originalEnv = process.env.AGENT_MAX_RECOVERY_ATTEMPTS;
+    afterEach(() => {
+        if (originalEnv === undefined) {
+            delete process.env.AGENT_MAX_RECOVERY_ATTEMPTS;
+        }
+        else {
+            process.env.AGENT_MAX_RECOVERY_ATTEMPTS = originalEnv;
+        }
+    });
+    it('returns default 3 when env var is not set', () => {
+        delete process.env.AGENT_MAX_RECOVERY_ATTEMPTS;
+        expect(getMaxRecoveryAttemptsFromEnv()).toBe(3);
+    });
+    it('parses valid integer from env var', () => {
+        process.env.AGENT_MAX_RECOVERY_ATTEMPTS = '5';
+        expect(getMaxRecoveryAttemptsFromEnv()).toBe(5);
+    });
+    it('returns default for non-numeric env var', () => {
+        process.env.AGENT_MAX_RECOVERY_ATTEMPTS = 'xyz';
+        expect(getMaxRecoveryAttemptsFromEnv()).toBe(3);
+    });
+    it('returns default for zero value', () => {
+        process.env.AGENT_MAX_RECOVERY_ATTEMPTS = '0';
+        expect(getMaxRecoveryAttemptsFromEnv()).toBe(3);
+    });
+    it('returns default for negative value', () => {
+        process.env.AGENT_MAX_RECOVERY_ATTEMPTS = '-1';
+        expect(getMaxRecoveryAttemptsFromEnv()).toBe(3);
+    });
+});

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

@@ -2,7 +2,7 @@
  * Agent Orchestrator Types
  */
 import type { AgentWorkType } from '@renseiai/agentfactory-linear';
-import type { AgentProvider } from '../providers/types.js';
+import type { AgentProvider, AgentProviderName } from '../providers/types.js';
 /**
  * Result of parsing an agent's output to determine pass/fail
  * Used for QA and acceptance work types to decide status transitions
@@ -137,6 +137,8 @@ export interface AgentProcess {
     stopReason?: 'user_request' | 'timeout';
     /** Last activity timestamp for inactivity timeout tracking */
     lastActivityAt: Date;
+    /** Provider name used to spawn this agent */
+    providerName?: AgentProviderName;
     /** Total cost in USD (accumulated from provider result events) */
     totalCostUsd?: number;
     /** Total input tokens used */
@@ -175,6 +177,10 @@ export interface SpawnAgentOptions {
     teamName?: string;
     /** Project name for path scoping in monorepos */
     projectName?: string;
+    /** Issue labels (used for provider resolution via "provider:<name>" labels) */
+    labels?: string[];
+    /** Mention/prompt context text (used for provider resolution via "use <provider>" patterns) */
+    mentionContext?: string;
 }
 export interface OrchestratorStreamConfig {
     /** Minimum interval between activities in ms (default: 500ms) */
@@ -228,5 +234,9 @@ export interface SpawnAgentWithResumeOptions {
     teamName?: string;
     /** Project name for path scoping in monorepos */
     projectName?: string;
+    /** Issue labels (used for provider resolution via "provider:<name>" labels) */
+    labels?: string[];
+    /** Mention/prompt context text (used for provider resolution via "use <provider>" patterns) */
+    mentionContext?: string;
 }
 //# sourceMappingURL=types.d.ts.map

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;AA0EnB,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAS;IAEjC,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW;IAI5C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,WAAW;IAIhE,OAAO,CAAC,YAAY;CAsKrB;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;AA0EnB,qBAAa,cAAe,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAS;IAEjC,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW;IAI5C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,WAAW;IAIhE,OAAO,CAAC,YAAY;CA4KrB;AAsND;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

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

@@ -137,6 +137,12 @@ export class ClaudeProvider {
                 'Bash(cargo:*)',
                 'Bash(rustc:*)',
                 'Bash(go:*)',
+                // iOS/Apple development tools
+                'Bash(xcodebuild:*)',
+                'Bash(xcrun:*)',
+                'Bash(xcodegen:*)',
+                'Bash(swift:*)',
+                'Bash(swiftlint:*)',
                 'Bash(bash:*)',
                 'Bash(sh:*)',
                 'Bash(./:*)',

package/dist/src/providers/index.d.ts

@@ -2,12 +2,18 @@
  * Agent Provider Factory
  *
  * Creates provider instances based on name.
- * Supports provider selection via env vars:
- *   AGENT_PROVIDER=claude            (global default)
- *   AGENT_PROVIDER_SOCIAL=codex      (per-project override)
- *   AGENT_PROVIDER_QA=amp            (per-work-type override)
+ * Supports provider selection via env vars, config, labels, and mentions.
  *
- * Resolution order: work-type → project → env default → 'claude'
+ * Resolution order (highest → lowest):
+ * 1. Issue label override (provider:codex)
+ * 2. Mention context override ("use codex", "@codex")
+ * 3. Config providers.byWorkType
+ * 4. Config providers.byProject
+ * 5. Env var AGENT_PROVIDER_{WORKTYPE}
+ * 6. Env var AGENT_PROVIDER_{PROJECT}
+ * 7. Config providers.default
+ * 8. Env var AGENT_PROVIDER
+ * 9. Hardcoded 'claude'
  */
 export type { AgentProviderName, AgentProvider, AgentSpawnConfig, AgentHandle, AgentEvent } from './types.js';
 export type { AgentInitEvent, AgentSystemEvent, AgentAssistantTextEvent, AgentToolUseEvent, AgentToolResultEvent, AgentToolProgressEvent, AgentResultEvent, AgentErrorEvent, AgentCostData, } from './types.js';
@@ -17,6 +23,34 @@ export { AmpProvider, createAmpProvider } from './amp-provider.js';
 export { SpringAiProvider, createSpringAiProvider } from './spring-ai-provider.js';
 export { A2aProvider, createA2aProvider } from './a2a-provider.js';
 import type { AgentProvider, AgentProviderName } from './types.js';
+/** Provider configuration from .agentfactory/config.yaml */
+export interface ProvidersConfig {
+    /** Default provider for all agents */
+    default?: AgentProviderName;
+    /** Provider overrides by work type (e.g., { qa: 'codex' }) */
+    byWorkType?: Record<string, AgentProviderName>;
+    /** Provider overrides by project name (e.g., { Social: 'codex' }) */
+    byProject?: Record<string, AgentProviderName>;
+}
+/** Context for resolving which provider to use for a specific spawn */
+export interface ProviderResolutionContext {
+    /** Project name (e.g., "Social") */
+    project?: string;
+    /** Work type (e.g., "qa", "development") */
+    workType?: string;
+    /** Issue labels (scanned for "provider:<name>") */
+    labels?: string[];
+    /** Mention text (scanned for "use <provider>", "@<provider>", "provider:<provider>") */
+    mentionContext?: string;
+    /** Config-driven provider settings from .agentfactory/config.yaml */
+    configProviders?: ProvidersConfig;
+}
+/** Result of provider resolution with source for logging */
+export interface ProviderResolutionResult {
+    name: AgentProviderName;
+    source: string;
+}
+export declare const PROVIDER_ALIASES: Record<string, AgentProviderName>;
 /**
  * Create a provider instance by name.
  *
@@ -26,19 +60,41 @@ import type { AgentProvider, AgentProviderName } from './types.js';
  */
 export declare function createProvider(name: AgentProviderName): AgentProvider;
 /**
- * Resolve which provider to use based on env vars, project, and work type.
+ * Extract provider name from issue labels.
+ * Looks for labels matching "provider:<name>" pattern.
+ */
+export declare function extractProviderFromLabels(labels: string[]): AgentProviderName | null;
+/**
+ * Extract provider name from mention/prompt context text.
+ * Matches: "use <provider>", "@<provider>", "provider:<provider>"
+ * Case-insensitive, word-boundary aware.
+ */
+export declare function extractProviderFromMention(text: string): AgentProviderName | null;
+/**
+ * Resolve which provider to use with full priority cascade.
  *
- * Resolution order (highest priority first):
- * 1. AGENT_PROVIDER_{WORKTYPE} (e.g., AGENT_PROVIDER_QA=amp)
- * 2. AGENT_PROVIDER_{PROJECT} (e.g., AGENT_PROVIDER_SOCIAL=codex)
- * 3. AGENT_PROVIDER (global default)
- * 4. 'claude' (fallback)
+ * Resolution order (highest → lowest):
+ * 1. Issue label override (provider:codex)
+ * 2. Mention context override ("use codex", "@codex")
+ * 3. Config providers.byWorkType
+ * 4. Config providers.byProject
+ * 5. Env var AGENT_PROVIDER_{WORKTYPE}
+ * 6. Env var AGENT_PROVIDER_{PROJECT}
+ * 7. Config providers.default
+ * 8. Env var AGENT_PROVIDER
+ * 9. Hardcoded 'claude'
+ *
+ * @param context - Full resolution context (backwards-compatible with old { project, workType } shape)
+ * @returns The resolved provider name and its source
+ */
+export declare function resolveProviderWithSource(context?: ProviderResolutionContext): ProviderResolutionResult;
+/**
+ * Resolve which provider to use based on context.
+ * Backwards-compatible wrapper around resolveProviderWithSource().
  *
  * @param options - Project and work type context for resolution
  * @returns The resolved provider name
  */
-export declare function resolveProviderName(options?: {
-    project?: string;
-    workType?: string;
-}): AgentProviderName;
+export declare function resolveProviderName(options?: ProviderResolutionContext): AgentProviderName;
+export declare function isValidProviderName(name: string): name is AgentProviderName;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/providers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC7G,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAClF,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAOlE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAerE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,iBAAiB,CA2BpB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC7G,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAClF,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAWlE,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IAC9C,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;CAC9C;AAED,uEAAuE;AACvE,MAAM,WAAW,yBAAyB;IACxC,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qEAAqE;IACrE,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC;AAED,4DAA4D;AAC5D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,iBAAiB,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;CACf;AAMD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAK9D,CAAA;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAkBrE;AAMD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,iBAAiB,GAAG,IAAI,CAWpF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CA6BjF;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,wBAAwB,CAgEvG;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,iBAAiB,CAE1F;AAQD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,iBAAiB,CAE3E"}