hoolix 0.0.1-beta.19

package/dist/catalog/templates.js

@@ -0,0 +1,489 @@
+import { z } from 'zod';
+import { SourceDefinitionSchema } from '../sources/types.js';
+// ── Kind ──────────────────────────────────────────────────────────────────────
+export const TemplateKindSchema = z.enum(['docs-rag', 'mcp-server']);
+// ── Inputs (non-sensitive; stored in definition.template.inputs) ──────────────
+export const TemplateInputSchema = z.object({
+    name: z.string().min(1),
+    label: z.string().min(1),
+    description: z.string().min(1),
+    required: z.boolean().default(false),
+    placeholder: z.string().optional(),
+});
+// ── Credentials (sensitive; stored in credentials.json, 0600) ─────────────────
+export const CredentialInputSchema = z.object({
+    name: z.string().regex(/^[a-zA-Z][a-zA-Z0-9_]*$/, 'Must be a valid identifier'),
+    label: z.string().min(1),
+    description: z.string().min(1),
+    envVar: z.string().optional(), // auto-detect from process.env at create time
+    required: z.boolean().default(true),
+    sensitive: z.boolean().default(true),
+    placeholder: z.string().optional(),
+    validationHint: z.string().optional(),
+    docsUrl: z.string().url().optional(),
+});
+// ── Server run config (mcp-server kind only; credentials interpolated at connect) ──
+export const ServerRunConfigSchema = z.object({
+    transport: z.enum(['stdio', 'http']).default('stdio'),
+    command: z.string().min(1),
+    args: z.array(z.string()).default([]),
+    env: z.record(z.string(), z.string()).default({}),
+    npmPackage: z.string().optional(),
+    minNodeVersion: z.string().optional(),
+    proxyable: z.boolean().default(true),
+});
+// ── Template ──────────────────────────────────────────────────────────────────
+export const CatalogTemplateSchema = z.object({
+    id: z.string().regex(/^[a-z0-9-]{1,64}$/),
+    name: z.string().min(1),
+    version: z.string().min(1),
+    kind: TemplateKindSchema.default('docs-rag'),
+    category: z.enum([
+        'docs', 'github', 'tools', 'data', 'productivity', 'ai',
+        'official', 'example', 'community',
+    ]),
+    description: z.string().min(1),
+    tags: z.array(z.string().min(1)).default([]),
+    homepage: z.string().url().optional(),
+    // docs-rag kind: non-sensitive inputs (url, repo, etc.) and pre-baked sources
+    inputs: z.array(TemplateInputSchema).default([]),
+    sources: z.array(SourceDefinitionSchema).default([]),
+    // mcp-server kind: sensitive credentials + run config
+    credentials: z.array(CredentialInputSchema).default([]),
+    server: ServerRunConfigSchema.optional(),
+});
+// ── Official template definitions (14 total: 4 docs-rag + 10 mcp-server) ────────
+const OFFICIAL_TEMPLATES = [
+    // ── docs-rag kind ───────────────────────────────────────────────────────────
+    {
+        id: 'docs-rag',
+        name: 'Documentation RAG MCP',
+        version: '1.0.0',
+        kind: 'docs-rag',
+        category: 'docs',
+        description: 'Turn any documentation URL, llms.txt, or docs page into a grounded Hoolix MCP server.',
+        tags: ['docs', 'llms.txt', 'rag'],
+        inputs: [
+            {
+                name: 'url',
+                label: 'Documentation URL',
+                description: 'A docs page, llms.txt, llms-full.txt, or site URL.',
+                required: true,
+                placeholder: 'https://example.com/llms.txt',
+            },
+        ],
+        credentials: [],
+        sources: [],
+    },
+    {
+        id: 'github-docs',
+        name: 'GitHub Repository Docs MCP',
+        version: '1.0.0',
+        kind: 'docs-rag',
+        category: 'github',
+        description: 'Index README, docs folders, and llms files from a GitHub repository.',
+        tags: ['github', 'repository', 'docs'],
+        inputs: [
+            {
+                name: 'repo',
+                label: 'GitHub repository',
+                description: 'Repository in owner/name form, or a GitHub URL.',
+                required: true,
+                placeholder: 'modelcontextprotocol/servers',
+            },
+        ],
+        credentials: [],
+        sources: [],
+    },
+    {
+        id: 'terraform-aws-docs',
+        name: 'Terraform AWS Docs MCP',
+        version: '1.0.0',
+        kind: 'docs-rag',
+        category: 'official',
+        description: 'A starter MCP server for Terraform AWS provider documentation.',
+        tags: ['terraform', 'aws', 'infrastructure'],
+        inputs: [],
+        credentials: [],
+        sources: [
+            {
+                type: 'docs',
+                url: 'https://registry.terraform.io/providers/hashicorp/aws/latest/docs',
+                label: 'Terraform AWS provider docs',
+            },
+        ],
+    },
+    {
+        id: 'hoolix-docs',
+        name: 'Hoolix Docs MCP',
+        version: '1.0.0',
+        kind: 'docs-rag',
+        category: 'example',
+        description: 'Example template for indexing the Hoolix README from GitHub.',
+        tags: ['hoolix', 'example', 'github'],
+        inputs: [],
+        credentials: [],
+        sources: [
+            {
+                type: 'github',
+                repo: 'JayLLM/hoolix',
+                label: 'JayLLM/hoolix',
+            },
+        ],
+    },
+    // ── mcp-server kind (tools) ─────────────────────────────────────────────────
+    {
+        id: 'filesystem',
+        name: 'Filesystem MCP',
+        version: '1.0.0',
+        kind: 'mcp-server',
+        category: 'tools',
+        description: 'Give AI agents read/write access to local directories via the official MCP filesystem server.',
+        tags: ['filesystem', 'files', 'local', 'official'],
+        homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem',
+        inputs: [
+            {
+                name: 'allowedPath',
+                label: 'Allowed directory path',
+                description: 'Absolute path the AI agent can read and write (e.g. /Users/jay/projects)',
+                required: true,
+                placeholder: '/Users/jay/projects',
+            },
+        ],
+        credentials: [],
+        sources: [],
+        server: {
+            transport: 'stdio',
+            command: 'npx',
+            args: ['-y', '@modelcontextprotocol/server-filesystem@latest', '{allowedPath}'],
+            env: {},
+            npmPackage: '@modelcontextprotocol/server-filesystem',
+            proxyable: true,
+        },
+    },
+    {
+        id: 'github-api',
+        name: 'GitHub API MCP',
+        version: '1.0.0',
+        kind: 'mcp-server',
+        category: 'tools',
+        description: 'Search issues, pull requests, files, and code across GitHub via the official GitHub MCP server.',
+        tags: ['github', 'code', 'issues', 'prs', 'official'],
+        homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/github',
+        inputs: [],
+        credentials: [
+            {
+                name: 'githubToken',
+                label: 'GitHub Personal Access Token',
+                description: 'Token with repo and read:org scopes for accessing repositories',
+                envVar: 'GITHUB_TOKEN',
+                required: true,
+                sensitive: true,
+                placeholder: 'ghp_...',
+                validationHint: 'Scopes: repo, read:org',
+                docsUrl: 'https://github.com/settings/tokens',
+            },
+        ],
+        sources: [],
+        server: {
+            transport: 'stdio',
+            command: 'npx',
+            args: ['-y', '@modelcontextprotocol/server-github@latest'],
+            env: { GITHUB_TOKEN: '{githubToken}' },
+            npmPackage: '@modelcontextprotocol/server-github',
+            proxyable: true,
+        },
+    },
+    {
+        id: 'postgres',
+        name: 'PostgreSQL MCP',
+        version: '1.0.0',
+        kind: 'mcp-server',
+        category: 'data',
+        description: 'Execute read-only SQL queries and inspect schema on PostgreSQL databases via the official MCP server.',
+        tags: ['postgres', 'database', 'sql', 'official'],
+        homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/postgres',
+        inputs: [],
+        credentials: [
+            {
+                name: 'databaseUrl',
+                label: 'PostgreSQL connection URL',
+                description: 'Full connection string including user, password, host, and database name',
+                envVar: 'DATABASE_URL',
+                required: true,
+                sensitive: true,
+                placeholder: 'postgresql://user:pass@localhost:5432/mydb',
+                validationHint: 'Format: postgresql://user:password@host:port/database',
+            },
+        ],
+        sources: [],
+        server: {
+            transport: 'stdio',
+            command: 'npx',
+            args: ['-y', '@modelcontextprotocol/server-postgres@latest', '{databaseUrl}'],
+            env: {},
+            npmPackage: '@modelcontextprotocol/server-postgres',
+            proxyable: true,
+        },
+    },
+    {
+        id: 'sqlite',
+        name: 'SQLite MCP',
+        version: '1.0.0',
+        kind: 'mcp-server',
+        category: 'data',
+        description: 'Query and modify local SQLite databases. Requires Python 3.x and uv (https://docs.astral.sh/uv/).',
+        tags: ['sqlite', 'database', 'sql', 'local', 'official'],
+        homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/sqlite',
+        inputs: [
+            {
+                name: 'dbPath',
+                label: 'Database file path',
+                description: 'Absolute path to the .db or .sqlite file',
+                required: true,
+                placeholder: '/Users/jay/data/mydb.db',
+            },
+        ],
+        credentials: [],
+        sources: [],
+        server: {
+            transport: 'stdio',
+            command: 'uvx',
+            args: ['mcp-server-sqlite', '--db-path', '{dbPath}'],
+            env: {},
+            proxyable: true,
+        },
+    },
+    // ── mcp-server kind (ai) ────────────────────────────────────────────────────
+    {
+        id: 'memory',
+        name: 'Memory MCP',
+        version: '1.0.0',
+        kind: 'mcp-server',
+        category: 'ai',
+        description: 'Persistent in-session memory graph for AI agents using a local knowledge graph.',
+        tags: ['memory', 'knowledge-graph', 'ai', 'official'],
+        homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/memory',
+        inputs: [],
+        credentials: [],
+        sources: [],
+        server: {
+            transport: 'stdio',
+            command: 'npx',
+            args: ['-y', '@modelcontextprotocol/server-memory@latest'],
+            env: {},
+            npmPackage: '@modelcontextprotocol/server-memory',
+            proxyable: true,
+        },
+    },
+    {
+        id: 'sequential-thinking',
+        name: 'Sequential Thinking MCP',
+        version: '1.0.0',
+        kind: 'mcp-server',
+        category: 'ai',
+        description: 'Structured multi-step reasoning tool that breaks complex problems into sequential thoughts with revision support.',
+        tags: ['reasoning', 'thinking', 'ai', 'official'],
+        homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking',
+        inputs: [],
+        credentials: [],
+        sources: [],
+        server: {
+            transport: 'stdio',
+            command: 'npx',
+            args: ['-y', '@modelcontextprotocol/server-sequential-thinking@latest'],
+            env: {},
+            npmPackage: '@modelcontextprotocol/server-sequential-thinking',
+            proxyable: true,
+        },
+    },
+    {
+        id: 'brave-search',
+        name: 'Brave Search MCP',
+        version: '1.0.0',
+        kind: 'mcp-server',
+        category: 'tools',
+        description: 'Web and local search via the Brave Search API. Requires a free Brave Search API key.',
+        tags: ['search', 'web', 'brave', 'official'],
+        homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search',
+        inputs: [],
+        credentials: [
+            {
+                name: 'braveApiKey',
+                label: 'Brave Search API Key',
+                description: 'API key for Brave Search (free tier available)',
+                envVar: 'BRAVE_API_KEY',
+                required: true,
+                sensitive: true,
+                placeholder: 'BSA...',
+                validationHint: 'Get a free key at https://brave.com/search/api/',
+                docsUrl: 'https://brave.com/search/api/',
+            },
+        ],
+        sources: [],
+        server: {
+            transport: 'stdio',
+            command: 'npx',
+            args: ['-y', '@modelcontextprotocol/server-brave-search@latest'],
+            env: { BRAVE_API_KEY: '{braveApiKey}' },
+            npmPackage: '@modelcontextprotocol/server-brave-search',
+            proxyable: true,
+        },
+    },
+    {
+        id: 'slack',
+        name: 'Slack MCP',
+        version: '1.0.0',
+        kind: 'mcp-server',
+        category: 'productivity',
+        description: 'Read channels, threads, and users from Slack workspaces via the official Slack MCP server.',
+        tags: ['slack', 'messaging', 'productivity', 'official'],
+        homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/slack',
+        inputs: [],
+        credentials: [
+            {
+                name: 'slackBotToken',
+                label: 'Slack Bot Token',
+                description: 'Bot token (xoxb-...) with channels:read, users:read scopes',
+                envVar: 'SLACK_BOT_TOKEN',
+                required: true,
+                sensitive: true,
+                placeholder: 'xoxb-...',
+                validationHint: 'Scopes: channels:read, channels:history, users:read',
+                docsUrl: 'https://api.slack.com/authentication/token-types#bot',
+            },
+            {
+                name: 'slackTeamId',
+                label: 'Slack Team ID',
+                description: 'Workspace Team ID (e.g. T01234ABCD), found in your Slack admin settings',
+                envVar: 'SLACK_TEAM_ID',
+                required: true,
+                sensitive: false,
+                placeholder: 'T01234ABCD',
+            },
+        ],
+        sources: [],
+        server: {
+            transport: 'stdio',
+            command: 'npx',
+            args: ['-y', '@modelcontextprotocol/server-slack@latest'],
+            env: {
+                SLACK_BOT_TOKEN: '{slackBotToken}',
+                SLACK_TEAM_ID: '{slackTeamId}',
+            },
+            npmPackage: '@modelcontextprotocol/server-slack',
+            proxyable: true,
+        },
+    },
+    {
+        id: 'puppeteer',
+        name: 'Puppeteer MCP',
+        version: '1.0.0',
+        kind: 'mcp-server',
+        category: 'tools',
+        description: 'Browser automation and web scraping via Puppeteer. Allows AI agents to navigate, screenshot, and interact with web pages.',
+        tags: ['browser', 'puppeteer', 'automation', 'scraping', 'official'],
+        homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/puppeteer',
+        inputs: [],
+        credentials: [],
+        sources: [],
+        server: {
+            transport: 'stdio',
+            command: 'npx',
+            args: ['-y', '@modelcontextprotocol/server-puppeteer@latest'],
+            env: {},
+            npmPackage: '@modelcontextprotocol/server-puppeteer',
+            proxyable: true,
+        },
+    },
+    {
+        id: 'google-maps',
+        name: 'Google Maps MCP',
+        version: '1.0.0',
+        kind: 'mcp-server',
+        category: 'tools',
+        description: 'Geocoding, directions, places search, and map data via the Google Maps Platform API.',
+        tags: ['maps', 'geocoding', 'places', 'google', 'official'],
+        homepage: 'https://github.com/modelcontextprotocol/servers/tree/main/src/google-maps',
+        inputs: [],
+        credentials: [
+            {
+                name: 'googleMapsApiKey',
+                label: 'Google Maps API Key',
+                description: 'API key with Geocoding, Directions, and Places APIs enabled',
+                envVar: 'GOOGLE_MAPS_API_KEY',
+                required: true,
+                sensitive: true,
+                placeholder: 'AIza...',
+                validationHint: 'Enable: Geocoding API, Directions API, Places API',
+                docsUrl: 'https://console.cloud.google.com/apis/credentials',
+            },
+        ],
+        sources: [],
+        server: {
+            transport: 'stdio',
+            command: 'npx',
+            args: ['-y', '@modelcontextprotocol/server-google-maps@latest'],
+            env: { GOOGLE_MAPS_API_KEY: '{googleMapsApiKey}' },
+            npmPackage: '@modelcontextprotocol/server-google-maps',
+            proxyable: true,
+        },
+    },
+];
+// ── Public API ────────────────────────────────────────────────────────────────
+export function getOfficialTemplates() {
+    return OFFICIAL_TEMPLATES.map((t) => CatalogTemplateSchema.parse(t));
+}
+/**
+ * Returns the kind of a template by ID. Defaults to 'docs-rag' for unknown IDs
+ * so existing servers without a template ID continue to work unchanged.
+ */
+export function getTemplateKind(templateId) {
+    const found = OFFICIAL_TEMPLATES.find((t) => t.id === templateId);
+    return found?.kind ?? 'docs-rag';
+}
+export function buildDefinitionFromTemplate(template, inputs = {}) {
+    if (template.kind === 'mcp-server') {
+        // mcp-server kind: sources are empty; inputs stored in template reference for interpolation
+        return {
+            version: 1,
+            sources: [],
+            template: {
+                id: template.id,
+                name: template.name,
+                version: template.version,
+                inputs: Object.keys(inputs).length > 0 ? inputs : undefined,
+            },
+        };
+    }
+    // docs-rag kind (existing behaviour)
+    const sources = template.sources.length > 0
+        ? template.sources
+        : sourcesFromDocsRagInputs(template, inputs);
+    return {
+        version: 1,
+        sources,
+        template: {
+            id: template.id,
+            name: template.name,
+            version: template.version,
+            inputs: Object.keys(inputs).length > 0 ? inputs : undefined,
+        },
+    };
+}
+function sourcesFromDocsRagInputs(template, inputs) {
+    if (template.id === 'docs-rag') {
+        const url = inputs.url;
+        if (!url)
+            throw new Error('Template "docs-rag" requires --url <documentation-url>.');
+        return [{ type: 'docs', url, label: 'docs' }];
+    }
+    if (template.id === 'github-docs') {
+        const repo = inputs.repo;
+        if (!repo)
+            throw new Error('Template "github-docs" requires --repo <owner/name>.');
+        return [{ type: 'github', repo, label: repo }];
+    }
+    throw new Error(`Template "${template.id}" needs sources or an input mapping.`);
+}
+//# sourceMappingURL=templates.js.map

