nuabase 2.3.7 → 3.0.0

package/dist/cjs/chunks/logger-Co5uZG0A.cjs

@@ -1,90 +0,0 @@
-'use strict';
-
-var logger = {};
-
-var hasRequiredLogger;
-function requireLogger() {
-  if (hasRequiredLogger) return logger;
-  hasRequiredLogger = 1;
-  Object.defineProperty(logger, "__esModule", { value: true });
-  logger.logLlmCallError = logger.logLlmCallComplete = logger.logLlmCallStart = logger.generateSpanId = logger.ConsoleLogger = void 0;
-  logger.pickHeaders = pickHeaders;
-  logger.normalizeError = normalizeError;
-  class ConsoleLogger {
-    debug(message, context) {
-      console.debug(`[DEBUG] ${message}`, context || "");
-    }
-    info(message, context) {
-      console.info(`[INFO] ${message}`, context || "");
-    }
-    warn(message, context) {
-      console.warn(`[WARN] ${message}`, context || "");
-    }
-    error(message, context) {
-      console.error(`[ERROR] ${message}`, context || "");
-    }
-  }
-  logger.ConsoleLogger = ConsoleLogger;
-  const generateSpanId = () => crypto.randomUUID();
-  logger.generateSpanId = generateSpanId;
-  function pickHeaders(headers, allowlist, redactSet) {
-    const result = {};
-    for (const [key, value] of Object.entries(headers)) {
-      const lowerKey = key.toLowerCase();
-      if (redactSet?.has(lowerKey)) {
-        result[key] = "[REDACTED]";
-      } else if (allowlist.has(lowerKey)) {
-        result[key] = Array.isArray(value) ? value.join(", ") : value ?? "";
-      }
-    }
-    return result;
-  }
-  function normalizeError(error) {
-    return error instanceof Error ? { message: error.message, stack: error.stack } : String(error);
-  }
-  const LLM_RESPONSE_HEADER_ALLOWLIST = /* @__PURE__ */ new Set([
-    "x-request-id",
-    "x-ratelimit-limit-requests",
-    "x-ratelimit-limit-tokens",
-    "x-ratelimit-remaining-requests",
-    "x-ratelimit-remaining-tokens",
-    "x-groq-region"
-  ]);
-  const logLlmCallStart = (logger2, spanId, service, method, request) => {
-    logger2.info("LLM call started", {
-      type: "llm_call_start",
-      span_id: spanId,
-      service,
-      method,
-      ...request
-    });
-  };
-  logger.logLlmCallStart = logLlmCallStart;
-  const logLlmCallComplete = (logger2, spanId, service, method, response, duration) => {
-    const { headers, ...rest } = response;
-    logger2.info("LLM call completed", {
-      type: "llm_call_complete",
-      span_id: spanId,
-      service,
-      method,
-      ...rest,
-      ...pickHeaders(headers, LLM_RESPONSE_HEADER_ALLOWLIST),
-      duration_ms: duration
-    });
-  };
-  logger.logLlmCallComplete = logLlmCallComplete;
-  const logLlmCallError = (logger2, spanId, service, method, error, duration) => {
-    logger2.error("LLM call failed", {
-      type: "llm_call_error",
-      span_id: spanId,
-      service,
-      method,
-      error: normalizeError(error),
-      duration_ms: duration
-    });
-  };
-  logger.logLlmCallError = logLlmCallError;
-  return logger;
-}
-
-exports.requireLogger = requireLogger;

package/dist/esm/chunks/logger-DnkHzkX_.mjs

