@anna-ai/cli 0.1.19 → 0.1.21

package/dist/apps-release-BLH9XSxB.js

@@ -0,0 +1,135 @@
+import { canonicalHost } from "./credentials-BTv2IfUZ.js";
+import { findAppBySlug, getApp, getBundle, listVersions, publishVersion } from "./apps-B1Nd8l_t.js";
+import { CliError } from "./client-Dn9zThOd.js";
+import { resolveClient, withErrorHandling } from "./_lifecycle-shared-sbea9HtH.js";
+import { readAppIdentity } from "./app-cache-BEM653Th.js";
+import { resolve } from "node:path";
+import { bold, cyan, dim, green, yellow } from "kleur/colors";
+
+//#region src/commands/apps-release.ts
+/** Resolve the target app via `--slug` or the local `.anna/app.json` cache. */
+async function resolveApp(client, host, opts) {
+	if (opts.slug) {
+		const app = await findAppBySlug(client, opts.slug);
+		if (!app) throw new CliError(`no app with slug "${opts.slug}" on ${host}`, 5);
+		return getApp(client, app.id);
+	}
+	const cwd = resolve(opts.cwd ?? process.cwd());
+	const cached = readAppIdentity(cwd);
+	if (cached && cached.host === canonicalHost(host)) try {
+		return await getApp(client, cached.app_id);
+	} catch (e) {
+		if (e instanceof CliError && e.status === 404) {
+			const app = await findAppBySlug(client, cached.slug);
+			if (app) return getApp(client, app.id);
+		} else throw e;
+	}
+	throw new CliError("cannot resolve app — pass --slug <slug> or run from a project dir with a .anna/app.json cache (run 'anna-app apps publish' first)", 5);
+}
+/** Does this version declare a UI bundle in its frozen manifest? */
+function declaresUiBundle(version) {
+	const entry = version.manifest?.ui?.bundle?.entry;
+	return typeof entry === "string" && entry.length > 0;
+}
+function statusGuard(app) {
+	if (app.status === "APPROVED" || app.status === "PUBLISHED") return;
+	let hint;
+	switch (app.status) {
+		case "DRAFT":
+		case "REJECTED":
+			hint = "submit for review first: `anna-app apps submit-review`";
+			break;
+		case "PENDING_REVIEW":
+			hint = "awaiting admin approval — cannot release until APPROVED";
+			break;
+		case "ARCHIVED":
+			hint = "app is archived; restore it first: `anna-app apps unarchive`";
+			break;
+		default: hint = "app must be APPROVED or PUBLISHED to release";
+	}
+	throw new CliError(`app status is ${app.status}; release not permitted — ${hint}`, 6);
+}
+async function runAppsRelease(opts) {
+	return withErrorHandling(async () => {
+		const { client, host } = resolveClient({ account: opts.account });
+		let app = await resolveApp(client, host, opts);
+		let versions = await listVersions(client, app.id);
+		let target = versions.find((v) => v.version === opts.version);
+		if (!target) {
+			if (opts.allowCreate) {
+				if (!opts.json) console.log(yellow(`version ${opts.version} not found remotely; running 'apps publish' first (--allow-create)…`));
+				const { runAppsPublish } = await import("./apps-publish-DfZTOxBJ.js");
+				const code = await runAppsPublish({
+					cwd: opts.cwd,
+					account: opts.account,
+					json: opts.json
+				});
+				if (code !== 0) return code;
+				app = await getApp(client, app.id);
+				versions = await listVersions(client, app.id);
+				target = versions.find((v) => v.version === opts.version);
+			}
+			if (!target) throw new CliError(`no version ${opts.version} for app "${app.slug}" on ${host} — run 'anna-app apps publish' first`, 5);
+		}
+		if (declaresUiBundle(target)) {
+			const bundle = await getBundle(client, app.id, target.id);
+			if (!bundle || bundle.status !== "bundle_ready") throw new CliError(`version ${opts.version} declares a UI bundle but it is not finalized (status=${bundle?.status ?? "missing"}) — re-run 'anna-app apps publish'`, 4);
+		}
+		statusGuard(app);
+		if (target.is_latest && app.status === "PUBLISHED") {
+			if (opts.json) {
+				console.log(JSON.stringify({
+					host,
+					app_id: app.id,
+					slug: app.slug,
+					version: target.version,
+					version_id: target.id,
+					is_latest: true,
+					published_at: target.published_at ?? null,
+					status: app.status,
+					already_live: true
+				}, null, 2));
+				return 0;
+			}
+			console.log(green(`✓ apps/${app.slug}: version ${target.version} already live`) + dim(` (no-op)`));
+			return 0;
+		}
+		if (opts.dryRun) {
+			if (opts.json) {
+				console.log(JSON.stringify({
+					host,
+					app_id: app.id,
+					slug: app.slug,
+					version: target.version,
+					version_id: target.id,
+					current_status: app.status,
+					dry_run: true
+				}, null, 2));
+				return 0;
+			}
+			console.log(yellow(`[dry-run] would release apps/${app.slug} version ${target.version} (id=${target.id}, current status=${app.status})`));
+			return 0;
+		}
+		const released = await publishVersion(client, app.id, target.id);
+		const finalApp = await getApp(client, app.id);
+		if (opts.json) {
+			console.log(JSON.stringify({
+				host,
+				app_id: app.id,
+				slug: app.slug,
+				version: released.version,
+				version_id: released.id,
+				is_latest: released.is_latest ?? true,
+				published_at: released.published_at ?? null,
+				status: finalApp.status
+			}, null, 2));
+			return 0;
+		}
+		console.log(green(`✓ apps/${app.slug}: released version ${released.version}`) + dim(` (id=${released.id})`));
+		console.log(bold(cyan(`status: ${finalApp.status}`)) + " — now live in the store");
+		return 0;
+	});
+}
+
+//#endregion
+export { runAppsRelease };

