@nodetool-ai/agents 0.7.0-rc.22 → 0.8.1

package/dist/capabilities/compositions.js

@@ -0,0 +1,384 @@
+/**
+ * The `compositions` capability module — reusable timeline templates,
+ * headlessly.
+ *
+ * A composition is a group clip plus its children and the parameters that vary
+ * (`@nodetool-ai/timeline`'s `composition.ts`). Two kinds exist and both read
+ * the same way: the ones NodeTool ships, JSON files under
+ * `packages/base-nodes/nodetool/examples/compositions/`, and the ones a user
+ * saved, ordinary JSON assets carrying a marker under
+ * `metadata.nodetool_composition` — the entity pattern (D11).
+ *
+ * Inserting one is not here: it is the `insert_composition` op on
+ * `edit_timeline`, so a template lands through the same bridge every other
+ * document edit goes through (I11).
+ */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import nodePath from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadMediaRefBytes } from "@nodetool-ai/runtime";
+import { DEFAULT_LIMIT, MAX_LIMIT, deleteCompositionSpec, getCompositionSpec, listCompositionsSpec, saveCompositionSpec } from "./compositions.specs.js";
+import { userIdOf } from "../tools/mcp-tool-support.js";
+import { isRecord, isString } from "../utils/type-guards.js";
+/** The metadata key a saved composition's marker lives under. */
+export const COMPOSITION_METADATA_KEY = "nodetool_composition";
+/** File suffix of a shipped composition. */
+const SHIPPED_SUFFIX = ".composition.json";
+/** Assets the library scans for markers. */
+const COMPOSITION_ASSET_LIMIT = 1000;
+const isError = (value) => isRecord(value) && isString(value.error);
+/**
+ * Where the shipped compositions live: an explicit override, then the packaged
+ * layout (`examples/compositions` next to `server.mjs`), then the checkout.
+ *
+ * The three roots are the same ones every other shipped-example reader walks;
+ * this module resolves them itself rather than taking a loader on the run,
+ * because a composition is read with no user and no database.
+ */
+export function shippedCompositionsDir() {
+    const override = process.env["NODETOOL_EXAMPLE_COMPOSITIONS_DIR"];
+    if (override)
+        return existsSync(override) ? override : null;
+    const here = nodePath.dirname(fileURLToPath(import.meta.url));
+    const candidates = [];
+    // The packaged backend: `examples/` sits next to the bundled server.
+    for (let up = 1; up <= 4; up += 1) {
+        candidates.push(nodePath.join(here, ...Array(up).fill(".."), "examples", "compositions"));
+    }
+    // The checkout: walk up to the repo root and read base-nodes' examples.
+    let cursor = here;
+    for (let up = 0; up < 8; up += 1) {
+        candidates.push(nodePath.join(cursor, "packages", "base-nodes", "nodetool", "examples", "compositions"));
+        cursor = nodePath.dirname(cursor);
+    }
+    return candidates.find((dir) => existsSync(dir)) ?? null;
+}
+function readShippedFile(dir, file) {
+    // The names only ever come from readdirSync, but resolve and check
+    // containment anyway so no future caller can read outside the directory.
+    const root = nodePath.resolve(dir);
+    const target = nodePath.resolve(root, file);
+    if (target !== root && !target.startsWith(root + nodePath.sep))
+        return null;
+    try {
+        const parsed = JSON.parse(readFileSync(target, "utf8"));
+        return isComposition(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Whether a parsed value carries the shape a composition must have. */
+export function isComposition(value) {
+    if (!isRecord(value))
+        return false;
+    return (isString(value["id"]) &&
+        isString(value["name"]) &&
+        isRecord(value["group"]) &&
+        Array.isArray(value["children"]) &&
+        isRecord(value["params"]));
+}
+/** Every composition NodeTool ships, sorted by id. */
+export function loadShippedCompositions() {
+    const dir = shippedCompositionsDir();
+    if (!dir)
+        return [];
+    let files;
+    try {
+        files = readdirSync(dir).filter((file) => file.endsWith(SHIPPED_SUFFIX));
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const file of files.sort((a, b) => a.localeCompare(b))) {
+        const composition = readShippedFile(dir, file);
+        if (composition)
+            out.push(composition);
+    }
+    return out;
+}
+/** Every composition this user saved, newest asset first. */
+export async function loadUserCompositions(run) {
+    const userId = userIdOf(run.context);
+    if (!userId)
+        return { error: "No user is bound to this session." };
+    const { Asset } = await import("@nodetool-ai/models");
+    const [assets] = await Asset.paginate(userId, {
+        contentType: "application",
+        limit: COMPOSITION_ASSET_LIMIT
+    });
+    const marked = assets.filter((asset) => isRecord(asset.metadata?.[COMPOSITION_METADATA_KEY]));
+    const out = [];
+    for (const asset of marked) {
+        const composition = await readCompositionAsset(run, asset.id);
+        if (composition)
+            out.push({ ...composition, id: asset.id });
+    }
+    return out;
+}
+async function readCompositionAsset(run, assetId) {
+    try {
+        const bytes = await loadMediaRefBytes({ uri: `asset://${assetId}`, asset_id: assetId }, run.context);
+        if (!bytes || bytes.length === 0)
+            return null;
+        const parsed = JSON.parse(new TextDecoder().decode(bytes));
+        return isComposition(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * One composition by id: a shipped slug wins, then the user's assets. The
+ * shipped set is checked first because its ids are slugs and an asset id is a
+ * uuid — they cannot collide, and a shipped read needs no database.
+ */
+export async function loadComposition(run, compositionId) {
+    const shipped = loadShippedCompositions().find((comp) => comp.id === compositionId);
+    if (shipped)
+        return { composition: shipped, source: "shipped" };
+    const userId = userIdOf(run.context);
+    if (!userId)
+        return null;
+    const { Asset } = await import("@nodetool-ai/models");
+    const asset = await Asset.find(userId, compositionId);
+    if (!asset || !isRecord(asset.metadata?.[COMPOSITION_METADATA_KEY])) {
+        return null;
+    }
+    const composition = await readCompositionAsset(run, asset.id);
+    if (!composition)
+        return null;
+    return {
+        composition: { ...composition, id: asset.id },
+        source: "user"
+    };
+}
+/** The summary shape `list_compositions` returns, one row per template. */
+const compositionRow = (composition, source) => ({
+    id: composition.id,
+    name: composition.name,
+    description: composition.description ?? "",
+    source,
+    duration_ms: composition.group.durationMs,
+    child_count: composition.children.length,
+    params: Object.entries(composition.params ?? {}).map(([name, param]) => ({
+        name,
+        type: param.type,
+        default: param.default
+    }))
+});
+const listCompositions = {
+    spec: listCompositionsSpec,
+    impl: async (run, params) => {
+        const wanted = isString(params["source"]) ? params["source"] : "";
+        const rows = [];
+        if (wanted !== "user") {
+            for (const composition of loadShippedCompositions()) {
+                rows.push(compositionRow(composition, "shipped"));
+            }
+        }
+        if (wanted !== "shipped") {
+            const mine = await loadUserCompositions(run);
+            if (isError(mine)) {
+                // A session with no user still lists the shipped half rather than
+                // failing: those need no database at all.
+                if (wanted === "user")
+                    return mine;
+            }
+            else {
+                for (const composition of mine) {
+                    rows.push(compositionRow(composition, "user"));
+                }
+            }
+        }
+        const query = isString(params["query"])
+            ? params["query"].trim().toLowerCase()
+            : "";
+        const matched = query
+            ? rows.filter((row) => row.name.toLowerCase().includes(query) ||
+                row.description.toLowerCase().includes(query))
+            : rows;
+        const requested = Number(params["limit"] ?? DEFAULT_LIMIT);
+        const limit = Number.isFinite(requested)
+            ? Math.min(Math.max(Math.trunc(requested), 1), MAX_LIMIT)
+            : DEFAULT_LIMIT;
+        return {
+            compositions: matched.slice(0, limit),
+            count: Math.min(matched.length, limit),
+            total: matched.length
+        };
+    }
+};
+const getComposition = {
+    spec: getCompositionSpec,
+    impl: async (run, params) => {
+        const compositionId = params["composition_id"];
+        if (!isString(compositionId) || compositionId.trim() === "") {
+            return {
+                error: "composition_id is required (use list_compositions to find one)."
+            };
+        }
+        const loaded = await loadComposition(run, compositionId.trim());
+        if (!loaded) {
+            const known = loadShippedCompositions().map((comp) => comp.id);
+            return {
+                error: `Composition ${compositionId} was not found. Shipped ones: ${known.join(", ")}.`
+            };
+        }
+        return { composition: loaded.composition, source: loaded.source };
+    }
+};
+const saveComposition = {
+    spec: saveCompositionSpec,
+    impl: async (run, params) => {
+        const timelineId = params["timeline_id"];
+        const groupTarget = params["group_target"];
+        const name = params["name"];
+        if (!isString(timelineId) || timelineId.trim() === "") {
+            return { error: "timeline_id is required." };
+        }
+        if (!isString(groupTarget) || groupTarget.trim() === "") {
+            return { error: "group_target is required (a group clip id or name)." };
+        }
+        if (!isString(name) || name.trim() === "") {
+            return { error: "name is required and must be a non-empty string." };
+        }
+        const rawParams = params["params"];
+        if (!isRecord(rawParams)) {
+            return {
+                error: 'params is required: {"<name>": {type, default, path}} naming what varies.'
+            };
+        }
+        const userId = userIdOf(run.context);
+        if (!userId)
+            return { error: "No user is bound to this session." };
+        const { TimelineSequence } = await import("@nodetool-ai/models");
+        const seq = await TimelineSequence.findById(timelineId.trim());
+        // A sequence owned by someone else reads as missing.
+        if (!seq || seq.user_id !== userId) {
+            return { error: `Timeline ${timelineId} was not found.` };
+        }
+        const stored = isString(seq.document)
+            ? JSON.parse(seq.document)
+            : seq.document;
+        if (!isRecord(stored) || !Array.isArray(stored["clips"])) {
+            return { error: `Timeline ${seq.id} has no readable document.` };
+        }
+        const clips = stored["clips"];
+        const wanted = groupTarget.trim();
+        const match = clips.find((clip) => clip.id === wanted) ??
+            clips.find((clip) => (clip.name ?? "").toLowerCase() === wanted.toLowerCase());
+        if (!match) {
+            const groups = clips.filter((clip) => clip.mediaType === "group");
+            return {
+                error: `No clip matching "${wanted}" is on timeline ${seq.id}. ` +
+                    (groups.length > 0
+                        ? `Groups: ${groups.map((g) => `${g.id} ("${g.name}")`).join(", ")}.`
+                        : "It has no groups — make one with the add_group op first.")
+            };
+        }
+        const { extractComposition } = await import("@nodetool-ai/timeline");
+        let composition;
+        const extractOptions = {
+            name: name.trim()
+        };
+        if (isString(params["description"])) {
+            extractOptions.description = params["description"];
+        }
+        try {
+            composition = extractComposition(
+            // SAFETY: the clips came out of the stored document, which the
+            // timeline schema wrote; extractComposition reads only ids, times,
+            // mediaType and parentId, and refuses anything else by message.
+            { clips: stored["clips"] }, match.id, 
+            // SAFETY: the parameter bag is the caller's, and extractComposition
+            // checks every declared type and pointer before it returns.
+            rawParams, extractOptions);
+        }
+        catch (error) {
+            return { error: error instanceof Error ? error.message : String(error) };
+        }
+        const fileName = `${name.trim().replace(/[^\w.-]+/g, "-")}.composition.json`;
+        let created;
+        try {
+            created = await run.context.createAsset({
+                name: fileName,
+                contentType: "application/json",
+                content: new TextEncoder().encode(`${JSON.stringify(composition, null, 2)}\n`)
+            });
+        }
+        catch (error) {
+            return {
+                error: `Could not save the composition asset: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+        const assetId = isRecord(created) && isString(created["id"]) ? created["id"] : null;
+        if (!assetId) {
+            return { error: "The composition asset was created without an id." };
+        }
+        const { Asset } = await import("@nodetool-ai/models");
+        const asset = await Asset.find(userId, assetId);
+        if (!asset) {
+            return { error: `Composition asset ${assetId} was not readable.` };
+        }
+        const marker = {
+            name: composition.name,
+            param_names: Object.keys(composition.params ?? {})
+        };
+        if (composition.description !== undefined) {
+            marker.description = composition.description;
+        }
+        asset.metadata = {
+            ...(asset.metadata ?? {}),
+            [COMPOSITION_METADATA_KEY]: marker
+        };
+        await asset.save();
+        return {
+            composition_id: assetId,
+            asset_id: assetId,
+            source: "user",
+            composition: { ...composition, id: assetId }
+        };
+    }
+};
+const deleteComposition = {
+    spec: deleteCompositionSpec,
+    impl: async (run, params) => {
+        const compositionId = params["composition_id"];
+        if (!isString(compositionId) || compositionId.trim() === "") {
+            return {
+                error: "composition_id is required (use list_compositions to find one)."
+            };
+        }
+        const id = compositionId.trim();
+        if (loadShippedCompositions().some((comp) => comp.id === id)) {
+            return {
+                error: `"${id}" is a composition NodeTool ships, so it cannot be deleted. Save your own and delete that instead.`
+            };
+        }
+        const userId = userIdOf(run.context);
+        if (!userId)
+            return { error: "No user is bound to this session." };
+        const { Asset } = await import("@nodetool-ai/models");
+        const asset = await Asset.find(userId, id);
+        if (!asset || !isRecord(asset.metadata?.[COMPOSITION_METADATA_KEY])) {
+            return { error: `Composition ${id} was not found.` };
+        }
+        await asset.delete();
+        return { ok: true, composition_id: id };
+    }
+};
+/** Every composition capability, in declaration order. */
+export const COMPOSITION_CAPABILITIES = [
+    listCompositions,
+    getComposition,
+    saveComposition,
+    deleteComposition
+];
+export const module = {
+    module: "compositions",
+    exports: COMPOSITION_CAPABILITIES
+};
+export { listCompositions, getComposition, saveComposition, deleteComposition };
+//# sourceMappingURL=compositions.js.map

package/dist/capabilities/compositions.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * The `compositions` module's specs — data only, no implementation.
+ *
+ * Same split the entities module keeps: the registry's eager spec table imports
+ * this file and never `compositions.ts`, so the models package stays out of the
+ * entry graph.
+ */
+import type { JsonSchema } from "@nodetool-ai/runtime";
+import type { CapabilitySpec } from "./types.js";
+export declare const DEFAULT_LIMIT = 100;
+export declare const MAX_LIMIT = 500;
+export declare const LIST_COMPOSITIONS_SCHEMA: JsonSchema;
+export declare const listCompositionsSpec: CapabilitySpec;
+export declare const GET_COMPOSITION_SCHEMA: JsonSchema;
+export declare const getCompositionSpec: CapabilitySpec;
+export declare const SAVE_COMPOSITION_SCHEMA: JsonSchema;
+export declare const saveCompositionSpec: CapabilitySpec;
+export declare const DELETE_COMPOSITION_SCHEMA: JsonSchema;
+export declare const deleteCompositionSpec: CapabilitySpec;
+/** Every spec this module declares, in declaration order. */
+export declare const compositionsSpecs: readonly CapabilitySpec[];
+//# sourceMappingURL=compositions.specs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compositions.specs.d.ts","sourceRoot":"","sources":["../../src/capabilities/compositions.specs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B,eAAO,MAAM,wBAAwB,EAAE,UAqBtC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cAWlC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,UAUpC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAWhC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,UA6BrC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAWjC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,UASvC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,cAUnC,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAKtD,CAAC"}

package/dist/capabilities/compositions.specs.js

@@ -0,0 +1,126 @@
+/**
+ * The `compositions` module's specs — data only, no implementation.
+ *
+ * Same split the entities module keeps: the registry's eager spec table imports
+ * this file and never `compositions.ts`, so the models package stays out of the
+ * entry graph.
+ */
+export const DEFAULT_LIMIT = 100;
+export const MAX_LIMIT = 500;
+export const LIST_COMPOSITIONS_SCHEMA = {
+    type: "object",
+    properties: {
+        source: {
+            type: "string",
+            enum: ["shipped", "user"],
+            description: 'Only the templates NodeTool ships ("shipped") or only the ones this ' +
+                'user saved ("user"). Omit for both.'
+        },
+        query: {
+            type: "string",
+            description: "Only compositions whose name or description contains this text " +
+                "(case-insensitive)."
+        },
+        limit: {
+            type: "number",
+            description: `Max compositions to return (default ${DEFAULT_LIMIT}, max ${MAX_LIMIT}).`
+        }
+    }
+};
+export const listCompositionsSpec = {
+    name: "list_compositions",
+    description: "List the timeline compositions available to this user: the templates " +
+        "NodeTool ships (title card, lower third, caption bar, callout, CTA end " +
+        "card, logo sting) and the ones saved from a timeline. Each row carries " +
+        "the id, name, description, parameter names and whether it is shipped or " +
+        "the user's. Insert one with the edit_timeline op insert_composition.",
+    inputSchema: LIST_COMPOSITIONS_SCHEMA,
+    category: "read",
+    userMessage: () => "Listing compositions"
+};
+export const GET_COMPOSITION_SCHEMA = {
+    type: "object",
+    properties: {
+        composition_id: {
+            type: "string",
+            description: "The composition's id — a shipped slug, or the asset id of a saved one."
+        }
+    },
+    required: ["composition_id"]
+};
+export const getCompositionSpec = {
+    name: "get_composition",
+    description: "Read one composition in full: its group clip, its child clips with times " +
+        "relative to the group start, and every parameter with its type, default " +
+        "and the JSON pointer it writes into. Read this before overriding a " +
+        "parameter — the names and types are the template's, not a convention.",
+    inputSchema: GET_COMPOSITION_SCHEMA,
+    category: "read",
+    userMessage: (params) => `Reading composition ${String(params["composition_id"])}`
+};
+export const SAVE_COMPOSITION_SCHEMA = {
+    type: "object",
+    properties: {
+        timeline_id: {
+            type: "string",
+            description: "The timeline the group lives on."
+        },
+        group_target: {
+            type: "string",
+            description: "The group clip to turn into a template, by clip id or name. It must " +
+                "be a clip made with the add_group op."
+        },
+        name: { type: "string", description: "Name for the saved composition." },
+        description: {
+            type: "string",
+            description: "What the template is for, one line."
+        },
+        params: {
+            type: "object",
+            description: 'The values that vary, as {"<name>": {type, default, path, ' +
+                'description?}}. `type` is one of string, number, color, boolean; ' +
+                '`path` is a JSON pointer into the children array, e.g. ' +
+                '"/1/textStyle/text" for the text of the second child. A path that ' +
+                "addresses nothing is refused rather than saved."
+        }
+    },
+    required: ["timeline_id", "group_target", "name", "params"]
+};
+export const saveCompositionSpec = {
+    name: "save_composition",
+    description: "Save a group on a timeline as a reusable composition. The group and every " +
+        "clip parented to it are copied into a template with child times rebased " +
+        "to the group start, and stored as a JSON asset in the user's library. " +
+        "Declare in `params` which values vary; everything else is fixed by the " +
+        "template.",
+    inputSchema: SAVE_COMPOSITION_SCHEMA,
+    category: "write",
+    userMessage: (params) => `Saving composition "${String(params["name"])}"`
+};
+export const DELETE_COMPOSITION_SCHEMA = {
+    type: "object",
+    properties: {
+        composition_id: {
+            type: "string",
+            description: "The saved composition's id, from list_compositions."
+        }
+    },
+    required: ["composition_id"]
+};
+export const deleteCompositionSpec = {
+    name: "delete_composition",
+    description: "Delete a saved composition. Clips already instantiated from it keep " +
+        "working — they are ordinary clips — they just lose the template behind " +
+        "their compositionId. A shipped composition cannot be deleted.",
+    inputSchema: DELETE_COMPOSITION_SCHEMA,
+    category: "write",
+    userMessage: (params) => `Deleting composition ${String(params["composition_id"])}`
+};
+/** Every spec this module declares, in declaration order. */
+export const compositionsSpecs = [
+    listCompositionsSpec,
+    getCompositionSpec,
+    saveCompositionSpec,
+    deleteCompositionSpec
+];
+//# sourceMappingURL=compositions.specs.js.map

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

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

package/dist/capabilities/concurrency.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Bounded parallelism for capabilities that fan one call out over many items —
+ * voicing script lines, rendering storyboard shots, fetching thread previews.
+ * A `concurrency` argument comes from a model, so it is clamped rather than
+ * trusted.
+ */
+export declare const DEFAULT_CONCURRENCY = 3;
+export declare const MAX_CONCURRENCY = 8;
+export declare function clampConcurrency(value: unknown): number;
+/** Run `task` over `items`, at most `limit` in flight. */
+export declare function mapWithConcurrency<T, R>(items: T[], limit: number, task: (item: T) => Promise<R>): Promise<R[]>;
+//# sourceMappingURL=concurrency.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/capabilities/concurrency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIvD;AAED,0DAA0D;AAC1D,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAC3C,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,CAAC,EAAE,CAAC,CAed"}

package/dist/capabilities/concurrency.js

@@ -0,0 +1,30 @@
+/**
+ * Bounded parallelism for capabilities that fan one call out over many items —
+ * voicing script lines, rendering storyboard shots, fetching thread previews.
+ * A `concurrency` argument comes from a model, so it is clamped rather than
+ * trusted.
+ */
+export const DEFAULT_CONCURRENCY = 3;
+export const MAX_CONCURRENCY = 8;
+export function clampConcurrency(value) {
+    const n = Math.floor(Number(value));
+    if (!Number.isFinite(n) || n < 1)
+        return DEFAULT_CONCURRENCY;
+    return Math.min(n, MAX_CONCURRENCY);
+}
+/** Run `task` over `items`, at most `limit` in flight. */
+export async function mapWithConcurrency(items, limit, task) {
+    const results = new Array(items.length);
+    let next = 0;
+    const workers = Array.from({ length: Math.min(limit, items.length) }, async () => {
+        for (;;) {
+            const index = next++;
+            if (index >= items.length)
+                return;
+            results[index] = await task(items[index]);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/capabilities/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/capabilities/concurrency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AAEjC,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,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,mBAAmB,CAAC;IAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;AACtC,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAU,EACV,KAAa,EACb,IAA6B;IAE7B,MAAM,OAAO,GAAG,IAAI,KAAK,CAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CACxB,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EACzC,KAAK,IAAI,EAAE;QACT,SAAS,CAAC;YACR,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC;YACrB,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YAClC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CACF,CAAC;IACF,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/capabilities/costs.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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 type { CapabilityExport, CapabilityModule } from "./types.js";
+declare const getCostSummary: CapabilityExport;
+export declare const COST_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+export { getCostSummary };
+//# sourceMappingURL=costs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"costs.d.ts","sourceRoot":"","sources":["../../src/capabilities/costs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAWrE,QAAA,MAAM,cAAc,EAAE,gBASrB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,SAAS,gBAAgB,EAAqB,CAAC;AAE/E,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC"}