@anna-ai/cli 0.1.40 → 0.1.42

package/dist/{app-bundle-upload-B6TJeyOq.js → app-bundle-upload-DgoZIhQG.js}

@@ -29,9 +29,16 @@ const CONTENT_TYPES = {
 	md: "text/markdown"
 };
 const MAX_TOTAL_BYTES = 1024 * 1024 * 1024;
-const MAX_FILE_BYTES = 100 * 1024 * 1024;
+const MAX_FILE_BYTES = 50 * 1024 * 1024;
 const MAX_FILES = 2e3;
 const UPLOAD_PARALLEL = 4;
+const fmtMB = (n) => (n / 1024 / 1024).toFixed(2);
+function totalSizeError(totalBytes) {
+	return new CliError(`bundle is ${fmtMB(totalBytes)} MB — exceeds the ${fmtMB(MAX_TOTAL_BYTES)} MB publish limit.\n  Tip: preview/screenshot images usually shrink 5-10x when exported as WebP/AVIF\n  thumbnails sized for their on-screen dimensions. Unchanged files are deduplicated\n  server-side, so only new bytes upload on re-publish. Assets that must stay large\n  belong in executa binary distribution, not the UI bundle.`, 4);
+}
+function fileSizeError(relativePath, byteSize) {
+	return new CliError(`bundle file exceeds the ${fmtMB(MAX_FILE_BYTES)} MB per-file limit: ${relativePath} (${fmtMB(byteSize)} MB).\n  Compress/split the asset, or ship it via executa binary distribution.`, 4);
+}
 function guessContentType(name) {
 	const m = /\.([a-z0-9]+)$/i.exec(name);
 	if (!m) return "application/octet-stream";
@@ -88,9 +95,9 @@ async function uploadAppBundle(params) {
 	if (files.length === 0) throw new CliError(`bundle directory is empty: ${bundleDir}`, 4);
 	if (files.length > MAX_FILES) throw new CliError(`too many bundle files (${files.length} > ${MAX_FILES})`, 4);
 	const totalBytes = files.reduce((s, f) => s + f.entry.byte_size, 0);
-	if (totalBytes > MAX_TOTAL_BYTES) throw new CliError(`bundle is ${(totalBytes / 1024 / 1024).toFixed(2)} MB — exceeds 50 MB limit`, 4);
+	if (totalBytes > MAX_TOTAL_BYTES) throw totalSizeError(totalBytes);
 	const tooBig = files.find((f) => f.entry.byte_size > MAX_FILE_BYTES);
-	if (tooBig) throw new CliError(`bundle file exceeds 10 MB: ${tooBig.relativePath} (${(tooBig.entry.byte_size / 1024 / 1024).toFixed(2)} MB)`, 4);
+	if (tooBig) throw fileSizeError(tooBig.relativePath, tooBig.entry.byte_size);
 	if (!files.some((f) => f.relativePath === entryPath)) throw new CliError(`manifest entry "${entryPath}" not found in bundle dir ${bundleDir}`, 4);
 	const fingerprint = manifestFingerprint(files);
 	const existing = await getBundle(client, appId, versionId);
@@ -117,7 +124,10 @@ async function uploadAppBundle(params) {
 		external_origins: externalOrigins
 	});
 	const proxyByPath = new Map(initResp.files.map((p) => [p.relative_path, p.proxy_upload_url]));
-	const queue = [...files];
+	const skipSet = new Set(initResp.files.filter((p) => p.skip_upload).map((p) => p.relative_path));
+	const toUpload = files.filter((f) => !skipSet.has(f.relativePath));
+	if (skipSet.size > 0) log?.(`  ♻ ${skipSet.size}/${files.length} files unchanged on server — skipped (dedup)`);
+	const queue = [...toUpload];
 	const uploadOne = async () => {
 		for (;;) {
 			const f = queue.shift();
@@ -129,7 +139,7 @@ async function uploadAppBundle(params) {
 			await uploadBundleFile(client, appId, versionId, f.relativePath, blob);
 		}
 	};
-	await Promise.all(Array.from({ length: Math.min(UPLOAD_PARALLEL, files.length) }, uploadOne));
+	await Promise.all(Array.from({ length: Math.min(UPLOAD_PARALLEL, toUpload.length) }, uploadOne));
 	const detail = await finalizeBundle(client, appId, versionId, false);
 	log?.(`  ✓ bundle finalized (${detail.file_count} files, status=${detail.status})`);
 	return {
@@ -158,9 +168,9 @@ async function uploadWorkingBundle(params) {
 	if (files.length === 0) throw new CliError(`bundle directory is empty: ${bundleDir}`, 4);
 	if (files.length > MAX_FILES) throw new CliError(`too many bundle files (${files.length} > ${MAX_FILES})`, 4);
 	const totalBytes = files.reduce((s, f) => s + f.entry.byte_size, 0);
-	if (totalBytes > MAX_TOTAL_BYTES) throw new CliError(`bundle is ${(totalBytes / 1024 / 1024).toFixed(2)} MB — exceeds 50 MB limit`, 4);
+	if (totalBytes > MAX_TOTAL_BYTES) throw totalSizeError(totalBytes);
 	const tooBig = files.find((f) => f.entry.byte_size > MAX_FILE_BYTES);
-	if (tooBig) throw new CliError(`bundle file exceeds 10 MB: ${tooBig.relativePath} (${(tooBig.entry.byte_size / 1024 / 1024).toFixed(2)} MB)`, 4);
+	if (tooBig) throw fileSizeError(tooBig.relativePath, tooBig.entry.byte_size);
 	if (!files.some((f) => f.relativePath === entryPath)) throw new CliError(`manifest entry "${entryPath}" not found in bundle dir ${bundleDir}`, 4);
 	const fingerprint = manifestFingerprint(files);
 	if (knownFingerprint && knownFingerprint === fingerprint) {
@@ -185,7 +195,10 @@ async function uploadWorkingBundle(params) {
 		external_origins: externalOrigins
 	});
 	const proxyByPath = new Map(initResp.files.map((p) => [p.relative_path, p.proxy_upload_url]));
-	const queue = [...files];
+	const skipSet = new Set(initResp.files.filter((p) => p.skip_upload).map((p) => p.relative_path));
+	const toUpload = files.filter((f) => !skipSet.has(f.relativePath));
+	if (skipSet.size > 0) log?.(`  ♻ ${skipSet.size}/${files.length} files unchanged on server — skipped (dedup)`);
+	const queue = [...toUpload];
 	const uploadOne = async () => {
 		for (;;) {
 			const f = queue.shift();
@@ -197,7 +210,7 @@ async function uploadWorkingBundle(params) {
 			await uploadWorkingBundleFile(client, appId, f.relativePath, blob);
 		}
 	};
-	await Promise.all(Array.from({ length: Math.min(UPLOAD_PARALLEL, files.length) }, uploadOne));
+	await Promise.all(Array.from({ length: Math.min(UPLOAD_PARALLEL, toUpload.length) }, uploadOne));
 	const detail = await finalizeWorkingBundle(client, appId, false);
 	log?.(`  ✓ working bundle staged (${detail.file_count} files, status=${detail.bundle_status})`);
 	return {

package/dist/{apps-cut-CK5eBabo.js → apps-cut-Crx0WrpZ.js}

@@ -10,10 +10,10 @@ import "./executas-CvQY_w2U.js";
 import "./executa-publish-DueD_0hh.js";
 import "./binary-upload-CKMU5Rfw.js";
 import { uploadExecutaBinaries } from "./executa-upload-binaries-DURJTXRI.js";
-import "./dev-CseybCH2.js";
-import "./executa-install-IP1xB9nw.js";
+import "./dev-DEGmXqc_.js";
+import "./executa-install-jSVVx6oh.js";
 import "./app-cache-Cr3tKbux.js";
-import { resolveAppBySlugOrCache } from "./working-orchestration-YUC3pKQx.js";
+import { resolveAppBySlugOrCache } from "./working-orchestration-oFZwsWqQ.js";
 import { resolve } from "node:path";
 import { existsSync } from "node:fs";
 import { bold, cyan, dim, green, yellow } from "kleur/colors";

package/dist/{apps-discard-BpkNZTjG.js → apps-discard-Bmj0-j_T.js}

@@ -10,10 +10,10 @@ import "./executas-CvQY_w2U.js";
 import "./executa-publish-DueD_0hh.js";
 import "./binary-upload-CKMU5Rfw.js";
 import "./executa-upload-binaries-DURJTXRI.js";
-import "./dev-CseybCH2.js";
-import "./executa-install-IP1xB9nw.js";
+import "./dev-DEGmXqc_.js";
+import "./executa-install-jSVVx6oh.js";
 import "./app-cache-Cr3tKbux.js";
-import { resolveAppBySlugOrCache } from "./working-orchestration-YUC3pKQx.js";
+import { resolveAppBySlugOrCache } from "./working-orchestration-oFZwsWqQ.js";
 import { dim, green, yellow } from "kleur/colors";
 
 //#region src/commands/apps-discard.ts

package/dist/{apps-publish-bcqO88S0.js → apps-publish-l4itT8Dk.js}

@@ -7,7 +7,7 @@ import { loadAppManifest } from "./manifest-CAF3_r1T.js";
 import { bumpVersion, bundleHash, manifestHash, rewriteVersion, runExecutaPublish } from "./executa-publish-DueD_0hh.js";
 import { appCacheMatches, readAppIdentity, writeAppIdentity } from "./app-cache-Cr3tKbux.js";
 import { syncAppListingMeta } from "./listing-meta-CtVtyaWu.js";
-import { isExistingDir, uploadAppBundle } from "./app-bundle-upload-B6TJeyOq.js";
+import { isExistingDir, uploadAppBundle } from "./app-bundle-upload-DgoZIhQG.js";
 import { resolve } from "node:path";
 import { bold, cyan, dim, green, yellow } from "kleur/colors";
 

package/dist/{apps-publish-DnU-B7YF.js → apps-publish-z0YSOUL0.js}

@@ -11,7 +11,7 @@ import "./binary-upload-CKMU5Rfw.js";
 import "./executa-upload-binaries-DURJTXRI.js";
 import "./app-cache-Cr3tKbux.js";
 import "./listing-meta-CtVtyaWu.js";
-import "./app-bundle-upload-B6TJeyOq.js";
-import { runAppsPublish } from "./apps-publish-bcqO88S0.js";
+import "./app-bundle-upload-DgoZIhQG.js";
+import { runAppsPublish } from "./apps-publish-l4itT8Dk.js";
 
 export { runAppsPublish };

package/dist/{apps-push-XmXxOTDb.js → apps-push-CDLYRDt8.js}

@@ -10,12 +10,12 @@ import "./executas-CvQY_w2U.js";
 import { bumpVersion, bundleHash, manifestHash, rewriteVersion } from "./executa-publish-DueD_0hh.js";
 import "./binary-upload-CKMU5Rfw.js";
 import "./executa-upload-binaries-DURJTXRI.js";
-import "./dev-CseybCH2.js";
-import "./executa-install-IP1xB9nw.js";
+import "./dev-DEGmXqc_.js";
+import "./executa-install-jSVVx6oh.js";
 import "./app-cache-Cr3tKbux.js";
-import { installLocalBundledShims, resolveAppIdentity, resolveBundledExecutas } from "./working-orchestration-YUC3pKQx.js";
+import { installLocalBundledShims, resolveAppIdentity, resolveBundledExecutas } from "./working-orchestration-oFZwsWqQ.js";
 import { syncAppListingMeta } from "./listing-meta-CtVtyaWu.js";
-import { isExistingDir, uploadWorkingBundle } from "./app-bundle-upload-B6TJeyOq.js";
+import { isExistingDir, uploadWorkingBundle } from "./app-bundle-upload-DgoZIhQG.js";
 import { resolve } from "node:path";
 import { bold, cyan, dim, green, yellow } from "kleur/colors";
 

package/dist/{apps-release-CX7FtoOH.js → apps-release-DlXBYdbb.js}

@@ -59,7 +59,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-DnU-B7YF.js");
+				const { runAppsPublish } = await import("./apps-publish-z0YSOUL0.js");
 				const code = await runAppsPublish({
 					cwd: opts.cwd,
 					account: opts.account,

package/dist/{bridge-CpntGdy3.js → bridge-Bnpq2I_T.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.0a17";
+const PINNED_RUNTIME_VERSION = "0.2.0a18";
 /**
 * 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-CL8HLo-I.js

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

package/dist/cli.js

@@ -473,8 +473,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)").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-CnZO3d6s.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").option("--web <mode>", "Web backend: \"local\" (keyless ddgs + stdlib fetcher, free, default) or \"real\" (platform web service via /api/v1/copilot/app/web/* — production provider chain + normal CU billing; requires `anna-app login`).", "local").action(async (opts) => {
+	const { runDev, parseExecutaSpec } = await import("./dev-C0sHLKn_.js");
 	const cwd = opts.cwd ?? process.cwd();
 	let executas;
 	if (opts.executa && opts.executa.length > 0) {
@@ -503,7 +503,8 @@ program.command("dev").description("Run a local harness (in-process dispatcher +
 		mockLlm: opts.mockLlm,
 		llmAccount: opts.llmAccount,
 		llmAppSlug: opts.llmAppSlug,
-		storageMode: opts.storage
+		storageMode: opts.storage,
+		webMode: opts.web
 	});
 	process.exit(code);
 });
@@ -533,7 +534,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-7XhZ7A4o.js");
+	const { runDoctor } = await import("./doctor-Dm6TNsq6.js");
 	const code = await runDoctor({ matrixNexusRoot: opts.matrixNexusRoot });
 	process.exit(code);
 });
@@ -596,7 +597,7 @@ executa.command("register").description("Register a HARNESS AnnaApp(kind=executa
 	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-B-mkxkKd.js");
+	const { runExecutaInstall } = await import("./executa-install-Q8zSREKQ.js");
 	const code = await runExecutaInstall({
 		dir: opts.dir,
 		toolId: opts.toolId,
@@ -607,7 +608,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-AODQxG02.js");
+	const { runExecutaDev } = await import("./executa-dev-CnWCz6Of.js");
 	const storageMode = opts.storage === void 0 ? void 0 : (() => {
 		const m = opts.storage;
 		if (m === "off" || m === "memory" || m === "mock" || m === "real") return m;
@@ -670,7 +671,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-DnU-B7YF.js");
+	const { runAppsPublish } = await import("./apps-publish-z0YSOUL0.js");
 	process.exit(await runAppsPublish({
 		cwd: opts.cwd,
 		manifest: opts.manifest,
@@ -704,7 +705,7 @@ apps.command("push").description("Upsert the mutable working draft (manifest + b
 			process.exit(2);
 		}
 	}
-	const { runAppsPush } = await import("./apps-push-XmXxOTDb.js");
+	const { runAppsPush } = await import("./apps-push-CDLYRDt8.js");
 	process.exit(await runAppsPush({
 		cwd: opts.cwd,
 		manifest: opts.manifest,
@@ -724,7 +725,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-CK5eBabo.js");
+	const { runAppsCut } = await import("./apps-cut-Crx0WrpZ.js");
 	process.exit(await runAppsCut({
 		version,
 		changelog: opts.changelog,
@@ -736,7 +737,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-BpkNZTjG.js");
+	const { runAppsDiscard } = await import("./apps-discard-Bmj0-j_T.js");
 	process.exit(await runAppsDiscard({
 		slug: opts.slug,
 		cwd: opts.cwd,
@@ -746,7 +747,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-CX7FtoOH.js");
+	const { runAppsRelease } = await import("./apps-release-DlXBYdbb.js");
 	process.exit(await runAppsRelease({
 		version,
 		slug: opts.slug,
@@ -1000,7 +1001,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-BQL5NDnd.js");
+	const { runTopLevelPublish } = await import("./publish-BC5dFF_P.js");
 	process.exit(await runTopLevelPublish({
 		cwd: opts.cwd,
 		bump: opts.bump,

package/dist/dev-C0sHLKn_.js

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

package/dist/{dev-CseybCH2.js → dev-DEGmXqc_.js}

@@ -49,8 +49,20 @@ async function runDev(opts) {
 		}
 		process.env.ANNA_APP_RUNTIME_STORAGE_MODE = "aps";
 	}
-	const { PythonBridge, PINNED_RUNTIME_VERSION } = await import("./bridge-BsQ-pos9.js");
-	const { HarnessServer } = await import("./server-DqTkDxEM.js");
+	const webMode = opts.webMode === "real" ? "real" : "local";
+	if (opts.webMode && opts.webMode !== "local" && opts.webMode !== "real") {
+		console.error(red(`✗ --web must be "local" or "real", got "${opts.webMode}"`));
+		return 2;
+	}
+	if (webMode === "real") {
+		if (opts.noLlm || opts.mockLlm) {
+			console.error(red("✗ --web real requires a real LLM bridge (PAT on disk); drop --no-llm / --mock-llm or switch back to --web local."));
+			return 2;
+		}
+		process.env.ANNA_APP_RUNTIME_WEB_MODE = "real";
+	}
+	const { PythonBridge, PINNED_RUNTIME_VERSION } = await import("./bridge-CL8HLo-I.js");
+	const { HarnessServer } = await import("./server-3aUfxWXU.js");
 	const bridge = new PythonBridge({
 		mode,
 		matrixNexusRoot: matrixNexusRoot ?? void 0,
@@ -112,8 +124,10 @@ async function runDev(opts) {
 	});
 	if (llm === null) return 2;
 	llm.storageMode = storageMode;
+	llm.webMode = webMode;
 	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)")}`);
+	console.log(`  web backend       ${dim(webMode === "real" ? "real (platform web service via /api/v1/copilot/app/web/* — normal CU billing)" : "local (keyless ddgs + stdlib SSRF fetcher, unbilled)")}`);
 	const server = new HarnessServer({
 		slug,
 		manifest,

package/dist/{doctor-7XhZ7A4o.js → doctor-Dm6TNsq6.js}

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

package/dist/{executa-dev-AODQxG02.js → executa-dev-CnWCz6Of.js}

@@ -1,5 +1,5 @@
 import "./nexus-root-BlPwOusj.js";
-import { parseExecutaSpec } from "./dev-CseybCH2.js";
+import { parseExecutaSpec } from "./dev-DEGmXqc_.js";
 import { isAbsolute, resolve } from "node:path";
 import { existsSync } from "node:fs";
 import { bold, cyan, dim, green, red, yellow } from "kleur/colors";
@@ -88,7 +88,7 @@ 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-Bka_coxb.js");
+	const { ExecutaRunner } = await import("./runner-Dq3cluPM.js");
 	const { ImageBridge } = await import("./image-B4UrufYH.js");
 	const image = opts.noImage ? new ImageBridge({ mode: "off" }) : opts.mockImage ? new ImageBridge({
 		mode: "mock",

package/dist/executa-install-Q8zSREKQ.js

@@ -0,0 +1,7 @@
+import "./credentials-BTv2IfUZ.js";
+import "./nexus-root-BlPwOusj.js";
+import "./executa-cache-BFoUtb4J.js";
+import "./dev-DEGmXqc_.js";
+import { runExecutaInstall } from "./executa-install-jSVVx6oh.js";
+
+export { runExecutaInstall };

package/dist/{executa-install-IP1xB9nw.js → executa-install-jSVVx6oh.js}

@@ -1,5 +1,5 @@
 import { readExecutaIdentity } from "./executa-cache-BFoUtb4J.js";
-import { parseExecutaSpec } from "./dev-CseybCH2.js";
+import { parseExecutaSpec } from "./dev-DEGmXqc_.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/{publish-BQL5NDnd.js → publish-BC5dFF_P.js}

@@ -11,8 +11,8 @@ import "./binary-upload-CKMU5Rfw.js";
 import "./executa-upload-binaries-DURJTXRI.js";
 import "./app-cache-Cr3tKbux.js";
 import "./listing-meta-CtVtyaWu.js";
-import "./app-bundle-upload-B6TJeyOq.js";
-import { runAppsPublish } from "./apps-publish-bcqO88S0.js";
+import "./app-bundle-upload-DgoZIhQG.js";
+import { runAppsPublish } from "./apps-publish-l4itT8Dk.js";
 import { resolve } from "node:path";
 import { existsSync } from "node:fs";
 import { red, yellow } from "kleur/colors";

package/dist/{runner-Bka_coxb.js → runner-Dq3cluPM.js}

@@ -204,7 +204,11 @@ var ExecutaRunner = class {
 	async handleReverse(env) {
 		const id = env.id;
 		const method = env.method;
-		const params = env.params ?? {};
+		let params = env.params ?? {};
+		if (params.context !== void 0) {
+			const { context: _context,...rest } = params;
+			params = rest;
+		}
 		const respond = (body) => {
 			if (id === void 0 || id === null) return;
 			if (!this.proc) return;

package/dist/{server-DqTkDxEM.js → server-3aUfxWXU.js}

@@ -1,5 +1,5 @@
 import { canonicalHost, getAccount } from "./credentials-BTv2IfUZ.js";
-import { BridgeRequestError } from "./bridge-CpntGdy3.js";
+import { BridgeRequestError } from "./bridge-Bnpq2I_T.js";
 import { dirname, join, normalize, resolve } from "node:path";
 import { createRequire } from "node:module";
 import { createReadStream, existsSync, readFileSync, statSync, watch } from "node:fs";
@@ -99,6 +99,15 @@ const VALID_STORAGE_SCOPES = new Set([
 	"app",
 	"tool"
 ]);
+/** ``anna.web.*`` methods forwarded to ``/api/v1/copilot/app/web/*`` when
+*  ``webMode === "real"``. Mirrors matrix-nexus ``copilot_app.py`` routes;
+*  wire shapes are identical to the iframe HOST API (app-web-search §2). */
+const WEB_REAL_METHODS = new Set([
+	"search",
+	"fetch",
+	"image_search",
+	"image_fetch"
+]);
 var LlmBridge = class {
 	mintedAuto = new Map();
 	mintedAgent = new Map();
@@ -139,6 +148,7 @@ var LlmBridge = class {
 		if (ns === "upload" && (method === "inline" || method === "negotiate" || method === "confirm")) return true;
 		if (ns === "storage" && this.opts.storageMode === "aps" && this.opts.mode === "real" && STORAGE_APS_METHODS.has(method)) return true;
 		if (ns === "files" && this.opts.storageMode === "aps" && this.opts.mode === "real" && Object.prototype.hasOwnProperty.call(FILES_APP_ROUTES, method)) return true;
+		if (ns === "web" && this.opts.webMode === "real" && this.opts.mode === "real" && WEB_REAL_METHODS.has(method)) return true;
 		return false;
 	}
 	/** Back-compat static alias — older code paths still call
@@ -694,6 +704,14 @@ var LlmBridge = class {
 				};
 			}
 		}
+		if (args.ns === "web" && WEB_REAL_METHODS.has(args.method)) {
+			const ms = await this.mintComplete(args.windowUuid);
+			const result = await this.postJson(`${canonicalHost(acc.host)}/api/v1/copilot/app/web/${args.method}`, ms.appSessionToken, args.args);
+			return {
+				ok: true,
+				result
+			};
+		}
 		if (args.ns === "storage") {
 			const sm = await this.mintStorage();
 			const a = args.args;
@@ -1355,6 +1373,26 @@ var HarnessServer = class {
 				"host.storage.files_delete",
 				"storage",
 				"files_delete"
+			],
+			[
+				"host.web.search",
+				"web",
+				"search"
+			],
+			[
+				"host.web.fetch",
+				"web",
+				"fetch"
+			],
+			[
+				"host.web.image_search",
+				"web",
+				"image_search"
+			],
+			[
+				"host.web.image_fetch",
+				"web",
+				"image_fetch"
 			]
 		];
 		for (const [hostMethod, ns, dispatchMethod] of HOST_OUTBOUND_ROUTES) this.bridge.onRequest(hostMethod, async (params) => {

package/dist/{working-orchestration-YUC3pKQx.js → working-orchestration-oFZwsWqQ.js}

@@ -4,7 +4,7 @@ import { CliError } from "./client-D-_z1ALk.js";
 import { parseExecutaIdOverrides, readExecutasLock, substituteBundledRefs, validateBundledHandles, writeBundleToolIdSidecar, writeExecutasLock } from "./bundled-executas-rSIkaA6-.js";
 import { loadExecutaManifest } from "./manifest-CAF3_r1T.js";
 import { runExecutaPublish } from "./executa-publish-DueD_0hh.js";
-import { runExecutaInstall } from "./executa-install-IP1xB9nw.js";
+import { runExecutaInstall } from "./executa-install-jSVVx6oh.js";
 import { appCacheMatches, readAppIdentity, writeAppIdentity } from "./app-cache-Cr3tKbux.js";
 import { join, resolve } from "node:path";
 import { dim, green, yellow } from "kleur/colors";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anna-ai/cli",
-  "version": "0.1.40",
+  "version": "0.1.42",
   "description": "Anna App developer CLI: scaffold, validate, harness (Phase 2 MVP: init + validate).",
   "license": "MIT",
   "type": "module",

package/dist/bridge-BsQ-pos9.js

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

package/dist/dev-CnZO3d6s.js

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

package/dist/executa-install-B-mkxkKd.js

@@ -1,7 +0,0 @@
-import "./credentials-BTv2IfUZ.js";
-import "./nexus-root-BlPwOusj.js";
-import "./executa-cache-BFoUtb4J.js";
-import "./dev-CseybCH2.js";
-import { runExecutaInstall } from "./executa-install-IP1xB9nw.js";
-
-export { runExecutaInstall };