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

package/dist/author-graph.js

@@ -0,0 +1,317 @@
+/**
+ * `authorGraph` — build a workflow graph by letting a CodeAct sub-agent write
+ * it with the typed DSL pack.
+ *
+ * The `GraphPlanner` this replaces had the model author an *untyped* program:
+ * `node("some.node.Type", {...})` took the type and every property name as free
+ * text, so nothing checked either until `submit_graph` validated the result.
+ * `@nodetool-ai/sandbox-dsl` ships one generated function per node type with
+ * that node's real inputs, so a type the catalog does not have has no export
+ * and the import fails before any code runs.
+ *
+ * That change makes a bespoke loop unnecessary. Authoring is now ordinary
+ * CodeAct: the sub-agent writes an action, imports the namespaces it needs,
+ * validates the graph it built, fixes what the validator reports, and hands the
+ * graph back through `finish()` — the same structured-result path every other
+ * sub-agent settles through. What this module owns is the brief (objective,
+ * inputs, execution tools, output schema), the belt, and the pack.
+ */
+import { budgetFromContext, isRunBudget, getProcessSandboxModuleCatalog, withAgentSpanGen } from "@nodetool-ai/runtime";
+import { createLogger } from "@nodetool-ai/config";
+import { toolForCapabilityName } from "./capabilities/lazy-tool.js";
+import { createCapabilityRun, contextSecretAvailability, gateFromContext } from "./capabilities/index.js";
+import { GRAPH_DSL_PACKAGE, catalogServesGraphDsl } from "./codeact/graph-dsl-package.js";
+import { renderWorkflowAuthoringKnowledge, resolveAvailableGenericNodes } from "./prompts/workflow-authoring-knowledge.js";
+import { runSubAgent } from "./subagent.js";
+import { isObjectLike } from "./utils/type-guards.js";
+const log = createLogger("nodetool.agents.author-graph");
+/** Provider rounds one authoring run may spend. */
+export const AUTHOR_GRAPH_MAX_ITERATIONS = 20;
+/** Discovery and checking. Authoring itself is the DSL pack, not a tool. */
+const AUTHORING_CAPABILITIES = [
+    "search_nodes",
+    "get_node_info",
+    "list_nodes",
+    "validate_workflow",
+    "validate_code",
+    "run_code",
+    "test_code"
+];
+/**
+ * The shape `finish()` must carry. Deliberately loose about what a node or an
+ * edge holds — `validate_workflow` is what judges that, against the registry.
+ */
+const GRAPH_RESULT_SCHEMA = {
+    type: "object",
+    properties: {
+        nodes: {
+            type: "array",
+            items: { type: "object" },
+            description: "The graph's nodes, exactly as `workflow()` returned them."
+        },
+        edges: {
+            type: "array",
+            items: { type: "object" },
+            description: "The graph's edges, exactly as `workflow()` returned them."
+        }
+    },
+    required: ["nodes", "edges"]
+};
+/**
+ * Author a workflow graph for `objective`.
+ *
+ * Streams the sub-agent's `ProcessingMessage`s and returns the authored graph,
+ * or null when the run produced none — the same generator contract
+ * `GraphPlanner.plan()` had, so both callers consume it unchanged.
+ */
+export async function* authorGraph(objective, opts) {
+    return yield* withAgentSpanGen("plan", {
+        objective,
+        provider: opts.provider.provider,
+        model: opts.model,
+        extra: { "agent.plan.kind": "graph" }
+    }, () => authorGraphImpl(objective, opts));
+}
+async function* authorGraphImpl(objective, opts) {
+    const catalog = resolveCatalog(opts.context);
+    if (!catalogServesGraphDsl(catalog)) {
+        const content = `Cannot author a graph: this process serves no \`${GRAPH_DSL_PACKAGE}\` ` +
+            "pack, so the sub-agent has nothing to build the graph with. Install the " +
+            "sandbox packs (`nodetool packs compile`) or supply a catalog that " +
+            "carries the DSL pack.";
+        log.error("authorGraph: DSL pack unavailable", {
+            objective: objective.slice(0, 120)
+        });
+        yield {
+            type: "planning_update",
+            phase: "complete",
+            status: "failed",
+            content
+        };
+        return null;
+    }
+    yield {
+        type: "planning_update",
+        phase: "initialization",
+        status: "started",
+        content: "Authoring workflow graph..."
+    };
+    const tools = buildAuthoringBelt(opts);
+    log.info("authorGraph started", {
+        objective: objective.slice(0, 120),
+        provider: opts.provider.provider,
+        model: opts.model,
+        tools: tools.length,
+        executionTools: opts.tools?.length ?? 0
+    });
+    const outcome = yield* runSubAgent({
+        context: opts.context,
+        provider: opts.provider,
+        model: opts.model,
+        tools,
+        instructions: buildBrief(objective, opts),
+        title: "Author workflow graph",
+        outputSchema: GRAPH_RESULT_SCHEMA,
+        systemPrompt: buildAuthoringPreamble(opts),
+        sandboxPackages: [GRAPH_DSL_PACKAGE],
+        maxIterations: opts.maxIterations ?? AUTHOR_GRAPH_MAX_ITERATIONS,
+        turnBudget: opts.turnBudget,
+        threadId: opts.threadId,
+        signal: opts.signal
+    });
+    if (!outcome.ok) {
+        log.warn("authorGraph failed", { error: outcome.error });
+        yield {
+            type: "planning_update",
+            phase: "complete",
+            status: "failed",
+            content: `Graph authoring failed: ${outcome.error}`
+        };
+        return null;
+    }
+    const graph = asGraphData(outcome.result);
+    if (!graph) {
+        log.warn("authorGraph returned no usable graph", {
+            resultType: typeof outcome.result
+        });
+        yield {
+            type: "planning_update",
+            phase: "complete",
+            status: "failed",
+            content: "Graph authoring finished without a {nodes, edges} graph — nothing to run."
+        };
+        return null;
+    }
+    log.info("Graph authored", {
+        nodes: graph.nodes.length,
+        edges: graph.edges.length
+    });
+    yield {
+        type: "planning_update",
+        phase: "complete",
+        status: "success",
+        content: `Graph built: ${graph.nodes.length} nodes, ${graph.edges.length} edges`
+    };
+    return graph;
+}
+/**
+ * The catalog the sub-agent's imports will resolve against. There is no option
+ * for it: the guest loader reads the one on the {@link ProcessingContext}, so
+ * anything else here would only describe a pack the action cannot import. A
+ * host that means "no packs" sets `null` on the context; a plain object with no
+ * catalog at all falls back to this process's.
+ */
+function resolveCatalog(context) {
+    const fromContext = context.sandboxModuleCatalog;
+    if (fromContext !== undefined)
+        return fromContext;
+    return getProcessSandboxModuleCatalog();
+}
+/**
+ * The run budget behind an authoring run: the caller's when it passed one, the
+ * context's otherwise. A bare {@link TurnBudget} carries no run-level bounds,
+ * so it is not one.
+ */
+function resolveAuthoringBudget(opts) {
+    if (isRunBudget(opts.turnBudget))
+        return opts.turnBudget;
+    return budgetFromContext(opts.context);
+}
+/**
+ * Discovery, graph validation, and the Code-body harness — plus `find_model`
+ * when providers are configured. Everything else the agent needs is the pack.
+ *
+ * The executor still accepts Tool[], so these are compatibility views over
+ * the owned run. Each invocation uses that run's permission gate.
+ */
+export function buildAuthoringBelt(opts) {
+    const gate = opts.gate ?? gateFromContext(opts.context, "authorGraph");
+    const runOptions = {
+        context: opts.context,
+        gate,
+        // The belt's capabilities run inside the authoring run, so they share its
+        // budget rather than starting one.
+        budget: resolveAuthoringBudget(opts),
+        // The belt carries `validate_workflow`, so a graph the child authors
+        // against a provider this install has no key for comes back saying so.
+        // A hermetic caller's context resolves no secrets and gets no callback.
+        availableSecrets: contextSecretAvailability(opts.context),
+        nodeRegistry: opts.registry
+    };
+    if (opts.providers)
+        runOptions.providers = opts.providers;
+    const run = createCapabilityRun(runOptions);
+    const names = [...AUTHORING_CAPABILITIES];
+    if (opts.providers && Object.keys(opts.providers).length > 0) {
+        names.unshift("find_model");
+    }
+    else {
+        log.warn("authorGraph has no configured providers — `find_model` is off the belt, so AI work falls back to the model-less Agent node.");
+    }
+    return names.map((name) => toolForCapabilityName(name, run));
+}
+/**
+ * The system-prompt preamble: what the agent has to know to author a NodeTool
+ * workflow, plus how this particular run ends. The DSL mechanics are NOT here
+ * — the CodeAct prompt renders `GRAPH_DSL_PROMPT_SECTION` itself once the pack
+ * is on the session allowlist, and saying it twice only invites the model to
+ * follow the copy that suits it.
+ */
+export function buildAuthoringPreamble(opts) {
+    const { available, missing } = resolveAvailableGenericNodes(opts.registry);
+    if (missing.length > 0) {
+        log.warn("authorGraph: GENERIC_AI_NODES entries missing from the registry; omitting them from the prompt", { missing });
+    }
+    const sections = [];
+    if (opts.systemPrompt?.trim())
+        sections.push(opts.systemPrompt.trim());
+    sections.push("You author one workflow graph and hand it back. You do not save it and " +
+        "you do not run it — the caller owns both.");
+    sections.push(renderWorkflowAuthoringKnowledge(available));
+    sections.push(`## Finishing
+
+1. Build the graph: \`const graph = workflow(...terminals);\`
+2. Check it: \`await nodetool.workflows.validate(graph)\`. Fix every error it
+   reports and validate again. A graph that still has errors is not finished.
+3. Hand it back: \`await finish(graph)\` — the object itself, not a re-typed copy.
+
+A \`nodetool.code.Code\` body is code, so check it like code: \`validate_code\`
+after every edit, \`run_code\` with representative inputs when the body does
+anything non-obvious, and \`test_code\` with a case per branch when it does
+arithmetic or parsing. That is cheaper than discovering the body is wrong on a
+run the user paid for.`);
+    return sections.join("\n\n");
+}
+/** The user message: what to build, with what, and what it must produce. */
+export function buildBrief(objective, opts) {
+    const parts = [
+        "Build a workflow graph to achieve this objective.",
+        `Objective: ${objective}`,
+        `Workflow inputs (runtime parameters the caller will supply):\n${formatInputs(opts.inputs ?? {})}`,
+        `Execution tools available to agent step nodes:\n${formatTools(opts.tools ?? [])}`,
+        `Output schema (for the final result of the workflow):\n${opts.outputSchema
+            ? JSON.stringify(opts.outputSchema, null, 2)
+            : "None specified"}`
+    ];
+    return parts.join("\n\n");
+}
+/**
+ * Render the caller's inputs. The kernel dispatches runtime parameters to
+ * `nodetool.input.*` nodes matched by name, so the agent must know which keys
+ * exist to wire them in.
+ */
+function formatInputs(inputs) {
+    const entries = Object.entries(inputs);
+    if (entries.length === 0) {
+        return "None — the workflow takes no runtime parameters.";
+    }
+    const lines = entries.map(([key, value]) => {
+        let preview;
+        try {
+            preview = JSON.stringify(value) ?? "undefined";
+        }
+        catch {
+            preview = String(value);
+        }
+        if (preview.length > 200)
+            preview = `${preview.slice(0, 197)}...`;
+        return `- ${key}: ${preview}`;
+    });
+    return [
+        ...lines,
+        "",
+        "Add one `nodetool.input.*` node per key above, with its `name` property set to that key EXACTLY, and wire its output into whatever consumes it."
+    ].join("\n");
+}
+function formatTools(tools) {
+    if (tools.length === 0)
+        return "No execution tools available.";
+    return tools
+        .map((tool) => {
+        const schema = tool.inputSchema;
+        let args = "";
+        if (isObjectLike(schema) && "properties" in schema) {
+            const props = Object.keys(schema.properties);
+            const required = Array.isArray(schema.required)
+                ? schema.required
+                : [];
+            if (props.length > 0) {
+                args = ` | Args: ${props
+                    .map((p) => (required.includes(p) ? `${p} (required)` : p))
+                    .join(", ")}`;
+            }
+        }
+        return `- ${tool.name}: ${tool.description}${args}`;
+    })
+        .join("\n");
+}
+/** Narrow a finished result to a graph, or null when it is not one. */
+function asGraphData(result) {
+    if (!isObjectLike(result))
+        return null;
+    const record = result;
+    if (!Array.isArray(record.nodes) || !Array.isArray(record.edges))
+        return null;
+    return record;
+}
+//# sourceMappingURL=author-graph.js.map

