@mrpatronz/nexusflow 1.9.1 → 2.1.1

package/dist/agent/CopilotAcpAdapter.d.ts

@@ -0,0 +1,7 @@
+import { AcpCliAdapter, type AcpTransportFactory } from './AcpCliAdapter.js';
+/** Copilot ACP starts with a read/search-only tool surface. */
+export declare function buildCopilotAcpArgs(): string[];
+export declare class CopilotAcpAdapter extends AcpCliAdapter {
+    constructor(transportFactory?: AcpTransportFactory);
+}
+//# sourceMappingURL=CopilotAcpAdapter.d.ts.map

package/dist/agent/CopilotAcpAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopilotAcpAdapter.d.ts","sourceRoot":"","sources":["../../src/agent/CopilotAcpAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAI7E,+DAA+D;AAC/D,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAW9C;AAED,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,gBAAgB,CAAC,EAAE,mBAAmB;CAUnD"}

package/dist/agent/CopilotAcpAdapter.js

@@ -0,0 +1,29 @@
+import { AcpCliAdapter } from './AcpCliAdapter.js';
+import { findExecutable } from './cliAvailability.js';
+import { isValidSessionUuid } from './session.js';
+/** Copilot ACP starts with a read/search-only tool surface. */
+export function buildCopilotAcpArgs() {
+    return [
+        '--acp',
+        '--stdio',
+        '--available-tools=view,glob,grep',
+        '--disable-builtin-mcps',
+        '--no-ask-user',
+        '--no-auto-update',
+        '--no-remote',
+        '--no-remote-export',
+    ];
+}
+export class CopilotAcpAdapter extends AcpCliAdapter {
+    constructor(transportFactory) {
+        super({
+            executable: findExecutable('copilot') ?? 'copilot',
+            args: buildCopilotAcpArgs(),
+            label: 'GitHub Copilot CLI',
+            loginCommand: 'copilot login',
+            validateSessionId: isValidSessionUuid,
+            transportFactory,
+        });
+    }
+}
+//# sourceMappingURL=CopilotAcpAdapter.js.map

package/dist/agent/CopilotAcpAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopilotAcpAdapter.js","sourceRoot":"","sources":["../../src/agent/CopilotAcpAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA4B,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,+DAA+D;AAC/D,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,OAAO;QACP,SAAS;QACT,kCAAkC;QAClC,wBAAwB;QACxB,eAAe;QACf,kBAAkB;QAClB,aAAa;QACb,oBAAoB;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD,YAAY,gBAAsC;QAChD,KAAK,CAAC;YACJ,UAAU,EAAE,cAAc,CAAC,SAAS,CAAC,IAAI,SAAS;YAClD,IAAI,EAAE,mBAAmB,EAAE;YAC3B,KAAK,EAAE,oBAAoB;YAC3B,YAAY,EAAE,eAAe;YAC7B,iBAAiB,EAAE,kBAAkB;YACrC,gBAAgB;SACjB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/agent/ProviderRegistry.d.ts

@@ -5,26 +5,73 @@ export interface ProviderStatus {
     isConfigured: boolean;
     message?: string;
     icon?: string;
+    accessLabel?: string;
+    setupIssue?: ProviderSetupIssue;
+    recoveryCommand?: string;
+    recoveryLabel?: string;
+    executionProfiles?: readonly ProviderExecutionProfile[];
+    defaultExecutionProfile?: AgentExecutionProfile;
+    capabilities: ProviderCapabilities;
 }