package/dist/apps-status-DQ9RvlME.js

@@ -0,0 +1,58 @@
+import "./credentials-BTv2IfUZ.js";
+import { findAppBySlug, getApp, listVersions } from "./apps-B1Nd8l_t.js";
+import { CliError } from "./client-Dn9zThOd.js";
+import { resolveClient, withErrorHandling } from "./_lifecycle-shared-sbea9HtH.js";
+import { bold, cyan, dim, green, red, yellow } from "kleur/colors";
+
+//#region src/commands/apps-status.ts
+async function runAppsStatus(opts) {
+	return withErrorHandling(async () => {
+		const { client, host } = resolveClient({ account: opts.account });
+		const app = await findAppBySlug(client, opts.slug);
+		if (!app) throw new CliError(`no app with slug "${opts.slug}" on ${host}`, 5);
+		const full = await getApp(client, app.id);
+		const versions = await listVersions(client, app.id);
+		const latest = versions.find((v) => v.is_latest) ?? versions[0] ?? null;
+		if (opts.json) {
+			console.log(JSON.stringify({
+				host,
+				app_id: full.id,
+				slug: full.slug,
+				name: full.name,
+				status: full.status,
+				visibility: full.visibility ?? null,
+				is_published: full.is_published ?? false,
+				review_message: full.review_message ?? null,
+				latest_version: latest ? {
+					id: latest.id,
+					version: latest.version,
+					published_at: latest.published_at,
+					is_latest: latest.is_latest ?? null
+				} : null,
+				version_count: versions.length
+			}, null, 2));
+			return 0;
+		}
+		console.log(bold(cyan(`apps/${full.slug}`)) + " " + dim(`(${host})`));
+		console.log(`  ${dim("name      :")} ${full.name}`);
+		console.log(`  ${dim("app_id    :")} ${full.id}`);
+		console.log(`  ${dim("status    :")} ${colorStatus(full.status)}` + (full.is_published ? " " + green("[published]") : ""));
+		if (latest) console.log(`  ${dim("latest    :")} v${latest.version} (id=${latest.id}, published=${latest.published_at ?? "—"})`);
+		else console.log(`  ${dim("latest    :")} ${dim("(no versions yet)")}`);
+		if (full.review_message) console.log(`  ${dim("reviewer  :")} ${full.review_message}`);
+		console.log(`  ${dim("versions  :")} ${versions.length} total`);
+		return 0;
+	});
+}
+function colorStatus(s) {
+	switch (s) {
+		case "PUBLISHED": return green(s);
+		case "PENDING_REVIEW": return yellow(s);
+		case "REJECTED": return red(s);
+		case "ARCHIVED": return dim(s);
+		default: return s;
+	}
+}
+
+//#endregion
+export { runAppsStatus };

