nuabase 2.3.7 → 3.0.0

package/dist/types/nua-llm-core/modules/agent/types.d.ts

@@ -1,90 +0,0 @@
-import { NormalizedUsage } from "../engine/http/provider-config";
-import { ModelInput } from "../model-info";
-export type ToolDefinition = {
-    name: string;
-    description: string;
-    parameters: Record<string, unknown>;
-};
-export type ToolExecutionResult = {
-    content: string;
-    isError?: boolean;
-};
-export type AgentTool = ToolDefinition & {
-    execute: (args: Record<string, unknown>) => Promise<ToolExecutionResult>;
-};
-export type TextContent = {
-    type: "text";
-    text: string;
-};
-export type ToolCallContent = {
-    type: "toolCall";
-    id: string;
-    name: string;
-    arguments: Record<string, unknown>;
-};
-export type AssistantContentBlock = TextContent | ToolCallContent;
-export type UserMessage = {
-    role: "user";
-    content: string;
-};
-export type AssistantMessage = {
-    role: "assistant";
-    content: AssistantContentBlock[];
-};
-export type ToolResultMessage = {
-    role: "toolResult";
-    toolCallId: string;
-    toolName: string;
-    content: string;
-    isError: boolean;
-};
-export type ConversationMessage = UserMessage | AssistantMessage | ToolResultMessage;
-export type AgenticParsedResponse = {
-    message: AssistantMessage;
-    usage: NormalizedUsage;
-    stopReason: "stop" | "tool_use";
-};
-export type AgentEvent = {
-    type: "turn_start";
-    turn: number;
-} | {
-    type: "text_delta";
-    text: string;
-} | {
-    type: "response_complete";
-    message: AssistantMessage;
-    usage: NormalizedUsage;
-    stopReason: "stop" | "tool_use";
-} | {
-    type: "tool_start";
-    toolCallId: string;
-    toolName: string;
-    arguments: Record<string, unknown>;
-} | {
-    type: "tool_complete";
-    toolCallId: string;
-    toolName: string;
-    result: ToolExecutionResult;
-} | {
-    type: "error";
-    error: string;
-};
-export type AgentEventHandler = (event: AgentEvent) => void;
-export type AgentRunParams = {
-    model?: ModelInput;
-    systemPrompt?: string;
-    messages: ConversationMessage[];
-    tools: AgentTool[];
-    maxTokens?: number;
-    maxTurns?: number;
-    onEvent?: AgentEventHandler;
-};
-export type AgentCompletionReason = "stop" | "max_turns" | "error";
-export type AgentResult = {
-    success: boolean;
-    completionReason: AgentCompletionReason;
-    messages: ConversationMessage[];
-    textResponse?: string;
-    usage: NormalizedUsage;
-    error?: string;
-};

package/dist/types/nua-llm-core/modules/cast/cast-request.d.ts

@@ -1,32 +0,0 @@
-import { JsonSchema } from "../../lib/schema-utils";
-import { MappableInputData } from "../../lib/types";
-/** A cast ready to run, as plain data. Its prompt is rendered per attempt (see prompts/render-prompt). */
-export type CastRequest = ValueCastRequest | ListCastRequest;
-/** Asks for one value. */
-export type ValueCastRequest = {
-    kind: "value";
-    /** The caller's instructions. */
-    prompt: string;
-    data: unknown;
-    outputName: string;
-    /** The schema the result must satisfy. */
-    schema: JsonSchema;
-    maxTokens: number;
-};
-/** Asks for one result row per input row, each keyed by the input row's primary key. */
-export type ListCastRequest = {
-    kind: "list";
-    /** The caller's instructions. */
-    prompt: string;
-    rows: MappableInputData;
-    primaryKey: string;
-    outputName: string;
-    /** The schema the whole list must satisfy (see list-schema). */
-    schema: JsonSchema;
-    maxTokens: number;
-};
-/** The prompt one attempt sends. `system` is the part that tells the model how to shape its answer. */
-export type RenderedPrompt = {
-    system: string;
-    full: string;
-};

