@anna-ai/cli 0.1.14 → 0.1.17

package/dist/{apps-BEJUn9Ws.js → apps-ClgEOdKD.js}

@@ -1,5 +1,5 @@
 import { getAccount } from "./credentials-BTv2IfUZ.js";
-import { listDevApps } from "./dev-app-cache-C3D1Sp_V.js";
+import { listDevApps } from "./dev-app-cache-3Pfesngr.js";
 import { bold, cyan, dim, green, red, yellow } from "kleur/colors";
 
 //#region src/commands/apps.ts

package/dist/bridge-B1vq1oG3.js

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

package/dist/{bridge-D6YyP9DM.js → bridge-Dffh9JUd.js}

@@ -9,17 +9,39 @@ 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.0a2";
+const PINNED_RUNTIME_VERSION = "0.2.0a4";
+/**
+* Throwable from a {@link RequestHandler} to send a structured JSON-RPC
+* error back to the python bridge with a stable string ``code`` (e.g.
+* ``"llm_disabled"``, ``"provider_error"``). The python side decodes the
+* code from ``error.data.errorCode``.
+*/
+var BridgeRequestError = class extends Error {
+	constructor(code, message, details) {
+		super(message);
+		this.code = code;
+		this.details = details;
+	}
+};
 var PythonBridge = class {
 	proc = null;
 	nextId = 1;
 	pending = new Map();
+	requestHandlers = new Map();
 	readyPromise = null;
 	closed = false;
 	constructor(opts) {
 		this.opts = opts;
 	}
 	/**
+	* Register a handler for an outbound python→node RPC method (e.g.
+	* ``host.llm.complete``). Subsequent registrations for the same method
+	* replace the previous handler.
+	*/
+	onRequest(method, handler) {
+		this.requestHandlers.set(method, handler);
+	}
+	/**
 	* Build the default launch command from `opts.mode`. uvx by default; for
 	* `nexus-source` mode, `matrixNexusRoot` must be set.
 	*/
@@ -93,6 +115,10 @@ var PythonBridge = class {
 					resolve$1();
 					return;
 				}
+				if (typeof env$1.method === "string") {
+					this.handleIncomingRequest(env$1);
+					return;
+				}
 				this.handleResponse(env$1);
 			});
 			this.proc.on("error", (e) => reject(e));
@@ -102,6 +128,58 @@ var PythonBridge = class {
 		});
 		await this.readyPromise;
 	}
+	async handleIncomingRequest(env) {
+		const method = env.method;
+		const id = env.id;
+		if (id == null) return;
+		const params = env.params ?? {};
+		const handler = this.requestHandlers.get(method);
+		if (!handler) {
+			this.writeFrame({
+				jsonrpc: "2.0",
+				id,
+				error: {
+					code: -32601,
+					message: `method not found: ${method}`
+				}
+			});
+			return;
+		}
+		try {
+			const result = await handler(params);
+			this.writeFrame({
+				jsonrpc: "2.0",
+				id,
+				result: result ?? {}
+			});
+		} catch (e) {
+			if (e instanceof BridgeRequestError) this.writeFrame({
+				jsonrpc: "2.0",
+				id,
+				error: {
+					code: -32e3,
+					message: e.message,
+					data: {
+						errorCode: e.code,
+						...e.details ?? {}
+					}
+				}
+			});
+			else this.writeFrame({
+				jsonrpc: "2.0",
+				id,
+				error: {
+					code: -32603,
+					message: e.message,
+					data: { errorCode: "internal_error" }
+				}
+			});
+		}
+	}
+	writeFrame(env) {
+		if (!this.proc) return;
+		this.proc.stdin.write(`${JSON.stringify(env)}\n`);
+	}
 	handleResponse(env) {
 		const id = env.id;
 		if (id == null) return;
@@ -143,4 +221,4 @@ var PythonBridge = class {
 };
 
 //#endregion
-export { PINNED_RUNTIME_VERSION, PythonBridge };
+export { BridgeRequestError, PINNED_RUNTIME_VERSION, PythonBridge };

package/dist/cli.js

@@ -450,8 +450,8 @@ program.command("validate").description("Run schema + ACL checks on a manifest+b
 	const code = printResult(result);
 	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)").action(async (opts) => {
-	const { runDev, parseExecutaSpec } = await import("./dev-C81H9c9_.js");
+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-Bi6rkb1x.js");
 	const cwd = opts.cwd ?? process.cwd();
 	let executas;
 	if (opts.executa && opts.executa.length > 0) {
@@ -479,7 +479,8 @@ program.command("dev").description("Run a local harness (in-process dispatcher +
 		noLlm: opts.llm === false,
 		mockLlm: opts.mockLlm,
 		llmAccount: opts.llmAccount,
-		llmAppSlug: opts.llmAppSlug
+		llmAppSlug: opts.llmAppSlug,
+		storageMode: opts.storage
 	});
 	process.exit(code);
 });
