@tianshu-ai/tianshu 0.3.0

package/plugins/files/dist/tools/edit-file.js

@@ -0,0 +1,230 @@
+// edit_file — exact text replacement, in-place, with optional
+// batch updates per call.
+//
+// One call carries an `edits: Edit[]` array; the file is loaded
+// once, every edit is applied in order in memory, and the
+// composite result is written atomically (temp sibling + rename)
+// only if every edit succeeds. Same uniqueness contract as before
+// — each `old_text` must appear exactly once at the moment that
+// edit runs (so cascading edits where one substring becomes
+// non-unique mid-batch are caught and surfaced; the file on disk
+// is unchanged in that case).
+//
+// Why batch: long-form synthesis (HTML reports, multi-section
+// markdown) wants to fill several `<!-- TODO -->` placeholders or
+// patch several function bodies in one round-trip. The non-batch
+// API forced one tool call per patch, multiplying turns and tool
+// result tokens.
+//
+// Backwards compat: a single `{ old_text, new_text }` at the top
+// level still works — we re-shape it into `edits: [{...}]` before
+// running. Old prompts and existing tests keep passing without
+// edits to call sites.
+//
+// Modelled on OpenClaw / Claude Code's edit tool, where the
+// `edits` array is the canonical shape.
+import fs from "node:fs";
+import { Type } from "typebox";
+import { loadPrompt } from "./load-prompt.js";
+import { hasRead, markRead } from "./read-tracker.js";
+import { resolveInUserHome, toWorkspaceUri, PathOutsideRootError, } from "./path-helper.js";
+import { applyShape, normaliseEnding, shapeOf } from "./text-shape.js";
+import { findMatch } from "./replacers.js";
+export function editFileSchema() {
+    return {
+        name: "edit_file",
+        description: loadPrompt("edit-file.prompt.md"),
+        parameters: Type.Object({
+            path: Type.String({
+                description: 'Path relative to the workspace root, e.g. "notes/today.md". ' +
+                    'Prefer relative paths over a leading slash \u2014 a leading slash ' +
+                    'here means workspace root, NOT the sandbox OS root that `exec` sees.',
+            }),
+            // `edits` is REQUIRED at the schema level so the host's
+            // truncation detector fires when the model emits
+            // `{path: "..."}` with the array dropped — a common stream
+            // truncation pattern. The legacy `{old_text, new_text}`
+            // shorthand is still accepted at runtime (executeEditFile
+            // re-shapes it into a single-element edits array) for
+            // back-compat with existing callers, but the schema only
+            // documents the canonical form.
+            edits: Type.Array(Type.Object({
+                old_text: Type.String({
+                    description: "Exact text to find. Must appear exactly once at edit time " +
+                        "unless `replace_all` is set. Whitespace-only and indentation-only " +
+                        "differences are tolerated via fuzzy matching; if no match is " +
+                        "found at all the whole batch fails atomically.",
+                }),
+                new_text: Type.String({
+                    description: "Replacement text.",
+                }),
+                replace_all: Type.Optional(Type.Boolean({
+                    description: "Replace every occurrence of `old_text`. Use for renaming " +
+                        "a symbol across the file (the typical multi-occurrence case). " +
+                        "Default false: requires the match to be unique.",
+                })),
+            }), {
+                minItems: 1,
+                description: "List of edits to apply in order, atomic (all or nothing). " +
+                    "Each entry is one find/replace pair.",
+            }),
+        }),
+    };
+}
+export function executeEditFile(userHome, args, sessionId) {
+    // Normalise to a non-empty edits array. Single-edit shorthand
+    // wins only if `edits` is missing — passing both is ambiguous,
+    // we prefer the structured form.
+    const edits = args.edits
+        ? args.edits
+        : args.old_text !== undefined && args.new_text !== undefined
+            ? [
+                {
+                    old_text: args.old_text,
+                    new_text: args.new_text,
+                    replace_all: args.replace_all,
+                },
+            ]
+            : null;
+    if (!edits) {
+        return {
+            ok: false,
+            text: "edit_file: pass either `edits` array or both `old_text` + `new_text`",
+        };
+    }
+    if (edits.length === 0) {
+        return { ok: false, text: "edit_file: edits array is empty" };
+    }
+    let resolved;
+    try {
+        resolved = resolveInUserHome(userHome, args.path);
+    }
+    catch (err) {
+        if (err instanceof PathOutsideRootError) {
+            return { ok: false, text: `path is outside the workspace: ${args.path}` };
+        }
+        throw err;
+    }
+    if (!fs.existsSync(resolved)) {
+        return { ok: false, text: `not found: ${args.path}` };
+    }
+    if (fs.statSync(resolved).isDirectory()) {
+        return { ok: false, text: `is a directory: ${args.path}` };
+    }
+    // Read-required: every edit_file call must follow a read_file
+    // on the same path in the same session. Without that the agent
+    // is matching against text it never actually saw, which is how
+    // overconfident overwrites land. The error tells the agent
+    // exactly what to do next.
+    if (!hasRead(sessionId, resolved)) {
+        return {
+            ok: false,
+            text: `edit_file: call read_file on ${args.path} once before editing — ` +
+                `exact-text matching needs the file's actual current contents in your context. ` +
+                `A single full read (offset=0, no limit) is enough; the host remembers it ` +
+                `for the rest of this session and any number of follow-up edits.`,
+        };
+    }
+    // Read once, peel BOM, detect line ending. We work on the
+    // BOM-less, already-text representation throughout the batch;
+    // only re-prepend BOM at the final write step.
+    const raw = fs.readFileSync(resolved, "utf8");
+    const shape = shapeOf(raw);
+    const applied = [];
+    let working = shape.text;
+    for (let i = 0; i < edits.length; i++) {
+        const e = edits[i];
+        // Normalise the model's input to the file's actual line
+        // ending so a CRLF file matches even when the model sent LF
+        // (and vice-versa).
+        const oldText = normaliseEnding(e.old_text, shape.ending);
+        const newText = normaliseEnding(e.new_text, shape.ending);
+        if (oldText.length === 0) {
+            return {
+                ok: false,
+                text: `edit_file: edit #${i + 1} has empty old_text`,
+                failedEditIndex: i + 1,
+            };
+        }
+        if (oldText === newText) {
+            return {
+                ok: false,
+                text: `edit_file: edit #${i + 1} old_text and new_text are identical`,
+                failedEditIndex: i + 1,
+            };
+        }
+        const match = findMatch(working, oldText);
+        if (!match) {
+            return {
+                ok: false,
+                text: `edit_file: edit #${i + 1} old_text not found in ${args.path} (after ${i} prior edit${i === 1 ? "" : "s"} applied in memory). The match is whitespace- and indent-tolerant; if it still doesn't fit, re-read the file and pull a fresh, larger unique window.`,
+                failedEditIndex: i + 1,
+            };
+        }
+        if (e.replace_all) {
+            // Global replace using the *matched* span, not the
+            // original `oldText`. If a fuzzy replacer rewrote
+            // whitespace, we want to keep replacing the file's
+            // shape, not the model's.
+            const before = working;
+            working = working.split(match.matched).join(newText);
+            const replaced = (before.length - working.length) / Math.max(1, match.matched.length - newText.length);
+            void replaced;
+            applied.push({
+                ok: true,
+                oldLen: oldText.length,
+                newLen: newText.length,
+            });
+            continue;
+        }
+        // Uniqueness check on the *exact match span* — if a fuzzy
+        // candidate appears more than once, we still want the agent
+        // to disambiguate.
+        const occ = countOccurrences(working, match.matched);
+        if (occ > 1) {
+            return {
+                ok: false,
+                text: `edit_file: edit #${i + 1} old_text matches ${occ} places in ${args.path} (after ${i} prior edit${i === 1 ? "" : "s"}); pull a wider unique window or set replace_all=true if you really mean every occurrence`,
+                failedEditIndex: i + 1,
+            };
+        }
+        working =
+            working.slice(0, match.start) + newText + working.slice(match.end);
+        applied.push({
+            ok: true,
+            oldLen: oldText.length,
+            newLen: newText.length,
+        });
+    }
+    // Atomic write: temp sibling then rename. Only if every edit ran.
+    // Re-attach the BOM here — BOM-preservation is the contract; the
+    // batch above never saw it.
+    const finalText = applyShape(working, shape);
+    const tmp = `${resolved}.tmp.${process.pid}.${Date.now()}`;
+    fs.writeFileSync(tmp, finalText);
+    fs.renameSync(tmp, resolved);
+    // After a successful edit the agent's mental model of the file
+    // is now `working`, which is in its context (it just wrote
+    // those edits). Treat that as equivalent to having read the new
+    // bytes — otherwise a second edit_file in the same turn would
+    // need a fresh read_file in between, which is wasteful.
+    markRead(sessionId, resolved);
+    const totalDelta = applied.reduce((acc, a) => acc + (a.newLen - a.oldLen), 0);
+    const summary = applied.length === 1
+        ? `edited ${toWorkspaceUri(userHome, resolved)} (${applied[0].oldLen} → ${applied[0].newLen} chars)`
+        : `edited ${toWorkspaceUri(userHome, resolved)} (${applied.length} edits, net ${totalDelta >= 0 ? "+" : ""}${totalDelta} chars)`;
+    return { ok: true, text: summary, edits: applied };
+}
+function countOccurrences(haystack, needle) {
+    let count = 0;
+    let from = 0;
+    while (true) {
+        const idx = haystack.indexOf(needle, from);
+        if (idx < 0)
+            break;
+        count++;
+        from = idx + needle.length;
+    }
+    return count;
+}
+//# sourceMappingURL=edit-file.js.map

