glirastes 0.1.0

package/dist/server/adapters/nextjs/types.d.ts

@@ -0,0 +1,246 @@
+import type { z } from 'zod';
+import type { ToolContext, ToolRegistry, EndpointMethod, UiActionTemplate, UiPattern, ModelTier, AuditEmitter, AiPipeline, FollowupsConfig, PipelineResult, PiiShield, TelemetrySink, PromptOverride } from '../../../types.js';
+import type { Lancer } from '../../lancer/index.js';
+import type { InternalApiCaller } from '../../core/index.js';
+export interface WithAiToolOptions<TInput extends z.ZodTypeAny = z.ZodTypeAny> {
+    toolName: string;
+    id?: string;
+    module?: string;
+    sharedWith?: string[];
+    description: string;
+    method?: EndpointMethod;
+    path?: string;
+    inputSchema: TInput;
+    needsApproval?: boolean;
+    uiActionOnSuccess?: UiActionTemplate;
+    uiPattern?: UiPattern;
+}
+export type AiToolRouteHandler = ((req: Request, context?: {
+    params: Promise<Record<string, string>>;
+}) => Response | Promise<Response>) & {
+    __aiToolMeta?: WithAiToolOptions;
+};
+export type LoadTools = (context: ToolContext & {
+    callEndpoint: InternalApiCaller;
+}) => ToolRegistry | Promise<ToolRegistry>;
+export interface GuardrailResult {
+    ok: boolean;
+    reason?: string;
+    sanitizedMessages?: unknown[];
+}
+export type GuardrailHook = (messages: unknown[]) => GuardrailResult | Promise<GuardrailResult>;
+export interface IntentRoutingResult {
+    toolNames?: string[];
+    systemPromptAddition?: string;
+    maxSteps?: number;
+    contextWindow?: number;
+    modelTier?: ModelTier;
+    metadata?: Record<string, unknown>;
+}
+export type IntentRouter = (latestUserText: string, allToolNames: string[]) => IntentRoutingResult | Promise<IntentRoutingResult>;
+export type StepLimitSource = 'explicit' | 'module' | 'safety';
+export interface StepUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+export interface PipelineStepReport {
+    stepNumber: number;
+    finishReason: string;
+    toolCalls: string[];
+    toolResults: number;
+    requiresApproval: boolean;
+    pendingApprovals: number;
+    summary: string;
+    usage: StepUsage;
+    createdAt: string;
+}
+export type PipelineStreamStatus = 'running' | 'completed' | 'safety-stop' | 'aborted' | 'error';
+export interface PipelineStreamState {
+    status: PipelineStreamStatus;
+    totalSteps: number;
+    finishReason?: string;
+    maxSteps: number;
+    stepLimitSource: StepLimitSource;
+    updatedAt: string;
+    message?: string;
+}
+export interface AiChatHandlerConfig {
+    /**
+     * Static tools (ToolRegistry). Used when pipeline mode is active.
+     * Alternative to loadTools — when both are provided, `tools` takes precedence.
+     */
+    tools?: ToolRegistry;
+    /**
+     * Dynamic tool loader. Used in legacy mode (without pipeline).
+     * When `tools` is provided, loadTools is ignored.
+     */
+    loadTools?: LoadTools;
+    /**
+     * AI Pipeline (Pro feature via glirastes/server).
+     * When provided, replaces guardrails + intentRouter with the pipeline's
+     * process() method. The pipeline handles intent classification, tool
+     * selection, guardrails, and model selection.
+     */
+    pipeline?: AiPipeline;
+    /**
+     * Followups configuration. Pro feature — requires pipeline from glirastes/server.
+     * Only used with pipeline mode.
+     */
+    followups?: FollowupsConfig;
+    /**
+     * Model or model-resolver. Optional when pipeline `ModelSelectorConfig`
+     * entries include an `instance` field — the adapter falls back to
+     * `pipelineResult.model.instance` automatically.
+     */
+    model?: unknown | ((context: {
+        routing?: IntentRoutingResult;
+        pipelineResult?: PipelineResult;
+    }) => unknown);
+    systemPrompt: string | ((context: {
+        routing?: IntentRoutingResult;
+        pipelineResult?: PipelineResult;
+        currentDate: Date;
+    }) => string);
+    locale?: string;
+    uiActionSchema?: z.ZodTypeAny;
+    maxOutputTokens?: number;
+    temperature?: number;
+    /**
+     * Explicit hard cap for reasoning steps.
+     *
+     * When omitted or null, `safetyMaxSteps` is used as a soft safety cap.
+     */
+    maxSteps?: number | null;
+    /**
+     * Safety cap used when no explicit/module maxSteps is defined.
+     *
+     * Defaults to 24 and is intended as a guard against runaway loops,
+     * while users can still stop manually at any time.
+     */
+    safetyMaxSteps?: number;
+    /**
+     * Emit per-step reports as `data-step-report` stream parts.
+     * Enabled by default.
+     */
+    emitStepReports?: boolean;
+    maxContextMessages?: number;
+    /**
+     * Number of recent user/assistant text pairs to include as conversation
+     * history for intent classification. Helps the classifier understand
+     * follow-up messages. Defaults to 4.
+     */
+    maxConversationHistoryPairs?: number;
+    /**
+     * @deprecated Use `pipeline` instead. Ignored when `pipeline` is set.
+     */
+    guardrails?: GuardrailHook;
+    /**
+     * @deprecated Use `pipeline` instead. Ignored when `pipeline` is set.
+     */
+    intentRouter?: IntentRouter;
+    /**
+     * PII Shield instance for anonymization/pseudonymization.
+     * When provided, user messages are anonymized before reaching the LLM,
+     * tool-call arguments are re-hydrated, and responses are de-anonymized.
+     */
+    piiShield?: PiiShield;
+    wrapHandler?: <T>(callback: () => T | Promise<T>, req: Request) => Promise<T>;
+    onError?: (error: unknown, req: Request) => void;
+    onToolError?: (toolId: string, error: unknown) => void;
+    /**
+     * Called after pipeline classification and tool scoping, before streaming.
+     * Use this to log which intent, module, model, and tools were selected.
+     */
+    onPipelineResult?: (result: PipelineResult) => void;
+    onStepReport?: (report: PipelineStepReport) => void;
+    onFinish?: (event: {
+        totalSteps: number;
+        finishReason: string;
+        usage: {
+            inputTokens: number;
+            outputTokens: number;
+            totalTokens: number;
+        };
+        wasTruncated: boolean;
+        maxSteps: number;
+        stepLimitSource: StepLimitSource;
+    }) => void;
+    /**
+     * Unified audit event callback.
+     * Receives all audit events from all SDK packages (server-core, server-pro,
+     * lancer) as well as adapter-level session events.
+     * Forward to your SIEM, logging backend, or compliance store.
+     */
+    onAudit?: AuditEmitter;
+    /**
+     * Remote telemetry sink for forwarding audit events to Glirastes.
+     *
+     * Pass `lancer.telemetry` to enable monitoring on the Glirastes dashboard
+     * — works with both Free and Pro API keys. When combined with `pipeline`,
+     * Pro-tier telemetry is handled by server-pro; this field additionally
+     * forwards adapter-level session events.
+     *
+     * ```typescript
+     * const lancer = createLancer({ apiKey: process.env.GLIRASTES_API_KEY! });
+     * createAiChatHandler({ telemetry: lancer.telemetry, ... });
+     * ```
+     */
+    telemetry?: TelemetrySink;
+    /**
+     * Lancer client for runtime prompt and model overrides (Pro feature).
+     *
+     * When provided, the adapter fetches prompt overrides from Glirastes
+     * via `lancer.config.fetch(['prompts', 'models'])` and merges them with the
+     * local system prompt and model selection based on the classified module.
+     *
+     * For model overrides to work, also provide `modelInstanceFactory`.
+     *
+     * ```typescript
+     * const lancer = createLancer({ apiKey: process.env.GLIRASTES_API_KEY! });
+     * createAiChatHandler({ lancer, pipeline, ... });
+     * ```
+     */
+    lancer?: Lancer;
+    /**
+     * Default model IDs per tier as configured in the consumer app.
+     * Reported to Glirastes on first request so the dashboard can display them.
+     *
+     * ```typescript
+     * createAiChatHandler({
+     *   modelDefaults: { fast: 'openai/gpt-4o-mini', standard: 'openai/gpt-4o', powerful: 'openai/gpt-4o' },
+     *   ...
+     * });
+     * ```
+     */
+    modelDefaults?: Record<string, string>;
+    /**
+     * Factory that turns a modelId string (e.g. "anthropic/claude-sonnet-4")
+     * into a ready-to-use LanguageModel instance.
+     *
+     * Required for Glirastes model overrides to take effect at runtime.
+     * When a model override is configured on the Glirastes dashboard,
+     * this factory creates the replacement model instance.
+     *
+     * ```typescript
+     * const openrouter = createOpenAI({ baseURL: 'https://openrouter.ai/api/v1', apiKey });
+     * createAiChatHandler({ modelInstanceFactory: (id) => openrouter(id), ... });
+     * ```
+     */
+    modelInstanceFactory?: (modelId: string) => unknown;
+}
+export type { PromptOverride };
+export type { AiPipeline, FollowupsConfig, PipelineResult };
+export interface ExecuteToolOptions {
+    toolName: string;
+    input: unknown;
+    tools: ToolRegistry;
+    locale?: string;
+    uiActionSchema?: z.ZodTypeAny;
+}
+export interface ExecuteToolResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    uiAction?: Record<string, unknown>;
+}

