@anna-ai/cli 0.1.29 → 0.1.32

package/dist/listing-meta-BlY7XMrw.js

@@ -0,0 +1,117 @@
+import { patchApp, uploadAppLogo, uploadAppScreenshot } from "./apps-DlVsVHQ5.js";
+import { CliError } from "./client-D-_z1ALk.js";
+import { extname, resolve } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+
+//#region src/publish/listing-meta.ts
+const IMAGE_CONTENT_TYPES = {
+	".svg": "image/svg+xml",
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".jpeg": "image/jpeg",
+	".webp": "image/webp",
+	".gif": "image/gif"
+};
+function imageContentType(path) {
+	return IMAGE_CONTENT_TYPES[extname(path).toLowerCase()] ?? "application/octet-stream";
+}
+/**
+* A listing asset is "remote" (forwarded verbatim) when it's an absolute
+* http(s) URL or an inline `data:` URI. Anything else is treated as a
+* project-relative local file to be uploaded to the CDN — same split the logo
+* uses between `logoUrl` and `logoFile`.
+*/
+function isRemoteAsset(src) {
+	return /^https?:\/\//i.test(src) || src.startsWith("data:");
+}
+/**
+* Build the metadata payload from the manifest (only defined fields). The
+* logo is handled separately and never appears here when sourced from a file.
+*/
+function buildMeta(manifest) {
+	const meta = {};
+	const add = (key, value) => {
+		if (value !== void 0 && value !== null && value !== "") meta[key] = value;
+	};
+	add("name", manifest.name);
+	add("category", manifest.category);
+	add("tagline", manifest.tagline);
+	add("description", manifest.description);
+	add("cover_url", manifest.coverUrl);
+	add("homepage_url", manifest.homepageUrl);
+	add("support_url", manifest.supportUrl);
+	add("privacy_url", manifest.privacyUrl);
+	add("pricing_model", manifest.pricingModel);
+	return meta;
+}
+/**
+* Sync the app's store-listing metadata (and logo) from the local manifest.
+*
+* Returns a plan/result. When `dryRun` is set, no network calls are made and
+* the returned object reflects what *would* be sent.
+*/
+async function syncAppListingMeta(client, appId, manifest, opts) {
+	const meta = buildMeta(manifest);
+	const localLogo = opts.logoOverride ?? manifest.logoFile;
+	let logoUpload;
+	if (localLogo) {
+		const logoPath = resolve(opts.cwd, localLogo);
+		if (!existsSync(logoPath)) throw new CliError(`logo file not found: ${logoPath}`, 4);
+		logoUpload = { source: localLogo };
+	} else if (manifest.logoUrl) meta.logo_url = manifest.logoUrl;
+	const screenshotSources = manifest.screenshots ?? [];
+	const screenshotPlan = screenshotSources.map((src) => {
+		const remote = isRemoteAsset(src);
+		if (!remote && !existsSync(resolve(opts.cwd, src))) throw new CliError(`screenshot file not found: ${resolve(opts.cwd, src)}`, 4);
+		return {
+			source: src,
+			remote
+		};
+	});
+	const localScreenshots = screenshotPlan.filter((s) => !s.remote);
+	const noop = Object.keys(meta).length === 0 && !logoUpload && screenshotSources.length === 0;
+	if (opts.dryRun || noop) {
+		if (screenshotSources.length > 0) meta.screenshots = screenshotSources;
+		return {
+			meta,
+			logoUpload,
+			screenshotUploads: localScreenshots.length > 0 ? localScreenshots.map((s) => ({ source: s.source })) : void 0,
+			noop
+		};
+	}
+	const screenshotUploads = [];
+	const finalScreenshots = [];
+	for (const item of screenshotPlan) {
+		if (item.remote) {
+			finalScreenshots.push(item.source);
+			continue;
+		}
+		const shotPath = resolve(opts.cwd, item.source);
+		const bytes = readFileSync(shotPath);
+		const blob = new Blob([new Uint8Array(bytes)], { type: imageContentType(shotPath) });
+		const res = await uploadAppScreenshot(client, appId, blob);
+		finalScreenshots.push(res.screenshot_url);
+		screenshotUploads.push({
+			source: item.source,
+			screenshot_url: res.screenshot_url
+		});
+	}
+	if (finalScreenshots.length > 0) meta.screenshots = finalScreenshots;
+	if (Object.keys(meta).length > 0) await patchApp(client, appId, meta);
+	if (logoUpload) {
+		const logoPath = resolve(opts.cwd, logoUpload.source);
+		const bytes = readFileSync(logoPath);
+		const blob = new Blob([new Uint8Array(bytes)], { type: imageContentType(logoPath) });
+		const res = await uploadAppLogo(client, appId, blob);
+		logoUpload.logo_url = res.logo_url;
+	}
+	return {
+		meta,
+		logoUpload,
+		screenshotUploads: screenshotUploads.length > 0 ? screenshotUploads : void 0,
+		noop
+	};
+}
+
+//#endregion
+export { syncAppListingMeta };