package/dist/catalog/templates.js.map

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

package/dist/commands/audit.d.ts

@@ -0,0 +1,2 @@
+export declare function cmdAudit(args: string[]): Promise<void>;
+//# sourceMappingURL=audit.d.ts.map

package/dist/commands/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"AAiDA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6F5D"}

package/dist/commands/audit.js

@@ -0,0 +1,122 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { logger } from '../core/logger.js';
+import { getServerDataDir } from '../core/paths.js';
+import { printTitle, printSection, printCommand, printDetails, printTable, printJson, } from '../ui/format.js';
+function summarizeAudit(entries) {
+    const chronological = [...entries].sort((a, b) => String(a.ts || '').localeCompare(String(b.ts || '')));
+    const byTool = {};
+    let hitsTotal = 0;
+    let searchCount = 0;
+    let rateLimited = 0;
+    for (const entry of entries) {
+        const tool = String(entry.tool || 'unknown');
+        byTool[tool] = (byTool[tool] || 0) + 1;
+        if (tool === 'rate_limited')
+            rateLimited++;
+        if (tool === 'search_documentation' && typeof entry.hits === 'number') {
+            hitsTotal += entry.hits;
+            searchCount++;
+        }
+    }
+    const topTool = Object.entries(byTool).sort((a, b) => b[1] - a[1])[0]?.[0];
+    return {
+        firstTs: chronological[0]?.ts || null,
+        lastTs: chronological[chronological.length - 1]?.ts || null,
+        byTool,
+        topTool,
+        rateLimited,
+        avgHitsPerSearch: searchCount > 0 ? Math.round((hitsTotal / searchCount) * 10) / 10 : 0,
+    };
+}
+export async function cmdAudit(args) {
+    const slug = args[1];
+    if (!slug) {
+        logger.error('Usage: hoolix audit <slug> [--json] [--limit N] [--tool <name>] [--since <iso-prefix>]');
+        process.exit(1);
+    }
+    const json = args.includes('--json');
+    const limitIdx = args.indexOf('--limit');
+    const limit = limitIdx !== -1 && args[limitIdx + 1] ? parseInt(args[limitIdx + 1], 10) || 50 : 50;
+    const toolIdx = args.indexOf('--tool');
+    const toolFilter = toolIdx !== -1 && args[toolIdx + 1] ? args[toolIdx + 1] : undefined;
+    const sinceIdx = args.indexOf('--since');
+    const sinceFilter = sinceIdx !== -1 && args[sinceIdx + 1] ? args[sinceIdx + 1] : undefined;
+    const auditPath = path.join(getServerDataDir(slug), 'audit.log');
+    let raw = '';
+    try {
+        raw = await fs.readFile(auditPath, 'utf8');
+    }
+    catch {
+        if (json) {
+            printJson({ slug, entries: [], message: 'No audit log yet (server must be started and tools invoked).' });
+        }
+        else {
+            printTitle('Audit Log', slug);
+            console.log(`  No audit.log found for this server.`);
+            console.log(`  Start the server and perform searches/reads to generate entries.`);
+            printCommand(`hoolix start ${slug}`);
+        }
+        return;
+    }
+    const entries = [];
+    for (const line of raw.split('\n')) {
+        const t = line.trim();
+        if (!t)
+            continue;
+        try {
+            const e = JSON.parse(t);
+            if (toolFilter && e.tool !== toolFilter)
+                continue;
+            if (sinceFilter && typeof e.ts === 'string' && !e.ts.startsWith(sinceFilter))
+                continue;
+            entries.push(e);
+        }
+        catch {
+            // skip malformed lines
+        }
+    }
+    entries.sort((a, b) => String(b.ts || '').localeCompare(String(a.ts || '')));
+    const shown = entries.slice(0, limit);
+    const summary = summarizeAudit(entries);
+    if (json) {
+        printJson({ slug, count: entries.length, showing: shown.length, summary, entries: shown });
+        return;
+    }
+    printTitle('Audit Log', slug);
+    printDetails([
+        ['Total entries', entries.length],
+        ['Showing (newest)', shown.length],
+        ['Time range', summary.firstTs && summary.lastTs ? `${summary.firstTs} → ${summary.lastTs}` : 'n/a'],
+        ['Top tool', summary.topTool || 'n/a'],
+        ['Rate limited', summary.rateLimited],
+        ['Avg hits/search', summary.avgHitsPerSearch],
+        ['Log path', auditPath],
+    ]);
+    if (Object.keys(summary.byTool).length > 0) {
+        console.log('');
+        printSection('Summary by tool');
+        printTable(Object.entries(summary.byTool).map(([tool, count]) => ({ tool, count })));
+    }
+    console.log('');
+    if (shown.length === 0) {
+        console.log(`  No matching entries.`);
+        return;
+    }
+    const rows = shown.map((e) => {
+        const q = e.query?.slice(0, 48) || e.urlOrPath?.slice(0, 48) || '';
+        const extra = e.hits != null ? `hits=${e.hits}` : e.found != null ? `found=${e.found}` : e.entries != null ? `entries=${e.entries}` : '';
+        return {
+            ts: String(e.ts || '').replace('T', ' ').replace(/\.\d+Z$/, 'Z'),
+            tool: String(e.tool || ''),
+            details: [q, extra].filter(Boolean).join(' '),
+        };
+    });
+    printTable(rows);
+    console.log('');
+    if (entries.length > limit) {
+        console.log(`  ... ${entries.length - limit} more (use --limit or --json for full)`);
+    }
+    console.log(`  Filters: --tool search_documentation --since 2026- --limit 100`);
+}
+//# sourceMappingURL=audit.js.map

package/dist/commands/audit.js.map

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

package/dist/commands/bundle.d.ts

@@ -0,0 +1,11 @@
+/**
+ * hoolix bundle export [slugs...] --output <file>
+ * hoolix bundle import <file>
+ *
+ * Multi-server bundle: export multiple servers into a single .hoolix.json
+ * file. Credentials are NEVER included — the bundle contains metadata and
+ * chunks only. After import, `hoolix secrets set` commands are printed for
+ * any mcp-server kind servers that require credentials.
+ */
+export declare function cmdBundle(args: string[], json: boolean): Promise<void>;
+//# sourceMappingURL=bundle.d.ts.map