@agentex/agent 0.0.1 → 0.0.3

package/dist/types.d.ts

@@ -1,9 +1,34 @@
+/** Static declaration of what a provider supports. */
+export interface ProviderCapabilities {
+    sessions: boolean;
+    modelDiscovery: boolean;
+    quotaProbing: boolean;
+    mcp: boolean;
+    skills: boolean;
+    instructions: boolean;
+    workspace: boolean;
+}
 export interface ProviderModule {
     type: string;
+    capabilities: ProviderCapabilities;
     execute(ctx: ExecutionContext): Promise<ExecutionResult>;
+    createSession?(ctx: SessionContext): Promise<AgentSession>;
     testEnvironment(ctx: EnvironmentTestContext): Promise<EnvironmentTestResult>;
+    /**
+     * Enumerate every auth path this provider supports and report which are
+     * currently present. Cheap: inspects env vars and files only — does not
+     * spawn the binary. Callers should use the `hasSubscription` / `hasApiKey`
+     * / `hasBedrock` helpers rather than interpreting the report directly when
+     * they only want a yes/no for a specific billing mode.
+     */
+    resolveAuth(ctx?: AuthResolveContext): Promise<AuthReport>;
     sessionCodec?: SessionCodec;
-    listModels?(): Promise<ProviderModel[]>;
+    /** List available models. Pass cacheTtlMs to cache results (0 = no cache, default). */
+    listModels?(options?: {
+        cacheTtlMs?: number;
+    }): Promise<ProviderModel[]>;
+    /** Check current quota/rate limit status. Not all providers support this. */
+    checkQuota?(ctx: QuotaContext): Promise<QuotaStatus>;
 }
 export interface ExecutionContext {
     prompt: string;
@@ -15,6 +40,12 @@ export interface ExecutionContext {
     config?: ProviderConfig;
     onOutput?: (stream: "stdout" | "stderr", chunk: string) => void | Promise<void>;
     onEvent?: (event: StreamEvent) => void | Promise<void>;
+    onStart?: (pid: number) => void;
+    /** AbortSignal to cancel execution. When aborted, the process receives SIGTERM
+     *  followed by SIGKILL after the grace period. */
+    signal?: AbortSignal;
+    /** Called at key execution lifecycle phases (preparing, spawning, running, etc.). */
+    onLifecycle?: (event: LifecycleEvent) => void;
 }
 export interface ProviderConfig {
     command?: string;
@@ -28,30 +59,71 @@ export interface ProviderConfig {
     instructionsFile?: string;
     mcpServers?: McpServerConfig[];
     extraArgs?: string[];
+    search?: boolean;
+    sandbox?: boolean;
+    thinking?: string;
+    mode?: string;
+    /** Run the agent in an isolated workspace. The library creates a worktree
+     *  before execution and uses it as the working directory. */
+    workspace?: {
+        strategy: "worktree";
+        baseBranch?: string;
+        branchName?: string;
+    };
+}
+export interface QuotaStatus {
+    /** Whether the provider currently has available capacity */
+    available: boolean;
+    /** Remaining tokens in current window, if known */
+    remainingTokens?: number;
+    /** When the current rate limit window resets, if known */
+    resetAt?: string;
+    /** Billing type detected */
+    billingType: "api" | "subscription" | "metered_api";
+    /** Additional provider-specific info */
+    detail?: Record<string, unknown>;
+}
+export interface QuotaContext {
+    config?: ProviderConfig;
+    env?: Record<string, string>;
 }
+/** Final outcome of a single-turn execution. */
+export type ExecutionStatus = "completed" | "failed" | "aborted" | "timeout" | "blocked";
+/** Live state of an interactive session. */
+export type SessionState = "idle" | "thinking" | "tool_executing" | "waiting_for_approval" | "waiting_for_input" | "closed";
+/** Token usage for a single model within a run. */
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens?: number;
+    cacheCreationInputTokens?: number;
+}
+/**
+ * Get aggregate usage across all models. Convenience for when you don't
+ * care about per-model breakdown.
+ */
+export declare function aggregateUsage(usage: Record<string, TokenUsage> | undefined): TokenUsage | null;
 export interface ExecutionResult {
     runId: string;
     exitCode: number | null;
     signal: string | null;
-    timedOut: boolean;
+    status: ExecutionStatus;
     startedAt: string;
     completedAt: string;
     durationMs: number;
     errorMessage: string | null;
     errorCode: string | null;
-    usage?: {
-        inputTokens: number;
-        outputTokens: number;
-        cachedInputTokens?: number;
-    };
+    usage?: Record<string, TokenUsage>;
     costUsd: number | null;
     model: string | null;
     summary: string | null;
     sessionParams: Record<string, unknown> | null;
     sessionDisplayId: string | null;
     clearSession: boolean;
-    billingType: "api" | "subscription" | null;
+    billingType: "api" | "subscription" | "metered_api" | null;
     raw?: Record<string, unknown> | null;
+    /** If the run used a workspace, this contains the workspace handle for diffing/cleanup */
+    workspace?: import("./utils/workspace.js").PreparedWorkspace;
 }
 export type StreamEvent = {
     type: "system";
@@ -69,6 +141,7 @@ export type StreamEvent = {
     timestamp: string;
 } | {
     type: "tool_call";
+    callId?: string;
     name: string;
     input: unknown;
     timestamp: string;
@@ -85,6 +158,25 @@ export type StreamEvent = {
     isError: boolean;
     timestamp: string;
 };
+export type LifecycleEvent = {
+    phase: "preparing";
+    step: "workspace" | "skills" | "auth" | "instructions" | "binary";
+} | {
+    phase: "spawning";
+} | {
+    phase: "running";
+    pid: number;
+} | {
+    phase: "waiting_for_input";
+    request: UserInputRequest;
+} | {
+    phase: "completed";
+} | {
+    phase: "cancelled";
+} | {
+    phase: "error";
+    message: string;
+};
 export interface SessionCodec {
     deserialize(raw: unknown): Record<string, unknown> | null;
     serialize(params: Record<string, unknown> | null): Record<string, unknown> | null;
@@ -97,6 +189,8 @@ export interface EnvironmentTestContext {
 export interface EnvironmentTestResult {
     providerType: string;
     status: "pass" | "warn" | "fail";
+    /** Structured auth report: every supported auth path with presence state. */
+    auth: AuthReport;
     checks: EnvironmentCheck[];
     testedAt: string;
 }
@@ -107,6 +201,55 @@ export interface EnvironmentCheck {
     detail?: string;
     hint?: string;
 }
+/** How a provider is authenticated. Determines billing behavior at runtime. */
+export type AuthMethod = "api_key" | "bedrock" | "subscription";
+/** Where an auth credential lives. */
+export type AuthSource = 
+/** Single environment variable, e.g. OPENAI_API_KEY. */
+{
+    kind: "env";
+    var: string;
+}
+/** Multiple env vars that together form one credential, e.g. AWS creds. */
+ | {
+    kind: "env_combo";
+    vars: string[];
+}
+/** A file on disk, e.g. ~/.codex/auth.json. Path is already resolved. */
+ | {
+    kind: "file";
+    path: string;
+}
+/** macOS keychain entry. Cannot be read silently — present will be "unknown". */
+ | {
+    kind: "keychain";
+    service: string;
+    account?: string;
+};
+/**
+ * One auth path this provider supports, with its current presence state.
+ *
+ * `present` values:
+ * - `true`: the source exists / env var is set and non-empty.
+ * - `false`: the source does not exist / env var is unset or empty.
+ * - `"unknown"`: we can't check without side-effects (e.g. macOS keychain
+ *   would prompt the user). Safe-by-default: sugar helpers treat this as
+ *   not-present.
+ */
+export interface AuthOption {
+    method: AuthMethod;
+    source: AuthSource;
+    present: boolean | "unknown";
+}
+/** Full auth report for a provider. */
+export interface AuthReport {
+    providerType: string;
+    options: AuthOption[];
+}
+/** Optional context for auth resolution (override env vars for testing). */
+export interface AuthResolveContext {
+    env?: Record<string, string>;
+}
 export interface ProviderModel {
     id: string;
     name: string;
@@ -118,4 +261,178 @@ export interface McpServerConfig {
     args?: string[];
     env?: Record<string, string>;
 }
+/** Context for creating a persistent multi-turn session. */
+export interface SessionContext {
+    cwd?: string;
+    env?: Record<string, string>;
+    config?: ProviderConfig;
+    /** Resume an existing session. If omitted, starts fresh. */
+    sessionParams?: Record<string, unknown> | null;
+    /** AbortSignal to cancel the session. When aborted, the session is closed
+     *  and the underlying process is terminated. */
+    signal?: AbortSignal;
+    /** Called for every stream event across all turns. */
+    onEvent?: (event: StreamEvent) => void | Promise<void>;
+    /** Called for raw stdout/stderr output across all turns. */
+    onOutput?: (stream: "stdout" | "stderr", chunk: string) => void | Promise<void>;
+    /** Called at key execution lifecycle phases (preparing, spawning, running, etc.). */
+    onLifecycle?: (event: LifecycleEvent) => void;
+    /**
+     * Called when the agent needs confirmation or user input before proceeding
+     * with a tool call. This covers both regular tool permissions (e.g. Bash,
+     * Write) and interactive tools like AskUserQuestion.
+     *
+     * Use `parseAskUserQuestion(req)` to detect structured question prompts
+     * and return answers via `updatedInput`.
+     *
+     * Return `{ allow: true }` to proceed, `{ allow: false }` to deny.
+     * If not provided, all tool calls are auto-allowed.
+     */
+    onUserInputRequest?: (req: UserInputRequest) => Promise<UserInputResponse>;
+    /**
+     * Called when an MCP server requests user input (form fields, multiple
+     * choice, URL, etc.). Return `{ action: "accept", content: {...} }` to
+     * provide the input, `{ action: "decline" }` to refuse, or
+     * `{ action: "cancel" }` to abort the current turn.
+     *
+     * If not provided, all elicitations are declined.
+     */
+    onElicitation?: (req: ElicitationRequest) => Promise<ElicitationResponse>;
+    /**
+     * Called when the CLI needs the host to run a hook callback.
+     * If not provided, hook callbacks return an empty result.
+     */
+    onHookCallback?: (req: HookCallbackRequest) => Promise<HookCallbackResponse>;
+}
+/** A persistent session handle for multi-turn conversations. */
+export interface AgentSession {
+    readonly sessionId: string | null;
+    readonly state: SessionState;
+    /** Send a user message and wait for the agent's turn to complete. */
+    send(message: string): Promise<TurnResult>;
+    /** Gracefully interrupt the current turn. */
+    interrupt(): Promise<void>;
+    /** Terminate the session and kill the underlying process. */
+    close(): Promise<void>;
+}
+/** Result of a single turn within a session. */
+export interface TurnResult {
+    summary: string | null;
+    usage?: Record<string, TokenUsage>;
+    costUsd: number | null;
+    status: "completed" | "failed" | "max_turns" | "max_budget" | "aborted";
+    errorCode: string | null;
+    errorMessage: string | null;
+}
+/**
+ * Describes a tool the agent wants to use and needs confirmation or user
+ * input before proceeding. This is the unified callback for both regular
+ * tool permissions (Bash, Write, etc.) and interactive tools like
+ * AskUserQuestion.
+ *
+ * For AskUserQuestion, use `parseAskUserQuestion(req)` to extract the
+ * structured questions and return answers via `updatedInput`.
+ */
+export interface UserInputRequest {
+    toolName: string;
+    input: Record<string, unknown>;
+    toolUseId: string;
+    /** Human-readable title for the tool action. */
+    title?: string;
+    /** Display name of the tool. */
+    displayName?: string;
+    /** Why the agent decided to use this tool. */
+    description?: string;
+    /** ID of the sub-agent making the request, if any. */
+    agentId?: string;
+}
+/** Host response to a tool request. */
+export interface UserInputResponse {
+    allow: boolean;
+    message?: string;
+    /** Optionally modify the tool's input before execution (e.g. answers for AskUserQuestion). */
+    updatedInput?: Record<string, unknown>;
+}
+/**
+ * Sent when a server (typically an MCP tool-server running inside the Claude
+ * process) needs user input. The request can represent anything from a simple
+ * yes/no confirmation to a rich multi-field form combining dropdowns,
+ * checkboxes, text fields, and number inputs.
+ *
+ * The `requestedSchema` is a standard JSON Schema (type: "object") whose
+ * `properties` define the form fields. Supported property types:
+ *
+ * | Schema pattern | Renders as |
+ * |---|---|
+ * | `{ "type": "string", "oneOf": [{ "const": "a", "title": "A" }, ...] }` | Single-select dropdown / radio |
+ * | `{ "type": "string", "enum": ["x", "y"] }` | Single-select (legacy) |
+ * | `{ "type": "array", "items": { "anyOf": [{ "const": "a" }, ...] } }` | Multi-select checkboxes |
+ * | `{ "type": "string" }` | Freeform text input |
+ * | `{ "type": "string", "format": "email" \| "uri" \| "date" }` | Validated text input |
+ * | `{ "type": "integer", "minimum": 1, "maximum": 10 }` | Number input |
+ * | `{ "type": "boolean" }` | Toggle / checkbox |
+ *
+ * A single form can mix all of these — e.g., a dropdown for language, checkboxes
+ * for features, and a freeform "notes" field.
+ *
+ * **Example — multiple choice + freeform:**
+ * ```json
+ * { "type": "object", "properties": {
+ *     "framework": { "type": "string", "oneOf": [
+ *       { "const": "express", "title": "Express" },
+ *       { "const": "fastify", "title": "Fastify" },
+ *       { "const": "hono", "title": "Hono" }
+ *     ]},
+ *     "features": { "type": "array", "items": {
+ *       "anyOf": [
+ *         { "const": "auth", "title": "Authentication" },
+ *         { "const": "db", "title": "Database" },
+ *         { "const": "ws", "title": "WebSockets" }
+ *       ]
+ *     }},
+ *     "notes": { "type": "string" }
+ *   },
+ *   "required": ["framework"]
+ * }
+ * ```
+ */
+export interface ElicitationRequest {
+    /**
+     * Name of the MCP server requesting input. Maps to the `mcp_server_name`
+     * field in the Claude protocol. Display this so the user knows which
+     * server is asking for input.
+     */
+    mcpServerName: string;
+    /** Human-readable prompt describing what input is needed. */
+    message: string;
+    /** How to present the request: "form" for inline input, "url" to open a browser. */
+    mode?: "form" | "url";
+    /** URL to open when mode is "url". */
+    url?: string;
+    /** Unique ID for this elicitation, used for deduplication. */
+    elicitationId?: string;
+    /**
+     * JSON Schema (type: "object") describing the expected input. Each property
+     * in `properties` is a form field. See the type-level JSDoc for the full
+     * list of supported property types and examples.
+     */
+    requestedSchema?: Record<string, unknown>;
+}
+/** Host response to an elicitation request. */
+export interface ElicitationResponse {
+    /** "accept" to provide content, "decline" to refuse, "cancel" to abort the turn. */
+    action: "accept" | "decline" | "cancel";
+    /** The user's input, matching the requestedSchema. Only required when action is "accept". */
+    content?: Record<string, unknown>;
+}
+/** Sent when the CLI needs the host to execute a hook callback. */
+export interface HookCallbackRequest {
+    callbackId: string;
+    input: Record<string, unknown>;
+    toolUseId?: string;
+}
+/** Host response to a hook callback. */
+export interface HookCallbackResponse {
+    result?: Record<string, unknown>;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,2 +1,24 @@
-export {};
+/**
+ * Get aggregate usage across all models. Convenience for when you don't
+ * care about per-model breakdown.
+ */
+export function aggregateUsage(usage) {
+    if (!usage)
+        return null;
+    const entries = Object.values(usage);
+    if (entries.length === 0)
+        return null;
+    const result = { inputTokens: 0, outputTokens: 0 };
+    for (const u of entries) {
+        result.inputTokens += u.inputTokens;
+        result.outputTokens += u.outputTokens;
+        if (u.cachedInputTokens != null) {
+            result.cachedInputTokens = (result.cachedInputTokens ?? 0) + u.cachedInputTokens;
+        }
+        if (u.cacheCreationInputTokens != null) {
+            result.cacheCreationInputTokens = (result.cacheCreationInputTokens ?? 0) + u.cacheCreationInputTokens;
+        }
+    }
+    return result;
+}
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAqIA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAA6C;IAC1E,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,MAAM,GAAe,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IAC/D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,CAAC;QACpC,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC,YAAY,CAAC;QACtC,IAAI,CAAC,CAAC,iBAAiB,IAAI,IAAI,EAAE,CAAC;YAChC,MAAM,CAAC,iBAAiB,GAAG,CAAC,MAAM,CAAC,iBAAiB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAC;QACnF,CAAC;QACD,IAAI,CAAC,CAAC,wBAAwB,IAAI,IAAI,EAAE,CAAC;YACvC,MAAM,CAAC,wBAAwB,GAAG,CAAC,MAAM,CAAC,wBAAwB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,wBAAwB,CAAC;QACxG,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/ask-user-question.d.ts

@@ -0,0 +1,50 @@
+import type { UserInputRequest } from "../types.js";
+/**
+ * Structured option within an AskUserQuestion prompt.
+ */
+export interface QuestionOption {
+    label: string;
+    description: string;
+    /** Optional preview/detail content for the option. */
+    preview?: string;
+}
+/**
+ * A single question from the AskUserQuestion tool.
+ *
+ * Claude uses this tool to ask the user structured questions — for example,
+ * choosing between implementation approaches in plan mode. Each question has
+ * 2-4 predefined options. Apps typically add a freeform "Other" option when
+ * rendering.
+ */
+export interface AskUserQuestion {
+    question: string;
+    header: string;
+    options: QuestionOption[];
+    /** When true, the user can select multiple options. */
+    multiSelect?: boolean;
+}
+/**
+ * Parse an AskUserQuestion tool call from a UserInputRequest.
+ *
+ * Returns the structured questions array if this is an AskUserQuestion request,
+ * or `null` if it's a regular tool request.
+ *
+ * @example
+ * ```ts
+ * onUserInputRequest: async (req) => {
+ *   const questions = parseAskUserQuestion(req);
+ *   if (questions) {
+ *     // Render choices UI, collect answers
+ *     const answers: Record<string, string> = {};
+ *     for (const q of questions) {
+ *       answers[q.question] = await showChoiceUI(q.options);
+ *     }
+ *     return { allow: true, updatedInput: { ...req.input, answers } };
+ *   }
+ *   // Handle as regular tool request
+ *   return { allow: true };
+ * }
+ * ```
+ */
+export declare function parseAskUserQuestion(req: UserInputRequest): AskUserQuestion[] | null;
+//# sourceMappingURL=ask-user-question.d.ts.map

package/dist/utils/ask-user-question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-question.d.ts","sourceRoot":"","sources":["../../src/utils/ask-user-question.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,uDAAuD;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,GAAG,eAAe,EAAE,GAAG,IAAI,CAKpF"}

package/dist/utils/ask-user-question.js

@@ -0,0 +1,32 @@
+/**
+ * Parse an AskUserQuestion tool call from a UserInputRequest.
+ *
+ * Returns the structured questions array if this is an AskUserQuestion request,
+ * or `null` if it's a regular tool request.
+ *
+ * @example
+ * ```ts
+ * onUserInputRequest: async (req) => {
+ *   const questions = parseAskUserQuestion(req);
+ *   if (questions) {
+ *     // Render choices UI, collect answers
+ *     const answers: Record<string, string> = {};
+ *     for (const q of questions) {
+ *       answers[q.question] = await showChoiceUI(q.options);
+ *     }
+ *     return { allow: true, updatedInput: { ...req.input, answers } };
+ *   }
+ *   // Handle as regular tool request
+ *   return { allow: true };
+ * }
+ * ```
+ */
+export function parseAskUserQuestion(req) {
+    if (req.toolName !== "AskUserQuestion")
+        return null;
+    const questions = req.input["questions"];
+    if (!Array.isArray(questions) || questions.length === 0)
+        return null;
+    return questions;
+}
+//# sourceMappingURL=ask-user-question.js.map

package/dist/utils/ask-user-question.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-question.js","sourceRoot":"","sources":["../../src/utils/ask-user-question.ts"],"names":[],"mappings":"AA4BA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAqB;IACxD,IAAI,GAAG,CAAC,QAAQ,KAAK,iBAAiB;QAAE,OAAO,IAAI,CAAC;IACpD,MAAM,SAAS,GAAI,GAAG,CAAC,KAAiC,CAAC,WAAW,CAAC,CAAC;IACtE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrE,OAAO,SAA8B,CAAC;AACxC,CAAC"}

package/dist/utils/auth.d.ts

@@ -0,0 +1,29 @@
+import type { AuthReport, AuthResolveContext, ProviderModule } from "../types.js";
+export interface ResolvedAuth {
+    /** How the user is authenticated */
+    method: "api_key" | "bedrock" | "oauth" | "subscription";
+    /** How usage is billed */
+    billingType: "api" | "metered_api" | "subscription";
+    /** If the auth method requires model ID transformation (e.g., Bedrock), this resolves it */
+    resolveModelId?(requestedModel: string): string;
+    /** Cloud region, if applicable (Bedrock) */
+    region?: string;
+}
+/**
+ * Detect authentication method for a given provider based on environment variables.
+ */
+export declare function detectAuth(providerType: string, env: Record<string, string>): ResolvedAuth;
+/**
+ * Resolve the auth report for a provider by type. Providers call the matching
+ * function from their own `resolveAuth` method; callers can use the helpers
+ * below (`hasSubscription`, `hasApiKey`, `hasBedrock`) instead of this
+ * directly.
+ */
+export declare function resolveAuthForProvider(providerType: string, ctx?: AuthResolveContext): Promise<AuthReport>;
+/** True only if a subscription credential is confirmed present on disk. */
+export declare function hasSubscription(provider: ProviderModule, ctx?: AuthResolveContext): Promise<boolean>;
+/** True only if an API key is confirmed set in the env. */
+export declare function hasApiKey(provider: ProviderModule, ctx?: AuthResolveContext): Promise<boolean>;
+/** True only if Bedrock credentials are confirmed present in the env. */
+export declare function hasBedrock(provider: ProviderModule, ctx?: AuthResolveContext): Promise<boolean>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/utils/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/utils/auth.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,UAAU,EACV,kBAAkB,EAClB,cAAc,EACf,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,cAAc,CAAC;IACzD,0BAA0B;IAC1B,WAAW,EAAE,KAAK,GAAG,aAAa,GAAG,cAAc,CAAC;IACpD,4FAA4F;IAC5F,cAAc,CAAC,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAChD,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4CD;;GAEG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAuD1F;AA0HD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE,kBAAkB,GACvB,OAAO,CAAC,UAAU,CAAC,CAiBrB;AAYD,2EAA2E;AAC3E,wBAAsB,eAAe,CACnC,QAAQ,EAAE,cAAc,EACxB,GAAG,CAAC,EAAE,kBAAkB,GACvB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,2DAA2D;AAC3D,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,cAAc,EACxB,GAAG,CAAC,EAAE,kBAAkB,GACvB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,yEAAyE;AACzE,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,EACxB,GAAG,CAAC,EAAE,kBAAkB,GACvB,OAAO,CAAC,OAAO,CAAC,CAGlB"}