@@ -1,88 +0,0 @@
-var logger = {};
-
-var hasRequiredLogger;
-function requireLogger() {
-  if (hasRequiredLogger) return logger;
-  hasRequiredLogger = 1;
-  Object.defineProperty(logger, "__esModule", { value: true });
-  logger.logLlmCallError = logger.logLlmCallComplete = logger.logLlmCallStart = logger.generateSpanId = logger.ConsoleLogger = void 0;
-  logger.pickHeaders = pickHeaders;
-  logger.normalizeError = normalizeError;
-  class ConsoleLogger {
-    debug(message, context) {
-      console.debug(`[DEBUG] ${message}`, context || "");
-    }
-    info(message, context) {
-      console.info(`[INFO] ${message}`, context || "");
-    }
-    warn(message, context) {
-      console.warn(`[WARN] ${message}`, context || "");
-    }
-    error(message, context) {
-      console.error(`[ERROR] ${message}`, context || "");
-    }
-  }
-  logger.ConsoleLogger = ConsoleLogger;
-  const generateSpanId = () => crypto.randomUUID();
-  logger.generateSpanId = generateSpanId;
-  function pickHeaders(headers, allowlist, redactSet) {
-    const result = {};
-    for (const [key, value] of Object.entries(headers)) {
-      const lowerKey = key.toLowerCase();
-      if (redactSet?.has(lowerKey)) {
-        result[key] = "[REDACTED]";
-      } else if (allowlist.has(lowerKey)) {
-        result[key] = Array.isArray(value) ? value.join(", ") : value ?? "";
-      }
-    }
-    return result;
-  }
-  function normalizeError(error) {
-    return error instanceof Error ? { message: error.message, stack: error.stack } : String(error);
-  }
-  const LLM_RESPONSE_HEADER_ALLOWLIST = /* @__PURE__ */ new Set([
-    "x-request-id",
-    "x-ratelimit-limit-requests",
-    "x-ratelimit-limit-tokens",
-    "x-ratelimit-remaining-requests",
-    "x-ratelimit-remaining-tokens",
-    "x-groq-region"
-  ]);
-  const logLlmCallStart = (logger2, spanId, service, method, request) => {
-    logger2.info("LLM call started", {
-      type: "llm_call_start",
-      span_id: spanId,
-      service,
-      method,
-      ...request
-    });
-  };
-  logger.logLlmCallStart = logLlmCallStart;
-  const logLlmCallComplete = (logger2, spanId, service, method, response, duration) => {
-    const { headers, ...rest } = response;
-    logger2.info("LLM call completed", {
-      type: "llm_call_complete",
-      span_id: spanId,
-      service,
-      method,
-      ...rest,
-      ...pickHeaders(headers, LLM_RESPONSE_HEADER_ALLOWLIST),
-      duration_ms: duration
-    });
-  };
-  logger.logLlmCallComplete = logLlmCallComplete;
-  const logLlmCallError = (logger2, spanId, service, method, error, duration) => {
-    logger2.error("LLM call failed", {
-      type: "llm_call_error",
-      span_id: spanId,
-      service,
-      method,
-      error: normalizeError(error),
-      duration_ms: duration
-    });
-  };
-  logger.logLlmCallError = logLlmCallError;
-  return logger;
-}
-
-export { requireLogger as r };

package/dist/types/__tests__/helpers/client-factory.d.ts

@@ -1,39 +0,0 @@
-import { Nua } from '../../nua';
-import type { LocalAgentId } from '../../nua-llm-core/index';
-/**
- * One way of running casts that the shared tests exercise:
- * - gateway: the Nuabase API at NUABASE_API_URL
- * - direct: LLM providers' APIs, with API keys
- * - local-agent: a coding-agent CLI on this machine, with its own login
- */
-export type TestMode = {
-    name: string;
-} & ({
-    kind: 'gateway';
-} | {
-    kind: 'direct';
-} | {
-    kind: 'local-agent';
-    agent: LocalAgentId | 'auto';
-});
-/**
- * Returns the modes to run the shared tests in.
- * - gateway, unless SKIP_GATEWAY_TESTS is set.
- * - direct, when a provider API key is set, unless SKIP_DIRECT_TESTS is set.
- * - one local-agent mode per agent in NUA_LOCAL_AGENTS (e.g. "claude-code,codex", or "auto").
- */
-export declare function getTestModes(): TestMode[];
-/**
- * Creates a Nua client for the specified test mode.
- *
- * Gateway mode: Requires NUABASE_API_URL and NUABASE_API_KEY for a running Nuabase API
- * Direct mode: Requires one of GROQ_API_KEY, OPENROUTER_API_KEY, CEREBRAS_API_KEY, or GEMINI_API_KEY
- * Local-agent mode: Requires that agent installed and logged in on this machine
- */
-export declare function createTestClient(mode: TestMode): Promise<Nua>;
-/** The result `source` a mode produces: local agents run through the direct backend. */
-export declare function expectedSource(mode: TestMode): 'gateway' | 'direct';
-/** The part of a direct result's `meta` that says which engine answered. */
-export declare function expectedDirectMeta(mode: TestMode): Record<string, unknown>;
-/** Per-test time limit. A coding-agent CLI starts a process and may reason before answering. */
-export declare function testTimeoutMs(mode: TestMode): number;

