@anna-ai/cli 0.1.29 → 0.1.30

package/dist/cli.js

@@ -470,7 +470,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-CQkCFVXu.js");
+	const { runDev, parseExecutaSpec } = await import("./dev-C9VpI_AL.js");
 	const cwd = opts.cwd ?? process.cwd();
 	let executas;
 	if (opts.executa && opts.executa.length > 0) {
@@ -505,7 +505,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-BvP5umlN.js");
+	const { runFixtureVerify } = await import("./fixture-BJqc1IfX.js");
 	const code = await runFixtureVerify({
 		file,
 		json: opts.json
@@ -513,7 +513,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-BvP5umlN.js");
+	const { runFixtureSummarize } = await import("./fixture-BJqc1IfX.js");
 	const code = await runFixtureSummarize({
 		file,
 		json: opts.json
@@ -521,7 +521,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-BvP5umlN.js");
+	const { runFixtureReplay } = await import("./fixture-BJqc1IfX.js");
 	const code = await runFixtureReplay({
 		file,
 		manifest: opts.manifest
@@ -529,12 +529,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-DCsBgyRg.js");
+	const { runDoctor } = await import("./doctor-DnCYaREu.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-BGZjMAlh.js");
+	const { runLogin } = await import("./login-CslsHbsq.js");
 	const code = await runLogin({
 		host: opts.host,
 		noBrowser: opts.browser === false
@@ -542,7 +542,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-mh2_QlyM.js");
+	const { runLogout } = await import("./logout-B4_b9ZL0.js");
 	const code = await runLogout({
 		host: opts.host,
 		all: opts.all
@@ -550,10 +550,20 @@ 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-l_kIkfbI.js");
+	const { runWhoami } = await import("./whoami-ChzwOaN2.js");
 	const code = await runWhoami({ json: opts.json });
 	process.exit(code);
 });
+const account = program.command("account").description("Manage your developer account (handle / namespace)");
+account.command("set-handle <handle>").description("Set or rename your developer handle — the @handle namespace your apps publish under (@handle/slug). Required before creating your first app.").option("--host <url>", "Account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (handle, opts) => {
+	const { runAccountSetHandle } = await import("./account-B6n0XkpV.js");
+	const code = await runAccountSetHandle({
+		handle,
+		account: opts.host,
+		json: opts.json
+	});
+	process.exit(code);
+});
 const executa = program.command("executa").description("Standalone Executa plugin scaffolding + local runner");
 executa.command("init <dir>").description("Scaffold a standalone Executa plugin (python | node | go)").option("--slug <slug>", "Plugin slug (lowercase, hyphens)", "").option("--template <name>", "Language template: python | node | go", "python").option("--tool-id <id>", "Override the minted tool_id (default: tool-dev-<slug>)").option("--force", "Overwrite existing dir if non-empty", false).action(async (dir, opts) => {
 	const slug = opts.slug || dir.split(/[\\/]/).pop() || "my-executa";
@@ -566,7 +576,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-DXea7yRN.js");
+	const { runExecutaInit } = await import("./executa-init-BCqJUZXT.js");
 	const code = runExecutaInit({
 		targetDir: dir,
 		slug,
@@ -577,12 +587,12 @@ 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 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-BUiPzPIU.js");
+	const { runExecutaRegister } = await import("./executa-register-CMmlKyKB.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-Bvf_Lvvg.js");
+	const { runExecutaInstall } = await import("./executa-install-Bc1WRrWu.js");
 	const code = await runExecutaInstall({
 		dir: opts.dir,
 		toolId: opts.toolId,
@@ -593,7 +603,7 @@ executa.command("install").description("Install a local-dev shim for an Executa
 	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("--sampling-unsupported-format", "Simulate a model without json_schema support — exercises responseFormat onUnsupported branches (-32010 / downgrade)").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-DEpBrEIH.js");
+	const { runExecutaDev } = await import("./executa-dev-0XdBPTDy.js");
 	const storageMode = opts.storage === void 0 ? void 0 : (() => {
 		const m = opts.storage;
 		if (m === "off" || m === "memory" || m === "mock" || m === "real") return m;
@@ -631,12 +641,22 @@ 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-3VcdHIBK.js");
+	const { runAppsList } = await import("./apps-BpJ-TvHP.js");
 	process.exit(await runAppsList({
 		account: opts.account,
 		json: opts.json
 	}));
 });
+apps.command("rename-slug <new-slug>").description("Rename an app's public slug (DRAFT/REJECTED, never-published, zero installs only). Updates local app.json + .anna/app.json on success.").option("--cwd <dir>", "Project root (default: cwd)").option("--manifest <path>", "manifest.json path", "manifest.json").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (newSlug, opts) => {
+	const { runAppsRenameSlug } = await import("./apps-rename-slug-Bp-nQ_6I.js");
+	process.exit(await runAppsRenameSlug({
+		newSlug,
+		cwd: opts.cwd,
+		manifest: opts.manifest,
+		account: opts.account,
+		json: opts.json
+	}));
+});
 apps.command("publish").description("Publish or update an Anna App (manifest.json in cwd)").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 upload", 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 publish bundled executas", false).option("--no-bundled-executas", "Disable bundled-executa orchestration (legacy behaviour)").option("--no-bundle", "Skip UI bundle upload even if the manifest declares a UI").option("--bundle-dir <dir>", "UI bundle directory (default: <cwd>/bundle)").option("--account <host>", "Saved account host (default: current)").option("--json", "Emit machine-readable JSON", false).action(async (opts) => {
 	if (opts.bump && ![
 		"patch",
@@ -646,7 +666,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-Do7M5je3.js");
+	const { runAppsPublish } = await import("./apps-publish-3wbhXfAg.js");
 	process.exit(await runAppsPublish({
 		cwd: opts.cwd,
 		manifest: opts.manifest,
@@ -679,7 +699,7 @@ apps.command("push").description("Upsert the mutable working draft (manifest + b
 			process.exit(2);
 		}
 	}
-	const { runAppsPush } = await import("./apps-push-DbUEFdCK.js");
+	const { runAppsPush } = await import("./apps-push-Bh8zwT--.js");
 	process.exit(await runAppsPush({
 		cwd: opts.cwd,
 		manifest: opts.manifest,
@@ -698,7 +718,7 @@ apps.command("push").description("Upsert the mutable working draft (manifest + b
 	}));
 });
 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-BOhg9RHy.js");
+	const { runAppsCut } = await import("./apps-cut-C5SH9qZN.js");
 	process.exit(await runAppsCut({
 		version,
 		changelog: opts.changelog,
@@ -710,7 +730,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-Dy3vzpCM.js");
+	const { runAppsDiscard } = await import("./apps-discard-CfdkwUZ_.js");
 	process.exit(await runAppsDiscard({
 		slug: opts.slug,
 		cwd: opts.cwd,
@@ -720,7 +740,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-DJFG4BV3.js");
+	const { runAppsRelease } = await import("./apps-release-DNlN_8gz.js");
 	process.exit(await runAppsRelease({
 		version,
 		slug: opts.slug,
@@ -732,7 +752,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-CQQC_Heb.js");
+	const { runAppsSyncMeta } = await import("./apps-sync-meta-DdPnXuIU.js");
 	process.exit(await runAppsSyncMeta({
 		cwd: opts.cwd,
 		manifest: opts.manifest,
@@ -742,7 +762,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-BVmZlhmB.js");
+	const { runAppsSubmitReview } = await import("./apps-submit-review-DH-bzbDZ.js");
 	process.exit(await runAppsSubmitReview({
 		slug,
 		cwd: opts.cwd,
@@ -751,7 +771,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-F6aVlzDW.js");
+	const { runAppsStatus } = await import("./apps-status-5DV9cY4A.js");
 	process.exit(await runAppsStatus({
 		slug,
 		account: opts.account,
@@ -759,7 +779,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-BIKsJzIT.js");
+	const { runAppsVersions } = await import("./apps-versions-vGihRRje.js");
 	process.exit(await runAppsVersions({
 		slug,
 		account: opts.account,
@@ -767,7 +787,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-DgvymPBT.js");
+	const { runAppsGrants } = await import("./apps-grants-BtXXiuJt.js");
 	process.exit(await runAppsGrants({
 		slug,
 		account: opts.account,
@@ -775,7 +795,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-DWF4eTHn.js");
+	const { runAppsUnpublish } = await import("./apps-destructive-PY0wKjqu.js");
 	process.exit(await runAppsUnpublish({
 		slug,
 		yes: opts.yes,
@@ -785,7 +805,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-DWF4eTHn.js");
+	const { runAppsArchive } = await import("./apps-destructive-PY0wKjqu.js");
 	process.exit(await runAppsArchive({
 		slug,
 		yes: opts.yes,
@@ -795,7 +815,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-DWF4eTHn.js");
+	const { runAppsUnarchive } = await import("./apps-destructive-PY0wKjqu.js");
 	process.exit(await runAppsUnarchive({
 		slug,
 		yes: opts.yes,
@@ -804,7 +824,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-DWF4eTHn.js");
+	const { runAppsDelete } = await import("./apps-destructive-PY0wKjqu.js");
 	process.exit(await runAppsDelete({
 		slug,
 		yes: opts.yes,
@@ -814,14 +834,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-CjGZq1yP.js");
+	const { runExecutaList } = await import("./executa-reads-CjIr8BuD.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-CjGZq1yP.js");
+	const { runExecutaStatus } = await import("./executa-reads-CjIr8BuD.js");
 	process.exit(await runExecutaStatus({
 		ref,
 		account: opts.account,
@@ -829,7 +849,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-CjGZq1yP.js");
+	const { runExecutaVersions } = await import("./executa-reads-CjIr8BuD.js");
 	process.exit(await runExecutaVersions({
 		ref,
 		account: opts.account,
@@ -845,7 +865,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-IXWSwva0.js");
+	const { runExecutaPublish } = await import("./executa-publish-9XQRncyN.js");
 	process.exit(await runExecutaPublish({
 		cwd: opts.cwd,
 		manifest: opts.manifest,
@@ -858,7 +878,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-PL2ooHpZ.js");
+	const { runExecutaUnpublish } = await import("./executa-destructive-8iSnfmcn.js");
 	process.exit(await runExecutaUnpublish({
 		slug,
 		yes: opts.yes,
@@ -868,7 +888,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-PL2ooHpZ.js");
+	const { runExecutaYank } = await import("./executa-destructive-8iSnfmcn.js");
 	process.exit(await runExecutaYank({
 		ref,
 		yes: opts.yes,
@@ -878,7 +898,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-PL2ooHpZ.js");
+	const { runExecutaDelete } = await import("./executa-destructive-8iSnfmcn.js");
 	process.exit(await runExecutaDelete({
 		slug,
 		yes: opts.yes,
@@ -890,7 +910,7 @@ executa.command("delete <slug>").description("Hard-delete an Executa").option("-
 executa.command("cache-clear").description("Delete the local `.anna/executa.json` identity cache. Use after the server-side Executa has been deleted/recreated, or when switching host. Next `executa publish` will re-mint via the idempotency key.").option("--cwd <dir>", "Project root (default: cwd)").action(async (opts) => {
 	const { resolve: resolve$1 } = await import("node:path");
 	const { existsSync: existsSync$1 } = await import("node:fs");
-	const { executaCachePath, invalidateExecutaCache } = await import("./executa-cache-Kx3rfQD-.js");
+	const { executaCachePath, invalidateExecutaCache } = await import("./executa-cache-B0O79Hpb.js");
 	const cwd = resolve$1(opts.cwd ?? process.cwd());
 	const p = executaCachePath(cwd);
 	if (!existsSync$1(p)) {
@@ -903,7 +923,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-Cg7BZGp6.js");
+	const { runTokenList } = await import("./token-hGGfoge2.js");
 	process.exit(await runTokenList({
 		includeRevoked: opts.includeRevoked,
 		account: opts.account,
@@ -916,7 +936,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-Cg7BZGp6.js");
+	const { runTokenRevoke } = await import("./token-hGGfoge2.js");
 	process.exit(await runTokenRevoke({
 		id: idNum,
 		account: opts.account,
@@ -924,7 +944,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-Cg7BZGp6.js");
+	const { runTokenScopes } = await import("./token-hGGfoge2.js");
 	process.exit(await runTokenScopes({
 		account: opts.account,
 		json: opts.json
@@ -939,7 +959,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-BYWuujP3.js");
+	const { runTopLevelPublish } = await import("./publish-NTT1Libd.js");
 	process.exit(await runTopLevelPublish({
 		cwd: opts.cwd,
 		bump: opts.bump,

package/dist/dev-C9VpI_AL.js

@@ -0,0 +1,4 @@
+import "./nexus-root-BlPwOusj.js";
+import { parseExecutaSpec, runDev } from "./dev-aWkfWGLD.js";
+
+export { parseExecutaSpec, runDev };

package/dist/{dev-DXODERsf.js → dev-aWkfWGLD.js}

@@ -49,8 +49,8 @@ async function runDev(opts) {
 		}
 		process.env.ANNA_APP_RUNTIME_STORAGE_MODE = "aps";
 	}
-	const { PythonBridge, PINNED_RUNTIME_VERSION } = await import("./bridge-6GIQG63S.js");
-	const { HarnessServer } = await import("./server-F_VA-5tS.js");
+	const { PythonBridge, PINNED_RUNTIME_VERSION } = await import("./bridge-CmoKMMcG.js");
+	const { HarnessServer } = await import("./server-DtnMLKQS.js");
 	const bridge = new PythonBridge({
 		mode,
 		matrixNexusRoot: matrixNexusRoot ?? void 0,
@@ -90,7 +90,7 @@ async function runDev(opts) {
 	if (executas.length > 0) console.log(`  executas          ${dim(executas.map((e) => e.tool_id).join(", "))}`);
 	const bundledResolved = resolveBundledHandles(dirname(manifestPath), executas);
 	if (Object.keys(bundledResolved).length > 0) {
-		const { substituteBundledRefs, writeBundleToolIdSidecar } = await import("./bundled-executas-DeBhDjd8.js");
+		const { substituteBundledRefs, writeBundleToolIdSidecar } = await import("./bundled-executas-06keEPP_.js");
 		try {
 			manifest = substituteBundledRefs(manifest, bundledResolved);
 			writeBundleToolIdSidecar(bundleDir, bundledResolved);
@@ -161,7 +161,7 @@ async function runDev(opts) {
 */
 async function resolveRealLlm(args) {
 	const { getAccount } = await import("./credentials-Chkoidh5.js");
-	const { ensureDevAppRegistered } = await import("./dev-app-cache-TSjL4D4n.js");
+	const { ensureDevAppRegistered } = await import("./dev-app-cache-CP2P8SCZ.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.)"));
@@ -190,7 +190,7 @@ async function resolveRealLlm(args) {
 			account: args.account,
 			appSlug: entry.slug,
 			onAppSlugNotFound: async () => {
-				const { invalidateDevAppCache } = await import("./dev-app-cache-TSjL4D4n.js");
+				const { invalidateDevAppCache } = await import("./dev-app-cache-CP2P8SCZ.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");

package/dist/{dev-app-cache-TSjL4D4n.js → dev-app-cache-CP2P8SCZ.js}

@@ -58,6 +58,7 @@ async function registerDevApp(args) {
 	});
 	if (!res.ok) {
 		const text = await res.text().catch(() => "");
+		if (res.status === 409 && text.includes("HANDLE_REQUIRED")) throw new Error("developer handle required before registering a dev app — run `anna-app account set-handle <handle>` first.");
 		throw new Error(`/dev/apps/register failed: HTTP ${res.status} ${text}`);
 	}
 	return await res.json();

package/dist/{doctor-DCsBgyRg.js → doctor-DnCYaREu.js}

@@ -1,5 +1,5 @@
 import { findMatrixNexusRoot, nexusSchemaDir } from "./nexus-root-BlPwOusj.js";
-import { PINNED_RUNTIME_VERSION } from "./bridge-DAY7bsje.js";
+import { PINNED_RUNTIME_VERSION } from "./bridge-DXH59CmP.js";
 import { resolve } from "node:path";
 import { existsSync, statSync } from "node:fs";
 import { spawnSync } from "node:child_process";

package/dist/{executa-cache-Kx3rfQD-.js → executa-cache-B0O79Hpb.js}

@@ -1,4 +1,4 @@
 import "./credentials-BTv2IfUZ.js";
-import { executaCacheMatches, executaCachePath, invalidateExecutaCache, mintIdempotencyKey, readExecutaIdentity, writeExecutaIdentity } from "./executa-cache-CXiEgFZY.js";
+import { executaCacheMatches, executaCachePath, invalidateExecutaCache, mintIdempotencyKey, readExecutaIdentity, writeExecutaIdentity } from "./executa-cache-Do1D7xC0.js";
 
 export { executaCachePath, invalidateExecutaCache };

package/dist/{executa-destructive-PL2ooHpZ.js → executa-destructive-8iSnfmcn.js}

@@ -1,8 +1,8 @@
 import "./credentials-BTv2IfUZ.js";
 import { CliError } from "./client-D-_z1ALk.js";
-import { deleteMyTool, listMyTools, listToolVersions, unpublishTool, yankToolVersion } from "./executas-CK3er6f9.js";
-import { resolveClient, withErrorHandling } from "./_lifecycle-shared-BpSOfVCP.js";
-import { ensureDestructiveAllowed } from "./confirm-h_qMrx0I.js";
+import { resolveClient, withErrorHandling } from "./_lifecycle-shared-CUK2CE76.js";
+import { deleteMyTool, listMyTools, listToolVersions, unpublishTool, yankToolVersion } from "./executas-BhFed1B-.js";
+import { ensureDestructiveAllowed } from "./confirm-BuT56E_B.js";
 import { dim, green, yellow } from "kleur/colors";
 
 //#region src/commands/executa-destructive.ts

package/dist/{executa-dev-DEpBrEIH.js → executa-dev-0XdBPTDy.js}

@@ -1,5 +1,5 @@
 import "./nexus-root-BlPwOusj.js";
-import { parseExecutaSpec } from "./dev-DXODERsf.js";
+import { parseExecutaSpec } from "./dev-aWkfWGLD.js";
 import { isAbsolute, resolve } from "node:path";
 import { existsSync } from "node:fs";
 import { bold, cyan, dim, green, red, yellow } from "kleur/colors";
@@ -35,7 +35,7 @@ async function runExecutaDev(opts) {
 	const oneShot = !!(opts.describe || opts.health || opts.invoke);
 	const quiet = oneShot && (opts.json ?? false);
 	const { getAccount } = await import("./credentials-Chkoidh5.js");
-	const { ensureDevExecutaRegistered } = await import("./dev-app-cache-TSjL4D4n.js");
+	const { ensureDevExecutaRegistered } = await import("./dev-app-cache-CP2P8SCZ.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;
@@ -57,7 +57,7 @@ async function runExecutaDev(opts) {
 			}
 		}
 	}
-	const { SamplingBridge } = await import("./sampling-DwV7VPfT.js");
+	const { SamplingBridge } = await import("./sampling-Cc0qaj8a.js");
 	const simulateUnsupportedResponseFormat = opts.samplingUnsupportedFormat;
 	const sampling = opts.noSampling ? new SamplingBridge({ mode: "off" }) : opts.mockSampling ? new SamplingBridge({
 		mode: "mock",
@@ -69,7 +69,7 @@ async function runExecutaDev(opts) {
 		appSlug: effectiveAppSlug,
 		simulateUnsupportedResponseFormat
 	}) : new SamplingBridge({ mode: "off" });
-	const { AgentBridge } = await import("./agent-CaZVCPs6.js");
+	const { AgentBridge } = await import("./agent-J2bELWfv.js");
 	const agent = opts.noAgent ? new AgentBridge({ mode: "off" }) : opts.mockAgent ? new AgentBridge({
 		mode: "mock",
 		mockFile: opts.mockAgent
@@ -78,7 +78,7 @@ async function runExecutaDev(opts) {
 		account: opts.agentAccount ?? opts.samplingAccount,
 		appSlug: effectiveAppSlug
 	}) : new AgentBridge({ mode: "off" });
-	const { StorageBridge } = await import("./storage-CKTmE87u.js");
+	const { StorageBridge } = await import("./storage-C95wApr2.js");
 	const storageMode = opts.storage ?? (opts.mockStorage ? "mock" : "memory");
 	const storage = new StorageBridge({
 		mode: storageMode,
@@ -88,8 +88,8 @@ async function runExecutaDev(opts) {
 		scopes: opts.storageScopes ? opts.storageScopes.split(",").map((s) => s.trim()).filter(Boolean) : void 0,
 		pluginName: parsed.tool_id
 	});
-	const { ExecutaRunner } = await import("./runner-BuYbm-ex.js");
-	const { ImageBridge } = await import("./image-CSEXEfD-.js");
+	const { ExecutaRunner } = await import("./runner-DVu-o_U8.js");
+	const { ImageBridge } = await import("./image-Bdi4Hu0m.js");
 	const image = opts.noImage ? new ImageBridge({ mode: "off" }) : opts.mockImage ? new ImageBridge({
 		mode: "mock",
 		mockFile: opts.mockImage
@@ -98,7 +98,7 @@ async function runExecutaDev(opts) {
 		account: opts.imageAccount ?? opts.samplingAccount,
 		appSlug: effectiveAppSlug
 	}) : new ImageBridge({ mode: "off" });
-	const { HostUploadBridge } = await import("./host_upload-BXeHTgJs.js");
+	const { HostUploadBridge } = await import("./host_upload-sfo4UHlR.js");
 	const hostUpload = opts.noUpload ? new HostUploadBridge({ mode: "off" }) : opts.mockUpload ? new HostUploadBridge({
 		mode: "mock",
 		mockFile: opts.mockUpload

package/dist/{executa-install-BHQpOskj.js → executa-install-A-BgavhA.js}

@@ -1,5 +1,5 @@
-import { readExecutaIdentity } from "./executa-cache-CXiEgFZY.js";
-import { parseExecutaSpec } from "./dev-DXODERsf.js";
+import { readExecutaIdentity } from "./executa-cache-Do1D7xC0.js";
+import { parseExecutaSpec } from "./dev-aWkfWGLD.js";
 import { isAbsolute, join, resolve } from "node:path";
 import { chmodSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { bold, cyan, dim, green, red, yellow } from "kleur/colors";

package/dist/executa-install-Bc1WRrWu.js

@@ -0,0 +1,7 @@
+import "./credentials-BTv2IfUZ.js";
+import "./nexus-root-BlPwOusj.js";
+import "./executa-cache-Do1D7xC0.js";
+import "./dev-aWkfWGLD.js";
+import { runExecutaInstall } from "./executa-install-A-BgavhA.js";
+
+export { runExecutaInstall };

package/dist/executa-publish-9XQRncyN.js

@@ -0,0 +1,9 @@
+import "./credentials-BTv2IfUZ.js";
+import "./client-D-_z1ALk.js";
+import "./_lifecycle-shared-CUK2CE76.js";
+import "./executas-BhFed1B-.js";
+import "./executa-cache-Do1D7xC0.js";
+import { runExecutaPublish } from "./executa-publish-Xmm4DMO9.js";
+import "./manifest-CMc7RM57.js";
+
+export { runExecutaPublish };

package/dist/{executa-publish-CkPAB34b.js → executa-publish-Xmm4DMO9.js}

@@ -1,9 +1,9 @@
 import { canonicalHost } from "./credentials-BTv2IfUZ.js";
 import { CliError } from "./client-D-_z1ALk.js";
-import { commitDraft, createDraft, getMySkill, getMyTool, listToolVersions, publishToolVersion, setSkillVisibility, setToolVisibility, updateMySkill, updateMyTool } from "./executas-CK3er6f9.js";
-import { executaCacheMatches, invalidateExecutaCache, mintIdempotencyKey, readExecutaIdentity, writeExecutaIdentity } from "./executa-cache-CXiEgFZY.js";
-import { loadExecutaManifest } from "./manifest-Bljz8Y6T.js";
-import { resolveClient, withErrorHandling } from "./_lifecycle-shared-BpSOfVCP.js";
+import { resolveClient, withErrorHandling } from "./_lifecycle-shared-CUK2CE76.js";
+import { commitDraft, createDraft, getMySkill, getMyTool, listToolVersions, publishToolVersion, setSkillVisibility, setToolVisibility, updateMySkill, updateMyTool } from "./executas-BhFed1B-.js";
+import { executaCacheMatches, invalidateExecutaCache, mintIdempotencyKey, readExecutaIdentity, writeExecutaIdentity } from "./executa-cache-Do1D7xC0.js";
+import { loadExecutaManifest } from "./manifest-CMc7RM57.js";
 import { join, relative, resolve, sep } from "node:path";
 import { readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
 import { bold, cyan, dim, green, yellow } from "kleur/colors";

package/dist/{executa-reads-CjGZq1yP.js → executa-reads-CjIr8BuD.js}

@@ -1,7 +1,7 @@
 import "./credentials-BTv2IfUZ.js";
 import { CliError } from "./client-D-_z1ALk.js";
-import { getMyTool, listMyTools, listToolVersions } from "./executas-CK3er6f9.js";
-import { resolveClient, withErrorHandling } from "./_lifecycle-shared-BpSOfVCP.js";
+import { resolveClient, withErrorHandling } from "./_lifecycle-shared-CUK2CE76.js";
+import { getMyTool, listMyTools, listToolVersions } from "./executas-BhFed1B-.js";
 import { bold, cyan, dim, green } from "kleur/colors";
 
 //#region src/commands/executa-reads.ts

package/dist/{publish-BYWuujP3.js → publish-NTT1Libd.js}

@@ -1,15 +1,15 @@
 import "./credentials-BTv2IfUZ.js";
-import "./apps-CCdtLmxQ.js";
+import "./apps-73pdBAFE.js";
 import { CliError } from "./client-D-_z1ALk.js";
-import "./bundled-executas-B6b8gIfp.js";
-import "./executas-CK3er6f9.js";
-import "./executa-cache-CXiEgFZY.js";
-import { runExecutaPublish } from "./executa-publish-CkPAB34b.js";
-import "./manifest-Bljz8Y6T.js";
-import { withErrorHandling } from "./_lifecycle-shared-BpSOfVCP.js";
-import "./app-cache-Bl7cE5fm.js";
-import "./app-bundle-upload-BhAYo6yj.js";
-import { runAppsPublish } from "./apps-publish-Dgi4lBlu.js";
+import { withErrorHandling } from "./_lifecycle-shared-CUK2CE76.js";
+import "./bundled-executas-_H1A9M50.js";
+import "./executas-BhFed1B-.js";
+import "./executa-cache-Do1D7xC0.js";
+import { runExecutaPublish } from "./executa-publish-Xmm4DMO9.js";
+import "./manifest-CMc7RM57.js";
+import "./app-cache-BqnTkxUw.js";
+import "./app-bundle-upload-CPf_nGou.js";
+import { runAppsPublish } from "./apps-publish-B-ZVNmgn.js";
 import { resolve } from "node:path";
 import { existsSync } from "node:fs";
 import { red, yellow } from "kleur/colors";

package/dist/{server-F_VA-5tS.js → server-DtnMLKQS.js}

@@ -1,5 +1,5 @@
 import { canonicalHost, getAccount } from "./credentials-BTv2IfUZ.js";
-import { BridgeRequestError } from "./bridge-DAY7bsje.js";
+import { BridgeRequestError } from "./bridge-DXH59CmP.js";
 import { dirname, join, normalize, resolve } from "node:path";
 import { createRequire } from "node:module";
 import { createReadStream, existsSync, readFileSync, statSync, watch } from "node:fs";