package/plugins/files/dist/tools/edit-file.js.map

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

package/plugins/files/dist/tools/edit-file.prompt.md

@@ -0,0 +1,36 @@
+Apply one or more exact-text replacements inside an existing file.
+
+Pass `edits: [{old_text, new_text}, ...]` for a batch — the file
+is read once, edits run in order in memory, and the result is
+written atomically only if every edit succeeds (so a partial
+batch never lands on disk). Each `old_text` must appear exactly
+once at the moment its edit runs, otherwise the whole batch
+fails and reports which edit tripped.
+
+Use `write_file` for new files or full rewrites; reach for
+`edit_file` when you're patching specific regions.
+
+## Usage
+
+- **You must call `read_file` on the target path first.**
+  `edit_file` will refuse with a specific error if the path was
+  never read in this session — exact text matching only works
+  when you've actually seen the bytes you're matching against.
+- Keep `old_text` as small as possible while still being unique
+  in the file. Don't pad with large unchanged regions to
+  "connect" two distant changes; emit two separate edits in the
+  same batch instead.
+- The only edit kind is exact-text replace. Insertions /
+  deletions / appends are expressed as a replace where `new_text`
+  includes the surrounding anchor (e.g. delete = `{old_text:
+  "X", new_text: ""}`; insert-before-X = `{old_text: "X",
+  new_text: "new\nX"}`).
+- Line endings (CRLF vs LF) and BOM are preserved automatically.
+  Match by content; you don't need to know which the file uses.
+- Whitespace and indentation are tolerated: trailing-whitespace
+  drift, run-of-spaces collapse, and whole-block indent shift
+  are matched fuzzily. You still need to send the right text
+  in the right order; just stop polishing whitespace by hand.
+- For renaming a symbol that occurs many times, set
+  `replace_all: true` on that edit instead of writing one edit
+  per occurrence.

