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

package/dist/capabilities/generations.js

@@ -0,0 +1,382 @@
+/**
+ * The `generations` capability module — the record of every media
+ * generation, readable by the agent that asked for it.
+ *
+ * A generation capability (`generate_image`, `render_storyboard_clips`, …)
+ * returns a `generation_id`. Five capabilities read that row, wait for it to
+ * settle when the call was started in the background, stop it, and ask the
+ * provider what it billed. Every read is scoped to the caller: `findForUser`
+ * and `listGenerations` carry the user id in the WHERE, so an id belonging to
+ * someone else reads as absent.
+ *
+ * Two more read the *provider's* own record through
+ * `BaseProvider.listGenerations` / `getGeneration` — generations this
+ * installation never ran, and the price the provider billed rather than the
+ * estimate. Those are the provider's rows, scoped by the account the API key
+ * belongs to, not by NodeTool's user id.
+ *
+ * Design: docs/media-generation-tracking-design.md § 10.
+ */
+import { deriveGenerationStatus } from "@nodetool-ai/models";
+import { generationRegistry, isProviderGenerationsUnsupported } from "@nodetool-ai/runtime";
+import { userIdOf } from "../tools/mcp-tool-support.js";
+import { listGenerationsSpec, getGenerationSpec, awaitGenerationSpec, cancelGenerationSpec, reconcileGenerationSpec, listProviderGenerationsSpec, getProviderGenerationSpec } from "./generations.specs.js";
+import { isNonEmptyString, isRecord, isString } from "../utils/type-guards.js";
+const DEFAULT_AWAIT_SECONDS = 300;
+const MAX_AWAIT_SECONDS = 1800;
+/** How often a cross-process wait re-reads the row. */
+const AWAIT_POLL_MS = 5_000;
+const PUBLIC_STATUSES = new Set([
+    "pending",
+    "running",
+    "recovering",
+    "completed",
+    "failed",
+    "cancelled",
+    "needs_attention",
+    "interrupted"
+]);
+function lifecycleError(metadata, key) {
+    return metaString(metadata, key);
+}
+/** Derive the public state without treating a provider success as saved output. */
+export function publicGenerationStatus(row) {
+    if (row.status === "interrupted")
+        return "interrupted";
+    if (row.lifecycle_owner !== "durable") {
+        return PUBLIC_STATUSES.has(row.status) ? row.status : "pending";
+    }
+    return deriveGenerationStatus(row);
+}
+function metaString(metadata, key) {
+    const value = metadata?.[key];
+    return isString(value) ? value : null;
+}
+export function generationRecord(row) {
+    const assetIds = Array.isArray(row.asset_ids)
+        ? row.asset_ids.filter(isString)
+        : [];
+    return {
+        generation_id: row.id,
+        status: publicGenerationStatus(row),
+        submission_status: row.submission_status ?? null,
+        provider_status: row.provider_status ?? null,
+        output_status: row.output_status ?? null,
+        attachment_status: row.attachment_status ?? null,
+        provider: row.provider,
+        model: row.model,
+        capability: row.capability ?? null,
+        cost: row.cost,
+        currency: row.currency,
+        billing_unit: row.billing_unit,
+        quantity: row.quantity,
+        unit_price: row.unit_price,
+        price_source: metaString(row.metadata, "price_source"),
+        asset_ids: assetIds,
+        asset_uris: assetIds.map((id) => `asset://${id}`),
+        started_at: row.started_at,
+        completed_at: row.completed_at,
+        duration_seconds: row.duration,
+        generation_error: row.error,
+        submission_error: lifecycleError(row.metadata, "submission_error"),
+        provider_error: lifecycleError(row.metadata, "provider_error"),
+        output_error: lifecycleError(row.metadata, "output_error"),
+        attachment_error: lifecycleError(row.metadata, "attachment_error"),
+        origin: {
+            surface: row.surface ?? null,
+            thread_id: row.thread_id ?? null,
+            tool_call_id: row.tool_call_id ?? null,
+            job_id: row.job_id ?? null,
+            node_id: row.node_id,
+            workflow_id: row.workflow_id
+        },
+        provider_request_id: row.provider_request_id,
+        reconcile: {
+            reconciled_at: row.reconciled_at ?? null,
+            attempts: row.reconcile_attempts ?? 0,
+            error: metaString(row.metadata, "reconcile_error"),
+            next_at: metaString(row.metadata, "reconcile_next_at")
+        }
+    };
+}
+function optionalString(value) {
+    return isNonEmptyString(value) ? value : undefined;
+}
+function bounded(value, fallback, max) {
+    const n = Math.floor(Number(value));
+    if (!Number.isFinite(n) || n < 1)
+        return fallback;
+    return Math.min(n, max);
+}
+const listGenerations = {
+    spec: listGenerationsSpec,
+    impl: async (run, params) => {
+        const { Prediction } = await import("@nodetool-ai/models");
+        const [rows, next] = await Prediction.listGenerations(userIdOf(run.context), {
+            status: optionalString(params["status"]),
+            provider: optionalString(params["provider"]),
+            capability: optionalString(params["capability"]),
+            threadId: optionalString(params["thread_id"]),
+            jobId: optionalString(params["job_id"]),
+            since: optionalString(params["since"]),
+            limit: bounded(params["limit"], 50, 500),
+            startKey: optionalString(params["start_key"])
+        });
+        return { generations: rows.map(generationRecord), next: next || null };
+    }
+};
+const getGeneration = {
+    spec: getGenerationSpec,
+    impl: async (run, params) => {
+        const { Prediction } = await import("@nodetool-ai/models");
+        const id = String(params["generation_id"] ?? "");
+        const row = await Prediction.findForUser(userIdOf(run.context), id);
+        if (!row)
+            return { error: `Generation ${id} was not found.` };
+        return {
+            ...generationRecord(row),
+            parameters: isRecord(row.parameters) ? row.parameters : null,
+            metadata: isRecord(row.metadata) ? row.metadata : null
+        };
+    }
+};
+const TERMINAL = new Set([
+    "completed",
+    "failed",
+    "cancelled",
+    "needs_attention",
+    "interrupted"
+]);
+const awaitGeneration = {
+    spec: awaitGenerationSpec,
+    impl: async (run, params) => {
+        const { Prediction } = await import("@nodetool-ai/models");
+        const userId = userIdOf(run.context);
+        const id = String(params["generation_id"] ?? "");
+        const timeoutMs = bounded(params["timeout_seconds"], DEFAULT_AWAIT_SECONDS, MAX_AWAIT_SECONDS) * 1000;
+        const startedAt = Date.now();
+        let row = await Prediction.findForUser(userId, id);
+        if (!row)
+            return { error: `Generation ${id} was not found.` };
+        if (TERMINAL.has(publicGenerationStatus(row)))
+            return generationRecord(row);
+        // In this process the registry settles the moment the call returns; the
+        // tracker's row write follows within the same tick, so one re-read after
+        // the settle is enough. In another process, only the row can answer.
+        const deadline = startedAt + timeoutMs;
+        while (Date.now() < deadline) {
+            const slice = Math.min(AWAIT_POLL_MS, deadline - Date.now());
+            const outcome = generationRegistry.isRunning(id)
+                ? await generationRegistry.wait(id, slice)
+                : await new Promise((resolve) => setTimeout(() => resolve(null), slice));
+            if (outcome) {
+                // Give the tracker's write a moment to land, then read the row.
+                await new Promise((resolve) => setTimeout(resolve, 50));
+            }
+            row = await Prediction.findForUser(userId, id);
+            if (!row)
+                return { error: `Generation ${id} was not found.` };
+            if (TERMINAL.has(publicGenerationStatus(row)))
+                return generationRecord(row);
+            if (run.context.signal?.aborted)
+                break;
+        }
+        return {
+            ...generationRecord(row),
+            waited_seconds: Math.round((Date.now() - startedAt) / 1000)
+        };
+    }
+};
+const cancelGeneration = {
+    spec: cancelGenerationSpec,
+    impl: async (run, params) => {
+        const { Prediction } = await import("@nodetool-ai/models");
+        const userId = userIdOf(run.context);
+        const id = String(params["generation_id"] ?? "");
+        // The abort is what stops a local provider call; the row is what the seam
+        // closes when that call unwinds. Durable work belongs to another worker,
+        // so only its cancellation intent is recorded here.
+        const existing = await Prediction.findForUser(userId, id);
+        if (existing?.lifecycle_owner === "durable") {
+            const requested = await Prediction.requestCancellation(id, userId);
+            if (!requested) {
+                return {
+                    generation_id: id,
+                    cancelled: false,
+                    cancellation_requested: false,
+                    error: `Generation ${id} is not running — it already settled, or it is not yours.`
+                };
+            }
+            return {
+                generation_id: id,
+                status: publicGenerationStatus(existing),
+                cancelled: false,
+                cancellation_requested: true,
+                note: "Cancellation was requested; the durable worker will close the record after the provider responds."
+            };
+        }
+        const aborted = generationRegistry.cancel(id, userId);
+        const flipped = aborted
+            ? false
+            : await Prediction.markCancelledIfRunning(id, userId);
+        if (!aborted && !flipped) {
+            return {
+                generation_id: id,
+                cancelled: false,
+                error: `Generation ${id} is not running — it already settled, or it is not yours.`
+            };
+        }
+        return {
+            generation_id: id,
+            status: "cancelled",
+            aborted,
+            note: aborted
+                ? undefined
+                : "The record is closed; the provider call runs in another process and finishes on its own."
+        };
+    }
+};
+const reconcileGenerationCapability = {
+    spec: reconcileGenerationSpec,
+    impl: async (run, params) => {
+        const { reconcileGeneration } = await import("@nodetool-ai/execution");
+        const id = String(params["generation_id"] ?? "");
+        const outcome = await reconcileGeneration(id, userIdOf(run.context), (key) => run.context.getSecret(key));
+        if (!outcome.found)
+            return { error: `Generation ${id} was not found.` };
+        return {
+            generation_id: id,
+            before: outcome.before,
+            after: outcome.after,
+            reconciled: outcome.reconciled,
+            reason: outcome.reason ?? null
+        };
+    }
+};
+const PROVIDER_STATUSES = new Set([
+    "running",
+    "completed",
+    "failed",
+    "cancelled",
+    "unknown"
+]);
+function providerStatus(value) {
+    if (!isString(value) || !PROVIDER_STATUSES.has(value))
+        return undefined;
+    // SAFETY: the set holds exactly the members of ProviderGenerationStatus,
+    // and `has` just proved this string is one of them.
+    return value;
+}
+/**
+ * The provider instance, or the reason there isn't one. A missing key and an
+ * unregistered id both arrive here as a throw, and the agent needs to read
+ * which it was rather than see the tool fail.
+ */
+async function providerOf(run, providerId) {
+    try {
+        return await run.context.getProvider(providerId);
+    }
+    catch (err) {
+        return `Provider '${providerId}' is not available: ${err instanceof Error ? err.message : String(err)}`;
+    }
+}
+const listProviderGenerations = {
+    spec: listProviderGenerationsSpec,
+    impl: async (run, params) => {
+        const providerId = String(params["provider"] ?? "");
+        const provider = await providerOf(run, providerId);
+        if (isString(provider))
+            return { error: provider };
+        const query = {
+            limit: bounded(params["limit"], 50, 100)
+        };
+        const model = optionalString(params["model"]);
+        if (model)
+            query.model = model.split(",").map((id) => id.trim());
+        const status = providerStatus(params["status"]);
+        if (status)
+            query.status = status;
+        const since = optionalString(params["since"]);
+        if (since)
+            query.since = since;
+        const until = optionalString(params["until"]);
+        if (until)
+            query.until = until;
+        const cursor = optionalString(params["cursor"]);
+        if (cursor)
+            query.cursor = cursor;
+        if (run.context.signal)
+            query.signal = run.context.signal;
+        try {
+            const page = await provider.listGenerations(query);
+            return {
+                provider: providerId,
+                generations: page.generations,
+                next_cursor: page.next_cursor,
+                note: page.note
+            };
+        }
+        catch (err) {
+            if (isProviderGenerationsUnsupported(err)) {
+                return {
+                    provider: providerId,
+                    error: `${providerId} keeps no listable generation history. Read this ` +
+                        `installation's own record with list_generations.`
+                };
+            }
+            throw err;
+        }
+    }
+};
+const getProviderGeneration = {
+    spec: getProviderGenerationSpec,
+    impl: async (run, params) => {
+        const providerId = String(params["provider"] ?? "");
+        const requestId = String(params["request_id"] ?? "");
+        const provider = await providerOf(run, providerId);
+        if (isString(provider))
+            return { error: provider };
+        const lookup = {};
+        const model = optionalString(params["model"]);
+        if (model)
+            lookup.model = model;
+        if (run.context.signal)
+            lookup.signal = run.context.signal;
+        try {
+            const row = await provider.getGeneration(requestId, lookup);
+            if (!row) {
+                return {
+                    provider: providerId,
+                    request_id: requestId,
+                    error: `${providerId} has no request ${requestId}.`
+                };
+            }
+            return row;
+        }
+        catch (err) {
+            if (isProviderGenerationsUnsupported(err)) {
+                return {
+                    provider: providerId,
+                    error: `${providerId} cannot be asked about a single generation. Read ` +
+                        `this installation's own record with get_generation.`
+                };
+            }
+            throw err;
+        }
+    }
+};
+export const GENERATION_CAPABILITIES = [
+    listGenerations,
+    getGeneration,
+    awaitGeneration,
+    cancelGeneration,
+    reconcileGenerationCapability,
+    listProviderGenerations,
+    getProviderGeneration
+];
+export const module = {
+    module: "generations",
+    exports: GENERATION_CAPABILITIES
+};
+export { listGenerations, getGeneration, awaitGeneration, cancelGeneration, reconcileGenerationCapability as reconcileGeneration, listProviderGenerations, getProviderGeneration };
+//# sourceMappingURL=generations.js.map

