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

package/dist/capabilities/apps.specs.js

@@ -0,0 +1,236 @@
+/**
+ * The `apps` 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 `apps.ts`, so nothing the
+ * implementations pull in reaches the entry graph. `apps.ts` imports these
+ * back and attaches each to its implementation, so there is one spec object
+ * behind both halves.
+ */
+import { isString } from "../utils/type-guards.js";
+export const DEBUG_APP_SCHEMA = {
+    type: "object",
+    properties: {
+        application_id: {
+            type: "string",
+            description: "The ID of a saved application to debug. Give this or `document`, not both."
+        },
+        document: {
+            type: "object",
+            description: "An application document to debug inline, for an app that is not " +
+                "saved (or whose draft differs from the saved row). Give this or " +
+                "`application_id`, not both."
+        },
+        params: {
+            type: "object",
+            description: "Input values keyed by input name, seeded before the run"
+        },
+        interact: {
+            type: "array",
+            items: { type: "object" },
+            description: "User actions to simulate, in order. Each step is one of " +
+                "{set: {key, value, operationId?}}, {click: <widget>}, " +
+                "{change: {…}}, {run: <operationId>}, {cancel: <operationId>}, " +
+                "{seedResource: {id, items}}. Widgets are named by component id, " +
+                "by a type only one widget has, or by a unique label. Omit this " +
+                "to click the app's natural run trigger."
+        },
+        run: {
+            type: "boolean",
+            description: "Execute the app's operations (default true). false checks the " +
+                "wiring only — free and instant."
+        },
+        timeout_ms: {
+            type: "number",
+            description: "Wall clock for the whole debug run"
+        },
+        poll: {
+            type: "boolean",
+            description: "Return a session id as soon as the run starts instead of waiting " +
+                "for it (default false)"
+        }
+    },
+    required: []
+};
+export const debugAppSpec = {
+    name: "debug_app",
+    description: "Debug a mini APP (not a workflow): validate every widget binding, " +
+        "simulate the app the way the web runtime does, execute its operations " +
+        "on the kernel, and return each widget's final state plus a pass/fail " +
+        "verdict with the issues behind it. Pass `application_id` for a saved " +
+        "app or `document` for an unsaved one — exactly one of them. With " +
+        "run=false this is a static wiring check that runs in milliseconds and " +
+        "costs nothing; use it after every wiring change. A full run executes " +
+        "the real workflows and spends real money, so run it to confirm the app " +
+        "works, not to explore. Use `interact` to script the user actions to " +
+        "simulate. A long run takes minutes; pass poll=true to get a session id " +
+        "back immediately, then read GET /api/debug/sessions/<id> until it " +
+        "settles.",
+    inputSchema: DEBUG_APP_SCHEMA,
+    category: "execute",
+    userMessage: (params) => {
+        const target = params["application_id"];
+        const label = isString(target) && target.trim() ? ` ${target}` : " draft";
+        return params["run"] === false
+            ? `Checking app${label} wiring`
+            : `Debugging app${label}`;
+    }
+};
+export const listAppsSpec = {
+    name: "list_apps",
+    description: "List the mini apps in this account, newest first, with each app's " +
+        "operations and when it was last changed.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            limit: {
+                type: "number",
+                description: "How many apps to return (1-100).",
+                default: 50
+            }
+        },
+        required: []
+    },
+    category: "read",
+    userMessage: () => "Listing apps"
+};
+export const getAppSpec = {
+    name: "get_app",
+    description: "Read one of your mini apps: its document — operations, variables and " +
+        "the widget tree — the same document debug_app simulates.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            application_id: { type: "string", description: "The app to read" }
+        },
+        required: ["application_id"]
+    },
+    category: "read",
+    userMessage: (params) => `Reading app ${params["application_id"]}`
+};
+export const deleteAppSpec = {
+    name: "delete_app",
+    description: "Delete a mini app you own. The workflows its operations bind are left " +
+        "alone — only the app record goes. An app belonging to another user is " +
+        "reported as missing.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            application_id: { type: "string", description: "The app to delete" }
+        },
+        required: ["application_id"]
+    },
+    category: "write",
+    userMessage: (params) => `Deleting app ${params["application_id"]}`
+};
+export const CREATE_APP_SCHEMA = {
+    type: "object",
+    properties: {
+        name: { type: "string", description: "What the app is called" },
+        description: {
+            type: "string",
+            description: "One line on what the app does"
+        },
+        project_id: {
+            type: "string",
+            description: "Project to file the app under (default `default`)"
+        },
+        from_workflow_id: {
+            type: "string",
+            description: "Start with one operation already bound to this workflow, so the " +
+                "app has something to run the moment a widget is placed."
+        },
+        document: {
+            type: "object",
+            description: "A complete application document to start from. Omit it for an " +
+                "empty app and build it up with edit_app."
+        }
+    },
+    required: ["name"]
+};
+export const createAppSpec = {
+    name: "create_app",
+    description: "Create an empty mini APP (not a workflow) and return its id. This is " +
+        "the first step of building one: create it, place and wire the widgets " +
+        "with edit_app, then grade it with debug_app. Pass `from_workflow_id` " +
+        "to bind its first operation to a workflow you already built.",
+    inputSchema: CREATE_APP_SCHEMA,
+    category: "write",
+    userMessage: (params) => {
+        const name = params["name"];
+        return isString(name) && name.trim()
+            ? `Creating app ${name}`
+            : "Creating app";
+    }
+};
+export const EDIT_APP_SCHEMA = {
+    type: "object",
+    properties: {
+        application_id: { type: "string", description: "The app to edit" },
+        steps: {
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    tool: {
+                        type: "string",
+                        description: "An App Builder tool name, with or without the `ui_app_` " +
+                            "prefix — e.g. `add_component`, `ui_app_add_operation`. Call " +
+                            "with an empty `steps` list to see every tool and its schema."
+                    },
+                    input: {
+                        type: "object",
+                        description: "That tool's arguments"
+                    }
+                },
+                required: ["tool"]
+            },
+            description: "The edits to apply, in order. They run against the saved " +
+                "document and the result is saved once, at the end."
+        },
+        name: { type: "string", description: "Rename the app" },
+        description: { type: "string", description: "Re-describe the app" },
+        workflow_ids: {
+            type: "array",
+            items: { type: "string" },
+            description: "Workflows to load the bindable surface of, on top of the ones the " +
+                "app's operations already name. Bind a widget to a workflow this " +
+                "app does not use yet by naming it here."
+        },
+        base_updated_at: {
+            type: "string",
+            description: "The `updated_at` this edit was written against. Given, the save " +
+                "is refused when the app changed since — nothing is written."
+        }
+    },
+    required: ["application_id"]
+};
+export const editAppSpec = {
+    name: "edit_app",
+    description: "Edit a mini APP by driving the App Builder tools headlessly: place " +
+        "and wire widgets, declare operations, variables and resources. Each " +
+        "step names one `ui_app_*` tool and its arguments; they apply in order " +
+        "to the saved document, which is written back once at the end. Call it " +
+        "with no steps to read the tool catalog and the app's current state. " +
+        "Check the result with debug_app({run: false}) — free and instant — " +
+        "before running the app for real.",
+    inputSchema: EDIT_APP_SCHEMA,
+    category: "write",
+    userMessage: (params) => {
+        const steps = params["steps"];
+        const count = Array.isArray(steps) ? steps.length : 0;
+        return count === 0
+            ? `Reading app ${params["application_id"]} editor`
+            : `Editing app ${params["application_id"]} (${count} steps)`;
+    }
+};
+/** Every spec this module declares, in declaration order. */
+export const appsSpecs = [
+    debugAppSpec,
+    listAppsSpec,
+    getAppSpec,
+    createAppSpec,
+    editAppSpec,
+    deleteAppSpec
+];
+//# sourceMappingURL=apps.specs.js.map

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

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

