atom-lite 0.1.0 → 0.4.1

package/dist/extensions/discovery.js

@@ -0,0 +1,243 @@
+import { existsSync, readdirSync, readFileSync, statSync, } from "node:fs";
+import { basename, join, resolve } from "node:path";
+const EXTENSION_EXTENSIONS = new Set([".js", ".mjs"]);
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function isExtensionFile(path) {
+    const lower = path.toLowerCase();
+    return lower.endsWith(".js") || lower.endsWith(".mjs");
+}
+function validateManifest(raw, packagePath) {
+    const errors = [];
+    if (!raw || typeof raw !== "object") {
+        return { errors: ["manifest must be an object"] };
+    }
+    const record = raw;
+    const atom = record.atom;
+    if (!atom || typeof atom !== "object") {
+        return { errors: ["missing or invalid \"atom\" field"] };
+    }
+    const atomRecord = atom;
+    const extensionsRaw = atomRecord.extensions;
+    if (!Array.isArray(extensionsRaw) || extensionsRaw.length === 0) {
+        errors.push("\"atom.extensions\" must be a non-empty array of strings");
+    }
+    const extensions = [];
+    if (Array.isArray(extensionsRaw)) {
+        for (const entry of extensionsRaw) {
+            if (typeof entry !== "string" || entry.trim() === "") {
+                errors.push("\"atom.extensions\" entries must be non-empty strings");
+            }
+            else {
+                extensions.push(entry);
+            }
+        }
+    }
+    const capabilities = [];
+    if (atomRecord.capabilities !== undefined) {
+        if (!Array.isArray(atomRecord.capabilities)) {
+            errors.push("\"atom.capabilities\" must be an array of strings");
+        }
+        else {
+            for (const capability of atomRecord.capabilities) {
+                if (typeof capability !== "string") {
+                    errors.push("\"atom.capabilities\" entries must be strings");
+                }
+                else {
+                    capabilities.push(capability);
+                }
+            }
+        }
+    }
+    let engines;
+    if (atomRecord.engines !== undefined) {
+        if (!atomRecord.engines || typeof atomRecord.engines !== "object") {
+            errors.push("\"atom.engines\" must be an object");
+        }
+        else {
+            const engineRecord = atomRecord.engines;
+            if (engineRecord["atom-lite"] !== undefined &&
+                typeof engineRecord["atom-lite"] !== "string") {
+                errors.push("\"atom.engines.atom-lite\" must be a string");
+            }
+            else {
+                engines = { "atom-lite": engineRecord["atom-lite"] };
+            }
+        }
+    }
+    if (errors.length > 0)
+        return { errors };
+    const manifest = {
+        name: typeof record.name === "string" ? record.name : undefined,
+        version: typeof record.version === "string" ? record.version : undefined,
+        extensions,
+        capabilities,
+        engines,
+    };
+    return { manifest, errors: [] };
+}
+function candidate(source, rootPath, entryPath, manifest, errors = []) {
+    return {
+        id: basename(rootPath).replace(/\.(js|mjs)$/i, ""),
+        source,
+        rootPath,
+        entryPath: resolve(entryPath),
+        manifest,
+        errors,
+    };
+}
+function discoverDirectory(source, dir) {
+    const out = [];
+    if (!existsSync(dir))
+        return out;
+    let stat;
+    try {
+        stat = statSync(dir);
+    }
+    catch {
+        return out;
+    }
+    if (!stat.isDirectory())
+        return out;
+    let entries = [];
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return out;
+    }
+    entries.sort();
+    for (const entry of entries) {
+        const fullPath = join(dir, entry);
+        let entryStat;
+        try {
+            entryStat = statSync(fullPath);
+        }
+        catch {
+            continue;
+        }
+        if (entryStat.isFile() && isExtensionFile(fullPath)) {
+            out.push(candidate(source, fullPath, fullPath));
+            continue;
+        }
+        if (!entryStat.isDirectory())
+            continue;
+        const packageJsonPath = join(fullPath, "package.json");
+        if (existsSync(packageJsonPath)) {
+            const rawPackage = readJson(packageJsonPath);
+            const { manifest, errors } = validateManifest(rawPackage, packageJsonPath);
+            if (errors.length > 0) {
+                out.push(candidate(source, fullPath, fullPath, undefined, errors));
+                continue;
+            }
+            if (manifest) {
+                for (const relativeEntry of manifest.extensions) {
+                    const resolvedEntry = resolve(fullPath, relativeEntry);
+                    if (!existsSync(resolvedEntry)) {
+                        out.push(candidate(source, fullPath, resolvedEntry, manifest, [
+                            `extension entry does not exist: ${relativeEntry}`,
+                        ]));
+                    }
+                    else {
+                        out.push(candidate(source, fullPath, resolvedEntry, manifest));
+                    }
+                }
+                continue;
+            }
+        }
+        const indexJs = join(fullPath, "index.js");
+        const indexMjs = join(fullPath, "index.mjs");
+        if (existsSync(indexJs)) {
+            out.push(candidate(source, fullPath, indexJs));
+        }
+        else if (existsSync(indexMjs)) {
+            out.push(candidate(source, fullPath, indexMjs));
+        }
+    }
+    return out;
+}
+function discoverPath(source, inputPath) {
+    if (!existsSync(inputPath))
+        return [];
+    let stat;
+    try {
+        stat = statSync(inputPath);
+    }
+    catch {
+        return [];
+    }
+    if (stat.isFile()) {
+        if (!isExtensionFile(inputPath))
+            return [];
+        return [candidate(source, inputPath, inputPath)];
+    }
+    if (stat.isDirectory()) {
+        // A directory with a package manifest is treated as one package.
+        const packageJsonPath = join(inputPath, "package.json");
+        if (existsSync(packageJsonPath)) {
+            const rawPackage = readJson(packageJsonPath);
+            const { manifest, errors } = validateManifest(rawPackage, packageJsonPath);
+            if (errors.length > 0) {
+                return [candidate(source, inputPath, inputPath, undefined, errors)];
+            }
+            if (manifest) {
+                return manifest.extensions.map((relativeEntry) => {
+                    const resolvedEntry = resolve(inputPath, relativeEntry);
+                    const errors = existsSync(resolvedEntry)
+                        ? []
+                        : [`extension entry does not exist: ${relativeEntry}`];
+                    return candidate(source, inputPath, resolvedEntry, manifest, errors);
+                });
+            }
+        }
+        const indexJs = join(inputPath, "index.js");
+        const indexMjs = join(inputPath, "index.mjs");
+        if (existsSync(indexJs)) {
+            return [candidate(source, inputPath, indexJs)];
+        }
+        if (existsSync(indexMjs)) {
+            return [candidate(source, inputPath, indexMjs)];
+        }
+        return discoverDirectory(source, inputPath);
+    }
+    return [];
+}
+export function discoverExtensions(options = {}) {
+    const out = [];
+    for (const cliPath of options.cliPaths ?? []) {
+        out.push(...discoverPath("cli", cliPath));
+    }
+    if (options.userDir) {
+        out.push(...discoverDirectory("user", options.userDir));
+    }
+    if (options.projectDir) {
+        out.push(...discoverDirectory("project", options.projectDir));
+    }
+    for (const root of options.packageRoots ?? []) {
+        out.push(...discoverDirectory("package", root));
+    }
+    return out;
+}
+export function formatExtensionDiscovery(extensions) {
+    if (extensions.length === 0)
+        return "No extensions found.";
+    return extensions
+        .map((extension) => {
+        const status = extension.errors.length > 0
+            ? `invalid: ${extension.errors.join("; ")}`
+            : "ok";
+        const manifestName = extension.manifest?.name;
+        const label = manifestName
+            ? `${manifestName} (${extension.id})`
+            : extension.id;
+        return `${extension.source}\t${label}\t${extension.entryPath}\t${status}`;
+    })
+        .join("\n");
+}
+//# sourceMappingURL=discovery.js.map

