@agent-link/agent 0.1.338 → 0.1.340

package/dist/copilot-capabilities.d.ts

@@ -0,0 +1,43 @@
+export declare const COPILOT_CAPABILITY_MODELS: readonly ["gpt-6.1-sol", "gpt-6-sol", "gpt-6-astra", "gpt-5.6-luna", "gpt-5.6-sol", "gpt-5.6-sol-fast", "gpt-5.6-terra", "gpt-5.5", "gpt-5-mini"];
+export declare const COPILOT_CAPABILITY_EFFORTS: string[];
+type Source = 'backend' | 'offline';
+export interface CopilotModelCapability {
+    id: string;
+    parameterPolicy?: 'strict' | 'passthrough';
+    available?: boolean;
+    contexts: Partial<Record<'default' | 'long_context', boolean>>;
+    efforts?: string[];
+    defaults?: {
+        context?: string;
+        effort?: string;
+    };
+    combinations?: Array<{
+        context: string;
+        effort: string;
+    }>;
+    declaredWindows?: Partial<Record<'default' | 'long_context', number>>;
+    sources: Record<string, Source>;
+}
+export interface CopilotCapabilityCatalog {
+    providerId: string;
+    backendVersion?: string;
+    offlineVersion?: string;
+    models: CopilotModelCapability[];
+    status: 'ready' | 'partial' | 'offline';
+    fetchedAt: string;
+    scope?: string;
+    error?: string;
+}
+export declare function hasCopilotOfflineModel(providerId: string, modelId?: string): boolean;
+export declare function mergeCopilotCapabilities(providerId: string, response?: unknown, backendVersion?: string, offline?: Record<string, any>): CopilotCapabilityCatalog;
+export declare function copilotCapabilityIssue(catalog: CopilotCapabilityCatalog, options: {
+    model?: string;
+    context?: string;
+    effort?: string;
+}): 'model' | 'context' | 'effort' | undefined;
+export declare function assertCopilotCapabilities(catalog: CopilotCapabilityCatalog, options: {
+    model?: string;
+    context?: string;
+    effort?: string;
+}): void;
+export {};

package/dist/copilot-capabilities.js

