@foresthubai/workflow-core 0.4.4 → 0.4.5

package/src/expression/parser.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import jsep from "jsep";
 import type { DataType } from "../api";
 import { ResolvedExpr } from "./types";

package/src/expression/types.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { NodeOutput } from "../node";
 import type { DataType, Expression } from "../api";
 import type { Variable } from "../variable";

package/src/function/FunctionDeclaration.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { Expression, Schemas } from "../api";
 import type { ApiVariable } from "../variable";
 import type { DataType } from "../parameter";

package/src/function/index.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 export type { OutputAssignment, FunctionDeclaration, FunctionInfo } from "./FunctionDeclaration";
 export { toFunctionInfo } from "./FunctionDeclaration";
 export { serialize, deserialize } from "./serialization";

package/src/function/serialization.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { Expression } from "../api";
 import type { FunctionDeclaration, FunctionInfo } from "./FunctionDeclaration";
 import { toFunctionInfo } from "./FunctionDeclaration";

package/src/globals.d.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 /**
  * This package drops the `DOM` lib (see tsconfig.json) to stay headless, so the
  * Web Crypto `crypto` global is untyped. It exists at runtime everywhere we run

package/src/id/index.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 /**
  * Centralized UID creation for every entity in a workflow — nodes, edges,
  * channels, memory, models, declared variables, function arguments, and

package/src/index.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import { deserialize } from "./workflow/serialization";
 import { validateWorkflowState, type ValidationResult } from "./diagnostics/diagnostics";
 import type { ApiWorkflow } from "./workflow/Workflow";

package/src/memory/Memory.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { Schemas } from "../api";
 
 export type MemoryType = "MemoryFile" | "VectorDatabase";

package/src/memory/MemoryDefinition.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { Parameter } from "../parameter";
 import type { MemoryType } from "./Memory";
 

package/src/memory/MemoryFileDefinition.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { MemoryDefinition } from "./MemoryDefinition";
 
 /**

package/src/memory/MemoryRegistry.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { MemoryType } from "./Memory";
 import type { MemoryDefinition } from "./MemoryDefinition";
 import { MemoryFileDefinition } from "./MemoryFileDefinition";

package/src/memory/VectorDatabaseDefinition.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { MemoryDefinition } from "./MemoryDefinition";
 
 /**

package/src/memory/index.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 export type { MemoryType, Memory, MemoryRef } from "./Memory";
 export { ALL_MEMORY_TYPES } from "./Memory";
 export type { MemoryDefinition } from "./MemoryDefinition";

package/src/memory/serialization.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { Schemas } from "../api";
 import type { Memory } from "./Memory";
 

package/src/migration/index.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 export { CURRENT_SCHEMA_VERSION, BASELINE_SCHEMA_VERSION } from "./version";
 export { migrate, readSchemaVersion } from "./migrate";
 export { MIGRATIONS } from "./migrations";

package/src/migration/migrate.test.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import { describe, it, expect } from "vitest";
 import { migrate, readSchemaVersion } from "./migrate";
 import { CURRENT_SCHEMA_VERSION } from "./version";

package/src/migration/migrate.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { ApiWorkflow } from "../workflow/Workflow";
 import { MIGRATIONS, type Migration } from "./migrations";
 import { BASELINE_SCHEMA_VERSION, CURRENT_SCHEMA_VERSION } from "./version";

package/src/migration/migrations.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 /**
  * A single-step upgrade of the persisted workflow format, from `from` to
  * `from + 1`. Operates on the raw parsed document, never the domain types.

package/src/migration/version.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 /**
  * Persisted-format version this build reads and writes. A plain monotonic
  * integer, decoupled from the contract/package semver. Bump only when the

package/src/model/LLMModelDefinition.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { ModelDefinition } from "./ModelDefinition";
 
 /**

package/src/model/Model.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 // Domain Model — covers two distinct things that share a picker:
 //   1. The STATIC catalog (ModelInfo[]): the set of models the llmproxy already
 //      supports. Supplied to the editor as data (props), not declared per-workflow.

package/src/model/ModelDefinition.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { Parameter } from "../parameter";
 import type { ModelType } from "./Model";
 

package/src/model/ModelRegistry.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { ModelType } from "./Model";
 import type { ModelDefinition } from "./ModelDefinition";
 import { LLMModelDefinition } from "./LLMModelDefinition";

package/src/model/index.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 export type { ModelType, Model, ModelCapability, ModelInfo } from "./Model";
 export { ALL_MODEL_TYPES } from "./Model";
 export type { ModelDefinition } from "./ModelDefinition";

package/src/model/serialization.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { Schemas } from "../api";
 import type { Model, ModelCapability } from "./Model";
 

package/src/node/AgentNode.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import { NodeBase } from "./Node";
 import { OutputBinding, OutputDeclaration } from "../parameter";
 import type { Schemas } from "../api";

package/src/node/DataNode.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import { NodeBase } from "./Node";
 import type { Expression, Reference } from "../api";
 import { NodeCategory } from "./constants";

package/src/node/FunctionNode.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import { NodeBase } from "./Node";
 import type { Expression } from "../api";
 import type { FunctionInfo } from "../function";

package/src/node/InputNode.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import { NodeBase } from "./Node";
 import type { Expression } from "../api";
 import { OutputBinding } from "../parameter";

package/src/node/LogicNode.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import { NodeBase } from "./Node";
 import type { Expression } from "../api";
 import { NodeCategory } from "./constants";

package/src/node/MqttNode.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import { NodeBase } from "./Node";
 import type { Expression } from "../api";
 import { OutputBinding } from "../parameter";

package/src/node/Node.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 // Domain Node — the base shape every node variant builds on. NodeBase is the
 // generic, untyped-parameters shape used wherever a node is handled generically
 // (e.g. React Flow nodes); NodeData is the discriminated union over the

package/src/node/NodeDefinition.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import { NodeType } from "./Node";
 import { NodeCategory, NodeTag } from "./constants";
 import { OutputParameter, Parameter } from "../parameter";

package/src/node/NodeRegistry.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import { ReadPinNodeDefinition, SerialReadNodeDefinition, RetrieverNodeDefinition, WebFetchNodeDefinition } from "./InputNode";
 import { AgentNodeDefinition } from "./AgentNode";
 import {

package/src/node/OutputNode.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import { NodeBase } from "./Node";
 import type { Expression } from "../api";
 import { NodeCategory, NodeTag } from "./constants";

package/src/node/ToolNode.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import { NodeBase } from "./Node";
 import { NodeCategory } from "./constants";
 import { NodeDefinition } from "./NodeDefinition";

package/src/node/TriggerNode.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import { NodeBase } from "./Node";
 import type { Reference } from "../api";
 import { OutputBinding } from "../parameter";

package/src/node/constants.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 export enum NodeCategory {
   Input = "Input",
   Output = "Output",

package/src/node/index.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 // Base domain node types
 export type {
   NodeOutput,

package/src/node/methods.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import { NodeData, NodeOutput } from "./Node";
 import type { OutputBinding, OutputDeclaration } from "../parameter";
 import { PortDefinitions } from "./NodeDefinition";

package/src/node/serialization.test.ts

@@ -0,0 +1,51 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
+import { describe, it, expect } from "vitest";
+import { serialize, deserialize } from "./serialization";
+import type { Node } from "./Node";
+
+// Drafts save on purpose: a required-but-unset argument must serialize as
+// ABSENT — never as `undefined`, `""`, or (worst) `null` in the JSON file.
+
+function makeNode(type: string, args: Record<string, unknown>): Node {
+  return { id: "n1", type, position: { x: 0, y: 0 }, arguments: args } as unknown as Node;
+}
+
+describe("serialize: draft (incomplete) nodes", () => {
+  it("omits a required-but-unset argument entirely", () => {
+    const api = serialize(makeNode("ReadPin", {}), false);
+    expect("arguments" in api && api.arguments && "pinReference" in api.arguments).toBe(false);
+  });
+
+  it("emits no null/undefined values in the JSON form", () => {
+    const api = serialize(makeNode("OnThreshold", {}), false);
+    const json = JSON.parse(JSON.stringify(api)) as { arguments?: Record<string, unknown> };
+    expect(Object.values(json.arguments ?? {})).not.toContain(null);
+    expect(json).toEqual({ id: "n1", type: "OnThreshold", position: { x: 0, y: 0 }, arguments: {} });
+  });
+
+  it("unset MqttPublish qos stays absent instead of NaN→null", () => {
+    const api = serialize(makeNode("MqttPublish", { channelReference: "ch1" }), false);
+    const json = JSON.parse(JSON.stringify(api)) as { arguments: Record<string, unknown> };
+    expect("qos" in json.arguments).toBe(false);
+  });
+});
+
+describe("serialize: complete nodes", () => {
+  it("keeps configured required arguments", () => {
+    const api = serialize(makeNode("Delay", { delayMs: 250 }), false);
+    expect(api).toMatchObject({ arguments: { delayMs: 250 } });
+  });
+
+  it("maps MqttPublish qos from domain string to wire number", () => {
+    const api = serialize(makeNode("MqttPublish", { channelReference: "ch1", qos: "2" }), false);
+    expect(api).toMatchObject({ arguments: { qos: 2 } });
+  });
+
+  it("round-trips a configured node through deserialize", () => {
+    const node = makeNode("Ticker", { intervalValue: 5, intervalUnit: "seconds" });
+    const back = deserialize(serialize(node, false));
+    expect(back.arguments).toMatchObject({ intervalValue: 5, intervalUnit: "seconds" });
+  });
+});

package/src/node/serialization.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { Schemas } from "../api";
 import type { NodeData, Node } from "./Node";
 import type { Expression } from "../api";
@@ -17,6 +20,17 @@ export type ApiNode = Schemas["Node"];
  */
 export type ResolveFunctionInfo = (functionId: string) => FunctionInfo | undefined;
 