package/dist/author-graph.js.map

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

package/dist/background-subtasks.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Background subtask registry — the per-turn state behind `start_subtask` and
+ * `wait_subtasks`.
+ *
+ * A host creates one per chat turn and hangs it on the
+ * `SubAgentToolRuntime.background` field. Every `start_subtask` call in that
+ * turn registers its child here; the child's detached pump settles it when the
+ * loop ends. `wait_subtasks` blocks on the records instead of on the parent's
+ * tool call, which is what lets the parent keep working while children run.
+ *
+ * The settlement input is structurally compatible with `SubAgentOutcome` (plus
+ * an `{aborted: true}` variant) so this module imports nothing from
+ * `subagent.ts` — one less edge to cycle.
+ */
+export type BackgroundSubtaskStatus = "running" | "completed" | "failed" | "aborted";
+/** What a pump hands back when the child loop is over. */
+export type BackgroundSubtaskSettlement = {
+    ok: true;
+    result: unknown;
+} | {
+    ok: false;
+    error: string;
+} | {
+    aborted: true;
+};
+export interface BackgroundSubtaskSnapshot {
+    readonly subtask_id: string;
+    readonly description: string;
+    /** Child recursion depth (1 = spawned by the root loop). */
+    readonly depth: number;
+    readonly status: BackgroundSubtaskStatus;
+    /** Present when status is "completed". */
+    readonly result?: unknown;
+    /** Present when status is "failed". */
+    readonly error?: string;
+}
+/** A wait result row: a snapshot, or an unknown id the caller named. */
+export type WaitedSubtask = BackgroundSubtaskSnapshot | {
+    subtask_id: string;
+    status: "unknown";
+};
+export interface WaitBackgroundOptions {
+    /** Collect only these ids; omit to collect every record in the registry. */
+    ids?: readonly string[];
+    /** How long to block. Clamped to [1s, MAX_WAIT_TIMEOUT_MS]. */
+    timeoutMs?: number;
+    /** Aborting resolves immediately with current statuses. */
+    signal?: AbortSignal;
+}
+export declare const DEFAULT_WAIT_TIMEOUT_MS = 300000;
+export declare const MAX_WAIT_TIMEOUT_MS = 900000;
+/**
+ * Tracks background sub-agents for one turn. Not concurrency-safe across
+ * threads by design: every mutation happens on the turn's own async path.
+ */
+export declare class BackgroundSubtaskRegistry {
+    private readonly records;
+    private version;
+    private waiters;
+    /** Register a freshly spawned child as "running". */
+    start(id: string, description: string, depth: number): void;
+    /** Mark a child settled. Unknown ids are ignored — start() owns the keys. */
+    settle(id: string, settlement: BackgroundSubtaskSettlement): void;
+    /** Current state of every record, oldest first. */
+    snapshot(): BackgroundSubtaskSnapshot[];
+    /** How many records this turn has started. */
+    get size(): number;
+    /** Records still running. */
+    get runningCount(): number;
+    /**
+     * Resolve once every requested record left "running", or on timeout or
+     * abort — whichever comes first. Timeout and abort resolve with the
+     * current statuses rather than throwing; a partial answer beats no answer.
+     */
+    wait(opts?: WaitBackgroundOptions): Promise<WaitedSubtask[]>;
+    private untilNextVersion;
+    private notifyWaiters;
+}
+//# sourceMappingURL=background-subtasks.d.ts.map

