@you-agent-factory/factory-graph 0.0.0

package/dist/source.d.ts

@@ -0,0 +1,29 @@
+import type { FactoryDefinition } from "@you-agent-factory/client";
+import type { FactoryActivityProjection, FactoryLoadProjection, FactoryTopologyProjection } from "@you-agent-factory/factory-replay";
+/** Runtime information consumed by the semantic Factory graph at one selected tick. */
+export interface FactoryGraphRuntimeProjection {
+    activity: FactoryActivityProjection;
+    load: FactoryLoadProjection;
+    topology: FactoryTopologyProjection;
+}
+/** Host-owned selection behavior for a read-only graph. */
+export interface FactoryGraphObserveControls {
+    onSelectNode?: (nodeId: string) => void;
+    selectedNodeId?: string;
+}
+/**
+ * Lossless input to a Factory graph renderer.
+ *
+ * Hosts retain ownership of event streaming, timeline selection, persistence,
+ * and editing. The graph receives the complete Factory alongside the selected
+ * runtime projection, so semantic node renderers never need a reduced
+ * topology-only substitute.
+ */
+export interface FactoryGraphSource {
+    factory: Readonly<FactoryDefinition>;
+    runtime: FactoryGraphRuntimeProjection;
+    selectedTick: number;
+}
+export declare function isFactoryGraphSource(value: unknown): value is FactoryGraphSource;
+/** Validate the stable graph boundary without cloning or reducing its inputs. */
+export declare function createFactoryGraphSource(source: FactoryGraphSource): FactoryGraphSource;

package/dist/source.js

@@ -0,0 +1,18 @@
+export function isFactoryGraphSource(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const source = value;
+    const selectedTick = source.selectedTick;
+    return (source.factory !== undefined &&
+        source.runtime !== undefined &&
+        typeof selectedTick === "number" &&
+        Number.isSafeInteger(selectedTick) &&
+        selectedTick >= 0);
+}
+/** Validate the stable graph boundary without cloning or reducing its inputs. */
+export function createFactoryGraphSource(source) {
+    if (!isFactoryGraphSource(source)) {
+        throw new TypeError("Factory graph source requires a Factory, runtime projection, and non-negative selected tick.");
+    }
+    return source;
+}

package/dist/work-state-presentation.d.ts

@@ -0,0 +1,8 @@
+import type { GraphSemanticIconKind } from "./semantic-icon.js";
+export declare const FACTORY_GRAPH_WORK_STATE_TYPES: readonly ["INITIAL", "PROCESSING", "TERMINAL", "FAILED"];
+export type FactoryGraphWorkStateType = (typeof FACTORY_GRAPH_WORK_STATE_TYPES)[number];
+export declare const WORK_STATE_PHASE_LEGEND_ORDER: readonly ["INITIAL", "PROCESSING", "TERMINAL", "FAILED"];
+export declare function workStatePhaseSwatchClassName(_workStateType: FactoryGraphWorkStateType): string;
+export declare function workStatePhaseSurfaceClassName(_workStateType: FactoryGraphWorkStateType | undefined): string;
+export declare function workStatePhaseSemanticIconKind(workStateType: FactoryGraphWorkStateType | undefined): GraphSemanticIconKind;
+export declare function workStatePhaseSemanticIconClassName(workStateType: FactoryGraphWorkStateType | undefined): string;

package/dist/work-state-presentation.js

@@ -0,0 +1,40 @@
+import { factoryGraphNodeSurfaceClassName } from "./semantic-node-style.js";
+export const FACTORY_GRAPH_WORK_STATE_TYPES = [
+    "INITIAL",
+    "PROCESSING",
+    "TERMINAL",
+    "FAILED",
+];
+export const WORK_STATE_PHASE_LEGEND_ORDER = [
+    "INITIAL",
+    "PROCESSING",
+    "TERMINAL",
+    "FAILED",
+];
+const WORK_STATE_SURFACE = factoryGraphNodeSurfaceClassName("workState");
+const ICON_KIND_BY_PHASE = {
+    INITIAL: "queue",
+    PROCESSING: "processing",
+    TERMINAL: "terminal",
+    FAILED: "failed",
+};
+const ICON_CLASS_BY_PHASE = {
+    INITIAL: "text-info",
+    PROCESSING: "text-warning",
+    TERMINAL: "text-success",
+    FAILED: "text-error",
+};
+export function workStatePhaseSwatchClassName(_workStateType) {
+    return WORK_STATE_SURFACE;
+}
+export function workStatePhaseSurfaceClassName(_workStateType) {
+    return WORK_STATE_SURFACE;
+}
+export function workStatePhaseSemanticIconKind(workStateType) {
+    return workStateType ? ICON_KIND_BY_PHASE[workStateType] : "queue";
+}
+export function workStatePhaseSemanticIconClassName(workStateType) {
+    return workStateType
+        ? ICON_CLASS_BY_PHASE[workStateType]
+        : "text-on-surface-variant";
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@you-agent-factory/factory-graph",
+  "version": "0.0.0",
+  "description": "Lossless Factory graph source contracts shared by semantic graph renderers.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/portpowered/you-agent-factory.git",
+    "directory": "ui/packages/factory-graph"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "LICENSE.md",
+    "README.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "bun run prepare:dependencies && node scripts/build-package.mjs",
+    "check:pack": "node scripts/verify-package-pack.mjs",
+    "check:package-boundary": "node scripts/check-package-boundary.mjs",
+    "prepare:dependencies": "bun run --cwd ../client build && bun run --cwd ../components build && bun run --cwd ../factory-replay build",
+    "test": "bun run prepare:dependencies && vitest run --config vitest.config.ts",
+    "typecheck": "bun run prepare:dependencies && tsc -p tsconfig.json --noEmit --pretty false",
+    "verify": "bun run typecheck && bun run test && bun run build && bun run check:package-boundary && bun run check:pack"
+  },
+  "peerDependencies": {
+    "@you-agent-factory/client": "0.0.0",
+    "@you-agent-factory/components": "0.0.0",
+    "@you-agent-factory/factory-replay": "0.0.0",
+    "@xyflow/react": "^12.10.2",
+    "react": "^19.0.0"
+  },
+  "devDependencies": {
+    "@you-agent-factory/client": "workspace:*",
+    "@you-agent-factory/components": "workspace:*",
+    "@you-agent-factory/factory-replay": "workspace:*",
+    "@types/react": "^19.2.2",
+    "@xyflow/react": "^12.10.2",
+    "react": "^19.0.0",
+    "typescript": "~5.9.3",
+    "vitest": "4.1.3"
+  }
+}