package/dist/types/__tests__/helpers/index.d.ts

@@ -1,2 +0,0 @@
-export { createTestClient, expectedDirectMeta, expectedSource, getTestModes, testTimeoutMs, } from './client-factory';
-export type { TestMode } from './client-factory';

package/dist/types/backend/direct.d.ts

@@ -1,29 +0,0 @@
-import { CastArrayParams, CastResult, CastValueParams, LlmBackend } from './types';
-import type { LlmProviderId, ModelInput } from '../nua-llm-core/index';
-import type { LocalAgent } from '../nua-llm-core/local-agent';
-/** API keys for the LLM providers direct mode may call. */
-export type ProviderApiKeys = {
-    [key in LlmProviderId]?: {
-        apiKey: string;
-    };
-};
-/**
- * Either `providers`: API keys for LLM providers, with an optional default `model`.
- * Or `localAgent`: a coding-agent CLI on this machine, from `localAgent()` or
- * `findLocalAgent()` in "nuabase/local-agent".
- */
-export type DirectConfig = {
-    providers: ProviderApiKeys;
-    model?: ModelInput;
-    localAgent?: never;
-} | {
-    localAgent: LocalAgent;
-    providers?: never;
-    model?: never;
-};
-export declare class DirectBackend implements LlmBackend {
-    private readonly client;
-    constructor(config: DirectConfig);
-    castValue<T>(params: CastValueParams): Promise<CastResult<T>>;
-    castArray<T>(params: CastArrayParams): Promise<CastResult<T[]>>;
-}

package/dist/types/backend/gateway.d.ts

@@ -1,24 +0,0 @@
-import { CastArrayParams, CastResult, CastValueParams, LlmBackend, QueueResult } from './types';
-type GatewayApiKeyConfig = {
-    apiKey?: string;
-    fetchToken?: never;
-    baseUrl?: string;
-    dangerouslyAllowBrowserApiKeyInLocalhost?: boolean;
-};
-type GatewayTokenConfig = {
-    fetchToken: () => Promise<string>;
-    apiKey?: never;
-    baseUrl?: string;
-};
-export type GatewayConfig = GatewayApiKeyConfig | GatewayTokenConfig;
-export declare class GatewayBackend implements LlmBackend {
-    private readonly baseUrl;
-    private readonly authManager;
-    constructor(config: GatewayConfig);
-    castValue<T>(params: CastValueParams): Promise<CastResult<T>>;
-    castArray<T>(params: CastArrayParams): Promise<CastResult<T[]>>;
-    queueCastValue(params: CastValueParams): Promise<QueueResult>;
-    queueCastArray(params: CastArrayParams): Promise<QueueResult>;
-    private post;
-}
-export {};

package/dist/types/backend/types.d.ts

