nuabase 2.3.11 → 3.0.1

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;
-}

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

@@ -1,25 +0,0 @@
-import { Logger } from "../../../lib/logger";
-import { ModelInput } from "../../model-info";
-import { EngineRouter, Route } from "../engine-router";
-import { LocalAgentId } from "./agent-id";
-import { AgentRunner } from "./local-agent-engine";
-/**
- * A coding-agent CLI on this machine, set up once and ready to run casts.
- * Created by localAgent() or findLocalAgent().
- */
-export declare class LocalAgent implements EngineRouter {
-    private readonly runner;
-    /** The CLI's own model name for calls that name no model; undefined uses the CLI's default. */
-    private readonly defaultModel;
-    readonly agent: LocalAgentId;
-    readonly logger: Logger;
-    constructor(runner: AgentRunner, 
-    /** The CLI's own model name for calls that name no model; undefined uses the CLI's default. */
-    defaultModel: string | undefined);
-    /**
-     * No model choice runs the default model. An alias runs the CLI's equivalent
-     * model, if it has one. Provider models cannot run on a local agent.
-     */
-    route(model: ModelInput | undefined): Route;
-    private routeTo;
-}

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

@@ -1,16 +0,0 @@
-import { AgentInvocation, AgentProcessResult } from "./adapters/types";
-export type RunInvocationOptions = {
-    binaryPath: string;
-    invocation: AgentInvocation;
-    timeoutMs: number;
-    /** Env var names removed from the child's environment. */
-    unsetEnv?: string[];
-};
-/**
- * Runs one CLI invocation in a fresh temporary directory, so the agent sees no
- * project files, hooks, MCP config, or instructions, and removes the directory
- * afterwards. Rejects only when the process cannot be started.
- */
-export declare function runInvocation(options: RunInvocationOptions): Promise<AgentProcessResult>;
-/** Finds an executable on PATH, honouring PATHEXT on Windows. */
-export declare function findOnPath(binaryName: string): string | null;

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

@@ -1,8 +0,0 @@
-/** Runs at most `limit` tasks at once; the rest wait in order. */
-export declare class Semaphore {
-    private readonly limit;
-    private active;
-    private readonly waiting;
-    constructor(limit: number);
-    run<T>(task: () => Promise<T>): Promise<T>;
-}

package/dist/types/nua-llm-core/modules/execution/llm-response-extraction.d.ts

@@ -1,5 +0,0 @@
-export declare function extractThinkingFromResponse(input: string): {
-    thinking: string;
-    cleanedResponse: string;
-};
-export declare function parseJsonFromLlmResponse(input: string): object;

package/dist/types/nua-llm-core/modules/json-schema-validation/ajv-instances.d.ts

@@ -1,12 +0,0 @@
-import Ajv from "ajv";
-import Ajv2019 from "ajv/dist/2019.js";
-import Ajv2020 from "ajv/dist/2020.js";
-declare class AjvInstances {
-    readonly draft07: Ajv;
-    readonly draft2019: Ajv2019;
-    readonly draft2020: Ajv2020;
-    constructor();
-    getInstanceForSchema(schema: object): Ajv | Ajv2019 | Ajv2020;
-}
-export declare const ajvInstances: AjvInstances;
-export {};

package/dist/types/nua-llm-core/modules/json-schema-validation/nua-json-schema-value-validation.d.ts

@@ -1,10 +0,0 @@
-export type ValidationResult = {
-    success: boolean;
-    data?: object;
-    error?: string;
-};
-/**
- * Creates a validation function for checking JSON data against a schema using AJV.
- * Returns a closure that validates unknown data and returns a typed ValidationResult.
- */
-export declare function buildNuaJsonSchemaValueValidation(llmRequestId: string, parsedSchema: object): (json: object) => ValidationResult;

package/dist/types/nua-llm-core/modules/json-schema-validation/validate-json-schema.d.ts

@@ -1,2 +0,0 @@
-import { NuaValidationError } from "../../lib/nua-errors";
-export declare const validateJsonSchema: (schema: Object) => true | NuaValidationError;

package/dist/types/nua-llm-core/modules/model-info/index.d.ts

@@ -1,15 +0,0 @@
-import { NuaValidationError } from "../../lib/nua-errors";
-import { LlmProviderId } from "../engine/http/provider-config";
-export type ProviderModel = {
-    provider: LlmProviderId;
-    model: string;
-};
-export type ModelAliasName = "fast" | "gemini" | "qwen" | "sonnet" | "opus" | "haiku" | "kimi" | "gpt";
-export type ModelInput = ProviderModel | {
-    alias: ModelAliasName;
-};
-export declare const MODEL_ALIASES: Record<ModelAliasName, ProviderModel[]>;
-export declare const MODEL_ALIAS_NAMES: ModelAliasName[];
-export declare function isLlmProviderId(value: unknown): value is LlmProviderId;
-export declare function isModelAliasName(value: unknown): value is ModelAliasName;
-export declare function resolveModelInput(input: ModelInput | null | undefined, configuredProviders: ReadonlySet<LlmProviderId>): ProviderModel | NuaValidationError;