package/dist/background-subtasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-subtasks.d.ts","sourceRoot":"","sources":["../src/background-subtasks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,uBAAuB,GAC/B,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,CAAC;AAEd,0DAA0D;AAC1D,MAAM,MAAM,2BAA2B,GACnC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC;AAEtB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wEAAwE;AACxE,MAAM,MAAM,aAAa,GACrB,yBAAyB,GACzB;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAC/C,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAI3C;;;GAGG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoD;IAC5E,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,OAAO,CAAyB;IAExC,qDAAqD;IACrD,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQ1D;IAED,6EAA6E;IAC7E,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,2BAA2B,GAAG,IAAI,CAchE;IAED,mDAAmD;IACnD,QAAQ,IAAI,yBAAyB,EAAE,CAEtC;IAED,8CAA8C;IAC9C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,6BAA6B;IAC7B,IAAI,YAAY,IAAI,MAAM,CAIzB;IAED;;;;OAIG;IACG,IAAI,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAkCrE;IAED,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,aAAa;CAKtB"}

package/dist/background-subtasks.js

@@ -0,0 +1,139 @@
+/**
+ * Background subtask registry — the per-turn state behind `start_subtask` and
+ * `wait_subtasks`.
+ *
+ * A host creates one per chat turn and hangs it on the
+ * `SubAgentToolRuntime.background` field. Every `start_subtask` call in that
+ * turn registers its child here; the child's detached pump settles it when the
+ * loop ends. `wait_subtasks` blocks on the records instead of on the parent's
+ * tool call, which is what lets the parent keep working while children run.
+ *
+ * The settlement input is structurally compatible with `SubAgentOutcome` (plus
+ * an `{aborted: true}` variant) so this module imports nothing from
+ * `subagent.ts` — one less edge to cycle.
+ */
+export const DEFAULT_WAIT_TIMEOUT_MS = 300_000;
+export const MAX_WAIT_TIMEOUT_MS = 900_000;
+const MIN_WAIT_TIMEOUT_MS = 1_000;
+/**
+ * Tracks background sub-agents for one turn. Not concurrency-safe across
+ * threads by design: every mutation happens on the turn's own async path.
+ */
+export class BackgroundSubtaskRegistry {
+    records = new Map();
+    version = 0;
+    waiters = [];
+    /** Register a freshly spawned child as "running". */
+    start(id, description, depth) {
+        if (this.records.has(id))
+            return;
+        this.records.set(id, {
+            subtask_id: id,
+            description,
+            depth,
+            status: "running"
+        });
+    }
+    /** Mark a child settled. Unknown ids are ignored — start() owns the keys. */
+    settle(id, settlement) {
+        const record = this.records.get(id);
+        if (!record || record.status !== "running")
+            return;
+        if (aborted(settlement)) {
+            record.status = "aborted";
+        }
+        else if (settlement.ok) {
+            record.status = "completed";
+            record.result = settlement.result;
+        }
+        else {
+            record.status = "failed";
+            record.error = settlement.error;
+        }
+        this.version++;
+        this.notifyWaiters();
+    }
+    /** Current state of every record, oldest first. */
+    snapshot() {
+        return [...this.records.values()].map((r) => ({ ...r }));
+    }
+    /** How many records this turn has started. */
+    get size() {
+        return this.records.size;
+    }
+    /** Records still running. */
+    get runningCount() {
+        let n = 0;
+        for (const r of this.records.values())
+            if (r.status === "running")
+                n++;
+        return n;
+    }
+    /**
+     * Resolve once every requested record left "running", or on timeout or
+     * abort — whichever comes first. Timeout and abort resolve with the
+     * current statuses rather than throwing; a partial answer beats no answer.
+     */
+    async wait(opts = {}) {
+        const requested = opts.ids?.length ? opts.ids : [...this.records.keys()];
+        const timeoutMs = clampTimeout(opts.timeoutMs);
+        const rowsFor = () => requested.map((id) => {
+            const record = this.records.get(id);
+            return record ? { ...record } : { subtask_id: id, status: "unknown" };
+        });
+        const allSettled = () => requested.every((id) => {
+            const r = this.records.get(id);
+            return !r || r.status !== "running";
+        });
+        if (allSettled())
+            return rowsFor();
+        const deadline = new Promise((resolve) => {
+            const timer = setTimeout(() => resolve("timeout"), timeoutMs);
+            if (typeof timer.unref === "function")
+                timer.unref();
+        });
+        const abortedP = abortPromise(opts.signal);
+        for (;;) {
+            if (allSettled())
+                return rowsFor();
+            const outcome = await Promise.race([
+                this.untilNextVersion(this.version),
+                deadline,
+                abortedP
+            ]);
+            if (outcome === "aborted" || outcome === "timeout")
+                return rowsFor();
+            // "notified": loop, re-check at the top.
+        }
+    }
+    untilNextVersion(seen) {
+        if (this.version !== seen)
+            return Promise.resolve("notified");
+        return new Promise((resolve) => {
+            this.waiters.push(() => resolve("notified"));
+        });
+    }
+    notifyWaiters() {
+        const waiters = this.waiters;
+        this.waiters = [];
+        for (const w of waiters)
+            w();
+    }
+}
+function aborted(s) {
+    return s.aborted === true;
+}
+function clampTimeout(raw) {
+    const value = typeof raw === "number" && Number.isFinite(raw) ? raw : DEFAULT_WAIT_TIMEOUT_MS;
+    return Math.min(Math.max(Math.floor(value), MIN_WAIT_TIMEOUT_MS), MAX_WAIT_TIMEOUT_MS);
+}
+function abortPromise(signal) {
+    if (!signal)
+        return new Promise(() => { });
+    if (signal.aborted)
+        return Promise.resolve("aborted");
+    return new Promise((resolve) => {
+        signal.addEventListener("abort", () => resolve("aborted"), { once: true });
+    });
+}
+//# sourceMappingURL=background-subtasks.js.map

