@nodetool-ai/agents 0.7.0-rc.23 → 0.8.2

package/dist/capabilities/costs.js

@@ -0,0 +1,40 @@
+/**
+ * The `costs` capability module — what this account has spent.
+ *
+ * A run that picks its own models is spending the user's money, and until now
+ * it had no way to see the bill: `nodetool costs` reads the prediction ledger
+ * from the CLI, the Costs dashboard reads it over tRPC, and sandboxed code
+ * could reach neither. Reading is the whole module. There is deliberately no
+ * counterpart that adjusts a budget or buys credit — see the withheld table in
+ * `api-coverage.ts`.
+ *
+ * Scoped to the caller: `aggregateDashboard` takes the user id and every query
+ * behind it filters on that column, so one account's spend is all a run can
+ * ever see.
+ */
+import { userIdOf } from "../tools/mcp-tool-support.js";
+import { getCostSummarySpec } from "./costs.specs.js";
+/** Clamp a caller-supplied window to what the aggregate accepts. */
+function bounded(value, fallback, max) {
+    const n = Math.floor(Number(value));
+    if (!Number.isFinite(n) || n < 1)
+        return fallback;
+    return Math.min(n, max);
+}
+const getCostSummary = {
+    spec: getCostSummarySpec,
+    impl: async (run, params) => {
+        const { Prediction } = await import("@nodetool-ai/models");
+        return Prediction.aggregateDashboard(userIdOf(run.context), {
+            days: bounded(params["days"], 14, 365),
+            executionsLimit: bounded(params["executions_limit"], 50, 1000)
+        });
+    }
+};
+export const COST_CAPABILITIES = [getCostSummary];
+export const module = {
+    module: "costs",
+    exports: COST_CAPABILITIES
+};
+export { getCostSummary };
+//# sourceMappingURL=costs.js.map

package/dist/capabilities/costs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"costs.js","sourceRoot":"","sources":["../../src/capabilities/costs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,oEAAoE;AACpE,SAAS,OAAO,CAAC,KAAc,EAAE,QAAgB,EAAE,GAAW;IAC5D,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,cAAc,GAAqB;IACvC,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;QAC1B,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAC3D,OAAO,UAAU,CAAC,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;YAC1D,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC;YACtC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC;SAC/D,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAgC,CAAC,cAAc,CAAC,CAAC;AAE/E,MAAM,CAAC,MAAM,MAAM,GAAqB;IACtC,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,iBAAiB;CAC3B,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/capabilities/costs.specs.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The `costs` module's specs — data only, no implementation.
+ *
+ * Split out so a belt can be assembled synchronously: the registry's eager
+ * spec table imports this file, never `costs.ts`, so nothing the
+ * implementation pulls in reaches the entry graph.
+ */
+import type { CapabilitySpec } from "./types.js";
+export declare const getCostSummarySpec: CapabilitySpec;
+/** Every spec this module declares, in declaration order. */
+export declare const costsSpecs: readonly CapabilitySpec[];
+//# sourceMappingURL=costs.specs.d.ts.map

package/dist/capabilities/costs.specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"costs.specs.d.ts","sourceRoot":"","sources":["../../src/capabilities/costs.specs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,kBAAkB,EAAE,cA0BhC,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,UAAU,EAAE,SAAS,cAAc,EAAyB,CAAC"}

package/dist/capabilities/costs.specs.js

@@ -0,0 +1,35 @@
+/**
+ * The `costs` module's specs — data only, no implementation.
+ *
+ * Split out so a belt can be assembled synchronously: the registry's eager
+ * spec table imports this file, never `costs.ts`, so nothing the
+ * implementation pulls in reaches the entry graph.
+ */
+export const getCostSummarySpec = {
+    name: "get_cost_summary",
+    description: "What this account has spent on model calls over a trailing window: " +
+        "totals per provider and per model, a daily series, and the most recent " +
+        "executions. Read it before an expensive run to see what a comparable " +
+        "one cost.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            days: {
+                type: "number",
+                description: "Length of the trailing window in days (1–365).",
+                default: 14
+            },
+            executions_limit: {
+                type: "number",
+                description: "How many recent executions to include (1–1000).",
+                default: 50
+            }
+        },
+        required: []
+    },
+    category: "read",
+    userMessage: (params) => `Reading spend for the last ${Number(params["days"] ?? 14)} days`
+};
+/** Every spec this module declares, in declaration order. */
+export const costsSpecs = [getCostSummarySpec];
+//# sourceMappingURL=costs.specs.js.map