package/dist/types/nua-llm-core/modules/streaming/sse-parser.d.ts

@@ -1,7 +0,0 @@
-/**
- * Generic SSE (Server-Sent Events) stream parser.
- * Reads a ReadableStream<Uint8Array> and yields each `data:` payload as a string.
- * Handles OpenAI's `[DONE]` sentinel and Gemini's stream-close-means-done.
- * Uses only web-standard APIs (no node: imports).
- */
-export declare function parseSSEStream(stream: ReadableStream<Uint8Array>): AsyncGenerator<string>;

package/dist/types/nua-llm-core/nua-llm-client.d.ts

@@ -1,37 +0,0 @@
-import { ListSchema } from "./modules/cast/list-schema";
-import { CastResult } from "./modules/cast/run-cast";
-import { EngineRouter } from "./modules/engine/engine-router";
-import { ModelInput } from "./modules/model-info";
-export type CastValueParams = {
-    model?: ModelInput;
-    maxTokens?: number;
-    input: {
-        prompt: string;
-        data?: unknown;
-    };
-    output: {
-        name: string;
-        schema: object;
-    };
-};
-export type CastArrayParams = {
-    model?: ModelInput;
-    maxTokens?: number;
-    input: {
-        prompt: string;
-        data: unknown[];
-    };
-    /** Built with listSchema(); it names each row's primary key and output field. */
-    output: ListSchema;
-};
-/**
- * Turns a prompt, data and a JSON schema into a validated value. Where the calls
- * run is up to the engine router it is given: providerEngines() for LLM
- * providers' APIs, or localAgent() from "nua-llm-core/local-agent".
- */
-export declare class NuaLlmClient {
-    private readonly engines;
-    constructor(engines: EngineRouter);
-    castValue<T = unknown>(params: CastValueParams): Promise<CastResult<T>>;
-    castArray<T = unknown>(params: CastArrayParams): Promise<CastResult<T[]>>;
-}

package/dist/types/nua.d.ts

@@ -1,42 +0,0 @@
-import { DirectConfig } from './backend/direct';
-import { GatewayConfig } from './backend/gateway';
-import { CastResult, QueueResult } from './backend/types';
-import type { ModelInput } from './nua-llm-core/index';
-import { z } from 'zod';
-export type OutputDef<TSchema extends z.ZodTypeAny> = {
-    name: string;
-    schema: TSchema;
-};
-export type GetOptions<TSchema extends z.ZodTypeAny> = {
-    input?: unknown;
-    output: OutputDef<TSchema>;
-    model?: ModelInput;
-};
-export type ListOptions<TSchema extends z.ZodTypeAny, TData extends Record<string, unknown>, PrimaryKey extends keyof TData & string> = {
-    input: TData[];
-    primaryKey: PrimaryKey;
-    output: OutputDef<TSchema>;
-    model?: ModelInput;
-};
-export type ListResultRow<TSchema extends z.ZodTypeAny, PrimaryKey extends string> = {
-    [K in PrimaryKey]: string | number;
-} & {
-    [outputName: string]: z.infer<TSchema>;
-};
-export declare class Nua {
-    private readonly backend;
-    private constructor();
-    static gateway(config: GatewayConfig): Nua;
-    /**
-     * Runs casts in this process: on LLM providers' APIs with your API keys (`providers`), or
-     * on a coding-agent CLI installed on this machine (`localAgent`, set up with `localAgent()` or
-     * `findLocalAgent()` from "nuabase/local-agent").
-     */
-    static direct(config: DirectConfig): Nua;
-    get(prompt: string): Promise<CastResult<string>>;
-    get<TSchema extends z.ZodTypeAny>(prompt: string, options: GetOptions<TSchema>): Promise<CastResult<z.infer<TSchema>>>;
-    list<TSchema extends z.ZodTypeAny, TData extends Record<string, unknown>, PrimaryKey extends keyof TData & string>(prompt: string, options: ListOptions<TSchema, TData, PrimaryKey>): Promise<CastResult<ListResultRow<TSchema, PrimaryKey>[]>>;
-    queueGet(prompt: string): Promise<QueueResult>;
-    queueGet<TSchema extends z.ZodTypeAny>(prompt: string, options: GetOptions<TSchema>): Promise<QueueResult>;
-    queueList<TSchema extends z.ZodTypeAny, TData extends Record<string, unknown>, PrimaryKey extends keyof TData & string>(prompt: string, options: ListOptions<TSchema, TData, PrimaryKey>): Promise<QueueResult>;
-}