package/dist/background-subtasks.js.map

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

package/dist/blender-gate.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Availability gate for the `render_model3d` capability.
+ *
+ * Rendering a model shells to a Blender the server owns — a desktop install
+ * the user keeps, not a binary a managed server can carry. Under the cloud
+ * profile it is left off the toolbelt entirely, which makes
+ * `nodetool.model3d.render()` throw the prelude's "not in this toolbelt"
+ * error rather than fail deep inside the runner.
+ *
+ * Same switch that prunes the node catalog: `NODETOOL_NODE_PROFILE=cloud`, or
+ * `NODETOOL_ENV=production` with the profile unset. A self-hosted install of
+ * the same image sets `NODETOOL_NODE_PROFILE=full` and keeps the capability,
+ * as does every local install. The node catalog already agrees — the
+ * `nodetool.blender` namespace is not in the cloud allowlist, so the render
+ * nodes are gone from the cloud product too.
+ */
+/** Whether the `render_model3d` capability should be offered on this deployment. */
+export declare function isBlenderEnabled(): boolean;
+/** What `render_model3d` answers where this deployment offers none. */
+export declare const BLENDER_DISABLED_ERROR: string;
+//# sourceMappingURL=blender-gate.d.ts.map

package/dist/blender-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blender-gate.d.ts","sourceRoot":"","sources":["../src/blender-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,oFAAoF;AACpF,wBAAgB,gBAAgB,IAAI,OAAO,CAK1C;AAED,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,QAIX,CAAC"}

