@anna-ai/cli 0.1.28 → 0.1.29

package/dist/cli.js

@@ -592,8 +592,8 @@ 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("--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-Deo8ag5o.js");
+executa.command("dev").description("Run one Executa plugin in isolation (REPL or one-shot describe/invoke)").option("--dir <path>", "Executa project dir (default: CWD)").option("--spec <spec>", "Override discovery: comma-separated key=value (tool_id=...,type=...,command=\"...\")").option("--describe", "Print MANIFEST and exit", false).option("--health", "Print health and exit", false).option("--invoke <tool>", "Invoke one tool and exit").option("--args <json>", "JSON object passed as tool arguments", "{}").option("--json", "One-shot: emit compact JSON (no banners)", false).option("--no-sampling", "Hard-disable sampling reverse RPC (returns sampling_disabled)").option("--mock-sampling <fixture>", "Serve canned sampling responses from a JSONL fixture (offline)").option("--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 storageMode = opts.storage === void 0 ? void 0 : (() => {
 		const m = opts.storage;
 		if (m === "off" || m === "memory" || m === "mock" || m === "real") return m;
@@ -610,6 +610,7 @@ executa.command("dev").description("Run one Executa plugin in isolation (REPL or
 		json: opts.json,
 		noSampling: opts.sampling === false,
 		mockSampling: opts.mockSampling,
+		samplingUnsupportedFormat: opts.samplingUnsupportedFormat,
 		appSlug: opts.appSlug,
 		samplingAccount: opts.samplingAccount,
 		noAgent: opts.agent === false,

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

@@ -57,14 +57,17 @@ async function runExecutaDev(opts) {
 			}
 		}
 	}
