@nodetool-ai/cli 0.8.4-a24.3 → 0.8.5

package/dist/commands/runtime.js

@@ -6,17 +6,23 @@
  * The specs are `RUNTIME_NPM_PACKAGES` from `@nodetool-ai/protocol`, the same
  * pinned list the desktop Package Manager installs. A feature that needs a
  * missing one fails with a message naming `nodetool runtime add <id>`.
+ *
+ * `sd-cpp` is the one binary here: the stable-diffusion.cpp `sd-server`
+ * release, unpacked into `runtimeLocations().sdCpp` by the installer the
+ * desktop app shares.
  */
 import { existsSync } from "node:fs";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { z } from "zod";
+import { installSdCpp, runtimeLocations, sdCppInstallStatus, uninstallSdCpp } from "@nodetool-ai/config";
 import { RUNTIME_NPM_PACKAGES, RUNTIME_PACKAGE_NAMES, isRuntimeNpmPackageId } from "@nodetool-ai/protocol";
 import { optionalNodeModulesDir, optionalNodeRoot } from "../optional-node-root.js";
 import { asJson, printTable } from "./output.js";
 import { runNpm } from "../npm-runner.js";
 import { withInstallLock } from "../install-lock.js";
 const installedManifestSchema = z.object({ version: z.string() });
+const SD_CPP_ID = "sd-cpp";
 /** The version installed in the optional-node root, or null. */
 async function installedVersion(packageName) {
     const manifest = join(optionalNodeModulesDir(), packageName, "package.json");
@@ -32,9 +38,26 @@ async function installedVersion(packageName) {
         return null;
     }
 }