package/dist/{manifest-Bljz8Y6T.js → manifest-DOMrcdCK.js}

@@ -42,6 +42,7 @@ function loadAppManifest(cwd, manifestPath) {
 	const metadataRaw = appJsonRaw ?? raw;
 	const metadataLabel = hasAppJson ? "app.json" : "manifest.json";
 	const pickMeta = (k) => (appJsonRaw && pickString(appJsonRaw, k)) ?? pickString(raw, k);
+	const pickMetaArray = (k) => (appJsonRaw && pickStringArray(appJsonRaw, k)) ?? pickStringArray(raw, k);
 	const slug = pickMeta("slug");
 	const name = pickMeta("name") ?? slug ?? "";
 	const version = pickMeta("version") ?? "0.1.0";
@@ -63,7 +64,15 @@ function loadAppManifest(cwd, manifestPath) {
 		category: pickMeta("category"),
 		tagline: pickMeta("tagline"),
 		description: pickMeta("description"),
-		changelog: pickMeta("changelog")
+		changelog: pickMeta("changelog"),
+		logoUrl: pickMeta("logo_url"),
+		logoFile: pickMeta("logo_file"),
+		coverUrl: pickMeta("cover_url"),
+		screenshots: pickMetaArray("screenshots"),
+		homepageUrl: pickMeta("homepage_url"),
+		supportUrl: pickMeta("support_url"),
+		privacyUrl: pickMeta("privacy_url"),
+		pricingModel: pickMeta("pricing_model")
 	};
 }
 const HANDLE_RE = /^[a-z0-9][a-z0-9-]{0,62}$/;
@@ -242,6 +251,12 @@ function pickString(o, k) {
 	const v = o[k];
 	return typeof v === "string" ? v : void 0;
 }
+function pickStringArray(o, k) {
+	const v = o[k];
+	if (!Array.isArray(v)) return void 0;
+	const out = v.filter((x) => typeof x === "string");
+	return out.length > 0 ? out : void 0;
+}
 
 //#endregion
 export { loadAppManifest, loadExecutaManifest };

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

@@ -1,15 +1,16 @@
 import "./credentials-BTv2IfUZ.js";
-import "./apps-CCdtLmxQ.js";
+import "./apps-DlVsVHQ5.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-Ah6J7jYd.js";
+import "./manifest-DOMrcdCK.js";
+import "./app-cache-BqnTkxUw.js";
+import "./listing-meta-BlY7XMrw.js";
+import "./app-bundle-upload-CqT9KUOl.js";
+import { runAppsPublish } from "./apps-publish-BKqVsS1W.js";
 import { resolve } from "node:path";
 import { existsSync } from "node:fs";
 import { red, yellow } from "kleur/colors";

package/dist/{runner-BuYbm-ex.js → runner-BxYjAmih.js}