package/dist/types/nua-llm-core/modules/cast/envelope.d.ts

@@ -1,9 +0,0 @@
-import { JsonSchema } from "../../lib/schema-utils";
-export declare const ENVELOPE_KEY = "value";
-export declare function wrapInEnvelope(schema: JsonSchema): JsonSchema;
-export declare function unwrapEnvelope(envelope: unknown): {
-    found: true;
-    value: unknown;
-} | {
-    found: false;
-};

package/dist/types/nua-llm-core/modules/cast/list-schema.d.ts

@@ -1,32 +0,0 @@
-import { NuaValidationError } from "../../lib/nua-errors";
-import { JsonSchema } from "../../lib/schema-utils";
-declare const listSchemaBrand: unique symbol;
-/** Names the two fields of every row in a list result. */
-export type ListRowKeys = {
-    /** Holds the primary key of the input row the result row answers. */
-    primaryKey: string;
-    /** Holds the output value. */
-    outputName: string;
-};
-/**
- * The schema of a list cast's result, with the row keys it was built for. Only
- * listSchema() and parseListSchema() make one, so a castArray call cannot be
- * given an item schema by mistake.
- */
-export type ListSchema = ListRowKeys & {
-    readonly [listSchemaBrand]: true;
-    /** The JSON schema of the whole list, as sent to the model and validated against. */
-    jsonSchema: JsonSchema;
-};
-/**
- * Builds the list schema whose rows each hold one `itemSchema` value:
- *
- *   array<{ <primaryKey>: string | number, <outputName>: <itemSchema> }>
- */
-export declare function listSchema(itemSchema: JsonSchema, keys: ListRowKeys): ListSchema;
-/**
- * Reads back a list schema that was built by listSchema() and stored as JSON. It is
- * used exactly as stored, so a change to listSchema() does not alter stored ones.
- */
-export declare function parseListSchema(jsonSchema: unknown, keys: ListRowKeys): ListSchema | NuaValidationError;
-export {};

package/dist/types/nua-llm-core/modules/cast/prompts/list-prompt.d.ts

@@ -1,3 +0,0 @@
-import { SchemaEnforcementKind } from "../../engine/llm-engine";
-import { ListCastRequest, RenderedPrompt } from "../cast-request";
-export declare function renderListPrompt(cast: ListCastRequest, enforcement: SchemaEnforcementKind): RenderedPrompt;

package/dist/types/nua-llm-core/modules/cast/prompts/render-prompt.d.ts

@@ -1,7 +0,0 @@
-import { SchemaEnforcementKind } from "../../engine/llm-engine";
-import { CastRequest, RenderedPrompt } from "../cast-request";
-/**
- * The prompt for one attempt at a cast. It differs by enforcement: with native
- * enforcement the model is told its answer goes in an envelope field.
- */
-export declare function renderPrompt(cast: CastRequest, enforcement: SchemaEnforcementKind): RenderedPrompt;

package/dist/types/nua-llm-core/modules/cast/prompts/value-prompt.d.ts

@@ -1,3 +0,0 @@
-import { SchemaEnforcementKind } from "../../engine/llm-engine";
-import { RenderedPrompt, ValueCastRequest } from "../cast-request";
-export declare function renderValuePrompt(cast: ValueCastRequest, enforcement: SchemaEnforcementKind): RenderedPrompt;

package/dist/types/nua-llm-core/modules/cast/run-cast.d.ts

