@oomol-lab/open-flow 0.1.0-beta.54 → 0.1.0-beta.55

package/dist/common/flow-semantics.js

@@ -6072,6 +6072,70 @@ var $ZodUnion = /*@__PURE__*/ $constructor("$ZodUnion", (inst, def) => {
 		});
 	};
 });
+function discriminatorMap(def) {
+	const map = /* @__PURE__ */ new Map();
+	for (const option of def.options) {
+		const values = option._zod.propValues?.[def.discriminator];
+		if (!values || values.size === 0) throw new Error(`Invalid discriminated union option at index "${def.options.indexOf(option)}"`);
+		for (const value of values) if (map.has(value)) {
+			if (value !== void 0) throw new Error(`Duplicate discriminator value "${String(value)}"`);
+			map.set(value, null);
+		} else map.set(value, option);
+	}
+	return map;
+}
+var $ZodDiscriminatedUnion = /*@__PURE__*/ $constructor("$ZodDiscriminatedUnion", (inst, def) => {
+	def.inclusive = false;
+	$ZodUnion.init(inst, def);
+	const _super = inst._zod.parse;
+	defineLazyInternal(inst, "propValues", (zod) => {
+		const propValues = {};
+		let undefinedCount = 0;
+		for (const option of zod.def.options) {
+			const pv = option._zod.propValues;
+			if (!pv || Object.keys(pv).length === 0) throw new Error(`Invalid discriminated union option at index "${zod.def.options.indexOf(option)}"`);
+			if (pv[zod.def.discriminator]?.has(void 0)) undefinedCount++;
+			for (const [k, v] of Object.entries(pv)) {
+				if (!Object.prototype.hasOwnProperty.call(propValues, k)) assignProp(propValues, k, /* @__PURE__ */ new Set());
+				for (const val of v) propValues[k].add(val);
+			}
+		}
+		if (!zod.def.unionFallback && undefinedCount > 1) propValues[zod.def.discriminator]?.delete(void 0);
+		return propValues;
+	});
+	def.options.forEach((option, i) => {
+		const propShape = rawShape(option._zod.def);
+		if (propShape && !Object.prototype.hasOwnProperty.call(propShape, def.discriminator)) throw new Error(`Invalid discriminated union option at index "${i}"`);
+	});
+	const disc = cached(() => discriminatorMap(def));
+	inst._zod.parse = (payload, ctx) => {
+		const input = payload.value;
+		if (!isObject(input)) {
+			payload.issues.push({
+				code: "invalid_type",
+				expected: "object",
+				input,
+				inst
+			});
+			return payload;
+		}
+		const value = input?.[def.discriminator];
+		const opt = disc.value.get(value);
+		if (opt && (value !== void 0 || ctx.direction !== "backward")) return opt._zod.run(payload, ctx);
+		if (def.unionFallback || ctx.direction === "backward") return _super(payload, ctx);
+		payload.issues.push({
+			code: "invalid_union",
+			errors: [],
+			note: "No matching discriminator",
+			discriminator: def.discriminator,
+			options: Array.from(disc.value.keys()).filter((value) => disc.value.get(value) !== null),
+			input,
+			path: [def.discriminator],
+			inst
+		});
+		return payload;
+	};
+});
 var $ZodIntersection = /*@__PURE__*/ $constructor("$ZodIntersection", (inst, def) => {
 	$ZodType.init(inst, def);
 	inst._zod.parse = (payload, ctx) => {
@@ -9120,6 +9184,18 @@ function union(options, params) {
 		...normalizeParams(params)
 	});
 }
+var ZodDiscriminatedUnion = /*@__PURE__*/ $constructor("ZodDiscriminatedUnion", (inst, def) => {
+	ZodUnion.init(inst, def);
+	$ZodDiscriminatedUnion.init(inst, def);
+});
+function discriminatedUnion(discriminator, options, params) {
+	return new ZodDiscriminatedUnion({
+		type: "union",
+		options,
+		discriminator,
+		...normalizeParams(params)
+	});
+}
 var ZodIntersection = /*@__PURE__*/ $constructor("ZodIntersection", (inst, def) => {
 	$ZodIntersection.init(inst, def);
 	ZodType.init(inst, def);
@@ -9521,6 +9597,32 @@ var agentValue = union([object$1({
 	input: text
 })]);
 var agentInput$1 = union([agentValue, object$1({ kind: literal("model") })]);
+var decisionQuestion = discriminatedUnion("type", [
+	strictObject({
+		name: text,
+		instructions: text,
+		type: literal("noul"),
+		criteria: strictObject({
+			true: text.optional(),
+			false: text.optional()
+		}).optional()
+	}),
+	strictObject({
+		name: text,
+		instructions: text,
+		type: literal("choice"),
+		criteria: array(strictObject({
+			name: text,
+			description: text
+		}))
+	}),
+	strictObject({
+		name: text,
+		instructions: text,
+		type: literal("score"),
+		criteria: strings
+	})
+]);
 var managed = object$1({
 	...ports,
 	name: text,
@@ -9548,6 +9650,10 @@ var managed = object$1({
 				in: _enum(["header", "query"]).optional()
 			}))
 		}),
+		strictObject({
+			kind: literal("decision"),
+			questions: array(decisionQuestion)
+		}),
 		object$1({
 			kind: literal("llm"),
 			mode: _enum(["chat", "json"])
@@ -9574,7 +9680,7 @@ var managed = object$1({
 			}).optional()
 		})
 	])