@@ -1,68 +0,0 @@
-import type { AnswerOrigin, ModelInput, SchemaEnforcementKind } from '../nua-llm-core/index';
-export type CastValueParams = {
-    prompt: string;
-    data: unknown;
-    outputName: string;
-    outputSchema: object;
-    model?: ModelInput;
-};
-export type CastArrayParams = {
-    prompt: string;
-    data: unknown[];
-    primaryKey: string;
-    outputName: string;
-    outputSchema: object;
-    model?: ModelInput;
-};
-export type NormalizedUsage = {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-};
-export type GatewayMeta = {
-    requestId: string;
-    cached: boolean;
-    llmUsage: NormalizedUsage;
-    cacheUsage: NormalizedUsage;
-};
-export type DirectMeta = AnswerOrigin & {
-    /** How the output schema was enforced. The result is validated against the schema either way. */
-    schemaEnforcement: SchemaEnforcementKind;
-};
-export type CastResultSource = 'gateway' | 'direct';
-type CastResultSuccess<T> = {
-    success: true;
-    data: T;
-    usage: NormalizedUsage;
-    model: string;
-    latencyMs: number;
-} & ({
-    source: 'gateway';
-    meta: GatewayMeta;
-} | {
-    source: 'direct';
-    meta: DirectMeta;
-});
-type CastResultFailure = {
-    success: false;
-    error: string;
-    source: CastResultSource;
-    latencyMs: number;
-};
-export type CastResult<T> = CastResultSuccess<T> | CastResultFailure;
-export interface LlmBackend {
-    castValue<T>(params: CastValueParams): Promise<CastResult<T>>;
-    castArray<T>(params: CastArrayParams): Promise<CastResult<T[]>>;
-    queueCastValue?(params: CastValueParams): Promise<QueueResult>;
-    queueCastArray?(params: CastArrayParams): Promise<QueueResult>;
-}
-export type QueueResult = {
-    success: true;
-    jobId: string;
-    source: 'gateway' | 'direct';
-} | {
-    success: false;
-    error: string;
-    source: 'gateway' | 'direct';
-};
-export {};

package/dist/types/index.d.cts

@@ -1,7 +0,0 @@
-export { Nua } from './nua';
-export type { OutputDef, GetOptions, ListOptions, ListResultRow } from './nua';
-export type { LlmBackend, CastResult, CastValueParams, CastArrayParams, NormalizedUsage, GatewayMeta, DirectMeta, CastResultSource, QueueResult, } from './backend/types';
-export type { GatewayConfig } from './backend/gateway';
-export type { DirectConfig, ProviderApiKeys } from './backend/direct';
-export type { AnswerOrigin, LocalAgentId, ModelInput, SchemaEnforcementKind } from './nua-llm-core/index';
-export { z } from 'zod';

package/dist/types/index.d.mts

@@ -1,7 +0,0 @@
-export { Nua } from './nua';
-export type { OutputDef, GetOptions, ListOptions, ListResultRow } from './nua';
-export type { LlmBackend, CastResult, CastValueParams, CastArrayParams, NormalizedUsage, GatewayMeta, DirectMeta, CastResultSource, QueueResult, } from './backend/types';
-export type { GatewayConfig } from './backend/gateway';
-export type { DirectConfig, ProviderApiKeys } from './backend/direct';
-export type { AnswerOrigin, LocalAgentId, ModelInput, SchemaEnforcementKind } from './nua-llm-core/index';
-export { z } from 'zod';

package/dist/types/lib/auth.d.ts

@@ -1,14 +0,0 @@
-export declare const isDevelopmentLikeBrowserEnvironment: () => boolean;
-export type AuthConfig = {
-    apiKey?: string;
-    fetchToken?: () => Promise<string>;
-    dangerouslyAllowBrowserApiKeyInLocalhost?: boolean;
-};
-export declare class AuthTokenManager {
-    private readonly apiKey?;
-    private readonly fetchToken?;
-    private apiToken?;
-    private pendingTokenPromise?;
-    constructor(config: AuthConfig);
-    getToken(): Promise<string>;
-}

package/dist/types/lib/env.d.ts