@@ -1,44 +0,0 @@
-import { Logger } from "../../lib/logger";
-import { NormalizedUsage } from "../engine/http/provider-config";
-import { AnswerOrigin, AttemptOutcome, LlmEngine, SchemaEnforcementKind } from "../engine/llm-engine";
-import { ValidationResult } from "../json-schema-validation/nua-json-schema-value-validation";
-import { CastRequest, RenderedPrompt } from "./cast-request";
-export type CastSuccess<T> = {
-    success: true;
-    data: T;
-    /** Usage of the attempt that succeeded. */
-    usage: NormalizedUsage;
-    /** The prompt of the attempt that succeeded. */
-    prompt: RenderedPrompt;
-    origin: AnswerOrigin;
-    schemaEnforcement: SchemaEnforcementKind;
-};
-export type CastFailure = {
-    success: false;
-    error: string;
-    /** The prompt of the last attempt, when one was made. */
-    prompt?: RenderedPrompt;
-};
-export type CastResult<T> = CastSuccess<T> | CastFailure;
-/**
- * Runs a cast on an engine: asks for an answer, checks it against the schema,
- * and tries again when another attempt could help.
- */
-export declare function runCast<T>(engine: LlmEngine, request: CastRequest, logger: Logger): Promise<CastResult<T>>;
-export type Verdict = {
-    kind: "accept";
-    data: unknown;
-    usage: NormalizedUsage;
-    origin: AnswerOrigin;
-} | {
-    kind: "retry";
-    error: string;
-} | {
-    kind: "retry-in-prompt";
-    error: string;
-} | {
-    kind: "give-up";
-    error: string;
-};
-/** Decides what one attempt means for the cast. */
-export declare function judgeOutcome(outcome: AttemptOutcome, validate: (data: object) => ValidationResult): Verdict;

package/dist/types/nua-llm-core/modules/engine/engine-router.d.ts

@@ -1,23 +0,0 @@
-import { Logger } from "../../lib/logger";
-import { ModelInput } from "../model-info";
-import { LlmEngine } from "./llm-engine";
-/** The engine that runs a model choice, or why none can. */
-export type Route = {
-    kind: "routed";
-    engine: LlmEngine;
-} | {
-    kind: "unroutable";
-    message: string;
-};
-/**
- * Where a client's calls run. Every setup answers the same question: for this
- * model choice, which engine runs it? Created by providerEngines() for LLM
- * providers' APIs, or by localAgent() / findLocalAgent() in the Node-only
- * "nua-llm-core/local-agent" entry point for a coding-agent CLI.
- */
-export interface EngineRouter {
-    /** Where the engines log their calls. Casts log their retries here too. */
-    readonly logger: Logger;
-    /** `model` undefined means this router's default model. */
-    route(model: ModelInput | undefined): Route;
-}

package/dist/types/nua-llm-core/modules/engine/http/http-engine.d.ts

@@ -1,12 +0,0 @@
-import { Logger } from "../../../lib/logger";
-import { AttemptOutcome, AttemptRequest, LlmEngine } from "../llm-engine";
-import { ProviderTarget } from "./provider-call";
-/** Answers cast attempts on one model of an LLM provider's HTTP API. */
-export declare class HttpEngine implements LlmEngine {
-    private readonly target;
-    private readonly logger;
-    constructor(target: ProviderTarget, logger: Logger);
-    /** Provider APIs are given the schema in the prompt; none is enforced natively yet. */
-    nativeSchema(): null;
-    attempt(request: AttemptRequest): Promise<AttemptOutcome>;
-}

package/dist/types/nua-llm-core/modules/engine/http/provider-call.d.ts

@@ -1,33 +0,0 @@
-import { Logger } from "../../../lib/logger";
-import { LlmProviderId, NormalizedUsage, ProviderRequestBase } from "./provider-config";
-/** A provider's model, and the API key to call it with. */
-export type ProviderTarget = {
-    provider: LlmProviderId;
-    model: string;
-    apiKey: string;
-};
-/** One HTTP request to an LLM provider, and how to read its reply. */
-export type ProviderCall<T> = {
-    target: ProviderTarget;
-    /** The kind of request, for the log (e.g. "chat/completions", "agentic"). */
-    apiOperation: string;
-    maxTokens: number;
-    request: ProviderRequestBase;
-    /** Throws when the reply is an error or cannot be read. */
-    parseResponse: (response: Response) => Promise<T>;
-    /** Characters of reply text, for the log. */
-    responseLength: (reply: T) => number;
-    usage: (reply: T) => NormalizedUsage | undefined;
-};
-export type ProviderCallResult<T> = {
-    kind: "ok";
-    reply: T;
-}
-/** `status` is undefined when no HTTP response arrived. */
- | {
-    kind: "failed";
-    status: number | undefined;
-    message: string;
-};
-/** Sends the request and reads the reply, logging the start and the end of the call. Never throws. */
-export declare function callProvider<T>(call: ProviderCall<T>, logger: Logger): Promise<ProviderCallResult<T>>;