-});
+}).transform(limitDecisionTask);
 var operand = union([object$1({
 	kind: literal("value"),
 	value: json.optional(),
@@ -9968,6 +10074,11 @@ var shapes = {
 		before: text.optional(),
 		value: text.optional()
 	},
+	"task.decision.set": {
+		taskId: text,
+		before: managed,
+		value: managed
+	},
 	"task.openapi.set": {
 		taskId: text,
 		before: managed,
@@ -10403,6 +10514,162 @@ function hasRetiredRef(value) {
 	return source.contentMediaType == "oomol/ref" || Object.values(source).some(hasRetiredRef);
 }
 //#endregion
+//#region src/decision/common/decision.ts
+var decisionLimits = {
+	choice: 255,
+	score: 10
+};
+/** Ordered prefixes are shared by authoring, schemas, validation, and execution. */
+function limitDecisionQuestion(question) {
+	if (question.type === "noul" || question.criteria.length <= decisionLimits[question.type]) return question;
+	if (question.type === "choice") return {
+		...question,
+		criteria: question.criteria.slice(0, decisionLimits.choice)
+	};
+	return {
+		...question,
+		criteria: question.criteria.slice(0, decisionLimits.score)
+	};
+}
+function limitDecisionQuestions(questions) {
+	const limited = questions.map(limitDecisionQuestion);
+	return limited.every((question, i) => question === questions[i]) ? questions : limited;
+}
+/** Loading an oversized task also updates its previously generated output schemas. */
+function limitDecisionTask(task) {
+	if (task.executor.kind !== "decision") return task;
+	const original = task.executor.questions;
+	const questions = limitDecisionQuestions(original);
+	if (questions === original) return task;
+	const outputs = task.outputs.map((port) => {
+		if (!("handle" in port)) return port;
+		const index = original.findIndex((question) => question.name === port.handle);
+		if (index < 0 || original[index] === questions[index] || !dequal(port.jsonSchema, answerSchema(original[index]))) return port;
+		return {
+			...port,
+			jsonSchema: decisionAnswerSchema(questions[index])
+		};
+	});
+	return {
+		...task,
+		executor: {
+			...task.executor,
+			questions
+		},
+		outputs
+	};
+}
+var decisionStateSchema = { type: [
+	"string",
+	"object",
+	"array"
+] };
+var probability = {
+	type: "number",
+	minimum: 0,
+	maximum: 1
+};
+var defaultDecisionQuestion = (name = "decision1") => ({
+	name,
+	type: "noul",
+	instructions: ""
+});
+function decisionQuestionIssues(questions) {
+	questions = limitDecisionQuestions(questions);
+	const issues = [];
+	if (!questions.length) issues.push({
+		field: "questions",
+		message: "Add at least one question."
+	});
+	questions.forEach((question, index) => {
+		const add = (field, message) => issues.push({
+			question: index,
+			field,
+			message
+		});
+		if (!question.name.trim() || question.name === "__proto__" || questions.some((other, i) => i !== index && other.name === question.name)) add("name", "Question names must be non-empty and unique; __proto__ is reserved.");
+		if (!question.instructions.trim()) add("instructions", "Describe the question to evaluate.");
+		if (question.type === "choice") {
+			if (!question.criteria.length) add("criteria", "Provide between 1 and 255 choices.");
+			const names = question.criteria.map((item) => item.name);
+			if (names.some((name) => !name.trim() || name === "__proto__") || new Set(names).size !== names.length) add("criteria", "Choice names must be non-empty and unique; __proto__ is reserved.");
+		}
+		if (question.type === "score" && (question.criteria.length < 2 || question.criteria.some((level) => !level.trim()))) add("criteria", "Provide between 2 and 10 non-empty levels, in increasing order.");
+	});
+	return issues;
+}
+function decisionAnswerSchema(question) {
+	return answerSchema(limitDecisionQuestion(question));
+}
+function answerSchema(question) {
+	const properties = { type: { const: question.type } };
+	if (question.type === "noul") properties.noul = probability;
+	else {
+		const keys = question.type === "choice" ? question.criteria.map((item) => item.name) : question.criteria.map((_, index) => String(index));
+		properties.confidence = probability;
+		properties.probabilities = {
+			type: "object",
+			properties: Object.fromEntries(keys.map((key) => [key, probability])),
+			required: keys,
+			additionalProperties: false
+		};
+		if (question.type === "choice") properties.choice = {
+			type: "string",
+			...keys.length ? { enum: keys } : {}
+		};
+		else {
+			properties.score = {
+				type: "number",
+				minimum: 0,
+				maximum: Math.max(0, keys.length - 1)
+			};
+			properties.legend = {
+				type: "object",
+				properties: Object.fromEntries(keys.map((key) => [key, { type: "string" }])),
+				required: keys,
+				additionalProperties: false
+			};
+		}
+	}
+	return {
+		type: "object",
+		properties,
+		required: Object.keys(properties)
+	};
+}
+function decisionTask(questions = [defaultDecisionQuestion()], name = "AI Decision") {
+	questions = limitDecisionQuestions(questions);
+	const inputs = [{
+		handle: "target",
+		description: "Text, object, or array to evaluate across all questions.",
+		jsonSchema: decisionStateSchema,
+		nullable: false
+	}];
+	const outputs = questions.map((question) => ({
+		handle: question.name,
+		jsonSchema: decisionAnswerSchema(question),
+		nullable: false
+	}));
+	return {
+		name,
+		executor: {
+			kind: "decision",
+			questions
+		},
+		inputs,
+		outputs
+	};
+}
+function decisionTaskIssues(task) {
+	task = limitDecisionTask(task);
+	if (task.executor.kind !== "decision") return [];
+	const expected = decisionTask(task.executor.questions, task.name);
+	return [...decisionQuestionIssues(task.executor.questions), ...!dequal(task.inputs, expected.inputs) || !dequal(task.outputs, expected.outputs) ? [{
+		field: "ports",
+		message: "AI Decision ports must match its questions."
+	}] : []];
+}
+//#endregion
 //#region src/openapi/common/openapi.ts
 var methods = [
 	"get",
@@ -24045,6 +24312,13 @@ async function validateFlow(revision, engine) {
 	for (const taskId of [...closure.dependencies.tasks].toSorted()) {
 		const task = revision.document.tasks[taskId];
 		if (task == null) continue;
+		for (const issue of decisionTaskIssues(task)) checked.diagnostics.push({
+			code: "decision.config-invalid",
+			column: 0,
+			line: 1,
+			message: issue.message,
+			path: `/document/tasks/${taskId}/executor`
+		});
 		for (const message of openApiIssues(task)) checked.diagnostics.push({
 			code: "openapi.config-invalid",
 			column: 0,
@@ -24173,7 +24447,7 @@ async function prepareFlow(revision, engineContract, triggerId) {
 			graph: revision.document.graph,
 			modules: Object.fromEntries([...closure.dependencies.modules].toSorted().map((id) => [id, revision.modules[id]])),
 			subflows: Object.fromEntries([...closure.dependencies.subflows].toSorted().map((id) => [id, revision.document.subflows[id]])),
-			tasks: Object.fromEntries([...closure.dependencies.tasks].toSorted().map((id) => [id, revision.document.tasks[id]]))
+			tasks: Object.fromEntries([...closure.dependencies.tasks].toSorted().map((id) => [id, limitDecisionTask(revision.document.tasks[id])]))
 		},
 		kind: "prepared",
 		validation

package/dist/common/integration-trigger.js

@@ -5918,6 +5918,70 @@ var $ZodUnion = /*@__PURE__*/ $constructor("$ZodUnion", (inst, def) => {
 		});
 	};
 });
+function discriminatorMap(def) {
+	const map = /* @__PURE__ */ new Map();
+	for (const option of def.options) {
+		const values = option._zod.propValues?.[def.discriminator];
+		if (!values || values.size === 0) throw new Error(`Invalid discriminated union option at index "${def.options.indexOf(option)}"`);
+		for (const value of values) if (map.has(value)) {
+			if (value !== void 0) throw new Error(`Duplicate discriminator value "${String(value)}"`);
+			map.set(value, null);
+		} else map.set(value, option);
+	}
+	return map;
+}
+var $ZodDiscriminatedUnion = /*@__PURE__*/ $constructor("$ZodDiscriminatedUnion", (inst, def) => {
+	def.inclusive = false;
+	$ZodUnion.init(inst, def);
+	const _super = inst._zod.parse;
+	defineLazyInternal(inst, "propValues", (zod) => {
+		const propValues = {};
+		let undefinedCount = 0;
+		for (const option of zod.def.options) {
+			const pv = option._zod.propValues;
+			if (!pv || Object.keys(pv).length === 0) throw new Error(`Invalid discriminated union option at index "${zod.def.options.indexOf(option)}"`);
+			if (pv[zod.def.discriminator]?.has(void 0)) undefinedCount++;
+			for (const [k, v] of Object.entries(pv)) {
+				if (!Object.prototype.hasOwnProperty.call(propValues, k)) assignProp(propValues, k, /* @__PURE__ */ new Set());
+				for (const val of v) propValues[k].add(val);
+			}
+		}
+		if (!zod.def.unionFallback && undefinedCount > 1) propValues[zod.def.discriminator]?.delete(void 0);
+		return propValues;
+	});
+	def.options.forEach((option, i) => {
+		const propShape = rawShape(option._zod.def);
+		if (propShape && !Object.prototype.hasOwnProperty.call(propShape, def.discriminator)) throw new Error(`Invalid discriminated union option at index "${i}"`);
+	});
+	const disc = cached(() => discriminatorMap(def));
+	inst._zod.parse = (payload, ctx) => {
+		const input = payload.value;
+		if (!isObject(input)) {
+			payload.issues.push({
+				code: "invalid_type",
+				expected: "object",
+				input,
+				inst
+			});
+			return payload;
+		}
+		const value = input?.[def.discriminator];
+		const opt = disc.value.get(value);
+		if (opt && (value !== void 0 || ctx.direction !== "backward")) return opt._zod.run(payload, ctx);
+		if (def.unionFallback || ctx.direction === "backward") return _super(payload, ctx);
+		payload.issues.push({
+			code: "invalid_union",
+			errors: [],
+			note: "No matching discriminator",
+			discriminator: def.discriminator,
+			options: Array.from(disc.value.keys()).filter((value) => disc.value.get(value) !== null),
+			input,
+			path: [def.discriminator],
+			inst
+		});
+		return payload;
+	};
+});
 var $ZodIntersection = /*@__PURE__*/ $constructor("$ZodIntersection", (inst, def) => {
 	$ZodType.init(inst, def);
 	inst._zod.parse = (payload, ctx) => {
@@ -8966,6 +9030,18 @@ function union(options, params) {
 		...normalizeParams(params)
 	});
 }
+var ZodDiscriminatedUnion = /*@__PURE__*/ $constructor("ZodDiscriminatedUnion", (inst, def) => {
+	ZodUnion.init(inst, def);
+	$ZodDiscriminatedUnion.init(inst, def);
+});
+function discriminatedUnion(discriminator, options, params) {
+	return new ZodDiscriminatedUnion({
+		type: "union",
+		options,
+		discriminator,
+		...normalizeParams(params)
+	});
+}
 var ZodIntersection = /*@__PURE__*/ $constructor("ZodIntersection", (inst, def) => {
 	$ZodIntersection.init(inst, def);
 	ZodType.init(inst, def);
@@ -9244,6 +9320,96 @@ function json$1(params) {
 	return jsonSchema;
 }
 //#endregion
+//#region src/decision/common/decision.ts
+var decisionLimits = {
+	choice: 255,
+	score: 10
+};
+/** Ordered prefixes are shared by authoring, schemas, validation, and execution. */
+function limitDecisionQuestion(question) {
+	if (question.type === "noul" || question.criteria.length <= decisionLimits[question.type]) return question;
+	if (question.type === "choice") return {
+		...question,
+		criteria: question.criteria.slice(0, decisionLimits.choice)
+	};
+	return {
+		...question,
+		criteria: question.criteria.slice(0, decisionLimits.score)
+	};
+}
+function limitDecisionQuestions(questions) {
+	const limited = questions.map(limitDecisionQuestion);
+	return limited.every((question, i) => question === questions[i]) ? questions : limited;
+}
+/** Loading an oversized task also updates its previously generated output schemas. */
+function limitDecisionTask(task) {
+	if (task.executor.kind !== "decision") return task;
+	const original = task.executor.questions;
+	const questions = limitDecisionQuestions(original);
+	if (questions === original) return task;
+	const outputs = task.outputs.map((port) => {
+		if (!("handle" in port)) return port;
+		const index = original.findIndex((question) => question.name === port.handle);
+		if (index < 0 || original[index] === questions[index] || !dequal(port.jsonSchema, answerSchema(original[index]))) return port;
+		return {
+			...port,
+			jsonSchema: decisionAnswerSchema(questions[index])
+		};
+	});
+	return {
+		...task,
+		executor: {
+			...task.executor,
+			questions
+		},
+		outputs
+	};
+}
+var probability = {
+	type: "number",
+	minimum: 0,
+	maximum: 1
+};
+function decisionAnswerSchema(question) {
+	return answerSchema(limitDecisionQuestion(question));
+}
+function answerSchema(question) {
+	const properties = { type: { const: question.type } };
+	if (question.type === "noul") properties.noul = probability;
+	else {
+		const keys = question.type === "choice" ? question.criteria.map((item) => item.name) : question.criteria.map((_, index) => String(index));
+		properties.confidence = probability;
+		properties.probabilities = {
+			type: "object",
+			properties: Object.fromEntries(keys.map((key) => [key, probability])),
+			required: keys,
+			additionalProperties: false
+		};
+		if (question.type === "choice") properties.choice = {
+			type: "string",
+			...keys.length ? { enum: keys } : {}
+		};
+		else {
+			properties.score = {
+				type: "number",
+				minimum: 0,
+				maximum: Math.max(0, keys.length - 1)
+			};
+			properties.legend = {
+				type: "object",
+				properties: Object.fromEntries(keys.map((key) => [key, { type: "string" }])),
+				required: keys,
+				additionalProperties: false
+			};
+		}
+	}
+	return {
+		type: "object",
+		properties,
+		required: Object.keys(properties)
+	};
+}
+//#endregion
 //#region src/flow/common/triggerScheduleSchema.ts
 var triggerScheduleSchema = array(union([object({
 	type: literal("cron"),
@@ -9360,6 +9526,32 @@ var agentValue = union([object({
 	input: text
 })]);
 var agentInput = union([agentValue, object({ kind: literal("model") })]);
+var decisionQuestion = discriminatedUnion("type", [
+	strictObject({
+		name: text,
+		instructions: text,
+		type: literal("noul"),
+		criteria: strictObject({
+			true: text.optional(),
+			false: text.optional()
+		}).optional()
+	}),
+	strictObject({
+		name: text,
+		instructions: text,
+		type: literal("choice"),
+		criteria: array(strictObject({
+			name: text,
+			description: text
+		}))
+	}),
+	strictObject({
+		name: text,
+		instructions: text,
+		type: literal("score"),
+		criteria: strings
+	})
+]);
 var managed = object({
 	...ports,
 	name: text,
@@ -9387,6 +9579,10 @@ var managed = object({
 				in: _enum(["header", "query"]).optional()
 			}))
 		}),
+		strictObject({
+			kind: literal("decision"),
+			questions: array(decisionQuestion)
+		}),
 		object({
 			kind: literal("llm"),
 			mode: _enum(["chat", "json"])
@@ -9413,7 +9609,7 @@ var managed = object({
 			}).optional()
 		})
 	])
-});
+}).transform(limitDecisionTask);
 var operand = union([object({
 	kind: literal("value"),
 	value: json.optional(),
@@ -9807,6 +10003,11 @@ var shapes = {
 		before: text.optional(),
 		value: text.optional()
 	},
+	"task.decision.set": {
+		taskId: text,
+		before: managed,
+		value: managed
+	},
 	"task.openapi.set": {
 		taskId: text,
 		before: managed,