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

package/dist/prompts/workflow-authoring-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-authoring-knowledge.d.ts","sourceRoot":"","sources":["../../src/prompts/workflow-authoring-knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,oBAAoB,GACpB,gBAAgB,GAChB,8BAA8B,GAC9B,oBAAoB,GACpB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,UAAU,EAAE,qBAAqB,CAAC;IAClC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAqEpD,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAerD,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,CAAC;IAC7D,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,CAAC;CAClE;AAED,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE,SAAS,aAAa,EAAqB,GACnD,uBAAuB,CAmBzB;AAWD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,YAAY,GAAE,SAAS,aAAa,EAAqB,GACxD,MAAM,CA0KR;AAED,8DAA8D;AAC9D,eAAO,MAAM,4BAA4B,QAAqC,CAAC"}

package/dist/prompts/workflow-authoring-knowledge.js

@@ -0,0 +1,319 @@
+/**
+ * What an agent has to know to author a NodeTool workflow, independent of the
+ * surface authoring it.
+ *
+ * The DSL pack's own SKILL.md and {@link GRAPH_DSL_PROMPT_SECTION} teach the
+ * mechanics — how to import a namespace, wire a handle, and hand the graph to
+ * `validate`/`create`/`run`. None of that says which node to reach for, which
+ * properties a run fills in, or which of two similar nodes produces a value
+ * the next node can use. That knowledge lives here, rendered once and shared
+ * by the chat CodeAct prompt and the headless graph-authoring sub-agent, so
+ * the two cannot drift.
+ *
+ * The generic AI catalog lives here too: it is the table the prompt renders
+ * and the list a registry check verifies, and keeping both against one array
+ * is what stops the prompt from advertising a node that was renamed.
+ */
+import { isFunction } from "../utils/type-guards.js";
+/**
+ * Provider-agnostic nodes to reach for FIRST when the user asks for AI
+ * generation or transformation of any kind.
+ */
+export const GENERIC_AI_NODES = [
+    {
+        type: "nodetool.image.TextToImage",
+        capability: "text_to_image",
+        task: "Text → Image",
+        summary: "Generate an image from a text prompt. Required: prompt, model.",
+        acceptsModel: true
+    },
+    {
+        type: "nodetool.image.ImageToImage",
+        capability: "image_to_image",
+        task: "Image → Image",
+        summary: "Transform a source image with a text prompt. Required: image, prompt, model.",
+        acceptsModel: true
+    },
+    {
+        type: "nodetool.video.TextToVideo",
+        capability: "text_to_video",
+        task: "Text → Video",
+        summary: "Generate a video from a text prompt. Required: prompt, model.",
+        acceptsModel: true
+    },
+    {
+        type: "nodetool.video.ImageToVideo",
+        capability: "image_to_video",
+        task: "Image → Video",
+        summary: "Animate a source image into a video. Required: image, prompt, model.",
+        acceptsModel: true
+    },
+    {
+        type: "nodetool.video.ReferenceToVideo",
+        capability: "reference_to_video",
+        task: "Reference → Video",
+        summary: "Generate a video guided by ordered reference images and videos. Required: at least one reference image or video, prompt, model.",
+        acceptsModel: true
+    },
+    {
+        type: "nodetool.audio.TextToSpeech",
+        capability: "text_to_speech",
+        task: "Text → Speech",
+        summary: "Generate speech audio from text. Required: text, model. Optional: voice.",
+        acceptsModel: true
+    },
+    {
+        type: "nodetool.text.AutomaticSpeechRecognition",
+        capability: "automatic_speech_recognition",
+        task: "Speech → Text",
+        summary: "Transcribe audio to text. Required: audio, model.",
+        acceptsModel: true
+    },
+    {
+        type: "nodetool.text.Embedding",
+        capability: "generate_embedding",
+        task: "Text → Embedding",
+        summary: "Compute a text embedding vector. Required: text, model.",
+        acceptsModel: true
+    },
+    {
+        type: "nodetool.agents.Agent",
+        capability: "generate_message",
+        task: "LLM step (reasoning / generation)",
+        summary: "LLM step: pass a prompt in, get text out on the `text` handle. Inherits the run's configured model — do NOT set a model property.",
+        acceptsModel: false
+    }
+];
+/** Deterministic baseline namespaces — search inside these for non-AI work. */
+export const CORE_BASELINE_NAMESPACES = [
+    "nodetool.control",
+    "nodetool.text",
+    "nodetool.image",
+    "nodetool.video",
+    "nodetool.audio",
+    "nodetool.data",
+    "nodetool.code",
+    "nodetool.constant",
+    "nodetool.input",
+    "nodetool.output",
+    "lib.os",
+    "nodetool.document",
+    "nodetool.vector",
+    "nodetool.triggers"
+];
+/**
+ * Partition {@link GENERIC_AI_NODES} into nodes the registry actually has and
+ * nodes it doesn't. The curated table is hand-maintained (capability → node
+ * isn't encoded in node metadata), so this keeps it honest at runtime: a node
+ * that gets renamed or removed shows up in `missing` instead of being silently
+ * advertised to the agent.
+ *
+ * When the registry can't be introspected (a stub) or knows none of the
+ * generic nodes (not yet populated with base-nodes / platform-filtered), the
+ * full catalog is returned with no `missing` — better a complete prompt than a
+ * blank one.
+ */
+export function resolveAvailableGenericNodes(registry, catalog = GENERIC_AI_NODES) {
+    const lookup = isFunction(registry?.resolveMetadata)
+        ? (type) => registry.resolveMetadata(type)
+        : isFunction(registry?.getMetadata)
+            ? (type) => registry.getMetadata(type)
+            : null;
+    if (!lookup)
+        return { available: [...catalog], missing: [] };
+    const available = [];
+    const missing = [];
+    for (const node of catalog) {
+        if (lookup(node.type) != null)
+            available.push(node);
+        else
+            missing.push(node.type);
+    }
+    if (available.length === 0)
+        return { available: [...catalog], missing: [] };
+    return { available, missing };
+}
+function renderGenericNodeTable(nodes) {
+    const rows = nodes.map((n) => `| ${n.task} | \`${n.type}\` | \`${n.capability}\` |`);
+    return ["| Task | node_type | Capability |", "|---|---|---|", ...rows].join("\n");
+}
+/**
+ * Render the shared knowledge section.
+ *
+ * @param genericNodes the AI catalog to advertise; pass a registry-checked
+ *   subset so the prompt never names a node this install lacks.
+ */
+export function renderWorkflowAuthoringKnowledge(genericNodes = GENERIC_AI_NODES) {
+    return `## Picking nodes
+
+Never guess a node type. \`nodetool.nodes.search(["what the step does"])\`
+with a broad category term ("image generation", "color filter" — not a guessed
+class name), then \`nodetool.nodes.info(type)\` for the exact properties and
+handles before you import that node's namespace.
+
+Prefer \`nodetool.*\` core nodes. Deterministic library nodes under \`lib.*\`
+(\`lib.image.filter.*\`, \`lib.image.color_grading.*\`, \`lib.grid.*\`,
+\`lib.svg.*\`) are fine too — they are not provider-locked. Provider-specific
+nodes are FORBIDDEN unless the user named that provider ("use OpenAI's image
+API"); they are hidden from search results until you pass
+\`{include_provider_nodes: true}\`.
+
+### Generic AI nodes — one of these for ANY AI generation or transform
+
+${renderGenericNodeTable(genericNodes)}
+
+Each takes a \`model\` property (a \`{provider, id}\` object) except
+\`nodetool.agents.Agent\`, which inherits the run's configured model when you
+omit \`model\`. Do not invent model ids: \`nodetool.models.pick(capability)\`
+returns one, and its \`ref\` field is the value the property wants.
+
+Deterministic, non-AI work lives in ${CORE_BASELINE_NAMESPACES.join(", ")},
+plus any \`lib.*\` namespace.
+
+## Agent steps
+
+\`agent({system, prompt})\` from \`nodetool.agents\` is the LLM step. Two rules
+it fails on otherwise:
+
+- **Omit \`model\`.** The run stamps its own model in at execution time; setting
+  one pins the node to that model forever.
+- **Read the text as \`.output("text")\`.** The node has \`text\`, \`chunk\`,
+  \`thinking\` and \`audio\` handles and no default, so a bare \`.output()\`
+  throws. The same holds for any multi-output node — \`textToSpeech\` needs
+  \`.output("audio")\`.
+
+Put the step's fixed instructions in \`system\` and wire the data into
+\`prompt\`. That split is what lets an upstream value reach the step at all,
+since a handle cannot be interpolated into a string.
+
+## Inputs and outputs
+
+An input node's \`name\` must equal the runtime parameter key **exactly** — the
+runtime matches parameters to input nodes by that name, so a hardcoded constant
+silently ignores what the caller passed. One input node per parameter, typed to
+the value: \`stringInput\`, \`integerInput\`, \`floatInput\`, \`booleanInput\`,
+\`imageInput\`, \`audioInput\`, … from \`nodetool.input\`.
+
+\`nodetool.output.Output\` — \`output({name, value})\` — is the ONLY output
+node. There is no \`StringOutput\`, \`ImageOutput\`, or any other per-type
+variant. It takes any value, and \`name\` is the key the result comes back
+under.
+
+## Branching
+
+\`if_({condition, value})\` from \`nodetool.control\` needs a real boolean on
+\`condition\`. A node that reports an *ordering* as a string ("equal",
+"greater", "less") is never a valid condition — it is truthy in every case.
+Produce the boolean itself, e.g. a \`code\` node whose body is
+\`return { output: inputs.a === inputs.b };\`, and wire that into
+\`condition\`.
+
+\`if_\` has TWO outputs, \`if_true\` and \`if_false\`, and emits only the taken
+branch. Wire BOTH to their destinations so each case is handled; do not fake
+the else-branch with an error handler.
+
+## \`nodetool.code.Code\` — the general-purpose transform
+
+\`code({...})\` runs vanilla JavaScript in the QuickJS sandbox. Reach for ONE
+Code node when the step is data shaping, parsing, formatting, arithmetic or
+string work — it replaces a chain of small nodes. Use a specialized node when
+the step wraps a model, a device, or an external service.
+
+- Before writing a body from scratch, call \`list_js_scripts\`: a saved script
+  already does the job when one matches, and a script carrying \`palette\` is
+  one of the user's own custom nodes.
+- **Inputs** are dynamic: any property you pass that is not \`code\` or
+  \`packages\` becomes an input handle, and the body reads it off the
+  \`inputs\` object.
+- **Outputs** are dynamic too: the body returns an object, and each key becomes
+  an output handle you read with \`.output("key")\`.
+- Sandbox API inside the body: \`fetch\`, \`workspace.*\`, \`crypto.*\`,
+  \`format.*\`, \`image.*\`, \`parallelMap\`, \`sleep\`, \`progress\`,
+  \`nodetool.secrets.get\`, plus core JavaScript.
+- **The toolbelt is in there too**, imported: \`import { run_apify_actor }
+  from "@nodetool-ai/sandbox-nodetool/apify";\`, plus the \`nodetool.*\` object
+  model. It is the same server-side belt an \`execute_code\` action has, minus
+  the browser-only \`ui_*\` tools, so a call you ran in an action runs the same
+  way inside a body. There is no \`tools.<name>()\` global.
+- **Never paste a value you fetched while authoring into a body.** The node has
+  to fetch it when it runs — a URL, id or result frozen into the code makes a
+  workflow that returns the same stale answer forever and looks like it works.
+  If the call you need is not available, say that; do not substitute a
+  hard-coded result for it.
+
+\`\`\`js
+import { stringInput } from "@nodetool-ai/sandbox-dsl/nodetool.input";
+import { code } from "@nodetool-ai/sandbox-dsl/nodetool.code";
+import { output } from "@nodetool-ai/sandbox-dsl/nodetool.output";
+
+const orders = stringInput({ name: "orders" });
+const totals = code({
+  orders: orders.output(),
+  code: [
+    "const rows = JSON.parse(inputs.orders);",
+    "return { total: rows.reduce((s, r) => s + r.amount, 0) };"
+  ].join("\\n")
+});
+return workflow(output({ name: "total", value: totals.output("total") }));
+\`\`\`
+
+### Libraries in a Code node
+
+A library is a sandbox pack: list its specifier in the node's \`packages\`
+property and \`import\` it at the top of the body. Nothing else resolves — no
+\`require\`, no dynamic \`import()\`, and a specifier this machine does not
+have fails validation. \`nodetool.packs.list()\` reports what is installed and
+\`nodetool.packs.docs(specifier)\` serves a pack's SKILL.md. When a step needs a
+library nobody installed, say so and build the closest thing the sandbox APIs
+allow.
+
+## Persistence
+
+Generic AI nodes auto-save images, audio and video as assets — no separate save
+node. Text an Agent step produces (a report, a summary, JSON) is not saved by
+anything: either give a Code node a body that calls
+\`await workspace.write(path, text)\`, or list \`save_asset\` in the Agent
+node's tools so the artifact reaches the asset browser.
+
+## Patterns
+
+Match the request to one of these shapes before writing anything.
+
+- **Simple pipeline** — \`input → transform(s) → output\`. One source,
+  deterministic transforms: \`stringInput → posterize → output\`.
+- **AI generation + post-process** — a generic AI node, then a deterministic
+  filter, then \`output\`: \`textToImage({prompt, model}) →
+  posterize({image, colors: 3}) → output\`.
+- **Multi-step LLM reasoning** — chained \`agent\` nodes, each reading the
+  previous one's \`.output("text")\`, instructions in \`system\` and data in
+  \`prompt\`.
+- **Branch** — a boolean-producing node → \`if_({condition, value})\` → both
+  \`if_true\` and \`if_false\` wired onward.
+- **Multi-modal chain** — \`audioInput → automaticSpeechRecognition → agent →
+  textToImage → output\`, or any permutation. Generic AI nodes of different
+  modalities connect through an Agent step when the middle needs reasoning.
+
+Nodes with no data dependency between them run concurrently — do not serialize
+independent branches by chaining them.
+
+\`\`\`js
+import { workflow } from "@nodetool-ai/sandbox-dsl";
+import { stringInput } from "@nodetool-ai/sandbox-dsl/nodetool.input";
+import { agent } from "@nodetool-ai/sandbox-dsl/nodetool.agents";
+import { output } from "@nodetool-ai/sandbox-dsl/nodetool.output";
+
+const topic = stringInput({ name: "topic" });
+const draft = agent({
+  system: "Outline the topic the user gives you.",
+  prompt: topic.output()
+});
+const polish = agent({
+  system: "Rewrite the draft you are given so it flows well.",
+  prompt: draft.output("text")
+});
+return workflow(output({ name: "result", value: polish.output("text") }));
+\`\`\``;
+}
+/** The knowledge section over the full generic-AI catalog. */
+export const WORKFLOW_AUTHORING_KNOWLEDGE = renderWorkflowAuthoringKnowledge();
+//# sourceMappingURL=workflow-authoring-knowledge.js.map

