@anna-ai/cli 0.1.22 → 0.1.23

package/dist/{agent-Br6zY2qw.js → agent-DyXJhaZ0.js}

@@ -1,5 +1,5 @@
 import { canonicalHost } from "./credentials-BTv2IfUZ.js";
-import { hostOf, mintAppSession, requireAccount, withCode } from "./dev-account-qRaET1Cp.js";
+import { hostOf, mintAppSession, requireAccount, withCode } from "./dev-account-CD6hTr7M.js";
 import { resolve } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 

package/dist/{app-bundle-upload-DuLalcSt.js → app-bundle-upload-Cd4ci4rB.js}

@@ -1,6 +1,6 @@
 import { finalizeBundle, finalizeWorkingBundle, getBundle, initBundle, initWorkingBundle, uploadBundleFile, uploadWorkingBundleFile } from "./apps-B1Nd8l_t.js";
 import { CliError } from "./client-Dn9zThOd.js";
-import { canonicalize } from "./executa-publish-Ca5V7MyA.js";
+import { canonicalize } from "./executa-publish-BKFq6Hz9.js";
 import { join, relative, sep } from "node:path";
 import { readFileSync, readdirSync, statSync } from "node:fs";
 import { createHash } from "node:crypto";

package/dist/{apps-cut-DtEkddIk.js → apps-cut-BG6Ib3x4.js}

@@ -4,11 +4,13 @@ import { CliError } from "./client-Dn9zThOd.js";
 import { readExecutasLock, writeExecutasLock } from "./bundled-executas-BNOKw4kv.js";
 import "./executas-Cep6KEo0.js";
 import "./executa-cache-BFoUtb4J.js";
-import "./executa-publish-Ca5V7MyA.js";
-import "./manifest-DGwRap2i.js";
+import "./executa-publish-BKFq6Hz9.js";
+import "./manifest-hXWnNFHE.js";
 import { resolveClient, withErrorHandling } from "./_lifecycle-shared-sbea9HtH.js";
-import "./app-cache-BEM653Th.js";
-import { resolveAppBySlugOrCache } from "./working-orchestration-Dw9u1Vq0.js";
+import "./dev-CyFATq6R.js";
+import "./executa-install-DnBG8UJA.js";
+import "./app-cache-TcmbIIuL.js";
+import { resolveAppBySlugOrCache } from "./working-orchestration-CIpQ_JMY.js";
 import { resolve } from "node:path";
 import { bold, cyan, dim, green, yellow } from "kleur/colors";
 

package/dist/{apps-destructive-DSTrcFUP.js → apps-destructive-DQIFqYE2.js}

@@ -2,7 +2,7 @@ import "./credentials-BTv2IfUZ.js";
 import { archiveApp, deleteApp, findAppBySlug, unarchiveApp, unpublishApp } from "./apps-B1Nd8l_t.js";
 import { CliError } from "./client-Dn9zThOd.js";
 import { resolveClient, withErrorHandling } from "./_lifecycle-shared-sbea9HtH.js";
-import { ensureDestructiveAllowed } from "./confirm-DxHkk9Wn.js";
+import { ensureDestructiveAllowed } from "./confirm-C-4haiIg.js";
 import { dim, green, yellow } from "kleur/colors";
 
 //#region src/commands/apps-destructive.ts

package/dist/{apps-discard-y3_IwcbQ.js → apps-discard-BveXHAgF.js}

@@ -4,11 +4,13 @@ import "./client-Dn9zThOd.js";
 import "./bundled-executas-BNOKw4kv.js";
 import "./executas-Cep6KEo0.js";
 import "./executa-cache-BFoUtb4J.js";
-import "./executa-publish-Ca5V7MyA.js";
-import "./manifest-DGwRap2i.js";
+import "./executa-publish-BKFq6Hz9.js";
+import "./manifest-hXWnNFHE.js";
 import { resolveClient, withErrorHandling } from "./_lifecycle-shared-sbea9HtH.js";
-import "./app-cache-BEM653Th.js";
-import { resolveAppBySlugOrCache } from "./working-orchestration-Dw9u1Vq0.js";
+import "./dev-CyFATq6R.js";
+import "./executa-install-DnBG8UJA.js";
+import "./app-cache-TcmbIIuL.js";
+import { resolveAppBySlugOrCache } from "./working-orchestration-CIpQ_JMY.js";
 import { dim, green, yellow } from "kleur/colors";
 
 //#region src/commands/apps-discard.ts

package/dist/{apps-publish-DfZTOxBJ.js → apps-publish-D403z305.js}

@@ -4,11 +4,11 @@ import "./client-Dn9zThOd.js";
 import "./bundled-executas-BNOKw4kv.js";
 import "./executas-Cep6KEo0.js";
 import "./executa-cache-BFoUtb4J.js";
-import "./executa-publish-Ca5V7MyA.js";
-import "./manifest-DGwRap2i.js";
+import "./executa-publish-BKFq6Hz9.js";
+import "./manifest-hXWnNFHE.js";
 import "./_lifecycle-shared-sbea9HtH.js";
-import "./app-cache-BEM653Th.js";
-import "./app-bundle-upload-DuLalcSt.js";
-import { runAppsPublish } from "./apps-publish-CaTCanDu.js";
+import "./app-cache-TcmbIIuL.js";
+import "./app-bundle-upload-Cd4ci4rB.js";
+import { runAppsPublish } from "./apps-publish-U_Y7svJw.js";
 
 export { runAppsPublish };

package/dist/{apps-publish-CaTCanDu.js → apps-publish-U_Y7svJw.js}