@@ -2,10 +2,16 @@ import { spawn } from "node:child_process";
 import { createInterface } from "node:readline";
 
 //#region src/executa/runner.ts
-/** Spec describing where the host advertises its capabilities. */
+/**
+* Host `initialize` request params. Mirrors the production matrix Agent
+* (`matrix/src/executa/loader.py::negotiate`), which sends camelCase
+* `clientInfo` + `capabilities`. The CLI advertises a richer capability
+* set because the dev runner also brokers agent/storage/image/upload
+* reverse RPCs.
+*/
 const HOST_INITIALIZE_PARAMS = {
 	protocolVersion: "2.0",
-	client_capabilities: {
+	capabilities: {
 		sampling: {},
 		agent: {},
 		storage: {},
@@ -13,7 +19,7 @@ const HOST_INITIALIZE_PARAMS = {
 		"image.edit": {},
 		upload: {}
 	},
-	client_info: {
+	clientInfo: {
 		name: "anna-app-cli",
 		version: "executa-dev"
 	}

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

@@ -1,5 +1,5 @@
 import { canonicalHost, getAccount } from "./credentials-BTv2IfUZ.js";
-import { BridgeRequestError } from "./bridge-DAY7bsje.js";
+import { BridgeRequestError } from "./bridge-CbjqAm0H.js";
 import { dirname, join, normalize, resolve } from "node:path";
 import { createRequire } from "node:module";
 import { createReadStream, existsSync, readFileSync, statSync, watch } from "node:fs";
@@ -128,7 +128,7 @@ var LlmBridge = class {
 	*  - ``aps``: the bridge claims storage and forwards to real nexus APS
 	*    via ``/api/v1/storage/*`` with a Bearer ``storage_token``. */
 	handles(ns, method) {
-		if (ns === "llm" && (method === "complete" || method === "embed")) return true;
+		if (ns === "llm" && (method === "complete" || method === "embed" || method === "stream")) return true;
 		if (ns === "agent" && method.startsWith("session.")) return true;
 		if (ns === "image" && (method === "generate" || method === "edit")) return true;
 		if (ns === "upload" && (method === "inline" || method === "negotiate" || method === "confirm")) return true;
@@ -140,7 +140,7 @@ var LlmBridge = class {
 	*  ``LlmBridge.handles(ns, method)`` without an instance. Returns the
 	*  legacy (no-storage) decision since options aren't available here. */
 	static handles(ns, method) {
-		if (ns === "llm" && (method === "complete" || method === "embed")) return true;
+		if (ns === "llm" && (method === "complete" || method === "embed" || method === "stream")) return true;
 		if (ns === "agent" && method.startsWith("session.")) return true;
 		if (ns === "image" && (method === "generate" || method === "edit")) return true;
 		if (ns === "upload" && (method === "inline" || method === "negotiate" || method === "confirm")) return true;
@@ -453,6 +453,25 @@ var LlmBridge = class {
 				result
 			};
 		}
+		if (args.ns === "llm" && args.method === "stream") {
+			const ms = await this.mintComplete(args.windowUuid);
+			const sid = `dev-${++this.streamCounter}`;
+			this.pumpCompleteStream({
+				host: acc.host,
+				token: ms.appSessionToken,
+				body: args.args,
+				streamId: sid,
+				windowUuid: args.windowUuid,
+				onEvent: args.onEvent
+			});
+			return {
+				ok: true,
+				result: {
+					stream_id: sid,
+					run_id: String(args.args.run_id ?? sid)
+				}
+			};
+		}
 		if (args.ns === "agent") switch (args.method) {
 			case "session.create": {
 				const ms = await this.mintAgent(args.args);
@@ -846,7 +865,24 @@ var LlmBridge = class {
 	}
 	/** Consume an SSE response and forward each frame as `rpc.stream`. */
 	async pumpAgentRun(args) {
-		const url = `${canonicalHost(args.host)}/api/v1/copilot/app/agent`;
+		await this.pumpSse({
+			...args,
+			url: `${canonicalHost(args.host)}/api/v1/copilot/app/agent`
+		});
+	}
+	/** L1 streaming: consume ``/app/complete/stream`` SSE and forward each
+	*  ``{event:"model_token"|"complete"}`` frame as ``rpc.stream`` (mirrors
+	*  ``pumpAgentRun``). */
+	async pumpCompleteStream(args) {
+		await this.pumpSse({
+			...args,
+			url: `${canonicalHost(args.host)}/api/v1/copilot/app/complete/stream`
+		});
+	}
+	/** Shared SSE→rpc.stream pump used by both L1 (`llm.stream`) and L2
+	*  (`agent.session.run`) — POSTs the body, reassembles `data:` frames,
+	*  and re-emits each as an ordered `rpc.stream` event. */
+	async pumpSse(args) {
 		let seq = 0;
 		const emit = (payload, done) => {
 			seq += 1;
@@ -859,7 +895,7 @@ var LlmBridge = class {
 			});
 		};
 		try {
-			const res = await fetch(url, {
+			const res = await fetch(args.url, {
 				method: "POST",
 				headers: {
 					"content-type": "application/json",
@@ -951,6 +987,187 @@ const MIME = {
 	".woff2": "font/woff2",
 	".map": "application/json"
 };
+function makeAppsStub() {
+	const catalog = [
+		{
+			id: 1,
+			slug: "finder",
+			qualified_ref: "@anna/finder",
+			name: "Finder",
+			tagline: "Browse, preview and curate APS storage.",
+			logo_url: null,
+			category: "utilities",
+			is_enabled: true,
+			installed_version: "0.0.1",
+			latest_version: "0.0.1",
+			update_available: false,
+			deck_pinned: true,
+			deck_order: 0
+		},
+		{
+			id: 2,
+			slug: "avalon",
+			qualified_ref: "@anna/avalon",
+			name: "Avalon",
+			tagline: "A 5-player social-deduction game.",
+			logo_url: null,
+			category: "game",
+			is_enabled: true,
+			installed_version: "0.0.1",
+			latest_version: "0.0.1",
+			update_available: false,
+			deck_pinned: false,
+			deck_order: null
+		},
+		{
+			id: 3,
+			slug: "apps",
+			qualified_ref: "@anna/apps",
+			name: "Apps",
+			tagline: "A Launchpad-style launcher for your installed apps.",
+			logo_url: null,
+			category: "utilities",
+			is_enabled: true,
+			installed_version: "0.0.1",
+			latest_version: "0.0.1",
+			update_available: false,
+			deck_pinned: true,
+			deck_order: 1
+		}
+	];
+	const resolve$1 = (ref) => {
+		if (typeof ref === "number") return catalog.find((a) => a.id === ref);
+		const s = String(ref ?? "").trim();
+		if (/^\d+$/.test(s)) return catalog.find((a) => a.id === Number(s));
+		return catalog.find((a) => a.qualified_ref === s || a.slug === s);
+	};
+	const deck = () => catalog.filter((a) => a.deck_pinned).sort((a, b) => (a.deck_order ?? 0) - (b.deck_order ?? 0));
+	const nextOrder = () => deck().reduce((m, a) => Math.max(m, a.deck_order ?? 0), -1) + 1;
+	const handle = (method, args) => {
+		switch (method) {
+			case "list": {
+				const q = String(args.search ?? args.query ?? "").trim().toLowerCase();
+				const items = q ? catalog.filter((a) => a.name.toLowerCase().includes(q) || a.slug.toLowerCase().includes(q) || a.tagline.toLowerCase().includes(q) || a.category.toLowerCase().includes(q)) : catalog;
+				return {
+					ok: true,
+					result: { items }
+				};
+			}
+			case "search": {
+				const q = String(args.query ?? args.search ?? "").trim().toLowerCase();
+				const items = catalog.filter((a) => a.name.toLowerCase().includes(q) || a.slug.toLowerCase().includes(q) || a.tagline.toLowerCase().includes(q));
+				return {
+					ok: true,
+					result: { items }
+				};
+			}
+			case "get": {
+				const hit = resolve$1(args.app_ref ?? args.app_id);
+				return hit ? {
+					ok: true,
+					result: hit
+				} : {
+					ok: false,
+					error: {
+						code: "app_not_installed",
+						message: "not installed"
+					}
+				};
+			}
+			case "launch": {
+				const hit = resolve$1(args.app_ref ?? args.app_id);
+				if (!hit) return {
+					ok: false,
+					error: {
+						code: "app_not_installed",
+						message: "not installed"
+					}
+				};
+				return {
+					ok: true,
+					result: {
+						window_uuid: `dev-win-${hit.slug}`,
+						app: {
+							id: hit.id,
+							slug: hit.slug,
+							name: hit.name
+						},
+						opened_new: true
+					}
+				};
+			}
+			case "deck.list": return {
+				ok: true,
+				result: { items: deck() }
+			};
+			case "deck.add": {
+				const hit = resolve$1(args.app_ref ?? args.app_id);
+				if (!hit) return {
+					ok: false,
+					error: {
+						code: "app_not_installed",
+						message: "not installed"
+					}
+				};
+				if (!hit.deck_pinned) {
+					hit.deck_pinned = true;
+					hit.deck_order = nextOrder();
+				}
+				return {
+					ok: true,
+					result: { items: deck() }
+				};
+			}
+			case "deck.remove": {
+				const hit = resolve$1(args.app_ref ?? args.app_id);
+				if (!hit) return {
+					ok: false,
+					error: {
+						code: "app_not_installed",
+						message: "not installed"
+					}
+				};
+				if (hit.deck_pinned) {
+					hit.deck_pinned = false;
+					hit.deck_order = null;
+				}
+				return {
+					ok: true,
+					result: { items: deck() }
+				};
+			}
+			case "deck.reorder": {
+				const ordered = args.ordered ?? args.app_refs;
+				if (!Array.isArray(ordered)) return {
+					ok: false,
+					error: {
+						code: "invalid_arg",
+						message: "ordered must be a list"
+					}
+				};
+				ordered.forEach((ref, i) => {
+					const hit = resolve$1(ref);
+					if (hit) {
+						hit.deck_pinned = true;
+						hit.deck_order = i;
+					}
+				});
+				return {
+					ok: true,
+					result: { items: deck() }
+				};
+			}
+			default: return {
+				ok: false,
+				error: {
+					code: "not_implemented",
+					message: `apps.${method} stub missing`
+				}
+			};
+		}
+	};
+	return { handle };
+}
 var HarnessServer = class {
 	server = createServer((req, res) => this.handle(req, res));
 	wss = null;
@@ -961,6 +1178,8 @@ var HarnessServer = class {
 	/** Pending events queued by the LLM bridge — drained alongside Python events. */
 	llmEventQueue = [];
 	llmBridge;
+	/** In-memory `apps.*` dev stub (Apps launcher). */
+	appsStub = makeAppsStub();
 	constructor(cfg, bridge) {
 		this.cfg = cfg;
 		this.bridge = bridge;
@@ -1242,6 +1461,11 @@ var HarnessServer = class {
 				}
 			});
 		}
+		if (parsed.ns === "apps") {
+			const out = this.appsStub.handle(parsed.method, parsed.args ?? {});
+			this.json(res, 200, out);
+			return;
+		}
 		if (this.llmBridge != null && this.llmBridge.handles(parsed.ns, parsed.method)) {
 			const out = await this.llmBridge.dispatch({
 				windowUuid: this.sessionId ?? "harness",

package/dist/{storage-CKTmE87u.js → storage-BkF4XyI0.js}

@@ -1,15 +1,15 @@
 import { canonicalHost } from "./credentials-BTv2IfUZ.js";
-import { hostOf, requireAccount, withCode } from "./dev-account-CGo8k9_2.js";
+import { hostOf, requireAccount, withCode } from "./dev-account-DqEFCmVg.js";
 import { resolve } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 
 //#region src/executa/storage.ts
 /** JSON-RPC error codes from matrix/src/executa/protocol.py. */
-const STORAGE_ERR_INVALID_REQUEST = -32020;
 const STORAGE_ERR_NOT_GRANTED = -32021;
 const STORAGE_ERR_NOT_FOUND = -32022;
 const STORAGE_ERR_PRECONDITION_FAILED = -32023;
-const STORAGE_ERR_UPSTREAM = -32026;
+const STORAGE_ERR_INVALID_REQUEST = -32028;
+const STORAGE_ERR_UPSTREAM = -32029;
 /** Method → (http_method, sub_path, payload_kind). Mirrors matrix/storage.py. */
 const ROUTING = {
 	"storage/get": [

package/dist/{token-Cg7BZGp6.js → token-uedeaAy7.js}

@@ -1,6 +1,6 @@
 import "./credentials-BTv2IfUZ.js";
 import "./client-D-_z1ALk.js";
-import { resolveClient, withErrorHandling } from "./_lifecycle-shared-BpSOfVCP.js";
+import { resolveClient, withErrorHandling } from "./_lifecycle-shared-CUK2CE76.js";
 import { bold, cyan, dim, green, red, yellow } from "kleur/colors";
 
 //#region src/api/tokens.ts

package/dist/{working-orchestration-Pjm4YC_U.js → working-orchestration-1jzRuk34.js}

@@ -1,11 +1,11 @@
 import { canonicalHost } from "./credentials-BTv2IfUZ.js";
-import { createApp, findAppBySlug, getApp } from "./apps-CCdtLmxQ.js";
+import { createApp, findAppBySlug, getApp } from "./apps-DlVsVHQ5.js";
 import { CliError } from "./client-D-_z1ALk.js";
-import { parseExecutaIdOverrides, readExecutasLock, substituteBundledRefs, validateBundledHandles, writeBundleToolIdSidecar, writeExecutasLock } from "./bundled-executas-B6b8gIfp.js";
-import { runExecutaPublish } from "./executa-publish-CkPAB34b.js";
-import { loadExecutaManifest } from "./manifest-Bljz8Y6T.js";
-import { runExecutaInstall } from "./executa-install-BHQpOskj.js";
-import { appCacheMatches, readAppIdentity, writeAppIdentity } from "./app-cache-Bl7cE5fm.js";
+import { parseExecutaIdOverrides, readExecutasLock, substituteBundledRefs, validateBundledHandles, writeBundleToolIdSidecar, writeExecutasLock } from "./bundled-executas-_H1A9M50.js";
+import { runExecutaPublish } from "./executa-publish-Ah6J7jYd.js";
+import { loadExecutaManifest } from "./manifest-DOMrcdCK.js";
+import { runExecutaInstall } from "./executa-install-BW9jjY7u.js";
+import { appCacheMatches, readAppIdentity, writeAppIdentity } from "./app-cache-BqnTkxUw.js";
 import { join, resolve } from "node:path";
 import { dim, green, yellow } from "kleur/colors";
 import { homedir } from "node:os";
@@ -174,24 +174,40 @@ async function resolveAppIdentity(params) {
 	const found = await findAppBySlug(client, manifest.slug);
 	let appId;
 	let serverSlug;
+	let serverHandle;
 	let firstPublish = false;
 	if (found) {
 		appId = found.id;
 		serverSlug = found.slug;
+		serverHandle = typeof found.handle === "string" ? found.handle : void 0;
 	} else {
 		if (dryRun) {
 			if (!json) console.log(yellow(`[dry-run] would create AnnaApp slug=${manifest.slug}`));
 			return null;
 		}
-		const created = await createApp(client, {
-			slug: manifest.slug,
-			name: manifest.name,
-			category: manifest.category,
-			tagline: manifest.tagline,
-			description: manifest.description
-		});
+		let created;
+		try {
+			created = await createApp(client, {
+				slug: manifest.slug,
+				name: manifest.name,
+				category: manifest.category,
+				tagline: manifest.tagline,
+				description: manifest.description
+			});
+		} catch (e) {
+			if (e instanceof CliError && e.status === 409) {
+				const body = e.body;
+				const code = body?.detail?.code;
+				if (code === "HANDLE_REQUIRED") throw new CliError("you must set a developer handle before creating an app.\n  Run:  anna-app account set-handle <handle>\n  Your apps will then publish as @<handle>/" + manifest.slug + ".", 5, {
+					status: 409,
+					body
+				});
+			}
+			throw e;
+		}
 		appId = created.id;
 		serverSlug = created.slug;
+		serverHandle = typeof created.handle === "string" ? created.handle : void 0;
 		firstPublish = true;
 	}
 	writeAppIdentity(cwd, {
@@ -199,6 +215,7 @@ async function resolveAppIdentity(params) {
 		host: canonicalHost(host),
 		app_id: appId,
 		slug: serverSlug,
+		handle: serverHandle,
 		first_published_at: cached?.first_published_at ?? new Date().toISOString()
 	});
 	return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anna-ai/cli",
-  "version": "0.1.29",
+  "version": "0.1.32",
   "description": "Anna App developer CLI: scaffold, validate, harness (Phase 2 MVP: init + validate).",
   "license": "MIT",
   "type": "module",
@@ -33,8 +33,8 @@
     "prepublishOnly": "pnpm lint && pnpm test && pnpm build && node scripts/check-runtime-pin.mjs && node scripts/check-sdk-pin.mjs"
   },
   "dependencies": {
-    "@anna-ai/app-runtime": "^0.8.0",
-    "@anna-ai/app-schema": "^0.10.0",
+    "@anna-ai/app-runtime": "^0.10.0",
+    "@anna-ai/app-schema": "^0.12.0",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "commander": "^12.1.0",

package/templates/executa/go/main.go

@@ -93,7 +93,7 @@ func dispatch(e envelope) {
 	case "describe":
 		result = manifest
 	case "health":
-		result = map[string]any{"status": "ok"}
+		result = map[string]any{"status": "ready"}
 	case "invoke":
 		var p struct {
 			Tool      string         `json:"tool"`

package/templates/executa/node/plugin.mjs

@@ -85,7 +85,7 @@ async function dispatch(env) {
     } else if (method === "describe") {
       result = MANIFEST;
     } else if (method === "health") {
-      result = { status: "ok" };
+      result = { status: "ready" };
     } else if (method === "invoke") {
       result = await invoke(params.tool, params.arguments ?? {});
     } else {

package/templates/executa/python/__SLUG_PY___plugin.py

@@ -119,7 +119,7 @@ def _dispatch(env: dict[str, Any]) -> None:
         elif method == "describe":
             result = MANIFEST
         elif method == "health":
-            result = {"status": "ok"}
+            result = {"status": "ready"}
         elif method == "invoke":
             params = env.get("params", {})
             result = invoke(params.get("tool", ""), params.get("arguments", {}))

package/templates/minimal/executas/__SLUG__/__SLUG_PY___plugin.py

@@ -40,7 +40,7 @@ def main() -> None:
             if req.get("method") == "describe":
                 result = MANIFEST
             elif req.get("method") == "health":
-                result = {"status": "ok"}
+                result = {"status": "ready"}
             elif req.get("method") == "invoke":
                 result = invoke(req["params"]["tool"], req["params"].get("arguments", {}))
             else: