hoolix 0.0.1-beta.19

package/dist/app/contracts.d.ts

@@ -0,0 +1,105 @@
+import type { ServerMetadata } from '../core/registry.js';
+import type { ServerStatus } from '../process/manager.js';
+import type { EmbeddingModel } from '../rag/models.js';
+import type { RAGDiagnostics, SearchResult, TableOfContentsItem } from '../rag/types.js';
+import type { SourceType, IngestionResult } from '../ingestion/types.js';
+import type { AppProgressHandler } from './events.js';
+import type { ServerDefinition, SourceDefinition } from '../sources/types.js';
+export interface CreateServerInput {
+    name: string;
+    url?: string;
+    sources?: SourceDefinition[];
+    definition?: ServerDefinition;
+    templateId?: string;
+    templateInputs?: Record<string, string>;
+    credentials?: Record<string, string>;
+    embeddingModel: EmbeddingModel;
+    maxChunks?: number;
+    maxPages?: number;
+    onProgress?: AppProgressHandler;
+}
+export interface CreateServerResult {
+    meta: ServerMetadata;
+    ingestion: IngestionResult;
+    indexLabel: string;
+    indexWarning?: string;
+}
+export interface ReindexServerInput {
+    slug: string;
+    embeddingModel: EmbeddingModel;
+    maxChunks?: number;
+    maxPages?: number;
+    incremental?: boolean;
+    force?: boolean;
+    onProgress?: AppProgressHandler;
+}
+export interface ReindexServerResult {
+    meta: ServerMetadata;
+    ingestion: IngestionResult;
+    indexLabel: string;
+    indexWarning?: string;
+    skipped?: boolean;
+    reason?: string;
+}
+export interface DeleteServerResult {
+    slug: string;
+    deleted: true;
+}
+export interface ServerListItem extends ServerMetadata {
+    status?: ServerStatus;
+}
+export interface ServerInfoResult {
+    meta: ServerMetadata;
+    status: ServerStatus;
+}
+export interface VerifySample {
+    query: string;
+    hits: number;
+    top: {
+        title?: string;
+        sectionPath?: string;
+        url: string;
+        score?: number;
+    } | null;
+    grounded: boolean;
+    weak: boolean;
+    results: SearchResult[];
+}
+export interface VerifyReport {
+    slug: string;
+    name: string;
+    sourceUrl: string;
+    sourceType: SourceType;
+    chunkCount: number;
+    validation: {
+        valid: boolean;
+        issues: string[];
+    };
+    searchable: boolean;
+    groundingPercent: number;
+    sourceCoveragePercent: number | null;
+    uniqueSourceUrls: number | null;
+    totalChars: number | null;
+    averageChunkChars: number | null;
+    duplicateChunkIds: number | null;
+    weakQueries: string[];
+    ingestion: {
+        pagesProcessed?: number;
+        pagesDiscovered?: number;
+        maxPages?: number;
+        maxChunks?: number;
+        truncated: boolean;
+        note?: string;
+    };
+    samples: VerifySample[];
+    tocEntries: number;
+    tocPreview: TableOfContentsItem[];
+    toc: TableOfContentsItem[];
+    diagnostics: RAGDiagnostics | null;
+    embeddingModel: EmbeddingModel;
+    freshnessUpdatedAt: string;
+    definition: ServerDefinition;
+    sourceCount: number;
+    sourceLabels: string[];
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/app/contracts.d.ts.map

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

package/dist/app/contracts.js

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

package/dist/app/contracts.js.map

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

package/dist/app/events.d.ts

@@ -0,0 +1,13 @@
+import type { IngestionProgress } from '../ingestion/types.js';
+export type AppProgressStage = IngestionProgress['stage'] | 'index' | 'register' | 'credential' | 'delete' | 'verify' | 'done';
+export interface AppProgressEvent {
+    stage: AppProgressStage;
+    message: string;
+    current?: number;
+    total?: number;
+    percent?: number;
+}
+export type AppProgressHandler = (event: AppProgressEvent) => void;
+export declare function emitProgress(handler: AppProgressHandler | undefined, event: AppProgressEvent): void;
+export declare function fromIngestionProgress(progress: IngestionProgress): AppProgressEvent;
+//# sourceMappingURL=events.d.ts.map

package/dist/app/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/app/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,CAAC,OAAO,CAAC,GAC1B,OAAO,GACP,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAEnE,wBAAgB,YAAY,CAC1B,OAAO,EAAE,kBAAkB,GAAG,SAAS,EACvC,KAAK,EAAE,gBAAgB,GACtB,IAAI,CAEN;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,gBAAgB,CAQnF"}

package/dist/app/events.js

@@ -0,0 +1,13 @@
+export function emitProgress(handler, event) {
+    handler?.(event);
+}
+export function fromIngestionProgress(progress) {
+    return {
+        stage: progress.stage,
+        message: progress.message,
+        current: progress.current,
+        total: progress.total,
+        percent: progress.percent,
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/app/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/app/events.ts"],"names":[],"mappings":"AAqBA,MAAM,UAAU,YAAY,CAC1B,OAAuC,EACvC,KAAuB;IAEvB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAA2B;IAC/D,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,OAAO,EAAE,QAAQ,CAAC,OAAO;KAC1B,CAAC;AACJ,CAAC"}

package/dist/app/services/analytics.d.ts

@@ -0,0 +1,42 @@
+export interface AuditEntry extends Record<string, unknown> {
+    ts?: string;
+    tool?: string;
+    query?: string;
+    urlOrPath?: string;
+    hits?: number;
+    found?: boolean;
+    transport?: string;
+}
+export interface StatsReport {
+    slug: string;
+    name: string;
+    days: number;
+    since: string;
+    total: number;
+    byTool: Record<string, number>;
+    byTransport: Record<string, number>;
+    topQueries: Array<{
+        query: string;
+        count: number;
+        zeroHits: number;
+    }>;
+    topPages: Array<{
+        page: string;
+        count: number;
+    }>;
+    health: {
+        avgHitsPerSearch: number;
+        zeroHitSearches: number;
+        rateLimitEvents: number;
+        toolErrors: number;
+        readSuccessRate: number;
+    };
+    dailyActivity: Array<{
+        date: string;
+        count: number;
+    }>;
+    firstActivity: string | null;
+    lastActivity: string | null;
+}
+export declare function getStatsReport(slug: string, days?: number): Promise<StatsReport | null>;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/app/services/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../src/app/services/analytics.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAW,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,UAAU,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,MAAM,EAAE;QACN,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA+FzF"}

package/dist/app/services/analytics.js

@@ -0,0 +1,106 @@
+import path from 'node:path';
+import fs from 'fs-extra';
+import { getServerDataDir } from '../../core/paths.js';
+import { getServerMetadata } from '../../core/registry.js';
+export async function getStatsReport(slug, days = 30) {
+    const meta = await getServerMetadata(slug);
+    const since = new Date(Date.now() - days * 86400_000).toISOString();
+    const auditPath = path.join(getServerDataDir(slug), 'audit.log');
+    let raw = '';
+    try {
+        raw = await fs.readFile(auditPath, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    const allEntries = [];
+    for (const line of raw.split('\n')) {
+        const t = line.trim();
+        if (!t)
+            continue;
+        try {
+            allEntries.push(JSON.parse(t));
+        }
+        catch { }
+    }
+    const entries = allEntries.filter((e) => !e.ts || e.ts >= since);
+    const byTool = {};
+    const byTransport = {};
+    const queryCounts = {};
+    const pageCounts = {};
+    const byDay = {};
+    let rateLimited = 0;
+    let toolErrors = 0;
+    let hitsTotal = 0;
+    let searchCount = 0;
+    let zeroHits = 0;
+    let readCount = 0;
+    let readFound = 0;
+    for (const e of entries) {
+        const tool = String(e.tool || 'unknown');
+        byTool[tool] = (byTool[tool] || 0) + 1;
+        const transport = String(e.transport || 'http');
+        byTransport[transport] = (byTransport[transport] || 0) + 1;
+        if (e.ts)
+            byDay[e.ts.slice(0, 10)] = (byDay[e.ts.slice(0, 10)] || 0) + 1;
+        if (tool === 'search_documentation') {
+            searchCount++;
+            const hits = typeof e.hits === 'number' ? e.hits : 0;
+            hitsTotal += hits;
+            if (hits === 0)
+                zeroHits++;
+            if (typeof e.query === 'string' && e.query.trim()) {
+                const key = e.query.trim().toLowerCase().slice(0, 80);
+                queryCounts[key] ||= { count: 0, zeroHits: 0 };
+                queryCounts[key].count++;
+                if (hits === 0)
+                    queryCounts[key].zeroHits++;
+            }
+        }
+        if (tool === 'read_documentation_page') {
+            readCount++;
+            if (e.found)
+                readFound++;
+            if (typeof e.urlOrPath === 'string' && e.urlOrPath.trim()) {
+                pageCounts[e.urlOrPath.trim()] = (pageCounts[e.urlOrPath.trim()] || 0) + 1;
+            }
+        }
+        if (tool === 'rate_limited')
+            rateLimited++;
+        if (tool === 'tool_error')
+            toolErrors++;
+    }
+    const dailyActivity = [];
+    for (let i = 6; i >= 0; i--) {
+        const d = new Date(Date.now() - i * 86400_000).toISOString().slice(0, 10);
+        dailyActivity.push({ date: d, count: byDay[d] || 0 });
+    }
+    return {
+        slug,
+        name: meta.name,
+        days,
+        since,
+        total: entries.length,
+        byTool,
+        byTransport,
+        topQueries: Object.entries(queryCounts)
+            .sort((a, b) => b[1].count - a[1].count)
+            .slice(0, 10)
+            .map(([query, value]) => ({ query, count: value.count, zeroHits: value.zeroHits })),
+        topPages: Object.entries(pageCounts)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10)
+            .map(([page, count]) => ({ page, count })),
+        health: {
+            avgHitsPerSearch: searchCount > 0 ? Math.round((hitsTotal / searchCount) * 10) / 10 : 0,
+            zeroHitSearches: zeroHits,
+            rateLimitEvents: rateLimited,
+            toolErrors,
+            readSuccessRate: readCount > 0 ? Math.round((readFound / readCount) * 100) : 100,
+        },
+        dailyActivity,
+        firstActivity: allEntries[0]?.ts || null,
+        lastActivity: allEntries[allEntries.length - 1]?.ts || null,
+    };
+}
+//# sourceMappingURL=analytics.js.map

package/dist/app/services/analytics.js.map

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

package/dist/app/services/catalog.d.ts

@@ -0,0 +1,14 @@
+import { type CatalogTemplate } from '../../catalog/templates.js';
+import type { ServerDefinition } from '../../sources/types.js';
+export interface TemplateInstantiation {
+    template: CatalogTemplate;
+    definition: ServerDefinition;
+}
+/**
+ * Returns all templates: official (hardcoded) + community (from ~/.hoolix/templates/*.json).
+ * Sorted alphabetically by name.
+ */
+export declare function listTemplates(): Promise<CatalogTemplate[]>;
+export declare function getTemplate(id: string): Promise<CatalogTemplate>;
+export declare function instantiateTemplate(id: string, inputs?: Record<string, string>): Promise<TemplateInstantiation>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/app/services/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/app/services/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAIhE;AAED,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAMtE;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC,OAAO,CAAC,qBAAqB,CAAC,CAMhC"}

package/dist/app/services/catalog.js

@@ -0,0 +1,26 @@
+import { buildDefinitionFromTemplate, getOfficialTemplates, } from '../../catalog/templates.js';
+import { listCommunityTemplates } from '../../catalog/community.js';
+/**
+ * Returns all templates: official (hardcoded) + community (from ~/.hoolix/templates/*.json).
+ * Sorted alphabetically by name.
+ */
+export async function listTemplates() {
+    const official = getOfficialTemplates();
+    const community = await listCommunityTemplates();
+    return [...official, ...community].sort((a, b) => a.name.localeCompare(b.name));
+}
+export async function getTemplate(id) {
+    const template = (await listTemplates()).find((candidate) => candidate.id === id);
+    if (!template) {
+        throw new Error(`Template "${id}" not found. Next: run "hoolix templates list" to see available templates.`);
+    }
+    return template;
+}
+export async function instantiateTemplate(id, inputs = {}) {
+    const template = await getTemplate(id);
+    return {
+        template,
+        definition: buildDefinitionFromTemplate(template, inputs),
+    };
+}
+//# sourceMappingURL=catalog.js.map

package/dist/app/services/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../src/app/services/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GAErB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAQpE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,QAAQ,GAAI,oBAAoB,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,MAAM,sBAAsB,EAAE,CAAC;IACjD,OAAO,CAAC,GAAG,QAAQ,EAAE,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAU;IAC1C,MAAM,QAAQ,GAAG,CAAC,MAAM,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAClF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,aAAa,EAAE,4EAA4E,CAAC,CAAC;IAC/G,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,EAAU,EACV,SAAiC,EAAE;IAEnC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,EAAE,CAAC,CAAC;IACvC,OAAO;QACL,QAAQ;QACR,UAAU,EAAE,2BAA2B,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC1D,CAAC;AACJ,CAAC"}

package/dist/app/services/credentials.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Credential management for mcp-server kind templates.
+ *
+ * Sensitive values (API tokens, connection strings) are stored in a separate
+ * credentials.json per server with 0600 permissions — never in metadata.json.
+ * The metadata.json only records which credential keys exist (credentialKeys[]).
+ */
+import type { CatalogTemplate } from '../../catalog/templates.js';
+export declare function saveCredentials(slug: string, credentials: Record<string, string>): Promise<void>;
+export declare function loadCredentials(slug: string): Promise<Record<string, string>>;
+export declare function deleteCredentials(slug: string): Promise<void>;
+/**
+ * Set a single credential key. Creates or overwrites the key; leaves others intact.
+ * Updates credentialKeys in server metadata to reflect the new set.
+ */
+export declare function updateCredential(slug: string, key: string, value: string): Promise<string[]>;
+/**
+ * Remove a single credential key. Deletes credentials.json entirely if it becomes empty.
+ * Updates credentialKeys in server metadata.
+ */
+export declare function removeCredential(slug: string, key: string): Promise<string[]>;
+export declare function maskCredentials(credentials: Record<string, string>, template?: CatalogTemplate): Record<string, string>;
+export declare function promptCredentials(template: CatalogTemplate, options?: {
+    provided?: Record<string, string>;
+    env?: NodeJS.ProcessEnv;
+    nonInteractive?: boolean;
+}): Promise<Record<string, string>>;
+export declare function interpolateString(template: string, substitutions: Record<string, string>): string;
+/**
+ * Interpolate {credential} and {input} placeholders in a server run config.
+ * Call at connect/start time with merged inputs + loaded credentials.
+ */
+export declare function interpolateRunConfig(server: {
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+}, substitutions: Record<string, string>): {
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+};
+//# sourceMappingURL=credentials.d.ts.map

package/dist/app/services/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../../src/app/services/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAiBlE,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAanF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,EAAE,CAAC,CASnB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,EAAE,CAAC,CAanB;AAID,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,QAAQ,CAAC,EAAE,eAAe,GACzB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB;AAID,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CACrB,GACL,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAoCjC;AAID,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,EACxE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAQlE"}

package/dist/app/services/credentials.js

@@ -0,0 +1,143 @@
+/**
+ * Credential management for mcp-server kind templates.
+ *
+ * Sensitive values (API tokens, connection strings) are stored in a separate
+ * credentials.json per server with 0600 permissions — never in metadata.json.
+ * The metadata.json only records which credential keys exist (credentialKeys[]).
+ */
+import path from 'node:path';
+import fs from 'fs-extra';
+import { text, isCancel } from '@clack/prompts';
+import { getServerDir } from '../../core/paths.js';
+import { logger } from '../../core/logger.js';
+import { CredentialMissingError } from '../../core/errors.js';
+const CREDENTIALS_FILE = 'credentials.json';
+const CREDENTIALS_MODE = 0o600;
+function getCredentialsPath(slug) {
+    return path.join(getServerDir(slug), CREDENTIALS_FILE);
+}
+function maskValue(value, visible = 6) {
+    if (!value)
+        return '';
+    if (value.length <= visible * 2)
+        return `${value.slice(0, 2)}...`;
+    return `${value.slice(0, visible)}...${value.slice(-visible)}`;
+}
+// ── Persistence ───────────────────────────────────────────────────────────────
+export async function saveCredentials(slug, credentials) {
+    await fs.ensureDir(getServerDir(slug));
+    const credPath = getCredentialsPath(slug);
+    await fs.writeJson(credPath, credentials, { spaces: 2 });
+    // 0600: owner read/write only. No-op on Windows (acceptable; document in PACKAGING).
+    await fs.chmod(credPath, CREDENTIALS_MODE).catch(() => { });
+}
+export async function loadCredentials(slug) {
+    const credPath = getCredentialsPath(slug);
+    if (!(await fs.pathExists(credPath)))
+        return {};
+    try {
+        const raw = await fs.readJson(credPath);
+        if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+            return raw;
+        }
+        return {};
+    }
+    catch {
+        logger.debug(`Failed to load credentials.json for ${slug}`);
+        return {};
+    }
+}
+export async function deleteCredentials(slug) {
+    await fs.remove(getCredentialsPath(slug)).catch(() => { });
+}
+/**
+ * Set a single credential key. Creates or overwrites the key; leaves others intact.
+ * Updates credentialKeys in server metadata to reflect the new set.
+ */
+export async function updateCredential(slug, key, value) {
+    const existing = await loadCredentials(slug);
+    const updated = { ...existing, [key]: value };
+    await saveCredentials(slug, updated);
+    const keys = Object.keys(updated);
+    // Lazily import registry to avoid circular dependency at module load time
+    const { updateServerMetadata } = await import('../../core/registry.js');
+    await updateServerMetadata(slug, { credentialKeys: keys });
+    return keys;
+}
+/**
+ * Remove a single credential key. Deletes credentials.json entirely if it becomes empty.
+ * Updates credentialKeys in server metadata.
+ */
+export async function removeCredential(slug, key) {
+    const existing = await loadCredentials(slug);
+    if (!(key in existing))
+        return Object.keys(existing);
+    delete existing[key];
+    if (Object.keys(existing).length === 0) {
+        await deleteCredentials(slug);
+    }
+    else {
+        await saveCredentials(slug, existing);
+    }
+    const keys = Object.keys(existing);
+    const { updateServerMetadata } = await import('../../core/registry.js');
+    await updateServerMetadata(slug, { credentialKeys: keys });
+    return keys;
+}
+// ── Masking ───────────────────────────────────────────────────────────────────
+export function maskCredentials(credentials, template) {
+    return Object.fromEntries(Object.entries(credentials).map(([key, value]) => {
+        const def = template?.credentials.find((c) => c.name === key);
+        return [key, def?.sensitive !== false ? maskValue(value) : value];
+    }));
+}
+// ── Prompting ─────────────────────────────────────────────────────────────────
+export async function promptCredentials(template, options = {}) {
+    const result = { ...(options.provided ?? {}) };
+    const env = options.env ?? process.env;
+    for (const cred of template.credentials) {
+        if (result[cred.name])
+            continue;
+        // Auto-detect from environment (uses envVar hint, e.g. GITHUB_TOKEN)
+        const fromEnv = cred.envVar ? env[cred.envVar] : undefined;
+        if (fromEnv) {
+            logger.info(`Using ${cred.envVar} from environment for "${cred.label}"`);
+            result[cred.name] = fromEnv;
+            continue;
+        }
+        if (!cred.required)
+            continue;
+        if (options.nonInteractive) {
+            throw new CredentialMissingError(cred.name, cred.envVar);
+        }
+        const hint = cred.validationHint ? ` (${cred.validationHint})` : '';
+        const docsNote = cred.docsUrl ? `\n  Docs: ${cred.docsUrl}` : '';
+        const raw = await text({
+            message: `${cred.label}${hint}${docsNote}`,
+            placeholder: cred.placeholder ?? (cred.sensitive ? '••••••••' : ''),
+            validate: (v) => (v && v.trim().length > 0 ? undefined : `${cred.label} is required`),
+        });
+        if (isCancel(raw)) {
+            // caller handles cancel by catching or checking process exit
+            throw new CredentialMissingError(cred.name, cred.envVar);
+        }
+        result[cred.name] = String(raw).trim();
+    }
+    return result;
+}
+// ── Interpolation ─────────────────────────────────────────────────────────────
+export function interpolateString(template, substitutions) {
+    return template.replace(/\{(\w+)\}/g, (match, key) => substitutions[key] ?? match);
+}
+/**
+ * Interpolate {credential} and {input} placeholders in a server run config.
+ * Call at connect/start time with merged inputs + loaded credentials.
+ */
+export function interpolateRunConfig(server, substitutions) {
+    return {
+        command: server.command,
+        args: server.args.map((arg) => interpolateString(arg, substitutions)),
+        env: Object.fromEntries(Object.entries(server.env).map(([k, v]) => [k, interpolateString(v, substitutions)])),
+    };
+}
+//# sourceMappingURL=credentials.js.map

package/dist/app/services/credentials.js.map

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

package/dist/app/services/servers.d.ts

@@ -0,0 +1,15 @@
+import { type ServerMetadata } from '../../core/registry.js';
+import type { CreateServerInput, CreateServerResult, DeleteServerResult, ReindexServerInput, ReindexServerResult, ServerInfoResult, ServerListItem, VerifyReport } from '../contracts.js';
+export declare function createServer(input: CreateServerInput): Promise<CreateServerResult>;
+export declare function reindexServer(input: ReindexServerInput): Promise<ReindexServerResult>;
+export declare function updateReindexSchedule(slug: string, intervalHours: number | null): Promise<ServerMetadata>;
+export declare function listDueReindexServers(now?: Date): Promise<ServerMetadata[]>;
+export declare function deleteRegisteredServer(slug: string): Promise<DeleteServerResult>;
+export declare function listRegisteredServers(options?: {
+    includeStatus?: boolean;
+}): Promise<ServerListItem[]>;
+export declare function getServerInfo(slug: string): Promise<ServerInfoResult>;
+export declare function getServerLogTail(slug: string, maxChars?: number): Promise<string>;
+export declare function verifyServer(slug: string, queries?: string[]): Promise<VerifyReport>;
+export declare function getServerSourceLabel(meta: ServerMetadata): string;
+//# sourceMappingURL=servers.d.ts.map

package/dist/app/services/servers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"servers.d.ts","sourceRoot":"","sources":["../../../src/app/services/servers.ts"],"names":[],"mappings":"AAGA,OAAO,EASL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAahC,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,YAAY,EAEb,MAAM,iBAAiB,CAAC;AAyMzB,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoDxF;AAyCD,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA2D3F;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,CAQ/G;AAED,wBAAsB,qBAAqB,CAAC,GAAG,OAAa,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAOvF;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAGtF;AAED,wBAAsB,qBAAqB,CAAC,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAYhH;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAI3E;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAQrF;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,WAAqE,GAAG,OAAO,CAAC,YAAY,CAAC,CAyEpJ;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAEjE"}