package/dist/capabilities/args.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Guest and model calls miss the documented argument shape in a few
+ * predictable ways: camelCase keys where the schema is snake_case, a lone
+ * string where the first required field is a string, a name plus an options
+ * object, `id` where the schema says `workflow_id`. Fold those here so every
+ * entrance (import, belt, MCP) agrees.
+ *
+ * Nested records are left alone — Apify actor input keeps its own names.
+ *
+ * What is left over after folding is checked rather than passed on. A call
+ * that supplied arguments but not the required ones used to reach the
+ * implementation with the key `undefined`, and the implementation then reported
+ * on the *entity*: `get_workflow({ id })` came back "Workflow undefined was not
+ * found", which reads as a missing workflow and is really a misspelled
+ * argument. The report belongs to the call.
+ */
+import type { JsonSchema } from "@nodetool-ai/runtime";
+import { type ZodType } from "zod";
+export interface CapabilityArgSpec {
+    readonly name: string;
+    readonly inputSchema: JsonSchema;
+}
+/**
+ * Copy camelCase keys onto their snake_case form when the snake_case key is
+ * absent. `actorId` becomes `actor_id`; an already-set `actor_id` wins.
+ */
+export declare function withSnakeCaseAliases(args: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Turn the argument list a guest call produced into the one record the
+ * implementation reads.
+ *
+ * A leading string fills the first required string field when that field is
+ * missing from a following options object — `save_asset("reel.mp4", {source})`
+ * and `get_apify_actor_schema("owner/name")`.
+ *
+ * Throws when the folded record is still missing a required field, naming the
+ * call rather than letting the implementation report on an entity it looked up
+ * under `undefined`.
+ */
+export declare function coerceCapabilityArgs(spec: CapabilityArgSpec, args: readonly unknown[]): Record<string, unknown>;
+/**
+ * Validate one call's arguments against the spec's Zod schema, for the
+ * handful of capabilities whose identity is that schema.
+ *
+ * The one implementation of the check. `gatedCall` runs it for a registry
+ * entry reached through `invoke` (guest code, `run.invoke`); the lazy `Tool`
+ * runs it for a belt call, where the entry `capabilityFromTool` builds carries
+ * no schema. Every entrance therefore validates exactly once, and returns the
+ * same `invalid_tool_arguments` envelope `Tool.execute` used to return.
+ *
+ * The reserved protocol fields are not part of any schema: they are lifted out
+ * before the parse and `_tool_call_id` is put back on the parsed args, so a
+ * capability that asked for it still receives it.
+ */
+export declare function validateCapabilityArgs(spec: {
+    readonly name: string;
+    readonly zodSchema?: ZodType;
+}, args: Record<string, unknown>): {
+    ok: true;
+    args: Record<string, unknown>;
+} | {
+    ok: false;
+    error: Record<string, unknown>;
+};
+//# sourceMappingURL=args.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/capabilities/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAK,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAMtC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,SAAS,OAAO,EAAE,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzB;AAgID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,EAC7D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAE3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC3C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAsChD"}

package/dist/capabilities/args.js

@@ -0,0 +1,218 @@
+/**
+ * Guest and model calls miss the documented argument shape in a few
+ * predictable ways: camelCase keys where the schema is snake_case, a lone
+ * string where the first required field is a string, a name plus an options
+ * object, `id` where the schema says `workflow_id`. Fold those here so every
+ * entrance (import, belt, MCP) agrees.
+ *
+ * Nested records are left alone — Apify actor input keeps its own names.
+ *
+ * What is left over after folding is checked rather than passed on. A call
+ * that supplied arguments but not the required ones used to reach the
+ * implementation with the key `undefined`, and the implementation then reported
+ * on the *entity*: `get_workflow({ id })` came back "Workflow undefined was not
+ * found", which reads as a missing workflow and is really a misspelled
+ * argument. The report belongs to the call.
+ */
+import { parseWithTypeCoercion } from "@nodetool-ai/runtime";
+import { z } from "zod";
+import { USER_MESSAGE_FIELD } from "../tools/base-tool.js";
+import { TOOL_CALL_ID_FIELD } from "../tools/subtask-fields.js";
+import { isRecord, isString } from "../utils/type-guards.js";
+/**
+ * Copy camelCase keys onto their snake_case form when the snake_case key is
+ * absent. `actorId` becomes `actor_id`; an already-set `actor_id` wins.
+ */
+export function withSnakeCaseAliases(args) {
+    const out = { ...args };
+    for (const [key, value] of Object.entries(args)) {
+        if (!/[A-Z]/.test(key))
+            continue;
+        const snake = key.replace(/[A-Z]/g, (ch) => `_${ch.toLowerCase()}`);
+        if (!(snake in out)) {
+            out[snake] = value;
+        }
+    }
+    return out;
+}
+/**
+ * Turn the argument list a guest call produced into the one record the
+ * implementation reads.
+ *
+ * A leading string fills the first required string field when that field is
+ * missing from a following options object — `save_asset("reel.mp4", {source})`
+ * and `get_apify_actor_schema("owner/name")`.
+ *
+ * Throws when the folded record is still missing a required field, naming the
+ * call rather than letting the implementation report on an entity it looked up
+ * under `undefined`.
+ */
+export function coerceCapabilityArgs(spec, args) {
+    const first = args[0];
+    if (args.length === 0 || first === undefined || first === null) {
+        return {};
+    }
+    if (isRecord(first) && args.length === 1) {
+        return checked(spec, withIdAlias(spec, withSnakeCaseAliases(first)));
+    }
+    if (isString(first)) {
+        const key = firstRequiredStringKey(spec.inputSchema);
+        if (key === undefined) {
+            throw new Error(oneObjectMessage(spec));
+        }
+        const extra = extraRecord(args[1], spec, args.length);
+        if (key in extra) {
+            return checked(spec, withSnakeCaseAliases(extra));
+        }
+        return checked(spec, withSnakeCaseAliases({ ...extra, [key]: first }));
+    }
+    if (isRecord(first) && args.length === 2 && isRecord(args[1])) {
+        return checked(spec, withIdAlias(spec, withSnakeCaseAliases({ ...first, ...args[1] })));
+    }
+    throw new Error(oneObjectMessage(spec));
+}
+/**
+ * Copy a bare `id` onto the one required `*_id` key when that key is absent.
+ *
+ * Only when there is exactly one such key, so nothing has to be guessed: a spec
+ * requiring both `workflow_id` and `job_id` gets no alias and the missing-key
+ * report below instead. `get_workflow`, `run_workflow`, `debug_workflow` and
+ * every other single-subject capability are what this covers, and `id` is what
+ * a caller reaches for after `create_workflow` answered with a record whose own
+ * field is `id`.
+ */
+function withIdAlias(spec, args) {
+    const id = args["id"];
+    if (id === undefined || id === null)
+        return args;
+    const [key, ...rest] = requiredKeys(spec.inputSchema).filter((name) => name.endsWith("_id"));
+    if (key === undefined || rest.length > 0)
+        return args;
+    if (args[key] !== undefined && args[key] !== null)
+        return args;
+    return { ...args, [key]: id };
+}
+/**
+ * The required keys a record does not carry. `null` counts as missing: it is
+ * what a guest reaching for an absent field passes, and `String(null)` reaching
+ * a lookup is the same wrong answer `undefined` gives.
+ */
+function missingRequiredArgs(spec, args) {
+    return requiredKeys(spec.inputSchema).filter((key) => args[key] === undefined || args[key] === null);
+}
+/**
+ * Name the call, the keys it is missing, and — when it passed something — what
+ * it passed instead, which is usually the whole diagnosis.
+ *
+ * A key that is present but null/undefined has to be called out, or the report
+ * contradicts itself: `edit_storyboard({storyboard_id, ops})` with an unset
+ * variable read "missing required argument storyboard_id. Got: storyboard_id,
+ * ops", which sends the caller hunting for a spelling that was already right
+ * instead of at the value that never got computed.
+ */
+function missingArgsMessage(spec, missing, args) {
+    const plural = missing.length === 1 ? "argument" : "arguments";
+    const got = Object.keys(args);
+    const gotPart = got.length > 0 ? ` Got: ${got.join(", ")}.` : " Got no arguments.";
+    const empty = missing.filter((key) => key in args);
+    const emptyPart = empty.length === 0
+        ? ""
+        : ` ${empty.join(", ")} ${empty.length === 1 ? "was" : "were"} ` +
+            `passed as null/undefined — the key is right, the value is missing.`;
+    return (`${spec.name}: missing required ${plural} ${missing.join(", ")}.` +
+        gotPart +
+        emptyPart);
+}
+/**
+ * Refuse a call that brought arguments but not the required ones. A call with
+ * no arguments at all is left alone: `{}` reaching the implementation is the
+ * documented shape for the several capabilities whose schema requires nothing,
+ * and for the rest the implementation's own "x is required" already names the
+ * field rather than an entity.
+ */
+function checked(spec, args) {
+    if (Object.keys(args).length === 0)
+        return args;
+    const missing = missingRequiredArgs(spec, args);
+    if (missing.length > 0) {
+        throw new Error(missingArgsMessage(spec, missing, args));
+    }
+    return args;
+}
+function requiredKeys(schema) {
+    const required = schema.required;
+    if (!Array.isArray(required))
+        return [];
+    return required.filter((key) => isString(key));
+}
+function extraRecord(second, spec, length) {
+    if (length <= 1 || second === undefined) {
+        return {};
+    }
+    if (!isRecord(second)) {
+        throw new Error(oneObjectMessage(spec));
+    }
+    return second;
+}
+function firstRequiredStringKey(schema) {
+    const properties = schema.properties;
+    for (const key of requiredKeys(schema)) {
+        const field = isRecord(properties) ? properties[key] : undefined;
+        if (isRecord(field) && field.type === "string") {
+            return key;
+        }
+    }
+    return undefined;
+}
+function oneObjectMessage(spec) {
+    const keys = requiredKeys(spec.inputSchema);
+    const shape = keys.length > 0 ? ` ({ ${keys.join(", ")} })` : "";
+    return `${spec.name} takes one arguments object${shape}`;
+}
+/**
+ * Validate one call's arguments against the spec's Zod schema, for the
+ * handful of capabilities whose identity is that schema.
+ *
+ * The one implementation of the check. `gatedCall` runs it for a registry
+ * entry reached through `invoke` (guest code, `run.invoke`); the lazy `Tool`
+ * runs it for a belt call, where the entry `capabilityFromTool` builds carries
+ * no schema. Every entrance therefore validates exactly once, and returns the
+ * same `invalid_tool_arguments` envelope `Tool.execute` used to return.
+ *
+ * The reserved protocol fields are not part of any schema: they are lifted out
+ * before the parse and `_tool_call_id` is put back on the parsed args, so a
+ * capability that asked for it still receives it.
+ */
+export function validateCapabilityArgs(spec, args) {
+    const schema = spec.zodSchema;
+    if (!schema)
+        return { ok: true, args };
+    const { [USER_MESSAGE_FIELD]: _message, [TOOL_CALL_ID_FIELD]: toolCallId, ...rest } = args;
+    const fail = (issues) => ({
+        ok: false,
+        error: {
+            error: "invalid_tool_arguments",
+            message: `Invalid arguments for ${spec.name}: ${issues.join("; ")}`,
+            issues
+        }
+    });
+    let parsed;
+    try {
+        parsed = parseWithTypeCoercion(schema, rest);
+    }
+    catch (error) {
+        return fail(error instanceof z.ZodError
+            ? error.issues.map((issue) => {
+                const path = issue.path.join(".");
+                return path ? `${path}: ${issue.message}` : issue.message;
+            })
+            : [String(error)]);
+    }
+    if (!isRecord(parsed))
+        return fail(["expected an object"]);
+    const out = parsed;
+    if (toolCallId !== undefined)
+        out[TOOL_CALL_ID_FIELD] = toolCallId;
+    return { ok: true, args: out };
+}
+//# sourceMappingURL=args.js.map

package/dist/capabilities/args.js.map

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

package/dist/capabilities/assets.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The `assets` capability module — everything an agent does with stored media.
+ *
+ * Eight capabilities that used to be eight `Tool` subclasses spread over four
+ * files: `list_assets` / `get_asset`, `save_asset` / `read_asset`,
+ * `asset_search` / `asset_list`, and `list_images` / `view_image`. The
+ * design's mapping table folds the library and image tools in here rather
+ * than leaving them beside the file tools.
+ *
+ * Wire names, descriptions and schemas are unchanged. `view_image` keeps its
+ * result shape to the byte: the executors strip `image_content` out of the
+ * result and forward the pixels as provider image blocks (`image-injection.ts`),
+ * so anything that reshapes it silently blinds the model.
+ *
+ * `list_images` and `view_image` are the two capabilities whose identity is a
+ * Zod schema rather than a hand-written JSON one. Their `inputSchema` is
+ * derived with `zodToJsonSchema` from the `zodSchema` their spec carries, and
+ * the argument check runs once per entrance in `validateCapabilityArgs`
+ * (`./args.ts`) — never here.
+ */
+import type { CapabilityExport, CapabilityModule } from "./types.js";
+declare const listAssets: CapabilityExport;
+declare const getAsset: CapabilityExport;
+declare const saveAsset: CapabilityExport;
+declare const readAsset: CapabilityExport;
+declare const assetSearch: CapabilityExport;
+declare const assetList: CapabilityExport;
+declare const listImages: CapabilityExport;
+declare const viewImage: CapabilityExport;
+/** Every asset capability, in the order `getAllMcpTools` offered them. */
+/**
+ * Rename or re-file one of the caller's own assets.
+ *
+ * Deliberately narrow. `Asset.find` is user-scoped, so another user's asset
+ * reads as missing; a move goes through `Asset.validateParent`, the same rule
+ * the tRPC route applies, so a run cannot detach a subtree by moving a folder
+ * under its own descendant. Content type is not settable: the stored file name
+ * is derived from it, so changing it without re-uploading the bytes would
+ * leave the asset pointing at a file nobody wrote.
+ */
+declare const updateAsset: CapabilityExport;
+export declare const ASSET_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+export { listAssets, getAsset, saveAsset, readAsset, assetSearch, assetList, listImages, viewImage, updateAsset };
+//# sourceMappingURL=assets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/capabilities/assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAyBH,OAAO,KAAK,EACV,gBAAgB,EAEhB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAiKpB,QAAA,MAAM,UAAU,EAAE,gBAyCjB,CAAC;AAMF,QAAA,MAAM,QAAQ,EAAE,gBASf,CAAC;AAiFF,QAAA,MAAM,SAAS,EAAE,gBA+IhB,CAAC;AAMF,QAAA,MAAM,SAAS,EAAE,gBAuGhB,CAAC;AAEF,QAAA,MAAM,WAAW,EAAE,gBAqClB,CAAC;AAEF,QAAA,MAAM,SAAS,EAAE,gBAmChB,CAAC;AAuDF,QAAA,MAAM,UAAU,EAAE,gBAGjB,CAAC;AA4TF,QAAA,MAAM,SAAS,EAAE,gBAGhB,CAAC;AAEF,0EAA0E;AAC1E;;;;;;;;;GASG;AACH,QAAA,MAAM,WAAW,EAAE,gBAqClB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,SAAS,gBAAgB,EAUzD,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EACL,UAAU,EACV,QAAQ,EACR,SAAS,EACT,SAAS,EACT,WAAW,EACX,SAAS,EACT,UAAU,EACV,SAAS,EACT,WAAW,EACZ,CAAC"}