@glbgpt/cli 0.1.0-test.5 → 0.1.1

package/dist/src/core/types.d.ts

@@ -39,6 +39,13 @@ export interface ToolCall {
         /** JSON-encoded arguments string (may arrive in streamed pieces). */
         arguments: string;
     };
+    /**
+     * Opaque provider extras echoed back VERBATIM when this call is replayed in history.
+     * Gemini 3 (Vertex OpenAI-compat) delivers `{google: {thought_signature}}` here and
+     * REJECTS the next tool round without it (live-verified 2026-07-22). Only models that
+     * emit it ever see it back, so other providers are unaffected.
+     */
+    extra_content?: unknown;
 }
 /** A streaming chunk in the OpenAI chat.completion.chunk shape (only the fields we consume). */
 export interface ChatChunk {
@@ -54,6 +61,8 @@ export interface ChatChunk {
                     name?: string;
                     arguments?: string;
                 };
+                /** Provider extras on the call (Gemini thought signatures) — see ToolCall.extra_content. */
+                extra_content?: unknown;
             }>;
         };
         finish_reason?: string | null;
@@ -98,6 +107,18 @@ export interface ClientTool {
     name: string;
     description: string;
     parameters: Record<string, unknown>;
+    /**
+     * True for tools with no side effects (fs reads). A round whose calls are ALL
+     * read-only executes them concurrently; any other tool (paid media with its
+     * confirmation dialog) keeps the round strictly sequential.
+     */
+    readOnly?: boolean;
+    /**
+     * Per-turn call cap for THIS tool, enforced by TurnLoop on top of the global
+     * turn budget. Calls past the cap are answered with an error result instead of
+     * executing — used to bound per-turn spend on flat-priced tools (web_search).
+     */
+    maxCallsPerTurn?: number;
     execute(args: Record<string, unknown>): Promise<ToolResult>;
 }
 /** Result of running a client tool. Serialized to JSON as the tool message content. */

package/dist/src/core/updateCheck.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Advise-only update check (spec: 2026-07-20-update-check-design.md).
+ *
+ * Codex-shaped: a 20h-TTL file cache is all the startup path ever reads; when it
+ * is stale a background registry fetch refreshes it for the NEXT start, so the
+ * TUI is never blocked by the network and every failure is silent. One deliberate
+ * divergence: our channel lives on prerelease versions (0.1.0-test.N), so the
+ * comparison implements semver prerelease precedence instead of ignoring it.
+ * The registry is fetched over HTTPS directly — never by shelling npm — which
+ * sidesteps project-level .npmrc registry redirection entirely.
+ */
+export declare const UPDATE_CHECK_TTL_MS: number;
+export interface UpdateCache {
+    latestVersion: string;
+    channel: string;
+    lastCheckedAt: number;
+}
+export interface UpdateNotice {
+    latest: string;
+    command: string;
+}
+/** Injectable deps so tests never touch the network, the real cache, or the clock. */
+export interface UpdateCheckDeps {
+    currentVersion?: string;
+    cacheFile?: string;
+    fetchImpl?: typeof fetch;
+    now?: () => number;
+    /** Resolved from env/config when omitted. */
+    enabled?: boolean;
+}
+/** The npm dist-tag this build tracks: prerelease test builds follow `test`. */
+export declare function channelForVersion(version: string): 'test' | 'latest';
+export declare function upgradeCommand(channel: string): string;
+/**
+ * Semver precedence: >0 when `a` is newer than `b`, 0 when equal or either side
+ * is malformed (malformed must never read as "newer" — a registry hiccup would
+ * otherwise nag every start). Numeric prerelease identifiers compare numerically
+ * (test.10 > test.9); a release outranks its own prereleases.
+ */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Cache-only answer for THIS start; spawns the background refresh when the cache
+ * is stale, missing, or from another channel. Returns a notice only when the
+ * cached latest genuinely outranks the running version.
+ */
+export declare function maybeCheckForUpdate(deps?: UpdateCheckDeps): Promise<UpdateNotice | null>;