@@ -0,0 +1,128 @@
+import { COPILOT_OFFLINE_CAPABILITIES } from './copilot-capabilities-offline.js';
+// Include retired IDs for existing Sessions; new launches obtain capabilities
+// from their own backend declaration, never from a different model's snapshot.
+export const COPILOT_CAPABILITY_MODELS = ['gpt-6.1-sol', 'gpt-6-sol', 'gpt-6-astra', 'gpt-5.6-luna', 'gpt-5.6-sol',
+    'gpt-5.6-sol-fast', 'gpt-5.6-terra', 'gpt-5.5', 'gpt-5-mini'];
+export const COPILOT_CAPABILITY_EFFORTS = ['none', 'low', 'medium', 'high', 'xhigh', 'max'];
+const record = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+const strings = (v) => Array.isArray(v) && v.every(s => typeof s === 'string');
+const positive = (v) => typeof v === 'number' && Number.isFinite(v) && v > 0;
+export function hasCopilotOfflineModel(providerId, modelId) {
+    const table = COPILOT_OFFLINE_CAPABILITIES;
+    return !!modelId && !!table[providerId]?.models.some(model => model.id === modelId);
+}
+export function mergeCopilotCapabilities(providerId, response, backendVersion, offline = COPILOT_OFFLINE_CAPABILITIES) {
+    const snapshot = offline[providerId];
+    // Match the Provider and complete model ID, not the CLI version. Version is
+    // evidence provenance; an upgrade does not make an existing model unknown.
+    const fallback = snapshot;
+    const live = record(response) && Array.isArray(response.models) ? response.models : undefined;
+    const modelIds = [...new Set([...COPILOT_CAPABILITY_MODELS,
+            ...(live || []).filter((m) => record(m) && typeof m.id === 'string').map((m) => m.id),
+        ])];
+    const models = modelIds.map(id => {
+        const saved = fallback?.models?.find((m) => m.id === id);
+        const savedDefaults = snapshot?.models?.find((m) => m.id === id)?.defaults;
+        const model = { id, parameterPolicy: saved ? 'strict' : 'passthrough', contexts: {}, sources: {} };
+        if (savedDefaults) {
+            model.defaults = { ...savedDefaults };
+            model.sources.defaults = 'offline';
+        }
+        if (saved) {
+            if (typeof saved.available === 'boolean') {
+                model.available = saved.available;
+                model.sources.available = 'offline';
+            }
+            if (strings(saved.efforts)) {
+                model.efforts = [...saved.efforts];
+                model.sources.efforts = 'offline';
+            }
+            if (strings(saved.contexts)) {
+                for (const tier of ['default', 'long_context']) {
+                    model.contexts[tier] = saved.contexts.includes(tier);
+                    model.sources[tier] = 'offline';
+                }
+            }
+            if (saved.combinations) {
+                model.combinations = structuredClone(saved.combinations);
+                model.sources.combinations = 'offline';
+            }
+            if (saved.declaredWindows)
+                model.declaredWindows = { ...saved.declaredWindows };
+        }
+        const declared = live?.find((m) => record(m) && m.id === id);
+        if (declared) {
+            if (typeof declared.policy?.state === 'string') {
+                model.available = declared.policy.state === 'enabled';
+                model.sources.available = 'backend';
+            }
+            const efforts = declared.supportedReasoningEfforts ?? declared.capabilities?.supports?.reasoning_effort;
+            if (strings(efforts)) {
+                model.efforts = [...new Set(efforts)];
+                model.sources.efforts = 'backend';
+            }
+            if (typeof declared.defaultReasoningEffort === 'string') {
+                (model.defaults ||= {}).effort = declared.defaultReasoningEffort;
+                model.sources.defaultEffort = 'backend';
+            }
+            if (typeof declared.defaultContextTier === 'string') {
+                (model.defaults ||= {}).context = declared.defaultContextTier;
+                model.sources.defaultContext = 'backend';
+            }
+            const tiers = declared.supportedContextTiers;
+            for (const tier of ['default', 'long_context']) {
+                if (strings(tiers)) {
+                    model.contexts[tier] = tiers.includes(tier);
+                    model.sources[tier] = 'backend';
+                }
+                const prices = declared.billing?.tokenPrices;
+                const window = tier === 'default' ? prices?.maxPromptTokens : prices?.longContext?.maxPromptTokens;
+                if (positive(window)) {
+                    // Explicit enumerations take priority over billing metadata.
+                    if (!strings(tiers)) {
+                        model.contexts[tier] = true;
+                        model.sources[tier] = 'backend';
+                    }
+                    (model.declaredWindows ||= {})[tier] = window;
+                }
+            }
+            if (Array.isArray(declared.supportedConfigurations)
+                && declared.supportedConfigurations.every((c) => record(c) && typeof c.context === 'string' && typeof c.effort === 'string')) {
+                model.combinations = declared.supportedConfigurations.map((c) => ({ context: c.context, effort: c.effort }));
+                model.sources.combinations = 'backend';
+            }
+        }
+        return model;
+    });
+    const incomplete = models.some(m => m.available !== false
+        && (m.available == null || !m.efforts || m.contexts.default == null || m.contexts.long_context == null
+            || !m.defaults?.context || !m.defaults?.effort));
+    const offlineVersion = fallback?.version
+        ?? (models.some(m => m.sources.defaults === 'offline') ? snapshot?.version : undefined);
+    return { providerId, backendVersion, offlineVersion, models,
+        status: incomplete ? 'partial' : live ? 'ready' : 'offline', fetchedAt: new Date().toISOString() };
+}
+export function copilotCapabilityIssue(catalog, options) {
+    if (!options.model)
+        return undefined; // Older clients may leave the model to the Provider.
+    const model = catalog.models.find(m => m.id === options.model)
+        || mergeCopilotCapabilities(catalog.providerId).models.find(m => m.id === options.model);
+    if (!model || model.parameterPolicy === 'passthrough')
+        return undefined;
+    if (model.available === false)
+        return 'model';
+    const context = options.context || 'default';
+    if (model.contexts[context] === false)
+        return 'context';
+    if (options.effort && model.efforts && !model.efforts.includes(options.effort))
+        return 'effort';
+    if (model.combinations && options.effort && !model.combinations.some(c => c.context === context && c.effort === options.effort))
+        return 'effort';
+    // Unknown development evidence is never classified as unsupported.
+}
+export function assertCopilotCapabilities(catalog, options) {
+    const field = copilotCapabilityIssue(catalog, options);
+    if (field)
+        throw new Error(`Copilot ${field} is unavailable for the selected configuration. Please choose another value in Options.`);
+}
+//# sourceMappingURL=copilot-capabilities.js.map