@@ -1 +0,0 @@
-export declare function resolveConfigValue<T extends Record<string, any>>(config: T, key: keyof T, envVar: string): string | undefined;

package/dist/types/lib/error-response.d.ts

@@ -1,6 +0,0 @@
-export type NuabaseError = {
-    error: string;
-    isError: true;
-    isSuccess?: false;
-};
-export declare function parseErrorResponse(response: Response, urlPath: string): Promise<NuabaseError>;

package/dist/types/lib/error-utils.d.ts

@@ -1,6 +0,0 @@
-/**
- * Safely extracts an error message from an unknown value.
- * @param error The unknown value caught in a catch block.
- * @returns A string representing the error message.
- */
-export declare function getErrorMessageFromException(error: unknown): string;

package/dist/types/local-agent.d.cts

@@ -1,2 +0,0 @@
-export { detectLocalAgents, findLocalAgent, isLocalAgentId, LOCAL_AGENT_IDS, localAgent, } from './nua-llm-core/local-agent';
-export type { LocalAgent, LocalAgentAuthMode, LocalAgentConfig, LocalAgentId, LocalAgentOptions, LocalAgentStatus, } from './nua-llm-core/local-agent';

package/dist/types/local-agent.d.mts

@@ -1,2 +0,0 @@
-export { detectLocalAgents, findLocalAgent, isLocalAgentId, LOCAL_AGENT_IDS, localAgent, } from './nua-llm-core/local-agent';
-export type { LocalAgent, LocalAgentAuthMode, LocalAgentConfig, LocalAgentId, LocalAgentOptions, LocalAgentStatus, } from './nua-llm-core/local-agent';

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

@@ -1,23 +0,0 @@
-export * from "./nua-llm-client";
-export * from "./lib/logger";
-export * from "./lib/types";
-export * from "./lib/nua-errors";
-export { LLM_PROVIDER_IDS, normalizedUsageZero, providerConfigs, } from "./modules/engine/http/provider-config";
-export type { LlmProviderId } from "./modules/engine/http/provider-config";
-export { providerEngines } from "./modules/engine/http/provider-engines";
-export type { ProviderEngines, ProviderEnginesConfig } from "./modules/engine/http/provider-engines";
-export type { EngineRouter, Route } from "./modules/engine/engine-router";
-export type { AnswerOrigin, LlmEngine, SchemaEnforcementKind, } from "./modules/engine/llm-engine";
-export type { LocalAgentId } from "./modules/engine/local-agent/agent-id";
-export { validateJsonSchema } from "./modules/json-schema-validation/validate-json-schema";
-export { stableStringify } from "./lib/stable-stringify";
-export * from "./modules/model-info";
-export * from "./lib/schema-utils";
-export { listSchema, parseListSchema } from "./modules/cast/list-schema";
-export type { ListRowKeys, ListSchema } from "./modules/cast/list-schema";
-export type { CastResult, CastSuccess, CastFailure } from "./modules/cast/run-cast";
-export type { RenderedPrompt } from "./modules/cast/cast-request";
-export type { ToolDefinition, ToolExecutionResult, AgentTool, TextContent, ToolCallContent, AssistantContentBlock, UserMessage, AssistantMessage, ToolResultMessage, ConversationMessage, AgenticParsedResponse, AgentRunParams, AgentCompletionReason, AgentResult, AgentEvent, AgentEventHandler, } from "./modules/agent/types";
-export { runAgent } from "./modules/agent/run-agent";
-export { runAgentLoop } from "./modules/agent/agent-loop";
-export type { SendAgenticRequestFn } from "./modules/agent/agent-loop";

package/dist/types/nua-llm-core/lib/error-utils.d.ts

@@ -1,6 +0,0 @@
-/**
- * Safely extracts an error message from an unknown value.
- * @param error The unknown value caught in a catch block.
- * @returns A string representing the error message.
- */
-export declare function getErrorMessageFromException(error: unknown): string;

package/dist/types/nua-llm-core/lib/logger.d.ts

@@ -1,44 +0,0 @@
-export interface Logger {
-    debug(message: string, context?: object): void;
-    info(message: string, context?: object): void;
-    warn(message: string, context?: object): void;
-    error(message: string, context?: object): void;
-}
-export declare class ConsoleLogger implements Logger {
-    debug(message: string, context?: object): void;
-    info(message: string, context?: object): void;
-    warn(message: string, context?: object): void;
-    error(message: string, context?: object): void;
-}
-export declare const generateSpanId: () => string;
-/**
- * Generic header filtering with allowlist and optional redaction
- */
-export declare function pickHeaders(headers: Record<string, string | string[] | undefined>, allowlist: Set<string>, redactSet?: Set<string>): Record<string, string>;
-/**
- * Error normalization for logging
- */
-export declare function normalizeError(error: unknown): {
-    message: string;
-    stack?: string;
-} | string;
-interface LlmRequestLog {
-    url: string;
-    httpMethod: string;
-    model: string;
-    maxTokens: number;
-}
-interface LlmResponseLog {
-    status: number;
-    responseLength: number;
-    headers: Record<string, string>;
-    usage?: {
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-    };
-}
-export declare const logLlmCallStart: (logger: Logger, spanId: string, service: string, method: string, request: LlmRequestLog) => void;
-export declare const logLlmCallComplete: (logger: Logger, spanId: string, service: string, method: string, response: LlmResponseLog, duration: number) => void;
-export declare const logLlmCallError: (logger: Logger, spanId: string, service: string, method: string, error: unknown, duration: number) => void;
-export {};

package/dist/types/nua-llm-core/lib/nua-errors.d.ts

@@ -1,12 +0,0 @@
-export type NuaError = NuaInternalError | NuaValidationError;
-export type NuaValidationError = {
-    kind: "validation-error";
-    message: string;
-};
-export declare const isNuaValidationError: (a: unknown) => a is NuaValidationError;
-export type NuaInternalError = {
-    kind: "internal-error";
-    message: string;
-};
-export declare const isNuaInternalError: (a: unknown) => a is NuaInternalError;
-export declare const isNuaError: (a: unknown) => a is NuaError;

package/dist/types/nua-llm-core/lib/prompt-template-utils.d.ts

@@ -1,2 +0,0 @@
-export declare const templateVarName: (varName: string) => string;
-export declare const replaceTemplateVarName: (str: string, varName: string, value: string) => string;

package/dist/types/nua-llm-core/lib/schema-utils.d.ts

@@ -1 +0,0 @@
-export type JsonSchema = Record<string, unknown>;

package/dist/types/nua-llm-core/lib/stable-stringify.d.ts

@@ -1 +0,0 @@
-export declare function stableStringify(value: unknown): string;

package/dist/types/nua-llm-core/lib/strict-json-schema.d.ts

@@ -1,7 +0,0 @@
-import { JsonSchema } from "./schema-utils";
-/**
- * Converts a schema to OpenAI strict mode, or returns null when that would
- * change which values are valid (optional properties, open-ended objects,
- * unsupported keywords).
- */
-export declare function toStrictSchema(schema: JsonSchema): JsonSchema | null;

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

@@ -1,8 +0,0 @@
-export type UserDataPKValue = string | number;
-export type MappableInputDataRow = Record<string, unknown>;
-export type MappableInputData = MappableInputDataRow[];
-export type NormalizedUsage = {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-};

package/dist/types/nua-llm-core/lib/validate-mappable-input-data.d.ts

@@ -1,4 +0,0 @@
-import { NuaValidationError } from "./nua-errors";
-export type MappableInputDataRow = Record<string, unknown>;
-export type MappableInputData = MappableInputDataRow[];
-export declare function validateMappableInputData(data: unknown, primaryKey: string | null): NuaValidationError | MappableInputData;

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

@@ -1,7 +0,0 @@
-export { findLocalAgent, localAgent } from "./modules/engine/local-agent/create-local-agent";
-export type { LocalAgentAuthMode, LocalAgentConfig, LocalAgentOptions, } from "./modules/engine/local-agent/create-local-agent";
-export type { LocalAgent } from "./modules/engine/local-agent/local-agent";
-export { detectLocalAgents } from "./modules/engine/local-agent/detect";
-export type { LocalAgentStatus } from "./modules/engine/local-agent/detect";
-export { LOCAL_AGENT_IDS, isLocalAgentId } from "./modules/engine/local-agent/agent-id";
-export type { LocalAgentId } from "./modules/engine/local-agent/agent-id";

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

@@ -1,10 +0,0 @@
-import { AgentEventHandler, AgentResult, AgentTool, AgenticParsedResponse, ConversationMessage } from "./types";
-export type SendAgenticRequestFn = (messages: ConversationMessage[], tools: AgentTool[], systemPrompt?: string) => Promise<AgenticParsedResponse>;
-export declare function runAgentLoop(params: {
-    messages: ConversationMessage[];
-    tools: AgentTool[];
-    systemPrompt?: string;
-    maxTurns: number;
-    sendRequest: SendAgenticRequestFn;
-    onEvent?: AgentEventHandler;
-}): Promise<AgentResult>;

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

@@ -1,17 +0,0 @@
-import { Logger } from "../../lib/logger";
-import { ProviderTarget } from "../engine/http/provider-call";
-import { AgentEventHandler, AgenticParsedResponse, ConversationMessage, ToolDefinition } from "./types";
-export type AgentTurn = {
-    target: ProviderTarget;
-    maxTokens: number;
-    messages: ConversationMessage[];
-    tools: ToolDefinition[];
-    systemPrompt?: string;
-    /** When set, the reply is streamed and reported through it as it arrives. */
-    onEvent?: AgentEventHandler;
-};
-/**
- * Sends one turn of a tool-calling conversation to an LLM provider's HTTP API.
- * Throws when the call fails; the agent loop reports that as the end of the conversation.
- */
-export declare function sendAgentTurn(turn: AgentTurn, logger: Logger): Promise<AgenticParsedResponse>;

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

@@ -1,22 +0,0 @@
-import { ProviderRequestBase } from "../engine/http/provider-config";
-import { AgentEventHandler, AgenticParsedResponse, ConversationMessage, ToolDefinition } from "./types";
-export declare function buildOpenAiAgenticRequest(options: {
-    messages: ConversationMessage[];
-    tools: ToolDefinition[];
-    model: string;
-    maxTokens: number;
-    systemPrompt?: string;
-    stream?: boolean;
-}, baseUrl: string, apiKey: string): ProviderRequestBase;
-export declare function parseOpenAiAgenticResponse(response: Response, errorLabel: string): Promise<AgenticParsedResponse>;
-export declare function buildGeminiAgenticRequest(options: {
-    messages: ConversationMessage[];
-    tools: ToolDefinition[];
-    model: string;
-    maxTokens: number;
-    systemPrompt?: string;
-    stream?: boolean;
-}, apiKey: string): ProviderRequestBase;
-export declare function parseGeminiAgenticResponse(response: Response): Promise<AgenticParsedResponse>;
-export declare function streamOpenAiAgenticResponse(response: Response, errorLabel: string, onEvent?: AgentEventHandler): Promise<AgenticParsedResponse>;
-export declare function streamGeminiAgenticResponse(response: Response, onEvent?: AgentEventHandler): Promise<AgenticParsedResponse>;

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

@@ -1,7 +0,0 @@
-import { ProviderEngines } from "../engine/http/provider-engines";
-import { AgentResult, AgentRunParams } from "./types";
-/**
- * Runs a multi-turn, tool-calling conversation on an LLM provider's API. It needs
- * the providers' API directly, so it takes provider engines rather than any engine router.
- */
-export declare function runAgent(providers: ProviderEngines, params: AgentRunParams): Promise<AgentResult>;