package/dist/capabilities/costs.specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"costs.specs.js","sourceRoot":"","sources":["../../src/capabilities/costs.specs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,kBAAkB;IACxB,WAAW,EACT,qEAAqE;QACrE,yEAAyE;QACzE,uEAAuE;QACvE,WAAW;IACb,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;gBAC7D,OAAO,EAAE,EAAE;aACZ;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iDAAiD;gBAC9D,OAAO,EAAE,EAAE;aACZ;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CACtB,8BAA8B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO;CACpE,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,UAAU,GAA8B,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/capabilities/dispatcher.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The per-invocation dispatcher for capability modules — the guest's way into
+ * the platform, and the exact analog of the host-module dispatcher next door.
+ *
+ * It is a *second* dispatcher, not a widened one.
+ * `createSandboxHostDispatcher` stays pure functions over plain data: a library
+ * pack that could see a run context would hold the action's capabilities, which
+ * is what the consent design exists to prevent. This one carries a
+ * `CapabilityRun`, and it is mounted by the host, never by a pack.
+ *
+ * A generated facade is a convenience; it is not what holds the line. Every
+ * call arrives with three untrusted values — the module key, the export name,
+ * and the argument list — and every one is checked before anything runs:
+ *
+ * - the module key must be a specifier **this run mounted**;
+ * - the export name must be a capability that module registers;
+ * - the arguments must be a one-element list carrying an arguments record.
+ *
+ * Then it calls `run.invoke`, which is where the permission gate lives. The
+ * dispatcher does not gate on its own — a call through the import path and the
+ * same call through the belt bridge reach one implementation past one gate.
+ *
+ * Design: docs/tool-class-retirement-design.md § "The dispatcher change".
+ */
+import { type SandboxCapabilityModuleSpec } from "@nodetool-ai/protocol";
+import type { CapabilityRun } from "./types.js";
+/** Raised when a call breaks the capability module contract. */
+export declare class SandboxCapabilityError extends Error {
+    constructor(message: string);
+}
+export interface SandboxCapabilityDispatcher {
+    /** Specifiers this run may call, in registry order. */
+    readonly specifiers: readonly string[];
+    /**
+     * The one entry point guest code reaches. Every argument is untrusted and
+     * validated here before the capability is looked up, let alone gated.
+     */
+    call(moduleKey: unknown, exportName: unknown, args: unknown): Promise<unknown>;
+}
+/**
+ * Build the dispatcher for one invocation over the given registry modules.
+ *
+ * A module is mounted whether or not this run can serve every capability in
+ * it: a capability whose run dependency is missing fails at call time with the
+ * message it has always failed with. Availability of a *module* is the host's
+ * mount decision; availability of a *capability* is the implementation's.
+ */
+export declare function createCapabilityDispatcher(run: CapabilityRun, moduleKeys?: readonly string[], options?: {
+    signal?: AbortSignal;
+}): SandboxCapabilityDispatcher;
+/**
+ * The guest-visible identity of each mounted module: what a facade is generated
+ * from. Loading a module is what reveals its export names, so this is the one
+ * asynchronous half of the mount.
+ */
+export declare function capabilityModuleSpecs(moduleKeys: readonly string[]): Promise<readonly SandboxCapabilityModuleSpec[]>;
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/capabilities/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/capabilities/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,uBAAuB,CAAC;AAM/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,gEAAgE;AAChE,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,MAAM,WAAW,2BAA2B;IAC1C,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC;;;OAGG;IACH,IAAI,CACF,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,aAAa,EAClB,UAAU,GAAE,SAAS,MAAM,EAA4B,EACvD,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACrC,2BAA2B,CAgE7B;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC,CAWjD"}

package/dist/capabilities/dispatcher.js

@@ -0,0 +1,117 @@
+/**
+ * The per-invocation dispatcher for capability modules — the guest's way into
+ * the platform, and the exact analog of the host-module dispatcher next door.
+ *
+ * It is a *second* dispatcher, not a widened one.
+ * `createSandboxHostDispatcher` stays pure functions over plain data: a library
+ * pack that could see a run context would hold the action's capabilities, which
+ * is what the consent design exists to prevent. This one carries a
+ * `CapabilityRun`, and it is mounted by the host, never by a pack.
+ *
+ * A generated facade is a convenience; it is not what holds the line. Every
+ * call arrives with three untrusted values — the module key, the export name,
+ * and the argument list — and every one is checked before anything runs:
+ *
+ * - the module key must be a specifier **this run mounted**;
+ * - the export name must be a capability that module registers;
+ * - the arguments must be a one-element list carrying an arguments record.
+ *
+ * Then it calls `run.invoke`, which is where the permission gate lives. The
+ * dispatcher does not gate on its own — a call through the import path and the
+ * same call through the belt bridge reach one implementation past one gate.
+ *
+ * Design: docs/tool-class-retirement-design.md § "The dispatcher change".
+ */
+import { sandboxCapabilitySpecifier } from "@nodetool-ai/protocol";
+import { compactResourceIds } from "../codeact/compact-ids.js";
+import { extractErrorPayload, toTransferable } from "../codeact/tool-api.js";
+import { coerceCapabilityArgs } from "./args.js";
+import { listCapabilityModules, loadCapabilityModule } from "./registry.js";
+import { isString } from "../utils/type-guards.js";
+/** Raised when a call breaks the capability module contract. */
+export class SandboxCapabilityError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SandboxCapabilityError";
+    }
+}
+/**
+ * Build the dispatcher for one invocation over the given registry modules.
+ *
+ * A module is mounted whether or not this run can serve every capability in
+ * it: a capability whose run dependency is missing fails at call time with the
+ * message it has always failed with. Availability of a *module* is the host's
+ * mount decision; availability of a *capability* is the implementation's.
+ */
+export function createCapabilityDispatcher(run, moduleKeys = listCapabilityModules(), options = {}) {
+    const registered = new Set(listCapabilityModules());
+    const bySpecifier = new Map();
+    for (const module of moduleKeys) {
+        if (!registered.has(module)) {
+            throw new SandboxCapabilityError(`no capability module is registered for "${module}"`);
+        }
+        bySpecifier.set(sandboxCapabilitySpecifier(module), module);
+    }
+    return {
+        specifiers: [...bySpecifier.keys()],
+        async call(moduleKey, exportName, args) {
+            if (options.signal?.aborted === true) {
+                throw new SandboxCapabilityError("the run was cancelled");
+            }
+            const module = isString(moduleKey) ? bySpecifier.get(moduleKey) : undefined;
+            if (module === undefined) {
+                throw new SandboxCapabilityError(`${describe(moduleKey)} is not a capability module mounted for this session`);
+            }
+            const loaded = await loadCapabilityModule(module);
+            const found = isString(exportName)
+                ? loaded.exports.find((entry) => entry.spec.name === exportName)
+                : undefined;
+            if (found === undefined) {
+                throw new SandboxCapabilityError(`${moduleKey} has no export named ${describe(exportName)}`);
+            }
+            if (!Array.isArray(args)) {
+                throw new SandboxCapabilityError(`${moduleKey}: ${found.spec.name} was called with a non-list argument`);
+            }
+            let record;
+            try {
+                record = coerceCapabilityArgs(found.spec, args);
+            }
+            catch (error) {
+                throw new SandboxCapabilityError(`${moduleKey}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            // Plain data out, exactly as the belt bridge hands it over, so the two
+            // paths cannot show the guest different values for one call — including
+            // an `{error}` payload, which is a failure to throw on rather than a
+            // value to compute with. A gate refusal arrives that way.
+            const value = toTransferable(await run.invoke(found.spec.name, record));
+            const failure = extractErrorPayload(value);
+            if (failure !== null) {
+                throw new SandboxCapabilityError(`${found.spec.name}: ${failure}`);
+            }
+            // Short ids from here on: the guest, and so the observation, reads the
+            // 12-char form that every capability accepts back.
+            return toTransferable(compactResourceIds(value));
+        }
+    };
+}
+/**
+ * The guest-visible identity of each mounted module: what a facade is generated
+ * from. Loading a module is what reveals its export names, so this is the one
+ * asynchronous half of the mount.
+ */
+export async function capabilityModuleSpecs(moduleKeys) {
+    return Promise.all(moduleKeys.map(async (module) => {
+        const loaded = await loadCapabilityModule(module);
+        return {
+            module,
+            specifier: sandboxCapabilitySpecifier(module),
+            exports: loaded.exports.map((entry) => entry.spec.name)
+        };
+    }));
+}
+function describe(value) {
+    if (isString(value))
+        return JSON.stringify(value);
+    return `a ${value === null ? "null" : typeof value} value`;
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/capabilities/dispatcher.js.map

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

package/dist/capabilities/documents.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The `documents` capability module — PDF extraction and Pandoc conversion.
+ *
+ * Five capabilities that used to be five `Tool` subclasses in
+ * `pdf-tools.ts`. Wire names, descriptions and schemas are unchanged; a belt
+ * builds all five from `documents.specs.ts` by name.
+ *
+ * The PDF parser (`@llamaindex/liteparse`) is imported inside the extraction
+ * helper, as it always was — loading this module costs a handful of node
+ * builtins and nothing else.
+ *
+ * Design: docs/tool-class-retirement-design.md § "PRs 4–9 — remaining
+ * namespaces".
+ */
+import type { CapabilityExport, CapabilityModule } from "./types.js";
+declare const extractPdfText: CapabilityExport;
+declare const extractPdfTables: CapabilityExport;
+declare const convertPdfToMarkdown: CapabilityExport;
+declare const convertMarkdownToPdf: CapabilityExport;
+declare const convertDocument: CapabilityExport;
+/** Every document capability, in the order pdf-tools.ts declared them. */
+export declare const DOCUMENT_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+export { extractPdfText, extractPdfTables, convertPdfToMarkdown, convertMarkdownToPdf, convertDocument };
+//# sourceMappingURL=documents.d.ts.map

package/dist/capabilities/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/capabilities/documents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA+FrE,QAAA,MAAM,cAAc,EAAE,gBAwBrB,CAAC;AAMF,QAAA,MAAM,gBAAgB,EAAE,gBA+DvB,CAAC;AAMF,QAAA,MAAM,oBAAoB,EAAE,gBAqC3B,CAAC;AAMF,QAAA,MAAM,oBAAoB,EAAE,gBA8B3B,CAAC;AAMF,QAAA,MAAM,eAAe,EAAE,gBAqCtB,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,qBAAqB,EAAE,SAAS,gBAAgB,EAM5D,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EAChB,CAAC"}

package/dist/capabilities/documents.js

@@ -0,0 +1,278 @@
+/**
+ * The `documents` capability module — PDF extraction and Pandoc conversion.
+ *
+ * Five capabilities that used to be five `Tool` subclasses in
+ * `pdf-tools.ts`. Wire names, descriptions and schemas are unchanged; a belt
+ * builds all five from `documents.specs.ts` by name.
+ *
+ * The PDF parser (`@llamaindex/liteparse`) is imported inside the extraction
+ * helper, as it always was — loading this module costs a handful of node
+ * builtins and nothing else.
+ *
+ * Design: docs/tool-class-retirement-design.md § "PRs 4–9 — remaining
+ * namespaces".
+ */
+import { readFile, writeFile, mkdir, lstat, realpath } from "node:fs/promises";
+import { dirname, isAbsolute, relative } from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { extractPdfTextSpec, extractPdfTablesSpec, convertPdfToMarkdownSpec, convertMarkdownToPdfSpec, convertDocumentSpec } from "./documents.specs.js";
+import { isString } from "../utils/type-guards.js";
+const execFileAsync = promisify(execFile);
+/**
+ * True when `candidate`'s real (symlink-resolved) path stays within the real
+ * workspace root. `context.resolveWorkspacePath` only checks containment
+ * lexically, so an in-workspace symlink pointing outside the root would
+ * otherwise be dereferenced and leak host files. Mirrors the shared helper in
+ * edit-search-tools.ts (kept local — that copy is module-private there).
+ */
+async function isRealPathWithinRoot(root, candidate) {
+    try {
+        const realRoot = await realpath(root);
+        const realCandidate = await realpath(candidate);
+        if (realCandidate === realRoot)
+            return true;
+        const rel = relative(realRoot, realCandidate);
+        return rel !== "" && !rel.startsWith("..") && !isAbsolute(rel);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Like {@link isRealPathWithinRoot} but tolerant of a not-yet-created output
+ * file: when the candidate does not exist, its parent directory is
+ * realpath-checked instead, so writing through a symlinked-out directory is
+ * still blocked. Uses lstat (not access) so a dangling in-workspace symlink is
+ * treated as existing-but-out-of-root rather than absent.
+ */
+async function isWriteTargetWithinRoot(root, candidate) {
+    if (await isRealPathWithinRoot(root, candidate))
+        return true;
+    const parent = dirname(candidate);
+    if (parent === candidate)
+        return false;
+    try {
+        await lstat(candidate);
+        return false;
+    }
+    catch {
+        return isRealPathWithinRoot(root, parent);
+    }
+}
+/**
+ * Verify a workspace-resolved path stays inside the workspace after resolving
+ * symlinks, throwing on escape. Uses the not-yet-created-tolerant check for
+ * both reads and writes (matching edit-search-tools): a missing read target
+ * passes containment here and then fails naturally with the tool's own
+ * "not found" error, rather than being mislabeled as an escape.
+ */
+async function assertWithinWorkspace(context, resolvedPath) {
+    const root = context.resolveWorkspacePath(".");
+    if (!(await isWriteTargetWithinRoot(root, resolvedPath))) {
+        throw new Error(`Path resolves outside the workspace: ${resolvedPath}`);
+    }
+}
+/**
+ * Extract text from a PDF buffer using @llamaindex/liteparse.
+ * Returns per-page text so callers can slice by page range.
+ */
+async function extractPdfPages(buffer) {
+    const { LiteParse } = await import("@llamaindex/liteparse");
+    const parser = new LiteParse({ ocrEnabled: false });
+    const result = await parser.parse(buffer, true);
+    const pages = result.pages.map((p) => p.text);
+    return { pages, numPages: result.pages.length };
+}
+// ---------------------------------------------------------------------------
+// extract_pdf_text
+// ---------------------------------------------------------------------------
+const extractPdfText = {
+    spec: extractPdfTextSpec,
+    impl: async (run, params) => {
+        const context = run.context;
+        try {
+            const filePath = context.resolveWorkspacePath(params["path"]);
+            await assertWithinWorkspace(context, filePath);
+            const buffer = await readFile(filePath);
+            const { pages } = await extractPdfPages(buffer);
+            const startPage = params["start_page"] ?? 0;
+            const endPage = params["end_page"] ?? -1;
+            if (startPage === 0 && endPage === -1) {
+                return { text: pages.join("\n") };
+            }
+            const end = endPage === -1 ? pages.length - 1 : endPage;
+            const selectedPages = pages.slice(startPage, end + 1);
+            return { text: selectedPages.join("\n") };
+        }
+        catch (e) {
+            return { error: String(e instanceof Error ? e.message : e) };
+        }
+    }
+};
+// ---------------------------------------------------------------------------
+// extract_pdf_tables
+// ---------------------------------------------------------------------------
+const extractPdfTables = {
+    spec: extractPdfTablesSpec,
+    impl: async (run, params) => {
+        const context = run.context;
+        try {
+            const filePath = context.resolveWorkspacePath(params["path"]);
+            const outputFile = context.resolveWorkspacePath(params["output_file"]);
+            await assertWithinWorkspace(context, filePath);
+            const buffer = await readFile(filePath);
+            const { pages } = await extractPdfPages(buffer);
+            const startPage = params["start_page"] ?? 0;
+            const endPage = params["end_page"] ?? -1;
+            const end = endPage === -1 ? pages.length - 1 : endPage;
+            // Best-effort table extraction: look for lines with consistent
+            // column-like separators (multiple spaces or tabs)
+            const allTables = [];
+            for (let pageNum = startPage; pageNum <= end && pageNum < pages.length; pageNum++) {
+                const pageText = pages[pageNum] ?? "";
+                const lines = pageText
+                    .split("\n")
+                    .filter((l) => l.trim().length > 0);
+                // Detect tabular rows: lines with 2+ segments separated by 2+ spaces
+                const tabularLines = [];
+                for (const line of lines) {
+                    const cells = line
+                        .split(/\s{2,}/)
+                        .filter((c) => c.trim().length > 0);
+                    if (cells.length >= 2) {
+                        tabularLines.push(cells);
+                    }
+                }
+                // Group consecutive tabular lines into tables
+                if (tabularLines.length >= 2) {
+                    allTables.push({
+                        page: pageNum,
+                        rows: tabularLines.length,
+                        columns: Math.max(...tabularLines.map((r) => r.length)),
+                        content: tabularLines
+                    });
+                }
+            }
+            await assertWithinWorkspace(context, outputFile);
+            const parentDir = dirname(outputFile);
+            await mkdir(parentDir, { recursive: true });
+            await writeFile(outputFile, JSON.stringify(allTables), "utf-8");
+            return { output_file: outputFile };
+        }
+        catch (e) {
+            return { error: String(e instanceof Error ? e.message : e) };
+        }
+    }
+};
+// ---------------------------------------------------------------------------
+// convert_pdf_to_markdown
+// ---------------------------------------------------------------------------
+const convertPdfToMarkdown = {
+    spec: convertPdfToMarkdownSpec,
+    impl: async (run, params) => {
+        const context = run.context;
+        try {
+            const inputFile = context.resolveWorkspacePath(params["input_file"]);
+            const outputFile = context.resolveWorkspacePath(params["output_file"]);
+            await assertWithinWorkspace(context, inputFile);
+            const buffer = await readFile(inputFile);
+            const { pages } = await extractPdfPages(buffer);
+            const startPage = params["start_page"] ?? 0;
+            const endPage = params["end_page"] ?? -1;
+            let mdText;
+            if (startPage !== 0 || endPage !== -1) {
+                const end = endPage === -1 ? pages.length - 1 : endPage;
+                mdText = pages.slice(startPage, end + 1).join("\n");
+            }
+            else {
+                mdText = pages.join("\n");
+            }
+            await assertWithinWorkspace(context, outputFile);
+            const parentDir = dirname(outputFile);
+            await mkdir(parentDir, { recursive: true });
+            await writeFile(outputFile, mdText, "utf-8");
+            return { output_file: outputFile };
+        }
+        catch (e) {
+            return { error: String(e instanceof Error ? e.message : e) };
+        }
+    }
+};
+// ---------------------------------------------------------------------------
+// convert_markdown_to_pdf
+// ---------------------------------------------------------------------------
+const convertMarkdownToPdf = {
+    spec: convertMarkdownToPdfSpec,
+    impl: async (run, params) => {
+        const context = run.context;
+        try {
+            const inputFile = context.resolveWorkspacePath(params["input_file"]);
+            const outputFile = context.resolveWorkspacePath(params["output_file"]);
+            const parentDir = dirname(outputFile);
+            await mkdir(parentDir, { recursive: true });
+            await execFileAsync("pandoc", [
+                inputFile,
+                "-f",
+                "markdown",
+                "-t",
+                "pdf",
+                "-o",
+                outputFile
+            ]);
+            return { output_file: outputFile, status: "success" };
+        }
+        catch (e) {
+            return { error: String(e instanceof Error ? e.message : e) };
+        }
+    }
+};
+// ---------------------------------------------------------------------------
+// convert_document
+// ---------------------------------------------------------------------------
+const convertDocument = {
+    spec: convertDocumentSpec,
+    impl: async (run, params) => {
+        const context = run.context;
+        try {
+            const inputFile = context.resolveWorkspacePath(params["input_file"]);
+            const outputFile = context.resolveWorkspacePath(params["output_file"]);
+            const fromFormat = params["from_format"] ?? "markdown";
+            const toFormat = params["to_format"] ?? "pdf";
+            let extraArgs = params["extra_args"] ?? [];
+            if (isString(extraArgs)) {
+                extraArgs = [extraArgs];
+            }
+            const parentDir = dirname(outputFile);
+            await mkdir(parentDir, { recursive: true });
+            await execFileAsync("pandoc", [
+                inputFile,
+                "-f",
+                fromFormat,
+                "-t",
+                toFormat,
+                "-o",
+                outputFile,
+                ...extraArgs
+            ]);
+            return { output_file: outputFile, status: "success" };
+        }
+        catch (e) {
+            return { error: String(e instanceof Error ? e.message : e) };
+        }
+    }
+};
+/** Every document capability, in the order pdf-tools.ts declared them. */
+export const DOCUMENT_CAPABILITIES = [
+    extractPdfText,
+    extractPdfTables,
+    convertPdfToMarkdown,
+    convertMarkdownToPdf,
+    convertDocument
+];
+export const module = {
+    module: "documents",
+    exports: DOCUMENT_CAPABILITIES
+};
+export { extractPdfText, extractPdfTables, convertPdfToMarkdown, convertMarkdownToPdf, convertDocument };
+//# sourceMappingURL=documents.js.map

package/dist/capabilities/documents.js.map

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

package/dist/capabilities/documents.specs.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The `documents` module's specs — data only, no implementation.
+ *
+ * Split out so a belt can be assembled synchronously: the registry's eager
+ * spec table imports this file, never `documents.ts`, so nothing the
+ * implementations pull in reaches the entry graph. `documents.ts` imports these
+ * back and attaches each to its implementation, so there is one spec object
+ * behind both halves.
+ */
+import type { CapabilitySpec } from "./types.js";
+export declare const extractPdfTextSpec: CapabilitySpec;
+export declare const extractPdfTablesSpec: CapabilitySpec;
+export declare const convertPdfToMarkdownSpec: CapabilitySpec;
+export declare const convertMarkdownToPdfSpec: CapabilitySpec;
+export declare const convertDocumentSpec: CapabilitySpec;
+/** Every spec this module declares, in declaration order. */
+export declare const documentsSpecs: readonly CapabilitySpec[];
+//# sourceMappingURL=documents.specs.d.ts.map

package/dist/capabilities/documents.specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.specs.d.ts","sourceRoot":"","sources":["../../src/capabilities/documents.specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,kBAAkB,EAAE,cA6BhC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cAoClC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,cAoCtC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,cA0BtC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cA4CjC,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,cAAc,EAAE,SAAS,cAAc,EAMnD,CAAC"}