package/dist/blender-gate.js

@@ -0,0 +1,27 @@
+/**
+ * Availability gate for the `render_model3d` capability.
+ *
+ * Rendering a model shells to a Blender the server owns — a desktop install
+ * the user keeps, not a binary a managed server can carry. Under the cloud
+ * profile it is left off the toolbelt entirely, which makes
+ * `nodetool.model3d.render()` throw the prelude's "not in this toolbelt"
+ * error rather than fail deep inside the runner.
+ *
+ * Same switch that prunes the node catalog: `NODETOOL_NODE_PROFILE=cloud`, or
+ * `NODETOOL_ENV=production` with the profile unset. A self-hosted install of
+ * the same image sets `NODETOOL_NODE_PROFILE=full` and keeps the capability,
+ * as does every local install. The node catalog already agrees — the
+ * `nodetool.blender` namespace is not in the cloud allowlist, so the render
+ * nodes are gone from the cloud product too.
+ */
+import { CLOUD_PROFILE_ENV, NODE_ENV_VAR, isCloudProfileActive } from "@nodetool-ai/protocol";
+/** Whether the `render_model3d` capability should be offered on this deployment. */
+export function isBlenderEnabled() {
+    return !isCloudProfileActive(process.env[CLOUD_PROFILE_ENV], process.env[NODE_ENV_VAR]);
+}
+/** What `render_model3d` answers where this deployment offers none. */
+export const BLENDER_DISABLED_ERROR = "Rendering 3D models is not available on this deployment. It shells out " +
+    "to a Blender install on the server, so it is offered only where the " +
+    "machine belongs to its user — the desktop app, a local server, or a " +
+    "self-hosted install.";
+//# sourceMappingURL=blender-gate.js.map