package/dist/server/adapters/nextjs/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/adapters/nextjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/server/adapters/nextjs/types.ts"],"names":[],"mappings":""}

package/dist/server/adapters/nextjs/with-ai-tool.d.ts

@@ -0,0 +1,9 @@
+import type { z } from 'zod';
+import type { WithAiToolOptions, AiToolRouteHandler } from './types.js';
+/**
+ * Wraps a Next.js App Router handler with AI tool metadata.
+ * The handler works as before -- metadata is for the codegen scanner.
+ */
+export declare function withAiTool<TInput extends z.ZodTypeAny>(options: WithAiToolOptions<TInput>, handler: (req: Request, context?: {
+    params: Promise<Record<string, string>>;
+}) => Response | Promise<Response>): AiToolRouteHandler;

package/dist/server/adapters/nextjs/with-ai-tool.js

@@ -0,0 +1,10 @@
+/**
+ * Wraps a Next.js App Router handler with AI tool metadata.
+ * The handler works as before -- metadata is for the codegen scanner.
+ */
+export function withAiTool(options, handler) {
+    const decoratedHandler = (req, ctx) => handler(req, ctx);
+    decoratedHandler.__aiToolMeta = options;
+    return decoratedHandler;
+}
+//# sourceMappingURL=with-ai-tool.js.map