@@ -2,11 +2,11 @@ import { canonicalHost } from "./credentials-BTv2IfUZ.js";
 import { createApp, createVersion, findAppBySlug, getApp } from "./apps-B1Nd8l_t.js";
 import { CliError } from "./client-Dn9zThOd.js";
 import { parseExecutaIdOverrides, readExecutasLock, substituteBundledRefs, validateBundledHandles, writeBundleToolIdSidecar, writeExecutasLock } from "./bundled-executas-BNOKw4kv.js";
-import { bumpVersion, bundleHash, manifestHash, rewriteVersion, runExecutaPublish } from "./executa-publish-Ca5V7MyA.js";
-import { loadAppManifest } from "./manifest-DGwRap2i.js";
+import { bumpVersion, bundleHash, manifestHash, rewriteVersion, runExecutaPublish } from "./executa-publish-BKFq6Hz9.js";
+import { loadAppManifest } from "./manifest-hXWnNFHE.js";
 import { resolveClient, withErrorHandling } from "./_lifecycle-shared-sbea9HtH.js";
-import { appCacheMatches, readAppIdentity, writeAppIdentity } from "./app-cache-BEM653Th.js";
-import { isExistingDir, uploadAppBundle } from "./app-bundle-upload-DuLalcSt.js";
+import { appCacheMatches, readAppIdentity, writeAppIdentity } from "./app-cache-TcmbIIuL.js";
+import { isExistingDir, uploadAppBundle } from "./app-bundle-upload-Cd4ci4rB.js";
 import { resolve } from "node:path";
 import { bold, cyan, dim, green, yellow } from "kleur/colors";
 

package/dist/{apps-push-B9XT2uwF.js → apps-push-x5reIQHx.js}

@@ -4,12 +4,14 @@ import { CliError } from "./client-Dn9zThOd.js";
 import "./bundled-executas-BNOKw4kv.js";
 import "./executas-Cep6KEo0.js";
 import "./executa-cache-BFoUtb4J.js";
-import { bumpVersion, bundleHash, manifestHash, rewriteVersion } from "./executa-publish-Ca5V7MyA.js";
-import { loadAppManifest } from "./manifest-DGwRap2i.js";
+import { bumpVersion, bundleHash, manifestHash, rewriteVersion } from "./executa-publish-BKFq6Hz9.js";
+import { loadAppManifest } from "./manifest-hXWnNFHE.js";
 import { resolveClient, withErrorHandling } from "./_lifecycle-shared-sbea9HtH.js";
-import "./app-cache-BEM653Th.js";
-import { resolveAppIdentity, resolveBundledExecutas } from "./working-orchestration-Dw9u1Vq0.js";
-import { isExistingDir, uploadWorkingBundle } from "./app-bundle-upload-DuLalcSt.js";
+import "./dev-CyFATq6R.js";
+import "./executa-install-DnBG8UJA.js";
+import "./app-cache-TcmbIIuL.js";
+import { installLocalBundledShims, resolveAppIdentity, resolveBundledExecutas } from "./working-orchestration-CIpQ_JMY.js";
+import { isExistingDir, uploadWorkingBundle } from "./app-bundle-upload-Cd4ci4rB.js";
 import { resolve } from "node:path";
 import { bold, cyan, dim, green, yellow } from "kleur/colors";
 
@@ -27,7 +29,7 @@ async function runAppsPush(opts) {
 			manifest.version = next;
 			manifest.metadataRaw.version = next;
 		}