package/dist/prompts/workflow-authoring-knowledge.js.map

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

package/dist/run-policy.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The run-level execution policy stamped onto planner-authored Agent nodes.
+ *
+ * `authorGraph` emits bare `nodetool.agents.Agent` nodes: no model (it cannot
+ * know which are configured), no system prompt, no turn budget. The run owns
+ * all three, so a planned graph is only runnable once this has been applied —
+ * otherwise every Agent node dies on "Select a model".
+ */
+import type { GraphData } from "@nodetool-ai/protocol";
+/** The run-level execution policy stamped onto planner-authored Agent nodes. */
+export interface RunPolicy {
+    providerId: string;
+    modelId: string;
+    systemPrompt?: string;
+    maxStepIterations?: number;
+    maxTokens?: number;
+}
+/**
+ * Stamp the run's execution policy onto planner-authored Agent nodes.
+ *
+ * A property the node already carries wins — a hand-authored graph, or a model
+ * the planner pinned via `find_model`, is never overwritten.
+ */
+export declare function applyRunPolicy(graphData: GraphData, policy: RunPolicy): GraphData;
+//# sourceMappingURL=run-policy.d.ts.map

package/dist/run-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-policy.d.ts","sourceRoot":"","sources":["../src/run-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAIvD,gFAAgF;AAChF,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,SAAS,GAChB,SAAS,CA2CX"}