package/dist/types/nua-llm-core/modules/engine/http/provider-config.d.ts

@@ -1,65 +0,0 @@
-export type ProviderRequestBase = {
-    url: string;
-    method?: string;
-    headers?: Record<string, string>;
-    body?: unknown;
-    /** Request details with secrets removed for logging */
-    loggableUrl?: string;
-    loggableHeaders?: Record<string, string>;
-    loggableBody?: unknown;
-};
-export declare const LLM_PROVIDER_IDS: readonly ["groq", "cerebras", "gemini", "openrouter"];
-export type LlmProviderId = (typeof LLM_PROVIDER_IDS)[number];
-export interface ProviderRequestOptions {
-    prompt: string;
-    model: string;
-    maxTokens: number;
-    assistantPrefillPrompt?: string;
-}
-export type NormalizedUsage = {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-};
-export declare const normalizedUsageZero: NormalizedUsage;
-export type ProviderParsedResponse = {
-    text: string;
-    usage: NormalizedUsage;
-};
-export interface ProviderConfig {
-    providerId: LlmProviderId;
-    apiOperation: string;
-    errorLabel: string;
-    buildRequest(options: ProviderRequestOptions, apiKey: string): ProviderRequestBase;
-    parseResponse(response: Response): Promise<ProviderParsedResponse>;
-}
-type OpenAiThinkingDetail = {
-    type?: string;
-    summary?: string;
-    format?: string;
-    index?: number;
-};
-type OpenAiThinkingMessage = {
-    content?: string | null;
-    reasoning?: string | null;
-    reasoning_details?: Array<OpenAiThinkingDetail | Record<string, unknown>>;
-};
-export type OpenAiUsage = {
-    prompt_tokens?: number;
-    completion_tokens?: number;
-    total_tokens?: number;
-    prompt_tokens_details?: Record<string, unknown> | null;
-    completion_tokens_details?: Record<string, unknown> | null;
-    [key: string]: unknown;
-} | null;
-export type GeminiUsageMetadata = {
-    promptTokenCount?: number;
-    candidatesTokenCount?: number;
-    totalTokenCount?: number;
-    [key: string]: unknown;
-};
-export declare const normalizeOpenAiUsage: (usage: OpenAiUsage | undefined) => NormalizedUsage;
-export declare const normalizeGeminiUsage: (usage: GeminiUsageMetadata | undefined) => NormalizedUsage;
-export declare const extractOpenAiMessageText: (message: OpenAiThinkingMessage | undefined) => string | undefined;
-export declare const providerConfigs: Record<LlmProviderId, ProviderConfig>;
-export {};

package/dist/types/nua-llm-core/modules/engine/http/provider-engines.d.ts

@@ -1,35 +0,0 @@
-import { Logger } from "../../../lib/logger";
-import { ModelInput } from "../../model-info";
-import { EngineRouter, Route } from "../engine-router";
-import { ProviderTarget } from "./provider-call";
-import { LlmProviderId } from "./provider-config";
-export type ProviderEnginesConfig = {
-    /** API keys by provider. Providers without a key are never used. */
-    providers: {
-        [key in LlmProviderId]?: {
-            apiKey: string;
-        };
-    };
-    /** Used when a call names no model. Defaults to the "fast" alias. */
-    model?: ModelInput;
-    /** Defaults to the console. */
-    logger?: Logger;
-};
-type Unroutable = Extract<Route, {
-    kind: "unroutable";
-}>;
-/** Runs calls on LLM providers' HTTP APIs, with API keys. Also runs tool-calling agents (see runAgent). */
-export declare function providerEngines(config: ProviderEnginesConfig): ProviderEngines;
-export declare class ProviderEngines implements EngineRouter {
-    readonly logger: Logger;
-    private readonly apiKeys;
-    private readonly defaultModel;
-    constructor(config: ProviderEnginesConfig);
-    route(model: ModelInput | undefined): Route;
-    /** The provider model, with its API key, that a model choice runs on. */
-    resolve(model: ModelInput | undefined): {
-        kind: "resolved";
-        target: ProviderTarget;
-    } | Unroutable;
-}
-export {};

