@orkestrel/agent 0.0.12 → 0.0.13

package/dist/src/core/index.cjs

@@ -583,6 +583,61 @@ var ConversationManager = class {
 //#endregion
 //#region src/core/helpers.ts
 /**
+* Project an unknown value onto the canonical JSON representation of an
+* {@link AgentResult}.
+*
+* @remarks
+* This is a total hostile-boundary projection. Each structural field is captured once
+* through Contract's sanctioned exception boundary, so conforming accessors and inherited
+* properties are supported while a throwing getter or revoked proxy returns `undefined`.
+* Present usage counts must be finite numbers; negative and fractional values are preserved,
+* not normalized. Extra input properties are dropped while a fresh exact plain object is rebuilt
+* and deep-gated through
+* {@link import('@orkestrel/contract').parseJSONValue}.
+*
+* @param value - The unknown value to project
+* @returns A fresh JSON value containing only AgentResult fields, or `undefined` when invalid
+*
+* @example
+* ```ts
+* import { agentResultToJSON } from '@orkestrel/agent'
+*
+* agentResultToJSON({ content: 'done', usage: { prompt: 2, completion: 1, total: 3 }, partial: false })
+* // { content: 'done', usage: { prompt: 2, completion: 1, total: 3 }, partial: false }
+* ```
+*/
+function agentResultToJSON(value) {
+	const captured = (0, _orkestrel_contract.attempt)(() => {
+		if (!(0, _orkestrel_contract.isObject)(value)) return void 0;
+		const content = Reflect.get(value, "content");
+		const thinking = Reflect.get(value, "thinking");
+		const usage = Reflect.get(value, "usage");
+		const partial = Reflect.get(value, "partial");
+		if (!(0, _orkestrel_contract.isString)(content) || !(0, _orkestrel_contract.isBoolean)(partial)) return void 0;
+		if (thinking !== void 0 && !(0, _orkestrel_contract.isString)(thinking)) return void 0;
+		let projectedUsage;
+		if (usage !== void 0) {
+			if (!(0, _orkestrel_contract.isObject)(usage)) return void 0;
+			const prompt = Reflect.get(usage, "prompt");
+			const completion = Reflect.get(usage, "completion");
+			const total = Reflect.get(usage, "total");
+			if (!(0, _orkestrel_contract.isFiniteNumber)(prompt) || !(0, _orkestrel_contract.isFiniteNumber)(completion) || !(0, _orkestrel_contract.isFiniteNumber)(total)) return;
+			projectedUsage = {
+				prompt,
+				completion,
+				total
+			};
+		}
+		return {
+			content,
+			...thinking === void 0 ? {} : { thinking },
+			...projectedUsage === void 0 ? {} : { usage: projectedUsage },
+			partial
+		};
+	});
+	return captured.success ? (0, _orkestrel_contract.parseJSONValue)(captured.value) : void 0;
+}
+/**
 * Filter a list of items by a {@link import('./types.js').ScopeInterface} allow-list of
 * keys — the pure, total set-membership primitive the context's build step and the agent
 * loop's tool-advertise step apply a scope through.
@@ -2771,6 +2826,7 @@ exports.THINK_CLOSE = THINK_CLOSE;
 exports.THINK_OPEN = THINK_OPEN;
 exports.ThinkSplitter = ThinkSplitter;
 exports.WORKSPACE_SECTION_HEADER = WORKSPACE_SECTION_HEADER;
+exports.agentResultToJSON = agentResultToJSON;
 exports.createAgent = createAgent;
 exports.createAgentContext = createAgentContext;
 exports.createAgentQueue = createAgentQueue;