+export type AgentExecutionProfile = 'review' | 'workspace-write';
+export interface ProviderExecutionProfile {
+    id: AgentExecutionProfile;
+    label: string;
+    description: string;
+}
+export type ProviderSetupIssue = 'missing-cli' | 'signed-out' | 'probe-failed';
+export interface ProviderSetupHelp {
+    setupIssue: ProviderSetupIssue;
+    recoveryCommand: string;
+    recoveryLabel: string;
+}
+export interface ProviderCapabilities {
+    transport: 'native-api' | 'cli-print' | 'acp';
+    sessionIdentity: 'none' | 'client-assigned' | 'provider-assigned';
+    workspaceAccess: 'read-only' | 'workspace-write' | 'harness-managed';
+    sessionIdFormat?: 'uuid' | 'opaque';
+}
+export type AgentEvent = 'data' | 'close' | 'error' | 'system' | 'idle' | 'session';
 export interface AgentHarness {
     start(cwd: string, session?: AgentSession): Promise<void>;
-    send(data: string): Promise<void>;
+    send(data: string, executionProfile?: AgentExecutionProfile): Promise<void>;
     stop(): void;
-    on(event: 'data' | 'close' | 'error' | 'system' | 'idle', listener: (...args: any[]) => void): this;
+    on(event: AgentEvent, listener: (...args: any[]) => void): this;
+    /**
+     * Detaches a listener, so a caller that attaches per operation on a long-lived
+     * harness can clean up rather than accumulating listener sets. Satisfied for
+     * free by EventEmitter, which every adapter extends.
+     *
+     * Nothing in this package calls it today — the caller it was added for was the
+     * workflow engine — but it belongs on the interface: `on` without `off` makes
+     * any repeated use of a harness a leak.
+     */
+    off(event: AgentEvent, listener: (...args: any[]) => void): this;
 }
 export interface ProviderAdapter {
     id: string;
     name: string;
     icon?: string;
+    accessLabel?: string;
+    capabilities: ProviderCapabilities;
+    executionProfiles?: readonly ProviderExecutionProfile[];
+    defaultExecutionProfile?: AgentExecutionProfile;
     isConfigured(): boolean;
     getStatusMessage(): string | undefined;
+    getSetupHelp?(): ProviderSetupHelp | undefined;
+    invalidateStatus?(): void;
     createInstance(): AgentHarness;
 }
 declare class ProviderRegistryImpl {
     private providers;
+    private lastRefreshCompletedAt;
     register(provider: ProviderAdapter): void;
     getProvider(id: string): ProviderAdapter | undefined;
-    getAllStatus(): ProviderStatus[];
+    /** Resolve an untyped renderer value against provider-owned profiles. */
+    resolveExecutionProfile(provider: ProviderAdapter, requested: unknown): AgentExecutionProfile | undefined | null;
+    getAllStatus(options?: {
+        refreshProviderId?: string;
+    }): ProviderStatus[];
 }
 export declare const ProviderRegistry: ProviderRegistryImpl;
 export {};

package/dist/agent/ProviderRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProviderRegistry.d.ts","sourceRoot":"","sources":["../../src/agent/ProviderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,IAAI,IAAI,CAAC;IACb,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CACrG;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,IAAI,OAAO,CAAC;IACxB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAAC;IACvC,cAAc,IAAI,YAAY,CAAC;CAChC;AAED,cAAM,oBAAoB;IACxB,OAAO,CAAC,SAAS,CAA2C;IAE5D,QAAQ,CAAC,QAAQ,EAAE,eAAe;IAIlC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIpD,YAAY,IAAI,cAAc,EAAE;CASjC;AAED,eAAO,MAAM,gBAAgB,sBAA6B,CAAC"}
+{"version":3,"file":"ProviderRegistry.d.ts","sourceRoot":"","sources":["../../src/agent/ProviderRegistry.ts"],"names":[],"mappings":"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"}

package/dist/agent/ProviderRegistry.js