package/dist/blender-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blender-gate.js","sourceRoot":"","sources":["../src/blender-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAE/B,oFAAoF;AACpF,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,oBAAoB,CAC1B,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAC9B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAC1B,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,sBAAsB,GACjC,yEAAyE;IACzE,sEAAsE;IACtE,sEAAsE;IACtE,sBAAsB,CAAC"}

package/dist/browser-gate.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Availability gate for the `browser_*` capabilities.
+ *
+ * Driving a browser is a single-tenant capability wearing a multi-tenant
+ * server's clothes. The session is a process singleton — one page, shared by
+ * every caller in the process — so on a managed server two tenants' agents
+ * drive the same tab, and whatever the first one signed into is what the
+ * second one's `browser_view` reads. The extension transport is worse still:
+ * it drives one user's own Chrome, which a shared server would hand to
+ * anybody's run.
+ *
+ * Neither is a defect to fix behind a flag; both are what the surface is for.
+ * It belongs on a machine its user owns — a desktop app, a local server, a
+ * self-hosted install — so under the cloud profile the capabilities are left
+ * off every belt and refuse when reached by name.
+ *
+ * Same switch that prunes the node catalog: `NODETOOL_NODE_PROFILE=cloud`, or
+ * `NODETOOL_ENV=production` with the profile unset. The node catalog already
+ * agrees — `lib.browser` is not in `CLOUD_NODE_NAMESPACES`, so the Screenshot
+ * node is gone from the cloud product too. A self-hosted install of the same
+ * image sets `NODETOOL_NODE_PROFILE=full` and keeps both, as does every local
+ * install.
+ */
+/** Whether the `browser_*` capabilities should be offered on this deployment. */
+export declare function isBrowserEnabled(): boolean;
+/** What a `browser_*` capability answers where this deployment offers none. */
+export declare const BROWSER_DISABLED_ERROR: string;
+//# sourceMappingURL=browser-gate.d.ts.map

package/dist/browser-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-gate.d.ts","sourceRoot":"","sources":["../src/browser-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAQH,iFAAiF;AACjF,wBAAgB,gBAAgB,IAAI,OAAO,CAK1C;AAED,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,QAIX,CAAC"}