package/dist/types/nua-llm-core/modules/engine/llm-engine.d.ts

@@ -1,73 +0,0 @@
-import { JsonSchema } from "../../lib/schema-utils";
-import { LlmProviderId, NormalizedUsage } from "./http/provider-config";
-import type { LocalAgentId } from "./local-agent/agent-id";
-/**
- * How one attempt makes the model produce the output shape.
- * - in-prompt: the prompt describes the schema; the reply is free text that should contain the JSON.
- * - native: the engine enforces `schema` itself. It is the output schema wrapped in an
- *   envelope (see cast/envelope), already converted to the engine's own dialect.
- */
-export type SchemaEnforcement = {
-    kind: "in-prompt";
-} | {
-    kind: "native";
-    schema: JsonSchema;
-};
-export type SchemaEnforcementKind = SchemaEnforcement["kind"];
-/** One prompt for an engine to answer once, on the model the engine was created for. */
-export type AttemptRequest = {
-    prompt: string;
-    maxTokens: number;
-    enforcement: SchemaEnforcement;
-};
-export type Answer = 
-/** A free-text reply that should contain the JSON result. */
-{
-    kind: "text";
-    text: string;
-}
-/** The envelope object the engine enforced natively. */
- | {
-    kind: "structured";
-    envelope: unknown;
-};
-/** Which engine produced an answer. */
-export type AnswerOrigin = {
-    engine: "http";
-    provider: LlmProviderId;
-    model: string;
-} | {
-    engine: "local-agent";
-    agent: LocalAgentId;
-    /** The model the agent reports using, else the one requested; undefined when neither is known. */
-    model: string | undefined;
-    /** The agent's own estimate. On a subscription this is not what the user pays. */
-    costUsdEstimate: number | undefined;
-};
-export type AttemptFailure = {
-    /**
-     * - transient: another attempt may succeed.
-     * - fatal: every attempt will fail the same way (bad API key, not logged in, out of quota, timed out).
-     * - schema-rejected: the engine refused the native schema; the in-prompt prompt may still work.
-     */
-    kind: "transient" | "fatal" | "schema-rejected";
-    message: string;
-};
-export type AttemptOutcome = {
-    kind: "answered";
-    answer: Answer;
-    usage: NormalizedUsage;
-    origin: AnswerOrigin;
-} | {
-    kind: "failed";
-    failure: AttemptFailure;
-};
-/**
- * Answers prompts on one model: an LLM provider's HTTP API, or a coding-agent
- * CLI on this machine. Expected failures come back as outcomes, not exceptions.
- */
-export interface LlmEngine {
-    /** The envelope schema in the form this engine enforces natively, or null if it cannot. */
-    nativeSchema(envelopeSchema: JsonSchema): JsonSchema | null;
-    attempt(request: AttemptRequest): Promise<AttemptOutcome>;
-}

package/dist/types/nua-llm-core/modules/engine/local-agent/adapters/claude-code.d.ts

@@ -1,2 +0,0 @@
-import { AgentAdapter } from "./types";
-export declare const claudeCodeAdapter: AgentAdapter;

package/dist/types/nua-llm-core/modules/engine/local-agent/adapters/codex.d.ts

@@ -1,2 +0,0 @@
-import { AgentAdapter } from "./types";
-export declare const codexAdapter: AgentAdapter;

package/dist/types/nua-llm-core/modules/engine/local-agent/adapters/failure-classification.d.ts

@@ -1,4 +0,0 @@
-import { AttemptFailure } from "../../llm-engine";
-import { AgentProcessResult } from "./types";
-export declare function classifyAgentFailure(agent: string, message: string): AttemptFailure;
-export declare function stderrTail(result: AgentProcessResult, maxChars?: number): string;