@@ -509,7 +510,7 @@ 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-B3u0edUg.js");
+	const { runDoctor } = await import("./doctor-Dxkx0eqv.js");
 	const code = await runDoctor({ matrixNexusRoot: opts.matrixNexusRoot });
 	process.exit(code);
 });
@@ -535,7 +536,7 @@ program.command("whoami").description("Show the current account (and any others)
 	process.exit(code);
 });
 program.command("apps:list").description("List dev apps installed for the current PAT").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (opts) => {
-	const { runAppsList } = await import("./apps-BEJUn9Ws.js");
+	const { runAppsList } = await import("./apps-ClgEOdKD.js");
 	const code = await runAppsList({
 		account: opts.account,
 		json: opts.json
@@ -569,8 +570,8 @@ executa.command("register").description("Register a standalone executa with nexu
 	const code = await runExecutaRegister(opts);
 	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)").action(async (opts) => {
-	const { runExecutaDev } = await import("./executa-dev-BhouP8jh.js");
+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-BzhSd_A2.js");
 	const storageMode = opts.storage === void 0 ? void 0 : (() => {
 		const m = opts.storage;
 		if (m === "off" || m === "memory" || m === "mock" || m === "real") return m;
@@ -595,7 +596,13 @@ executa.command("dev").description("Run one Executa plugin in isolation (REPL or
 		storage: storageMode,
 		mockStorage: opts.mockStorage,
 		storageAccount: opts.storageAccount,
-		storageScopes: opts.storageScopes
+		storageScopes: opts.storageScopes,
+		noImage: opts.image === false,
+		mockImage: opts.mockImage,
+		imageAccount: opts.imageAccount,
+		noUpload: opts.upload === false,
+		mockUpload: opts.mockUpload,
+		uploadAccount: opts.uploadAccount
 	});
 	process.exit(code);
 });

package/dist/{dev-BfLGxpiT.js → dev-BUetXnfG.js}

@@ -31,8 +31,20 @@ async function runDev(opts) {
 	}
 	const matrixNexusRoot = await resolveMatrixNexusRoot(opts.matrixNexusRoot, cwd);
 	const mode = matrixNexusRoot ? "nexus-source" : "uvx";
-	const { PythonBridge, PINNED_RUNTIME_VERSION } = await import("./bridge-C0DWb5eQ.js");
-	const { HarnessServer } = await import("./server-q6nKCeEV.js");
+	const storageMode = opts.storageMode === "aps" ? "aps" : "legacy";
+	if (opts.storageMode && opts.storageMode !== "legacy" && opts.storageMode !== "aps") {
+		console.error(red(`✗ --storage must be "legacy" or "aps", got "${opts.storageMode}"`));
+		return 2;
+	}
+	if (storageMode === "aps") {
+		if (opts.noLlm || opts.mockLlm) {
+			console.error(red("✗ --storage aps requires a real LLM bridge (PAT on disk); drop --no-llm / --mock-llm or switch back to --storage legacy."));
+			return 2;
+		}
+		process.env.ANNA_APP_RUNTIME_STORAGE_MODE = "aps";
+	}
+	const { PythonBridge, PINNED_RUNTIME_VERSION } = await import("./bridge-B1vq1oG3.js");
+	const { HarnessServer } = await import("./server-6WHNkydc.js");
 	const bridge = new PythonBridge({
 		mode,
 		matrixNexusRoot: matrixNexusRoot ?? void 0,
@@ -75,7 +87,9 @@ async function runDev(opts) {
 		manifest
 	});
 	if (llm === null) return 2;
+	llm.storageMode = storageMode;
 	console.log(`  llm bridge        ${dim(llm.mode === "off" ? "disabled (--no-llm)" : llm.mode === "mock" ? `mock (${opts.mockLlm})` : `real${opts.llmAccount ? ` [${opts.llmAccount}]` : ""} → app_slug=${llm.appSlug}`)}`);
+	console.log(`  storage backend   ${dim(storageMode === "aps" ? "aps (real nexus APS via /api/v1/storage/*)" : "legacy (in-memory runtime_state)")}`);
 	const server = new HarnessServer({
 		slug,
 		manifest,
@@ -123,7 +137,7 @@ async function runDev(opts) {
 */
 async function resolveRealLlm(args) {
 	const { getAccount } = await import("./credentials-DDqx6XMQ.js");
-	const { ensureDevAppRegistered } = await import("./dev-app-cache-CZ8lIKiw.js");
+	const { ensureDevAppRegistered } = await import("./dev-app-cache-CZ1UjMz0.js");
 	const acc = getAccount(args.account);
 	if (!acc) {
 		console.error(red("✗ no developer PAT on disk — run `anna-app login --host <nexus-url>` first.\n  (or use `--no-llm` / `--mock-llm <fixture>` to develop offline.)"));
@@ -134,22 +148,35 @@ async function resolveRealLlm(args) {
 		return null;
 	}
 	const manifest = args.manifest;
+	const registerInput = {
+		slug: args.appSlug,
+		name: manifest.name,
+		category: manifest.category,
+		tagline: manifest.tagline
+	};
 	try {
 		const entry = await ensureDevAppRegistered({
 			cwd: args.cwd,
 			host: acc.host,
 			pat: acc.pat,
-			input: {
-				slug: args.appSlug,
-				name: manifest.name,
-				category: manifest.category,
-				tagline: manifest.tagline
-			}
+			input: registerInput
 		});
 		return {
 			mode: "real",
 			account: args.account,
-			appSlug: entry.slug
+			appSlug: entry.slug,
+			onAppSlugNotFound: async () => {
+				const { invalidateDevAppCache } = await import("./dev-app-cache-CZ1UjMz0.js");
+				invalidateDevAppCache(args.cwd);
+				const fresh = getAccount(args.account);
+				if (!fresh) throw new Error("PAT not found while re-registering dev app — run `anna-app login` again");
+				await ensureDevAppRegistered({
+					cwd: args.cwd,
+					host: fresh.host,
+					pat: fresh.pat,
+					input: registerInput
+				});
+			}
 		};
 	} catch (e) {
 		console.error(red(`✗ failed to register dev app on nexus: ${e.message}`));

package/dist/dev-Bi6rkb1x.js

@@ -0,0 +1,3 @@
+import { parseExecutaSpec, runDev } from "./dev-BUetXnfG.js";
+
+export { parseExecutaSpec, runDev };

package/dist/dev-app-cache-3Pfesngr.js

@@ -0,0 +1,189 @@
+import { canonicalHost } from "./credentials-BTv2IfUZ.js";
+import { dirname, join, resolve } from "node:path";
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+
+//#region src/dev-app-cache.ts
+const CACHE_DIR = ".anna";
+const CACHE_FILE = "dev-app.json";
+function cachePath(cwd) {
+	return resolve(cwd, CACHE_DIR, CACHE_FILE);
+}
+function readDevAppCache(cwd) {
+	const p = cachePath(cwd);
+	if (!existsSync(p)) return null;
+	try {
+		const raw = JSON.parse(readFileSync(p, "utf-8"));
+		if (typeof raw.host === "string" && typeof raw.slug === "string" && typeof raw.app_id === "number") return {
+			host: raw.host,
+			slug: raw.slug,
+			app_id: raw.app_id,
+			name: raw.name ?? raw.slug,
+			registered_at: raw.registered_at ?? ""
+		};
+	} catch {}
+	return null;
+}
+function writeDevAppCache(cwd, entry) {
+	const p = cachePath(cwd);
+	mkdirSync(dirname(p), { recursive: true });
+	writeFileSync(p, JSON.stringify(entry, null, 2) + "\n", "utf-8");
+}
+/** Delete the local dev-app cache file.
+*
+*  Used by the LLM bridge's recovery flow: when `/dev/session/mint`
+*  returns 404 with "app slug ... not found", the cache is stale (the
+*  nexus DB no longer has the row this cache asserts is registered).
+*  Invalidating forces the next `ensureDevAppRegistered` call to
+*  re-POST `/dev/apps/register`. Idempotent: a missing file is a no-op.
+*/
+function invalidateDevAppCache(cwd) {
+	const p = cachePath(cwd);
+	if (existsSync(p)) try {
+		unlinkSync(p);
+	} catch {}
+}
+/** Call POST /api/v1/anna-apps/dev/apps/register. Idempotent server-side. */
+async function registerDevApp(args) {
+	const url = `${canonicalHost(args.host)}/api/v1/anna-apps/dev/apps/register`;
+	const res = await fetch(url, {
+		method: "POST",
+		headers: { "content-type": "application/json" },
+		body: JSON.stringify({
+			pat: args.pat,
+			slug: args.input.slug,
+			name: args.input.name,
+			category: args.input.category,
+			tagline: args.input.tagline
+		})
+	});
+	if (!res.ok) {
+		const text = await res.text().catch(() => "");
+		throw new Error(`/dev/apps/register failed: HTTP ${res.status} ${text}`);
+	}
+	return await res.json();
+}
+/** Call GET /api/v1/anna-apps/dev/apps. */
+async function listDevApps(args) {
+	const url = new URL(`${canonicalHost(args.host)}/api/v1/anna-apps/dev/apps`);
+	url.searchParams.set("pat", args.pat);
+	const res = await fetch(url, { method: "GET" });
+	if (!res.ok) {
+		const text = await res.text().catch(() => "");
+		throw new Error(`/dev/apps failed: HTTP ${res.status} ${text}`);
+	}
+	const body = await res.json();
+	return body.apps;
+}
+/**
+* Convenience helper for `anna-app dev`: returns a valid cached entry if
+* it still matches the manifest slug, otherwise hits the server to
+* (re-)register. Throws if no PAT is available on disk.
+*/
+async function ensureDevAppRegistered(args) {
+	const canonical = canonicalHost(args.host);
+	const cached = readDevAppCache(args.cwd);
+	if (cached && cached.host === canonical && cached.slug === args.input.slug) return cached;
+	const r = await registerDevApp({
+		host: args.host,
+		pat: args.pat,
+		input: args.input
+	});
+	const entry = {
+		host: canonical,
+		slug: r.slug,
+		app_id: r.app_id,
+		name: r.name,
+		registered_at: new Date().toISOString()
+	};
+	writeDevAppCache(args.cwd, entry);
+	return entry;
+}
+const _internal = {
+	cachePath,
+	CACHE_DIR: join(CACHE_DIR, CACHE_FILE)
+};
+const EXECUTA_CACHE_FILE = "dev-executa.json";
+/**
+* Bump this whenever the server-side dev-executa grant shape changes in
+* a way that requires a re-register to pick up. Cached entries written
+* with a lower `cache_version` are treated as stale and re-POSTed.
+*
+*   1 — initial (llm_grant only)
+*   2 — adds image_grant + upload_grant; fixes `allowedPurposes` to
+*       protocol whitelist {image_input,image_reference,user_artifact}
+*/
+const EXECUTA_CACHE_VERSION = 2;
+function executaCachePath(cwd) {
+	return resolve(cwd, CACHE_DIR, EXECUTA_CACHE_FILE);
+}
+function readDevExecutaCache(cwd) {
+	const p = executaCachePath(cwd);
+	if (!existsSync(p)) return null;
+	try {
+		const raw = JSON.parse(readFileSync(p, "utf-8"));
+		if (typeof raw.host === "string" && typeof raw.slug === "string" && typeof raw.app_id === "number" && typeof raw.tool_id === "string") return {
+			host: raw.host,
+			slug: raw.slug,
+			app_id: raw.app_id,
+			tool_id: raw.tool_id,
+			name: raw.name ?? raw.tool_id,
+			registered_at: raw.registered_at ?? "",
+			cache_version: typeof raw.cache_version === "number" ? raw.cache_version : 0
+		};
+	} catch {}
+	return null;
+}
+function writeDevExecutaCache(cwd, entry) {
+	const p = executaCachePath(cwd);
+	mkdirSync(dirname(p), { recursive: true });
+	writeFileSync(p, JSON.stringify(entry, null, 2) + "\n", "utf-8");
+}
+/** Call `POST /api/v1/anna-apps/dev/executas/register`. Idempotent. */
+async function registerDevExecuta(args) {
+	const url = `${canonicalHost(args.host)}/api/v1/anna-apps/dev/executas/register`;
+	const res = await fetch(url, {
+		method: "POST",
+		headers: { "content-type": "application/json" },
+		body: JSON.stringify({
+			pat: args.pat,
+			tool_id: args.toolId,
+			slug: args.slug,
+			name: args.name
+		})
+	});
+	if (!res.ok) {
+		const text = await res.text().catch(() => "");
+		throw new Error(`/dev/executas/register failed: HTTP ${res.status} ${text}`);
+	}
+	return await res.json();
+}
+/**
+* Convenience: return a cached executa registration if still valid for
+* this host+tool_id, otherwise hit the server. Throws if no PAT.
+*/
+async function ensureDevExecutaRegistered(args) {
+	const canonical = canonicalHost(args.host);
+	const cached = readDevExecutaCache(args.cwd);
+	if (cached && cached.host === canonical && cached.tool_id === args.toolId && cached.cache_version >= EXECUTA_CACHE_VERSION && (!args.slug || cached.slug === args.slug)) return cached;
+	const r = await registerDevExecuta({
+		host: args.host,
+		pat: args.pat,
+		toolId: args.toolId,
+		slug: args.slug,
+		name: args.name
+	});
+	const entry = {
+		host: canonical,
+		slug: r.slug,
+		app_id: r.app_id,
+		tool_id: r.tool_id,
+		name: r.name,
+		registered_at: new Date().toISOString(),
+		cache_version: EXECUTA_CACHE_VERSION
+	};
+	writeDevExecutaCache(args.cwd, entry);
+	return entry;
+}
+
+//#endregion
+export { ensureDevAppRegistered, ensureDevExecutaRegistered, invalidateDevAppCache, listDevApps, readDevAppCache, readDevExecutaCache, registerDevApp, registerDevExecuta, writeDevAppCache, writeDevExecutaCache };

package/dist/dev-app-cache-CZ1UjMz0.js

@@ -0,0 +1,4 @@
+import "./credentials-BTv2IfUZ.js";
+import { ensureDevAppRegistered, ensureDevExecutaRegistered, invalidateDevAppCache, listDevApps, readDevAppCache, readDevExecutaCache, registerDevApp, registerDevExecuta, writeDevAppCache, writeDevExecutaCache } from "./dev-app-cache-3Pfesngr.js";
+
+export { ensureDevAppRegistered, ensureDevExecutaRegistered, invalidateDevAppCache };

package/dist/{doctor-B3u0edUg.js → doctor-Dxkx0eqv.js}

@@ -1,4 +1,4 @@
-import { PINNED_RUNTIME_VERSION } from "./bridge-D6YyP9DM.js";
+import { PINNED_RUNTIME_VERSION } from "./bridge-Dffh9JUd.js";
 import { dirname, isAbsolute, resolve } from "node:path";
 import { existsSync, statSync } from "node:fs";
 import { spawnSync } from "node:child_process";

package/dist/{executa-dev-BhouP8jh.js → executa-dev-BzhSd_A2.js}

@@ -1,4 +1,4 @@
-import { parseExecutaSpec } from "./dev-BfLGxpiT.js";
+import { parseExecutaSpec } from "./dev-BUetXnfG.js";
 import { isAbsolute, resolve } from "node:path";
 import { existsSync } from "node:fs";
 import { bold, cyan, dim, green, red, yellow } from "kleur/colors";
@@ -33,54 +33,101 @@ async function runExecutaDev(opts) {
 	}
 	const oneShot = !!(opts.describe || opts.health || opts.invoke);
 	const quiet = oneShot && (opts.json ?? false);
-	const { SamplingBridge } = await import("./sampling-3EfSlDHM.js");
+	const { getAccount } = await import("./credentials-DDqx6XMQ.js");
+	const { ensureDevExecutaRegistered } = await import("./dev-app-cache-CZ1UjMz0.js");
+	const needsRealMint = !opts.noSampling && !opts.mockSampling || !opts.noAgent && !opts.mockAgent || !opts.noImage && !opts.mockImage || !opts.noUpload && !opts.mockUpload || opts.storage === "real";
+	let effectiveAppSlug = opts.appSlug;
+	let autoRegistered = false;
+	if (!effectiveAppSlug && needsRealMint) {
+		const acc = getAccount(opts.samplingAccount);
+		if (acc) try {
+			const reg = await ensureDevExecutaRegistered({
+				cwd: parsed.project_dir,
+				host: acc.host,
+				pat: acc.pat,
+				toolId: parsed.tool_id
+			});
+			effectiveAppSlug = reg.slug;
+			autoRegistered = true;
+		} catch (e) {
+			if (!quiet) {
+				console.warn(yellow(`! executa auto-register failed: ${e.message}`));
+				console.warn(yellow("  reverse-RPC bridges (sampling/agent/image/upload) will run in disabled mode. Pass `--app-slug <slug>` to override, or `--no-sampling --no-agent --no-image --no-upload` to silence."));
+			}
+		}
+	}
+	const { SamplingBridge } = await import("./sampling-CJUDG-mf.js");
 	const sampling = opts.noSampling ? new SamplingBridge({ mode: "off" }) : opts.mockSampling ? new SamplingBridge({
 		mode: "mock",
 		mockFile: opts.mockSampling
-	}) : opts.appSlug ? new SamplingBridge({
+	}) : effectiveAppSlug ? new SamplingBridge({
 		mode: "real",
 		account: opts.samplingAccount,
-		appSlug: opts.appSlug
+		appSlug: effectiveAppSlug
 	}) : new SamplingBridge({ mode: "off" });
 	const { AgentBridge } = await import("./agent-DUmINbo4.js");
 	const agent = opts.noAgent ? new AgentBridge({ mode: "off" }) : opts.mockAgent ? new AgentBridge({
 		mode: "mock",
 		mockFile: opts.mockAgent
-	}) : opts.appSlug ? new AgentBridge({
+	}) : effectiveAppSlug ? new AgentBridge({
 		mode: "real",
 		account: opts.agentAccount ?? opts.samplingAccount,
-		appSlug: opts.appSlug
+		appSlug: effectiveAppSlug
 	}) : new AgentBridge({ mode: "off" });
-	const { StorageBridge } = await import("./storage-CnWTZqq_.js");
+	const { StorageBridge } = await import("./storage-EQJA_0UW.js");
 	const storageMode = opts.storage ?? (opts.mockStorage ? "mock" : "memory");
 	const storage = new StorageBridge({
 		mode: storageMode,
 		mockFile: opts.mockStorage,
 		account: opts.storageAccount ?? opts.samplingAccount,
-		appSlug: opts.appSlug,
+		appSlug: effectiveAppSlug,
 		scopes: opts.storageScopes ? opts.storageScopes.split(",").map((s) => s.trim()).filter(Boolean) : void 0,
 		pluginName: parsed.tool_id
 	});
-	const { ExecutaRunner } = await import("./runner-Bral1LFW.js");
+	const { ExecutaRunner } = await import("./runner-DmGLdat0.js");
+	const { ImageBridge } = await import("./image-bwolX7pa.js");
+	const image = opts.noImage ? new ImageBridge({ mode: "off" }) : opts.mockImage ? new ImageBridge({
+		mode: "mock",
+		mockFile: opts.mockImage
+	}) : effectiveAppSlug ? new ImageBridge({
+		mode: "real",
+		account: opts.imageAccount ?? opts.samplingAccount,
+		appSlug: effectiveAppSlug
+	}) : new ImageBridge({ mode: "off" });
+	const { HostUploadBridge } = await import("./host_upload-C_pGOS6p.js");
+	const hostUpload = opts.noUpload ? new HostUploadBridge({ mode: "off" }) : opts.mockUpload ? new HostUploadBridge({
+		mode: "mock",
+		mockFile: opts.mockUpload
+	}) : effectiveAppSlug ? new HostUploadBridge({
+		mode: "real",
+		account: opts.uploadAccount ?? opts.samplingAccount,
+		appSlug: effectiveAppSlug
+	}) : new HostUploadBridge({ mode: "off" });
 	const runner = new ExecutaRunner({
 		command: parsed.command,
 		cwd: parsed.project_dir,
 		sampling,
 		agent,
 		storage,
+		image,
+		hostUpload,
 		onStderr: (line) => {
 			const text = quiet ? `${line}\n` : dim(`[executa] ${line}\n`);
 			writeStderrCooperative(text);
 		}
 	});
 	if (!quiet) {
+		const slugTag = (mode) => effectiveAppSlug ? `${mode} → app_slug=${effectiveAppSlug}${autoRegistered ? " (auto)" : ""}` : "disabled (no fixture, no --app-slug, no PAT)";
 		console.log(bold(cyan("anna-app executa dev")));
 		console.log(`  tool_id   ${dim(parsed.tool_id)}`);
 		console.log(`  dir       ${dim(parsed.project_dir)}`);
 		console.log(`  command   ${dim(parsed.command.join(" "))}`);
-		console.log(`  sampling  ${dim(opts.noSampling ? "disabled (--no-sampling)" : opts.mockSampling ? `mock (${opts.mockSampling})` : opts.appSlug ? `real → app_slug=${opts.appSlug}` : "disabled (no fixture, no --app-slug)")}`);
-		console.log(`  agent     ${dim(opts.noAgent ? "disabled (--no-agent)" : opts.mockAgent ? `mock (${opts.mockAgent})` : opts.appSlug ? `real → app_slug=${opts.appSlug}` : "disabled (no fixture, no --app-slug)")}`);
-		console.log(`  storage   ${dim(storageMode === "mock" ? `mock (${opts.mockStorage ?? "<no-fixture>"})` : storageMode === "real" ? `real → app_slug=${opts.appSlug ?? "<unset>"}` : storageMode)}`);
+		if (autoRegistered && effectiveAppSlug) console.log(`  executa   ${dim(`auto-registered as ${effectiveAppSlug}`)}`);
+		console.log(`  sampling  ${dim(opts.noSampling ? "disabled (--no-sampling)" : opts.mockSampling ? `mock (${opts.mockSampling})` : slugTag("real"))}`);
+		console.log(`  agent     ${dim(opts.noAgent ? "disabled (--no-agent)" : opts.mockAgent ? `mock (${opts.mockAgent})` : slugTag("real"))}`);
+		console.log(`  storage   ${dim(storageMode === "mock" ? `mock (${opts.mockStorage ?? "<no-fixture>"})` : storageMode === "real" ? `real → app_slug=${effectiveAppSlug ?? "<unset>"}` : storageMode)}`);
+		console.log(`  image     ${dim(opts.noImage ? "disabled (--no-image)" : opts.mockImage ? `mock (${opts.mockImage})` : slugTag("real"))}`);
+		console.log(`  upload    ${dim(opts.noUpload ? "disabled (--no-upload)" : opts.mockUpload ? `mock (${opts.mockUpload})` : slugTag("real"))}`);
 	}
 	let init;
 	try {