nduka 1.0.0

package/dist/tools/search-orchestrator.js

@@ -0,0 +1,174 @@
+import { loadChatbotConfig } from '../config/chatbot-config.js';
+import { buildWebSearchQueries, webResultsContainRequestedDetail } from '../llm/search-planner.js';
+import { CrunchtrovaClient } from './crunchtrova.js';
+import { normalizeFetchUrl, normalizeToolQuery } from './input-guard.js';
+function compact(value, max = 260) {
+    const cleaned = value.replace(/\s+/g, ' ').trim();
+    return cleaned.length > max ? `${cleaned.slice(0, max - 1)}…` : cleaned;
+}
+function cleanSearchCommandWords(text) {
+    return text
+        .replace(/[“”]/g, '"')
+        .replace(/[‘’]/g, "'")
+        .replace(/^\s*\[voice note\]:\s*/i, ' ')
+        .replace(/\b(yea|yeah|yes|yep|ok|okay|alright|so)\b/gi, ' ')
+        .replace(/\bwhat'?s\s+(?:the\s+)?(?:latest\s+|recent\s+)?(?:news\s+)?about\b/gi, ' ')
+        .replace(/\bwhat\s+is\s+(?:the\s+)?(?:latest\s+|recent\s+)?(?:news\s+)?about\b/gi, ' ')
+        .replace(/\b(hey|hi|hello|yo|man|bro|mate|please|pls)\b/gi, ' ')
+        .replace(/\b(can you|could you|would you|i want you to|help me|let me know|tell me|show me)\b/gi, ' ')
+        .replace(/\b(check online|check the internet|search online|search the web|google it|on google|verify this|check for|and check)\b/gi, ' ')
+        .replace(/^\s*(search|look up|lookup|find|find out|check)\s+/i, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+export function normalizeNewsQuery(text) {
+    const cleaned = cleanSearchCommandWords(text)
+        .replace(/\b20\d{2}-\d{2}-\d{2}\b/g, ' ')
+        .replace(/\b(latest|recent|breaking|update|updates|news|headline|headlines)\b/gi, ' ')
+        .replace(/\b(official source|official)\b/gi, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+    return cleaned || text.replace(/\s+/g, ' ').trim();
+}
+export function buildNewsSearchQueries(query) {
+    const base = normalizeNewsQuery(query);
+    const variants = [
+        base,
+        base.replace(/\b(first lady|wife of the president)\b/gi, 'wife').replace(/\s+/g, ' ').trim(),
+        query.replace(/\b20\d{2}-\d{2}-\d{2}\b/g, ' ').replace(/\b(latest|recent|breaking|update|updates|news|headline|headlines|search)\b/gi, ' ').replace(/\s+/g, ' ').trim(),
+    ].filter((item) => item.length > 2);
+    return Array.from(new Set(variants));
+}
+export class SearchOrchestrator {
+    client;
+    config;
+    lastRun = null;
+    constructor(client = new CrunchtrovaClient(), config = loadChatbotConfig()) {
+        this.client = client;
+        this.config = config;
+    }
+    getLastRun() {
+        return this.lastRun;
+    }
+    async webSearch(query) {
+        const cfg = this.config.tools.web.search;
+        const attempts = [];
+        const normalized = normalizeToolQuery(query);
+        if (!normalized.ok)
+            return this.remember({ ok: false, tool: 'web_search', provider: cfg.provider, query: String(query || ''), results: [], error: normalized.error || 'Invalid search query', diagnostics: { attempts } });
+        query = normalized.value;
+        const all = [];
+        const seen = new Set();
+        if (!cfg.enabled)
+            return this.remember({ ok: false, tool: 'web_search', provider: cfg.provider, query, results: [], error: 'web_search is disabled by config', diagnostics: { attempts } });
+        for (const plannedQuery of buildWebSearchQueries(query)) {
+            const start = Date.now();
+            const rr = await this.client.searchWeb(plannedQuery, cfg.maxResults, this.config.tools.web.fetch.contentLimit || 2000);
+            const status = this.client.getStatus();
+            attempts.push({ tool: 'web_search', provider: cfg.provider, query: plannedQuery, endpoint: status.webPath, ok: !rr.error && rr.results.length > 0, latencyMs: Date.now() - start, resultCount: rr.results.length, error: rr.error });
+            if (rr.error)
+                continue;
+            for (const result of rr.results) {
+                const key = (result.url || result.title || '').toLowerCase();
+                if (!key || seen.has(key))
+                    continue;
+                seen.add(key);
+                all.push(result);
+            }
+            if (webResultsContainRequestedDetail(query, all))
+                break;
+        }
+        if (all.length > 0)
+            return this.remember({ ok: true, tool: 'web_search', provider: cfg.provider, query, results: all.slice(0, cfg.maxResults), diagnostics: { attempts } });
+        if (cfg.fallbackProviders.includes('news')) {
+            const fallback = await this.newsSearch(query, { asFallback: true, inheritedAttempts: attempts });
+            if (fallback.ok)
+                fallback.diagnostics.fallbackUsed = 'news';
+            return fallback;
+        }
+        const error = attempts.map((attempt) => `${attempt.query}: ${attempt.error || 'empty results'}`).join(' | ') || 'empty results';
+        return this.remember({ ok: false, tool: 'web_search', provider: cfg.provider, query, results: [], error, diagnostics: { attempts } });
+    }
+    async newsSearch(query, options = {}) {
+        const cfg = this.config.tools.web.news;
+        const attempts = [...(options.inheritedAttempts || [])];
+        const normalized = normalizeToolQuery(query);
+        if (!normalized.ok)
+            return this.remember({ ok: false, tool: 'news_search', provider: cfg.provider, query: String(query || ''), results: [], error: normalized.error || 'Invalid news query', diagnostics: { attempts } });
+        query = normalized.value;
+        if (!cfg.enabled)
+            return this.remember({ ok: false, tool: 'news_search', provider: cfg.provider, query, results: [], error: 'news_search is disabled by config', diagnostics: { attempts } });
+        for (const plannedQuery of buildNewsSearchQueries(query)) {
+            const start = Date.now();
+            const rr = await this.client.searchNews(plannedQuery, cfg.maxResults, cfg.contentLimit || 1500);
+            const status = this.client.getStatus();
+            attempts.push({ tool: 'news_search', provider: cfg.provider, query: plannedQuery, endpoint: status.newsPath, ok: !rr.error && rr.results.length > 0, latencyMs: Date.now() - start, resultCount: rr.results.length, error: rr.error });
+            if (!rr.error && rr.results.length > 0)
+                return this.remember({ ok: true, tool: 'news_search', provider: cfg.provider, query: plannedQuery, results: rr.results.slice(0, cfg.maxResults), diagnostics: { attempts, fallbackUsed: options.asFallback ? 'news' : undefined } });
+        }
+        const error = attempts.filter((attempt) => attempt.tool === 'news_search').map((attempt) => `${attempt.query}: ${attempt.error || 'empty results'}`).join(' | ') || 'empty results';
+        return this.remember({ ok: false, tool: 'news_search', provider: cfg.provider, query, results: [], error, diagnostics: { attempts } });
+    }
+    async fetchUrl(url) {
+        const cfg = this.config.tools.web.fetch;
+        const attempts = [];
+        const normalized = normalizeFetchUrl(url);
+        if (!normalized.ok)
+            return this.remember({ ok: false, tool: 'url_fetch', provider: cfg.provider, url: String(url || ''), results: [], error: normalized.error || 'Invalid URL', diagnostics: { attempts } });
+        url = normalized.value;
+        if (!cfg.enabled)
+            return this.remember({ ok: false, tool: 'url_fetch', provider: cfg.provider, url, results: [], error: 'url_fetch is disabled by config', diagnostics: { attempts } });
+        const start = Date.now();
+        const rr = await this.client.fetchUrl(url);
+        const status = this.client.getStatus();
+        attempts.push({ tool: 'url_fetch', provider: cfg.provider, url, endpoint: status.fetchPath, ok: !rr.error && Boolean(rr.result), latencyMs: Date.now() - start, resultCount: rr.result ? 1 : 0, error: rr.error });
+        if (rr.result && !rr.error)
+            return this.remember({ ok: true, tool: 'url_fetch', provider: cfg.provider, url, results: [rr.result], diagnostics: { attempts } });
+        return this.remember({ ok: false, tool: 'url_fetch', provider: cfg.provider, url, results: [], error: rr.error || 'No content returned from URL', diagnostics: { attempts } });
+    }
+    formatResult(result) {
+        const diagnostics = this.formatDiagnostics(result);
+        if (!result.ok)
+            return `Tool error: ${result.tool} failed: ${result.error || 'unknown error'}\n\n${diagnostics}`;
+        let body = '';
+        if (result.tool === 'web_search')
+            body = this.client.formatWebResults(result.results);
+        else if (result.tool === 'news_search')
+            body = this.client.formatNewsResults(result.results);
+        else
+            body = this.client.formatFetchResult(result.results[0]);
+        return `${body}\n\n${diagnostics}`;
+    }
+    formatSearchStatus() {
+        const status = this.client.getStatus();
+        const search = this.config.tools.web.search;
+        const news = this.config.tools.web.news;
+        const fetchCfg = this.config.tools.web.fetch;
+        const last = this.lastRun;
+        return [
+            '🔎 *Search / Tool Status*',
+            '',
+            `Provider configured: ${status.configured ? 'yes' : 'no'}`,
+            `Base URL: ${status.baseUrl}`,
+            `Key: ${status.keyMasked}`,
+            `Web: ${search.enabled ? 'on' : 'off'} via ${search.provider}, fallback: ${search.fallbackProviders.join(', ') || 'none'}, timeout: ${search.timeoutSeconds}s`,
+            `News: ${news.enabled ? 'on' : 'off'} via ${news.provider}, fallback: ${news.fallbackProviders.join(', ') || 'none'}, timeout: ${news.timeoutSeconds}s`,
+            `Fetch: ${fetchCfg.enabled ? 'on' : 'off'} via ${fetchCfg.provider}, timeout: ${fetchCfg.timeoutSeconds}s`,
+            `Endpoints: web ${status.webPath}, news ${status.newsPath}, fetch ${status.fetchPath}`,
+            last ? `Last run: ${last.tool} ${last.ok ? 'ok' : 'failed'} (${last.diagnostics.attempts.length} attempt(s))` : 'Last run: none in this process',
+        ].join('\n');
+    }
+    formatDiagnostics(result) {
+        const attempts = result.diagnostics.attempts.slice(-8).map((attempt, index) => {
+            const target = attempt.query || attempt.url || '';
+            const suffix = attempt.error ? ` error=${compact(attempt.error, 160)}` : '';
+            return `${index + 1}. ${attempt.tool}/${attempt.provider}${attempt.endpoint ? ` ${attempt.endpoint}` : ''} ok=${attempt.ok} results=${attempt.resultCount ?? 0} latency=${attempt.latencyMs}ms target="${compact(target, 120)}"${suffix}`;
+        });
+        return ['Tool diagnostics:', ...attempts].join('\n');
+    }
+    remember(result) {
+        this.lastRun = result;
+        return result;
+    }
+}
+//# sourceMappingURL=search-orchestrator.js.map

package/dist/tools/search-orchestrator.js.map

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

package/dist/tools/tool-catalog-config.d.ts

@@ -0,0 +1,103 @@
+export type CatalogProviderAdapter = 'crunchtrova' | 'builtin' | 'custom';
+export type CatalogOperationKind = 'web_search' | 'news_search' | 'url_fetch' | 'media' | 'custom';
+export type CatalogResultMode = 'list' | 'document' | 'json' | 'text';
+export type CatalogInputType = 'string' | 'number' | 'boolean';
+export interface CatalogInputField {
+    type: CatalogInputType;
+    required?: boolean;
+    description?: string;
+}
+export interface CatalogOutputField {
+    type: CatalogInputType | 'object' | 'array';
+    required?: boolean;
+    description?: string;
+}
+export type ToolFailureAction = 'clarify' | 'manual_review' | 'safe_failure';
+export interface CatalogGroundingPolicy {
+    requiresToolResult?: boolean;
+    allowModelEstimates?: boolean;
+    requiredFields?: string[];
+}
+export interface CatalogFailurePolicy {
+    onNoMatch?: ToolFailureAction;
+    onToolError?: ToolFailureAction;
+    onEmptyResult?: ToolFailureAction;
+}
+export interface CatalogToolTimeouts {
+    timeoutSeconds?: number;
+    maxRetries?: number;
+}
+export interface CatalogToolCommands {
+    aliases?: string[];
+    rawAliases?: string[];
+    usage?: string;
+    rawUsage?: string;
+    title?: string;
+    rawTitle?: string;
+    icon?: string;
+}
+export interface CatalogToolClarification {
+    missingRequiredArg?: string;
+    lowConfidence?: string;
+    noMatchingTool?: string;
+}
+export interface CatalogResponsePolicy {
+    checking?: string[];
+    clarify?: string[];
+    manualReview?: string[];
+    blocked?: string[];
+}
+export interface CatalogOperationConfig {
+    kind: CatalogOperationKind;
+    resultMode: CatalogResultMode;
+    timeoutSeconds: number;
+    maxResults: number;
+    paths?: string[];
+}
+export interface CatalogProviderConfig {
+    enabled: boolean;
+    adapter: CatalogProviderAdapter;
+    operations: Record<string, CatalogOperationConfig>;
+}
+export interface CatalogToolConfig {
+    enabled: boolean;
+    description: string;
+    provider: string;
+    operation: string;
+    public: boolean;
+    ownerOnly: boolean;
+    synthesis: boolean;
+    rawAllowed: boolean;
+    asyncEligible: boolean;
+    syncEligible?: boolean;
+    customerCallable?: boolean;
+    requiresApproval?: boolean;
+    requiresIdentity?: boolean;
+    tenantScoped?: boolean;
+    capabilityTags?: string[];
+    outputSchema?: Record<string, CatalogOutputField>;
+    groundingPolicy?: CatalogGroundingPolicy;
+    failurePolicy?: CatalogFailurePolicy;
+    clarification?: CatalogToolClarification;
+    timeouts?: CatalogToolTimeouts;
+    commands?: CatalogToolCommands;
+    aliases: string[];
+    inputSchema: Record<string, CatalogInputField>;
+}
+export interface ToolCatalogConfig {
+    version: number;
+    providers: Record<string, CatalogProviderConfig>;
+    tools: Record<string, CatalogToolConfig>;
+    responses?: CatalogResponsePolicy;
+}
+export interface ResolvedCatalogTool extends CatalogToolConfig {
+    name: string;
+    providerConfig: CatalogProviderConfig;
+    operationConfig: CatalogOperationConfig;
+}
+export declare const DEFAULT_TOOL_CATALOG: ToolCatalogConfig;
+export declare function parseTool(value: unknown, name: string, providers: Record<string, CatalogProviderConfig>): ResolvedCatalogTool;
+export declare function parseToolCatalogConfig(input: unknown): ToolCatalogConfig;
+export declare function loadToolCatalogConfig(path?: string): ToolCatalogConfig;
+export declare function listEnabledCatalogTools(config?: ToolCatalogConfig): ResolvedCatalogTool[];
+//# sourceMappingURL=tool-catalog-config.d.ts.map

package/dist/tools/tool-catalog-config.d.ts.map

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

package/dist/tools/tool-catalog-config.js

@@ -0,0 +1,185 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+export const DEFAULT_TOOL_CATALOG = {
+    version: 1,
+    responses: {
+        checking: ['I’m checking that now.', 'I’ll check the configured source now.', 'Let me verify that with the available lookup.'],
+        clarify: ['I need one more detail before I can check that.', 'Please confirm exactly what you want me to look up.', 'Which specific topic, person, place, account, team, or date should I check?'],
+        manualReview: ['I could not safely confirm this from the available sources, so I have flagged it for review.', 'I could not verify that automatically, so this has been marked for manual review.'],
+        blocked: ['I cannot help with that request.'],
+    },
+    providers: {
+        crunchtrova: {
+            enabled: true,
+            adapter: 'crunchtrova',
+            operations: {
+                web: { kind: 'web_search', resultMode: 'list', timeoutSeconds: 180, maxResults: 5, paths: ['/search/web', '/web/search', '/search', '/tools/google-search', '/tools/google_search', '/tool/google_search', '/google/search', '/search/google'] },
+                news: { kind: 'news_search', resultMode: 'list', timeoutSeconds: 180, maxResults: 5, paths: ['/search/news', '/news/search', '/news', '/tools/news-search', '/tools/news_search', '/tool/news_search'] },
+                fetch: { kind: 'url_fetch', resultMode: 'document', timeoutSeconds: 180, maxResults: 1, paths: ['/fetch/url', '/url/fetch', '/fetch', '/tools/url-search', '/tools/url_search', '/tool/url_search', '/url/search'] },
+            },
+        },
+    },
+    tools: {
+        web_search: {
+            enabled: true,
+            description: 'Search the web for current information.',
+            provider: 'crunchtrova',
+            operation: 'web',
+            public: true,
+            ownerOnly: false,
+            synthesis: true,
+            rawAllowed: true,
+            asyncEligible: true,
+            aliases: ['search'],
+            commands: { aliases: ['search', 's'], rawAliases: ['searchraw', 'sraw'], usage: '/search <query>', rawUsage: '/searchraw <query>', title: 'Web Search', rawTitle: 'Raw Web Search', icon: '🔍' },
+            inputSchema: { query: { type: 'string', required: true, description: 'Search query' } },
+        },
+        news_search: {
+            enabled: true,
+            description: 'Search recent news articles.',
+            provider: 'crunchtrova',
+            operation: 'news',
+            public: true,
+            ownerOnly: false,
+            synthesis: true,
+            rawAllowed: true,
+            asyncEligible: true,
+            aliases: ['news'],
+            commands: { aliases: ['news', 'n'], rawAliases: ['newsraw', 'nraw'], usage: '/news <query>', rawUsage: '/newsraw <query>', title: 'News Search', rawTitle: 'Raw News Search', icon: '📰' },
+            inputSchema: { query: { type: 'string', required: true, description: 'News query' } },
+        },
+        url_fetch: {
+            enabled: true,
+            description: 'Fetch and read a web page.',
+            provider: 'crunchtrova',
+            operation: 'fetch',
+            public: false,
+            ownerOnly: true,
+            synthesis: true,
+            rawAllowed: true,
+            asyncEligible: false,
+            aliases: ['fetch'],
+            commands: { aliases: ['fetch', 'f'], rawAliases: ['fetchraw', 'fraw'], usage: '/fetch <url>', rawUsage: '/fetchraw <url>', title: 'Fetch', rawTitle: 'Raw Fetch', icon: '📄' },
+            inputSchema: { url: { type: 'string', required: true, description: 'URL to fetch' } },
+        },
+    },
+};
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function clone(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function catalogPath() {
+    return process.env.CHATBOT_TOOLS_PATH || process.env.TOOL_CATALOG_PATH || './config/tools.chatbot.json';
+}
+function validateId(value, label) {
+    if (!/^[a-z][a-z0-9_]{0,63}$/.test(value))
+        throw new Error(`Invalid ${label}: ${value}`);
+}
+function normalizePath(value, label) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        throw new Error(`Invalid ${label}: path cannot be empty.`);
+    if (/^https?:\/\//i.test(trimmed))
+        throw new Error(`Invalid ${label}: path must be relative, not a full URL.`);
+    return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+}
+function normalizeOperation(operation, label) {
+    const paths = Array.isArray(operation.paths) ? operation.paths.map((path, index) => normalizePath(path, `${label}.paths[${index}]`)) : undefined;
+    return { ...operation, paths };
+}
+export function parseTool(value, name, providers) {
+    validateId(name, 'tool name');
+    if (!isRecord(value))
+        throw new Error(`Invalid tool config for ${name}: expected object`);
+    const tool = value;
+    if (typeof tool.description !== 'string' || !tool.description.trim())
+        throw new Error(`Tool ${name} must define description.`);
+    validateId(String(tool.provider || ''), `provider for ${name}`);
+    validateId(String(tool.operation || ''), `operation for ${name}`);
+    const providerConfig = providers[tool.provider];
+    if (!providerConfig)
+        throw new Error(`Tool ${name} references unknown provider: ${tool.provider}`);
+    const operationConfig = providerConfig.operations[tool.operation];
+    if (!operationConfig)
+        throw new Error(`Tool ${name} references unknown operation: ${tool.provider}/${tool.operation}`);
+    if (!isRecord(tool.inputSchema))
+        throw new Error(`Tool ${name} must define inputSchema.`);
+    for (const alias of tool.aliases || [])
+        validateId(alias, 'tool alias');
+    for (const alias of tool.commands?.aliases || [])
+        validateId(alias, `command alias for ${name}`);
+    for (const alias of tool.commands?.rawAliases || [])
+        validateId(alias, `raw command alias for ${name}`);
+    return {
+        ...tool,
+        name,
+        providerConfig,
+        operationConfig,
+        aliases: Array.isArray(tool.aliases) ? [...tool.aliases] : [],
+        commands: tool.commands ? { ...tool.commands } : undefined,
+        capabilityTags: Array.isArray(tool.capabilityTags) ? [...tool.capabilityTags] : [],
+    };
+}
+function validateProvider(provider, name) {
+    validateId(name, 'provider name');
+    if (!['crunchtrova', 'builtin', 'custom'].includes(provider.adapter))
+        throw new Error(`Invalid provider adapter for ${name}: ${provider.adapter}`);
+    if (!isRecord(provider.operations))
+        throw new Error(`Provider ${name} must define operations.`);
+    for (const [operationName, operation] of Object.entries(provider.operations)) {
+        validateId(operationName, `operation name for ${name}`);
+        if (!['web_search', 'news_search', 'url_fetch', 'media', 'custom'].includes(operation.kind))
+            throw new Error(`Invalid operation kind for ${name}/${operationName}: ${operation.kind}`);
+        if (!['list', 'document', 'json', 'text'].includes(operation.resultMode))
+            throw new Error(`Invalid result mode for ${name}/${operationName}: ${operation.resultMode}`);
+        if (!Number.isFinite(operation.timeoutSeconds) || operation.timeoutSeconds <= 0)
+            throw new Error(`Invalid timeoutSeconds for ${name}/${operationName}.`);
+        if (!Number.isFinite(operation.maxResults) || operation.maxResults < 0)
+            throw new Error(`Invalid maxResults for ${name}/${operationName}.`);
+        if (operation.paths !== undefined && (!Array.isArray(operation.paths) || operation.paths.length === 0))
+            throw new Error(`Invalid paths for ${name}/${operationName}: expected a non-empty array.`);
+        normalizeOperation(operation, `${name}/${operationName}`);
+    }
+}
+function normalizeCatalog(config) {
+    const cloned = clone(config);
+    for (const provider of Object.values(cloned.providers)) {
+        for (const [operationName, operation] of Object.entries(provider.operations)) {
+            provider.operations[operationName] = normalizeOperation(operation, operationName);
+        }
+    }
+    return cloned;
+}
+export function parseToolCatalogConfig(input) {
+    if (!isRecord(input))
+        throw new Error('Tool catalog config must be an object.');
+    const config = input;
+    if (!isRecord(config.providers))
+        throw new Error('Tool catalog must define providers.');
+    if (!isRecord(config.tools))
+        throw new Error('Tool catalog must define tools.');
+    for (const [name, provider] of Object.entries(config.providers))
+        validateProvider(provider, name);
+    const normalized = normalizeCatalog(config);
+    for (const [name, tool] of Object.entries(normalized.tools))
+        parseTool(tool, name, normalized.providers);
+    return normalized;
+}
+export function loadToolCatalogConfig(path = catalogPath()) {
+    const resolved = resolve(process.cwd(), path);
+    if (!existsSync(resolved))
+        return parseToolCatalogConfig(DEFAULT_TOOL_CATALOG);
+    return parseToolCatalogConfig(JSON.parse(readFileSync(resolved, 'utf-8')));
+}
+export function listEnabledCatalogTools(config = loadToolCatalogConfig()) {
+    const tools = [];
+    for (const [name, tool] of Object.entries(config.tools)) {
+        const resolved = parseTool(tool, name, config.providers);
+        if (resolved.enabled && resolved.providerConfig.enabled)
+            tools.push(resolved);
+    }
+    return tools;
+}
+//# sourceMappingURL=tool-catalog-config.js.map

package/dist/tools/tool-catalog-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-catalog-config.js","sourceRoot":"","sources":["../../src/tools/tool-catalog-config.ts"],"names":[],"mappings":"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"}

package/dist/tools/tool-catalog.d.ts

@@ -0,0 +1,24 @@
+import type { ToolDefinition } from '../tool-runtime/engine.js';
+import { type ResolvedCatalogTool, type ToolCatalogConfig } from './tool-catalog-config.js';
+export interface CatalogToolSummary {
+    name: string;
+    provider: string;
+    operation: string;
+    public: boolean;
+    ownerOnly: boolean;
+    synthesis: boolean;
+    rawAllowed: boolean;
+    aliases: string[];
+}
+export declare class ToolCatalog {
+    private config;
+    constructor(config?: ToolCatalogConfig);
+    reload(config?: ToolCatalogConfig): void;
+    enabledTools(): ResolvedCatalogTool[];
+    names(): string[];
+    summaries(): CatalogToolSummary[];
+    definitions(): ToolDefinition[];
+    findByNameOrAlias(name: string): ResolvedCatalogTool | undefined;
+    formatStatus(): string;
+}
+//# sourceMappingURL=tool-catalog.d.ts.map

package/dist/tools/tool-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-catalog.d.ts","sourceRoot":"","sources":["../../src/tools/tool-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAkD,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE5I,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAaD,qBAAa,WAAW;IACV,OAAO,CAAC,MAAM;gBAAN,MAAM,GAAE,iBAA2C;IAEvE,MAAM,CAAC,MAAM,GAAE,iBAA2C,GAAG,IAAI;IAIjE,YAAY,IAAI,mBAAmB,EAAE;IAIrC,KAAK,IAAI,MAAM,EAAE;IAIjB,SAAS,IAAI,kBAAkB,EAAE;IAajC,WAAW,IAAI,cAAc,EAAE;IAc/B,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAKhE,YAAY,IAAI,MAAM;CAIvB"}

package/dist/tools/tool-catalog.js

@@ -0,0 +1,62 @@
+import { listEnabledCatalogTools, loadToolCatalogConfig } from './tool-catalog-config.js';
+function timeoutMs(seconds) {
+    return Math.max(1_000, Math.min(seconds * 1000, 300_000));
+}
+function outputSchemaFor(tool) {
+    if (tool.operationConfig.resultMode === 'document')
+        return { title: { type: 'string' }, content: { type: 'string' } };
+    if (tool.operationConfig.resultMode === 'json')
+        return { result: { type: 'object' } };
+    if (tool.operationConfig.resultMode === 'text')
+        return { text: { type: 'string' } };
+    return { results: { type: 'object' } };
+}
+export class ToolCatalog {
+    config;
+    constructor(config = loadToolCatalogConfig()) {
+        this.config = config;
+    }
+    reload(config = loadToolCatalogConfig()) {
+        this.config = config;
+    }
+    enabledTools() {
+        return listEnabledCatalogTools(this.config);
+    }
+    names() {
+        return this.enabledTools().map((tool) => tool.name);
+    }
+    summaries() {
+        return this.enabledTools().map((tool) => ({
+            name: tool.name,
+            provider: tool.provider,
+            operation: tool.operation,
+            public: tool.public,
+            ownerOnly: tool.ownerOnly,
+            synthesis: tool.synthesis,
+            rawAllowed: tool.rawAllowed,
+            aliases: [...tool.aliases],
+        }));
+    }
+    definitions() {
+        return this.enabledTools().map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            permission: tool.ownerOnly ? 'admin' : 'read',
+            inputSchema: tool.inputSchema,
+            outputSchema: outputSchemaFor(tool),
+            timeoutMs: timeoutMs(tool.operationConfig.timeoutSeconds),
+            maxRetries: tool.operationConfig.kind === 'url_fetch' ? 1 : 2,
+            tenantScoped: false,
+            requiresApproval: tool.ownerOnly && !tool.public,
+        }));
+    }
+    findByNameOrAlias(name) {
+        const normalized = name.trim();
+        return this.enabledTools().find((tool) => tool.name === normalized || tool.aliases.includes(normalized));
+    }
+    formatStatus() {
+        const rows = this.summaries().map((tool) => `- ${tool.name} -> ${tool.provider}/${tool.operation} (${tool.public ? 'public' : 'owner'}, ${tool.synthesis ? 'synthesis' : 'raw'})`);
+        return ['🧰 *Tool Catalog*', '', ...rows].join('\n');
+    }
+}
+//# sourceMappingURL=tool-catalog.js.map

package/dist/tools/tool-catalog.js.map

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

package/dist/tools/tool-command-synthesis.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Tool command synthesis is disabled in the memory-only chat branch.
+ *
+ * Normal customer chat must not call search/news/fetch synthesis.
+ * Raw owner debug commands can still return raw tool results where allowed.
+ */
+export interface ToolCommandSynthesisInput {
+    toolName: string;
+    toolQuery: string;
+    toolResult: string;
+    userQuestion?: string;
+}
+export type ToolCommandCompletion = (messages: unknown[], target: {
+    provider: string;
+    model: string;
+}) => Promise<string>;
+export declare class ToolCommandSynthesizer {
+    private completion?;
+    constructor(completion?: ToolCommandCompletion | undefined);
+    synthesize(_input: ToolCommandSynthesisInput): Promise<string>;
+}
+//# sourceMappingURL=tool-command-synthesis.d.ts.map

package/dist/tools/tool-command-synthesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-command-synthesis.d.ts","sourceRoot":"","sources":["../../src/tools/tool-command-synthesis.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,qBAAqB,GAAG,CAClC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KACxC,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,qBAAa,sBAAsB;IACrB,OAAO,CAAC,UAAU,CAAC;gBAAX,UAAU,CAAC,EAAE,qBAAqB,YAAA;IAIhD,UAAU,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC;CAKrE"}