+function sdCppDir() {
+    const dir = runtimeLocations().sdCpp;
+    if (!dir) {
+        throw new Error("This host has no sd-server install directory. Set SD_CPP_SERVER_PATH instead.");
+    }
+    return dir;
+}
+async function sdCppRow() {
+    const status = await sdCppInstallStatus(sdCppDir(), process.platform);
+    return {
+        id: SD_CPP_ID,
+        name: RUNTIME_PACKAGE_NAMES[SD_CPP_ID],
+        installed: status.installed,
+        version: status.version ?? "",
+        description: "Local image generation server (sd-server) for the stable-diffusion.cpp provider."
+    };
+}
 async function runtimeRows() {
     const ids = Object.keys(RUNTIME_NPM_PACKAGES).filter(isRuntimeNpmPackageId);
-    return Promise.all(ids.map(async (id) => {
+    const npmRows = await Promise.all(ids.map(async (id) => {
         const spec = RUNTIME_NPM_PACKAGES[id];
         const versions = await Promise.all(spec.packageNames.map(installedVersion));
         const installed = versions.every((version) => version !== null);
@@ -46,15 +69,16 @@ async function runtimeRows() {
             description: spec.description
         };
     }));
+    return runtimeLocations().sdCpp ? [...npmRows, await sdCppRow()] : npmRows;
 }
 /** Parse the ids a user typed, failing on any id the catalog lacks. */
 function parseIds(ids) {
-    const unknown = ids.filter((id) => !isRuntimeNpmPackageId(id));
+    const unknown = ids.filter((id) => id !== SD_CPP_ID && !isRuntimeNpmPackageId(id));
     if (unknown.length > 0) {
-        const known = Object.keys(RUNTIME_NPM_PACKAGES).join(", ");
+        const known = [...Object.keys(RUNTIME_NPM_PACKAGES), SD_CPP_ID].join(", ");
         throw new Error(`Unknown runtime package: ${unknown.join(", ")}. Known: ${known}.`);
     }
-    return ids.filter(isRuntimeNpmPackageId);
+    return { npm: ids.filter(isRuntimeNpmPackageId), sdCpp: ids.includes(SD_CPP_ID) };
 }
 /** Create the root with a private manifest, so npm installs into it. */
 async function ensureRoot() {
@@ -87,7 +111,24 @@ export function registerRuntimeCommands(program) {
         .description("Install one or more runtime packages by id")
         .argument("<ids...>", "Runtime package ids, from `nodetool runtime list`")
         .action(async (ids) => {
-        const parsed = parseIds(ids);
+        const { npm: parsed, sdCpp } = parseIds(ids);
+        if (sdCpp) {
+            const installDir = sdCppDir();
+            console.error(`Installing sd-cpp into ${installDir}`);
+            await installSdCpp({
+                installDir,
+                platform: process.platform,
+                arch: process.arch,
+                onEvent: (event) => {
+                    if (event.type === "stage") {
+                        console.error(event.label);
+                    }
+                }
+            });
+        }
+        if (parsed.length === 0) {
+            return;
+        }
         const specs = parsed.flatMap((id) => RUNTIME_NPM_PACKAGES[id].npmPackages);
         const root = optionalNodeRoot();
         console.error(`Installing ${parsed.join(", ")} into ${root}`);
@@ -103,7 +144,13 @@ export function registerRuntimeCommands(program) {
         .description("Uninstall one or more runtime packages by id")
         .argument("<ids...>", "Runtime package ids")
         .action(async (ids) => {
-        const parsed = parseIds(ids);
+        const { npm: parsed, sdCpp } = parseIds(ids);
+        if (sdCpp) {
+            await uninstallSdCpp(sdCppDir());
+        }
+        if (parsed.length === 0) {
+            return;
+        }
         const names = parsed.flatMap((id) => RUNTIME_NPM_PACKAGES[id].packageNames);
         const root = optionalNodeRoot();
         if (!existsSync(join(root, "package.json"))) {

package/dist/commands/runtime.js.map

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

package/dist/commands/telemetry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `nodetool telemetry` — the CLI's consent controls for anonymous usage
+ * analytics. Nothing is sent until `enable` runs, and nothing here ever
+ * prompts. See docs/analytics.md.
+ */
+import type { Command } from "commander";
+import { type AnalyticsClient } from "@nodetool-ai/analytics";
+type Env = Readonly<Record<string, string | undefined>>;
+export declare const NEVER_COLLECTED: readonly ["command lines, arguments and flags", "file paths, file names and the working directory", "environment variables, API keys and tokens", "stdin, stdout and stderr", "prompts, workflow contents and outputs", "URLs you pass to commands", "account, project and workflow IDs"];
+export interface TelemetryStatus {
+    enabled: boolean;
+    consent: string;
+    disabledByEnv: boolean;
+    configFile: string;
+    endpoint: string;
+    pendingEvents: number;
+}
+export declare function telemetryStatus(client: AnalyticsClient, env: Env, configFile: string): Promise<TelemetryStatus>;
+export declare function registerTelemetryCommands(program: Command, deps?: {
+    env?: Env;
+    configFile?: string;
+}): void;
+export {};
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/commands/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/commands/telemetry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAMhC,KAAK,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAExD,eAAO,MAAM,eAAe,YAC1B,oCAAoC,EACpC,kDAAkD,EAClD,4CAA4C,EAC5C,0BAA0B,EAC1B,wCAAwC,EACxC,2BAA2B,EAC3B,mCAAmC,CAC3B,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,GAAG,EACR,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAY1B;AAeD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5C,IAAI,CAoFN"}

package/dist/commands/telemetry.js

@@ -0,0 +1,116 @@
+import { ANALYTICS_EVENTS, isAnalyticsDisabledByEnv } from "@nodetool-ai/analytics";
+import { defaultCliAnalyticsPath } from "@nodetool-ai/analytics/node";
+import { asJson, printKv } from "./output.js";
+import { cliAnalyticsEndpoint, createCliAnalyticsClient } from "../telemetry.js";
+export const NEVER_COLLECTED = [
+    "command lines, arguments and flags",
+    "file paths, file names and the working directory",
+    "environment variables, API keys and tokens",
+    "stdin, stdout and stderr",
+    "prompts, workflow contents and outputs",
+    "URLs you pass to commands",
+    "account, project and workflow IDs"
+];
+export async function telemetryStatus(client, env, configFile) {
+    await client.ready;
+    const disabledByEnv = isAnalyticsDisabledByEnv(env);
+    const consent = client.getConsent().productAnalytics;
+    return {
+        enabled: consent === "granted" && !disabledByEnv,
+        consent,
+        disabledByEnv,
+        configFile,
+        endpoint: cliAnalyticsEndpoint(env),
+        pendingEvents: client.pendingEvents().length
+    };
+}
+function printStatus(status) {
+    printKv({
+        "Anonymous usage analytics": status.enabled ? "enabled" : "disabled",
+        Consent: status.consent,
+        "Disabled by environment": status.disabledByEnv
+            ? "yes (NODETOOL_TELEMETRY or DO_NOT_TRACK)"
+            : "no",
+        "Config file": status.configFile,
+        Endpoint: status.endpoint,
+        "Unsent events": status.pendingEvents
+    });
+}
+export function registerTelemetryCommands(program, deps = {}) {
+    const env = deps.env ?? process.env;
+    const configFile = deps.configFile ?? defaultCliAnalyticsPath();
+    const client = () => createCliAnalyticsClient({ env, storePath: configFile });
+    const telemetry = program
+        .command("telemetry")
+        .description("Anonymous usage analytics for the CLI: off until you enable it");
+    telemetry
+        .command("enable")
+        .description("Share anonymous, coarse usage events")
+        .action(async () => {
+        const c = client();
+        await c.setConsent("productAnalytics", "granted");
+        console.log("Anonymous usage analytics enabled. The CLI sends the command category, " +
+            "platform, version and bucketed run counts and durations.");
+        console.log(`Never collected: ${NEVER_COLLECTED.join("; ")}.`);
+        if (isAnalyticsDisabledByEnv(env)) {
+            console.log("NODETOOL_TELEMETRY or DO_NOT_TRACK is set, so nothing is sent while it stays set.");
+        }
+        console.log("Run `nodetool telemetry disable` to turn it off.");
+        c.shutdown();
+    });
+    telemetry
+        .command("disable")
+        .description("Stop sending and delete unsent events and the anonymous ID")
+        .action(async () => {
+        const c = client();
+        await c.setConsent("productAnalytics", "denied");
+        console.log("Anonymous usage analytics disabled. Unsent events and the anonymous ID were deleted.");
+        c.shutdown();
+    });
+    telemetry
+        .command("status")
+        .description("Show whether telemetry is on and why")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const c = client();
+        const status = await telemetryStatus(c, env, configFile);
+        if (opts.json)
+            asJson(status);
+        else
+            printStatus(status);
+        c.shutdown();
+    });
+    telemetry
+        .command("inspect")
+        .description("Print unsent events and an example event exactly as they would be sent, without sending")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const c = client();
+        const status = await telemetryStatus(c, env, configFile);
+        const example = c.preview({
+            event: "cli_started",
+            properties: { commandCategory: "run" }
+        });
+        const report = {
+            status,
+            pending: c.pendingEvents(),
+            example,
+            events: Object.keys(ANALYTICS_EVENTS),
+            neverCollected: NEVER_COLLECTED
+        };
+        if (opts.json) {
+            asJson(report);
+        }
+        else {
+            printStatus(status);
+            console.log("\nExample event (not sent):");
+            console.log(JSON.stringify(example, null, 2));
+            console.log(`\nUnsent events (${report.pending.length}):`);
+            for (const event of report.pending)
+                console.log(JSON.stringify(event));
+            console.log(`\nNever collected: ${NEVER_COLLECTED.join("; ")}.`);
+        }
+        c.shutdown();
+    });
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/commands/telemetry.js.map

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

package/dist/commands/tools.d.ts

@@ -0,0 +1,11 @@
+/** Direct local access to the same tools and guides as CLI agent sessions. */
+import type { Command } from "commander";
+import type { Tool } from "@nodetool-ai/agents";
+export interface AuthoringTools {
+    list(): Promise<Tool[]>;
+    call(name: string, args: Record<string, unknown>): Promise<unknown>;
+}
+export declare function parseToolArguments(raw: string): Promise<Record<string, unknown>>;
+export declare const AUTHORING_HELP = "\nAuthoring tools and starting documents:\n  nodetool tools list timeline\n  nodetool tools info create_timeline\n  nodetool skills list\n  nodetool skills read storyboard-core\n  nodetool skills read motion-graphics\n  nodetool skills read nodetool-workflow-builder\n  nodetool skills read nodetool-app-builder\n  nodetool skills read native-game\n  nodetool tools call list_projects\n  nodetool tools call create_timeline --args '{\"name\":\"My timeline\"}'\n  nodetool tools call <name> --args @arguments.json\n\nTools expose their current input schemas. Read the matching shipped guide\nbefore creating workflows, timelines, motion graphics, mini apps, or games.\n";
+export declare function registerAuthoringCommands(program: Command, load?: () => Promise<AuthoringTools>): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/commands/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/commands/tools.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAShD,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACxB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE;AA6ED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAUlC;AA0CD,eAAO,MAAM,cAAc,iqBAgB1B,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,MAAM,OAAO,CAAC,cAAc,CAAc,GAC/C,IAAI,CAmGN"}

package/dist/commands/tools.js

@@ -0,0 +1,206 @@
+import { readFile } from "node:fs/promises";
+import { asJson } from "./output.js";
+import { commandFailureExitCode, printCommandError } from "../command-errors.js";
+import { isRecord } from "../predicates.js";
+import { setupLocalDb, LOCAL_USER_ID } from "./local-db.js";
+async function localTools() {
+    const { buildCliToolbelt } = await import("../agent-toolbelt.js");
+    const { buildFullRegistry } = await import("../node-registry.js");
+    const registry = await buildFullRegistry();
+    const { toolForCapabilityName } = await import("@nodetool-ai/agents");
+    const byName = new Map(buildCliToolbelt({}, registry).map((tool) => [tool.name, tool]));
+    // Model discovery is provider-backed at invocation, but its schema is static.
+    for (const name of ["find_model", "list_models"]) {
+        if (!byName.has(name)) {
+            byName.set(name, toolForCapabilityName(name));
+        }
+    }
+    const tools = [...byName.values()];
+    return {
+        list: async () => tools,
+        call: async (name, args) => {
+            if (!tools.some((candidate) => candidate.name === name)) {
+                throw new Error(`Unknown tool: ${name}. Use nodetool tools list to discover names.`);
+            }
+            const { getDefaultDbPath } = await import("@nodetool-ai/config");
+            const { migrateSqliteDb, Project } = await import("@nodetool-ai/models");
+            await migrateSqliteDb(getDefaultDbPath());
+            await setupLocalDb();
+            await Project.ensurePersonal(LOCAL_USER_ID);
+            const { buildConfiguredProviders } = await import("../providers.js");
+            const providers = await buildConfiguredProviders();
+            const tool = buildCliToolbelt(providers, registry).find((candidate) => candidate.name === name);
+            if (!tool) {
+                throw new Error(`No configured providers are available for ${name}. Configure a provider before calling this tool.`);
+            }
+            const { createChatContext } = await import("../chat-context.js");
+            const context = await createChatContext({
+                workspaceDir: process.cwd(),
+                userId: LOCAL_USER_ID
+            });
+            for (const [id, provider] of Object.entries(providers)) {
+                context.registerProvider(id, provider);
+            }
+            const { RUN_BUDGET_CONTEXT_KEY } = await import("@nodetool-ai/runtime");
+            const { PERMISSION_GATE_CONTEXT_KEY, headlessGate } = await import("@nodetool-ai/agents");
+            const { createCliRunBudget } = await import("../run-budget.js");
+            context.set(RUN_BUDGET_CONTEXT_KEY, await createCliRunBudget());
+            context.set(PERMISSION_GATE_CONTEXT_KEY, headlessGate("CLI tool call"));
+            const { attachRunCostLedger } = await import("@nodetool-ai/execution");
+            const ledger = attachRunCostLedger(context, {
+                userId: LOCAL_USER_ID,
+                workflowId: null
+            });
+            const controller = new AbortController();
+            const cancel = () => controller.abort(new Error("Tool call interrupted"));
+            context.signal = controller.signal;
+            process.once("SIGINT", cancel);
+            process.once("SIGTERM", cancel);
+            try {
+                return await tool.execute(context, args);
+            }
+            finally {
+                await ledger.settled();
+                ledger();
+                process.removeListener("SIGINT", cancel);
+                process.removeListener("SIGTERM", cancel);
+            }
+        }
+    };
+}
+export async function parseToolArguments(raw) {
+    const value = JSON.parse(raw.startsWith("@") ? await readFile(raw.slice(1), "utf8") : raw);
+    if (!isRecord(value)) {
+        throw new Error("--args must be a JSON object or @path to a JSON object file.");
+    }
+    return value;
+}
+/** Inspect only result envelopes whose tool contracts define failure statuses. */
+function toolCallFailed(name, result) {
+    if (!isRecord(result)) {
+        return false;
+    }
+    if (commandFailureExitCode(result) === 3 ||
+        result.error ||
+        result.isError === true ||
+        result.success === false ||
+        result.ok === false) {
+        return true;
+    }
+    switch (name) {
+        case "get_node_info":
+        case "search_nodes":
+            return result.status === "error";
+        case "run_node":
+        case "run_workflow":
+        case "resolve_workflow_escalation":
+            return result.status === "failed" || result.status === "error";
+        case "debug_app":
+            return (result.status === "failed" ||
+                (isRecord(result.verdict) && result.verdict.ok === false));
+        case "debug_workflow":
+            return (isRecord(result.run) &&
+                (result.run.status === "failed" ||
+                    result.run.status === "error" ||
+                    Boolean(result.run.error) ||
+                    (isRecord(result.run.verdict) && result.run.verdict.ok === false)));
+        default:
+            return false;
+    }
+}
+export const AUTHORING_HELP = `
+Authoring tools and starting documents:
+  nodetool tools list timeline
+  nodetool tools info create_timeline
+  nodetool skills list
+  nodetool skills read storyboard-core
+  nodetool skills read motion-graphics
+  nodetool skills read nodetool-workflow-builder
+  nodetool skills read nodetool-app-builder
+  nodetool skills read native-game
+  nodetool tools call list_projects
+  nodetool tools call create_timeline --args '{"name":"My timeline"}'
+  nodetool tools call <name> --args @arguments.json
+
+Tools expose their current input schemas. Read the matching shipped guide
+before creating workflows, timelines, motion graphics, mini apps, or games.
+`;
+export function registerAuthoringCommands(program, load = localTools) {
+    const run = async (name, args) => {
+        try {
+            const result = await (await load()).call(name, args);
+            asJson(result);
+            if (toolCallFailed(name, result)) {
+                const failure = name === "debug_workflow" && isRecord(result) && isRecord(result.run)
+                    ? result.run
+                    : result;
+                process.exitCode = commandFailureExitCode(failure);
+            }
+        }
+        catch (error) {
+            process.exitCode = printCommandError(error, true);
+        }
+    };
+    const tools = program
+        .command("tools")
+        .description("Discover tool schemas and call local authoring tools")
+        .addHelpText("after", AUTHORING_HELP);
+    tools
+        .command("list [query]")
+        .description("List tool names and descriptions, optionally filtered")
+        .action(async (query) => {
+        const matches = (await (await load()).list()).filter((tool) => !query ||
+            `${tool.name} ${tool.description}`
+                .toLowerCase()
+                .includes(query.toLowerCase()));
+        asJson(matches.map((tool) => ({
+            name: tool.name,
+            description: tool.description
+        })));
+    });
+    tools
+        .command("info <name>")
+        .description("Print the authoritative input schema for a tool")
+        .action(async (name) => {
+        const tool = (await (await load()).list()).find((candidate) => candidate.name === name);
+        if (!tool) {
+            throw new Error(`Unknown tool: ${name}. Use nodetool tools list.`);
+        }
+        asJson({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema
+        });
+    });
+    tools
+        .command("call <name>")
+        .description("Execute a local tool. Calls can save documents, run jobs, or use configured providers.")
+        .option("--args <json|@file>", "JSON arguments, inline or read from a file", "{}")
+        .action(async (name, options) => run(name, await parseToolArguments(options.args)));
+    const skills = program
+        .command("skills")
+        .description("Find and read installed authoring guides and user skills");
+    skills
+        .command("list [query]")
+        .description("Search the installed skill catalog")
+        .action(async (query) => run("list_skills", query ? { query } : {}));
+    skills
+        .command("read <name>")
+        .description("Read a guide, including its starting examples and tool instructions")
+        .action(async (name) => run("load_skill", { name }));
+    program.addHelpText("after", AUTHORING_HELP);
+    for (const name of [
+        "timeline",
+        "game",
+        "app",
+        "apps",
+        "workflows",
+        "jsscript",
+        "sketch"
+    ]) {
+        program.commands
+            .find((command) => command.name() === name)
+            ?.addHelpText("after", AUTHORING_HELP);
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/commands/tools.js.map

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

package/dist/harness/capability-table.js

@@ -242,7 +242,7 @@ export const CAPABILITY_COVERAGE = [
         name: "export_workflow_digraph",
         module: "workflows",
         impl: "packages/agents/src/capabilities/workflows.ts",
-        contract: "adbf4387177b",
+        contract: "e77dc5f2c0d1",
         selfcheck: "capability-suites",
         suites: [
             "packages/agents/tests/mcp-tools.test.ts",
@@ -1271,7 +1271,7 @@ export const CAPABILITY_COVERAGE = [
         name: "edit_app",
         module: "apps",
         impl: "packages/agents/src/capabilities/apps.ts",
-        contract: "80aab4b438b8",
+        contract: "5d71cf4b7e8e",
         selfcheck: "capability-suites",
         suites: [
             "packages/agents/tests/capabilities-apps.test.ts",
@@ -2644,8 +2644,8 @@ export const CAPABILITY_COVERAGE = [
         suites: [
             "packages/agents/tests/capabilities-game.test.ts",
             "packages/agents/tests/capabilities-game3d.test.ts",
+            "packages/agents/tests/capabilities-game-assertions.test.ts",
             "packages/agents/tests/capabilities-game-asset-browser.test.ts",
-            "packages/agents/tests/capabilities-game-authoring.test.ts",
         ],
         evals: [
             {
@@ -2702,13 +2702,13 @@ export const CAPABILITY_COVERAGE = [
         name: "playtest_native_game",
         module: "game",
         impl: "packages/agents/src/capabilities/game.ts",
-        contract: "dc700e7f4caa",
+        contract: "7b0863b4985f",
         selfcheck: "capability-suites",
         suites: [
             "packages/agents/tests/capabilities-game.test.ts",
             "packages/agents/tests/capabilities-game3d.test.ts",
+            "packages/agents/tests/capabilities-game-assertions.test.ts",
             "packages/agents/tests/capabilities-game-autoplay.test.ts",
-            "packages/agents/tests/game-asset-pipeline.test.ts",
         ],
     },
     {
@@ -2731,8 +2731,8 @@ export const CAPABILITY_COVERAGE = [
         suites: [
             "packages/agents/tests/capabilities-game.test.ts",
             "packages/agents/tests/capabilities-game3d.test.ts",
+            "packages/agents/tests/capabilities-game-assertions.test.ts",
             "packages/agents/tests/capabilities-game-authoring.test.ts",
-            "packages/agents/tests/capabilities-game-autoplay.test.ts",
         ],
         evals: [
             {
@@ -2741,7 +2741,7 @@ export const CAPABILITY_COVERAGE = [
             },
             {
                 file: "packages/agents/src/evals/surfaces/game.ts",
-                cases: ["audio-mixer-buses", "cascaded-shadows", "collision-layer-matrix", "entity-tags-properties", "environment-preset-3d", "forces-and-torques-3d", "hud-widget-tree", "hud-widget-tree-3d", "input-bindings", "lifecycle-timer-script", "material-system-3d", "particle-emitter", "particle-rendering", "particle-rendering-3d", "physics-materials", "player-saves-script", "post-processing", "procedural-sky", "render-culling", "script-parameters", "spatial-audio-source", "typed-event-script"],
+                cases: ["audio-mixer-buses", "cascaded-shadows", "collision-layer-matrix", "entity-tags-properties", "environment-preset-3d", "forces-and-torques-3d", "height-fog-and-decals-3d", "hud-widget-tree", "hud-widget-tree-3d", "input-bindings", "lifecycle-timer-script", "material-system-3d", "particle-emitter", "particle-rendering", "particle-rendering-3d", "physics-materials", "player-saves-script", "post-processing", "procedural-sky", "render-culling", "script-parameters", "spatial-audio-source", "typed-event-script"],
             },
         ],
     },
@@ -3086,7 +3086,7 @@ export const CAPABILITY_COVERAGE = [
         name: "edit_storyboard",
         module: "storyboards",
         impl: "packages/agents/src/capabilities/storyboards.ts",
-        contract: "f8a51c6734fd",
+        contract: "a2f214d7936b",
         selfcheck: "capability-suites",
         suites: [
             "packages/agents/tests/capabilities-storyboards.test.ts",