@edukors/ai-cli 0.0.0-stage → 0.1.1

package/dist/session.js

@@ -0,0 +1,333 @@
+import { randomUUID } from "node:crypto";
+import { AiCliError, toAiCliError } from "./errors.js";
+const settledWithin = (turn, ms) => Promise.race([turn.settled.then(() => true), new Promise((r) => setTimeout(() => r(false), ms).unref())]);
+export class AiSession {
+    deps;
+    id;
+    appId;
+    documentId;
+    accountId;
+    providerId;
+    _state = "opening";
+    provider = null;
+    /** Identifies the current provider instance; hooks from older ones are ignored. */
+    providerToken = null;
+    _resumeId;
+    turn = null;
+    closing = false;
+    options;
+    listeners = new Set();
+    droppedEvents = 0;
+    constructor(deps) {
+        this.deps = deps;
+        this.id = deps.scope.sessionId;
+        this.appId = deps.scope.appId;
+        this.documentId = deps.scope.documentId;
+        this.accountId = deps.scope.accountId;
+        this.providerId = deps.scope.providerId;
+        this.options = { ...deps.options };
+    }
+    get state() {
+        return this._state;
+    }
+    /** The provider's own conversation id, for applications that persist it to resume later. */
+    get resumeId() {
+        return this._resumeId;
+    }
+    /** Events of this session only. Returns an unsubscribe function. */
+    on(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /** Opens (or reopens) the provider session. Called by the library; reopening happens on demand. */
+    async start(resumeId) {
+        if (this.closing)
+            throw new AiCliError("SESSION_CLOSED", "the session is closed");
+        this._state = "opening";
+        const context = await this.deps.context();
+        context.options = { ...this.options };
+        if (resumeId && this.deps.capabilities.persistentSessions)
+            context.resumeId = resumeId;
+        const token = {};
+        this.providerToken = token;
+        let instance;
+        try {
+            instance = await this.deps.adapter.openSession(context, { exited: (error) => this.providerExited(token, error) });
+        }
+        catch (e) {
+            if (this.providerToken === token)
+                this.providerToken = null;
+            this._state = this.closing ? "closed" : "failed";
+            throw toAiCliError(e, "PROVIDER_START_FAILED");
+        }
+        if (this.closing || this.providerToken !== token) {
+            await instance.close().catch(() => undefined);
+            throw new AiCliError("SESSION_CLOSED", "the session is closed");
+        }
+        this.provider = instance;
+        const resumed = context.resumeId !== undefined && instance.resumeId === context.resumeId;
+        this._resumeId = instance.resumeId ?? this._resumeId;
+        this._state = "idle";
+        this.emit({ type: "sessionOpened", resumed });
+    }
+    /**
+     * Sends a request and resolves when it ends. Failures resolve with
+     * `status: "failed"` and are also emitted as `error` events; only misuse
+     * (a closed or busy session) rejects.
+     */
+    async send(text, options = {}) {
+        if (this.closing)
+            throw new AiCliError("SESSION_CLOSED", "the session is closed");
+        if (this.turn)
+            throw new AiCliError("SESSION_BUSY", "a request is already in progress");
+        const turn = this.newTurn(options.requestId ?? randomUUID());
+        this.turn = turn;
+        this._state = "busy";
+        try {
+            this.emit({ type: "activity", phase: "preparing" }, turn.requestId);
+            if (!this.provider) {
+                await this.start(this._resumeId);
+                this._state = "busy";
+            }
+            if (turn.cancelled)
+                return this.finish(turn, "cancelled");
+            const provider = this.provider;
+            if (!provider)
+                throw new AiCliError("PROVIDER_CRASHED", "the provider stopped before the request started");
+            const outcome = await provider.send({ requestId: turn.requestId, text, ...(options.context !== undefined ? { context: options.context } : {}) }, this.sinkFor(turn));
+            return this.finish(turn, turn.cancelled ? "cancelled" : outcome);
+        }
+        catch (e) {
+            if (turn.cancelled)
+                return this.finish(turn, "cancelled");
+            const error = toAiCliError(e, "PROVIDER_ERROR");
+            if (error.code === "PROVIDER_CRASHED" || error.code === "PROVIDER_START_FAILED")
+                this.dropProvider();
+            this.deps.log.warn(`request failed: ${error.code}`, { message: error.message, cause: error.cause });
+            return this.finish(turn, "failed", error);
+        }
+    }
+    /**
+     * Stops the current request. Resolves once it has settled: already
+     * committed tool calls stay committed, nothing after this point is applied.
+     * A provider that does not stop within the grace period is shut down and
+     * restarted (resumed) on the next request.
+     */
+    async interrupt() {
+        const turn = this.turn;
+        if (!turn)
+            return;
+        if (!turn.cancelled) {
+            turn.cancelled = true;
+            turn.abort.abort();
+            if (!this.closing)
+                this._state = "interrupting";
+            for (const q of turn.questions.values())
+                q.reject(new AiCliError("CANCELLED", "the request was cancelled"));
+            turn.questions.clear();
+            const provider = this.provider;
+            provider?.interrupt().catch((e) => this.deps.log.warn("provider interrupt failed", e));
+            if (!(await settledWithin(turn, this.deps.interruptGraceMs))) {
+                this.deps.log.warn("provider did not stop in time; shutting it down");
+                this.dropProvider();
+                await provider?.close().catch((e) => this.deps.log.warn("provider close failed", e));
+                // A well-behaved adapter settles `send` on close; otherwise settle it here.
+                if (!(await settledWithin(turn, this.deps.interruptGraceMs)))
+                    this.finish(turn, "cancelled");
+            }
+        }
+        await turn.settled;
+    }
+    /** Answers a `question` event. */
+    answer(questionId, answer) {
+        const pending = this.turn?.questions.get(questionId);
+        if (!pending)
+            throw new AiCliError("QUESTION_NOT_FOUND", "no such question is waiting", { meta: { questionId } });
+        this.turn.questions.delete(questionId);
+        pending.resolve(answer);
+    }
+    async updateOptions(options) {
+        if (this.closing)
+            throw new AiCliError("SESSION_CLOSED", "the session is closed");
+        const next = { ...this.options, ...options };
+        if (this.provider) {
+            if (!this.deps.capabilities.liveOptions || !this.provider.updateOptions) {
+                throw new AiCliError("CAPABILITY_UNSUPPORTED", "this provider cannot change options in an open session", { meta: { providerId: this.providerId } });
+            }
+            await this.provider.updateOptions(next);
+        }
+        this.options = next;
+    }
+    async close(reason = "closed") {
+        if (this.closing)
+            return;
+        this.closing = true;
+        await this.interrupt();
+        const provider = this.provider;
+        this.dropProvider();
+        await provider?.close().catch((e) => this.deps.log.warn("provider close failed", e));
+        this._state = "closed";
+        this.emit({ type: "sessionClosed", reason });
+        this.deps.onClosed(this);
+    }
+    /** Counts provider output that arrived for a request no longer current. */
+    get lateEventsDropped() {
+        return this.droppedEvents;
+    }
+    // ---------------------------------------------------------------- internals
+    newTurn(requestId) {
+        let settle;
+        const settled = new Promise((r) => (settle = r));
+        return { requestId, abort: new AbortController(), cancelled: false, result: null, questions: new Map(), settled, settle };
+    }
+    finish(turn, status, error) {
+        if (turn.result)
+            return turn.result;
+        const result = { requestId: turn.requestId, status, ...(error ? { error: error.toJSON() } : {}) };
+        turn.result = result;
+        for (const q of turn.questions.values())
+            q.reject(new AiCliError("CANCELLED", "the request ended"));
+        turn.questions.clear();
+        if (!turn.abort.signal.aborted)
+            turn.abort.abort();
+        if (this.turn === turn)
+            this.turn = null;
+        if (!this.closing)
+            this._state = status === "failed" && !this.provider ? "failed" : "idle";
+        if (status === "completed")
+            this.emit({ type: "turnCompleted" }, turn.requestId);
+        else if (status === "cancelled")
+            this.emit({ type: "cancelled" }, turn.requestId);
+        else
+            this.emit({ type: "error", error: result.error }, turn.requestId);
+        turn.settle();
+        return result;
+    }
+    dropProvider() {
+        this.provider = null;
+        this.providerToken = null;
+    }
+    providerExited(token, error) {
+        if (token !== this.providerToken)
+            return;
+        this.dropProvider();
+        // During a request the adapter rejects `send`, which reports the failure.
+        if (this.turn || this.closing)
+            return;
+        this._state = "failed";
+        const err = toAiCliError(error, "PROVIDER_CRASHED");
+        this.deps.log.warn("provider exited while idle", { code: err.code, message: err.message });
+        this.emit({ type: "error", error: err.toJSON() });
+    }
+    sinkFor(turn) {
+        const live = () => this.turn === turn && !turn.abort.signal.aborted;
+        const drop = (what) => {
+            this.droppedEvents++;
+            this.deps.log.debug(`dropped late ${what}`, { requestId: turn.requestId });
+        };
+        return {
+            signal: turn.abort.signal,
+            text: (delta) => (live() ? this.emit({ type: "textDelta", text: delta }, turn.requestId) : drop("text")),
+            activity: (phase, detail) => (live() ? this.emit({ type: "activity", phase, ...(detail ? { detail } : {}) }, turn.requestId) : drop("activity")),
+            usage: (usage) => (live() ? this.emit({ type: "usageUpdated", usage: { ...usage, observedAt: usage.observedAt ?? new Date().toISOString() } }, turn.requestId) : drop("usage")),
+            callTool: (name, args) => this.callTool(turn, live, name, args),
+            callExternal: (server, tool, args) => this.callExternal(turn, live, server, tool, args),
+            ask: (question) => {
+                if (!live()) {
+                    drop("question");
+                    return Promise.reject(new AiCliError("CANCELLED", "the request is no longer active"));
+                }
+                const questionId = randomUUID();
+                return new Promise((resolve, reject) => {
+                    turn.questions.set(questionId, { resolve, reject });
+                    this.emit({ type: "question", questionId, prompt: question.prompt, ...(question.options ? { options: question.options } : {}) }, turn.requestId);
+                });
+            },
+        };
+    }
+    async callTool(turn, live, name, args) {
+        if (!live()) {
+            this.droppedEvents++;
+            return { content: "The request was cancelled; the tool was not run.", isError: true };
+        }
+        const callId = randomUUID();
+        const tool = this.deps.tools.get(name);
+        this.emit({ type: "toolStarted", callId, tool: name }, turn.requestId);
+        const fail = (code, message) => {
+            this.emit({ type: "toolCompleted", callId, tool: name, ok: false, errorCode: code }, turn.requestId);
+            return { content: message, isError: true };
+        };
+        if (!tool)
+            return fail("TOOL_NOT_FOUND", `Unknown tool: ${name}`);
+        if (args === null || args === undefined)
+            args = {};
+        if (typeof args !== "object" || Array.isArray(args))
+            return fail("TOOL_INVALID_ARGUMENTS", "Tool arguments must be a JSON object.");
+        let value = args;
+        if (tool.validate) {
+            const checked = tool.validate(value);
+            if (!checked.ok)
+                return fail("TOOL_INVALID_ARGUMENTS", `Invalid arguments for ${name}: ${checked.message}`);
+            value = checked.value;
+        }
+        try {
+            const result = await tool.run(value, { documentId: this.documentId, requestId: turn.requestId, callId, signal: turn.abort.signal });
+            // Reported even after an interruption: the application did run it.
+            this.emit({ type: "toolCompleted", callId, tool: name, ok: !result.isError, ...(result.isError ? { errorCode: "TOOL_FAILED" } : {}) }, turn.requestId);
+            return result;
+        }
+        catch (e) {
+            this.deps.log.warn(`tool ${name} threw`, e);
+            return fail(e instanceof AiCliError ? e.code : "TOOL_FAILED", `Tool ${name} failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    async callExternal(turn, live, server, tool, args) {
+        if (!live()) {
+            this.droppedEvents++;
+            return { content: "The request was cancelled; the tool was not run.", isError: true };
+        }
+        const callId = randomUUID();
+        const name = `mcp__${server}__${tool}`;
+        this.emit({ type: "toolStarted", callId, tool: name }, turn.requestId);
+        const fail = (code, message) => {
+            this.emit({ type: "toolCompleted", callId, tool: name, ok: false, errorCode: code }, turn.requestId);
+            return { content: message, isError: true };
+        };
+        if (!this.deps.external?.has(server, tool))
+            return fail("TOOL_NOT_FOUND", `Unknown tool: ${name}`);
+        const input = args && typeof args === "object" && !Array.isArray(args) ? args : {};
+        try {
+            const decision = this.deps.authorize
+                ? await this.deps.authorize({ kind: "mcp", callId, server, tool, input, documentId: this.documentId, requestId: turn.requestId, signal: turn.abort.signal })
+                : { allow: false, message: "This application does not allow calls to MCP servers." };
+            if (!decision.allow)
+                return fail("TOOL_DENIED", decision.message || "The user declined this action.");
+            if (!live())
+                return fail("CANCELLED", "The request was cancelled; the tool was not run.");
+            const result = await this.deps.external.call(server, tool, input);
+            this.emit({ type: "toolCompleted", callId, tool: name, ok: !result.isError, ...(result.isError ? { errorCode: "TOOL_FAILED" } : {}) }, turn.requestId);
+            return result;
+        }
+        catch (e) {
+            this.deps.log.warn(`MCP tool ${name} failed`, e);
+            return fail("TOOL_FAILED", `${name} failed: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    /** Reports the user's MCP servers once the session is open. */
+    reportServers(statuses) {
+        for (const s of statuses)
+            this.emit({ type: "mcpServerStatus", ...s });
+    }
+    emit(body, requestId) {
+        const event = this.deps.publish({ ...this.deps.scope, ...(requestId ? { requestId } : {}), ...body });
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch (e) {
+                this.deps.log.error("session listener threw", e);
+            }
+        }
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/settings.d.ts

@@ -0,0 +1,8 @@
+/**
+ * What an editor's settings screen needs, safe to bundle for a browser or
+ * webview: no Node modules are imported from here.
+ */
+export { parseMcpConfig } from "./mcp/config.js";
+export type { McpProblem, McpProblemCode } from "./mcp/config.js";
+export { TOOL_SERVER_NAME } from "./constants.js";
+export type { McpServerSpec } from "./mcp/external.js";

package/dist/settings.js

@@ -0,0 +1,7 @@
+/**
+ * What an editor's settings screen needs, safe to bundle for a browser or
+ * webview: no Node modules are imported from here.
+ */
+export { parseMcpConfig } from "./mcp/config.js";
+export { TOOL_SERVER_NAME } from "./constants.js";
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/skills.d.ts

@@ -0,0 +1,24 @@
+import type { ToolSpec } from "./tools.js";
+/**
+ * The application's skills: a folder of `<folder>/SKILL.md`, each with a YAML
+ * frontmatter naming and describing it. Claude Code loads them natively; for
+ * providers that would need a shell to read them (Codex), the library serves
+ * them through `read_skill` instead.
+ */
+export interface SkillInfo {
+    folder: string;
+    name: string;
+    description: string;
+}
+/** `name` and `description` from a SKILL.md frontmatter: one-line values, quoted or not, and folded blocks. */
+export declare function frontmatter(text: string): Record<string, string>;
+export declare function listSkills(dir: string): SkillInfo[];
+/**
+ * A file of one skill, `SKILL.md` by default. The path must stay inside that
+ * skill's folder, links included.
+ */
+export declare function readSkillFile(dir: string, skill: string, file?: string): string;
+export declare const READ_SKILL_TOOL = "read_skill";
+export declare const readSkillSpec: ToolSpec;
+/** What the model is told about the skills when it cannot load them natively. */
+export declare function skillsInstructions(skills: SkillInfo[]): string;

package/dist/skills.js

@@ -0,0 +1,91 @@
+import { existsSync, readdirSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+/** `name` and `description` from a SKILL.md frontmatter: one-line values, quoted or not, and folded blocks. */
+export function frontmatter(text) {
+    const m = /^?---\r?\n([\s\S]*?)\r?\n---\s*(?:\r?\n|$)/.exec(text);
+    if (!m)
+        return {};
+    const fields = {};
+    const lines = m[1].split(/\r?\n/);
+    for (let i = 0; i < lines.length; i++) {
+        const kv = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(lines[i]);
+        if (!kv)
+            continue;
+        let value = kv[2].trim();
+        if (/^[>|][+-]?$/.test(value)) {
+            const block = [];
+            while (i + 1 < lines.length && (/^\s+\S/.test(lines[i + 1]) || !lines[i + 1].trim()))
+                block.push(lines[++i].trim());
+            value = value.startsWith(">") ? block.filter(Boolean).join(" ") : block.join("\n").trim();
+        }
+        else if (/^(["']).*\1$/.test(value))
+            value = value.slice(1, -1);
+        fields[kv[1]] = value;
+    }
+    return fields;
+}
+export function listSkills(dir) {
+    if (!existsSync(dir))
+        return [];
+    const skills = [];
+    for (const folder of readdirSync(dir).sort()) {
+        const file = join(dir, folder, "SKILL.md");
+        try {
+            if (folder.startsWith(".") || !statSync(join(dir, folder)).isDirectory() || !existsSync(file))
+                continue;
+            const fields = frontmatter(readFileSync(file, "utf8"));
+            skills.push({ folder, name: fields.name || folder, description: fields.description ?? "" });
+        }
+        catch {
+            /* unreadable: left out */
+        }
+    }
+    return skills;
+}
+const MAX_FILE = 256 << 10;
+/**
+ * A file of one skill, `SKILL.md` by default. The path must stay inside that
+ * skill's folder, links included.
+ */
+export function readSkillFile(dir, skill, file = "SKILL.md") {
+    const found = listSkills(dir).find((s) => s.name === skill || s.folder === skill);
+    if (!found)
+        throw new Error(`there is no skill named "${skill}"`);
+    const root = realpathSync(join(dir, found.folder));
+    if (isAbsolute(file))
+        throw new Error("the file must be a path inside the skill's folder");
+    const target = resolve(root, file);
+    if (!existsSync(target))
+        throw new Error(`the skill has no file "${file}"`);
+    const real = realpathSync(target);
+    const rel = relative(root, real);
+    if (rel.startsWith("..") || isAbsolute(rel) || rel.split(sep).includes(".."))
+        throw new Error("the file must be a path inside the skill's folder");
+    if (!statSync(real).isFile())
+        throw new Error(`"${file}" is not a file`);
+    if (statSync(real).size > MAX_FILE)
+        throw new Error(`"${file}" is too large to read`);
+    return readFileSync(real, "utf8");
+}
+export const READ_SKILL_TOOL = "read_skill";
+export const readSkillSpec = {
+    name: READ_SKILL_TOOL,
+    description: "Reads a skill's instructions (SKILL.md), or another file inside that skill's folder that the instructions mention. Read a skill before following it.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            skill: { type: "string", description: "The skill's name." },
+            file: { type: "string", description: "A path inside the skill's folder; SKILL.md when omitted." },
+        },
+        required: ["skill"],
+        additionalProperties: false,
+    },
+};
+/** What the model is told about the skills when it cannot load them natively. */
+export function skillsInstructions(skills) {
+    if (!skills.length)
+        return "";
+    const lines = skills.map((s) => `- ${s.name}${s.description ? `: ${s.description}` : ""}`);
+    return `# Skills\n\nThese skills are available. When a request matches one, read it first with the \`${READ_SKILL_TOOL}\` tool and follow its instructions; read other files of a skill only when its instructions point to them.\n\n${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

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

package/dist/testing/fakeProvider.d.ts

@@ -0,0 +1,22 @@
+import type { ProviderAdapter } from "../provider.js";
+/**
+ * An adapter for fixtures/fake-ai.mjs. It is written the way a real adapter
+ * is: detection, sign-in and status through short commands, a long-running
+ * process for the session, runtime validation of everything it reads.
+ * Applications can use it to test their integration without any account.
+ */
+export declare const FAKE_CLI_PATH: string;
+export interface FakeProviderOptions {
+    id?: string;
+    /** Defaults to running fixtures/fake-ai.mjs with the current Node. */
+    command?: {
+        file: string;
+        args: string[];
+    };
+    minVersion?: string;
+    multiAccount?: boolean;
+    /** Extra variables for the fake CLI (FAKE_AI_VERSION, FAKE_AI_LOGIN, ...). */
+    env?: Record<string, string>;
+    startupTimeoutMs?: number;
+}
+export declare function createFakeProvider(options?: FakeProviderOptions): ProviderAdapter;