package/dist/copilot-capabilities.js.map

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

package/dist/copilot-capability-service.d.ts

@@ -0,0 +1,24 @@
+import { CopilotCommandRuntime } from './copilot-command-bridge.js';
+import { type CopilotCapabilityCatalog } from './copilot-capabilities.js';
+export interface CopilotCapabilityScope {
+    providerId: string;
+    workDir: string;
+}
+type Runtime = Pick<CopilotCommandRuntime, 'start' | 'stop' | 'request' | 'isRunning'>;
+interface Dependencies {
+    createRuntime: (scope: CopilotCapabilityScope) => Runtime;
+    existingRuntime: (scope: CopilotCapabilityScope) => Runtime | undefined;
+    scopeKey: (scope: CopilotCapabilityScope) => string;
+    timeoutMs?: number;
+}
+export declare function copilotCapabilityScopeKey(scope: CopilotCapabilityScope): string;
+export declare function createCopilotCapabilityService(deps: Dependencies): {
+    snapshot: (scope: CopilotCapabilityScope) => CopilotCapabilityCatalog;
+    query: (scope: CopilotCapabilityScope, signal?: AbortSignal) => Promise<CopilotCapabilityCatalog>;
+};
+export declare const copilotCapabilityService: {
+    snapshot: (scope: CopilotCapabilityScope) => CopilotCapabilityCatalog;
+    query: (scope: CopilotCapabilityScope, signal?: AbortSignal) => Promise<CopilotCapabilityCatalog>;
+};
+export declare function setCopilotMetadataRuntimeLookup(lookup: Dependencies['existingRuntime']): void;
+export {};

package/dist/copilot-capability-service.js