package/dist/apps-submit-review-DLwCxeAs.js

@@ -0,0 +1,45 @@
+import { canonicalHost } from "./credentials-BTv2IfUZ.js";
+import { findAppBySlug, getApp, submitForReview } from "./apps-B1Nd8l_t.js";
+import { CliError } from "./client-Dn9zThOd.js";
+import { resolveClient, withErrorHandling } from "./_lifecycle-shared-sbea9HtH.js";
+import { readAppIdentity } from "./app-cache-BEM653Th.js";
+import { resolve } from "node:path";
+import { bold, cyan, green } from "kleur/colors";
+
+//#region src/commands/apps-submit-review.ts
+async function runAppsSubmitReview(opts) {
+	return withErrorHandling(async () => {
+		const { client, host } = resolveClient({ account: opts.account });
+		let appId;
+		let serverSlug;
+		if (opts.slug) {
+			const found = await findAppBySlug(client, opts.slug);
+			if (!found) throw new CliError(`no app with slug "${opts.slug}" on ${host}`, 5);
+			appId = found.id;
+			serverSlug = found.slug;
+		} else {
+			const cwd = resolve(opts.cwd ?? process.cwd());
+			const cached = readAppIdentity(cwd);
+			if (!cached || cached.host !== canonicalHost(host)) throw new CliError("cannot resolve app — pass a <slug> or run from a project dir with a .anna/app.json cache", 5);
+			appId = cached.app_id;
+			serverSlug = cached.slug;
+		}
+		const app = await submitForReview(client, appId);
+		const finalApp = await getApp(client, appId);
+		if (opts.json) {
+			console.log(JSON.stringify({
+				host,
+				app_id: appId,
+				slug: serverSlug,
+				status: finalApp.status
+			}, null, 2));
+			return 0;
+		}
+		console.log(green(`✓ apps/${serverSlug}: submitted for review`));
+		console.log(bold(cyan(`status: ${app.status ?? finalApp.status}`)));
+		return 0;
+	});
+}
+
+//#endregion
+export { runAppsSubmitReview };

package/dist/apps-sync-meta-D9eKMMUp.js