package/plugins/files/dist/tools/glob.d.ts

@@ -0,0 +1,12 @@
+import type { Tool } from "@earendil-works/pi-ai";
+export interface GlobToolResult {
+    ok: boolean;
+    text: string;
+    matches?: string[];
+    truncated?: boolean;
+}
+export declare function globSchema(): Tool;
+export declare function executeGlob(userHome: string, args: {
+    pattern: string;
+}): Promise<GlobToolResult>;
+//# sourceMappingURL=glob.d.ts.map

package/plugins/files/dist/tools/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../src/tools/glob.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AASlD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,UAAU,IAAI,IAAI,CAgBjC;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC,cAAc,CAAC,CA0DzB"}

package/plugins/files/dist/tools/glob.js

@@ -0,0 +1,84 @@
+// glob — match file paths against a shell-style pattern, scoped to
+// the per-user workspace home.
+//
+// Backed by fast-glob so brace expansion, alternation, double-star,
+// case sensitivity, and gitignore-shaped traversal all behave the way
+// the LLM expects from prior training data.
+import fs from "node:fs";
+import fg from "fast-glob";
+import { Type } from "typebox";
+import { resolveInUserHome, toWorkspaceUri, PathOutsideRootError, } from "./path-helper.js";
+const MAX_RESULTS = 1000;
+export function globSchema() {
+    return {
+        name: "glob",
+        description: `Find files matching a shell-style glob pattern, rooted at the workspace.\n` +
+            `Supports the usual glob syntax: \`*\`, \`**\`, \`?\`, \`{a,b}\`, character classes.\n` +
+            `Patterns are interpreted relative to the workspace root \u2014 write \`**/*.md\`, \
+not \`/**/*.md\`.\n` +
+            `Returns up to ${MAX_RESULTS} matching paths, sorted alphabetically.`,
+        parameters: Type.Object({
+            pattern: Type.String({
+                description: 'Glob pattern relative to the workspace root, e.g. "**/*.md", "src/*.ts", "{notes,journal}/**/*.txt".',
+            }),
+        }),
+    };
+}
+export async function executeGlob(userHome, args) {
+    if (!args.pattern || typeof args.pattern !== "string") {
+        return { ok: false, text: "pattern is required" };
+    }
+    // Strip the optional `/workspace/` prefix or leading `/` so the
+    // pattern is fast-glob-relative to userHome. We forbid `..` outright
+    // to keep the search inside the user home regardless of any path
+    // tricks fast-glob might otherwise resolve.
+    let pat = args.pattern.replace(/\\/g, "/");
+    if (pat.startsWith("/workspace/"))
+        pat = pat.slice("/workspace/".length);
+    else if (pat === "/workspace")
+        pat = "";
+    if (pat.startsWith("/"))
+        pat = pat.slice(1);
+    if (pat.includes("..")) {
+        return { ok: false, text: `pattern cannot contain ".."` };
+    }
+    if (pat.length === 0) {
+        return { ok: false, text: "pattern is empty" };
+    }
+    // Resolve root and auto-create on first call so a fresh tenant
+    // doesn't blow up.
+    let root;
+    try {
+        root = resolveInUserHome(userHome, "/");
+    }
+    catch (err) {
+        if (err instanceof PathOutsideRootError) {
+            return { ok: false, text: "could not resolve workspace root" };
+        }
+        throw err;
+    }
+    if (!fs.existsSync(root))
+        fs.mkdirSync(root, { recursive: true });
+    // fast-glob honours `cwd`, returns paths relative to that cwd, and
+    // we ask it for files only. `dot: true` so dotfiles surface (the
+    // workspace deliberately uses .config/ etc.).
+    const found = await fg(pat, {
+        cwd: root,
+        onlyFiles: true,
+        dot: true,
+        suppressErrors: true,
+        followSymbolicLinks: false,
+    });
+    found.sort();
+    const truncated = found.length > MAX_RESULTS;
+    const slice = truncated ? found.slice(0, MAX_RESULTS) : found;
+    const matches = slice.map((rel) => toWorkspaceUri(root, `${root}/${rel}`));
+    const header = `${matches.length} match${matches.length === 1 ? "" : "es"}${truncated ? ` (truncated at ${MAX_RESULTS})` : ""}:`;
+    return {
+        ok: true,
+        text: [header, ...matches].join("\n"),
+        matches,
+        truncated,
+    };
+}
+//# sourceMappingURL=glob.js.map

