chivgent 0.6.0

package/dist/session-store.js

@@ -0,0 +1,183 @@
+import { appendFile, mkdir, readFile, readdir, stat } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+export const SESSION_FORMAT_VERSION = 1;
+const SESSION_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+const SESSIONS_DIRECTORY = "sessions";
+const DEFAULT_LIST_LIMIT = 20;
+export function defaultSessionHome(environment = process.env) {
+    const configured = environment.CHIVGENT_HOME;
+    return configured !== undefined && configured.length > 0
+        ? configured
+        : path.join(os.homedir(), ".chivgent");
+}
+export function createSessionId(now = new Date()) {
+    const stamp = now.toISOString().replaceAll(/[:.]/g, "-");
+    return `${stamp}-${Math.random().toString(36).slice(2, 8)}`;
+}
+/**
+ * Appends session records as JSON lines under `<home>/sessions/<id>.jsonl`.
+ * Writes are serialised per session so events keep their emission order.
+ */
+export class FileSessionStore {
+    directory;
+    pendingWrites = Promise.resolve();
+    constructor(home = defaultSessionHome()) {
+        this.directory = path.join(home, SESSIONS_DIRECTORY);
+    }
+    location(id) {
+        return path.join(this.directory, `${assertSessionId(id)}.jsonl`);
+    }
+    append(id, record) {
+        const file = this.location(id);
+        const line = `${JSON.stringify(record)}\n`;
+        const write = this.pendingWrites.then(async () => {
+            await mkdir(this.directory, { recursive: true });
+            await appendFile(file, line, "utf8");
+        });
+        // Keep the queue usable after an individual write fails. The caller still
+        // receives `write` and can observe that failure, while later appends are
+        // chained from a recovered promise instead of a permanently rejected one.
+        this.pendingWrites = write.catch(() => undefined);
+        return write;
+    }
+    async flush() {
+        await this.pendingWrites;
+    }
+    async read(id) {
+        let contents;
+        try {
+            contents = await readFile(this.location(id), "utf8");
+        }
+        catch (error) {
+            if (isNotFound(error)) {
+                return undefined;
+            }
+            throw error;
+        }
+        return parseTranscript(contents);
+    }
+    async list(options = {}) {
+        let files;
+        try {
+            files = await readdir(this.directory);
+        }
+        catch (error) {
+            if (isNotFound(error)) {
+                return [];
+            }
+            throw error;
+        }
+        const summaries = [];
+        for (const file of files) {
+            if (!file.endsWith(".jsonl")) {
+                continue;
+            }
+            const summary = await this.summarise(path.join(this.directory, file));
+            if (summary === undefined) {
+                continue;
+            }
+            if (options.cwd !== undefined && summary.cwd !== options.cwd) {
+                continue;
+            }
+            summaries.push(summary);
+        }
+        return summaries
+            .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt))
+            .slice(0, options.limit ?? DEFAULT_LIST_LIMIT);
+    }
+    async summarise(file) {
+        let transcript;
+        let updatedAt;
+        try {
+            transcript = parseTranscript(await readFile(file, "utf8"));
+            updatedAt = (await stat(file)).mtime.toISOString();
+        }
+        catch (error) {
+            if (isNotFound(error)) {
+                return undefined;
+            }
+            throw error;
+        }
+        if (transcript === undefined) {
+            return undefined;
+        }
+        const lastPrompt = transcript.prompts.at(-1);
+        return {
+            id: transcript.header.id,
+            cwd: transcript.header.cwd,
+            timestamp: transcript.header.timestamp,
+            updatedAt,
+            promptCount: transcript.prompts.length,
+            ...(lastPrompt === undefined ? {} : { lastPrompt }),
+        };
+    }
+}
+/**
+ * Rebuilds a transcript from a session file. The authoritative message list is
+ * the one carried by the last `agent_end`, so a partially written file degrades
+ * to the last completed run instead of failing to load.
+ */
+export function parseTranscript(contents) {
+    let header;
+    let messages = [];
+    const prompts = [];
+    for (const line of contents.split("\n")) {
+        if (line.trim().length === 0) {
+            continue;
+        }
+        let record;
+        try {
+            record = JSON.parse(line);
+        }
+        catch {
+            continue; // A truncated final line must not discard the session.
+        }
+        if (typeof record !== "object" || record === null || !("type" in record)) {
+            continue;
+        }
+        if (record.type === "session") {
+            header = toHeader(record);
+        }
+        else if (record.type === "agent_start" && "prompt" in record) {
+            if (typeof record.prompt === "string") {
+                prompts.push(record.prompt);
+            }
+        }
+        else if (record.type === "agent_end" && "messages" in record) {
+            if (Array.isArray(record.messages)) {
+                messages = record.messages;
+            }
+        }
+    }
+    return header === undefined ? undefined : { header, messages, prompts };
+}
+function toHeader(record) {
+    const candidate = record;
+    if (typeof candidate.id !== "string" ||
+        typeof candidate.cwd !== "string" ||
+        typeof candidate.timestamp !== "string" ||
+        typeof candidate.version !== "number") {
+        return undefined;
+    }
+    return {
+        type: "session",
+        version: candidate.version,
+        id: candidate.id,
+        timestamp: candidate.timestamp,
+        cwd: candidate.cwd,
+    };
+}
+function assertSessionId(id) {
+    if (!SESSION_ID_PATTERN.test(id)) {
+        throw new TypeError(`Invalid session id: ${id}`);
+    }
+    return id;
+}
+function isNotFound(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        (error.code === "ENOENT" || error.code === "ENOTDIR"));
+}
+//# sourceMappingURL=session-store.js.map