+/**
+ * A required wire field the workflow may not have yet: drafts save on purpose,
+ * and deserialize mirrors this with `??` fallbacks. serialize() emits such a
+ * field as absent (see the undefined-prune there); validate / check-schema /
+ * deploy are the strictness gates. This is the one deliberate spot where the
+ * api's "required" is relaxed — use it instead of `!` assertions.
+ */
+function draft<T>(value: T | undefined): T {
+  return value as T;
+}
+
 /**
  * Serialize a domain Node to the strict API format (Schemas["Node"]).
  * Strips hidden parameters (those whose activationRules are not met). The
@@ -39,6 +53,12 @@ export function serialize(node: Node, isToolInput: boolean): ApiNode {
     if (def) {
       pruneArguments(result.arguments, def.parameters, isToolInput);
     }
+    // Required-but-unset draft arguments (see draft()) are emitted as absent,
+    // so the in-memory node matches its JSON form.
+    const args = result.arguments as Record<string, unknown>;
+    for (const key of Object.keys(args)) {
+      if (args[key] === undefined) delete args[key];
+    }
   }
 
   return result;
@@ -52,7 +72,7 @@ function serializeNodeData(data: NodeData, position: { x: number; y: number }, i
         type: data.type,
         position: position,
         arguments: {
-          pinReference: data.arguments.pinReference!,
+          pinReference: draft(data.arguments.pinReference),
           signalType: data.arguments.signalType,
           output: data.arguments.output,
           toolDescription: data.arguments.toolDescription,
@@ -64,7 +84,7 @@ function serializeNodeData(data: NodeData, position: { x: number; y: number }, i
         type: data.type,
         position: position,
         arguments: {
-          portReference: data.arguments.portReference!,
+          portReference: draft(data.arguments.portReference),
           ...(data.arguments.prompt !== undefined ? { prompt: data.arguments.prompt } : {}),
           output: data.arguments.output,
         },
@@ -75,7 +95,7 @@ function serializeNodeData(data: NodeData, position: { x: number; y: number }, i
         type: data.type,
         position: position,
         arguments: {
-          pinReference: data.arguments.pinReference!,
+          pinReference: draft(data.arguments.pinReference),
           signalType: data.arguments.signalType,
           value: data.arguments.value,
         },
@@ -86,7 +106,7 @@ function serializeNodeData(data: NodeData, position: { x: number; y: number }, i
         type: data.type,
         position: position,
         arguments: {
-          portReference: data.arguments.portReference!,
+          portReference: draft(data.arguments.portReference),
           value: data.arguments.value,
         },
       };
@@ -138,7 +158,7 @@ function serializeNodeData(data: NodeData, position: { x: number; y: number }, i
         type: data.type,
         position: position,
         arguments: {
-          pinReference: data.arguments.pinReference!,
+          pinReference: draft(data.arguments.pinReference),
           edge: data.arguments.edge,
         },
       };
@@ -148,7 +168,7 @@ function serializeNodeData(data: NodeData, position: { x: number; y: number }, i
         type: data.type,
         position: position,
         arguments: {
-          portReference: data.arguments.portReference!,
+          portReference: draft(data.arguments.portReference),
           output: data.arguments.output,
         },
       };
@@ -158,8 +178,8 @@ function serializeNodeData(data: NodeData, position: { x: number; y: number }, i
         type: data.type,
         position: position,
         arguments: {
-          variable: data.arguments.variable!,
-          threshold: data.arguments.threshold!,
+          variable: draft(data.arguments.variable),
+          threshold: draft(data.arguments.threshold),
           direction: data.arguments.direction,
           deadband: data.arguments.deadband,
           output: data.arguments.output,
@@ -171,7 +191,7 @@ function serializeNodeData(data: NodeData, position: { x: number; y: number }, i
         type: data.type,
         position: position,
         arguments: {
-          delayMs: data.arguments.delayMs!,
+          delayMs: draft(data.arguments.delayMs),
         },
       };
     case "Ticker":
@@ -180,7 +200,7 @@ function serializeNodeData(data: NodeData, position: { x: number; y: number }, i
         type: data.type,
         position: position,
         arguments: {
-          intervalValue: data.arguments.intervalValue!,
+          intervalValue: draft(data.arguments.intervalValue),
           intervalUnit: data.arguments.intervalUnit,
         },
       };
@@ -210,7 +230,7 @@ function serializeNodeData(data: NodeData, position: { x: number; y: number }, i
         position: position,
         arguments: {
           memoryReference: data.arguments.memoryReference,
-          topK: data.arguments.topK!,
+          topK: draft(data.arguments.topK),
           query: data.arguments.query,
           output: data.arguments.output,
           toolDescription: data.arguments.toolDescription,
@@ -265,7 +285,7 @@ function serializeNodeData(data: NodeData, position: { x: number; y: number }, i
         type: data.type,
         position: position,
         arguments: {
-          variable: data.arguments.variable!,
+          variable: draft(data.arguments.variable),
           value: data.arguments.value,
         },
       };
@@ -278,7 +298,8 @@ function serializeNodeData(data: NodeData, position: { x: number; y: number }, i
           channelReference: data.arguments.channelReference ?? "",
           dataType: data.arguments.dataType,
           value: data.arguments.value,
-          qos: Number(data.arguments.qos) as 0 | 1 | 2,
+          // Unset stays unset — Number(undefined) is NaN, which stringifies to null.
+          qos: draft(data.arguments.qos === undefined ? undefined : (Number(data.arguments.qos) as 0 | 1 | 2)),
           retain: data.arguments.retain,
         },
       };

package/src/parameter/OutputParameter.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { Reference } from "../api";
 import { DataType, FromArgs, unwrapFromArgs } from "./Parameter";
 

package/src/parameter/Parameter.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { Expression, Reference } from "../api";
 import type { ChannelType } from "../channel";
 import type { MemoryType } from "../memory";

package/src/parameter/index.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 export type {
   DataType,
   FromArgs,

package/src/variable/Variable.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { Schemas } from "../api";
 import type { DataType } from "../api";
 

package/src/variable/index.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 // Public surface of the variable module. The discriminated-union types live in
 // ./Variable; the key/lookup/uid helpers and availability computation live in
 // ./operations. This file is a barrel only. Mirrors channel/memory/model.

package/src/variable/operations.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { NodeOutput } from "../node";
 import type { Reference } from "../api";
 import type { ApiVariable } from "./Variable";

package/src/workflow/Workflow.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import type { Channel } from "../channel";
 import type { Memory } from "../memory";
 import type { Model } from "../model";

package/src/workflow/index.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 export type { ApiWorkflow, Workflow, Canvas } from "./Workflow";
 export { MAIN_CANVAS_ID } from "./Workflow";
 export { serialize, deserialize, computeVariablesFromNodes } from "./serialization";

package/src/workflow/serialization.test.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 import { describe, it, expect } from "vitest";
 import { serialize, deserialize, computeVariablesFromNodes, buildCanvasVariables } from "./serialization";
 import { MAIN_CANVAS_ID, type Workflow, type Canvas } from "./Workflow";

package/src/workflow/serialization.ts

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (c) 2026 ForestHub.
+
 // Pure conversion between the api format (Schemas["Workflow"])
 // and the domain shape (Workflow).
 // Two producers feed serialize: the editor reads its live stores into