package/dist/src/core/updateCheck.js

@@ -0,0 +1,139 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { configDir } from '../config/paths.js';
+import { getConfigValueSync } from '../config/configFile.js';
+import { VERSION } from '../version.js';
+/**
+ * Advise-only update check (spec: 2026-07-20-update-check-design.md).
+ *
+ * Codex-shaped: a 20h-TTL file cache is all the startup path ever reads; when it
+ * is stale a background registry fetch refreshes it for the NEXT start, so the
+ * TUI is never blocked by the network and every failure is silent. One deliberate
+ * divergence: our channel lives on prerelease versions (0.1.0-test.N), so the
+ * comparison implements semver prerelease precedence instead of ignoring it.
+ * The registry is fetched over HTTPS directly — never by shelling npm — which
+ * sidesteps project-level .npmrc registry redirection entirely.
+ */
+export const UPDATE_CHECK_TTL_MS = 20 * 60 * 60 * 1000;
+const REGISTRY_URL = 'https://registry.npmjs.org/@glbgpt%2fcli';
+const FETCH_TIMEOUT_MS = 5000;
+/** The npm dist-tag this build tracks: prerelease test builds follow `test`. */
+export function channelForVersion(version) {
+    return version.includes('-test.') ? 'test' : 'latest';
+}
+export function upgradeCommand(channel) {
+    return `npm i -g @glbgpt/cli@${channel}`;
+}
+function parse(version) {
+    // Build metadata is constrained to the semver charset (not `.*`): version strings
+    // from the registry get echoed into the terminal, and a lax tail would let a
+    // poisoned response smuggle ANSI control sequences into that output.
+    const m = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/.exec(version);
+    if (!m)
+        return null;
+    return {
+        core: [Number(m[1]), Number(m[2]), Number(m[3])],
+        pre: m[4] ? m[4].split('.') : null,
+    };
+}
+/**
+ * Semver precedence: >0 when `a` is newer than `b`, 0 when equal or either side
+ * is malformed (malformed must never read as "newer" — a registry hiccup would
+ * otherwise nag every start). Numeric prerelease identifiers compare numerically
+ * (test.10 > test.9); a release outranks its own prereleases.
+ */
+export function compareVersions(a, b) {
+    const pa = parse(a);
+    const pb = parse(b);
+    if (!pa || !pb)
+        return 0;
+    for (let i = 0; i < 3; i++) {
+        if (pa.core[i] !== pb.core[i])
+            return pa.core[i] - pb.core[i];
+    }
+    if (!pa.pre && !pb.pre)
+        return 0;
+    if (!pa.pre)
+        return 1; // release > prerelease
+    if (!pb.pre)
+        return -1;
+    const len = Math.max(pa.pre.length, pb.pre.length);
+    for (let i = 0; i < len; i++) {
+        const x = pa.pre[i];
+        const y = pb.pre[i];
+        if (x === undefined)
+            return -1; // shorter prerelease = lower precedence
+        if (y === undefined)
+            return 1;
+        const xn = /^\d+$/.test(x);
+        const yn = /^\d+$/.test(y);
+        if (xn && yn) {
+            if (Number(x) !== Number(y))
+                return Number(x) - Number(y);
+        }
+        else if (xn !== yn) {
+            return xn ? -1 : 1; // numeric identifiers rank below alphanumeric ones
+        }
+        else if (x !== y) {
+            return x < y ? -1 : 1;
+        }
+    }
+    return 0;
+}
+function isEnabled() {
+    const env = process.env.GLBGPT_UPDATE_CHECK;
+    if (env !== undefined)
+        return env !== 'false' && env !== '0';
+    return getConfigValueSync('update-check') !== 'false';
+}
+async function readCache(file) {
+    try {
+        const parsed = JSON.parse(await fs.readFile(file, 'utf8'));
+        if (typeof parsed.latestVersion === 'string' &&
+            typeof parsed.channel === 'string' &&
+            typeof parsed.lastCheckedAt === 'number') {
+            return parsed;
+        }
+    }
+    catch {
+        // missing or corrupt cache = no cache
+    }
+    return null;
+}
+async function refresh(cacheFile, channel, fetchImpl, now) {
+    const res = await fetchImpl(REGISTRY_URL, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+    if (!res.ok)
+        return;
+    const json = (await res.json());
+    const latest = json['dist-tags']?.[channel];
+    if (typeof latest !== 'string' || !latest)
+        return;
+    const cache = { latestVersion: latest, channel, lastCheckedAt: now() };
+    await fs.mkdir(path.dirname(cacheFile), { recursive: true });
+    await fs.writeFile(cacheFile, JSON.stringify(cache) + '\n', 'utf8');
+}
+/**
+ * Cache-only answer for THIS start; spawns the background refresh when the cache
+ * is stale, missing, or from another channel. Returns a notice only when the
+ * cached latest genuinely outranks the running version.
+ */
+export async function maybeCheckForUpdate(deps = {}) {
+    const current = deps.currentVersion ?? VERSION;
+    if (!(deps.enabled ?? isEnabled()) || current === '0.0.0')
+        return null;
+    const channel = channelForVersion(current);
+    const cacheFile = deps.cacheFile ?? path.join(configDir(), 'version-check.json');
+    const now = deps.now ?? Date.now;
+    const cache = await readCache(cacheFile);
+    const fresh = cache !== null && cache.channel === channel && now() - cache.lastCheckedAt < UPDATE_CHECK_TTL_MS;
+    if (!fresh) {
+        void refresh(cacheFile, channel, deps.fetchImpl ?? fetch, now).catch(() => {
+            // Failure silence is the contract: no log, no notice, retry next start.
+        });
+    }
+    if (cache !== null && cache.channel === channel && compareVersions(cache.latestVersion, current) > 0) {
+        return { latest: cache.latestVersion, command: upgradeCommand(channel) };
+    }
+    return null;
+}
+//# sourceMappingURL=updateCheck.js.map

package/dist/src/core/updateCheck.js.map

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

package/dist/src/exec/media.d.ts

@@ -0,0 +1,32 @@
+import { AiApiClient } from '../media/aiApiClient.js';
+import { TaskManager } from '../media/taskManager.js';
+import { TaskLedger } from '../media/taskLedger.js';
+import { SessionBudget } from '../media/budget.js';
+import type { ClientTool } from '../core/types.js';
+export interface ExecMediaResult {
+    taskId: string;
+    status: 'done' | 'failed';
+    url?: string;
+    localPath?: string;
+    credits?: number;
+    reason?: string;
+}
+export interface ExecMedia {
+    tools: ClientTool[];
+    pendingCount(): number;
+    /** Wait for every in-flight task to reach a terminal state, then return all results. */
+    drain(): Promise<ExecMediaResult[]>;
+}
+/**
+ * Media generation for `glbgpt exec` (spec §3): the same in-chat generate tools the
+ * TUI uses, gated by the session budget instead of a confirmation dialog. The tools
+ * fire-and-forget their TaskManager registration; this wrapper tracks submitted
+ * task ids so runExec can wait for them before the process exits.
+ */
+export declare function createExecMedia(opts: {
+    client: AiApiClient;
+    budget: SessionBudget;
+    outputDir: string;
+    taskManager?: TaskManager;
+    ledger?: TaskLedger;
+}): ExecMedia;

package/dist/src/exec/media.js

@@ -0,0 +1,70 @@
+import { TaskManager } from '../media/taskManager.js';
+import { TaskLedger } from '../media/taskLedger.js';
+import { budgetedExecutor } from '../media/budget.js';
+import { createGenerateImageTool, createGenerateVideoTool } from '../media/generateImageTool.js';
+/**
+ * Media generation for `glbgpt exec` (spec §3): the same in-chat generate tools the
+ * TUI uses, gated by the session budget instead of a confirmation dialog. The tools
+ * fire-and-forget their TaskManager registration; this wrapper tracks submitted
+ * task ids so runExec can wait for them before the process exits.
+ */
+export function createExecMedia(opts) {
+    const taskManager = opts.taskManager ?? new TaskManager(opts.client, { outputDir: opts.outputDir });
+    const ledger = opts.ledger ?? new TaskLedger();
+    const executor = budgetedExecutor(opts.client, opts.budget);
+    const inflight = new Map();
+    const results = [];
+    let onIdle = null;
+    taskManager.subscribe((e) => {
+        if (e.type === 'task_done') {
+            results.push({
+                taskId: e.taskId,
+                status: 'done',
+                url: e.outputUrl,
+                localPath: e.localPath,
+                credits: inflight.get(e.taskId)?.credits,
+            });
+        }
+        else if (e.type === 'task_failed') {
+            results.push({ taskId: e.taskId, status: 'failed', reason: e.reason, credits: inflight.get(e.taskId)?.credits });
+        }
+        else {
+            return; // task_progress
+        }
+        inflight.delete(e.taskId);
+        if (inflight.size === 0 && onIdle) {
+            onIdle();
+            onIdle = null;
+        }
+    });
+    /** Record the task id a successful submit returns, so drain() knows what to wait for. */
+    const tracked = (tool) => ({
+        ...tool,
+        async execute(args) {
+            const r = await tool.execute(args);
+            const rec = r;
+            if (typeof rec.task_id === 'string') {
+                inflight.set(rec.task_id, {
+                    credits: typeof rec.estimated_credits === 'number' ? rec.estimated_credits : undefined,
+                });
+            }
+            return r;
+        },
+    });
+    return {
+        tools: [
+            tracked(createGenerateImageTool({ executor, taskManager, ledger })),
+            tracked(createGenerateVideoTool({ executor, taskManager, ledger })),
+        ],
+        pendingCount: () => inflight.size,
+        async drain() {
+            if (inflight.size > 0) {
+                await new Promise((resolve) => {
+                    onIdle = resolve;
+                });
+            }
+            return results;
+        },
+    };
+}
+//# sourceMappingURL=media.js.map

package/dist/src/exec/media.js.map

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

package/dist/src/exec/output.d.ts

@@ -33,6 +33,22 @@ export declare class ExecOutput {
     finishResult(structured: unknown | null): void;
     /** Turn failed. Keeps the active output structure and returns via a non-zero exit upstream. */
     finishError(message: string): void;
+    /** A tool call started. jsonl gets an event line; text/json a stderr one-liner. */
+    toolBegin(name: string, args: Record<string, unknown>): void;
+    /**
+     * A tool call finished. Full content is deliberately omitted (a read can approach 1MB;
+     * consumers get activity, the model gets content).
+     */
+    toolEnd(name: string, result: Record<string, unknown>): void;
+    /** A media generation reached a terminal state after the turn (exec waits for these before exit). */
+    mediaResult(r: {
+        taskId: string;
+        status: 'done' | 'failed';
+        url?: string;
+        localPath?: string;
+        credits?: number;
+        reason?: string;
+    }): void;
     /** Accumulated assistant text (used to write the --output-last-message file). */
     getContent(): string;
     private line;

package/dist/src/exec/output.js

@@ -73,6 +73,47 @@ export class ExecOutput {
             this.sinks.err(`${message}\n`);
         }
     }
+    /** A tool call started. jsonl gets an event line; text/json a stderr one-liner. */
+    toolBegin(name, args) {
+        if (this.mode === 'jsonl') {
+            this.line({ type: 'tool_call', name, args });
+        }
+        else {
+            const arg = typeof args.path === 'string' ? args.path : typeof args.pattern === 'string' ? args.pattern : '';
+            this.sinks.err(`⚒ ${name}${arg ? `(${arg})` : ''}\n`);
+        }
+    }
+    /**
+     * A tool call finished. Full content is deliberately omitted (a read can approach 1MB;
+     * consumers get activity, the model gets content).
+     */
+    toolEnd(name, result) {
+        const summary = typeof result.summary === 'string' ? result.summary : undefined;
+        const error = typeof result.error === 'string' ? result.error : undefined;
+        if (this.mode === 'jsonl') {
+            this.line({ type: 'tool_result', name, ...(summary ? { summary } : {}), ...(error ? { error } : {}) });
+        }
+        else {
+            this.sinks.err(`  ⎿ ${error ?? summary ?? 'done'}\n`);
+        }
+    }
+    /** A media generation reached a terminal state after the turn (exec waits for these before exit). */
+    mediaResult(r) {
+        if (this.mode === 'jsonl') {
+            this.line({
+                type: 'media_result',
+                task_id: r.taskId,
+                status: r.status,
+                ...(r.url ? { url: r.url } : {}),
+                ...(r.localPath ? { local_path: r.localPath } : {}),
+                ...(r.credits !== undefined ? { credits: r.credits } : {}),
+                ...(r.reason ? { reason: r.reason } : {}),
+            });
+        }
+        else {
+            this.sinks.err(r.status === 'done' ? `⚒ media saved: ${r.localPath}\n` : `⚒ media failed: ${r.reason}\n`);
+        }
+    }
     /** Accumulated assistant text (used to write the --output-last-message file). */
     getContent() {
         return this.content;

package/dist/src/exec/output.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/exec/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,MAAM,OAAO,UAAU;IAKF;IACA;IACA;IANX,OAAO,GAAG,EAAE,CAAC;IACb,KAAK,GAAc,EAAE,aAAa,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;IAEtE,YACmB,IAAgB,EAChB,KAAa,EACb,KAAkB;QAFlB,SAAI,GAAJ,IAAI,CAAY;QAChB,UAAK,GAAL,KAAK,CAAQ;QACb,UAAK,GAAL,KAAK,CAAa;IAClC,CAAC;IAEJ,kDAAkD;IAClD,KAAK;QACH,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;QACrB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,+CAA+C;IAC/C,UAAU,CAAC,YAAoB,EAAE,gBAAwB;QACvD,IAAI,CAAC,KAAK,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;QAClF,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACjG,CAAC;IACH,CAAC;IAED,8FAA8F;IAC9F,YAAY,CAAC,UAA0B;QACrC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,OAAO;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;YACnG,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU;YACV,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;IACL,CAAC;IAED,+FAA+F;IAC/F,WAAW,CAAC,OAAe;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,UAAU,EAAE,IAAI;gBAChB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,EAAE,OAAO,EAAE;aACnB,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,iFAAiF;IACjF,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAEO,IAAI,CAAC,GAAY;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF"}
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../../src/exec/output.ts"],"names":[],"mappings":"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"}

package/dist/src/fs/globTool.d.ts

@@ -0,0 +1,8 @@
+import type { ClientTool } from '../core/types.js';
+/**
+ * Translate a glob pattern to a RegExp over "/"-separated relative paths.
+ * Supported: `**` (any depth, including zero for a leading `**` + separator), `*` (within one
+ * segment), `?` (one char). Everything else is matched literally.
+ */
+export declare function globToRegExp(pattern: string): RegExp;
+export declare function createGlobTool(root: string): ClientTool;

package/dist/src/fs/globTool.js

@@ -0,0 +1,117 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { GuardError, resolveInWorkspace, sanitizeFsError } from './workspaceGuard.js';
+import { walkFiles } from './walk.js';
+import { MAX_GLOB_RESULTS, MAX_GLOB_SCAN } from './limits.js';
+/**
+ * Translate a glob pattern to a RegExp over "/"-separated relative paths.
+ * Supported: `**` (any depth, including zero for a leading `**` + separator), `*` (within one
+ * segment), `?` (one char). Everything else is matched literally.
+ */
+export function globToRegExp(pattern) {
+    let re = '';
+    let i = 0;
+    while (i < pattern.length) {
+        const c = pattern[i];
+        if (c === '*') {
+            if (pattern[i + 1] === '*') {
+                // `**/` at a boundary may match zero directories.
+                if (pattern[i + 2] === '/') {
+                    re += '(?:.*/)?';
+                    i += 3;
+                }
+                else {
+                    re += '.*';
+                    i += 2;
+                }
+            }
+            else {
+                re += '[^/]*';
+                i += 1;
+            }
+        }
+        else if (c === '?') {
+            re += '[^/]';
+            i += 1;
+        }
+        else {
+            re += c.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            i += 1;
+        }
+    }
+    return new RegExp(`^${re}$`);
+}
+export function createGlobTool(root) {
+    return {
+        name: 'glob',
+        readOnly: true,
+        description: 'Find files inside the workspace by glob pattern (e.g. "**/*.pdf", "docs/*.md"). ' +
+            `Returns matching paths, newest modified first (top ${MAX_GLOB_RESULTS}; larger result sets are ` +
+            'truncated with a note). node_modules/.git etc. are never searched.',
+        parameters: {
+            type: 'object',
+            properties: {
+                pattern: { type: 'string', description: 'Glob pattern over workspace-relative paths.' },
+                path: { type: 'string', description: 'Directory to search from (default workspace root).' },
+            },
+            required: ['pattern'],
+        },
+        async execute(args) {
+            if (typeof args.pattern !== 'string' || !args.pattern.trim()) {
+                return { error: 'Missing required "pattern" argument.' };
+            }
+            const startArg = typeof args.path === 'string' && args.path.trim() ? args.path : '.';
+            try {
+                const start = await resolveInWorkspace(root, startArg);
+                const rx = globToRegExp(args.pattern);
+                const matches = [];
+                for await (const f of walkFiles(root, start)) {
+                    // Match against "/"-separated rel paths for cross-platform stability. Try BOTH the
+                    // root-relative path (so `pattern: 'docs/*.md'` works from the root) and the path
+                    // relative to the resolved start dir (so `pattern: '*.md', path: 'docs'` also works,
+                    // matching the over-cap error's own advice to narrow via `path`). Results always stay
+                    // root-relative so they remain valid read_file inputs either way.
+                    const relFromRoot = f.rel.split(path.sep).join('/');
+                    const relFromStart = path.relative(start, f.abs).split(path.sep).join('/');
+                    if (!rx.test(relFromRoot) && !rx.test(relFromStart))
+                        continue;
+                    const stat = await fs.stat(f.abs);
+                    matches.push({ rel: f.rel, mtime: stat.mtimeMs });
+                    // Hard scan bound so a pathological workspace can't stat forever; the note
+                    // below reports the cap so the model knows the count is a floor, not a total.
+                    if (matches.length >= MAX_GLOB_SCAN)
+                        break;
+                }
+                if (matches.length === 0)
+                    return { error: `No files match: ${args.pattern}` };
+                matches.sort((a, b) => b.mtime - a.mtime);
+                // Discovery results are cheap (a path list) — over-cap truncates with a note
+                // instead of erroring, saving the model a retry round-trip.
+                if (matches.length > MAX_GLOB_RESULTS) {
+                    // When the scan cap stopped collection we cannot know whether more matches exist
+                    // (an exact-2000 workspace would make "2000+" a false claim) — say what we know.
+                    const scanCapped = matches.length >= MAX_GLOB_SCAN;
+                    const shown = matches.slice(0, MAX_GLOB_RESULTS);
+                    const note = scanCapped
+                        ? `(Results truncated: showing the ${MAX_GLOB_RESULTS} newest of the first ${MAX_GLOB_SCAN} matches scanned. Narrow the pattern or search a subdirectory.)`
+                        : `(Results truncated: showing the ${MAX_GLOB_RESULTS} newest of ${matches.length} matches. Narrow the pattern or search a subdirectory.)`;
+                    return {
+                        summary: `${MAX_GLOB_RESULTS} files (truncated)`,
+                        content: [...shown.map((m) => m.rel), note].join('\n'),
+                    };
+                }
+                return {
+                    summary: `${matches.length} files`,
+                    content: matches.map((m) => m.rel).join('\n'),
+                };
+            }
+            catch (err) {
+                if (err instanceof GuardError)
+                    return { error: err.message };
+                const message = err instanceof Error ? err.message : String(err);
+                return { error: `glob failed: ${sanitizeFsError(message, root)}` };
+            }
+        },
+    };
+}
+//# sourceMappingURL=globTool.js.map

package/dist/src/fs/globTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globTool.js","sourceRoot":"","sources":["../../../src/fs/globTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACd,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC3B,kDAAkD;gBAClD,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC3B,EAAE,IAAI,UAAU,CAAC;oBACjB,CAAC,IAAI,CAAC,CAAC;gBACT,CAAC;qBAAM,CAAC;oBACN,EAAE,IAAI,IAAI,CAAC;oBACX,CAAC,IAAI,CAAC,CAAC;gBACT,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,EAAE,IAAI,OAAO,CAAC;gBACd,CAAC,IAAI,CAAC,CAAC;YACT,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACrB,EAAE,IAAI,MAAM,CAAC;YACb,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;aAAM,CAAC;YACN,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;YAC/C,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;IACH,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,kFAAkF;YAClF,sDAAsD,gBAAgB,2BAA2B;YACjG,oEAAoE;QACtE,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE;gBACvF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oDAAoD,EAAE;aAC5F;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;QACD,KAAK,CAAC,OAAO,CAAC,IAAI;YAChB,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC7D,OAAO,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;YAC3D,CAAC;YACD,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;YACrF,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACvD,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACtC,MAAM,OAAO,GAA0C,EAAE,CAAC;gBAC1D,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;oBAC7C,mFAAmF;oBACnF,kFAAkF;oBAClF,qFAAqF;oBACrF,sFAAsF;oBACtF,kEAAkE;oBAClE,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACpD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAC3E,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC;wBAAE,SAAS;oBAC9D,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;oBAClC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;oBAClD,2EAA2E;oBAC3E,8EAA8E;oBAC9E,IAAI,OAAO,CAAC,MAAM,IAAI,aAAa;wBAAE,MAAM;gBAC7C,CAAC;gBACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC1C,6EAA6E;gBAC7E,4DAA4D;gBAC5D,IAAI,OAAO,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;oBACtC,iFAAiF;oBACjF,iFAAiF;oBACjF,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;oBACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;oBACjD,MAAM,IAAI,GAAG,UAAU;wBACrB,CAAC,CAAC,mCAAmC,gBAAgB,wBAAwB,aAAa,iEAAiE;wBAC3J,CAAC,CAAC,mCAAmC,gBAAgB,cAAc,OAAO,CAAC,MAAM,yDAAyD,CAAC;oBAC7I,OAAO;wBACL,OAAO,EAAE,GAAG,gBAAgB,oBAAoB;wBAChD,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;qBACvD,CAAC;gBACJ,CAAC;gBACD,OAAO;oBACL,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,QAAQ;oBAClC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;iBAC9C,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,UAAU;oBAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC7D,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,OAAO,EAAE,KAAK,EAAE,gBAAgB,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;YACrE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/fs/grepTool.d.ts

@@ -0,0 +1,4 @@
+import type { ClientTool } from '../core/types.js';
+export declare function createGrepTool(root: string, opts?: {
+    timeoutMs?: number;
+}): ClientTool;