@@ -0,0 +1,116 @@
+import { CopilotCommandRuntime, copilotMetadataScopeKey } from './copilot-command-bridge.js';
+import { mergeCopilotCapabilities } from './copilot-capabilities.js';
+export function copilotCapabilityScopeKey(scope) {
+    return copilotMetadataScopeKey(scope);
+}
+export function createCopilotCapabilityService(deps) {
+    const cache = new Map();
+    const flights = new Map();
+    const snapshot = (scope) => {
+        const key = deps.scopeKey(scope);
+        return structuredClone(cache.get(key) || { ...mergeCopilotCapabilities(scope.providerId), scope: key });
+    };
+    async function query(scope, signal) {
+        if (!['copilot', 'agency-copilot'].includes(scope.providerId))
+            throw new Error('Unsupported Copilot Provider');
+        if (signal?.aborted)
+            throw new Error('Capability query cancelled');
+        const key = deps.scopeKey(scope);
+        let flight = flights.get(key);
+        if (flight?.controller.signal.aborted) {
+            await flight.promise.catch(() => { });
+            return query(scope, signal); // Wait for owned-process cleanup before retrying.
+        }
+        if (!flight) {
+            const controller = new AbortController();
+            flight = { controller, users: 0, promise: undefined };
+            flights.set(key, flight);
+            const entry = flight;
+            entry.promise = (async () => {
+                let runtime;
+                let owned = false;
+                let timer;
+                let backendVersion;
+                const aborted = new Promise((_, reject) => {
+                    controller.signal.addEventListener('abort', () => reject(new Error('Capability query cancelled')), { once: true });
+                });
+                void aborted.catch(() => { }); // Factory failure may occur before the race is installed.
+                try {
+                    const borrowed = deps.existingRuntime(scope);
+                    runtime = borrowed?.isRunning() ? borrowed : deps.createRuntime(scope);
+                    owned = runtime !== borrowed;
+                    const activeRuntime = runtime;
+                    const result = await Promise.race([
+                        (async () => {
+                            if (owned)
+                                await activeRuntime.start();
+                            if (controller.signal.aborted)
+                                throw new Error('Capability query cancelled');
+                            const status = await activeRuntime.request('status.get').catch(() => undefined);
+                            backendVersion = status?.version;
+                            if (controller.signal.aborted)
+                                throw new Error('Capability query cancelled');
+                            const raw = await activeRuntime.request('models.list');
+                            if (controller.signal.aborted)
+                                throw new Error('Capability query cancelled');
+                            return { ...mergeCopilotCapabilities(scope.providerId, raw, backendVersion), scope: key };
+                        })(),
+                        aborted,
+                        new Promise((_, reject) => { timer = setTimeout(() => reject(new Error('Capability query timed out')), deps.timeoutMs ?? 60_000); }),
+                    ]);
+                    if (deps.scopeKey(scope) === key) {
+                        cache.set(key, result);
+                        if (cache.size > 64)
+                            cache.delete(cache.keys().next().value);
+                    }
+                    return result;
+                }
+                catch (error) {
+                    if (controller.signal.aborted)
+                        throw error;
+                    const previous = cache.get(key);
+                    const fallback = previous && (!backendVersion || previous.backendVersion === backendVersion)
+                        ? previous : { ...mergeCopilotCapabilities(scope.providerId, undefined, backendVersion), scope: key };
+                    return { ...fallback, error: String(error), status: fallback.status === 'partial' ? 'partial' : 'offline' };
+                }
+                finally {
+                    clearTimeout(timer);
+                    controller.abort();
+                    try {
+                        if (owned)
+                            await runtime?.stop();
+                    }
+                    finally {
+                        if (flights.get(key) === entry)
+                            flights.delete(key);
+                    }
+                }
+            })();
+        }
+        const active = flight;
+        active.users++;
+        let onAbort;
+        try {
+            return await Promise.race([active.promise, new Promise((_, reject) => {
+                    onAbort = () => reject(new Error('Capability query cancelled'));
+                    signal?.addEventListener('abort', onAbort, { once: true });
+                })]);
+        }
+        finally {
+            if (onAbort)
+                signal?.removeEventListener('abort', onAbort);
+            active.users--;
+            if (!active.users && flights.get(key) === active)
+                active.controller.abort();
+        }
+    }
+    return { snapshot, query };
+}
+export const copilotCapabilityService = createCopilotCapabilityService({
+    createRuntime: scope => new CopilotCommandRuntime({ ...scope, transport: 'sdk' }),
+    existingRuntime: scope => metadataRuntimeLookup(scope),
+    scopeKey: copilotCapabilityScopeKey,
+});
+let metadataRuntimeLookup = () => undefined;
+export function setCopilotMetadataRuntimeLookup(lookup) { metadataRuntimeLookup = lookup; }
+//# sourceMappingURL=copilot-capability-service.js.map

package/dist/copilot-capability-service.js.map

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

package/dist/copilot-command-bridge.d.ts