-		const { publishManifestRaw } = await resolveBundledExecutas({
+		const { publishManifestRaw, resolved } = await resolveBundledExecutas({
 			manifest,
 			cwd,
 			host,
@@ -40,6 +42,13 @@ async function runAppsPush(opts) {
 			account: opts.account,
 			json: opts.json
 		});
+		let installedShims = [];
+		if (!opts.dryRun && !opts.noInstallLocal && Object.keys(resolved).length > 0) installedShims = await installLocalBundledShims({
+			manifest,
+			cwd,
+			resolved,
+			json: opts.json
+		});
 		const identity = await resolveAppIdentity({
 			client,
 			cwd,
@@ -101,6 +110,7 @@ async function runAppsPush(opts) {
 				first_publish: firstPublish,
 				status: finalApp.status,
 				dirty_vs_latest_cut: draft?.dirty_vs_latest_cut ?? null,
+				installed_shims: installedShims,
 				bundle: bundleResult ? {
 					status: bundleResult.status,
 					file_count: bundleResult.fileCount,
@@ -117,6 +127,10 @@ async function runAppsPush(opts) {
 		else console.log(green(`  ✓ working bundle: ${bundleResult.fileCount} files, ${(bundleResult.totalBytes / 1024).toFixed(1)} KB → ${bundleResult.bundleStatus}`));
 		console.log(bold(cyan(`status: ${finalApp.status}`)));
 		if (draft?.dirty_vs_latest_cut) console.log(dim(`  (uncommitted changes vs latest cut version)`));
+		if (installedShims.length > 0) {
+			for (const s of installedShims) console.log(green(`  ✓ installed local dev shim: `) + cyan(s.tool_id));
+			console.log(dim(`→ click `) + cyan(`Rediscover Local`) + dim(` in the Agent's Plugin Details to load `) + (installedShims.length === 1 ? dim("it") : dim("them")));
+		}
 		console.log(dim(`→ install & test the draft (reserved `) + cyan(`0.0.0-draft`) + dim(`) from the Developer Console`));
 		console.log(dim(`→ run `) + cyan(`anna-app apps cut ${manifest.version}`) + dim(` to snapshot an immutable version`));
 		return 0;

package/dist/{apps-release-BLH9XSxB.js → apps-release-ByIgz6lx.js}

@@ -2,7 +2,7 @@ import { canonicalHost } from "./credentials-BTv2IfUZ.js";
 import { findAppBySlug, getApp, getBundle, listVersions, publishVersion } from "./apps-B1Nd8l_t.js";
 import { CliError } from "./client-Dn9zThOd.js";
 import { resolveClient, withErrorHandling } from "./_lifecycle-shared-sbea9HtH.js";
-import { readAppIdentity } from "./app-cache-BEM653Th.js";
+import { readAppIdentity } from "./app-cache-TcmbIIuL.js";
 import { resolve } from "node:path";
 import { bold, cyan, dim, green, yellow } from "kleur/colors";
 
@@ -58,7 +58,7 @@ async function runAppsRelease(opts) {
 		if (!target) {
 			if (opts.allowCreate) {
 				if (!opts.json) console.log(yellow(`version ${opts.version} not found remotely; running 'apps publish' first (--allow-create)…`));
-				const { runAppsPublish } = await import("./apps-publish-DfZTOxBJ.js");
+				const { runAppsPublish } = await import("./apps-publish-D403z305.js");
 				const code = await runAppsPublish({
 					cwd: opts.cwd,
 					account: opts.account,

package/dist/{apps-submit-review-DLwCxeAs.js → apps-submit-review-D-cPtZtc.js}

@@ -2,7 +2,7 @@ import { canonicalHost } from "./credentials-BTv2IfUZ.js";
 import { findAppBySlug, getApp, submitForReview } from "./apps-B1Nd8l_t.js";
 import { CliError } from "./client-Dn9zThOd.js";
 import { resolveClient, withErrorHandling } from "./_lifecycle-shared-sbea9HtH.js";
-import { readAppIdentity } from "./app-cache-BEM653Th.js";
+import { readAppIdentity } from "./app-cache-TcmbIIuL.js";
 import { resolve } from "node:path";
 import { bold, cyan, green } from "kleur/colors";
 

package/dist/{apps-sync-meta-D9eKMMUp.js → apps-sync-meta-CTHwGlzI.js}

@@ -1,9 +1,9 @@
 import { canonicalHost } from "./credentials-BTv2IfUZ.js";
 import { findAppBySlug, getApp, patchApp } from "./apps-B1Nd8l_t.js";
 import { CliError } from "./client-Dn9zThOd.js";
-import { loadAppManifest } from "./manifest-DGwRap2i.js";
+import { loadAppManifest } from "./manifest-hXWnNFHE.js";
 import { resolveClient, withErrorHandling } from "./_lifecycle-shared-sbea9HtH.js";
-import { readAppIdentity } from "./app-cache-BEM653Th.js";
+import { readAppIdentity } from "./app-cache-TcmbIIuL.js";
 import { resolve } from "node:path";
 import { bold, cyan, dim, green } from "kleur/colors";
 

package/dist/{bridge-BuklhzeE.js → bridge-CBew_Ytl.js}

@@ -9,7 +9,7 @@ import { createInterface } from "node:readline";
 * `uvx <pkg>@<version>` so end users always run the dispatcher version
 * the CLI was tested against.
 */
-const PINNED_RUNTIME_VERSION = "0.2.0a6";
+const PINNED_RUNTIME_VERSION = "0.2.0a7";
 /**
 * Throwable from a {@link RequestHandler} to send a structured JSON-RPC
 * error back to the python bridge with a stable string ``code`` (e.g.

package/dist/bridge-DZmZIWG0.js

@@ -0,0 +1,3 @@
+import { BridgeRequestError, PINNED_RUNTIME_VERSION, PythonBridge } from "./bridge-CBew_Ytl.js";
+
+export { PINNED_RUNTIME_VERSION, PythonBridge };

package/dist/cli.js

@@ -137,11 +137,16 @@ function hostApiAllows(manifest, ns, method) {
 	if (!manifest.ui) return false;
 	if (ns === "window") return true;
 	const grants = manifest.ui.host_api ?? {};
+	if (ns === "tools" && (method === "invoke" || method === "list")) {
+		const tools = grants.tools;
+		if (tools && tools.length > 0) return true;
+		const declared = (manifest.required_executas?.length ?? 0) + (manifest.optional_executas?.length ?? 0);
+		return declared > 0;
+	}
 	const methods = grants[ns];
 	if (!methods || methods.length === 0) return false;
 	if (methods.includes("*")) return true;
 	if (methods.includes(method)) return true;
-	if (ns === "tools" && (method === "invoke" || method === "list")) return true;
 	return false;
 }
 function checkHostApiAllowance(usages, manifest, bundleMethods) {
@@ -460,7 +465,7 @@ program.command("validate").description("Run schema + ACL checks on a manifest+b
 	process.exit(code);
 });
 program.command("dev").description("Run a local harness (in-process dispatcher + iframe + SSE relay)").option("--manifest <path>", "manifest.json path", "manifest.json").option("--bundle <dir>", "bundle directory (default: ./bundle)").option("--slug <slug>", "App slug (overrides manifest.slug/name)").option("--view <name>", "View name to open (default: manifest default)").option("--matrix-nexus-root <path>", "matrix-nexus checkout (auto-detected if omitted; can also use $ANNA_NEXUS_ROOT)").option("--port <number>", "HTTP port", "5180").option("--user-id <id>", "Harness user_id", "1").option("--cwd <dir>", "Project root (default: cwd)").option("--no-watch", "Disable bundle file watcher (default: enabled)").option("--executa <spec>", "Explicit executa registration; repeatable. Spec: comma-separated key=value (dir=<path>[,tool_id=<id>][,type=python|node|go|binary][,command=\"<argv>\"]). When only `dir=` is given, the executa is auto-detected from executa.json / pyproject.toml / package.json / go.mod. Overrides directory auto-discovery under <manifest-dir>/executas/.", (val, prev) => prev ? [...prev, val] : [val]).option("--no-llm", "Disable LLM bridge (anna.llm/agent return llm_disabled)").option("--mock-llm <fixture>", "Serve canned LLM responses from a JSONL fixture").option("--llm-account <host>", "Saved account host to use (default: current)").option("--llm-app-slug <slug>", "Override the manifest slug used to register / look up the dev AnnaApp (default: manifest.slug)").option("--storage <mode>", "Storage backend: \"legacy\" (in-memory runtime_state, default) or \"aps\" (real nexus APS via /api/v1/storage/* — requires `anna-app login`).", "legacy").action(async (opts) => {
-	const { runDev, parseExecutaSpec } = await import("./dev-BS_8yoSm.js");
+	const { runDev, parseExecutaSpec } = await import("./dev-DdjwQzJ2.js");
 	const cwd = opts.cwd ?? process.cwd();
 	let executas;
 	if (opts.executa && opts.executa.length > 0) {
@@ -495,7 +500,7 @@ program.command("dev").description("Run a local harness (in-process dispatcher +
 });
 const fixture = program.command("fixture").description("Inspect / replay harness recordings (Phase 6)");
 fixture.command("verify <file>").description("Schema + invariant checks on a harness JSONL recording").option("--json", "Emit machine-readable JSON", false).action(async (file, opts) => {
-	const { runFixtureVerify } = await import("./fixture-CYwxbiQD.js");
+	const { runFixtureVerify } = await import("./fixture-C9VLX3os.js");
 	const code = await runFixtureVerify({
 		file,
 		json: opts.json
@@ -503,7 +508,7 @@ fixture.command("verify <file>").description("Schema + invariant checks on a har
 	process.exit(code);
 });
 fixture.command("summarize <file>").description("Print a human-readable digest of a harness recording").option("--json", "Emit machine-readable JSON", false).action(async (file, opts) => {
-	const { runFixtureSummarize } = await import("./fixture-CYwxbiQD.js");
+	const { runFixtureSummarize } = await import("./fixture-C9VLX3os.js");
 	const code = await runFixtureSummarize({
 		file,
 		json: opts.json
@@ -511,7 +516,7 @@ fixture.command("summarize <file>").description("Print a human-readable digest o
 	process.exit(code);
 });
 fixture.command("replay <file>").description("Dry-run replay of a harness recording (Phase 6 MVP)").option("--manifest <path>", "manifest.json path", "manifest.json").action(async (file, opts) => {
-	const { runFixtureReplay } = await import("./fixture-CYwxbiQD.js");
+	const { runFixtureReplay } = await import("./fixture-C9VLX3os.js");
 	const code = await runFixtureReplay({
 		file,
 		manifest: opts.manifest
@@ -519,12 +524,12 @@ fixture.command("replay <file>").description("Dry-run replay of a harness record
 	process.exit(code);
 });
 program.command("doctor").description("Check environment for `anna-app dev` (uv, matrix-nexus, dev key)").option("--matrix-nexus-root <path>", "matrix-nexus checkout (optional)").action(async (opts) => {
-	const { runDoctor } = await import("./doctor-DKrt-Kda.js");
+	const { runDoctor } = await import("./doctor-oqYeEjLv.js");
 	const code = await runDoctor({ matrixNexusRoot: opts.matrixNexusRoot });
 	process.exit(code);
 });
 program.command("login").description("Device-flow login against a nexus host; saves a PAT to ~/.config/anna/credentials.json").requiredOption("--host <url>", "nexus base URL, e.g. https://nexus.example.com").option("--no-browser", "Do not open a browser window automatically", false).action(async (opts) => {
-	const { runLogin } = await import("./login-BGqFjQwH.js");
+	const { runLogin } = await import("./login-D4cU2Jcp.js");
 	const code = await runLogin({
 		host: opts.host,
 		noBrowser: opts.browser === false
@@ -532,7 +537,7 @@ program.command("login").description("Device-flow login against a nexus host; sa
 	process.exit(code);
 });
 program.command("logout").description("Remove a saved PAT entry").option("--host <url>", "Account to remove (default: current)").option("--all", "Remove every saved account", false).action(async (opts) => {
-	const { runLogout } = await import("./logout-CGIRKH3y.js");
+	const { runLogout } = await import("./logout-DOpL3vXX.js");
 	const code = await runLogout({
 		host: opts.host,
 		all: opts.all
@@ -540,7 +545,7 @@ program.command("logout").description("Remove a saved PAT entry").option("--host
 	process.exit(code);
 });
 program.command("whoami").description("Show the current account (and any others)").option("--json", "Emit machine-readable JSON", false).action(async (opts) => {
-	const { runWhoami } = await import("./whoami-BoFLEUcp.js");
+	const { runWhoami } = await import("./whoami-DarmijoA.js");
 	const code = await runWhoami({ json: opts.json });
 	process.exit(code);
 });
@@ -556,7 +561,7 @@ executa.command("init <dir>").description("Scaffold a standalone Executa plugin
 		console.error(`✗ unknown template "${opts.template}" — expected python | node | go`);
 		process.exit(2);
 	}
-	const { runExecutaInit } = await import("./executa-init-Jp-h9OI7.js");
+	const { runExecutaInit } = await import("./executa-init-By0kMPaF.js");
 	const code = runExecutaInit({
 		targetDir: dir,
 		slug,
@@ -566,13 +571,24 @@ executa.command("init <dir>").description("Scaffold a standalone Executa plugin
 	});
 	process.exit(code);
 });
-executa.command("register").description("Register a HARNESS AnnaApp(kind=executa) so `executa dev --storage real` (and agent / sampling / image / upload real-mode flows) can mint tokens for a local executa subprocess. Does NOT publish the executa itself — use `executa publish` for that. Lists/deletes via `apps list` / `apps delete`.").requiredOption("--tool-id <id>", "Executa tool_id (matches manifest.name)").option("--slug <slug>", "App slug (default: executa-<tool_id>; must be lowercase + hyphens)").option("--name <name>", "Human-readable display name (default: <tool_id>)").option("--account <host>", "Saved account host (default: current)").action(async (opts) => {
-	const { runExecutaRegister } = await import("./executa-register-CulDtwYZ.js");
+executa.command("register").description("Register a HARNESS AnnaApp(kind=executa) so `executa dev --storage real` (and agent / sampling / image / upload real-mode flows) can mint tokens for a local executa subprocess. Does NOT publish the executa itself — use `executa publish` for that. Lists/deletes via `apps list` / `apps delete`.").requiredOption("--tool-id <id>", "Executa tool_id (matches executa.json tool_id / executable_name)").option("--slug <slug>", "App slug (default: executa-<tool_id>; must be lowercase + hyphens)").option("--name <name>", "Human-readable display name (default: <tool_id>)").option("--account <host>", "Saved account host (default: current)").action(async (opts) => {
+	const { runExecutaRegister } = await import("./executa-register-BX29VfcD.js");
 	const code = await runExecutaRegister(opts);
 	process.exit(code);
 });
+executa.command("install").description("Install a local-dev shim for an Executa under its minted tool_id so the Agent can discover it via 'Rediscover Local' (for distribution_type: local). Resolves the tool_id from .anna/executa.json (written by `executa publish` / `apps push`) unless --tool-id is given.").option("--dir <path>", "Executa project dir (default: CWD)").option("--tool-id <id>", "Install the shim under this exact id (default: minted id from .anna/executa.json, else executa.json tool_id)").option("--bin-dir <path>", "Install dir for the shim (default: ~/.anna/executa/bin)").option("--force", "Overwrite an existing shim of the same name", false).option("--json", "Emit machine-readable JSON", false).action(async (opts) => {
+	const { runExecutaInstall } = await import("./executa-install-viq3kiV7.js");
+	const code = await runExecutaInstall({
+		dir: opts.dir,
+		toolId: opts.toolId,
+		binDir: opts.binDir,
+		force: opts.force,
+		json: opts.json
+	});
+	process.exit(code);
+});
 executa.command("dev").description("Run one Executa plugin in isolation (REPL or one-shot describe/invoke)").option("--dir <path>", "Executa project dir (default: CWD)").option("--spec <spec>", "Override discovery: comma-separated key=value (tool_id=...,type=...,command=\"...\")").option("--describe", "Print MANIFEST and exit", false).option("--health", "Print health and exit", false).option("--invoke <tool>", "Invoke one tool and exit").option("--args <json>", "JSON object passed as tool arguments", "{}").option("--json", "One-shot: emit compact JSON (no banners)", false).option("--no-sampling", "Hard-disable sampling reverse RPC (returns sampling_disabled)").option("--mock-sampling <fixture>", "Serve canned sampling responses from a JSONL fixture (offline)").option("--app-slug <slug>", "Forward sampling to nexus on behalf of this dev AnnaApp slug").option("--sampling-account <host>", "Saved account host for nexus sampling (default: current)").option("--no-agent", "Hard-disable agent reverse RPC (returns agent_not_granted)").option("--mock-agent <fixture>", "Serve canned agent/* responses from a JSONL fixture (offline)").option("--agent-account <host>", "Saved account host for nexus agent (default: --sampling-account or current)").option("--storage <mode>", "Storage backend: off | memory | mock | real (default: memory)").option("--mock-storage <fixture>", "Serve canned storage/* + files/* responses from a JSONL fixture").option("--storage-account <host>", "Saved account host for nexus storage (default: --sampling-account or current)").option("--storage-scopes <list>", "Comma-separated scopes for real storage tokens (default: user,app,tool)").option("--no-image", "Hard-disable image reverse RPC (returns image_not_granted)").option("--mock-image <fixture>", "Serve canned image/generate + image/edit responses from a JSONL fixture").option("--image-account <host>", "Saved account host for nexus image (default: --sampling-account or current)").option("--no-upload", "Hard-disable host/uploadFile reverse RPC (returns upload_not_granted)").option("--mock-upload <fixture>", "Serve canned host/uploadFile responses from a JSONL fixture").option("--upload-account <host>", "Saved account host for nexus uploads (default: --sampling-account or current)").action(async (opts) => {
-	const { runExecutaDev } = await import("./executa-dev-BvS9zTpO.js");
+	const { runExecutaDev } = await import("./executa-dev-DFp1ckAn.js");
 	const storageMode = opts.storage === void 0 ? void 0 : (() => {
 		const m = opts.storage;
 		if (m === "off" || m === "memory" || m === "mock" || m === "real") return m;
@@ -609,7 +625,7 @@ executa.command("dev").description("Run one Executa plugin in isolation (REPL or
 });
 const apps = program.command("apps").description("Anna App publish lifecycle commands");
 apps.command("list").description("List the Anna Apps you authored, with lifecycle status").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (opts) => {
-	const { runAppsList } = await import("./apps-BTn9EN0x.js");
+	const { runAppsList } = await import("./apps-B57i8xeb.js");
 	process.exit(await runAppsList({
 		account: opts.account,
 		json: opts.json
@@ -624,7 +640,7 @@ apps.command("publish").description("Publish or update an Anna App (manifest.jso
 		console.error(`✗ --bump must be patch|minor|major (got: ${opts.bump})`);
 		process.exit(2);
 	}
-	const { runAppsPublish } = await import("./apps-publish-DfZTOxBJ.js");
+	const { runAppsPublish } = await import("./apps-publish-D403z305.js");
 	process.exit(await runAppsPublish({
 		cwd: opts.cwd,
 		manifest: opts.manifest,
@@ -640,7 +656,7 @@ apps.command("publish").description("Publish or update an Anna App (manifest.jso
 		json: opts.json
 	}));
 });
-apps.command("push").description("Upsert the mutable working draft (manifest + bundle, no freeze)").option("--cwd <dir>", "Project root (default: cwd)").option("--manifest <path>", "manifest.json path", "manifest.json").option("--bump <kind>", "Bump version: patch|minor|major").option("--no-write", "Skip writing the bumped version back to disk", false).option("--dry-run", "Resolve identity + diff but don't upsert", false).option("--executa-id <handle=id>", "Override a bundled executa handle with a real tool_id (repeatable)", (val, prev) => [...prev, val], []).option("--skip-executa-publish", "Use cached/overridden tool_ids; don't recursively register bundled executas", false).option("--no-bundled-executas", "Disable bundled-executa orchestration (legacy behaviour)").option("--no-bundle", "Skip working UI bundle upload even if the manifest declares a UI").option("--bundle-dir <dir>", "UI bundle directory (default: <cwd>/bundle)").option("--if-match <revision>", "Optimistic-lock: require this working revision").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (opts) => {
+apps.command("push").description("Upsert the mutable working draft (manifest + bundle, no freeze)").option("--cwd <dir>", "Project root (default: cwd)").option("--manifest <path>", "manifest.json path", "manifest.json").option("--bump <kind>", "Bump version: patch|minor|major").option("--no-write", "Skip writing the bumped version back to disk", false).option("--dry-run", "Resolve identity + diff but don't upsert", false).option("--executa-id <handle=id>", "Override a bundled executa handle with a real tool_id (repeatable)", (val, prev) => [...prev, val], []).option("--skip-executa-publish", "Use cached/overridden tool_ids; don't recursively register bundled executas", false).option("--no-bundled-executas", "Disable bundled-executa orchestration (legacy behaviour)").option("--no-bundle", "Skip working UI bundle upload even if the manifest declares a UI").option("--bundle-dir <dir>", "UI bundle directory (default: <cwd>/bundle)").option("--no-install-local", "Don't install local-dev shims for bundled `local` executas (skip Rediscover-Local prep)").option("--if-match <revision>", "Optimistic-lock: require this working revision").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (opts) => {
 	if (opts.bump && ![
 		"patch",
 		"minor",
@@ -657,7 +673,7 @@ apps.command("push").description("Upsert the mutable working draft (manifest + b
 			process.exit(2);
 		}
 	}
-	const { runAppsPush } = await import("./apps-push-B9XT2uwF.js");
+	const { runAppsPush } = await import("./apps-push-x5reIQHx.js");
 	process.exit(await runAppsPush({
 		cwd: opts.cwd,
 		manifest: opts.manifest,
@@ -669,13 +685,14 @@ apps.command("push").description("Upsert the mutable working draft (manifest + b
 		noBundledExecutas: opts.bundledExecutas === false,
 		noBundle: opts.bundle === false,
 		bundleDir: opts.bundleDir,
+		noInstallLocal: opts.installLocal === false,
 		ifMatch,
 		account: opts.account,
 		json: opts.json
 	}));
 });
 apps.command("cut <version>").description("Snapshot the working draft into an immutable version (freeze deps)").option("--changelog <text>", "Override the working draft changelog for this version").option("--slug <slug>", "App slug (default: resolve from .anna/app.json cache)").option("--cwd <dir>", "Project root for identity cache (default: cwd)").option("--dry-run", "Resolve target but don't cut", false).option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (version, opts) => {
-	const { runAppsCut } = await import("./apps-cut-DtEkddIk.js");
+	const { runAppsCut } = await import("./apps-cut-BG6Ib3x4.js");
 	process.exit(await runAppsCut({
 		version,
 		changelog: opts.changelog,
@@ -687,7 +704,7 @@ apps.command("cut <version>").description("Snapshot the working draft into an im
 	}));
 });
 apps.command("discard").description("Drop the mutable working draft (leaves cut versions intact)").option("--slug <slug>", "App slug (default: resolve from .anna/app.json cache)").option("--cwd <dir>", "Project root for identity cache (default: cwd)").option("--dry-run", "Resolve target but don't discard", false).option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (opts) => {
-	const { runAppsDiscard } = await import("./apps-discard-y3_IwcbQ.js");
+	const { runAppsDiscard } = await import("./apps-discard-BveXHAgF.js");
 	process.exit(await runAppsDiscard({
 		slug: opts.slug,
 		cwd: opts.cwd,
@@ -697,7 +714,7 @@ apps.command("discard").description("Drop the mutable working draft (leaves cut
 	}));
 });
 apps.command("release <version>").description("Freeze & publish an existing remote version (go live)").option("--slug <slug>", "App slug (default: resolve from .anna/app.json cache)").option("--cwd <dir>", "Project root for identity cache (default: cwd)").option("--allow-create", "If the version isn't on the server, run 'apps publish' first, then release", false).option("--dry-run", "Resolve target + pre-flight but don't publish", false).option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (version, opts) => {
-	const { runAppsRelease } = await import("./apps-release-BLH9XSxB.js");
+	const { runAppsRelease } = await import("./apps-release-ByIgz6lx.js");
 	process.exit(await runAppsRelease({
 		version,
 		slug: opts.slug,
@@ -709,7 +726,7 @@ apps.command("release <version>").description("Freeze & publish an existing remo
 	}));
 });
 apps.command("sync-meta").description("Push mutable store metadata (name/tagline/…) from the manifest").option("--cwd <dir>", "Project root (default: cwd)").option("--manifest <path>", "manifest.json path", "manifest.json").option("--dry-run", "Print the metadata diff but don't PATCH", false).option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (opts) => {
-	const { runAppsSyncMeta } = await import("./apps-sync-meta-D9eKMMUp.js");
+	const { runAppsSyncMeta } = await import("./apps-sync-meta-CTHwGlzI.js");
 	process.exit(await runAppsSyncMeta({
 		cwd: opts.cwd,
 		manifest: opts.manifest,
@@ -719,7 +736,7 @@ apps.command("sync-meta").description("Push mutable store metadata (name/tagline
 	}));
 });
 apps.command("submit-review [slug]").description("Move an app into review (DRAFT/REJECTED → PENDING_REVIEW)").option("--cwd <dir>", "Project root for identity cache (default: cwd)").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (slug, opts) => {
-	const { runAppsSubmitReview } = await import("./apps-submit-review-DLwCxeAs.js");
+	const { runAppsSubmitReview } = await import("./apps-submit-review-D-cPtZtc.js");
 	process.exit(await runAppsSubmitReview({
 		slug,
 		cwd: opts.cwd,
@@ -728,7 +745,7 @@ apps.command("submit-review [slug]").description("Move an app into review (DRAFT
 	}));
 });
 apps.command("status <slug>").description("Show server-known state for one Anna App").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (slug, opts) => {
-	const { runAppsStatus } = await import("./apps-status-DQ9RvlME.js");
+	const { runAppsStatus } = await import("./apps-status-BYo97Nh5.js");
 	process.exit(await runAppsStatus({
 		slug,
 		account: opts.account,
@@ -736,7 +753,7 @@ apps.command("status <slug>").description("Show server-known state for one Anna
 	}));
 });
 apps.command("versions <slug>").description("List all server versions of one Anna App").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (slug, opts) => {
-	const { runAppsVersions } = await import("./apps-versions-2Tmk0nsx.js");
+	const { runAppsVersions } = await import("./apps-versions-Ca-AAMLL.js");
 	process.exit(await runAppsVersions({
 		slug,
 		account: opts.account,
@@ -744,7 +761,7 @@ apps.command("versions <slug>").description("List all server versions of one Ann
 	}));
 });
 apps.command("grants <slug>").description("Show currently granted scopes/quota for one Anna App").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (slug, opts) => {
-	const { runAppsGrants } = await import("./apps-grants-BGWlpee0.js");
+	const { runAppsGrants } = await import("./apps-grants-D3i6GxX_.js");
 	process.exit(await runAppsGrants({
 		slug,
 		account: opts.account,
@@ -752,7 +769,7 @@ apps.command("grants <slug>").description("Show currently granted scopes/quota f
 	}));
 });
 apps.command("unpublish <slug>").description("Flip a PUBLISHED app back to APPROVED (private)").option("--yes", "Acknowledge the destructive operation", false).option("--confirm <slug>", "Slug confirmation (must match target)").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (slug, opts) => {
-	const { runAppsUnpublish } = await import("./apps-destructive-DSTrcFUP.js");
+	const { runAppsUnpublish } = await import("./apps-destructive-DQIFqYE2.js");
 	process.exit(await runAppsUnpublish({
 		slug,
 		yes: opts.yes,
@@ -762,7 +779,7 @@ apps.command("unpublish <slug>").description("Flip a PUBLISHED app back to APPRO
 	}));
 });
 apps.command("archive <slug>").description("Archive an Anna App (hides it from end users)").option("--yes", "Acknowledge the destructive operation", false).option("--confirm <slug>", "Slug confirmation (must match target)").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (slug, opts) => {
-	const { runAppsArchive } = await import("./apps-destructive-DSTrcFUP.js");
+	const { runAppsArchive } = await import("./apps-destructive-DQIFqYE2.js");
 	process.exit(await runAppsArchive({
 		slug,
 		yes: opts.yes,
@@ -772,7 +789,7 @@ apps.command("archive <slug>").description("Archive an Anna App (hides it from e
 	}));
 });
 apps.command("unarchive <slug>").description("Restore an archived Anna App back to APPROVED").option("--yes", "Acknowledge the operation", false).option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (slug, opts) => {
-	const { runAppsUnarchive } = await import("./apps-destructive-DSTrcFUP.js");
+	const { runAppsUnarchive } = await import("./apps-destructive-DQIFqYE2.js");
 	process.exit(await runAppsUnarchive({
 		slug,
 		yes: opts.yes,
@@ -781,7 +798,7 @@ apps.command("unarchive <slug>").description("Restore an archived Anna App back
 	}));
 });
 apps.command("delete <slug>").description("Hard-delete an Anna App (refused by server if installs exist)").option("--yes", "Acknowledge the destructive operation", false).option("--confirm <slug>", "Slug confirmation (must match target)").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (slug, opts) => {
-	const { runAppsDelete } = await import("./apps-destructive-DSTrcFUP.js");
+	const { runAppsDelete } = await import("./apps-destructive-DQIFqYE2.js");
 	process.exit(await runAppsDelete({
 		slug,
 		yes: opts.yes,
@@ -791,14 +808,14 @@ apps.command("delete <slug>").description("Hard-delete an Anna App (refused by s
 	}));
 });
 executa.command("list").description("List Executas owned by the current PAT").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (opts) => {
-	const { runExecutaList } = await import("./executa-reads-CQ6S8gHY.js");
+	const { runExecutaList } = await import("./executa-reads-cd-8ZRjI.js");
 	process.exit(await runExecutaList({
 		account: opts.account,
 		json: opts.json
 	}));
 });
 executa.command("status <ref>").description("Show server-known state for one Executa (slug or tool_id)").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (ref, opts) => {
-	const { runExecutaStatus } = await import("./executa-reads-CQ6S8gHY.js");
+	const { runExecutaStatus } = await import("./executa-reads-cd-8ZRjI.js");
 	process.exit(await runExecutaStatus({
 		ref,
 		account: opts.account,
@@ -806,7 +823,7 @@ executa.command("status <ref>").description("Show server-known state for one Exe
 	}));
 });
 executa.command("versions <ref>").description("List immutable version snapshots for one Executa").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (ref, opts) => {
-	const { runExecutaVersions } = await import("./executa-reads-CQ6S8gHY.js");
+	const { runExecutaVersions } = await import("./executa-reads-cd-8ZRjI.js");
 	process.exit(await runExecutaVersions({
 		ref,
 		account: opts.account,
@@ -822,7 +839,7 @@ executa.command("publish").description("Mint or update an Executa (executa.json
 		console.error(`✗ --bump must be patch|minor|major (got: ${opts.bump})`);
 		process.exit(2);
 	}
-	const { runExecutaPublish } = await import("./executa-publish-B88_9gbp.js");
+	const { runExecutaPublish } = await import("./executa-publish-DaYvxbbW.js");
 	process.exit(await runExecutaPublish({
 		cwd: opts.cwd,
 		manifest: opts.manifest,
@@ -835,7 +852,7 @@ executa.command("publish").description("Mint or update an Executa (executa.json
 	}));
 });
 executa.command("unpublish <slug>").description("Flip an Executa's visibility back to private").option("--yes", "Acknowledge the destructive operation", false).option("--confirm <slug>", "Slug confirmation (must match target)").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (slug, opts) => {
-	const { runExecutaUnpublish } = await import("./executa-destructive-COQE4Xqi.js");
+	const { runExecutaUnpublish } = await import("./executa-destructive-Dpo58lxI.js");
 	process.exit(await runExecutaUnpublish({
 		slug,
 		yes: opts.yes,
@@ -845,7 +862,7 @@ executa.command("unpublish <slug>").description("Flip an Executa's visibility ba
 	}));
 });
 executa.command("yank <ref>").description("Hard-delete one Executa version (<slug>@<version>)").option("--yes", "Acknowledge the destructive operation", false).option("--confirm <slug>", "Slug confirmation (must match target)").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (ref, opts) => {
-	const { runExecutaYank } = await import("./executa-destructive-COQE4Xqi.js");
+	const { runExecutaYank } = await import("./executa-destructive-Dpo58lxI.js");
 	process.exit(await runExecutaYank({
 		ref,
 		yes: opts.yes,
@@ -855,7 +872,7 @@ executa.command("yank <ref>").description("Hard-delete one Executa version (<slu
 	}));
 });
 executa.command("delete <slug>").description("Hard-delete an Executa").option("--yes", "Acknowledge the destructive operation", false).option("--confirm <slug>", "Slug confirmation (must match target)").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (slug, opts) => {
-	const { runExecutaDelete } = await import("./executa-destructive-COQE4Xqi.js");
+	const { runExecutaDelete } = await import("./executa-destructive-Dpo58lxI.js");
 	process.exit(await runExecutaDelete({
 		slug,
 		yes: opts.yes,
@@ -880,7 +897,7 @@ executa.command("cache-clear").description("Delete the local `.anna/executa.json
 });
 const token = program.command("token").description("Manage developer PATs (list / revoke / scopes)");
 token.command("list").description("List the caller's PATs (most-recent first)").option("--include-revoked", "Also show revoked PATs", false).option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (opts) => {
-	const { runTokenList } = await import("./token-B9JUPelx.js");
+	const { runTokenList } = await import("./token-BGjbb2aU.js");
 	process.exit(await runTokenList({
 		includeRevoked: opts.includeRevoked,
 		account: opts.account,
@@ -893,7 +910,7 @@ token.command("revoke <id>").description("Revoke one of the caller's PATs by id"
 		console.error(`✗ token id must be a positive integer (got: ${id})`);
 		process.exit(2);
 	}
-	const { runTokenRevoke } = await import("./token-B9JUPelx.js");
+	const { runTokenRevoke } = await import("./token-BGjbb2aU.js");
 	process.exit(await runTokenRevoke({
 		id: idNum,
 		account: opts.account,
@@ -901,7 +918,7 @@ token.command("revoke <id>").description("Revoke one of the caller's PATs by id"
 	}));
 });
 token.command("scopes").description("Print the available PAT scope catalogue").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (opts) => {
-	const { runTokenScopes } = await import("./token-B9JUPelx.js");
+	const { runTokenScopes } = await import("./token-BGjbb2aU.js");
 	process.exit(await runTokenScopes({
 		account: opts.account,
 		json: opts.json
@@ -916,7 +933,7 @@ program.command("publish").description("Auto-detect cwd and publish (apps publis
 		console.error(`✗ --bump must be patch|minor|major (got: ${opts.bump})`);
 		process.exit(2);
 	}
-	const { runTopLevelPublish } = await import("./publish-C1wcf-qI.js");
+	const { runTopLevelPublish } = await import("./publish-R3JAl9Hm.js");
 	process.exit(await runTopLevelPublish({
 		cwd: opts.cwd,
 		bump: opts.bump,