@punica/editor 1.4.1 → 1.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punica/editor",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "Punica Editor",
   "private": false,
   "type": "module",

package/types/punica.module.flow.agent.d.ts

@@ -66,7 +66,7 @@ declare module 'punica' {
           workspaceId?: string;
         }
       ): Promise<{ output?: JSONValue; runId: string; durationMs: number }>;
-      /** Wrap an agent document in a transient FlowBook envelope. */
+      /** Wrap an agent document in a transient Workflow envelope. */
       envelope(manifest: unknown): unknown;
       /** True when the value looks like a runnable IvyAgent manifest. */
       isAgentManifest(manifest: unknown): boolean;

package/types/punica.module.flow.d.ts

@@ -170,16 +170,16 @@ declare module 'punica' {
 
     /**
      * Validator API surface (host/extension implementation).
-     * Validates FlowBookDocument.
+     * Validates WorkflowDocument.
      *
      * `options.hasCapability` mirrors the top-level
-     * `validateFlowBookDocument` Trinity seam — implementers thread it
-     * into `flowBookValidator` so registry lookups stay pure and
+     * `validateWorkflowDocument` Trinity seam — implementers thread it
+     * into `workflowValidator` so registry lookups stay pure and
      * substitutable (capability registry + CONSTITUTION § 0.1).
      */
     export interface Validator {
       validate(
-        spec: FlowBookDocument,
+        spec: WorkflowDocument,
         options?: {
           mode?: 'strict' | 'best-effort';
           hasCapability?: CapabilityLookup;
@@ -192,10 +192,10 @@ declare module 'punica' {
     };
 
     /**
-     * Validates a FlowBookDocument. Top-level helper exposed on `punica.flow`.
+     * Validates a WorkflowDocument. Top-level helper exposed on `punica.flow`.
      *
      * Pass `options.hasCapability` to enable Trinity verification — the
-     * validator checks every `ivyNode` / `flowBook` `ref.id` against
+     * validator checks every `ivyNode` / `workflow` `ref.id` against
      * that predicate and emits `WF_UNKNOWN_CAPABILITY` errors (strict)
      * or warnings (best-effort) for any miss. Substrate's
      * `validator.module.ts` wires this to
@@ -203,8 +203,8 @@ declare module 'punica' {
      * Trinity check is skipped (keeps the validator usable in
      * registry-less unit tests).
      */
-    export function validateFlowBookDocument(
-      spec: FlowBookDocument,
+    export function validateWorkflowDocument(
+      spec: WorkflowDocument,
       options?: {
         mode?: 'strict' | 'best-effort';
         hasCapability?: CapabilityLookup;
@@ -221,7 +221,7 @@ declare module 'punica' {
       ivy?: {
         /**
          * Optional annotation: which capability this cell belongs to (not required).
-         * Source-of-truth contract is CapabilityDefinition on IvyNode/FlowBook.
+         * Source-of-truth contract is CapabilityDefinition on IvyNode/Workflow.
          */
         capability?: {
           id?: CapabilityId;
@@ -310,7 +310,7 @@ declare module 'punica' {
     }
 
     /**
-     * Capability ID (IvyNode and FlowBook are both CapabilityDefinition-based).
+     * Capability ID (IvyNode and Workflow are both CapabilityDefinition-based).
      */
     export type CapabilityId = string;
 
@@ -348,7 +348,7 @@ declare module 'punica' {
      * -------------------------
      * Generic graph IR (the core)
      * -------------------------
-     * Used by FlowBook now; intended to be reused by agent/mcp/rest later.
+     * Used by Workflow now; intended to be reused by agent/mcp/rest later.
      */
     export type GraphId = string;
     export type NodeId = string;
@@ -403,7 +403,7 @@ declare module 'punica' {
     }
 
     /**
-     * Reserved pseudo IO node ids (for FlowBook wiring).
+     * Reserved pseudo IO node ids (for Workflow wiring).
      * If edges use these ids, they must exist as nodes in Graph.nodes.
      */
     export type FlowIoNodeId = 'flow-input' | 'flow-output';
@@ -422,14 +422,14 @@ declare module 'punica' {
       version?: string;
     }
 
-    export interface FlowBookRef {
-      kind: 'flowBook';
+    export interface WorkflowRef {
+      kind: 'workflow';
       id: CapabilityId;
       version?: string;
       /**
        * Optional inline definition for local experiments (no registry publishing).
        */
-      inline?: FlowBookDocument;
+      inline?: WorkflowDocument;
     }
 
     /**
@@ -452,7 +452,7 @@ declare module 'punica' {
       | FlowInputRef
       | FlowOutputRef
       | NodeCapabilityRef
-      | FlowBookRef
+      | WorkflowRef
       | PrimitiveRef;
 
     /**
@@ -465,11 +465,11 @@ declare module 'punica' {
     }
 
     /**
-     * FlowBook = GraphDocumentBase with FlowBook discriminators.
+     * Workflow = GraphDocumentBase with Workflow discriminators.
      */
-    export interface FlowBookDocument extends GraphDocumentBase {
-      apiVersion: 'ivy.flowbook/v0.1';
-      kind: 'FlowBook';
+    export interface WorkflowDocument extends GraphDocumentBase {
+      apiVersion: 'ivy.workflow/v0.1';
+      kind: 'Workflow';
     }
 
     /**

package/types/punica.module.flow.engine.d.ts

@@ -170,7 +170,7 @@ declare module 'punica' {
       }
 
       export interface StartRunInput {
-        spec: flow.FlowBookDocument;
+        spec: flow.WorkflowDocument;
         workspaceId?: string;
         filePathOrUri?: string;
         /**
@@ -211,7 +211,7 @@ declare module 'punica' {
         }): boolean;
         rejectPending(input: { pendingId: string }): boolean;
         /**
-         * Spawn a child run for a `FlowBookDocument` and await its
+         * Spawn a child run for a `WorkflowDocument` and await its
          * terminal state (subflow spawning). Substrate enforces
          * `MAX_SUBFLOW_DEPTH` and rejects synchronously when
          * `(parentDepth ?? 0) + 1` exceeds the cap. The child run

package/types/punica.module.flow.primitives.d.ts

@@ -5,8 +5,8 @@ declare module 'punica' {
   // eslint-disable-next-line @typescript-eslint/no-namespace
   export namespace flow {
     /**
-     * Trinity verification seam — every `ivyNode` / `flowBook` ref in a
-     * `FlowBookDocument` is checked against this predicate at validation
+     * Trinity verification seam — every `ivyNode` / `workflow` ref in a
+     * `WorkflowDocument` is checked against this predicate at validation
      * time. Substrate's `validator.module.ts` plumbs it through
      * `unifiedCapabilityRegistry.getCapability(...)`; unit tests inject
      * a deterministic set without touching the registry.
@@ -21,7 +21,7 @@ declare module 'punica' {
     export type CapabilityLookup = (capabilityId: string) => boolean;
 
     /**
-     * Built-in primitive node kinds carried by `FlowBookDocument` graphs.
+     * Built-in primitive node kinds carried by `WorkflowDocument` graphs.
      * Substrate ships the executor surface (4.C); host extensions can
      * register additional kinds via the node registry. Primitives are
      * deliberately small — they exist so a domain author can compose
@@ -69,7 +69,7 @@ declare module 'punica' {
     export interface FlowMigrationTransformer {
       from: string;
       to: string;
-      transform(doc: FlowBookDocument): FlowBookDocument;
+      transform(doc: WorkflowDocument): WorkflowDocument;
     }
 
     /**
@@ -81,7 +81,7 @@ declare module 'punica' {
 
     /**
      * One finding produced by a lint rule. `path` is a dot-path into
-     * `FlowBookDocument` (e.g. `graph.nodes[2].ref.id`); `nodeId` is the
+     * `WorkflowDocument` (e.g. `graph.nodes[2].ref.id`); `nodeId` is the
      * resolved node id when applicable. `code` is the rule's stable
      * machine identifier (e.g. `WF_UNKNOWN_CAPABILITY`).
      */
@@ -129,7 +129,7 @@ declare module 'punica' {
     /**
      * Substrate-shipped lint aggregator (flow linter). Pure analyzer:
      * `lint(spec, ctx?)` runs every registered rule against the
-     * `FlowBookDocument` and returns a single aggregated
+     * `WorkflowDocument` and returns a single aggregated
      * `FlowLintResult`. `register` / `unregister` let extensions
      * add custom rules without forking the substrate. The default
      * rule set (7 rules — `capability-not-declared`,
@@ -139,7 +139,7 @@ declare module 'punica' {
      * substrate; `reset()` restores it.
      */
     export interface FlowLinter {
-      lint(spec: FlowBookDocument, ctx?: FlowLintContext): FlowLintResult;
+      lint(spec: WorkflowDocument, ctx?: FlowLintContext): FlowLintResult;
       register(rule: FlowLintRule): void;
       unregister(ruleId: string): boolean;
       list(): readonly string[];
@@ -155,7 +155,7 @@ declare module 'punica' {
     export interface FlowLintRule {
       id: string;
       severity: FlowLintSeverity;
-      check(spec: FlowBookDocument, ctx: FlowLintContext): FlowLintIssue[];
+      check(spec: WorkflowDocument, ctx: FlowLintContext): FlowLintIssue[];
     }
 
     /**
@@ -455,7 +455,7 @@ declare module 'punica' {
     /**
      * Substrate-shipped registry for `CheckpointMigrator` entries.
      * Same shape as `MigrationRegistry` (4.F) but operates on
-     * checkpoint payloads rather than FlowBookDocuments. Substrate
+     * checkpoint payloads rather than WorkflowDocuments. Substrate
      * ships an EMPTY registry — hosts inject migrators when the
      * checkpoint version moves forward.
      */
@@ -524,7 +524,7 @@ declare module 'punica' {
     export const primitives: PrimitivesApi;
 
     /**
-     * Policy for handling a `FlowBookDocument` whose `version` differs
+     * Policy for handling a `WorkflowDocument` whose `version` differs
      * from the runtime's expected version (flow migration).
      *
      *  - `'auto-migrate'` — attempt to apply registered transformers
@@ -563,7 +563,7 @@ declare module 'punica' {
     export type MigrationResult =
       | {
           ok: true;
-          document: FlowBookDocument;
+          document: WorkflowDocument;
           appliedTransformers: readonly string[];
           fromVersion: string;
           toVersion: string;
@@ -572,7 +572,7 @@ declare module 'punica' {
           ok: false;
           reason: MigrationFailureReason;
           message: string;
-          partialDocument?: FlowBookDocument;
+          partialDocument?: WorkflowDocument;
           appliedTransformers: readonly string[];
         };
 
@@ -586,7 +586,7 @@ declare module 'punica' {
      * target), substrate returns `{ ok: true, appliedTransformers: [] }`.
      */
     export interface MigrationInvocation {
-      document: FlowBookDocument;
+      document: WorkflowDocument;
       targetVersion: string;
       policy?: VersionMismatchPolicy;
     }
@@ -649,7 +649,7 @@ declare module 'punica' {
      * session, so a parent's `'once'` approval is naturally honored
      * by the child as long as `workspaceId` matches — F33 dedup).
      *
-     *  - `spec`           — required `FlowBookDocument` to run.
+     *  - `spec`           — required `WorkflowDocument` to run.
      *  - `workspaceId`    — inherited from the parent run; the
      *                       substrate refuses to spawn a subflow into
      *                       a different workspace by default.
@@ -669,7 +669,7 @@ declare module 'punica' {
      *                       notebookCell-backed flows.
      */
     export interface SubflowInvocation {
-      spec: FlowBookDocument;
+      spec: WorkflowDocument;
       workspaceId?: string;
       input?: JSONValue;
       parentRunId?: string;

package/types/punica.module.kernel.llm.d.ts

@@ -54,7 +54,7 @@ declare module 'punica' {
         /**
          * Product ID that this instruction class belongs to.
          * Used for product-scoped routing.
-         * Example: 'ivy-node', 'ivy-agent', 'ivy-mcp', 'ivy-flowbook'
+         * Example: 'ivy-node', 'ivy-agent', 'ivy-mcp', 'ivy-workflow'
          */
         productId?: string;
       }
@@ -255,7 +255,7 @@ declare module 'punica' {
         ): Promise<CapabilityResult>;
 
         /**
-         * Generate FlowBook IR from natural language query.
+         * Generate Workflow IR from natural language query.
          */
         plan(input: {
           query: string;
@@ -300,10 +300,10 @@ declare module 'punica' {
         }): Promise<CapabilityResult>;
 
         /**
-         * Edit and optimize FlowBook IR structures.
+         * Edit and optimize Workflow IR structures.
          */
         editWorkflow(input: {
-          flowBook: ivy.FlowBookDocument;
+          workflow: ivy.WorkflowDocument;
           requirements?: string;
           context?: {
             workspaceId?: string;