package/dist/extensions/discovery.js.map

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

package/dist/extensions/loader.d.ts

@@ -0,0 +1,27 @@
+import { type DiscoveredExtension } from "./discovery.js";
+import { createExtensionRegistries } from "./api.js";
+export interface ExtensionLoaderOptions {
+    cliPaths?: string[];
+    userDir?: string;
+    projectDir?: string;
+    packageRoots?: string[];
+    trustedProjects?: string[];
+}
+export interface LoadedExtension {
+    id: string;
+    source: string;
+    entryPath: string;
+    status: "loaded" | "error" | "skipped";
+    error?: string;
+    registries: ReturnType<typeof createExtensionRegistries>;
+}
+export declare class ExtensionLoader {
+    private options;
+    private extensions;
+    constructor(options?: ExtensionLoaderOptions);
+    private trustedProjectSet;
+    discover(): DiscoveredExtension[];
+    loadAll(): Promise<LoadedExtension[]>;
+    list(): LoadedExtension[];
+    unloadAll(): Promise<void>;
+}

package/dist/extensions/loader.js

@@ -0,0 +1,113 @@
+import { pathToFileURL } from "node:url";
+import { join } from "node:path";
+import { discoverExtensions } from "./discovery.js";
+import { normalizeProjectPath } from "./trust.js";
+import { loadConfig } from "../config/load.js";
+import { createExtensionAPI, createExtensionRegistries } from "./api.js";
+export class ExtensionLoader {
+    options;
+    extensions = [];
+    constructor(options = {}) {
+        this.options = options;
+    }
+    trustedProjectSet() {
+        const projects = this.options.trustedProjects ??
+            loadConfig().extensions?.trustedProjects ??
+            [];
+        return new Set(projects.map((project) => normalizeProjectPath(project)));
+    }
+    discover() {
+        const trusted = this.trustedProjectSet();
+        const projectExtDir = this.options.projectDir
+            ? join(this.options.projectDir, ".atom-lite", "extensions")
+            : undefined;
+        const discovered = discoverExtensions({
+            cliPaths: this.options.cliPaths,
+            userDir: this.options.userDir,
+            projectDir: projectExtDir,
+            packageRoots: this.options.packageRoots,
+        });
+        return discovered.map((entry) => {
+            if (entry.source === "project" &&
+                !trusted.has(normalizeProjectPath(this.options.projectDir ?? process.cwd()))) {
+                return { ...entry, errors: [...entry.errors, "project is not trusted"] };
+            }
+            return entry;
+        });
+    }
+    async loadAll() {
+        const discovered = this.discover();
+        const loaded = [];
+        for (const entry of discovered) {
+            const registries = createExtensionRegistries();
+            const trusted = this.trustedProjectSet();
+            const ctx = {
+                workspace: this.options.projectDir ?? process.cwd(),
+                trusted: entry.source !== "project" ||
+                    trusted.has(normalizeProjectPath(this.options.projectDir ?? process.cwd())),
+                log: (message) => {
+                    // eslint-disable-next-line no-console
+                    console.error(`[extension:${entry.id}] ${message}`);
+                },
+            };
+            if (entry.errors.length > 0) {
+                loaded.push({
+                    id: entry.id,
+                    source: entry.source,
+                    entryPath: entry.entryPath,
+                    status: "skipped",
+                    error: entry.errors.join("; "),
+                    registries,
+                });
+                continue;
+            }
+            if (entry.source === "project" && !this.trustedProjectSet().has(normalizeProjectPath(this.options.projectDir ?? process.cwd()))) {
+                loaded.push({
+                    id: entry.id,
+                    source: entry.source,
+                    entryPath: entry.entryPath,
+                    status: "skipped",
+                    error: "project is not trusted",
+                    registries,
+                });
+                continue;
+            }
+            try {
+                const moduleUrl = pathToFileURL(entry.entryPath).href;
+                const imported = (await import(moduleUrl));
+                const factory = imported.default ?? imported.activate;
+                if (typeof factory !== "function") {
+                    throw new Error("extension must export a default or activate function");
+                }
+                const api = createExtensionAPI(entry.id, ctx, registries, "current");
+                await factory(api);
+                loaded.push({
+                    id: entry.id,
+                    source: entry.source,
+                    entryPath: entry.entryPath,
+                    status: "loaded",
+                    registries,
+                });
+            }
+            catch (error) {
+                loaded.push({
+                    id: entry.id,
+                    source: entry.source,
+                    entryPath: entry.entryPath,
+                    status: "error",
+                    error: error instanceof Error ? error.message : String(error),
+                    registries,
+                });
+            }
+        }
+        this.extensions = loaded;
+        return loaded;
+    }
+    list() {
+        return [...this.extensions];
+    }
+    async unloadAll() {
+        this.extensions = [];
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/extensions/loader.js.map

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

package/dist/extensions/trust.d.ts

@@ -0,0 +1,4 @@
+export declare function normalizeProjectPath(projectDir: string): string;
+export declare function isProjectTrusted(projectDir: string, configPath?: string): boolean;
+export declare function trustProject(projectDir: string, configPath?: string): void;
+export declare function untrustProject(projectDir: string, configPath?: string): void;

package/dist/extensions/trust.js

@@ -0,0 +1,40 @@
+import { loadConfig } from "../config/load.js";
+import { updateUserConfig } from "../config/write.js";
+import { resolve } from "node:path";
+export function normalizeProjectPath(projectDir) {
+    return resolve(projectDir);
+}
+export function isProjectTrusted(projectDir, configPath) {
+    const config = loadConfig(configPath ? { userConfigPath: configPath } : undefined);
+    const normalized = normalizeProjectPath(projectDir);
+    return (config.extensions?.trustedProjects ?? []).includes(normalized);
+}
+export function trustProject(projectDir, configPath) {
+    const normalized = normalizeProjectPath(projectDir);
+    updateUserConfig((config) => {
+        const extensions = config.extensions && typeof config.extensions === "object"
+            ? config.extensions
+            : {};
+        const trusted = Array.isArray(extensions.trustedProjects)
+            ? [...extensions.trustedProjects]
+            : [];
+        if (!trusted.includes(normalized))
+            trusted.push(normalized);
+        extensions.trustedProjects = trusted;
+        config.extensions = extensions;
+    }, configPath);
+}
+export function untrustProject(projectDir, configPath) {
+    const normalized = normalizeProjectPath(projectDir);
+    updateUserConfig((config) => {
+        const extensions = config.extensions && typeof config.extensions === "object"
+            ? config.extensions
+            : {};
+        const trusted = Array.isArray(extensions.trustedProjects)
+            ? extensions.trustedProjects.filter((path) => path !== normalized)
+            : [];
+        extensions.trustedProjects = trusted;
+        config.extensions = extensions;
+    }, configPath);
+}
+//# sourceMappingURL=trust.js.map

package/dist/extensions/trust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.js","sourceRoot":"","sources":["../../src/extensions/trust.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,UAAkB,EAClB,UAAmB;IAEnB,MAAM,MAAM,GAAG,UAAU,CACvB,UAAU,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CACxD,CAAC;IACF,MAAM,UAAU,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACpD,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,UAAmB;IAClE,MAAM,UAAU,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACpD,gBAAgB,CACd,CAAC,MAAM,EAAE,EAAE;QACT,MAAM,UAAU,GACd,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;YACxD,CAAC,CAAE,MAAM,CAAC,UAAsC;YAChD,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC;YACvD,CAAC,CAAC,CAAC,GAAI,UAAU,CAAC,eAA4B,CAAC;YAC/C,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5D,UAAU,CAAC,eAAe,GAAG,OAAO,CAAC;QACrC,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC,EACD,UAAU,CACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,UAAmB;IACpE,MAAM,UAAU,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACpD,gBAAgB,CACd,CAAC,MAAM,EAAE,EAAE;QACT,MAAM,UAAU,GACd,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;YACxD,CAAC,CAAE,MAAM,CAAC,UAAsC;YAChD,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC;YACvD,CAAC,CAAE,UAAU,CAAC,eAA4B,CAAC,MAAM,CAC7C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,UAAU,CAC9B;YACH,CAAC,CAAC,EAAE,CAAC;QACP,UAAU,CAAC,eAAe,GAAG,OAAO,CAAC;QACrC,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC,EACD,UAAU,CACX,CAAC;AACJ,CAAC"}

package/dist/extensions/types.d.ts

@@ -0,0 +1,52 @@
+export type AtomEvent = "extension_load" | "extension_activate" | "extension_unload" | "extension_error" | "session_start" | "session_end" | "turn_start" | "turn_end" | "tool_call" | "tool_result" | "message" | "context_build" | "config_change";
+export interface ExtensionTool {
+    name: string;
+    label: string;
+    description: string;
+    parameters?: Record<string, unknown>;
+    exposure?: "direct" | "model-only" | "hidden";
+    execute: (args: Record<string, unknown>, ctx: ExtensionContext) => Promise<unknown>;
+}
+export interface ExtensionCommand {
+    name: string;
+    description: string;
+    argumentHint?: string;
+    category?: string;
+    run: (args: string, ctx: ExtensionContext) => void | Promise<void>;
+}
+export interface ExtensionWidget {
+    id: string;
+    location: "aboveInput" | "belowInput" | "footer";
+    render: (width: number) => string[];
+}
+export interface ExtensionContext {
+    workspace: string;
+    trusted: boolean;
+    log: (message: string) => void;
+}
+export interface ExtensionProvider {
+    name: string;
+    config: Record<string, unknown>;
+}
+export interface ExtensionModel {
+    provider: string;
+    id: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface ExecOptions {
+    cwd?: string;
+    timeoutMs?: number;
+}
+export type ExtensionEventHandler = (event: unknown, ctx: ExtensionContext) => unknown | Promise<unknown>;
+export interface ExtensionStatus {
+    id: string;
+    source: string;
+    entryPath: string;
+    status: "loaded" | "error" | "skipped";
+    error?: string;
+}

package/dist/extensions/types.js

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

package/dist/extensions/types.js.map

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

package/dist/index.d.ts

@@ -13,4 +13,5 @@ export * from "./sessions/recovery.js";
 export { OllamaAdapter, OllamaProvider } from "./providers/ollama.js";
 export { GeminiAdapter } from "./providers/gemini.js";
 export { InMemoryToolRegistry } from "./tools/registry.js";
+export * from "./mcp/index.js";
 export * from "./types.js";

package/dist/index.js

@@ -12,5 +12,6 @@ export * from "./sessions/recovery.js";
 export { OllamaAdapter, OllamaProvider } from "./providers/ollama.js";
 export { GeminiAdapter } from "./providers/gemini.js";
 export { InMemoryToolRegistry } from "./tools/registry.js";
+export * from "./mcp/index.js";
 export * from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/mcp/client.d.ts

@@ -0,0 +1,73 @@
+import type { McpRemoteTool, McpTransport } from "./types.js";
+export declare const SUPPORTED_PROTOCOL_VERSIONS: readonly ["2024-11-05", "2025-03-26", "2025-06-18"];
+export declare const PREFERRED_PROTOCOL_VERSION = "2025-06-18";
+export declare class McpError extends Error {
+    readonly code?: number;
+    readonly data?: unknown;
+    constructor(message: string, code?: number, data?: unknown);
+}
+export declare class McpNotConnectedError extends McpError {
+    constructor(message?: string);
+}
+export interface McpClientOptions {
+    clientName?: string;
+    clientVersion?: string;
+    /** Called when the transport closes unexpectedly (not via close()). */
+    onClose?: (info: {
+        code?: number | null;
+        signal?: string | null;
+    }) => void;
+}
+export interface McpRequestOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface McpConnectOptions extends McpRequestOptions {
+    /** Timeout for spawning the transport and completing the handshake. */
+    startupTimeoutMs?: number;
+}
+export interface McpClientConnectResult {
+    protocolVersion: string;
+    serverInfo?: unknown;
+    capabilities?: unknown;
+}
+/**
+ * Small JSON-RPC 2.0 client for MCP. The transport owns framing and process
+ * lifecycle; this class owns request ids, timeouts, cancellation, and
+ * notifications.
+ */
+export declare class McpClient {
+    private readonly transport;
+    private readonly clientName;
+    private readonly clientVersion;
+    private readonly onClose?;
+    private nextId;
+    private pending;
+    private notificationHandlers;
+    private closed;
+    private started;
+    private startPromise?;
+    private protocolVersion?;
+    private serverInfo?;
+    private capabilities?;
+    private lastTransportError?;
+    constructor(transport: McpTransport, options?: McpClientOptions);
+    get protocolVersionValue(): string | undefined;
+    get serverInfoValue(): unknown;
+    get capabilitiesValue(): unknown;
+    get lastError(): Error | undefined;
+    isClosed(): boolean;
+    /** Spawn the transport and perform the MCP initialize handshake. */
+    connect(options?: McpConnectOptions): Promise<McpClientConnectResult>;
+    /** Discover every page of tools/list. */
+    listTools(options?: McpRequestOptions): Promise<McpRemoteTool[]>;
+    callTool(name: string, args: Record<string, unknown>, options?: McpRequestOptions): Promise<unknown>;
+    ping(options?: McpRequestOptions): Promise<unknown>;
+    onNotification(method: string, handler: (params: unknown) => void): () => void;
+    request(method: string, params: unknown, options?: McpRequestOptions): Promise<unknown>;
+    close(): Promise<void>;
+    private sendNotification;
+    private handleMessage;
+    private handleTransportError;
+    private handleClose;
+}