package/dist/types/nua-llm-core/modules/engine/local-agent/adapters/index.d.ts

@@ -1,3 +0,0 @@
-import { LocalAgentId } from "../agent-id";
-import { AgentAdapter } from "./types";
-export declare const AGENT_ADAPTERS: Record<LocalAgentId, AgentAdapter>;

package/dist/types/nua-llm-core/modules/engine/local-agent/adapters/pi.d.ts

@@ -1,2 +0,0 @@
-import { AgentAdapter } from "./types";
-export declare const piAdapter: AgentAdapter;

package/dist/types/nua-llm-core/modules/engine/local-agent/adapters/types.d.ts

@@ -1,61 +0,0 @@
-import { JsonSchema } from "../../../../lib/schema-utils";
-import { ModelAliasName } from "../../../model-info";
-import { NormalizedUsage } from "../../http/provider-config";
-import { Answer, AttemptFailure, AttemptRequest } from "../../llm-engine";
-import { LocalAgentId } from "../agent-id";
-/** A process to run inside a fresh, empty working directory. */
-export type AgentInvocation = {
-    args: string[];
-    stdin: string;
-    /** Files written into the working directory before the process starts. */
-    files?: {
-        name: string;
-        content: string;
-    }[];
-    /** Files read back from the working directory after the process exits. */
-    outputFiles?: string[];
-};
-export type AgentProcessResult = {
-    exitCode: number | null;
-    stdout: string;
-    stderr: string;
-    timedOut: boolean;
-    /** Contents of the requested output files; undefined when a file was not written. */
-    outputFiles: Record<string, string | undefined>;
-};
-/** What an agent's output says about one attempt. */
-export type AgentReply = {
-    kind: "answered";
-    answer: Answer;
-    usage: NormalizedUsage;
-    /** The model the agent reports having used, when it says. */
-    model: string | undefined;
-    costUsdEstimate: number | undefined;
-} | {
-    kind: "failed";
-    failure: AttemptFailure;
-};
-export type AgentLoginStatus = {
-    loggedIn: boolean;
-    detail?: string;
-};
-/**
- * Knows one coding-agent CLI: which models it offers, how to invoke it headless,
- * and how to read its output. Adapters do no I/O; the process runner does the spawning.
- */
-export interface AgentAdapter {
-    id: LocalAgentId;
-    /** Executable name looked up on PATH. */
-    binaryName: string;
-    /** Env vars that would make the CLI bill an API key instead of the user's subscription. */
-    apiKeyEnvVars: string[];
-    /** The CLI's own model name for each model alias it has an equivalent for. */
-    modelAliases: Partial<Record<ModelAliasName, string>>;
-    /** The envelope schema in the form this CLI accepts, or null if it can't enforce it. */
-    nativeSchema(envelopeSchema: JsonSchema): JsonSchema | null;
-    /** `model` is the CLI's own model name; undefined uses the CLI's default. */
-    buildInvocation(request: AttemptRequest, model: string | undefined): AgentInvocation;
-    readResult(result: AgentProcessResult, request: AttemptRequest): AgentReply;
-    loginStatusArgs: string[];
-    readLoginStatus(result: AgentProcessResult): AgentLoginStatus;
-}

package/dist/types/nua-llm-core/modules/engine/local-agent/agent-id.d.ts

@@ -1,4 +0,0 @@
-/** Supported coding-agent CLIs, in the order findLocalAgent() tries them. */
-export declare const LOCAL_AGENT_IDS: readonly ["claude-code", "codex", "pi"];
-export type LocalAgentId = (typeof LOCAL_AGENT_IDS)[number];
-export declare function isLocalAgentId(value: unknown): value is LocalAgentId;

package/dist/types/nua-llm-core/modules/engine/local-agent/create-local-agent.d.ts