-	const { SamplingBridge } = await import("./sampling-BcML4teS.js");
+	const { SamplingBridge } = await import("./sampling-DwV7VPfT.js");
+	const simulateUnsupportedResponseFormat = opts.samplingUnsupportedFormat;
 	const sampling = opts.noSampling ? new SamplingBridge({ mode: "off" }) : opts.mockSampling ? new SamplingBridge({
 		mode: "mock",
-		mockFile: opts.mockSampling
+		mockFile: opts.mockSampling,
+		simulateUnsupportedResponseFormat
 	}) : effectiveAppSlug ? new SamplingBridge({
 		mode: "real",
 		account: opts.samplingAccount,
-		appSlug: effectiveAppSlug
+		appSlug: effectiveAppSlug,
+		simulateUnsupportedResponseFormat
 	}) : new SamplingBridge({ mode: "off" });
 	const { AgentBridge } = await import("./agent-CaZVCPs6.js");
 	const agent = opts.noAgent ? new AgentBridge({ mode: "off" }) : opts.mockAgent ? new AgentBridge({

package/dist/{sampling-BcML4teS.js → sampling-DwV7VPfT.js}

@@ -20,8 +20,43 @@ var SamplingBridge = class {
 	}
 	async createMessage(req) {
 		if (this.opts.mode === "off") throw withCode(new Error("sampling disabled — rerun without `--no-sampling`"), -32008);
-		if (this.opts.mode === "mock") return this.mockMessage(req);
-		return this.realMessage(req);
+		validateResponseFormat(req);
+		const { effective, downgraded } = this.negotiateResponseFormat(req);
+		const result = this.opts.mode === "mock" ? this.mockMessage(req) : await this.realMessage(req, effective);
+		if (req.responseFormat) result._meta = {
+			...result._meta ?? {},
+			responseFormat: {
+				requested: req.responseFormat.type,
+				applied: effective?.type ?? null,
+				structuredValid: isParseableJson(result.content?.text),
+				downgraded
+			}
+		};
+		return result;
+	}
+	/**
+	* Local stand-in for the nexus gate's capability negotiation. With
+	* `simulateUnsupportedResponseFormat` the bridge behaves like a model
+	* without `supports_structured_output`; otherwise everything is
+	* "supported" (mock fixtures decide what comes back anyway).
+	*/
+	negotiateResponseFormat(req) {
+		let effective = req.responseFormat;
+		let downgraded = false;
+		if (effective?.type === "json_schema" && this.opts.simulateUnsupportedResponseFormat) {
+			const on = req.onUnsupported ?? "error";
+			if (on === "error") {
+				const err = withCode(new Error("model 'mock-model' does not support json_schema response format (simulated)"), -32010);
+				throw err;
+			}
+			if (on === "json_object") effective = { type: "json_object" };
+			else effective = void 0;
+			downgraded = true;
+		}
+		return {
+			effective,
+			downgraded
+		};
 	}
 	mockMessage(req) {
 		const content = collectContent(req);
@@ -69,10 +104,11 @@ var SamplingBridge = class {
 		};
 		return this.cachedSession;
 	}
-	async realMessage(req) {
+	async realMessage(req, effectiveResponseFormat) {
 		const acc = this.account();
 		const session = await this.mint();
 		const body = mcpToCompleteBody(req);
+		if (effectiveResponseFormat) body.response_format = effectiveResponseFormat;
 		const res = await fetch(`${canonicalHost(acc.host)}/api/v1/copilot/app/complete`, {
 			method: "POST",
 			headers: {
@@ -93,6 +129,59 @@ function withCode(err, code) {
 	err.rpcCode = code;
 	return err;
 }
+const RF_TYPES = new Set(["json_object", "json_schema"]);
+const RF_ON_UNSUPPORTED = new Set([
+	"error",
+	"json_object",
+	"text"
+]);
+const RF_MAX_SCHEMA_BYTES = 32 * 1024;
+const RF_MAX_SCHEMA_DEPTH = 8;
+const RF_MAX_SCHEMA_NODES = 512;
+const RF_NAME_RE = /^[a-zA-Z0-9_-]{1,64}$/;
+function invalid(message) {
+	return withCode(new Error(message), -32004);
+}
+/** Same hard limits the platform enforces — local dev fails identically. */
+function validateResponseFormat(req) {
+	const on = req.onUnsupported;
+	if (on != null && !RF_ON_UNSUPPORTED.has(on)) throw invalid(`'onUnsupported' must be one of ${[...RF_ON_UNSUPPORTED].sort().join(", ")}`);
+	const rf = req.responseFormat;
+	if (rf == null) return;
+	if (typeof rf !== "object" || Array.isArray(rf)) throw invalid("'responseFormat' must be an object");
+	if (!RF_TYPES.has(rf.type)) throw invalid(`responseFormat.type must be one of ${[...RF_TYPES].sort().join(", ")}`);
+	if (rf.type === "json_schema") {
+		const js = rf.json_schema;
+		if (js == null || typeof js !== "object" || Array.isArray(js)) throw invalid("responseFormat.json_schema must be an object");
+		if (typeof js.name !== "string" || !RF_NAME_RE.test(js.name)) throw invalid("json_schema.name must match ^[a-zA-Z0-9_-]{1,64}$");
+		if (js.strict !== void 0 && typeof js.strict !== "boolean") throw invalid("json_schema.strict must be a bool");
+		const schema = js.schema;
+		if (schema == null || typeof schema !== "object" || Array.isArray(schema)) throw invalid("json_schema.schema must be an object");
+		enforceSchemaLimits(schema);
+	}
+}
+function enforceSchemaLimits(schema) {
+	const raw = JSON.stringify(schema);
+	if (Buffer.byteLength(raw, "utf8") > RF_MAX_SCHEMA_BYTES) throw invalid(`json_schema.schema too large (> ${RF_MAX_SCHEMA_BYTES} bytes)`);
+	let nodes = 0;
+	const walk = (node, depth) => {
+		if (depth > RF_MAX_SCHEMA_DEPTH) throw invalid(`json_schema nesting too deep (> ${RF_MAX_SCHEMA_DEPTH})`);
+		nodes += 1;
+		if (nodes > RF_MAX_SCHEMA_NODES) throw invalid(`json_schema too many nodes (> ${RF_MAX_SCHEMA_NODES})`);
+		if (Array.isArray(node)) for (const v of node) walk(v, depth + 1);
+		else if (node !== null && typeof node === "object") for (const v of Object.values(node)) walk(v, depth + 1);
+	};
+	walk(schema, 0);
+}
+function isParseableJson(text) {
+	if (typeof text !== "string") return false;
+	try {
+		JSON.parse(text);
+		return true;
+	} catch {
+		return false;
+	}
+}
 /** Collect a single string view of a sampling request — used for mock matching. */
 function collectContent(req) {
 	const parts = [];

package/package.json

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