@@ -1,19 +1,54 @@
 class ProviderRegistryImpl {
     providers = new Map();
+    lastRefreshCompletedAt = new Map();
     register(provider) {
         this.providers.set(provider.id, provider);
     }
     getProvider(id) {
         return this.providers.get(id);
     }
-    getAllStatus() {
-        return Array.from(this.providers.values()).map(p => ({
-            id: p.id,
-            name: p.name,
-            icon: p.icon,
-            isConfigured: p.isConfigured(),
-            message: p.getStatusMessage()
-        }));
+    /** Resolve an untyped renderer value against provider-owned profiles. */
+    resolveExecutionProfile(provider, requested) {
+        const profiles = provider.executionProfiles;
+        if (!profiles?.length)
+            return requested === undefined ? undefined : null;
+        if (requested !== 'review' && requested !== 'workspace-write')
+            return null;
+        return profiles.some(profile => profile.id === requested) ? requested : null;
+    }
+    getAllStatus(options = {}) {
+        const providers = Array.from(this.providers.values());
+        const refreshProvider = options.refreshProviderId
+            ? this.providers.get(options.refreshProviderId)
+            : undefined;
+        const lastRefresh = options.refreshProviderId
+            ? this.lastRefreshCompletedAt.get(options.refreshProviderId) ?? 0
+            : 0;
+        const shouldRefresh = Boolean(refreshProvider?.invalidateStatus
+            && Date.now() - lastRefresh >= 1_000);
+        if (shouldRefresh)
+            refreshProvider?.invalidateStatus?.();
+        const statuses = providers.map(provider => {
+            const setup = provider.getSetupHelp?.();
+            return {
+                id: provider.id,
+                name: provider.name,
+                icon: provider.icon,
+                accessLabel: provider.accessLabel,
+                capabilities: provider.capabilities,
+                executionProfiles: provider.executionProfiles,
+                defaultExecutionProfile: provider.defaultExecutionProfile,
+                isConfigured: provider.isConfigured(),
+                message: provider.getStatusMessage(),
+                ...setup,
+            };
+        });
+        // Timestamp after all synchronous probes finish so requests queued during
+        // a slow refresh reuse its result instead of immediately spawning again.
+        if (shouldRefresh && options.refreshProviderId) {
+            this.lastRefreshCompletedAt.set(options.refreshProviderId, Date.now());
+        }
+        return statuses;
     }
 }
 export const ProviderRegistry = new ProviderRegistryImpl();

package/dist/agent/ProviderRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProviderRegistry.js","sourceRoot":"","sources":["../../src/agent/ProviderRegistry.ts"],"names":[],"mappings":"AA0BA,MAAM,oBAAoB;IAChB,SAAS,GAAiC,IAAI,GAAG,EAAE,CAAC;IAE5D,QAAQ,CAAC,QAAyB;QAChC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,WAAW,CAAC,EAAU;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACnD,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE;YAC9B,OAAO,EAAE,CAAC,CAAC,gBAAgB,EAAE;SAC9B,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"ProviderRegistry.js","sourceRoot":"","sources":["../../src/agent/ProviderRegistry.ts"],"names":[],"mappings":"AA0EA,MAAM,oBAAoB;IAChB,SAAS,GAAiC,IAAI,GAAG,EAAE,CAAC;IACpD,sBAAsB,GAAwB,IAAI,GAAG,EAAE,CAAC;IAEhE,QAAQ,CAAC,QAAyB;QAChC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,WAAW,CAAC,EAAU;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,yEAAyE;IACzE,uBAAuB,CAAC,QAAyB,EAAE,SAAkB;QACnE,MAAM,QAAQ,GAAG,QAAQ,CAAC,iBAAiB,CAAC;QAC5C,IAAI,CAAC,QAAQ,EAAE,MAAM;YAAE,OAAO,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;QACzE,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,iBAAiB;YAAE,OAAO,IAAI,CAAC;QAC3E,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/E,CAAC;IAED,YAAY,CAAC,UAA0C,EAAE;QACvD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,MAAM,eAAe,GAAG,OAAO,CAAC,iBAAiB;YAC/C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC;YAC/C,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB;YAC3C,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC;YACjE,CAAC,CAAC,CAAC,CAAC;QACN,MAAM,aAAa,GAAG,OAAO,CAC3B,eAAe,EAAE,gBAAgB;eAC9B,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,IAAI,KAAK,CACrC,CAAC;QACF,IAAI,aAAa;YAAE,eAAe,EAAE,gBAAgB,EAAE,EAAE,CAAC;QAEzD,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;YACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC;YACxC,OAAO;gBACL,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,YAAY,EAAE,QAAQ,CAAC,YAAY;gBACnC,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;gBAC7C,uBAAuB,EAAE,QAAQ,CAAC,uBAAuB;gBACzD,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE;gBACrC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,EAAE;gBACpC,GAAG,KAAK;aACT,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,0EAA0E;QAC1E,yEAAyE;QACzE,IAAI,aAAa,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC/C,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,oBAAoB,EAAE,CAAC"}

package/dist/agent/ProviderRegistry.test.js

@@ -8,6 +8,7 @@ class MockAgentHarness {
     async send(data) { }
     stop() { }
     on(event, listener) { return this; }
+    off(event, listener) { return this; }
 }
 // The registry is a shared singleton without a reset method, so each test
 // registers its own uniquely-named provider to stay order-independent.
