@oomol-lab/open-flow 0.1.0-beta.40 → 0.1.0-beta.41

package/README.md

@@ -2,6 +2,15 @@
 
 TypeScript contracts and Browser runtime for Open Flow.
 
+The offline Publications viewer is available as `OpenFlowPreview` from
+`@oomol-lab/open-flow/preview`, with standalone `@oomol-lab/open-flow/preview.css`.
+Supply `draft`, `presentation` (or null), `language` and `theme`; the entry also exports
+`Draft`, `Presentation` and `OpenFlowPreviewProps` types. Give its parent an explicit height.
+It supports temporary node movement, restore layout, read-only properties and subflows without
+fetching or saving a workflow. Use a new React key to reset the session when switching examples.
+A Shadow DOM host must load the stylesheet inside its shadow root before mounting the component;
+Vite hosts can import `@oomol-lab/open-flow/preview.css?url` for the stylesheet URL.
+
 Install the Task contracts as a development dependency:
 
 ```bash

package/dist/browser/{createResourceDialog-BOrW62JW.js → createResourceDialog-DmJk4LsF.js}

@@ -1,47 +1,46 @@
 import { i as e } from "./main-BDnNHhkU.js";
-import { Bn as t, kt as n } from "./lite-BA96NG4M.js";
-import { a as r, c as i, d as a, f as o, g as s, h as c, i as l, l as u, m as d, n as f, p, r as m, s as h, t as g } from "./workbenchSelect-B5zXyaaX.js";
-import { Fragment as _, jsx as v, jsxs as y } from "react/jsx-runtime";
-import { useEffect as b, useRef as x, useState as S } from "react";
+import { C as t, E as n, Fr as r, Mn as i, S as a, T as o, a as s, c, i as l, l as u, n as d, r as f, s as p, t as m, w as h, x as g } from "./workbenchSelect-Bq6KHpKx.js";
+import { useEffect as _, useRef as v, useState as y } from "react";
+import { Fragment as b, jsx as x, jsxs as S } from "react/jsx-runtime";
 //#region src/workbench/browser/runtime/shell/createResourceDialog.tsx
 function C({ disabled: C, field: w, id: T, issue: E, label: D, name: O, onNameChange: k, onOpenChange: A, onSubmit: j, pending: M, title: N }) {
-	let P = e(), F = x(null), I = x(null), [L, R] = S(!1), z = O.length > 0 && E != null, B = P(z ? `resource.nameIssue.${E}` : "resource.nameHint", { max: 80 }), V = `${T}-message`, H = `${T}-option`;
-	return b(() => R(!0), []), /* @__PURE__ */ y(_, { children: [/* @__PURE__ */ v("div", { ref: I }), /* @__PURE__ */ v(m, {
+	let P = e(), F = v(null), I = v(null), [L, R] = y(!1), z = O.length > 0 && E != null, B = P(z ? `resource.nameIssue.${E}` : "resource.nameHint", { max: 80 }), V = `${T}-message`, H = `${T}-option`;
+	return _(() => R(!0), []), /* @__PURE__ */ S(b, { children: [/* @__PURE__ */ x("div", { ref: I }), /* @__PURE__ */ x(f, {
 		onOpenChange: R,
 		onOpenChangeComplete: (e) => {
 			e || A(!1);
 		},
 		open: L,
-		children: /* @__PURE__ */ v(r, {
+		children: /* @__PURE__ */ x(s, {
 			container: I.current,
 			initialFocus: () => F.current,
 			showCloseButton: !1,
-			children: /* @__PURE__ */ y("form", {
+			children: /* @__PURE__ */ S("form", {
 				className: "flex flex-col gap-4",
 				onSubmit: j,
 				children: [
-					/* @__PURE__ */ y(i, {
+					/* @__PURE__ */ S(c, {
 						className: "flex-row items-center justify-between",
-						children: [/* @__PURE__ */ v(u, { children: N }), /* @__PURE__ */ v(l, {
+						children: [/* @__PURE__ */ x(u, { children: N }), /* @__PURE__ */ x(l, {
 							"aria-label": P("common.cancel"),
-							render: /* @__PURE__ */ v(t, {
+							render: /* @__PURE__ */ x(r, {
 								size: "icon-sm",
 								variant: "ghost"
 							}),
 							type: "button",
-							children: /* @__PURE__ */ v(f, { name: "close" })
+							children: /* @__PURE__ */ x(d, { name: "close" })
 						})]
 					}),
-					/* @__PURE__ */ y(c, {
+					/* @__PURE__ */ S(o, {
 						className: "gap-4",
-						children: [/* @__PURE__ */ y(o, {
+						children: [/* @__PURE__ */ S(a, {
 							"data-invalid": z,
 							children: [
-								/* @__PURE__ */ v(s, {
+								/* @__PURE__ */ x(n, {
 									htmlFor: T,
 									children: D
 								}),
-								/* @__PURE__ */ v(n, {
+								/* @__PURE__ */ x(i, {
 									autoComplete: "off",
 									"aria-describedby": V,
 									"aria-invalid": z,
@@ -52,17 +51,17 @@ function C({ disabled: C, field: w, id: T, issue: E, label: D, name: O, onNameCh
 									required: !0,
 									value: O
 								}),
-								v(z ? d : p, {
+								x(z ? h : t, {
 									id: V,
 									children: B
 								})
 							]
-						}), w != null && /* @__PURE__ */ y(o, { children: [
-							/* @__PURE__ */ v(s, {
+						}), w != null && /* @__PURE__ */ S(a, { children: [
+							/* @__PURE__ */ x(n, {
 								htmlFor: w.state == "ready" ? H : void 0,
 								children: w.label
 							}),
-							w.state == "ready" ? /* @__PURE__ */ v(g, {
+							w.state == "ready" ? /* @__PURE__ */ x(m, {
 								ariaLabel: w.ariaLabel,
 								className: "w-full",
 								id: H,
@@ -70,13 +69,13 @@ function C({ disabled: C, field: w, id: T, issue: E, label: D, name: O, onNameCh
 								options: w.options,
 								portalRoot: I.current,
 								value: w.value
-							}) : /* @__PURE__ */ y("div", {
+							}) : /* @__PURE__ */ S("div", {
 								className: "flex min-h-9 items-center gap-2 rounded-lg border bg-muted/30 px-3 py-2 text-sm text-muted-foreground",
 								role: w.state == "error" ? "alert" : "status",
 								children: [
-									w.state == "loading" && /* @__PURE__ */ v(a, { "aria-hidden": "true" }),
-									/* @__PURE__ */ v("span", { children: w.status }),
-									w.state == "error" && /* @__PURE__ */ v(t, {
+									w.state == "loading" && /* @__PURE__ */ x(g, { "aria-hidden": "true" }),
+									/* @__PURE__ */ x("span", { children: w.status }),
+									w.state == "error" && /* @__PURE__ */ x(r, {
 										className: "ml-auto bg-background",
 										onClick: w.onRetry,
 										size: "sm",
@@ -86,16 +85,16 @@ function C({ disabled: C, field: w, id: T, issue: E, label: D, name: O, onNameCh
 									})
 								]
 							}),
-							/* @__PURE__ */ v(p, { children: w.description })
+							/* @__PURE__ */ x(t, { children: w.description })
 						] })]
 					}),
-					/* @__PURE__ */ y(h, {
+					/* @__PURE__ */ S(p, {
 						className: "mx-0 mb-0 border-0 bg-transparent p-0 pt-1",
-						children: [/* @__PURE__ */ v(l, {
-							render: /* @__PURE__ */ v(t, { variant: "outline" }),
+						children: [/* @__PURE__ */ x(l, {
+							render: /* @__PURE__ */ x(r, { variant: "outline" }),
 							type: "button",
 							children: P("common.cancel")
-						}), /* @__PURE__ */ v(t, {
+						}), /* @__PURE__ */ x(r, {
 							disabled: C || M || E != null,
 							type: "submit",
 							children: P(M ? "common.creating" : "common.create")

package/dist/browser/dist-BhV15xlT.js

@@ -0,0 +1,300 @@
+import e, { createContext as t, createElement as n, useContext as r, useDebugValue as i, useEffect as a, useMemo as o, useState as s } from "react";
+//#region ../../node_modules/.bun/value-enhancer@5.7.2/node_modules/value-enhancer/dist/index.mjs
+var c = {}, l = (e) => e, u = Object.is, d = (e, t) => {
+	if (u(e, t)) return !0;
+	if (!Array.isArray(e) || !Array.isArray(t)) return !1;
+	let n = e.length;
+	if (t.length !== n) return !1;
+	for (let r = 0; r < n; r++) if (!u(e[r], t[r])) return !1;
+	return !0;
+}, f = (e) => e.value, p = (e) => e.map(f), m = (e) => e.$version, h = (e, t) => {
+	try {
+		e(t);
+	} catch (e) {
+		console.error(e);
+	}
+}, g = (e, t) => (e.set = t, e), _ = (e) => !!e?.$valCompute, ee = (e) => !!e?.set;
+function v() {
+	if (typeof window > "u") return;
+	let e = { style: "color:#a225c2" }, t = { style: "color:#268bd2" }, n = { style: "color:#e28c5f" }, r = { style: "color:#eb2f96" }, i = {
+		header: (t) => _(t) ? [
+			"div",
+			e,
+			`${ee(t) ? "Val" : "ReadonlyVal"}`,
+			"<",
+			a(t.value),
+			">"
+		] : null,
+		hasBody: () => !1
+	};
+	function a(e) {
+		return typeof e == "number" ? [
+			"span",
+			t,
+			e
+		] : typeof e == "string" ? [
+			"span",
+			n,
+			e
+		] : typeof e == "boolean" ? [
+			"span",
+			r,
+			e
+		] : typeof e == "object" && e ? ["object", { object: e }] : [
+			"span",
+			n,
+			String(e)
+		];
+	}
+	(window.devtoolsFormatters ??= []).push(i);
+}
+function y() {
+	v();
+}
+var b = /* @__PURE__ */ Promise.resolve(), x = /* @__PURE__ */ new Set(), S = /* @__PURE__ */ new Set(), C = x, w, T = () => {
+	let e = C;
+	C = C === x ? S : x, w = !1;
+	for (let t of e) t.t();
+	e.clear();
+}, E = (e) => {
+	C.add(e), w ||= b.then(T);
+}, D = (e) => C.delete(e), O = /* @__PURE__ */ new FinalizationRegistry(h), k = class {
+	constructor(e, t, n) {
+		if (this.#n = e, this.q = (t?.equal ?? u) || void 0, this.e = t?.eager, this.m = t?.name, this.#t = t?.onDisposeValue, n) {
+			let e = new WeakRef(this), t = () => {
+				if (r) {
+					let e = r;
+					r = void 0, e();
+				}
+			}, r = n(() => {
+				let n = e.deref();
+				n ? n.n() : t();
+			});
+			r && O.register(this, this.#e = t);
+		}
+	}
+	g = this;
+	b = /* @__PURE__ */ new Map();
+	s = 4;
+	v;
+	c = c;
+	q;
+	e;
+	m;
+	u = () => {
+		if (this.s & 4) {
+			this.s &= -5;
+			let e = this.#n();
+			this.c === c ? this.w(e) : this.q?.(e, this.c) || (this.w(e), this.s & 1 && (this.s |= 2));
+		}
+		return this.c;
+	};
+	n = () => {
+		this.#i && (console.error(this.c, /* @__PURE__ */ Error(`${this.m || ""} disposed`)), process.env.NODE_ENV !== "production" && console.error(this.#i)), this.s |= 4, this.b.size && (this.s |= 1, this[3] && this.#r(3), this[2] && (this.u(), this.s & 2 && this.#r(2)), this[1] ? E(this) : this.s &= -4);
+	};
+	a(e, t) {
+		let n = this.b.get(e);
+		return n && this[n]--, this.b.set(e, t), this[t]++, () => this.r(e);
+	}
+	r(e) {
+		if (e) {
+			let t = this.b.get(e);
+			t && (this.b.delete(e), this[t]--);
+		} else this.b.clear(), this[1] = this[2] = this[3] = 0, D(this);
+	}
+	t() {
+		this[1] && (this.u(), this.s & 2 && this.#r(1)), this.s &= -4;
+	}
+	d() {
+		let e = this.c;
+		this.r(), O.unregister(this), this.#e?.(), this.#i = process.env.NODE_ENV === "production" || /* @__PURE__ */ Error("[val-dev] Val disposed at:"), this.#t && e !== c && this.#t(e);
+	}
+	w(e) {
+		this.w = this.q?.(e, e) ? this.y : this.x, this.w(e);
+	}
+	x(e) {
+		let t = this.c;
+		this.c = e, this.v = Symbol(), this.#t && t !== c && t !== e && this.#t(t);
+	}
+	y(e) {
+		let t = this.c;
+		this.c = this.v = e, this.#t && t !== c && t !== e && this.#t(t);
+	}
+	1 = 0;
+	2 = 0;
+	3 = 0;
+	#e;
+	#t;
+	#n;
+	#r(e) {
+		for (let [t, n] of this.b) n === e && h(t, this.c);
+	}
+	#i;
+}, A = class {
+	#e = /* @__PURE__ */ new WeakSet();
+	constructor(e) {
+		this.g = e.g, this.e = e.e, this.u = e.u, this.n = e.n, this.b = e.b;
+	}
+	get v() {
+		return this.g.v;
+	}
+	g;
+	b;
+	e;
+	u;
+	n;
+	a(e, t) {
+		return this.#e.add(e), this.g.a(e, t);
+	}
+	r(e) {
+		if (e) this.#e.has(e) && (this.#e.delete(e), this.g.r(e));
+		else for (let e of this.g.b.keys()) this.r(e);
+	}
+	d() {
+		this.r();
+	}
+}, j = class {
+	#e;
+	constructor(e) {
+		this.#e = e, this.get = e.u, e.u();
+	}
+	get name() {
+		return this.#e.m;
+	}
+	get $version() {
+		return this.get(), this.#e.v;
+	}
+	get value() {
+		return this.get();
+	}
+	set value(e) {
+		this.set?.(e);
+	}
+	set;
+	get;
+	ref(e) {
+		let t = new j(new A(this.#e));
+		return e && this.set ? g(t, this.set) : t;
+	}
+	reaction(e, t = this.#e.e) {
+		return this.#e.a(e, t ? 2 : 1);
+	}
+	subscribe(e, t = this.#e.e) {
+		let n = this.reaction(e, t);
+		return h(e, this.get()), n;
+	}
+	$valCompute(e) {
+		return this.#e.a(e, 3);
+	}
+	unsubscribe(e) {
+		this.#e.r(e);
+	}
+	dispose() {
+		this.#e.d();
+	}
+	toString() {
+		return String(this.get());
+	}
+	toJSON(e) {
+		let t = this.get();
+		return t && t.toJSON ? t.toJSON(e) : t;
+	}
+}, M = (e, t) => {
+	let n = e, r = new k(() => n, t);
+	return [new j(r), (e) => {
+		r.q?.(e, n) || (n = e, r.n());
+	}];
+}, N = (e, t) => g(...M(e, t)), P = (e, t, n) => new j(new k(e, n, t)), F = (e, t = l, n) => {
+	let r, i;
+	return P(() => {
+		let n = e.map(m);
+		return (!i || !d(n, i)) && (i = n, r = t(p(e))), r;
+	}, (t) => {
+		let n = e.map((e) => e.$valCompute(t));
+		return () => n.forEach(h);
+	}, n);
+}, I = (e, t) => {
+	let n = 0, r = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map(), a = (e) => {
+		if (!_(e)) {
+			if (!_(e?.$)) return e;
+			e = e.$;
+		}
+		return r.has(e) ? u(e.$version, r.get(e)) || r.set(e, c) : (i.delete(e) || e.$valCompute(s.n), r.set(e, e.$version)), e.value;
+	}, o, s = new k(() => {
+		if (!n) {
+			if (r.size) x: {
+				for (let [e, t] of r) if (!u(e.$version, t)) break x;
+				return o;
+			}
+			let e = r;
+			r = i, i = e, n++;
+		}
+		if (o = e(a), !--n && i.size) {
+			for (let e of i.keys()) e.unsubscribe(s.n);
+			i.clear();
+		}
+		return o;
+	}, t, () => () => {
+		if (r.size) {
+			for (let e of r.keys()) e.unsubscribe(s.n);
+			r.clear();
+		}
+	});
+	return new j(s);
+}, L = (e, t = l, n) => {
+	let r, i = c;
+	return P(() => {
+		let n = e.$version;
+		return u(n, i) || (i = n, r = t(e.value)), r;
+	}, (t) => e.$valCompute(t), n);
+};
+process.env.NODE_ENV !== "production" && y();
+//#endregion
+//#region ../../node_modules/.bun/use-value-enhancer@5.0.7+5fffd67310d91248/node_modules/use-value-enhancer/dist/use-value-enhancer.mjs
+var R = (e) => _(e) ? e : _(e?.$) ? e.$ : void 0, z = () => {}, B = () => z, V = [B, B], H = e.useSyncExternalStore ? (t, n = !0) => {
+	let [r, a, s] = o(() => {
+		let e = R(t);
+		return e && [
+			(t) => e.subscribe(t, n),
+			() => e.$version,
+			e
+		];
+	}, [t, n]) ?? V, c = e.useSyncExternalStore(r, a, a), l = o(() => s ? s.get() : t, [
+		c,
+		s,
+		t
+	]);
+	return i(l), l;
+} : (e, t = !0) => {
+	let n = o(() => R(e), [e]), [r, c] = s(() => n?.$version);
+	a(() => {
+		if (n) {
+			let e = () => n.$version;
+			return n.subscribe(() => c(e), t);
+		}
+	}, [n, t]);
+	let l = o(() => n ? n.get() : e, [
+		r,
+		n,
+		e
+	]);
+	return i(l), l;
+}, U = /* @__PURE__ */ t(null), W = ({ i18n: e, children: t }) => {
+	let i = H(e.t$), a = r(U)?.t;
+	return n(U.Provider, {
+		value: o(() => ({
+			t: a ? (e, t) => {
+				let n = i(e, t);
+				return n === e ? a(e, t) : n;
+			} : i,
+			i18n: e
+		}), [i, a]),
+		children: t
+	});
+}, G = (e) => {
+	let t = r(U);
+	if (!t && !e) throw Error("I18nProvider not found");
+	return t;
+}, K = (e) => G(e)?.t, q = (e) => G(e)?.i18n, J = (e) => H(q(e)?.lang$), Y = (e) => e === !0 || e === !1, X = (e) => typeof e == "string", Z = Array.isArray, Q = (e) => typeof e == "object" && !!e, $ = (e) => Q(e) && !Z(e), te = (e) => $(e) ? e : void 0;
+//#endregion
+export { N as _, te as a, J as c, g as d, F as f, u as g, M as h, X as i, K as l, L as m, Y as n, W as o, I as p, $ as r, q as s, Z as t, H as u };

package/dist/browser/flow-authoring-node.d.ts

@@ -52,7 +52,10 @@ export declare function createManagedTask(target: GraphTarget, identity: {
 export declare function createAgentTask(target: GraphTarget, identity: {
     readonly nodeId: string;
     readonly taskId: string;
-}, name: string): readonly ChangeOperation[];
+}, name: string, defaults?: {
+    readonly prompt?: string;
+    readonly outputDescription?: string;
+}): readonly ChangeOperation[];
 export declare function createLlmTask(target: GraphTarget, identity: {
     readonly nodeId: string;
     readonly taskId: string;

package/dist/browser/flow-authoring.js

@@ -4508,8 +4508,7 @@ var Lc = T(D([E({
 			kind: k("agent"),
 			code: Js().optional(),
 			model: A,
-			prompt: $c,
-			system: A,
+			prompt: A,
 			maxRounds: w(),
 			tools: T(E({
 				id: A,
@@ -15730,7 +15729,8 @@ function jg(e, t, n, r = void 0, i = {
 			task: {
 				capabilities: i.capabilities ?? [{
 					kind: "connector",
-					mode: "shared"
+					mode: "independent",
+					actions: []
 				}],
 				inputs: i.inputs,
 				moduleId: t.moduleId,
@@ -15759,7 +15759,7 @@ function Mg(e, t, n) {
 		target: e
 	}];
 }
-function Ng(e, t, n) {
+function Ng(e, t, n, r = {}) {
 	if (e.kind != "flow") throw Error("Agent nodes are only supported in the root Flow.");
 	return Mg(e, t, {
 		name: n,
@@ -15772,16 +15772,13 @@ function Ng(e, t, n) {
 		outputs: [{
 			handle: "output",
 			jsonSchema: { type: "string" },
-			nullable: !1
+			nullable: !1,
+			description: r.outputDescription ?? "The final result produced by the Agent."
 		}],
 		executor: {
 			kind: "agent",
 			model: "deepseek-v4-flash",
-			system: "",
-			prompt: {
-				kind: "value",
-				value: ""
-			},
+			prompt: r.prompt ?? "Summarize the following content, highlighting key points and next steps.\n\n{{input}}",
 			maxRounds: 10,
 			tools: []
 		}

package/dist/browser/flow-change.d.ts

@@ -1,11 +1,10 @@
+import type { JsonValue, Port, PortDefinition } from '../index.js';
 export { fixedInputValue, inputValue, inputValues } from './flow-input-value.js';
 import type { WebhookMethod } from './webhook-method.js';
 import { currentFlowModelVersion } from './flow-change-schema.js';
 export { changeOperationsSchema, currentFlowModelVersion, decodeChangeOperations } from './flow-change-schema.js';
 export type { WebhookMethod };
-export type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
-    readonly [key: string]: JsonValue;
-};
+export type { JsonValue, Port, PortDefinition } from '../index.js';
 export type SchemaKeyword = 'const' | 'enum' | 'exclusiveMaximum' | 'exclusiveMinimum' | 'maximum' | 'maxItems' | 'maxLength' | 'maxProperties' | 'minimum' | 'minItems' | 'minLength' | 'minProperties' | 'multipleOf' | 'pattern' | 'required' | 'type';
 export type SchemaMismatch = {
     readonly kind: 'artifact' | 'binary' | 'nullable';
@@ -24,17 +23,9 @@ export declare const resourceNameMaxLength = 80;
 export type ResourceNameIssue = 'controlCharacter' | 'empty' | 'specialCharacter' | 'tooLong';
 export declare function resourceNameIssue(value: string): ResourceNameIssue | undefined;
 export declare function validVariableName(value: string): boolean;
-export interface PortDefinition {
-    readonly description?: string;
-    readonly jsonSchema: JsonValue;
-    readonly nullable: boolean;
-}
 export interface InputPortDefinition extends PortDefinition {
     readonly value?: JsonValue;
 }
-export interface Port extends PortDefinition {
-    readonly handle: string;
-}
 export interface InputPort extends InputPortDefinition {
     readonly handle: string;
 }
@@ -139,10 +130,7 @@ export type ManagedTaskExecutor = {
     readonly kind: 'agent';
     readonly code?: boolean;
     readonly model: string;
-    readonly prompt: Exclude<AgentInput, {
-        readonly kind: 'model';
-    }>;
-    readonly system: string;
+    readonly prompt: string;
     readonly maxRounds: number;
     readonly tools: readonly AgentTool[];
     readonly notification?: {

package/dist/browser/flow-change.js

@@ -4563,8 +4563,7 @@ var jc = B(U([V({
 			kind: K("agent"),
 			code: Us().optional(),
 			model: q,
-			prompt: qc,
-			system: q,
+			prompt: q,
 			maxRounds: z(),
 			tools: B(V({
 				id: q,