@unoverse-platform/studio 0.1.113 → 0.1.114

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unoverse-platform/studio",
-  "version": "0.1.113",
+  "version": "0.1.114",
   "type": "module",
   "description": "Unoverse Studio: the local authoring app. Reads your own rx/ folder, no backend.",
   "scripts": {

package/vendor/base/src/definitions/load/load.ts

@@ -184,7 +184,7 @@ export function loadDefinition(
             if (m.preview && typeof m.preview === "object") def.preview = m.preview as Record<string, string[]>;
             // THE WORKFLOW THAT WORKS IT (UNOVERSE_HOST_PAGE.md rule 4): the manifest names it,
             // and the page reads it here to start a call on it.
-            if (m.binding && typeof m.binding === "object") def.binding = m.binding as { workflow?: string; trigger?: string };
+            if (m.binding && typeof m.binding === "object") def.binding = m.binding as { workflow?: string; trigger?: string; pipeline?: string };
             // SPATIAL-CAPABLE, exactly as a component is (§9c, ruled 2026-08-30): a
             // template is found by what a guest says, through the same projection, the
             // same registry switch and the same embedded text. The difference is only

package/vendor/base/src/definitions/model.ts

@@ -52,7 +52,7 @@ export interface UnoverseDefinition {
   /** TEMPLATES: the workflow that works this template as a task, from its manifest.yaml
    *  (docs/unoverse/design/sdk/UNOVERSE_HOST_PAGE.md rule 4). A page starts a call on it from
    *  the avatar; a template without one starts nothing. */
-  binding?: { workflow?: string; trigger?: string };
+  binding?: { workflow?: string; trigger?: string; pipeline?: string };
   /** Source basename for FILE definitions (atoms) — the identity refs resolve by. */
   file?: string;
   /** The client org it belongs to (server-injected from its folder, never

package/vendor/base/src/definitions/registry/objects.ts

@@ -114,6 +114,8 @@ export interface ObjectMatching {
   ruleOut?: string[];
   /** The node that decides a name the rules leave open (TypeSafeChoice). Absent, an open name goes to review. */
   judge?: string;
+  /** The lines (by name, e.g. a document's `about`) whose name, sure to be no record held, makes the record. A mention on any other line never does. */
+  createFrom?: string[];
 }
 
 /**

package/vendor/base/src/definitions/registry/pipelines.ts

@@ -31,7 +31,7 @@ import { pipelineFindings, firstRefusal, PIPELINE_READ_KEYS } from "../../lint/o
 export interface CollectStep {
   /** The step's name; a later step reads its outputs as `{{ collect.<name>.<output> }}`. */
   name: string;
-  /** The marketplace node it runs. */
+  /** The marketplace node it runs, or `InputTrigger` as the first step: the pipeline's door (README, `collect`). */
   node: string;
   /** The node's config, with `{{ config.* }}` and `{{ collect.* }}` references. */
   config: Record<string, unknown>;

package/vendor/base/src/lint/design/file.mjs

@@ -461,8 +461,8 @@ function lintFile(file) {
       // TEMPLATE manifest = the envelope. Requires binding + a resolvable root.
       if (!json.name) report("warn", file, `app manifest missing "name": the display name (docs.unoverse.ai/design/apps)`);
       checkDiscoveryMeta(report, file, json, "app", "docs.unoverse.ai/design/apps");
-      if (!(json.binding && json.binding.workflow))
-        report("warn", file, `template manifest has no binding.workflow. The app owns its workflow binding (docs.unoverse.ai/design/apps)`);
+      if (!(json.binding && (json.binding.workflow || json.binding.pipeline)))
+        report("warn", file, `template manifest has no binding.workflow or binding.pipeline. The app owns its workflow binding (docs.unoverse.ai/design/apps)`);
       // Two valid roots (definitions.ts:229): the STANDARD manifest-only form (root =
       // layouts/<layout>), OR a `<name>` envelope OVERRIDE (its own root). Only the
       // manifest-only form must resolve a layout; an envelope-form template supplies its own.

package/vendor/base/src/lint/objects/rules.mjs

@@ -23,7 +23,7 @@ export const KEBAB = /^[a-z0-9]+(-[a-z0-9]+)*$/;
 const REF_OR_EXPR = /[{}]|^\s*return\b/;
 
 /** The twelve elements of the vocabulary (docs/unoverse/data/objects/elements/): what an object IS. */
-export const ELEMENTS = new Set(["purpose", "story", "content", "capability", "process", "asset", "task", "journey", "channel", "organisation", "people", "product", "brand", "document"]);
+export const ELEMENTS = new Set(["purpose", "story", "content", "capability", "process", "asset", "task", "journey", "channel", "organisation", "people", "product", "brand", "document", "observation"]);
 
 /** The face every object and pipeline carries, as a node's node.yaml does. */
 export const FACE_KEYS = ["title", "description", "whenToUse", "category", "version"];
@@ -110,13 +110,14 @@ export function envelopeFindings(name, envelope, file = `${name}.yaml`) {
   if (envelope.matching != null) {
     const m = envelope.matching;
     const fields = (v) => Array.isArray(v) && v.length > 0 && v.every((f) => typeof f === "string" && f);
-    if (!isRecord(m)) refuse(`object ${name}: matching is a record: ids, names, remember, evidence, ruleOut, judge`);
+    if (!isRecord(m)) refuse(`object ${name}: matching is a record: ids, names, remember, evidence, ruleOut, judge, createFrom`);
     else {
       if (!fields(m.names)) refuse(`object ${name}: matching: names lists the fields that hold this object's names`);
       for (const k of ["ids", "evidence", "ruleOut"]) if (m[k] != null && !fields(m[k])) refuse(`object ${name}: matching: ${k} is a list of field names`);
+      if (m.createFrom != null && !fields(m.createFrom)) refuse(`object ${name}: matching: createFrom is a list of line names (about)`);
       if (m.remember != null && (typeof m.remember !== "string" || !(m.names ?? []).includes(m.remember))) refuse(`object ${name}: matching: remember names one of names, the list a confirmed name is added to`);
       if (m.judge != null && (typeof m.judge !== "string" || !/^[A-Z][A-Za-z0-9]*$/.test(m.judge))) refuse(`object ${name}: matching: judge names a node by its type (TypeSafeChoice)`);
-      for (const k of Object.keys(m)) if (!["ids", "names", "remember", "evidence", "ruleOut", "judge"].includes(k)) say(`object ${name}: matching: "${k}" is not a word here`);
+      for (const k of Object.keys(m)) if (!["ids", "names", "remember", "evidence", "ruleOut", "judge", "createFrom"].includes(k)) say(`object ${name}: matching: "${k}" is not a word here`);
     }
   }
   return out;
@@ -333,6 +334,7 @@ export function pipelineFindings(name, file, fileName = "pipeline.yaml") {
         return;
       }
       if (stepNames.has(s.name)) refuse(`pipeline ${name}: two collect steps named "${s.name}"`);
+      if (s.node === "InputTrigger" && i > 0) refuse(`pipeline ${name}: collect step "${s.name}" is an Input Trigger, which only opens a pipeline: make it the first step (docs/unoverse/data/pipelines/README.md, collect)`);
       // A step reads only what came before it.
       for (const ref of collectRefs(s.config)) if (!stepNames.has(ref)) say(`pipeline ${name}: collect step "${s.name}" reads collect.${ref}, which is not an earlier step`);
       stepNames.add(s.name);
@@ -438,7 +440,8 @@ export function pipelineFolderFindings(name, { file, config, test }, { nodeTypes
   const out = [];
   if (!isRecord(file)) return out;
   const steps = Array.isArray(file.collect) ? file.collect.filter(isRecord) : [];
-  if (nodeTypes) for (const s of steps) if (typeof s.node === "string" && !nodeTypes.has(s.node)) out.push({ file: "pipeline.yaml", msg: `pipeline ${name}: collect step "${s.name}" names node "${s.node}", which neither the marketplace nor this org holds. A step runs a node the org has` });
+  // The Input Trigger is the engine's own node, not a marketplace one: the pipeline's door (README, collect).
+  if (nodeTypes) for (const s of steps) if (typeof s.node === "string" && s.node !== "InputTrigger" && !nodeTypes.has(s.node)) out.push({ file: "pipeline.yaml", msg: `pipeline ${name}: collect step "${s.name}" names node "${s.node}", which neither the marketplace nor this org holds. A step runs a node the org has` });
   if (objectNames && isRecord(file.make)) for (const object of Object.keys(file.make)) if (!objectNames.has(object)) out.push({ file: "pipeline.yaml", msg: `pipeline ${name}: make.${object} names an object neither the marketplace nor this org holds. What a pipeline makes is an object folder: design/<tier>/objects/${object}/` });
   const props = isRecord(config?.configSchema?.properties) ? new Set(Object.keys(config.configSchema.properties)) : null;
   const refs = configRefs(file);

package/vendor/sdk/appEngine.ts

@@ -227,6 +227,7 @@ export function mountAppEngine(el: HTMLElement, first: AppConfig): AppEngine {
   // A PAGE TEMPLATE'S TASK, called at its own workflow's trigger with the user's token.
   // `metadata.task` names the task its Task Runner loads; the submit carries the answers.
   const startTask = async (b: Binding, task: string, submit?: Record<string, unknown>) => {
+    if (b.pipeline) return startPipeline(b.pipeline, submit ?? {});
     if (!b.workflow) return;
     inTask = true;
     syncConnection();
@@ -248,6 +249,27 @@ export function mountAppEngine(el: HTMLElement, first: AppConfig): AppEngine {
     }).catch((e) => console.error("[unoverse] task start failed", e));
   };
 
+  // A TEMPLATE BOUND TO A PIPELINE (docs/unoverse/data/pipelines/README.md, collect): the answers go
+  // to the pipeline's Input Trigger, called as a workflow is, `/api/pipelines/<org>/<name>/execute`,
+  // the org the app's own. The server shows the run live in this conversation, as it shows a
+  // workflow task (the agent-card, its steps from the run's traces), so nothing here follows it;
+  // the receipt is written into template state as `run`.
+  const startPipeline = async (name: string, answers: Record<string, unknown>) => {
+    const org = appId.includes("/") ? appId.split("/")[0] : "";
+    const token = cfg.getAccessToken ? await cfg.getAccessToken() : null;
+    try {
+      const res = await fetch(`${cfg.apiUrl ?? cfg.serverUrl}/api/pipelines/${encodeURIComponent(org)}/${encodeURIComponent(name)}/execute`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...(token ? { Authorization: `Bearer ${token}` } : {}) },
+        body: JSON.stringify({ input: answers, conversationId: cfg.conversationId, chatId: cfg.conversationId }),
+      });
+      store.mergeAppState({ run: await res.json().catch(() => ({ status: res.ok ? "STARTED" : "FAILED" })) });
+    } catch (e) {
+      console.error("[unoverse] pipeline run failed", e);
+      store.mergeAppState({ run: { status: "FAILED", error: String((e as Error)?.message ?? e) } });
+    }
+  };
+
   const onAction: ActionHandler = (action, data, meta) => {
     const t = typeof action === "string" ? action : (action as { type?: string })?.type;
     const d = (data ?? {}) as Record<string, unknown>;

package/vendor/sdk/lib/dom/component.ts

@@ -282,10 +282,15 @@ export function mountComponent(options: ComponentOptions): ComponentMount {
       tree.destroy();
       show([message(doc, text)]);
     };
-    // Loading and error hints carry NO styling: the SDK owns zero styles.
+    // An error carries NO styling: the SDK owns zero styles. Loading shows nothing: a comment
+    // holds the component's place until the drawing arrives, so a slide never flashes a line.
+    const hold = () => {
+      tree.destroy();
+      show([doc.createComment(`loading ${defUri ?? "component"}`)]);
+    };
     if (error) return say(`Unoverse error: ${error}`);
-    if (o.store && !o.store.getType(o.chatId ?? "", o.nodeId ?? "")) return say("waiting for COMPONENT_INIT…");
-    if (!def || !theme) return say(`Loading ${defUri ?? "component"}…`);
+    if (o.store && !o.store.getType(o.chatId ?? "", o.nodeId ?? "")) return hold();
+    if (!def || !theme) return hold();
     // Defaults beneath; the app's state, then the definition's own state, then the
     // instance's values above; a value the component wrote itself on top (static source).
     const merged = o.store

package/vendor/sdk/lib/dom/primitives.ts

@@ -534,8 +534,12 @@ export function inputView(ctx: RenderCtx): Prim {
     const max = maxLength();
     // Focus moves BEFORE the store round-trip, so a fast typist's next key lands next door.
     if (advanceOnFill() && max != null && t.length >= max) stepFocus(1);
-    if (field() != null) ctx.onAction?.("input", { text: t, field: field() });
-    else local = t;
+    if (field() != null) {
+      ctx.onAction?.("input", { text: t, field: field() });
+      // The store tells the page on the next frame; until then the field shows what was typed,
+      // not the old value, so a fast typist's next key lands after it, not in an emptied box.
+      data = { ...data, [field()!]: t };
+    } else local = t;
     show();
   };
   const submit = () => {

package/vendor/sdk/pageInterfaces.ts

@@ -67,7 +67,7 @@ const avatars = new Set<HTMLElement>();
 const CALL_PHASES = ["listening", "speaking"];
 
 /** The workflow a template names in its manifest (UNOVERSE_HOST_PAGE.md rule 4). */
-export type Binding = { workflow?: string; trigger?: string };
+export type Binding = { workflow?: string; trigger?: string; pipeline?: string };
 
 /** THE TASK IN VIEW: the marked template, not an avatar, spanning the middle of the screen. */
 function taskInView(doc: Document): HTMLElement | null {
@@ -152,6 +152,7 @@ function mountPageTemplate(o: PageTemplateOptions): { refresh(): void; destroy()
     // `props`, keyed by part, merge into those parts. THE SAME TEMPLATE, STREAMED, hydrates this
     // copy part by part; a copy still on its first step moves to the next as its values land.
     let lastProps = "";
+    let lastStep: string | undefined;
     let lastStreamed = "";
     const lastPart = new Map<string, string>();
     const fillParts = (byPart: Record<string, unknown>) => {
@@ -176,7 +177,12 @@ function mountPageTemplate(o: PageTemplateOptions): { refresh(): void; destroy()
           fillParts(task.props);
         }
       }
-      moveTo(task?.step);
+      // A NEW STEP MOVES IT, once. A step the person took since (Enter) stands until the task
+      // publishes another: the latest move wins, wherever it was made.
+      if (task?.step !== lastStep) {
+        lastStep = task?.step;
+        moveTo(task?.step);
+      }
       for (const r of appStore.getResponses()) {
         for (const pointer of r.components) {
           const { chatId, nodeId } = appStore.split(pointer);
@@ -288,7 +294,7 @@ function mountPageTemplate(o: PageTemplateOptions): { refresh(): void; destroy()
     .then((raw) => {
       if (!alive || !raw) return;
       const d = raw as UnoverseDefinition & { defaultLayout?: string; layouts?: Record<string, unknown>; sections?: Record<string, Section[]>; binding?: Binding; stateTree?: StateTree };
-      if (d.binding?.workflow) o.onBinding(uri, d.binding);
+      if (d.binding?.workflow || d.binding?.pipeline) o.onBinding(uri, d.binding);
       def = d;
       const base = d.defaultLayout ?? (d.layouts ? Object.keys(d.layouts)[0] : undefined);
       parts = [];
@@ -299,6 +305,8 @@ function mountPageTemplate(o: PageTemplateOptions): { refresh(): void; destroy()
           parts.push(nodeId);
           store.apply({ type: "COMPONENT_INIT", chatId: CHAT, nodeId, component: { type: ref, props: sec.seeds?.[ref] ?? {} } });
           if (sec.face) store.mergeComponentState(CHAT, nodeId, { state: sec.face });
+          // EVERY PART READ NOW, not when its face first shows: a step onto a slide draws at once.
+          client.readDefinition(`unoverse://components/${ref}`).catch(() => {});
         });
       }
       const ref = uri.replace(/^unoverse:\/\/templates\//, "");
@@ -366,7 +374,7 @@ export function mountPageInterfaces(o: PageInterfacesOptions): { destroy(): void
     if (action === "submit" || action === "cancel") {
       o.toServer(action, data, meta);
       const state = (meta?.state ?? data) as Record<string, unknown> | undefined;
-      if (action === "submit" && bindings[uri]?.workflow && state && typeof state === "object") o.startTask(bindings[uri], uri, state);
+      if (action === "submit" && (bindings[uri]?.workflow || bindings[uri]?.pipeline) && state && typeof state === "object") o.startTask(bindings[uri], uri, state);
     } else if (action === "startCall") {
       const t = target();
       if (!t || started.has(t)) return;