@@ -0,0 +1,72 @@
+import { canonicalHost } from "./credentials-BTv2IfUZ.js";
+import { findAppBySlug, getApp, patchApp } from "./apps-B1Nd8l_t.js";
+import { CliError } from "./client-Dn9zThOd.js";
+import { loadAppManifest } from "./manifest-DGwRap2i.js";
+import { resolveClient, withErrorHandling } from "./_lifecycle-shared-sbea9HtH.js";
+import { readAppIdentity } from "./app-cache-BEM653Th.js";
+import { resolve } from "node:path";
+import { bold, cyan, dim, green } from "kleur/colors";
+
+//#region src/commands/apps-sync-meta.ts
+async function runAppsSyncMeta(opts) {
+	return withErrorHandling(async () => {
+		const cwd = resolve(opts.cwd ?? process.cwd());
+		const manifest = loadAppManifest(cwd, opts.manifest);
+		const { client, host } = resolveClient({ account: opts.account });
+		let appId = null;
+		let serverSlug = manifest.slug;
+		const cached = readAppIdentity(cwd);
+		if (cached && cached.host === canonicalHost(host) && cached.slug === manifest.slug) {
+			appId = cached.app_id;
+			serverSlug = cached.slug;
+		} else {
+			const found = await findAppBySlug(client, manifest.slug);
+			if (found) {
+				appId = found.id;
+				serverSlug = found.slug;
+			}
+		}
+		if (appId === null) throw new CliError(`no app with slug "${manifest.slug}" on ${host} — run 'anna-app apps publish' first`, 5);
+		const meta = {
+			name: manifest.name,
+			category: manifest.category,
+			tagline: manifest.tagline,
+			description: manifest.description
+		};
+		if (opts.dryRun) {
+			if (opts.json) {
+				console.log(JSON.stringify({
+					host,
+					app_id: appId,
+					slug: serverSlug,
+					meta,
+					dry_run: true
+				}, null, 2));
+				return 0;
+			}
+			console.log(`[dry-run] would PATCH apps/${serverSlug} metadata: ` + JSON.stringify(meta));
+			return 0;
+		}
+		await patchApp(client, appId, meta);
+		const finalApp = await getApp(client, appId);
+		if (opts.json) {
+			console.log(JSON.stringify({
+				host,
+				app_id: appId,
+				slug: serverSlug,
+				meta,
+				status: finalApp.status
+			}, null, 2));
+			return 0;
+		}
+		console.log(green(`✓ apps/${serverSlug}: metadata synced`));
+		console.log(`  ${dim("name     :")} ${manifest.name}`);
+		if (manifest.category) console.log(`  ${dim("category :")} ${manifest.category}`);
+		if (manifest.tagline) console.log(`  ${dim("tagline  :")} ${manifest.tagline}`);
+		console.log(bold(cyan(`status: ${finalApp.status}`)));
+		return 0;
+	});
+}
+
+//#endregion
+export { runAppsSyncMeta };

package/dist/apps-versions-2Tmk0nsx.js

@@ -0,0 +1,43 @@
+import "./credentials-BTv2IfUZ.js";
+import { findAppBySlug, listVersions } from "./apps-B1Nd8l_t.js";
+import { CliError } from "./client-Dn9zThOd.js";
+import { resolveClient, withErrorHandling } from "./_lifecycle-shared-sbea9HtH.js";
+import { bold, cyan, dim, green } from "kleur/colors";
+
+//#region src/commands/apps-versions.ts
+async function runAppsVersions(opts) {
+	return withErrorHandling(async () => {
+		const { client, host } = resolveClient({ account: opts.account });
+		const app = await findAppBySlug(client, opts.slug);
+		if (!app) throw new CliError(`no app with slug "${opts.slug}" on ${host}`, 5);
+		const versions = await listVersions(client, app.id);
+		if (opts.json) {
+			console.log(JSON.stringify({
+				host,
+				app_id: app.id,
+				slug: app.slug,
+				versions: versions.map((v) => ({
+					id: v.id,
+					version: v.version,
+					is_latest: v.is_latest ?? false,
+					published_at: v.published_at ?? null,
+					created_at: v.created_at ?? null
+				}))
+			}, null, 2));
+			return 0;
+		}
+		console.log(bold(cyan(`apps/${app.slug}`)) + " " + dim(`versions (${versions.length})`));
+		if (versions.length === 0) {
+			console.log(dim("  (none)"));
+			return 0;
+		}
+		for (const v of versions) {
+			const tag = v.is_latest ? green("[latest]") : dim("        ");
+			console.log(`  ${tag} v${v.version} ${dim(`(id=${v.id}, published=${v.published_at ?? "—"})`)}`);
+		}
+		return 0;
+	});
+}
+
+//#endregion
+export { runAppsVersions };