package/dist/capabilities/generations.js.map

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

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

@@ -0,0 +1,62 @@
+/**
+ * The `generations` module's specs — data only, no implementation.
+ *
+ * A generation is one provider media call tracked as a ledger row from before
+ * the call to its terminal state (docs/media-generation-tracking-design.md).
+ * Five of these read, wait on, stop and reconcile that record; the generation
+ * capabilities themselves (`generate_image`, …) return the `generation_id`
+ * they take. The last two read the *provider's* own record instead, for
+ * generations this installation never ran and for the price it actually
+ * billed (`packages/runtime/src/providers/provider-generations.ts`).
+ */
+import type { CapabilitySpec } from "./types.js";
+export declare const LIST_GENERATIONS_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly status: {
+            readonly type: "string";
+            readonly enum: readonly ["pending", "running", "recovering", "completed", "failed", "cancelled", "needs_attention", "interrupted"];
+            readonly description: "Only generations in this state.";
+        };
+        readonly provider: {
+            readonly type: "string";
+            readonly description: "Only this provider.";
+        };
+        readonly capability: {
+            readonly type: "string";
+            readonly description: "Only this capability, e.g. text_to_image, image_to_video, text_to_speech.";
+        };
+        readonly thread_id: {
+            readonly type: "string";
+            readonly description: "Only generations a given chat thread asked for.";
+        };
+        readonly job_id: {
+            readonly type: "string";
+            readonly description: "Only generations a given workflow run asked for.";
+        };
+        readonly since: {
+            readonly type: "string";
+            readonly description: "ISO timestamp; generations created before it are left out.";
+        };
+        readonly limit: {
+            readonly type: "number";
+            readonly description: "How many to return (1–500).";
+            readonly default: 50;
+        };
+        readonly start_key: {
+            readonly type: "string";
+            readonly description: "The `next` cursor from a previous page.";
+        };
+    };
+    readonly required: readonly [];
+};
+export declare const listGenerationsSpec: CapabilitySpec;
+export declare const getGenerationSpec: CapabilitySpec;
+export declare const awaitGenerationSpec: CapabilitySpec;
+export declare const cancelGenerationSpec: CapabilitySpec;
+export declare const reconcileGenerationSpec: CapabilitySpec;
+export declare const listProviderGenerationsSpec: CapabilitySpec;
+export declare const getProviderGenerationSpec: CapabilitySpec;
+/** Every spec this module declares, in declaration order. */
+export declare const generationsSpecs: readonly CapabilitySpec[];
+//# sourceMappingURL=generations.specs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generations.specs.d.ts","sourceRoot":"","sources":["../../src/capabilities/generations.specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,uBAAuB;aAClC,IAAI,EAAE,QAAQ;aACd,UAAU;iBACR,MAAM;qBACJ,IAAI,EAAE,QAAQ;qBACd,IAAI,YACF,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,aAAa;qBAEf,WAAW,EAAE,iCAAiC;;iBAEhD,QAAQ;qBAAI,IAAI,EAAE,QAAQ;qBAAE,WAAW,EAAE,qBAAqB;;iBAC9D,UAAU;qBACR,IAAI,EAAE,QAAQ;qBACd,WAAW,EACT,2EAA2E;;iBAE/E,SAAS;qBACP,IAAI,EAAE,QAAQ;qBACd,WAAW,EAAE,iDAAiD;;iBAEhE,MAAM;qBACJ,IAAI,EAAE,QAAQ;qBACd,WAAW,EAAE,kDAAkD;;iBAEjE,KAAK;qBACH,IAAI,EAAE,QAAQ;qBACd,WAAW,EAAE,4DAA4D;;iBAE3E,KAAK;qBACH,IAAI,EAAE,QAAQ;qBACd,WAAW,EAAE,6BAA6B;qBAC1C,OAAO,EAAE,EAAE;;iBAEb,SAAS;qBACP,IAAI,EAAE,QAAQ;qBACd,WAAW,EAAE,yCAAyC;;;aAG1D,QAAQ;CACA,CAAC;AAEX,eAAO,MAAM,mBAAmB,EAAE,cAejC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAkB/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAuBjC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cAiBlC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,cAiBrC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,cAqDzC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,cA0BvC,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAQrD,CAAC"}