package/dist/server/adapters/nextjs/with-ai-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-ai-tool.js","sourceRoot":"","sources":["../../../../src/server/adapters/nextjs/with-ai-tool.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,OAAkC,EAClC,OAGiC;IAEjC,MAAM,gBAAgB,GAAuB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CACxD,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACpB,gBAAgB,CAAC,YAAY,GAAG,OAA4B,CAAC;IAC7D,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/server/core/followup-tool.d.ts

@@ -0,0 +1,9 @@
+import { type Tool, type FollowupsConfig } from '../../types.js';
+/**
+ * Create a followup suggestion tool definition.
+ *
+ * This tool allows the LLM to suggest contextual follow-up actions
+ * at the end of a conversation turn. The frontend renders these as
+ * clickable suggestion chips.
+ */
+export declare function createFollowupTool(config?: FollowupsConfig): Tool | null;

package/dist/server/core/followup-tool.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { defineTool } from '../../types.js';
+// ============================================================================
+// Default Locale (English)
+// ============================================================================
+const DEFAULT_LOCALE = {
+    description: 'Suggest contextual follow-up actions after completing a task.',
+    suggestionHint: 'Formulate suggestions as the user would type them. ' +
+        'Use concrete names/titles from the context instead of generic placeholders.',
+    examples: {
+        good: [
+            'Set deadline for "Prepare meeting"',
+            'Create subtasks for "Prepare meeting"',
+            'Show only high priority tasks',
+        ],
+        bad: [
+            'Perform another action',
+            'Show help',
+        ],
+    },
+};
+// ============================================================================
+// Default Followup Config
+// ============================================================================
+const DEFAULT_COUNT = 3;
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a followup suggestion tool definition.
+ *
+ * This tool allows the LLM to suggest contextual follow-up actions
+ * at the end of a conversation turn. The frontend renders these as
+ * clickable suggestion chips.
+ */
+export function createFollowupTool(config) {
+    const enabled = config?.enabled ?? true;
+    if (!enabled)
+        return null;
+    const count = Math.max(1, Math.min(5, config?.count ?? DEFAULT_COUNT));
+    const locale = config?.locale ?? DEFAULT_LOCALE;
+    const goodExamples = locale.examples?.good
+        ? locale.examples.good.map((e) => `- "${e}"`).join('\n')
+        : '';
+    const badExamples = locale.examples?.bad
+        ? locale.examples.bad.map((e) => `- "${e}"`).join('\n')
+        : '';
+    const description = `${locale.description}
+
+${locale.suggestionHint}
+
+${goodExamples ? `Good examples:\n${goodExamples}\n` : ''}
+${badExamples ? `Avoid:\n${badExamples}\n` : ''}
+Generate exactly ${count} suggestions.
+
+IMPORTANT: After calling this tool, do NOT include the suggestions in your text response. The UI renders them automatically as clickable chips. Your text response should only confirm the completed action — never list or repeat the suggestions.`;
+    const inputSchema = z.object({
+        suggestions: z
+            .array(z.string().min(1).max(200))
+            .min(1)
+            .max(5)
+            .describe(locale.suggestionHint),
+    });
+    return defineTool({
+        id: 'suggest_followups',
+        description,
+        inputSchema,
+        needsApproval: false,
+        execute: async (input) => {
+            const limitedSuggestions = input.suggestions.slice(0, count);
+            return {
+                success: true,
+                followups: limitedSuggestions,
+                _instruction: 'Suggestions registered and will be shown as clickable chips in the UI. ' +
+                    'Do NOT repeat or list them in your text response.',
+            };
+        },
+    });
+}
+//# sourceMappingURL=followup-tool.js.map

package/dist/server/core/followup-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"followup-tool.js","sourceRoot":"","sources":["../../../src/server/core/followup-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAwD,MAAM,gBAAgB,CAAC;AAElG,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E,MAAM,cAAc,GAAmB;IACrC,WAAW,EAAE,+DAA+D;IAC5E,cAAc,EACZ,qDAAqD;QACrD,6EAA6E;IAC/E,QAAQ,EAAE;QACR,IAAI,EAAE;YACJ,oCAAoC;YACpC,uCAAuC;YACvC,+BAA+B;SAChC;QACD,GAAG,EAAE;YACH,wBAAwB;YACxB,WAAW;SACZ;KACF;CACF,CAAC;AAEF,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAwB;IACzD,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC;IACxC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,aAAa,CAAC,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,cAAc,CAAC;IAEhD,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI;QACxC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACxD,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,EAAE,GAAG;QACtC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACvD,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,WAAW,GAAG,GAAG,MAAM,CAAC,WAAW;;EAEzC,MAAM,CAAC,cAAc;;EAErB,YAAY,CAAC,CAAC,CAAC,mBAAmB,YAAY,IAAI,CAAC,CAAC,CAAC,EAAE;EACvD,WAAW,CAAC,CAAC,CAAC,WAAW,WAAW,IAAI,CAAC,CAAC,CAAC,EAAE;mBAC5B,KAAK;;oPAE4N,CAAC;IAEnP,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;QAC3B,WAAW,EAAE,CAAC;aACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC;KACnC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;QAChB,EAAE,EAAE,mBAAmB;QACvB,WAAW;QACX,WAAW;QACX,aAAa,EAAE,KAAK;QACpB,OAAO,EAAE,KAAK,EAAE,KAAkC,EAAE,EAAE;YACpD,MAAM,kBAAkB,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAC7D,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,kBAAkB;gBAC7B,YAAY,EACV,yEAAyE;oBACzE,mDAAmD;aACtD,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/server/core/index.d.ts

@@ -0,0 +1,139 @@
+import type { AiEndpointToolDefinition, AiUiToolDefinition, EndpointMethod, Tool, ToolContext, ToolRegistry, UiPattern, AuditEmitter, TelemetrySink } from '../../types.js';
+import { z } from 'zod';
+export interface InternalApiRequest {
+    method: EndpointMethod;
+    path: string;
+    body?: unknown;
+}
+export interface InternalApiResponse {
+    ok: boolean;
+    status: number;
+    data?: unknown;
+    error?: string;
+}
+export type InternalApiCaller = (request: InternalApiRequest) => Promise<InternalApiResponse>;
+export type NodeIncomingHeaders = Record<string, string | string[] | undefined>;
+export interface FetchInternalApiCallerOptions {
+    baseUrl: string;
+    fetchImpl?: typeof fetch;
+    defaultHeaders?: Record<string, string>;
+}
+export interface NextInternalApiCallerOptions {
+    origin: string;
+    cookieHeader?: string;
+    defaultHeaders?: Record<string, string>;
+    fetchImpl?: typeof fetch;
+}
+export interface ExpressInternalApiCallerOptions {
+    baseUrl: string;
+    reqHeaders?: NodeIncomingHeaders;
+    forwardHeaderNames?: string[];
+    defaultHeaders?: Record<string, string>;
+    fetchImpl?: typeof fetch;
+}
+export interface EndpointToolContext extends ToolContext {
+    callEndpoint: InternalApiCaller;
+}
+/**
+ * Truncate large tool results to prevent LLM context overflow.
+ *
+ * Strategy: find the largest array in the top-level result and
+ * progressively remove items from the end until the serialized
+ * size is under the limit. A `_truncated` object is appended so the
+ * LLM knows the data was cut.
+ */
+export declare function truncateToolResult(result: unknown, maxChars?: number): unknown;
+export declare function buildPath(pathTemplate: string, payload: Record<string, unknown>): string;
+export declare function stripPathParams(pathTemplate: string, payload: Record<string, unknown>): Record<string, unknown>;
+export declare function buildQueryString(payload: Record<string, unknown>): string;
+export declare function applyTemplateValue(value: unknown, input: Record<string, unknown>, responseData: Record<string, unknown>): unknown;
+/**
+ * Build a uiAction from a UiPattern definition + runtime data.
+ */
+export declare function buildUiActionFromPattern(pattern: UiPattern, input: Record<string, unknown>, response: Record<string, unknown>): Record<string, unknown> | undefined;
+/**
+ * Validates and normalizes optional uiAction inside tool results.
+ * Invalid actions are dropped so frontend event handling stays deterministic.
+ *
+ * @param result - Tool execution result (may contain uiAction)
+ * @param uiActionSchema - Zod schema to validate against (from createUiActionSchema)
+ */
+export declare function normalizeResultUiAction(result: unknown, uiActionSchema?: z.ZodTypeAny): unknown;
+/**
+ * Convert an endpoint tool definition into a Tool.
+ * Uses callEndpoint from the ToolContext to execute HTTP requests.
+ */
+export declare function endpointToolToTool<TInput extends z.ZodTypeAny>(endpointTool: AiEndpointToolDefinition<TInput>): Tool;
+/**
+ * Convert an array of endpoint tools into a ToolRegistry.
+ */
+export declare function endpointToolsToRegistry(endpointTools: ReadonlyArray<AiEndpointToolDefinition>): ToolRegistry;
+/**
+ * Convert a UI tool definition into a Tool.
+ * UI tools never call external services — they only produce uiActions.
+ */
+export declare function uiToolToTool<TInput extends z.ZodTypeAny>(uiTool: AiUiToolDefinition<TInput>): Tool;
+/**
+ * Convert an array of UI tools into a ToolRegistry.
+ */
+export declare function uiToolsToRegistry(uiTools: ReadonlyArray<AiUiToolDefinition>): ToolRegistry;
+/**
+ * Options for converting tools to AI SDK tools.
+ */
+export interface ToolToAiToolOptions {
+    /** Zod schema for validating uiActions at runtime */
+    uiActionSchema?: z.ZodTypeAny;
+    /** Called when a tool execution fails */
+    onError?: (toolId: string, error: unknown) => void;
+    /**
+     * When true, validate tool results against outputSchema in dev mode.
+     * Defaults to true when NODE_ENV !== 'production'.
+     */
+    validateOutputSchemas?: boolean;
+    /** Audit event emitter for PCI DSS / compliance logging */
+    onAudit?: AuditEmitter;
+    /** Session ID for audit context */
+    sessionId?: string;
+    /** Trace ID for correlating events within a single request */
+    traceId?: string;
+    /**
+     * Remote telemetry sink for forwarding audit events to Glirastes.
+     * Compatible with `lancer.telemetry`. Fire-and-forget — never blocks
+     * tool execution. Enables monitoring dashboard for Free-tier users.
+     */
+    telemetry?: TelemetrySink;
+}
+/**
+ * Convert a Tool to an AI SDK-compatible tool object.
+ *
+ * Returns a plain object with `description`, `parameters`, `execute` that
+ * can be passed to any AI SDK that follows the Vercel AI SDK convention.
+ *
+ * @param tool - The tool to convert
+ * @param context - Runtime context (currentDate, locale, runtime)
+ * @param toolName - Override tool name (defaults to tool.id)
+ * @param options - Additional options
+ */
+export declare function toolToAiTool(tool: Tool, context: ToolContext, toolName?: string, options?: ToolToAiToolOptions): {
+    _toolId: string;
+    description: string;
+    parameters: z.ZodType<any, z.ZodTypeDef, any>;
+    needsApproval: ((input: unknown) => Promise<boolean>) | undefined;
+    execute: (input: unknown) => Promise<unknown>;
+};
+/**
+ * Convert a registry of tools to AI SDK tools.
+ * The SDK does not perform authorization — the backend API that each tool
+ * calls is responsible for permission enforcement.
+ */
+export declare function toolsToAiTools(registry: ToolRegistry, context: ToolContext, options?: ToolToAiToolOptions): Record<string, ReturnType<typeof toolToAiTool>>;
+export declare function normalizeNodeHeaders(headers: NodeIncomingHeaders, allowedHeaderNames?: string[]): Record<string, string>;
+export declare function createFetchInternalApiCaller(options: FetchInternalApiCallerOptions): InternalApiCaller;
+export declare function createNextInternalApiCaller(options: NextInternalApiCallerOptions): InternalApiCaller;
+export declare function createExpressInternalApiCaller(options: ExpressInternalApiCallerOptions): InternalApiCaller;
+export { zodToCompactDescription } from './zod-compact.js';
+export { createFollowupTool } from './followup-tool.js';
+export { defineModule, createAiRouter } from './module-router.js';
+export { createModelSelector, createModelSelectorFromMap } from './model-selector.js';
+export { createIntentClassifier, tokenize, jaccardSimilarity, classifyWithHeuristics, buildClassificationPrompt, parseJsonResponse, } from './intent-classifier.js';
+export type { LocalClassifierConfig } from './intent-classifier.js';