package/dist/bridge-Id8K8gr-.js

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

package/dist/bundled-executas-BNOKw4kv.js

@@ -0,0 +1,161 @@
+import { canonicalHost } from "./credentials-BTv2IfUZ.js";
+import { CliError } from "./client-Dn9zThOd.js";
+import { dirname, resolve } from "node:path";
+import { existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+
+//#region src/publish/bundled-executas.ts
+const BUNDLED_PREFIX = "bundled:";
+const LOCK_DIR = ".anna";
+const LOCK_FILE = "executas.lock.json";
+/** Parse repeated `--executa-id handle=tool-id` flags. */
+function parseExecutaIdOverrides(raw) {
+	if (!raw || raw.length === 0) return [];
+	return raw.map((entry) => {
+		const eq = entry.indexOf("=");
+		if (eq <= 0) throw new CliError(`--executa-id must be in the form handle=tool-id (got "${entry}")`, 2);
+		const handle = entry.slice(0, eq).trim();
+		const toolId = entry.slice(eq + 1).trim();
+		if (!handle || !toolId) throw new CliError(`--executa-id must be in the form handle=tool-id (got "${entry}")`, 2);
+		return {
+			handle,
+			toolId
+		};
+	});
+}
+function lockPath(cwd) {
+	return resolve(cwd, LOCK_DIR, LOCK_FILE);
+}
+function readExecutasLock(cwd, host) {
+	const p = lockPath(cwd);
+	if (!existsSync(p)) return null;
+	try {
+		const raw = JSON.parse(readFileSync(p, "utf-8"));
+		if (raw.executas && typeof raw.executas === "object" && typeof raw.host === "string" && canonicalHost(raw.host) === canonicalHost(host)) return {
+			$schema: "anna-executas-lock/v1",
+			host: canonicalHost(raw.host),
+			executas: raw.executas
+		};
+	} catch {}
+	return null;
+}
+function writeExecutasLock(cwd, lock) {
+	const p = lockPath(cwd);
+	mkdirSync(dirname(p), { recursive: true });
+	const tmp = `${p}.tmp.${process.pid}`;
+	writeFileSync(tmp, JSON.stringify({
+		...lock,
+		host: canonicalHost(lock.host)
+	}, null, 2) + "\n", "utf-8");
+	try {
+		renameSync(tmp, p);
+	} catch (e) {
+		try {
+			unlinkSync(tmp);
+		} catch {}
+		throw e;
+	}
+}
+/**
+* Walk a JSON value and collect every `bundled:<handle>` token found in
+* a string. Tokens can be bare (`bundled:foo`) or prefixed
+* (`required:bundled:foo`, `optional:bundled:foo`).
+*/
+function collectBundledHandles(value, out) {
+	if (typeof value === "string") {
+		const h = extractHandle(value);
+		if (h) out.add(h);
+		return;
+	}
+	if (Array.isArray(value)) {
+		for (const v of value) collectBundledHandles(v, out);
+		return;
+	}
+	if (value && typeof value === "object") for (const v of Object.values(value)) collectBundledHandles(v, out);
+}
+function extractHandle(s) {
+	let body = s;
+	if (body.startsWith("required:")) body = body.slice(9);
+	else if (body.startsWith("optional:")) body = body.slice(9);
+	if (body.startsWith(BUNDLED_PREFIX)) return body.slice(BUNDLED_PREFIX.length);
+	return null;
+}
+/**
+* Return a deep copy of `value` with every `bundled:<handle>` token
+* replaced by the resolved tool_id (preserving any required:/optional:
+* prefix).
+*/
+function substituteBundledRefs(value, resolved) {
+	if (typeof value === "string") return substituteString(value, resolved);
+	if (Array.isArray(value)) return value.map((v) => substituteBundledRefs(v, resolved));
+	if (value && typeof value === "object") {
+		const out = {};
+		for (const [k, v] of Object.entries(value)) out[k] = substituteBundledRefs(v, resolved);
+		return out;
+	}
+	return value;
+}
+function substituteString(s, resolved) {
+	let prefix = "";
+	let body = s;
+	if (body.startsWith("required:")) {
+		prefix = "required:";
+		body = body.slice(prefix.length);
+	} else if (body.startsWith("optional:")) {
+		prefix = "optional:";
+		body = body.slice(prefix.length);
+	}
+	if (body.startsWith(BUNDLED_PREFIX)) {
+		const handle = body.slice(BUNDLED_PREFIX.length);
+		const id = resolved[handle];
+		if (!id) throw new CliError(`unresolved bundled handle "${handle}"`, 4);
+		return prefix + id;
+	}
+	return s;
+}
+/**
+* Write the Option-A sidecar `<bundleDir>/anna-tool-ids.js`.
+*
+* The bundle can read it via:
+*
+*     <script src="anna-tool-ids.js"></script>
+*     const TOOL_ID = window.__ANNA_TOOL_IDS__["focus-session"];
+*/
+function writeBundleToolIdSidecar(bundleDir, resolved) {
+	const file = resolve(bundleDir, "anna-tool-ids.js");
+	const body = "/* AUTO-GENERATED by `anna-app apps publish`. Do not edit. */\n/* Maps local bundled_executas handles → server-minted tool_ids. */\nwindow.__ANNA_TOOL_IDS__ = " + JSON.stringify(resolved, null, 2) + ";\n";
+	mkdirSync(bundleDir, { recursive: true });
+	const tmp = `${file}.tmp.${process.pid}`;
+	writeFileSync(tmp, body, "utf-8");
+	try {
+		renameSync(tmp, file);
+	} catch (e) {
+		try {
+			unlinkSync(tmp);
+		} catch {}
+		throw e;
+	}
+	return file;
+}
+/**
+* Validate that the declared `bundled_executas` map, the `bundled:`
+* tokens used in the manifest, and any `--executa-id` overrides are
+* mutually consistent.
+*
+* - Every `bundled:<handle>` token referenced in the manifest must have
+*   a matching entry in `bundled_executas` OR a `--executa-id` override.
+* - Every override handle must be referenced or declared (typo guard).
+*/
+function validateBundledHandles(manifestRaw, declared, overrides) {
+	const referenced = new Set();
+	collectBundledHandles(manifestRaw, referenced);
+	const declaredHandles = new Set(declared.map((d) => d.handle));
+	const overrideHandles = new Set(overrides.map((o) => o.handle));
+	const unresolvable = [];
+	for (const h of referenced) if (!declaredHandles.has(h) && !overrideHandles.has(h)) unresolvable.push(h);
+	if (unresolvable.length > 0) throw new CliError(`manifest references bundled:${unresolvable.sort().join(", bundled:")} but no matching app.json bundled_executas entry or --executa-id override was found`, 4);
+	for (const h of overrideHandles) if (!referenced.has(h) && !declaredHandles.has(h)) throw new CliError(`--executa-id "${h}=…" does not match any bundled:${h} reference or app.json bundled_executas entry (typo?)`, 2);
+	return { referenced };
+}
+
+//#endregion
+export { collectBundledHandles, lockPath, parseExecutaIdOverrides, readExecutasLock, substituteBundledRefs, validateBundledHandles, writeBundleToolIdSidecar, writeExecutasLock };

package/dist/bundled-executas-CNaV2C_O.js

@@ -0,0 +1,5 @@
+import "./credentials-BTv2IfUZ.js";
+import "./client-Dn9zThOd.js";
+import { collectBundledHandles, lockPath, parseExecutaIdOverrides, readExecutasLock, substituteBundledRefs, validateBundledHandles, writeBundleToolIdSidecar, writeExecutasLock } from "./bundled-executas-BNOKw4kv.js";
+
+export { substituteBundledRefs, writeBundleToolIdSidecar };