package/dist/session-store.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,49 @@
+import { type AgentOptions, type AgentRunResult } from "./agent.js";
+import type { AgentEventListener } from "./events.js";
+import type { Message } from "./messages.js";
+import { type SessionHeader, type SessionStore } from "./session-store.js";
+export interface AgentSessionOptions {
+    /** Agent configuration. The session owns event delivery, so `onEvent` is not part of it. */
+    readonly agent: Omit<AgentOptions, "onEvent">;
+    readonly id?: string;
+    readonly cwd?: string;
+    readonly store?: SessionStore;
+    /** Messages restored from an earlier session. */
+    readonly messages?: readonly Message[];
+    /** True when the session log already has a header line. */
+    readonly resumed?: boolean;
+    readonly now?: () => Date;
+}
+/**
+ * Owns one conversation: the transcript that survives across prompts, the
+ * listeners that watch it, and the optional durable log. The Agent stays
+ * stateless between runs; the session is what makes a chivgent conversation
+ * multi-turn.
+ */
+export declare class AgentSession {
+    readonly id: string;
+    readonly cwd: string;
+    private readonly agent;
+    private readonly listeners;
+    private readonly store;
+    private readonly now;
+    private transcript;
+    private headerWritten;
+    private promptCount;
+    constructor(options: AgentSessionOptions);
+    get messages(): readonly Message[];
+    get turns(): number;
+    get toolNames(): readonly string[];
+    subscribe(listener: AgentEventListener): () => void;
+    /** Drops the transcript but keeps the session id and its log. */
+    clear(): void;
+    prompt(text: string, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<AgentRunResult>;
+    header(): SessionHeader;
+    private dispatch;
+    private record;
+    private writeHeader;
+    private flush;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,KAAK,EAAc,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,mBAAmB;IAClC,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAC9C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACvC,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAC3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,WAAW,CAAK;IAExB,YAAY,OAAO,EAAE,mBAAmB,EAavC;IAED,IAAI,QAAQ,IAAI,SAAS,OAAO,EAAE,CAEjC;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,SAAS,IAAI,SAAS,MAAM,EAAE,CAEjC;IAED,SAAS,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAKlD;IAED,iEAAiE;IACjE,KAAK,IAAI,IAAI,CAEZ;IAEK,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAC9C,OAAO,CAAC,cAAc,CAAC,CAWzB;IAED,MAAM,IAAI,aAAa,CAQtB;IAED,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,MAAM;YAcA,WAAW;YAYX,KAAK;CAOpB"}

package/dist/session.js

@@ -0,0 +1,115 @@
+import { Agent } from "./agent.js";
+import { createSessionId, SESSION_FORMAT_VERSION, } from "./session-store.js";
+/**
+ * Owns one conversation: the transcript that survives across prompts, the
+ * listeners that watch it, and the optional durable log. The Agent stays
+ * stateless between runs; the session is what makes a chivgent conversation
+ * multi-turn.
+ */
+export class AgentSession {
+    id;
+    cwd;
+    agent;
+    listeners = new Set();
+    store;
+    now;
+    transcript;
+    headerWritten;
+    promptCount = 0;
+    constructor(options) {
+        this.id = options.id ?? createSessionId();
+        this.cwd = options.cwd ?? process.cwd();
+        this.store = options.store;
+        this.now = options.now ?? (() => new Date());
+        this.transcript = structuredClone(options.messages ?? []);
+        this.headerWritten = options.resumed ?? false;
+        this.agent = new Agent({
+            ...options.agent,
+            onEvent: (event) => {
+                this.dispatch(event);
+            },
+        });
+    }
+    get messages() {
+        return this.transcript;
+    }
+    get turns() {
+        return this.promptCount;
+    }
+    get toolNames() {
+        return this.agent.toolNames;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /** Drops the transcript but keeps the session id and its log. */
+    clear() {
+        this.transcript = [];
+    }
+    async prompt(text, options = {}) {
+        await this.writeHeader();
+        this.promptCount += 1;
+        const result = await this.agent.run(text, {
+            history: this.transcript,
+            ...(options.signal === undefined ? {} : { signal: options.signal }),
+        });
+        this.transcript = result.messages;
+        await this.flush();
+        return result;
+    }
+    header() {
+        return {
+            type: "session",
+            version: SESSION_FORMAT_VERSION,
+            id: this.id,
+            timestamp: this.now().toISOString(),
+            cwd: this.cwd,
+        };
+    }
+    dispatch(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // A failing subscriber must not change the outcome of the run.
+            }
+        }
+        this.record(event);
+    }
+    record(event) {
+        if (this.store === undefined ||
+            !this.headerWritten ||
+            event.type === "message_update") {
+            return;
+        }
+        // Events are emitted synchronously; the store serialises the writes.
+        void this.store.append(this.id, event).catch(() => {
+            // A session log is a convenience, never a reason to fail a run.
+        });
+    }
+    async writeHeader() {
+        if (this.store === undefined || this.headerWritten) {
+            return;
+        }
+        try {
+            await this.store.append(this.id, this.header());
+            this.headerWritten = true;
+        }
+        catch {
+            // Skip persistence for this run. A later prompt can retry the header.
+        }
+    }
+    async flush() {
+        try {
+            await this.store?.flush?.();
+        }
+        catch {
+            // Persistence is best-effort and must not change the Agent result.
+        }
+    }
+}
+//# 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/tools/list-files.d.ts

@@ -0,0 +1,24 @@
+import type { Tool, ToolContext, ToolOutput } from "./tool.js";
+export declare class ListFilesTool implements Tool {
+    readonly name = "list_files";
+    readonly description = "List project files and directories in deterministic order. Ignored, generated, and sensitive paths are excluded.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly path: {
+                readonly type: "string";
+                readonly description: 'Directory relative to the workspace root. Use "." for the root.';
+            };
+            readonly max_depth: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 8;
+                readonly description: "Maximum directory depth to include. Usually use 4.";
+            };
+        };
+        readonly required: readonly ["path", "max_depth"];
+        readonly additionalProperties: false;
+    };
+    execute(argumentsValue: unknown, context: ToolContext): Promise<ToolOutput>;
+}
+//# sourceMappingURL=list-files.d.ts.map