@@ -15,6 +16,7 @@ function makeProvider(id, overrides = {}) {
     return {
         id,
         name: 'Mock',
+        capabilities: { transport: 'native-api', sessionIdentity: 'none', workspaceAccess: 'read-only' },
         isConfigured: () => true,
         getStatusMessage: () => undefined,
         createInstance: () => new MockAgentHarness(),
@@ -40,6 +42,7 @@ describe('ProviderRegistry', () => {
         expect(unconfiguredStatus).toBeDefined();
         expect(unconfiguredStatus?.isConfigured).toBe(false);
         expect(unconfiguredStatus?.message).toBe('Missing API Key');
+        expect(unconfiguredStatus?.capabilities.workspaceAccess).toBe('read-only');
     });
     it('should create an instance correctly', () => {
         ProviderRegistry.register(makeProvider('mock-instance'));
@@ -53,5 +56,55 @@ describe('ProviderRegistry', () => {
             expect(instance.started).toBe(true);
         }
     });
+    it('exposes closed setup recovery metadata and invalidates cached status on refresh', () => {
+        let configured = false;
+        let invalidations = 0;
+        ProviderRegistry.register(makeProvider('mock-refreshable', {
+            isConfigured: () => configured,
+            getStatusMessage: () => configured ? undefined : 'Sign in.',
+            getSetupHelp: () => configured ? undefined : {
+                setupIssue: 'signed-out',
+                recoveryCommand: 'mock auth login',
+                recoveryLabel: 'Copy sign-in command',
+            },
+            invalidateStatus: () => {
+                invalidations += 1;
+                configured = true;
+            },
+        }));
+        expect(ProviderRegistry.getAllStatus().find(status => status.id === 'mock-refreshable'))
+            .toMatchObject({ isConfigured: false, setupIssue: 'signed-out' });
+        expect(ProviderRegistry.getAllStatus({ refreshProviderId: 'mock-refreshable' }).find(status => status.id === 'mock-refreshable'))
+            .toMatchObject({ isConfigured: true });
+        ProviderRegistry.getAllStatus({ refreshProviderId: 'mock-refreshable' });
+        expect(invalidations).toBe(1);
+    });
+    it('exposes provider-owned execution profiles and validates turn authorization', () => {
+        const provider = makeProvider('mock-profiled', {
+            executionProfiles: [
+                { id: 'review', label: 'Review only', description: 'Read-only.' },
+                { id: 'workspace-write', label: 'Edit workspace', description: 'Workspace edits.' },
+            ],
+            defaultExecutionProfile: 'review',
+        });
+        ProviderRegistry.register(provider);
+        expect(ProviderRegistry.getAllStatus().find(status => status.id === 'mock-profiled'))
+            .toMatchObject({
+            defaultExecutionProfile: 'review',
+            executionProfiles: [
+                { id: 'review', label: 'Review only' },
+                { id: 'workspace-write', label: 'Edit workspace' },
+            ],
+        });
+        expect(ProviderRegistry.resolveExecutionProfile(provider, 'review')).toBe('review');
+        expect(ProviderRegistry.resolveExecutionProfile(provider, 'workspace-write')).toBe('workspace-write');
+        expect(ProviderRegistry.resolveExecutionProfile(provider, undefined)).toBeNull();
+        expect(ProviderRegistry.resolveExecutionProfile(provider, 'danger-full-access')).toBeNull();
+    });
+    it('keeps legacy providers profile-free', () => {
+        const provider = makeProvider('mock-legacy-profile');
+        expect(ProviderRegistry.resolveExecutionProfile(provider, undefined)).toBeUndefined();
+        expect(ProviderRegistry.resolveExecutionProfile(provider, 'review')).toBeNull();
+    });
 });
 //# sourceMappingURL=ProviderRegistry.test.js.map

package/dist/agent/ProviderRegistry.test.js.map

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

package/dist/agent/adapters.d.ts

@@ -1,3 +1,19 @@
 import { ProviderRegistry } from './ProviderRegistry.js';
+/**
+ * Wraps a synchronous detector in a short-lived cache.
+ *
+ * `isConfigured()` and `getStatusMessage()` are separate calls on the same
+ * provider, so listing statuses ran every detector twice. CLI detectors walk
+ * PATH and may spawn a bounded provider-owned status command, so duplicate
+ * probes materially slow the request.
+ *
+ * A few seconds is the right window: long enough to collapse the duplicate calls
+ * within one request, short enough that installing a CLI or signing in is
+ * noticed almost immediately rather than needing a restart.
+ */
+export type CachedStatusReader<T> = (() => T) & {
+    invalidate(): void;
+};
+export declare function cachedStatus<T>(detect: () => T, ttlMs?: number): CachedStatusReader<T>;
 export { ProviderRegistry };
 //# sourceMappingURL=adapters.d.ts.map

package/dist/agent/adapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/agent/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAoDzD,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/agent/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAA0B,MAAM,uBAAuB,CAAC;AAiDjF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG;IAAE,UAAU,IAAI,IAAI,CAAA;CAAE,CAAC;AAEvE,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,SAAQ,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAuBrF;AAqGD,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/agent/adapters.js

@@ -1,13 +1,18 @@
 import { ProviderRegistry } from './ProviderRegistry.js';
+import { detectAntigravityCliStatus, detectClaudeCliStatus, detectCodexCliStatus, detectCopilotCliStatus, } from './cliAvailability.js';
 import { NativeClaudeAgent } from './NativeClaudeAgent.js';
 import { NativeAgent } from './NativeAgent.js';
 import { NativeGoogleAgent } from './NativeGoogleAgent.js';
 import { ClaudeCliAdapter } from './ClaudeCliAdapter.js';
 import { AntigravityCliAdapter } from './AntigravityCliAdapter.js';
+import { CodexCliAdapter } from './CodexCliAdapter.js';
+import { CopilotAcpAdapter } from './CopilotAcpAdapter.js';
 ProviderRegistry.register({
     id: 'claude-native',
     name: 'Claude',
     icon: 'Bot',
+    accessLabel: 'Read-only tools',
+    capabilities: { transport: 'native-api', sessionIdentity: 'none', workspaceAccess: 'read-only' },
     isConfigured: () => !!process.env.ANTHROPIC_API_KEY,
     getStatusMessage: () => process.env.ANTHROPIC_API_KEY ? undefined : 'Anthropic API key is not configured in ANTHROPIC_API_KEY.',
     createInstance: () => new NativeClaudeAgent()
@@ -16,6 +21,8 @@ ProviderRegistry.register({
     id: 'openai-native',
     name: 'OpenAI',
     icon: 'Sparkles',
+    accessLabel: 'Read-only tools',
+    capabilities: { transport: 'native-api', sessionIdentity: 'none', workspaceAccess: 'read-only' },
     isConfigured: () => !!process.env.OPENAI_API_KEY,
     getStatusMessage: () => process.env.OPENAI_API_KEY ? undefined : 'OpenAI API key is not configured in OPENAI_API_KEY.',
     createInstance: () => new NativeAgent()
@@ -24,25 +31,128 @@ ProviderRegistry.register({
     id: 'google-native',
     name: 'Google Gemini',
     icon: 'Sparkles',
+    accessLabel: 'Read-only tools',
+    capabilities: { transport: 'native-api', sessionIdentity: 'none', workspaceAccess: 'read-only' },
     isConfigured: () => !!process.env.GEMINI_API_KEY,
     getStatusMessage: () => process.env.GEMINI_API_KEY ? undefined : 'Google API key is not configured in GEMINI_API_KEY.',
     createInstance: () => new NativeGoogleAgent()
 });
+export function cachedStatus(detect, ttlMs = 5_000) {
+    // Freshness is tracked with a flag, not by testing the value: keying on
+    // `value === undefined` would make a detector that legitimately returns
+    // undefined re-run on every read, which is the case this exists to avoid.
+    let cached = null;
+    let readAt = 0;
+    const read = (() => {
+        const now = Date.now();
+        if (!cached || now - readAt >= ttlMs) {
+            const value = detect();
+            // Age the cache from completion. A detector that consumes its whole
+            // timeout must still be reused by the other fields in this status read.
+            cached = { value };
+            readAt = Date.now();
+        }
+        return cached.value;
+    });
+    read.invalidate = () => {
+        cached = null;
+        readAt = 0;
+    };
+    return read;
+}
+function setupHelp(status) {
+    if (!status.setupIssue || !status.recoveryCommand || !status.recoveryLabel)
+        return undefined;
+    return {
+        setupIssue: status.setupIssue,
+        recoveryCommand: status.recoveryCommand,
+        recoveryLabel: status.recoveryLabel,
+    };
+}
+// The CLI providers need no API key, but "installed" is not the same as "usable":
+// a CLI can be on PATH and still have no credentials a spawned process can use.
+// Reporting that up front beats letting the first turn fail with whatever the CLI
+// happened to print.
+const claudeCliStatus = cachedStatus(() => detectClaudeCliStatus());
+const antigravityCliStatus = cachedStatus(() => detectAntigravityCliStatus());
+const codexCliStatus = cachedStatus(() => detectCodexCliStatus());
+const copilotCliStatus = cachedStatus(() => detectCopilotCliStatus());
 ProviderRegistry.register({
     id: 'claude-cli',
     name: 'Claude Code (Local CLI)',
     icon: 'Terminal',
-    isConfigured: () => true, // Assume the CLI is installed for now
-    getStatusMessage: () => undefined, // No API key required!
+    accessLabel: 'Harness-managed access',
+    executionProfiles: [
+        { id: 'review', label: 'Review only', description: 'Reads and plans; no source edits.' },
+        {
+            id: 'workspace-write',
+            label: 'Edit workspace',
+            description: 'Auto-accepts in-workspace file edits and common filesystem actions; other approval-requiring commands are unavailable in embedded chat.',
+        },
+    ],
+    defaultExecutionProfile: 'review',
+    capabilities: {
+        transport: 'cli-print',
+        sessionIdentity: 'client-assigned',
+        workspaceAccess: 'harness-managed',
+        sessionIdFormat: 'uuid',
+    },
+    isConfigured: () => claudeCliStatus().usable,
+    getStatusMessage: () => claudeCliStatus().message,
+    getSetupHelp: () => setupHelp(claudeCliStatus()),
+    invalidateStatus: () => claudeCliStatus.invalidate(),
     createInstance: () => new ClaudeCliAdapter()
 });
 ProviderRegistry.register({
     id: 'antigravity-cli',
     name: 'Antigravity (Local CLI)',
     icon: 'Terminal',
-    isConfigured: () => true, // Assume the CLI is installed for now
-    getStatusMessage: () => undefined, // No API key required!
+    accessLabel: 'Harness-managed access',
+    capabilities: { transport: 'cli-print', sessionIdentity: 'none', workspaceAccess: 'harness-managed' },
+    isConfigured: () => antigravityCliStatus().usable,
+    getStatusMessage: () => antigravityCliStatus().message,
     createInstance: () => new AntigravityCliAdapter()
 });
+ProviderRegistry.register({
+    id: 'codex-cli',
+    name: 'Codex (Local CLI)',
+    icon: 'Terminal',
+    accessLabel: 'Workspace write',
+    executionProfiles: [
+        { id: 'review', label: 'Review only', description: 'Read-only sandbox; escalation is denied.' },
+        {
+            id: 'workspace-write',
+            label: 'Edit workspace',
+            description: 'Workspace-write sandbox; command network and escalation outside the sandbox are denied.',
+        },
+    ],
+    defaultExecutionProfile: 'review',
+    capabilities: {
+        transport: 'cli-print',
+        sessionIdentity: 'provider-assigned',
+        workspaceAccess: 'workspace-write',
+        sessionIdFormat: 'uuid',
+    },
+    isConfigured: () => codexCliStatus().usable,
+    getStatusMessage: () => codexCliStatus().message,
+    getSetupHelp: () => setupHelp(codexCliStatus()),
+    invalidateStatus: () => codexCliStatus.invalidate(),
+    createInstance: () => new CodexCliAdapter()
+});
+ProviderRegistry.register({
+    id: 'copilot-cli',
+    name: 'GitHub Copilot (Local CLI)',
+    icon: 'Terminal',
+    accessLabel: 'Read-only workspace tools',
+    capabilities: {
+        transport: 'acp',
+        sessionIdentity: 'provider-assigned',
+        workspaceAccess: 'read-only',
+        sessionIdFormat: 'uuid',
+    },
+    isConfigured: () => copilotCliStatus().usable,
+    getStatusMessage: () => copilotCliStatus().message,
+    createInstance: () => new CopilotAcpAdapter()
+});
 export { ProviderRegistry };
 //# sourceMappingURL=adapters.js.map

package/dist/agent/adapters.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/agent/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,gBAAgB,CAAC,QAAQ,CAAC;IACxB,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,KAAK;IACX,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB;IACnD,gBAAgB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,2DAA2D;IAC/H,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,iBAAiB,EAAE;CAC9C,CAAC,CAAC;AAEH,gBAAgB,CAAC,QAAQ,CAAC;IACxB,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,UAAU;IAChB,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc;IAChD,gBAAgB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,qDAAqD;IACtH,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,WAAW,EAAE;CACxC,CAAC,CAAC;AAEH,gBAAgB,CAAC,QAAQ,CAAC;IACxB,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,UAAU;IAChB,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc;IAChD,gBAAgB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,qDAAqD;IACtH,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,iBAAiB,EAAE;CAC9C,CAAC,CAAC;AAEH,gBAAgB,CAAC,QAAQ,CAAC;IACxB,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,yBAAyB;IAC/B,IAAI,EAAE,UAAU;IAChB,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,sCAAsC;IAChE,gBAAgB,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,uBAAuB;IAC1D,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,gBAAgB,EAAE;CAC7C,CAAC,CAAC;AAEH,gBAAgB,CAAC,QAAQ,CAAC;IACxB,EAAE,EAAE,iBAAiB;IACrB,IAAI,EAAE,yBAAyB;IAC/B,IAAI,EAAE,UAAU;IAChB,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,sCAAsC;IAChE,gBAAgB,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,uBAAuB;IAC1D,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,qBAAqB,EAAE;CAClD,CAAC,CAAC;AAEH,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/agent/adapters.ts"],"names":[],"mappings":"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"}

package/dist/agent/adapters.test.d.ts

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

package/dist/agent/adapters.test.d.ts.map

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

package/dist/agent/adapters.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { cachedStatus } from './adapters.js';
+describe('cachedStatus', () => {
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('detects once for repeated reads inside the window', () => {
+        // isConfigured() and getStatusMessage() are separate calls on the same
+        // provider, so listing statuses ran every detector twice — and each walks
+        // PATH with a statSync per directory per PATHEXT entry, then reads a
+        // credentials file.
+        const detect = vi.fn(() => ({ usable: true }));
+        const read = cachedStatus(detect);
+        read();
+        read();
+        read();
+        expect(detect).toHaveBeenCalledTimes(1);
+    });
+    it('returns the same value each time it is cached', () => {
+        const detect = vi.fn(() => ({ usable: false, message: 'not signed in' }));
+        const read = cachedStatus(detect);
+        expect(read()).toEqual({ usable: false, message: 'not signed in' });
+        expect(read()).toEqual({ usable: false, message: 'not signed in' });
+    });
+    it('re-detects once the window has passed, so an install is noticed', () => {
+        // A permanent cache would need a restart to see a newly installed CLI.
+        vi.useFakeTimers();
+        const detect = vi.fn(() => ({ usable: false }));
+        const read = cachedStatus(detect, 5_000);
+        read();
+        vi.advanceTimersByTime(4_999);
+        read();
+        expect(detect).toHaveBeenCalledTimes(1);
+        vi.advanceTimersByTime(1);
+        read();
+        expect(detect).toHaveBeenCalledTimes(2);
+    });
+    it('caches an undefined result too', () => {
+        // Freshness is a flag, not a test of the value: keying on
+        // `value === undefined` would make a detector that legitimately returns
+        // undefined re-run on every read, defeating the whole point.
+        const detect = vi.fn(() => undefined);
+        const read = cachedStatus(detect);
+        read();
+        read();
+        expect(detect).toHaveBeenCalledTimes(1);
+    });
+    it('re-detects immediately after an explicit invalidation', () => {
+        const detect = vi.fn()
+            .mockReturnValueOnce({ usable: false })
+            .mockReturnValueOnce({ usable: true });
+        const read = cachedStatus(detect);
+        expect(read()).toEqual({ usable: false });
+        read.invalidate();
+        expect(read()).toEqual({ usable: true });
+        expect(detect).toHaveBeenCalledTimes(2);
+    });
+    it('ages the cache from completion of a slow detector', () => {
+        vi.useFakeTimers();
+        const detect = vi.fn(() => {
+            vi.advanceTimersByTime(5_000);
+            return { usable: false };
+        });
+        const read = cachedStatus(detect, 5_000);
+        read();
+        read();
+        read();
+        expect(detect).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=adapters.test.js.map

package/dist/agent/adapters.test.js.map

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