@@ -0,0 +1,184 @@
+import { spawn } from 'child_process';
+import * as acp from '@agentclientprotocol/sdk';
+import type { ProviderCommand, ProviderCommandDiscoveryResult, ProviderCommandScope } from './provider-command-types.js';
+import { type CopilotConfiguration } from './copilot-configuration.js';
+export interface CopilotContextSnapshot {
+    model: string;
+    contextTokens: number;
+    contextWindow: number;
+    /** System, conversation and tool tokens are all present in this recount. */
+    contextComplete: boolean;
+    backgroundThreshold?: number;
+    blockingThreshold?: number;
+}
+export declare function stripAgencyPlanInteractionGuidance(text: string): string;
+export declare function copilotBootstrapCommands(): ProviderCommand[];
+export type CopilotCommandInvocationResult = {
+    kind: 'text';
+    text: string;
+    markdown?: boolean;
+    preserveAnsi?: boolean;
+} | {
+    kind: 'agent-prompt';
+    prompt: string;
+    displayPrompt: string;
+    mode?: 'interactive' | 'plan' | 'autopilot';
+    notice?: string;
+} | {
+    kind: 'completed';
+    message?: string;
+} | {
+    kind: 'select-subcommand';
+    command: string;
+    title: string;
+    options: Array<{
+        name: string;
+        description: string;
+    }>;
+};
+interface CopilotCommandRuntimeOptions {
+    strictCapabilities?: boolean;
+    verifyConfiguration?: boolean;
+    initialSessionId?: string;
+    previousConfiguration?: CopilotConfiguration;
+    onConfiguration?: (sessionId: string, configuration: CopilotConfiguration) => void;
+    /** Override only for isolated journal fixtures; never changes Provider storage. */
+    sessionRoot?: string;
+    providerId: string;
+    workDir: string;
+    transport?: CopilotCommandTransport;
+    sessionOptions?: CopilotCommandSessionOptions;
+    onSessionEvent?: (sessionId: string, event: Record<string, unknown>) => void;
+    onUserInputRequest?: (sessionId: string, request: CopilotSdkUserInputRequest) => Promise<CopilotSdkUserInputResponse>;
+    onExitPlanModeRequest?: (sessionId: string, request: CopilotSdkExitPlanModeRequest) => Promise<CopilotSdkExitPlanModeResponse>;
+    onAcpElicitationRequest?: (request: acp.CreateElicitationRequest) => Promise<acp.CreateElicitationResponse>;
+    onRuntimeExit?: (error?: Error) => void;
+}
+export interface CopilotSdkUserInputRequest {
+    question: string;
+    choices?: string[];
+    allowFreeform?: boolean;
+}
+export interface CopilotSdkUserInputResponse {
+    answer: string;
+    wasFreeform: boolean;
+}
+export interface CopilotSdkExitPlanModeRequest {
+    summary: string;
+    planContent?: string;
+    actions: string[];
+    recommendedAction: string;
+}
+export interface CopilotSdkExitPlanModeResponse {
+    approved: boolean;
+    selectedAction?: string;
+    feedback?: string;
+}
+export interface CopilotCommandSessionOptions {
+    model?: string;
+    contextTier?: string;
+    reasoningEffort?: string;
+}
+export type CopilotCommandTransport = 'sdk' | 'acp';
+interface SpawnSpec {
+    command: string;
+    args: string[];
+    options: Parameters<typeof spawn>[2];
+}
+export declare function copilotMetadataScopeKey(scope: {
+    providerId: string;
+    workDir: string;
+}): string;
+export declare function resolveCopilotCommandSpawn(providerId: string, workDir: string, sessionOptions?: CopilotCommandSessionOptions, transport?: CopilotCommandTransport): SpawnSpec;
+export declare class CopilotCommandRuntime {
+    private readonly options;
+    private cancelledCompactions;
+    private compactionAttempts;
+    private liveCompactions;
+    private compactionLifecycle;
+    private readonly goalSessions;
+    private planRevisions;
+    preparePlanReview(sessionId: string): string;
+    planControlPrompt(sessionId: string, revision: string, deferred?: string[]): string;
+    readPlanReadiness(sessionId: string, revision: string): import("./copilot-plan-state.js").CopilotPlanReadiness | null;
+    sealPlanReadiness(sessionId: string, revision: string, content: string): void;
+    private child;
+    private connection;
+    private acpConnection;
+    private readonly acpSessions;
+    private readonly acpCommandWaiters;
+    private readonly acpToolNames;
+    private readonly promptWaiters;
+    private stderr;
+    private releaseSessionLock;
+    private cancelSessionLockWait;
+    private stopPromise;
+    private startPromise;
+    private rejectStartup;
+    private configuration;
+    private configurationSince;
+    private configurationSessionId;
+    private capabilityCheckedAt;
+    private capabilityDirty;
+    metadataScopeKey: string;
+    configurationNeedsRefresh(): Promise<boolean>;
+    getConfiguration(): CopilotConfiguration | null;
+    private beginConfiguration;
+    private publishConfiguration;
+    private observeConfiguration;
+    refreshConfiguration(sessionId: string): Promise<void>;
+    /** Query an already-open Session only; never start a Runtime or send a prompt. */
+    readContextSnapshot(sessionId: string): Promise<CopilotContextSnapshot | null>;
+    private stopping;
+    constructor(options: CopilotCommandRuntimeOptions);
+    start(): Promise<void>;
+    private startRuntime;
+    private initializeConnection;
+    request<T>(method: string, params?: Record<string, unknown>, timeoutMs?: number | null): Promise<T>;
+    openSession(sessionId?: string, options?: CopilotCommandSessionOptions): Promise<string>;
+    private acquireSessionLock;
+    listSessionCommands(sessionId: string): Promise<ProviderCommand[]>;
+    invokeCommand(sessionId: string, name: string, input: string): Promise<CopilotCommandInvocationResult>;
+    /** Retry only a settled native failure, never a possibly still-running RPC. */
+    private compactWithRetries;
+    private invokeCommandOnce;
+    setMode(sessionId: string, mode: 'interactive' | 'plan' | 'autopilot'): Promise<void>;
+    getMode(sessionId: string): Promise<'interactive' | 'plan' | 'autopilot'>;
+    enableAllowAll(sessionId: string): Promise<void>;
+    send(sessionId: string, prompt: string, displayPrompt: string, attachments?: Array<{
+        type: 'file';
+        path: string;
+        displayName?: string;
+    }>): Promise<void>;
+    readPlanContent(sessionId: string, sessionRoot?: string): string | null;
+    abort(sessionId: string): Promise<void>;
+    respondToUserInput(sessionId: string, requestId: string, response: CopilotSdkUserInputResponse): Promise<boolean>;
+    abortManualCompaction(sessionId: string): Promise<void>;
+    destroySession(sessionId: string): Promise<void>;
+    deleteSession(sessionId: string): Promise<void>;
+    stop(): Promise<void>;
+    private stopRuntime;
+    isRunning(): boolean;
+    get transport(): CopilotCommandTransport;
+    private usesAgencyAcp;
+    private handleDirectSessionEvent;
+    private observeGoalLifecycle;
+    private observeCompactionLifecycle;
+    private waitForPrompt;
+    private pausePromptWaiter;
+    private resumePromptWaiter;
+    private resumeAllPromptWaiters;
+    private clearPromptWaiter;
+    private failPromptWaiters;
+    private openAcpSession;
+    private applyAcpSessionOptions;
+    private findAcpSelectConfig;
+    private requestAcp;
+    private notifyAcp;
+    private handleAcpSessionUpdate;
+    private emitAcpEvent;
+}
+export declare function normalizeAcpCommands(values: acp.AvailableCommand[]): ProviderCommand[];
+export declare function normalizeCopilotCommands(input: unknown): ProviderCommand[];
+export declare function discoverCopilotCommands(_scope: ProviderCommandScope): Promise<ProviderCommandDiscoveryResult>;
+export {};