package/dist/run-policy.js

@@ -0,0 +1,54 @@
+/**
+ * The run-level execution policy stamped onto planner-authored Agent nodes.
+ *
+ * `authorGraph` emits bare `nodetool.agents.Agent` nodes: no model (it cannot
+ * know which are configured), no system prompt, no turn budget. The run owns
+ * all three, so a planned graph is only runnable once this has been applied —
+ * otherwise every Agent node dies on "Select a model".
+ */
+import { AGENT_NODE_TYPE } from "./graph-builder.js";
+import { isString } from "./utils/type-guards.js";
+/**
+ * Stamp the run's execution policy onto planner-authored Agent nodes.
+ *
+ * A property the node already carries wins — a hand-authored graph, or a model
+ * the planner pinned via `find_model`, is never overwritten.
+ */
+export function applyRunPolicy(graphData, policy) {
+    const { providerId, modelId, systemPrompt, maxStepIterations, maxTokens } = policy;
+    return {
+        ...graphData,
+        nodes: graphData.nodes.map((node) => {
+            if (node.type !== AGENT_NODE_TYPE)
+                return node;
+            const properties = { ...(node.properties ?? {}) };
+            const model = properties["model"];
+            if (!model?.provider || model.provider === "empty" || !model.id) {
+                properties["model"] = {
+                    type: "language_model",
+                    provider: providerId,
+                    id: modelId,
+                    name: modelId,
+                    path: null,
+                    supported_tasks: []
+                };
+            }
+            // The run's system prompt carries the merged skill/memory instructions.
+            const system = properties["system"];
+            if (systemPrompt && (!isString(system) || system.length === 0)) {
+                properties["system"] = systemPrompt;
+            }
+            // `maxStepIterations` is the run's per-step turn budget; on the node it
+            // is `max_turns`, which otherwise defaults to 100.
+            if (maxStepIterations !== undefined && properties["max_turns"] == null) {
+                properties["max_turns"] = maxStepIterations;
+            }
+            // Same for the run's output-token cap, which the node calls `max_tokens`.
+            if (maxTokens !== undefined && properties["max_tokens"] == null) {
+                properties["max_tokens"] = maxTokens;
+            }
+            return { ...node, properties };
+        })
+    };
+}
+//# sourceMappingURL=run-policy.js.map

