@animus-labs/cortex 0.2.0

package/dist/noop-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-logger.js","sourceRoot":"","sources":["../src/noop-logger.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,KAAK,KAAI,CAAC;IACV,IAAI,KAAI,CAAC;IACT,IAAI,KAAI,CAAC;IACT,KAAK,KAAI,CAAC;CACX,CAAC"}

package/dist/prompt-diagnostics.d.ts

@@ -0,0 +1,47 @@
+import type { CortexEvent } from './event-bridge.js';
+import type { CortexLogger, PromptWatchdogDiagnosticsConfig } from './types.js';
+interface PromptStartMeta {
+    inputLength: number;
+    messageCount: number;
+    provider: string;
+    modelId: string;
+}
+interface PromptFinishMeta {
+    status: 'resolved' | 'rejected' | 'cancelled';
+    durationMs: number;
+    turns: number;
+    totalCost: number;
+    currentContextTokens: number;
+    pendingBackgroundResults: number;
+}
+interface PromptDiagnosticsCallbacks {
+    isPrompting: () => boolean;
+    isAbortRequested: () => boolean;
+}
+export declare class PromptWatchdogDiagnostics {
+    private readonly logger;
+    private readonly enabled;
+    private readonly heartbeatIntervalMs;
+    private readonly abortWaitWarningMs;
+    private readonly callbacks;
+    private readonly sessionId;
+    private sequence;
+    private activePrompt;
+    private heartbeatTimer;
+    private abortWaitTimer;
+    private abortWaitStartedAt;
+    constructor(config: PromptWatchdogDiagnosticsConfig | undefined, logger: CortexLogger | undefined, callbacks: PromptDiagnosticsCallbacks);
+    startPrompt(meta: PromptStartMeta): void;
+    recordEvent(event: CortexEvent): void;
+    recordAbortRequested(): void;
+    startAbortWait(): void;
+    finishAbortWait(): void;
+    finishPrompt(meta: PromptFinishMeta): void;
+    stop(): void;
+    private emitHeartbeat;
+    private currentPromptId;
+    private stopHeartbeat;
+    private stopAbortWait;
+}
+export {};
+//# sourceMappingURL=prompt-diagnostics.d.ts.map

package/dist/prompt-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-diagnostics.d.ts","sourceRoot":"","sources":["../src/prompt-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EACV,YAAY,EACZ,+BAA+B,EAChC,MAAM,YAAY,CAAC;AAoBpB,UAAU,eAAe;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,UAAU,0BAA0B;IAClC,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,gBAAgB,EAAE,MAAM,OAAO,CAAC;CACjC;AAQD,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,kBAAkB,CAAuB;gBAG/C,MAAM,EAAE,+BAA+B,GAAG,SAAS,EACnD,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,SAAS,EAAE,0BAA0B;IAUvC,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAqCxC,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAkErC,oBAAoB,IAAI,IAAI;IAW5B,cAAc,IAAI,IAAI;IAsBtB,eAAe,IAAI,IAAI;IAYvB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAwB1C,IAAI,IAAI,IAAI;IAMZ,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,aAAa;CAOtB"}

package/dist/prompt-diagnostics.js