package/plugins/files/dist/tools/glob.js.map

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

package/plugins/files/dist/tools/index.d.ts

@@ -0,0 +1,13 @@
+import type { AgentTool } from "@tianshu/plugin-sdk";
+export declare const ListDirTool: AgentTool;
+export declare const ReadFileTool: AgentTool;
+export declare const WriteFileTool: AgentTool;
+export declare const EditFileTool: AgentTool;
+export declare const GlobTool: AgentTool;
+export declare const TenantConfigListTool: AgentTool;
+export declare const TenantConfigReadTool: AgentTool;
+export declare const TenantConfigWriteTool: AgentTool;
+export declare const TenantConfigEditTool: AgentTool;
+export declare const TenantConfigDeleteTool: AgentTool;
+export declare const TenantConfigGlobTool: AgentTool;
+//# sourceMappingURL=index.d.ts.map

package/plugins/files/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,SAAS,EAIV,MAAM,qBAAqB,CAAC;AAuC7B,eAAO,MAAM,WAAW,EAAE,SAIzB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,SAQ1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,SAc3B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,SAmB1B,CAAC;AAuEF,eAAO,MAAM,QAAQ,EAAE,SAItB,CAAC;AASF,eAAO,MAAM,oBAAoB,EAAE,SAIlC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,SAOlC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,SAQnC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,SAalC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,SAQpC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,SAOlC,CAAC"}