package/dist/tools/list-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-files.d.ts","sourceRoot":"","sources":["../../src/tools/list-files.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AA+B/D,qBAAa,aAAc,YAAW,IAAI;IACxC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,sHACiG;IACrH,QAAQ,CAAC,WAAW;uBA3Bd,QAAQ;;qBAEZ,IAAI;yBACF,IAAI,EAAE,QAAQ;yBACd,WAAW,EACT,iEAAiE;;qBAErE,SAAS;yBACP,IAAI,EAAE,SAAS;yBACf,OAAO,EAAE,CAAC;yBACV,OAAO;yBACP,WAAW,EAAE,oDAAoD;;;qCAG1D,MAAM,EAAE,WAAW;;MAaK;IAE7B,OAAO,CACX,cAAc,EAAE,OAAO,EACvB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAiCrB;CACF"}

package/dist/tools/list-files.js

@@ -0,0 +1,80 @@
+import { WorkspaceError } from "../workspace.js";
+import { formatBoundedLineOutput } from "./output.js";
+const DEFAULT_PATH = ".";
+const DEFAULT_MAX_DEPTH = 4;
+const MAX_DEPTH = 8;
+const inputSchema = {
+    type: "object",
+    properties: {
+        path: {
+            type: "string",
+            description: 'Directory relative to the workspace root. Use "." for the root.',
+        },
+        max_depth: {
+            type: "integer",
+            minimum: 1,
+            maximum: MAX_DEPTH,
+            description: "Maximum directory depth to include. Usually use 4.",
+        },
+    },
+    required: ["path", "max_depth"],
+    additionalProperties: false,
+};
+export class ListFilesTool {
+    name = "list_files";
+    description = "List project files and directories in deterministic order. Ignored, generated, and sensitive paths are excluded.";
+    inputSchema = inputSchema;
+    async execute(argumentsValue, context) {
+        const argumentsObject = parseArguments(argumentsValue);
+        if (argumentsObject === undefined) {
+            return {
+                content: 'Invalid arguments. Expected {"path":".","max_depth":4}; max_depth must be an integer from 1 to 8.',
+                isError: true,
+            };
+        }
+        try {
+            const result = await context.workspace.listFiles({
+                path: argumentsObject.path,
+                maxDepth: argumentsObject.maxDepth,
+            });
+            return {
+                content: formatBoundedLineOutput(result.entries.map((entry) => entry.path), {
+                    emptyMessage: "No discoverable files found.",
+                    truncated: result.truncated,
+                    truncationMessage: "[truncated: narrow path or reduce max_depth to inspect a smaller subtree]",
+                }),
+                isError: false,
+            };
+        }
+        catch (error) {
+            if (error instanceof WorkspaceError || error instanceof TypeError) {
+                return { content: error.message, isError: true };
+            }
+            throw error;
+        }
+    }
+}
+function parseArguments(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const keys = Object.keys(value);
+    if (keys.some((key) => key !== "path" && key !== "max_depth")) {
+        return undefined;
+    }
+    const path = value.path ?? DEFAULT_PATH;
+    const maxDepth = value.max_depth ?? DEFAULT_MAX_DEPTH;
+    if (typeof path !== "string" ||
+        path.length === 0 ||
+        typeof maxDepth !== "number" ||
+        !Number.isSafeInteger(maxDepth) ||
+        maxDepth < 1 ||
+        maxDepth > MAX_DEPTH) {
+        return undefined;
+    }
+    return { path, maxDepth };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=list-files.js.map

package/dist/tools/list-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-files.js","sourceRoot":"","sources":["../../src/tools/list-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,YAAY,GAAG,GAAG,CAAC;AACzB,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,SAAS,GAAG,CAAC,CAAC;AAEpB,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,iEAAiE;SACpE;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,SAAS;YAClB,WAAW,EAAE,oDAAoD;SAClE;KACF;IACD,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;IAC/B,oBAAoB,EAAE,KAAK;CACnB,CAAC;AAOX,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAClB,kHAAkH,CAAC;IAC5G,WAAW,GAAG,WAAW,CAAC;IAEnC,KAAK,CAAC,OAAO,CACX,cAAuB,EACvB,OAAoB;QAEpB,MAAM,eAAe,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;QACvD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO;gBACL,OAAO,EACL,mGAAmG;gBACrG,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC;gBAC/C,IAAI,EAAE,eAAe,CAAC,IAAI;gBAC1B,QAAQ,EAAE,eAAe,CAAC,QAAQ;aACnC,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,uBAAuB,CAC9B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EACzC;oBACE,YAAY,EAAE,8BAA8B;oBAC5C,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,iBAAiB,EACf,2EAA2E;iBAC9E,CACF;gBACD,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,cAAc,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;gBAClE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACnD,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,WAAW,CAAC,EAAE,CAAC;QAC9D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,YAAY,CAAC;IACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,IAAI,iBAAiB,CAAC;IACtD,IACE,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,CAAC,MAAM,KAAK,CAAC;QACjB,OAAO,QAAQ,KAAK,QAAQ;QAC5B,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC;QAC/B,QAAQ,GAAG,CAAC;QACZ,QAAQ,GAAG,SAAS,EACpB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/tools/output.d.ts

@@ -0,0 +1,10 @@
+export declare const MAX_TOOL_OUTPUT_BYTES: number;
+export interface BoundedLineOutputOptions {
+    readonly emptyMessage: string;
+    readonly metadata?: string;
+    readonly truncated: boolean;
+    readonly truncationMessage: string;
+}
+export declare function formatBoundedLineOutput(lines: readonly string[], options: BoundedLineOutputOptions): string;
+export declare function truncateUtf8(value: string, maxBytes: number): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/tools/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/tools/output.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,QAAY,CAAC;AAE/C,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,EAAE,wBAAwB,GAChC,MAAM,CA8BR;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAepE"}

package/dist/tools/output.js

@@ -0,0 +1,44 @@
+export const MAX_TOOL_OUTPUT_BYTES = 64 * 1024;
+export function formatBoundedLineOutput(lines, options) {
+    const mainLines = lines.length === 0 ? [options.emptyMessage] : lines;
+    const reservedSuffix = [options.truncationMessage, options.metadata]
+        .filter((value) => value !== undefined)
+        .join("\n");
+    const mainBudget = Math.max(0, MAX_TOOL_OUTPUT_BYTES - Buffer.byteLength(reservedSuffix, "utf8") - 1);
+    const accepted = [];
+    let usedBytes = 0;
+    let truncated = options.truncated;
+    for (const line of mainLines) {
+        const separatorBytes = accepted.length === 0 ? 0 : 1;
+        const lineBytes = Buffer.byteLength(line, "utf8");
+        if (usedBytes + separatorBytes + lineBytes > mainBudget) {
+            truncated = true;
+            break;
+        }
+        accepted.push(line);
+        usedBytes += separatorBytes + lineBytes;
+    }
+    const outputLines = [
+        ...accepted,
+        ...(truncated ? [options.truncationMessage] : []),
+        ...(options.metadata === undefined ? [] : [options.metadata]),
+    ];
+    return truncateUtf8(outputLines.join("\n"), MAX_TOOL_OUTPUT_BYTES);
+}
+export function truncateUtf8(value, maxBytes) {
+    const encoded = Buffer.from(value, "utf8");
+    if (encoded.byteLength <= maxBytes) {
+        return value;
+    }
+    const decoder = new TextDecoder("utf-8", { fatal: true });
+    for (let end = maxBytes; end >= Math.max(0, maxBytes - 4); end -= 1) {
+        try {
+            return decoder.decode(encoded.subarray(0, end));
+        }
+        catch {
+            // Try the previous byte until the UTF-8 prefix is complete.
+        }
+    }
+    return "";
+}
+//# sourceMappingURL=output.js.map

package/dist/tools/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/tools/output.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,GAAG,IAAI,CAAC;AAS/C,MAAM,UAAU,uBAAuB,CACrC,KAAwB,EACxB,OAAiC;IAEjC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACtE,MAAM,cAAc,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,QAAQ,CAAC;SACjE,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;SACvD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CACzB,CAAC,EACD,qBAAqB,GAAG,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,CACtE,CAAC;IACF,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,IAAI,SAAS,GAAG,cAAc,GAAG,SAAS,GAAG,UAAU,EAAE,CAAC;YACxD,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM;QACR,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,SAAS,IAAI,cAAc,GAAG,SAAS,CAAC;IAC1C,CAAC;IAED,MAAM,WAAW,GAAG;QAClB,GAAG,QAAQ;QACX,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;KAC9D,CAAC;IACF,OAAO,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,qBAAqB,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,QAAgB;IAC1D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,OAAO,CAAC,UAAU,IAAI,QAAQ,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,KAAK,IAAI,GAAG,GAAG,QAAQ,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC;YACH,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,4DAA4D;QAC9D,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/tools/read-file.d.ts

@@ -0,0 +1,29 @@
+import type { Tool, ToolContext, ToolOutput } from "./tool.js";
+export declare class ReadFileTool implements Tool {
+    readonly name = "read_file";
+    readonly description = "Read a bounded range from a UTF-8 text file inside the workspace. Use list_files or search_text first when the path is unknown.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly path: {
+                readonly type: "string";
+                readonly description: "Path relative to the workspace root.";
+            };
+            readonly start_line: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly description: "First one-based line to read. Usually start with 1.";
+            };
+            readonly line_count: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 500;
+                readonly description: "Number of lines to read. Usually use 200.";
+            };
+        };
+        readonly required: readonly ["path", "start_line", "line_count"];
+        readonly additionalProperties: false;
+    };
+    execute(argumentsValue: unknown, context: ToolContext): Promise<ToolOutput>;
+}
+//# sourceMappingURL=read-file.d.ts.map

package/dist/tools/read-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAsC/D,qBAAa,YAAa,YAAW,IAAI;IACvC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,qIACgH;IACpI,QAAQ,CAAC,WAAW;uBAhCd,QAAQ;;qBAEZ,IAAI;yBACF,IAAI,EAAE,QAAQ;yBACd,WAAW,EAAE,sCAAsC;;qBAErD,UAAU;yBACR,IAAI,EAAE,SAAS;yBACf,OAAO,EAAE,CAAC;yBACV,WAAW,EAAE,qDAAqD;;qBAEpE,UAAU;yBACR,IAAI,EAAE,SAAS;yBACf,OAAO,EAAE,CAAC;yBACV,OAAO;yBACP,WAAW,EAAE,2CAA2C;;;qCAGjD,MAAM,EAAE,YAAY,EAAE,YAAY;;MAcV;IAE7B,OAAO,CACX,cAAc,EAAE,OAAO,EACvB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA6BrB;CACF"}