@rivus/agent 0.14.4 → 0.15.0

package/dist/chunks/rivus-model-management-wire.js

@@ -0,0 +1,344 @@
+//#region src/adapters/cli/model/rivus-model-cli-protocol.ts
+const RIVUS_MODEL_CLI_USAGE = `Usage:
+  rivus model status --json [--request <id>] [--verbose]
+  rivus model set --model <provider/model> --expected-revision <n> --request <id> --json [--verbose]
+  rivus model rollback --expected-revision <n> --request <id> --json [--verbose]
+
+Commands:
+  status    Read the effective and persistent model selection
+  set       Submit one authorized model change
+  rollback  Submit one authorized change to the previous model
+
+All command results are JSON. A successful set or rollback call means the request
+was accepted; query status by request id for the final outcome.
+`;
+function parseRivusModelCliArguments(argv) {
+	if (argv.includes("--help") || argv.includes("-h")) return { help: true };
+	const operation = argv[0];
+	if (operation !== "status" && operation !== "set" && operation !== "rollback") return { error: "model requires one of status, set, rollback" };
+	let expectedRevision;
+	let json = false;
+	let model;
+	let requestId;
+	let verbose = false;
+	for (let index = 1; index < argv.length; index += 1) {
+		const argument = argv[index];
+		if (argument === "--json") {
+			if (json) return { error: "--json may only be provided once" };
+			json = true;
+			continue;
+		}
+		if (argument === "--verbose") {
+			if (verbose) return { error: "--verbose may only be provided once" };
+			verbose = true;
+			continue;
+		}
+		if (argument === "--request") {
+			if (requestId !== void 0) return { error: "--request may only be provided once" };
+			const value = argv[index + 1];
+			if (!value || value.startsWith("-")) return { error: "--request requires an id" };
+			requestId = value;
+			index += 1;
+			continue;
+		}
+		if (argument.startsWith("--request=")) {
+			if (requestId !== void 0) return { error: "--request may only be provided once" };
+			requestId = argument.slice(10);
+			if (!requestId) return { error: "--request requires an id" };
+			continue;
+		}
+		if (argument === "--expected-revision") {
+			if (expectedRevision !== void 0) return { error: "--expected-revision may only be provided once" };
+			const value = argv[index + 1];
+			if (!value || value.startsWith("-")) return { error: "--expected-revision requires a non-negative integer" };
+			const parsed = parseRevision(value);
+			if (parsed === void 0) return { error: "--expected-revision requires a non-negative integer" };
+			expectedRevision = parsed;
+			index += 1;
+			continue;
+		}
+		if (argument.startsWith("--expected-revision=")) {
+			if (expectedRevision !== void 0) return { error: "--expected-revision may only be provided once" };
+			const parsed = parseRevision(argument.slice(20));
+			if (parsed === void 0) return { error: "--expected-revision requires a non-negative integer" };
+			expectedRevision = parsed;
+			continue;
+		}
+		if (argument === "--model") {
+			if (model !== void 0) return { error: "--model may only be provided once" };
+			const value = argv[index + 1];
+			if (!value || value.startsWith("-")) return { error: "--model requires provider/model" };
+			if (!isModelReference(value)) return { error: "--model must be provider/model" };
+			model = value;
+			index += 1;
+			continue;
+		}
+		if (argument.startsWith("--model=")) {
+			if (model !== void 0) return { error: "--model may only be provided once" };
+			const value = argument.slice(8);
+			if (!isModelReference(value)) return { error: "--model must be provider/model" };
+			model = value;
+			continue;
+		}
+		return { error: `Unknown model option: ${argument}` };
+	}
+	if (!json) return { error: "model commands require --json" };
+	if (operation === "status") {
+		if (model !== void 0) return { error: "status does not accept --model" };
+		if (expectedRevision !== void 0) return { error: "status does not accept --expected-revision" };
+		return {
+			json: true,
+			operation,
+			...requestId !== void 0 ? { requestId } : {},
+			...verbose ? { verbose: true } : {}
+		};
+	}
+	if (requestId === void 0) return { error: "--request is required for model changes" };
+	if (expectedRevision === void 0) return { error: "--expected-revision is required for model changes" };
+	if (operation === "set" && model === void 0) return { error: "--model is required for model set" };
+	if (operation === "rollback" && model !== void 0) return { error: "rollback does not accept --model" };
+	return operation === "set" ? {
+		expectedRevision,
+		json: true,
+		model,
+		operation,
+		requestId,
+		...verbose ? { verbose: true } : {}
+	} : {
+		expectedRevision,
+		json: true,
+		operation,
+		requestId,
+		...verbose ? { verbose: true } : {}
+	};
+}
+function renderRivusModelCliHelp() {
+	return RIVUS_MODEL_CLI_USAGE;
+}
+function renderRivusModelCliArgumentError(error) {
+	return `${error}\n\n${RIVUS_MODEL_CLI_USAGE}`;
+}
+function isModelReference(value) {
+	return /^[^/\s]+\/[^/\s]+$/.test(value);
+}
+function parseRevision(value) {
+	if (!/^\d+$/.test(value)) return void 0;
+	const revision = Number(value);
+	return Number.isSafeInteger(revision) ? revision : void 0;
+}
+//#endregion
+//#region src/adapters/cli/model/rivus-model-management-wire.ts
+function createRivusModelManagementWireRequest(command, env) {
+	const context = optionalString(env.RIVUS_MODEL_CONTEXT);
+	return {
+		...command,
+		...context ? { context } : {}
+	};
+}
+function parseRivusModelManagementWireRequest(value) {
+	if (!isRecord(value)) throw new Error("model request must be a JSON object");
+	const operation = value.operation;
+	if (operation !== "status" && operation !== "set" && operation !== "rollback") throw new Error("model request operation is invalid");
+	const context = optionalString(value.context);
+	const requestId = optionalString(value.requestId);
+	const verbose = value.verbose === true ? true : void 0;
+	if (operation === "status") {
+		if (value.json !== true) throw new Error("model request must require JSON output");
+		return {
+			json: true,
+			operation,
+			...context ? { context } : {},
+			...requestId ? { requestId } : {},
+			...verbose ? { verbose: true } : {}
+		};
+	}
+	const expectedRevision = value.expectedRevision;
+	if (value.json !== true || typeof expectedRevision !== "number" || !Number.isSafeInteger(expectedRevision) || expectedRevision < 0) throw new Error("model request has an invalid expected revision or output mode");
+	if (!requestId) throw new Error("model request requires a request id");
+	if (operation === "set") {
+		const model = optionalString(value.model);
+		if (!model || !/^[^/\s]+\/[^/\s]+$/.test(model)) throw new Error("model request target is invalid");
+		return {
+			expectedRevision,
+			json: true,
+			model,
+			operation,
+			requestId,
+			...context ? { context } : {},
+			...verbose ? { verbose: true } : {}
+		};
+	}
+	return {
+		expectedRevision,
+		json: true,
+		operation,
+		requestId,
+		...context ? { context } : {},
+		...verbose ? { verbose: true } : {}
+	};
+}
+function toRivusModelManagementSubmission(request) {
+	const target = request.operation === "set" ? parseTarget(request.model) : void 0;
+	return {
+		expectedRevision: request.expectedRevision,
+		operation: request.operation,
+		requestId: request.requestId,
+		...target ? { target } : {},
+		...request.verbose ? { verbose: true } : {}
+	};
+}
+function projectRivusModelCliResponse(value, operation) {
+	if (!isRecord(value)) throw new Error("model handler must return a JSON object");
+	const response = { schemaVersion: 1 };
+	copyScalar(response, value, "requestId");
+	copyScalar(response, value, "revision");
+	copyScalar(response, value, "source");
+	copyScalar(response, value, "protocolVersion");
+	copyScalar(response, value, "runtimeVersion");
+	copyScalar(response, value, "operation");
+	copyScalar(response, value, "expectedRevision");
+	copyScalar(response, value, "phase");
+	copyScalar(response, value, "reason");
+	for (const key of [
+		"actual",
+		"current",
+		"persisted",
+		"previous",
+		"target"
+	]) {
+		const model = projectModelReference(value[key]);
+		if (model) response[key] = model;
+	}
+	const budget = projectBudget(value.budget);
+	if (budget) response.budget = budget;
+	const pending = projectPending(value.pending);
+	if (pending) response.pending = pending;
+	const request = projectReceipt(value.request);
+	if (request) response.request = request;
+	const error = projectError(value.error);
+	if (error) response.error = error;
+	const recoveryRequired = projectError(value.recoveryRequired);
+	if (recoveryRequired) response.recoveryRequired = recoveryRequired;
+	const notification = projectNotification(value.notification);
+	if (notification) response.notification = notification;
+	const status = value.status;
+	response.status = isPublicStatus(status) ? status : value.recoveryRequired !== void 0 ? "recovery-required" : operation === "status" && value.pending !== void 0 ? "pending" : operation === "status" ? "applied" : "failed";
+	return response;
+}
+function createRivusModelManagementFailure(code, message) {
+	return {
+		error: {
+			code,
+			message
+		},
+		schemaVersion: 1,
+		status: "failed"
+	};
+}
+function projectModelReference(value) {
+	if (!isRecord(value) || typeof value.provider !== "string" || typeof value.model !== "string") return void 0;
+	const result = {
+		model: value.model,
+		provider: value.provider
+	};
+	if (typeof value.label === "string") return {
+		...result,
+		label: value.label
+	};
+	if (typeof value.bindingRevision === "string") return {
+		...result,
+		bindingRevision: value.bindingRevision
+	};
+	return result;
+}
+function projectPending(value) {
+	if (!isRecord(value)) return void 0;
+	const result = {};
+	copyScalar(result, value, "phase");
+	copyScalar(result, value, "reason");
+	if (result.reason === void 0 && typeof result.phase === "string") result.reason = result.phase;
+	copyScalar(result, value, "requestId");
+	copyScalar(result, value, "updatedAt");
+	const request = projectReceipt(value.request);
+	if (request) result.request = request;
+	const target = projectModelReference(value.target);
+	if (target) result.target = target;
+	return Object.keys(result).length > 0 ? result : void 0;
+}
+function projectReceipt(value) {
+	if (!isRecord(value)) return void 0;
+	const result = {};
+	for (const key of [
+		"requestId",
+		"revision",
+		"status",
+		"phase",
+		"operation",
+		"expectedRevision",
+		"acceptedAt",
+		"updatedAt"
+	]) copyScalar(result, value, key);
+	const current = projectModelReference(value.current);
+	if (current) result.current = current;
+	const previous = projectModelReference(value.previous);
+	if (previous) result.previous = previous;
+	const target = projectModelReference(value.target);
+	if (target) result.target = target;
+	const budget = projectBudget(value.budget);
+	if (budget) result.budget = budget;
+	const error = projectError(value.error);
+	if (error) result.error = error;
+	const notification = projectNotification(value.notification);
+	if (notification) result.notification = notification;
+	return Object.keys(result).length > 0 ? result : void 0;
+}
+function projectBudget(value) {
+	if (!isRecord(value)) return void 0;
+	const result = {};
+	for (const key of [
+		"deadlineAt",
+		"maxOutputTokens",
+		"maxPaidRequests",
+		"outputTokens",
+		"paidRequests"
+	]) copyScalar(result, value, key);
+	return Object.keys(result).length > 0 ? result : void 0;
+}
+function projectError(value) {
+	if (!isRecord(value) || typeof value.code !== "string" || typeof value.message !== "string") return void 0;
+	return {
+		code: value.code,
+		message: value.message
+	};
+}
+function projectNotification(value) {
+	if (!isRecord(value)) return void 0;
+	const result = {};
+	copyScalar(result, value, "attempts");
+	copyScalar(result, value, "lastAttemptAt");
+	copyScalar(result, value, "status");
+	return Object.keys(result).length > 0 ? result : void 0;
+}
+function copyScalar(target, source, key) {
+	const value = source[key];
+	if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") target[key] = value;
+}
+function parseTarget(value) {
+	if (!value) throw new Error("model request target is missing");
+	const separator = value.indexOf("/");
+	return {
+		model: value.slice(separator + 1),
+		provider: value.slice(0, separator)
+	};
+}
+function isPublicStatus(value) {
+	return value === "applied" || value === "failed" || value === "pending" || value === "recovery-required" || value === "restored";
+}
+function optionalString(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
+export { toRivusModelManagementSubmission as a, renderRivusModelCliHelp as c, projectRivusModelCliResponse as i, createRivusModelManagementWireRequest as n, parseRivusModelCliArguments as o, parseRivusModelManagementWireRequest as r, renderRivusModelCliArgumentError as s, createRivusModelManagementFailure as t };

package/dist/chunks/rivus-plugin-testkit.js

@@ -1,5 +1,5 @@
-import { o as createRivusHostToolDescriptorProvider, p as deepFreeze, r as createRivusPluginCatalog$1, s as RIVUS_MEMORY_TOOL_ID, t as createRivusAgentCatalog } from "./rivus-agent-definition-resolver.js";
 import { t as createSha256Digest } from "./sha256-digest.js";
+import { o as createRivusHostToolDescriptorProvider, p as deepFreeze, r as createRivusPluginCatalog$1, s as RIVUS_MEMORY_TOOL_ID, t as createRivusAgentCatalog } from "./rivus-agent-definition-resolver.js";
 //#region src/adapters/compatibility/agent-catalog/rivus-agent-catalog.ts
 const runtime = Object.freeze({
 	digest: createSha256Digest,

package/dist/chunks/{tool-input-digest.js → rivus-tool.js}

@@ -1,65 +1,4 @@
 import { Unsafe } from "typebox";
-//#region src/adapters/pi/skills/pi-skill-tool.ts
-const PI_SKILL_READER_TOOL_NAME = "rivus_read_skill";
-function createPiSkillRuntime(skills) {
-	if (skills.length === 0) return Object.freeze({ prompt: "" });
-	const skillsById = new Map(skills.map((skill) => [skill.id, skill]));
-	const prompt = [
-		"Granted Skills are versioned instructions loaded on demand.",
-		`Before following a Skill, call ${PI_SKILL_READER_TOOL_NAME} with its exact ID and follow the returned content.`,
-		"Granted Skill catalog:",
-		...skills.map((skill) => `- ${skill.id} | ${skill.title} | v${skill.version} | ${skill.digest}`)
-	].join("\n");
-	const tool = {
-		description: "Read the full versioned instructions for one Skill granted to this Agent Runtime.",
-		execute: async (_callId, input) => {
-			const skillId = readSkillId(input);
-			const skill = skillsById.get(skillId);
-			if (!skill) throw new Error(`Skill is not granted: ${skillId}`);
-			const details = {
-				contentLength: skill.content.length,
-				digest: skill.digest,
-				skillId: skill.id,
-				title: skill.title,
-				version: skill.version
-			};
-			return {
-				content: [{
-					text: skill.content,
-					type: "text"
-				}],
-				details
-			};
-		},
-		executionMode: "sequential",
-		label: "Read granted Skill",
-		name: PI_SKILL_READER_TOOL_NAME,
-		parameters: Unsafe({
-			additionalProperties: false,
-			properties: { skillId: {
-				description: "Exact Skill ID from the granted Skill catalog.",
-				type: "string"
-			} },
-			required: ["skillId"],
-			type: "object"
-		}),
-		promptSnippet: `${PI_SKILL_READER_TOOL_NAME}: read one granted Skill by exact ID`
-	};
-	return Object.freeze({
-		prompt,
-		tool
-	});
-}
-function readSkillId(input) {
-	if (input === null || typeof input !== "object" || Array.isArray(input) || typeof input.skillId !== "string") throw new Error("Skill reader input requires a string skillId");
-	return input.skillId;
-}
-//#endregion
-//#region src/core/application/agent-catalog/contracts/rivus-tool.ts
-var RivusToolInputRejected = class extends Error {
-	name = "RivusToolInputRejected";
-};
-//#endregion
 //#region src/core/application/tool-execution/authority/invocation-authority-registry.ts
 const authorities = /* @__PURE__ */ new WeakMap();
 let localAuthoritySequence = 0;
@@ -106,11 +45,6 @@ function isRecord(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 //#endregion
-//#region src/core/application/tool-execution/authority/tool-risk-policy.ts
-function requiresToolApproval(risk) {
-	return risk === "irreversible" || risk === "host-control";
-}
-//#endregion
 //#region src/core/application/tool-execution/brokerage/tool-input-digest.ts
 var InvalidStableJson = class extends Error {
 	name = "InvalidStableJson";
@@ -155,4 +89,70 @@ function serializeStableJson(value, ancestors) {
 	}
 }
 //#endregion
-export { requiresToolApproval as a, resolveInvocationAuthority as c, createPiSkillRuntime as d, normalizeStableJson as i, RivusToolInputRejected as l, InvalidToolInput as n, InvalidInvocationAuthority as o, createToolInputDigest as r, createInvocationAuthority as s, InvalidStableJson as t, PI_SKILL_READER_TOOL_NAME as u };
+//#region src/core/application/tool-execution/authority/tool-risk-policy.ts
+function requiresToolApproval(risk) {
+	return risk === "irreversible" || risk === "host-control";
+}
+//#endregion
+//#region src/adapters/pi/skills/pi-skill-tool.ts
+const PI_SKILL_READER_TOOL_NAME = "rivus_read_skill";
+function createPiSkillRuntime(skills) {
+	if (skills.length === 0) return Object.freeze({ prompt: "" });
+	const skillsById = new Map(skills.map((skill) => [skill.id, skill]));
+	const prompt = [
+		"Granted Skills are versioned instructions loaded on demand.",
+		`Before following a Skill, call ${PI_SKILL_READER_TOOL_NAME} with its exact ID and follow the returned content.`,
+		"Granted Skill catalog:",
+		...skills.map((skill) => `- ${skill.id} | ${skill.title} | v${skill.version} | ${skill.digest}`)
+	].join("\n");
+	const tool = {
+		description: "Read the full versioned instructions for one Skill granted to this Agent Runtime.",
+		execute: async (_callId, input) => {
+			const skillId = readSkillId(input);
+			const skill = skillsById.get(skillId);
+			if (!skill) throw new Error(`Skill is not granted: ${skillId}`);
+			const details = {
+				contentLength: skill.content.length,
+				digest: skill.digest,
+				skillId: skill.id,
+				title: skill.title,
+				version: skill.version
+			};
+			return {
+				content: [{
+					text: skill.content,
+					type: "text"
+				}],
+				details
+			};
+		},
+		executionMode: "sequential",
+		label: "Read granted Skill",
+		name: PI_SKILL_READER_TOOL_NAME,
+		parameters: Unsafe({
+			additionalProperties: false,
+			properties: { skillId: {
+				description: "Exact Skill ID from the granted Skill catalog.",
+				type: "string"
+			} },
+			required: ["skillId"],
+			type: "object"
+		}),
+		promptSnippet: `${PI_SKILL_READER_TOOL_NAME}: read one granted Skill by exact ID`
+	};
+	return Object.freeze({
+		prompt,
+		tool
+	});
+}
+function readSkillId(input) {
+	if (input === null || typeof input !== "object" || Array.isArray(input) || typeof input.skillId !== "string") throw new Error("Skill reader input requires a string skillId");
+	return input.skillId;
+}
+//#endregion
+//#region src/core/application/agent-catalog/contracts/rivus-tool.ts
+var RivusToolInputRejected = class extends Error {
+	name = "RivusToolInputRejected";
+};
+//#endregion
+export { InvalidStableJson as a, normalizeStableJson as c, resolveInvocationAuthority as d, requiresToolApproval as i, InvalidInvocationAuthority as l, PI_SKILL_READER_TOOL_NAME as n, InvalidToolInput as o, createPiSkillRuntime as r, createToolInputDigest as s, RivusToolInputRejected as t, createInvocationAuthority as u };