package/plugins/files/dist/tools/index.js

@@ -0,0 +1,158 @@
+// Agent tools the `files` plugin contributes.
+//
+// These five tools (list_dir / read_file / write_file / edit_file /
+// glob) operate on the **per-user host workspace** \u2014
+// <tenant>/workspace/users/<userId>/. They are NOT sandbox-aware:
+// when the microsandbox plugin is also enabled, the agent will see
+// these alongside microsandbox's `exec` etc. and use whichever fits
+// the task (host fs is direct + persistent; sandbox fs lives inside
+// /workspace which is bind-mounted from the same dir, so changes
+// flow both ways).
+//
+// Ownership rationale: the `files` plugin already owns the file
+// browser UI panel + upload + the HTTP /list /read /raw /upload
+// routes. Putting the agent tools here keeps every "files for the
+// agent / user" surface in one plugin.
+import { readFileSync } from "node:fs";
+import { resolveInUserHome } from "./path-helper.js";
+import { listDirSchema, executeListDir } from "./list-dir.js";
+import { readFileSchema, executeReadFile } from "./read-file.js";
+import { writeFileSchema, executeWriteFile } from "./write-file.js";
+import { editFileSchema, executeEditFile } from "./edit-file.js";
+import { globSchema, executeGlob } from "./glob.js";
+import { tenantConfigListSchema, executeTenantConfigList, } from "./tenant-config-list.js";
+import { tenantConfigReadSchema, executeTenantConfigRead, } from "./tenant-config-read.js";
+import { tenantConfigWriteSchema, executeTenantConfigWrite, } from "./tenant-config-write.js";
+import { tenantConfigEditSchema, executeTenantConfigEdit, } from "./tenant-config-edit.js";
+import { tenantConfigGlobSchema, executeTenantConfigGlob, } from "./tenant-config-glob.js";
+import { tenantConfigDeleteSchema, executeTenantConfigDelete, } from "./tenant-config-delete.js";
+/** Pull the agent's scope from the host-supplied context. Defaults
+ *  to main if the host doesn't provide one (older host versions). */
+function scopeFromCtx(ctx) {
+    return ctx.agentScope ?? { kind: "main" };
+}
+export const ListDirTool = {
+    schema: listDirSchema(),
+    execute: (args, ctx) => executeListDir(ctx.userHomeDir, args),
+};
+export const ReadFileTool = {
+    schema: readFileSchema(),
+    execute: (args, ctx) => executeReadFile(ctx.userHomeDir, args, ctx.sessionId),
+};
+export const WriteFileTool = {
+    schema: writeFileSchema(),
+    execute: async (args, ctx) => {
+        const result = executeWriteFile(ctx.userHomeDir, args, ctx.sessionId);
+        return appendLspDiagnostics(result, ctx, args);
+    },
+};
+export const EditFileTool = {
+    schema: editFileSchema(),
+    execute: async (args, ctx) => {
+        const result = executeEditFile(ctx.userHomeDir, args, ctx.sessionId);
+        return appendLspDiagnostics(result, ctx, args);
+    },
+};
+/**
+ * After a successful write/edit, ask the host's LSP service for
+ * diagnostics on the touched file and append the formatted block
+ * to the tool's text. ADR-0005 §"Diagnostic delivery" — sync,
+ * 3 s timeout, never throws, degrades silently when LSP is
+ * disabled or the language has no LSP. The text appended is
+ * what we want the model to see in the same turn that produced
+ * the edit, so it can react inline rather than several tool
+ * calls later.
+ */
+async function appendLspDiagnostics(result, ctx, args) {
+    // Don't bother on failed writes — there's nothing on disk to
+    // diagnose.
+    if (!result.ok)
+        return result;
+    const cap = ctx.capabilities.get("host.lsp");
+    if (!cap)
+        return result;
+    let resolved;
+    try {
+        resolved = resolveInUserHome(ctx.userHomeDir, args.path);
+    }
+    catch {
+        // Path checks already happened in the underlying tool; if it
+        // somehow rejects here just skip diagnostics.
+        return result;
+    }
+    // We need the post-edit contents to push via didChange. For
+    // write_file the agent supplied them; for edit_file the
+    // executor returned ok without echoing them, so we read from
+    // disk — cheap (we just wrote it) and avoids drifting from
+    // what the LS will actually see when it loads the file.
+    let contents;
+    if (typeof args.content === "string") {
+        contents = args.content;
+    }
+    else {
+        try {
+            contents = fsReadFile(resolved);
+        }
+        catch {
+            return result;
+        }
+    }
+    let diag;
+    try {
+        diag = await cap.diagnoseAfterEdit({
+            filePath: resolved,
+            contents,
+        });
+    }
+    catch {
+        // Capability is supposed to never throw, but if it does
+        // we'd rather drop diagnostics than break the edit.
+        return result;
+    }
+    if (!diag.text && !diag.unavailable)
+        return result;
+    const trailer = diag.text
+        ? `\n\n${diag.text}`
+        : `\n\n[lsp] diagnostics unavailable: ${diag.unavailable}`;
+    return { ...result, text: result.text + trailer };
+}
+function fsReadFile(absolutePath) {
+    // Lazy-import node:fs so this module stays browser-bundle-safe
+    // (the SDK consumer only imports tool schemas).
+    return readFileSync(absolutePath, "utf8");
+}
+export const GlobTool = {
+    schema: globSchema(),
+    execute: (args, ctx) => executeGlob(ctx.userHomeDir, args),
+};
+// ─── Tenant-config tools ────────────────────────────────────────
+//
+// These five mirror the per-user fs tools but operate on the
+// tenant-shared config tree at `<tenant>/workspace/_tenant/config/`.
+// Reads are unrestricted; writes are scope-gated (main agent vs
+// worker:<kind>) by `tenant-config-helper.checkWritable`.
+export const TenantConfigListTool = {
+    schema: tenantConfigListSchema(),
+    execute: (args, ctx) => executeTenantConfigList(ctx.tenantHomeDir, args),
+};
+export const TenantConfigReadTool = {
+    schema: tenantConfigReadSchema(),
+    execute: (args, ctx) => executeTenantConfigRead(ctx.tenantHomeDir, args),
+};
+export const TenantConfigWriteTool = {
+    schema: tenantConfigWriteSchema(),
+    execute: (args, ctx) => executeTenantConfigWrite(ctx.tenantHomeDir, scopeFromCtx(ctx), args),
+};
+export const TenantConfigEditTool = {
+    schema: tenantConfigEditSchema(),
+    execute: (args, ctx) => executeTenantConfigEdit(ctx.tenantHomeDir, scopeFromCtx(ctx), args),
+};
+export const TenantConfigDeleteTool = {
+    schema: tenantConfigDeleteSchema(),
+    execute: (args, ctx) => executeTenantConfigDelete(ctx.tenantHomeDir, scopeFromCtx(ctx), args),
+};
+export const TenantConfigGlobTool = {
+    schema: tenantConfigGlobSchema(),
+    execute: (args, ctx) => executeTenantConfigGlob(ctx.tenantHomeDir, args),
+};
+//# sourceMappingURL=index.js.map

package/plugins/files/dist/tools/index.js.map

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

package/plugins/files/dist/tools/list-dir.d.ts

@@ -0,0 +1,24 @@
+import type { Tool } from "@earendil-works/pi-ai";
+interface ListEntry {
+    name: string;
+    path: string;
+    type: "directory" | "file" | "other";
+    size: number;
+    modifiedMs: number;
+}
+export interface ListDirToolResult {
+    ok: boolean;
+    text: string;
+    entries?: ListEntry[];
+    truncated?: boolean;
+}
+/** Build the tool definition (Type schema) and a separate executor.
+ *  Keeping these separate lets the chat handler register the schema
+ *  with pi-ai while invoking the executor inside its own loop with
+ *  the per-request user home. */
+export declare function listDirSchema(): Tool;
+export declare function executeListDir(userHome: string, args: {
+    path?: string;
+}): ListDirToolResult;
+export {};
+//# sourceMappingURL=list-dir.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-dir.d.ts","sourceRoot":"","sources":["../../src/tools/list-dir.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AASlD,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;iCAGiC;AACjC,wBAAgB,aAAa,IAAI,IAAI,CAmBpC;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACtB,iBAAiB,CAwEnB"}