@@ -0,0 +1,230 @@
+import { NOOP_LOGGER } from './noop-logger.js';
+const DEFAULT_HEARTBEAT_INTERVAL_MS = 1000;
+const DEFAULT_ABORT_WAIT_WARNING_MS = 2000;
+function maybeUnref(timer) {
+    if ('unref' in timer && typeof timer.unref === 'function') {
+        timer.unref();
+    }
+}
+export class PromptWatchdogDiagnostics {
+    logger;
+    enabled;
+    heartbeatIntervalMs;
+    abortWaitWarningMs;
+    callbacks;
+    sessionId;
+    sequence = 0;
+    activePrompt = null;
+    heartbeatTimer = null;
+    abortWaitTimer = null;
+    abortWaitStartedAt = null;
+    constructor(config, logger, callbacks) {
+        this.logger = logger ?? NOOP_LOGGER;
+        this.enabled = config?.enabled ?? false;
+        this.heartbeatIntervalMs = Math.max(250, config?.heartbeatIntervalMs ?? DEFAULT_HEARTBEAT_INTERVAL_MS);
+        this.abortWaitWarningMs = Math.max(250, config?.abortWaitWarningMs ?? DEFAULT_ABORT_WAIT_WARNING_MS);
+        this.callbacks = callbacks;
+        this.sessionId = Math.random().toString(36).slice(2, 8);
+    }
+    startPrompt(meta) {
+        if (!this.enabled)
+            return;
+        this.stopHeartbeat();
+        this.sequence += 1;
+        const now = Date.now();
+        this.activePrompt = {
+            startedAt: now,
+            inputLength: meta.inputLength,
+            messageCount: meta.messageCount,
+            provider: meta.provider,
+            modelId: meta.modelId,
+            lastEventAt: now,
+            lastEventType: 'prompt_started',
+            eventCount: 0,
+            toolCallCount: 0,
+            responseChunkCount: 0,
+            childEventCount: 0,
+            sawFirstResponseChunk: false,
+        };
+        this.logger.info('[Diagnostics] prompt_started', {
+            diagnosticsSessionId: this.sessionId,
+            promptId: this.currentPromptId(),
+            inputLength: meta.inputLength,
+            messageCount: meta.messageCount,
+            provider: meta.provider,
+            model: meta.modelId,
+        });
+        this.heartbeatTimer = setInterval(() => {
+            this.emitHeartbeat();
+        }, this.heartbeatIntervalMs);
+        maybeUnref(this.heartbeatTimer);
+    }
+    recordEvent(event) {
+        if (!this.enabled || !this.activePrompt)
+            return;
+        const now = Date.now();
+        this.activePrompt.lastEventAt = now;
+        this.activePrompt.lastEventType = event.childTaskId ? `${event.type}:child` : event.type;
+        this.activePrompt.eventCount += 1;
+        if (event.childTaskId) {
+            this.activePrompt.childEventCount += 1;
+        }
+        if (event.type === 'tool_call_start') {
+            this.activePrompt.toolCallCount += 1;
+            this.logger.debug('[Diagnostics] tool_call_start', {
+                diagnosticsSessionId: this.sessionId,
+                promptId: this.currentPromptId(),
+                toolName: event.payload?.toolName,
+                childTaskId: event.childTaskId,
+            });
+            return;
+        }
+        if (event.type === 'tool_call_end') {
+            const endPayload = event.payload;
+            this.logger.debug('[Diagnostics] tool_call_end', {
+                diagnosticsSessionId: this.sessionId,
+                promptId: this.currentPromptId(),
+                toolName: endPayload?.toolName,
+                childTaskId: event.childTaskId,
+                durationMs: endPayload?.durationMs,
+                isError: endPayload?.isError,
+            });
+            return;
+        }
+        if (event.type === 'response_start') {
+            this.logger.debug('[Diagnostics] response_started', {
+                diagnosticsSessionId: this.sessionId,
+                promptId: this.currentPromptId(),
+                childTaskId: event.childTaskId,
+            });
+            return;
+        }
+        if (event.type === 'response_chunk') {
+            this.activePrompt.responseChunkCount += 1;
+            if (!this.activePrompt.sawFirstResponseChunk) {
+                this.activePrompt.sawFirstResponseChunk = true;
+                this.logger.debug('[Diagnostics] first_response_chunk', {
+                    diagnosticsSessionId: this.sessionId,
+                    promptId: this.currentPromptId(),
+                    childTaskId: event.childTaskId,
+                });
+            }
+            return;
+        }
+        if (event.type === 'response_end' || event.type === 'turn_start' || event.type === 'turn_end' || event.type === 'loop_end') {
+            this.logger.debug(`[Diagnostics] ${event.type}`, {
+                diagnosticsSessionId: this.sessionId,
+                promptId: this.currentPromptId(),
+                childTaskId: event.childTaskId,
+            });
+        }
+    }
+    recordAbortRequested() {
+        if (!this.enabled)
+            return;
+        this.logger.info('[Diagnostics] abort_requested', {
+            diagnosticsSessionId: this.sessionId,
+            promptId: this.currentPromptId(),
+            isPrompting: this.callbacks.isPrompting(),
+            abortRequested: this.callbacks.isAbortRequested(),
+        });
+    }
+    startAbortWait() {
+        if (!this.enabled)
+            return;
+        this.stopAbortWait();
+        this.abortWaitStartedAt = Date.now();
+        this.logger.debug('[Diagnostics] abort_wait_started', {
+            diagnosticsSessionId: this.sessionId,
+            promptId: this.currentPromptId(),
+        });
+        this.abortWaitTimer = setInterval(() => {
+            if (this.abortWaitStartedAt === null)
+                return;
+            this.logger.warn('[Diagnostics] abort_wait_still_pending', {
+                diagnosticsSessionId: this.sessionId,
+                promptId: this.currentPromptId(),
+                elapsedMs: Date.now() - this.abortWaitStartedAt,
+                isPrompting: this.callbacks.isPrompting(),
+                abortRequested: this.callbacks.isAbortRequested(),
+            });
+        }, this.abortWaitWarningMs);
+        maybeUnref(this.abortWaitTimer);
+    }
+    finishAbortWait() {
+        if (!this.enabled)
+            return;
+        const elapsedMs = this.abortWaitStartedAt === null ? 0 : Date.now() - this.abortWaitStartedAt;
+        this.stopAbortWait();
+        this.logger.info('[Diagnostics] abort_wait_finished', {
+            diagnosticsSessionId: this.sessionId,
+            promptId: this.currentPromptId(),
+            elapsedMs,
+        });
+    }
+    finishPrompt(meta) {
+        if (!this.enabled || !this.activePrompt)
+            return;
+        const snapshot = this.activePrompt;
+        this.stopHeartbeat();
+        this.logger.info('[Diagnostics] prompt_finished', {
+            diagnosticsSessionId: this.sessionId,
+            promptId: this.currentPromptId(),
+            status: meta.status,
+            durationMs: meta.durationMs,
+            turns: meta.turns,
+            totalCost: meta.totalCost,
+            currentContextTokens: meta.currentContextTokens,
+            pendingBackgroundResults: meta.pendingBackgroundResults,
+            lastEventType: snapshot.lastEventType,
+            lastEventAgoMs: Date.now() - snapshot.lastEventAt,
+            eventCount: snapshot.eventCount,
+            toolCallCount: snapshot.toolCallCount,
+            responseChunkCount: snapshot.responseChunkCount,
+            childEventCount: snapshot.childEventCount,
+        });
+        this.activePrompt = null;
+    }
+    stop() {
+        this.stopHeartbeat();
+        this.stopAbortWait();
+        this.activePrompt = null;
+    }
+    emitHeartbeat() {
+        if (!this.activePrompt)
+            return;
+        const now = Date.now();
+        this.logger.debug('[Diagnostics] prompt_heartbeat', {
+            diagnosticsSessionId: this.sessionId,
+            promptId: this.currentPromptId(),
+            elapsedMs: now - this.activePrompt.startedAt,
+            sinceLastEventMs: now - this.activePrompt.lastEventAt,
+            lastEventType: this.activePrompt.lastEventType,
+            isPrompting: this.callbacks.isPrompting(),
+            abortRequested: this.callbacks.isAbortRequested(),
+            eventCount: this.activePrompt.eventCount,
+            toolCallCount: this.activePrompt.toolCallCount,
+            responseChunkCount: this.activePrompt.responseChunkCount,
+            childEventCount: this.activePrompt.childEventCount,
+        });
+    }
+    currentPromptId() {
+        if (!this.activePrompt)
+            return null;
+        return `prompt-${this.sequence}`;
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+    stopAbortWait() {
+        if (this.abortWaitTimer) {
+            clearInterval(this.abortWaitTimer);
+            this.abortWaitTimer = null;
+        }
+        this.abortWaitStartedAt = null;
+    }
+}
+//# sourceMappingURL=prompt-diagnostics.js.map

package/dist/prompt-diagnostics.js.map

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

package/dist/provider-manager.d.ts

@@ -0,0 +1,224 @@
+/**
+ * ProviderManager: standalone class wrapping pi-ai for provider discovery,
+ * OAuth login/refresh, API key validation, model resolution, and custom
+ * endpoint creation.
+ *
+ * ProviderManager and CortexAgent are fully independent. Neither knows
+ * about the other. The consumer creates both, uses ProviderManager for
+ * auth/discovery, and provides a getApiKey callback to CortexAgent.
+ *
+ * Pi-ai is loaded dynamically so consumers never import it directly.
+ * If the dependency is missing or unavailable, methods that require it
+ * throw clear errors.
+ *
+ * Reference: provider-manager.md
+ */
+import type { ProviderInfo, ModelInfo } from './provider-registry.js';
+import type { CortexModel } from './model-wrapper.js';
+/** Callbacks provided by the consumer during an OAuth flow. */
+export interface OAuthCallbacks {
+    /**
+     * Called when the user needs to visit a URL to authorize.
+     * The consumer should open the URL in a browser or display it.
+     */
+    onAuth: (info: {
+        url: string;
+        instructions?: string;
+    }) => void;
+    /**
+     * Called when the OAuth flow needs user input (e.g., a prompt).
+     * The consumer should display the prompt and return the user's response.
+     */
+    onPrompt: (prompt: {
+        message: string;
+        placeholder?: string;
+        allowEmpty?: boolean;
+    }) => Promise<string>;
+    /**
+     * Called with progress messages during the flow.
+     */
+    onProgress?: (message: string) => void;
+    /**
+     * Called when a callback-server OAuth flow needs the user to paste a
+     * manual authorization code.
+     */
+    onManualCodeInput?: () => Promise<string>;
+    /**
+     * Called when the OAuth flow needs the user to choose from provider-specific
+     * options, such as a Copilot organization or endpoint.
+     */
+    onSelect?: (prompt: {
+        message: string;
+        options: Array<{
+            id: string;
+            label: string;
+        }>;
+    }) => Promise<string | undefined>;
+}
+/** Display-safe metadata extracted at login time. */
+export interface OAuthMeta {
+    /** Provider identifier. */
+    provider: string;
+    /** Display name, email, or account identifier (if available). */
+    displayName?: string | undefined;
+    /** When the access token expires (Unix timestamp ms). Undefined if non-expiring. */
+    expiresAt?: number | undefined;
+    /** Whether the credential supports automatic refresh. */
+    refreshable: boolean;
+}
+/** Result of a successful OAuth login. */
+export interface OAuthResult {
+    /**
+     * Serialized credential payload. The consumer stores this (encrypted)
+     * and passes it back to resolveOAuthApiKey() for refresh.
+     * Treat as an opaque blob: encrypt, store, decrypt, pass back. Never parse.
+     */
+    credentials: string;
+    /** Display-safe metadata extracted at login time. */
+    meta: OAuthMeta;
+}
+/** Result of resolving/refreshing an OAuth API key. */
+export interface OAuthRefreshResult {
+    /** The API key to use for LLM calls. */
+    apiKey: string;
+    /**
+     * Credential payload (may be updated if refresh occurred).
+     * Same format as OAuthResult.credentials.
+     */
+    credentials: string;
+    /** Updated metadata. */
+    meta: OAuthMeta;
+    /** Whether the credentials were actually refreshed (true) or reused as-is (false). */
+    changed: boolean;
+}
+/** Configuration for creating a custom model endpoint. */
+export interface CustomModelConfig {
+    /** Base URL of the OpenAI-compatible API (e.g., 'http://localhost:11434/v1'). */
+    baseUrl: string;
+    /** Model identifier to send in API requests. */
+    modelId: string;
+    /** Context window size (default: 128,000). */
+    contextWindow?: number | undefined;
+    /** Optional API key (some local servers don't require one). */
+    apiKey?: string | undefined;
+    /** Compatibility settings for non-standard servers. */
+    compat?: {
+        /** Whether the server supports the 'developer' role (default: true). */
+        supportsDeveloperRole?: boolean | undefined;
+        /** Whether the server supports reasoning_effort (default: true). */
+        supportsReasoningEffort?: boolean | undefined;
+    } | undefined;
+}
+export type ApiKeyValidationStatus = 'valid' | 'invalid_credentials' | 'transient_error' | 'resolution_error';
+export interface ApiKeyValidationResult {
+    provider: string;
+    modelId: string | null;
+    valid: boolean;
+    retryable: boolean;
+    status: ApiKeyValidationStatus;
+    message?: string | undefined;
+}
+/**
+ * Interface for provider management operations.
+ * Consumers can mock this for testing.
+ */
+export interface IProviderManager {
+    listProviders(): ProviderInfo[];
+    listOAuthProviders(): string[];
+    listModels(provider: string): Promise<ModelInfo[]>;
+    initiateOAuth(provider: string, callbacks: OAuthCallbacks): Promise<OAuthResult>;
+    cancelOAuth(): void;
+    resolveOAuthApiKey(provider: string, credentials: string): Promise<OAuthRefreshResult>;
+    validateApiKey(provider: string, apiKey: string): Promise<ApiKeyValidationResult>;
+    checkEnvApiKey(provider: string): string | null;
+    resolveModel(provider: string, modelId: string): Promise<CortexModel>;
+    createCustomModel(config: CustomModelConfig): Promise<CortexModel>;
+}
+export declare class ProviderManager implements IProviderManager {
+    /** Active OAuth AbortController, if any. */
+    private activeOAuthAbort;
+    /**
+     * List all known providers with their metadata.
+     */
+    listProviders(): ProviderInfo[];
+    /**
+     * List provider IDs that support OAuth authentication.
+     */
+    listOAuthProviders(): string[];
+    /**
+     * List models available from a provider.
+     * Delegates to pi-ai's getModels().
+     *
+     * @param provider - Provider identifier
+     * @returns Array of ModelInfo
+     * @throws Error if pi-ai is not installed
+     */
+    listModels(provider: string): Promise<ModelInfo[]>;
+    /**
+     * Initiate an OAuth login flow for a provider.
+     *
+     * @param provider - OAuth provider identifier
+     * @param callbacks - UI callbacks for auth URL, prompts, and progress
+     * @returns The OAuth credentials and display metadata
+     * @throws Error if the provider does not support OAuth or pi-ai is not installed
+     */
+    initiateOAuth(provider: string, callbacks: OAuthCallbacks): Promise<OAuthResult>;
+    /**
+     * Cancel any in-progress OAuth flow.
+     */
+    cancelOAuth(): void;
+    /**
+     * Resolve an API key from stored OAuth credentials, refreshing if needed.
+     *
+     * @param provider - The OAuth provider
+     * @param credentials - Serialized credential blob from initiateOAuth()
+     * @returns The API key and potentially updated credentials
+     * @throws Error if pi-ai is not installed or resolution fails
+     */
+    resolveOAuthApiKey(provider: string, credentials: string): Promise<OAuthRefreshResult>;
+    /**
+     * Validate an API key by making a minimal LLM call (maxTokens: 1).
+     *
+     * @param provider - The provider to validate against
+     * @param apiKey - The API key to validate
+     * @returns True if the key is valid, false otherwise
+     * @throws Error if pi-ai is not installed
+     */
+    validateApiKey(provider: string, apiKey: string): Promise<ApiKeyValidationResult>;
+    /**
+     * Check whether a provider's API key is available in environment variables.
+     *
+     * @param provider - The provider to check
+     * @returns The API key if found, null otherwise
+     */
+    checkEnvApiKey(provider: string): string | null;
+    /**
+     * Resolve a provider + model ID into a CortexModel.
+     *
+     * @param provider - The provider identifier
+     * @param modelId - The model identifier
+     * @returns A CortexModel handle
+     * @throws Error if pi-ai is not installed or the model is not found
+     */
+    resolveModel(provider: string, modelId: string): Promise<CortexModel>;
+    /**
+     * Create a custom model for an OpenAI-compatible endpoint.
+     *
+     * @param config - Custom model configuration
+     * @returns A CortexModel handle
+     * @throws Error if pi-ai is not installed
+     */
+    createCustomModel(config: CustomModelConfig): Promise<CortexModel>;
+    /**
+     * Get the cheapest known model ID for a provider.
+     * Uses the UTILITY_MODEL_DEFAULTS as a proxy for "smallest model."
+     */
+    private getSmallestModelId;
+    /**
+     * Attempt to validate an API key by making a minimal LLM call.
+     */
+    private tryValidation;
+    private classifyValidationError;
+    private extractSilentValidationError;
+}
+//# sourceMappingURL=provider-manager.d.ts.map

package/dist/provider-manager.d.ts.map

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