@@ -1,36 +0,0 @@
-import { Logger } from "../../../lib/logger";
-import { LocalAgentId } from "./agent-id";
-import { LocalAgent } from "./local-agent";
-/**
- * - subscription: removes API-key env vars (ANTHROPIC_API_KEY, OPENAI_API_KEY, ...) from the
- *   agent's environment, so the CLI uses its own login and plan.
- * - inherit: passes the environment through unchanged.
- */
-export type LocalAgentAuthMode = "subscription" | "inherit";
-export type LocalAgentOptions = {
-    /** The agent's own model name (e.g. "haiku" for Claude Code) for calls that name no model. Defaults to the agent's default. */
-    model?: string;
-    /** Per-call limit in milliseconds. Defaults to 180000. */
-    timeoutMs?: number;
-    /** Maximum agent processes running at once. Defaults to 2. */
-    concurrency?: number;
-    /** Defaults to "subscription". */
-    auth?: LocalAgentAuthMode;
-    /** Where calls and cast retries are logged. Defaults to the console. */
-    logger?: Logger;
-};
-export type LocalAgentConfig = LocalAgentOptions & {
-    agent: LocalAgentId;
-    /** Path to the agent executable. Defaults to looking it up on PATH. */
-    binaryPath?: string;
-};
-/**
- * Sets up the named coding-agent CLI on this machine. Throws right away when the
- * CLI cannot be found; a missing login shows up as the first call's error. Node.js only.
- */
-export declare function localAgent(config: LocalAgentConfig): LocalAgent;
-/**
- * Sets up the first supported coding-agent CLI that is installed and logged in,
- * trying Claude Code first. Rejects when none is. Node.js only.
- */
-export declare function findLocalAgent(options?: LocalAgentOptions): Promise<LocalAgent>;

package/dist/types/nua-llm-core/modules/engine/local-agent/detect.d.ts

@@ -1,20 +0,0 @@
-import { LocalAgentId } from "./agent-id";
-export type LocalAgentStatus = {
-    agent: LocalAgentId;
-    installed: false;
-    loggedIn: false;
-    detail?: string;
-} | {
-    agent: LocalAgentId;
-    installed: true;
-    loggedIn: boolean;
-    binaryPath: string;
-    version?: string;
-    detail?: string;
-};
-/**
- * Reports which supported coding agents are installed and logged in, in
- * preference order. Runs each CLI's version and login-status commands, which
- * make no model calls.
- */
-export declare function detectLocalAgents(binaryPaths?: Partial<Record<LocalAgentId, string>>): Promise<LocalAgentStatus[]>;

package/dist/types/nua-llm-core/modules/engine/local-agent/local-agent-engine.d.ts

@@ -1,32 +0,0 @@
-import { Logger } from "../../../lib/logger";
-import { JsonSchema } from "../../../lib/schema-utils";
-import { AttemptOutcome, AttemptRequest, LlmEngine } from "../llm-engine";
-import { AgentAdapter } from "./adapters/types";
-import { Semaphore } from "./semaphore";
-/** How to run one installed agent's processes. Set up once and shared by all its engines. */
-export type AgentRunner = {
-    adapter: AgentAdapter;
-    binaryPath: string;
-    /** Per-attempt limit. */
-    timeoutMs: number;
-    /** Env vars removed from the agent's environment. */
-    unsetEnv: string[];
-    /** Bounds how many agent processes run at once, across all models. */
-    limiter: Semaphore;
-    logger: Logger;
-};
-/**
- * Answers prompts on one model of a coding-agent CLI installed on this machine.
- * Each attempt is one agent process. maxTokens has no CLI equivalent and is ignored.
- */
-export declare class LocalAgentEngine implements LlmEngine {
-    private readonly runner;
-    /** The CLI's own model name; undefined uses the CLI's default. */
-    private readonly model;
-    constructor(runner: AgentRunner, 
-    /** The CLI's own model name; undefined uses the CLI's default. */
-    model: string | undefined);
-    nativeSchema(envelopeSchema: JsonSchema): JsonSchema | null;
-    attempt(request: AttemptRequest): Promise<AttemptOutcome>;
-    private runAgent;
-}