package/dist/run-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-policy.js","sourceRoot":"","sources":["../src/run-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAWlD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAoB,EACpB,MAAiB;IAEjB,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,GACvE,MAAM,CAAC;IACT,OAAO;QACL,GAAG,SAAS;QACZ,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAClC,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe;gBAAE,OAAO,IAAI,CAAC;YAC/C,MAAM,UAAU,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;YAElD,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAEnB,CAAC;YACd,IAAI,CAAC,KAAK,EAAE,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBAChE,UAAU,CAAC,OAAO,CAAC,GAAG;oBACpB,IAAI,EAAE,gBAAgB;oBACtB,QAAQ,EAAE,UAAU;oBACpB,EAAE,EAAE,OAAO;oBACX,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,IAAI;oBACV,eAAe,EAAE,EAAE;iBACpB,CAAC;YACJ,CAAC;YAED,wEAAwE;YACxE,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YACpC,IAAI,YAAY,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC/D,UAAU,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC;YACtC,CAAC;YAED,wEAAwE;YACxE,mDAAmD;YACnD,IAAI,iBAAiB,KAAK,SAAS,IAAI,UAAU,CAAC,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC;gBACvE,UAAU,CAAC,WAAW,CAAC,GAAG,iBAAiB,CAAC;YAC9C,CAAC;YAED,0EAA0E;YAC1E,IAAI,SAAS,KAAK,SAAS,IAAI,UAAU,CAAC,YAAY,CAAC,IAAI,IAAI,EAAE,CAAC;gBAChE,UAAU,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;YACvC,CAAC;YAED,OAAO,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC;QACjC,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/sandbox-av-media.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Cross-platform audio and video operations for the JavaScript sandbox.
+ *
+ * Mediabunny owns container parsing, codecs, and conversion. Browsers use
+ * WebCodecs. Node registers Mediabunny's official server codec adapter on
+ * first use. The sandbox only sees byte arrays and media handles.
+ */
+interface AudioBridge {
+    info(bytes: Uint8Array): Promise<Record<string, unknown>>;
+    normalize(bytes: Uint8Array): Promise<Uint8Array>;
+    trim(bytes: Uint8Array, options?: Record<string, unknown>): Promise<Uint8Array>;
+    concat(inputs: Uint8Array[]): Promise<Uint8Array>;
+    mix(inputs: Uint8Array[]): Promise<Uint8Array>;
+    reverse(bytes: Uint8Array): Promise<Uint8Array>;
+    fadeIn(bytes: Uint8Array, options?: Record<string, unknown>): Promise<Uint8Array>;
+    fadeOut(bytes: Uint8Array, options?: Record<string, unknown>): Promise<Uint8Array>;
+    repeat(bytes: Uint8Array, options?: Record<string, unknown>): Promise<Uint8Array>;
+}
+interface VideoBridge {
+    info(bytes: Uint8Array): Promise<Record<string, unknown>>;
+    trim(bytes: Uint8Array, options?: Record<string, unknown>): Promise<Uint8Array>;
+    resize(bytes: Uint8Array, options?: Record<string, unknown>): Promise<Uint8Array>;
+    rotate(bytes: Uint8Array, degrees: unknown): Promise<Uint8Array>;
+    addAudio(video: Uint8Array, audio: Uint8Array, options?: Record<string, unknown>): Promise<Uint8Array>;
+    extractAudio(bytes: Uint8Array): Promise<Uint8Array>;
+    extractFrame(bytes: Uint8Array, time?: unknown): Promise<Uint8Array>;
+}
+export declare function createAudioBridge(signal?: AbortSignal, maxBytes?: number): AudioBridge;
+export declare function createVideoBridge(signal?: AbortSignal, maxBytes?: number): VideoBridge;
+export declare const audioOps: AudioBridge;
+export declare const videoOps: VideoBridge;
+export {};
+//# sourceMappingURL=sandbox-av-media.d.ts.map

package/dist/sandbox-av-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-av-media.d.ts","sourceRoot":"","sources":["../src/sandbox-av-media.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsXH,UAAU,WAAW;IACnB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClD,IAAI,CACF,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClD,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,CACJ,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,OAAO,CACL,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,MAAM,CACJ,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB;AAED,UAAU,WAAW;IACnB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,IAAI,CACF,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,MAAM,CACJ,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjE,QAAQ,CACN,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,UAAU,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrD,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACtE;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,SAAoB,GAC3B,WAAW,CAyMb;AAwBD,wBAAgB,iBAAiB,CAC/B,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,SAAoB,GAC3B,WAAW,CAiPb;AAED,eAAO,MAAM,QAAQ,aAAsB,CAAC;AAC5C,eAAO,MAAM,QAAQ,aAAsB,CAAC"}