@sogni-ai/sogni-intelligence-client 3.0.0-alpha.0

package/dist-esm/workflows/validation.js

@@ -0,0 +1,330 @@
+import { collectBindings, parseBinding, BindingError } from './bindings.js';
+export function validateWorkflow(def) {
+    const issues = [];
+    const stageIds = new Set();
+    for (const stage of walkStages(def.stages)) {
+        if (stageIds.has(stage.id)) {
+            issues.push({
+                severity: 'error',
+                code: 'duplicate_stage_id',
+                message: `Duplicate stage id: ${stage.id}`,
+                path: `stages/${stage.id}`,
+            });
+        }
+        stageIds.add(stage.id);
+    }
+    const inputNames = new Set();
+    for (const input of def.inputs) {
+        if (inputNames.has(input.name)) {
+            issues.push({
+                severity: 'error',
+                code: 'duplicate_input_name',
+                message: `Duplicate input name: ${input.name}`,
+                path: `inputs/${input.name}`,
+            });
+        }
+        inputNames.add(input.name);
+    }
+    const flatStages = Array.from(walkStages(def.stages));
+    const producerIndex = {};
+    flatStages.forEach((stage, idx) => {
+        for (const name of stage.produces ?? []) {
+            if (name in producerIndex) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'duplicate_artifact_producer',
+                    message: `Artifact "${name}" is produced by multiple stages. Downstream stages will see the last write.`,
+                    path: `stages/${stage.id}/produces`,
+                });
+            }
+            else {
+                producerIndex[name] = idx;
+            }
+        }
+    });
+    flatStages.forEach((stage, idx) => {
+        for (const name of stage.requiredArtifactsIn ?? []) {
+            if (!(name in producerIndex)) {
+                issues.push({
+                    severity: 'error',
+                    code: 'missing_artifact_producer',
+                    message: `Stage "${stage.id}" requires artifact "${name}" but no earlier stage produces it.`,
+                    path: `stages/${stage.id}/requiredArtifactsIn`,
+                });
+                continue;
+            }
+            if (producerIndex[name] >= idx) {
+                issues.push({
+                    severity: 'error',
+                    code: 'forward_artifact_reference',
+                    message: `Stage "${stage.id}" requires "${name}" but its producer runs later.`,
+                    path: `stages/${stage.id}/requiredArtifactsIn`,
+                });
+            }
+        }
+        for (const name of stage.optionalArtifactsIn ?? []) {
+            if (!(name in producerIndex)) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'missing_optional_artifact',
+                    message: `Optional artifact "${name}" has no producer and will never be available.`,
+                    path: `stages/${stage.id}/optionalArtifactsIn`,
+                });
+            }
+        }
+    });
+    for (const { stage, inBatchItem } of walkStageContexts(def.stages)) {
+        const bindings = collectStageBindings(stage);
+        for (const binding of bindings) {
+            try {
+                const parsed = parseBinding(binding);
+                if (parsed.root === 'inputs') {
+                    const firstField = parsed.segments.find((s) => s.kind === 'field');
+                    if (firstField && firstField.kind === 'field' && !inputNames.has(firstField.name)) {
+                        issues.push({
+                            severity: 'error',
+                            code: 'unknown_input',
+                            message: `Binding "${binding}" references unknown input "${firstField.name}".`,
+                            path: `stages/${stage.id}/args`,
+                        });
+                    }
+                }
+                if (parsed.root === 'artifacts') {
+                    const firstField = parsed.segments.find((s) => s.kind === 'field');
+                    if (firstField && firstField.kind === 'field' && !(firstField.name in producerIndex)) {
+                        issues.push({
+                            severity: 'error',
+                            code: 'unknown_artifact',
+                            message: `Binding "${binding}" references unknown artifact "${firstField.name}".`,
+                            path: `stages/${stage.id}/args`,
+                        });
+                    }
+                }
+                if (parsed.root === 'item' && !inBatchItem && stage.type !== 'batch' && !stage.subStages?.length) {
+                    issues.push({
+                        severity: 'error',
+                        code: 'item_binding_outside_batch',
+                        message: `Stage "${stage.id}" uses $item but is not inside a batch.`,
+                        path: `stages/${stage.id}/args`,
+                    });
+                }
+            }
+            catch (err) {
+                if (err instanceof BindingError) {
+                    issues.push({
+                        severity: 'error',
+                        code: 'invalid_binding_syntax',
+                        message: err.message,
+                        path: `stages/${stage.id}/args`,
+                    });
+                }
+                else {
+                    throw err;
+                }
+            }
+        }
+    }
+    const graph = {};
+    for (const stage of flatStages) {
+        graph[stage.id] = [];
+        for (const name of [...(stage.requiredArtifactsIn ?? []), ...(stage.optionalArtifactsIn ?? [])]) {
+            const producerIdx = producerIndex[name];
+            if (producerIdx !== undefined) {
+                const producerStage = flatStages[producerIdx];
+                if (producerStage)
+                    graph[stage.id].push(producerStage.id);
+            }
+        }
+    }
+    const cycle = findCycle(graph);
+    if (cycle) {
+        issues.push({
+            severity: 'error',
+            code: 'cyclic_stage_dependency',
+            message: `Cyclic artifact dependency detected: ${cycle.join(' → ')}`,
+            path: `stages`,
+        });
+    }
+    for (const stage of flatStages) {
+        if (stage.type === 'batch') {
+            if (!stage.overBinding.startsWith('$')) {
+                issues.push({
+                    severity: 'error',
+                    code: 'batch_over_binding_not_a_binding',
+                    message: `Batch stage "${stage.id}" overBinding must be a $... binding.`,
+                    path: `stages/${stage.id}/overBinding`,
+                });
+            }
+            if (!stage.itemName) {
+                issues.push({
+                    severity: 'error',
+                    code: 'batch_item_name_required',
+                    message: `Batch stage "${stage.id}" must declare itemName.`,
+                    path: `stages/${stage.id}/itemName`,
+                });
+            }
+            if (stage.concurrency !== undefined && stage.concurrency < 1) {
+                issues.push({
+                    severity: 'error',
+                    code: 'batch_concurrency_invalid',
+                    message: `Batch stage "${stage.id}" concurrency must be ≥ 1.`,
+                    path: `stages/${stage.id}/concurrency`,
+                });
+            }
+        }
+    }
+    const hasErrors = issues.some((i) => i.severity === 'error');
+    return { valid: !hasErrors, issues };
+}
+export function computeStaleStageIds(run, mutatedArtifactNames) {
+    if (mutatedArtifactNames.length === 0)
+        return [];
+    const flat = Array.from(walkStages(run.workflowSnapshot.stages));
+    const producerIndex = {};
+    flat.forEach((stage, idx) => {
+        for (const name of stage.produces ?? []) {
+            if (!(name in producerIndex))
+                producerIndex[name] = idx;
+        }
+    });
+    const liveArtifacts = new Set(mutatedArtifactNames);
+    const stale = new Set();
+    let startIdx = Infinity;
+    for (const name of mutatedArtifactNames) {
+        const idx = producerIndex[name];
+        if (idx !== undefined && idx < startIdx)
+            startIdx = idx;
+    }
+    if (!Number.isFinite(startIdx))
+        return [];
+    for (let i = startIdx; i < flat.length; i++) {
+        const stage = flat[i];
+        const consumes = [
+            ...(stage.requiredArtifactsIn ?? []),
+            ...(stage.optionalArtifactsIn ?? []),
+        ];
+        const touchesLive = consumes.some((name) => liveArtifacts.has(name));
+        if (touchesLive) {
+            stale.add(stage.id);
+            for (const name of stage.produces ?? [])
+                liveArtifacts.add(name);
+        }
+    }
+    return Array.from(stale);
+}
+const TRANSIENT_ITEM_FIELDS = [
+    'status',
+    'progress',
+    'workerName',
+    'error',
+];
+export function persistedArtifactItem(item) {
+    const clone = { ...item };
+    for (const field of TRANSIENT_ITEM_FIELDS) {
+        delete clone[field];
+    }
+    return clone;
+}
+export function persistedArtifact(artifact) {
+    return {
+        ...artifact,
+        items: artifact.items.map(persistedArtifactItem),
+    };
+}
+export function persistedRun(run) {
+    const artifacts = {};
+    for (const [name, artifact] of Object.entries(run.artifacts)) {
+        artifacts[name] = persistedArtifact(artifact);
+    }
+    const stages = run.stages.map((s) => s.state === 'running' ? { ...s, state: 'pending' } : s);
+    return { ...run, artifacts, stages };
+}
+export function* walkStages(stages) {
+    for (const stage of stages) {
+        yield stage;
+        if (stage.subStages?.length) {
+            yield* walkStages(stage.subStages);
+        }
+        if (stage.type === 'batch') {
+            yield stage.itemStage;
+        }
+    }
+}
+export function getFlatWorkflowStages(stages) {
+    return Array.from(walkStages(stages));
+}
+export function getCurrentRunStage(run) {
+    return getFlatWorkflowStages(run.workflowSnapshot.stages)[run.currentStageIndex];
+}
+function* walkStageContexts(stages, inBatchItem = false) {
+    for (const stage of stages) {
+        yield { stage, inBatchItem };
+        if (stage.subStages?.length) {
+            yield* walkStageContexts(stage.subStages, inBatchItem);
+        }
+        if (stage.type === 'batch') {
+            yield* walkStageContexts([stage.itemStage], true);
+        }
+    }
+}
+function collectStageBindings(stage) {
+    const out = [];
+    if (stage.type === 'fixed') {
+        out.push(...collectBindings(stage.args));
+    }
+    if (stage.type === 'interactive') {
+        void stage;
+    }
+    if (stage.type === 'batch') {
+        const b = stage;
+        out.push(b.overBinding);
+        if (b.itemStage.type === 'fixed') {
+            out.push(...collectBindings(b.itemStage.args));
+        }
+    }
+    return out;
+}
+function findCycle(graph) {
+    const WHITE = 0;
+    const GRAY = 1;
+    const BLACK = 2;
+    const color = {};
+    const parent = {};
+    for (const id of Object.keys(graph))
+        color[id] = WHITE;
+    for (const start of Object.keys(graph)) {
+        if (color[start] !== WHITE)
+            continue;
+        const stack = [start];
+        parent[start] = null;
+        while (stack.length > 0) {
+            const id = stack[stack.length - 1];
+            if (color[id] === WHITE)
+                color[id] = GRAY;
+            let advanced = false;
+            for (const next of graph[id] ?? []) {
+                if (color[next] === WHITE) {
+                    parent[next] = id;
+                    stack.push(next);
+                    advanced = true;
+                    break;
+                }
+                if (color[next] === GRAY) {
+                    const cycle = [next, id];
+                    let p = parent[id];
+                    while (p && p !== next) {
+                        cycle.push(p);
+                        p = parent[p];
+                    }
+                    return cycle.reverse();
+                }
+            }
+            if (!advanced) {
+                color[id] = BLACK;
+                stack.pop();
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=validation.js.map

package/dist-esm/workflows/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/workflows/validation.ts"],"names":[],"mappings":"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"}

package/media/index.d.ts

@@ -0,0 +1 @@
+export * from '../dist/media/index.js';

package/media/index.js

@@ -0,0 +1,2 @@
+'use strict';
+module.exports = require('../dist/media/index.js');

package/package.json

@@ -0,0 +1,134 @@
+{
+  "name": "@sogni-ai/sogni-intelligence-client",
+  "version": "3.0.0-alpha.0",
+  "description": "Public Sogni Intelligence client — Node.js convenience wrapper for the Sogni SDK plus the public-safe subset of @sogni/creative-agent contracts (ContractRegistry, AssetManifest, RunRecord, tool envelopes). For agent builders, third-party integrations, and downstream SDKs.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist-esm/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./contracts": {
+      "types": "./dist/contracts/index.d.ts",
+      "import": "./dist-esm/contracts/index.js",
+      "require": "./dist/contracts/index.js",
+      "default": "./dist/contracts/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist-esm/tools/index.js",
+      "require": "./dist/tools/index.js",
+      "default": "./dist/tools/index.js"
+    },
+    "./replay": {
+      "types": "./dist/replay/index.d.ts",
+      "import": "./dist-esm/replay/index.js",
+      "require": "./dist/replay/index.js",
+      "default": "./dist/replay/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist-esm/runtime/index.js",
+      "require": "./dist/runtime/index.js",
+      "default": "./dist/runtime/index.js"
+    },
+    "./skills/asset_reference_management": {
+      "types": "./dist/skills/asset_reference_management/index.d.ts",
+      "import": "./dist-esm/skills/asset_reference_management/index.js",
+      "require": "./dist/skills/asset_reference_management/index.js",
+      "default": "./dist/skills/asset_reference_management/index.js"
+    },
+    "./workflows": {
+      "types": "./dist/workflows/index.d.ts",
+      "import": "./dist-esm/workflows/index.js",
+      "require": "./dist/workflows/index.js",
+      "default": "./dist/workflows/index.js"
+    },
+    "./media": {
+      "types": "./dist/media/index.d.ts",
+      "import": "./dist-esm/media/index.js",
+      "require": "./dist/media/index.js",
+      "default": "./dist/media/index.js"
+    },
+    "./public-skill-runtime": {
+      "types": "./dist/public-skill-runtime/index.d.ts",
+      "import": "./dist-esm/public-skill-runtime/index.js",
+      "require": "./dist/public-skill-runtime/index.js",
+      "default": "./dist/public-skill-runtime/index.js"
+    },
+    "./schemas/*": "./dist/schemas/*",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc && tsc -p tsconfig.esm.json && node scripts/write-esm-package-json.mjs",
+    "build:watch": "tsc --watch",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "test": "node --import tsx test/basic-tests.ts",
+    "test:e2e": "node --import tsx test/e2e-test.ts",
+    "test:e2e:llm": "SOGNI_E2E_SCOPE=llm node --import tsx test/e2e-test.ts",
+    "typecheck:examples": "tsc --noEmit -p tsconfig.examples.json",
+    "test:examples": "npm run typecheck:examples",
+    "test:all": "npm run test && npm run test:examples && npm run test:e2e"
+  },
+  "keywords": [
+    "sogni",
+    "sogni-intelligence",
+    "ai",
+    "agent",
+    "agent-builder",
+    "creative-agent",
+    "contracts",
+    "tool-calling",
+    "image-generation",
+    "video-generation",
+    "audio-generation",
+    "n8n",
+    "workflow",
+    "automation",
+    "depin",
+    "stable-diffusion",
+    "flux"
+  ],
+  "author": "Sogni AI",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Sogni-AI/sogni-intelligence-client.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Sogni-AI/sogni-intelligence-client/issues"
+  },
+  "homepage": "https://github.com/Sogni-AI/sogni-intelligence-client#readme",
+  "dependencies": {
+    "@sogni-ai/sogni-client": "5.0.0-alpha.1",
+    "sharp": "^0.34.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "dotenv": "^17.2.3",
+    "tsx": "^4.20.6",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "dist-esm",
+    "contracts",
+    "media",
+    "workflows",
+    "replay",
+    "runtime",
+    "tools",
+    "public-skill-runtime",
+    "skills",
+    "README.md",
+    "LICENSE",
+    ".env.example"
+  ]
+}

package/public-skill-runtime/index.d.ts

@@ -0,0 +1 @@
+export * from '../dist/public-skill-runtime/index.js';

package/public-skill-runtime/index.js

@@ -0,0 +1,2 @@
+'use strict';
+module.exports = require('../dist/public-skill-runtime/index.js');

package/replay/index.d.ts

@@ -0,0 +1 @@
+export * from '../dist/replay/index.js';

package/replay/index.js

@@ -0,0 +1,2 @@
+'use strict';
+module.exports = require('../dist/replay/index.js');

package/runtime/index.d.ts

@@ -0,0 +1 @@
+export * from '../dist/runtime/index.js';

package/runtime/index.js

@@ -0,0 +1,2 @@
+'use strict';
+module.exports = require('../dist/runtime/index.js');

package/skills/asset_reference_management/index.d.ts

@@ -0,0 +1 @@
+export * from '../../dist/skills/asset_reference_management/index.js';

package/skills/asset_reference_management/index.js

@@ -0,0 +1,2 @@
+'use strict';
+module.exports = require('../../dist/skills/asset_reference_management/index.js');

package/tools/index.d.ts

@@ -0,0 +1 @@
+export * from '../dist/tools/index.js';

package/tools/index.js

@@ -0,0 +1,2 @@
+'use strict';
+module.exports = require('../dist/tools/index.js');

package/workflows/index.d.ts

@@ -0,0 +1 @@
+export * from '../dist/workflows/index.js';

package/workflows/index.js

@@ -0,0 +1,2 @@
+'use strict';
+module.exports = require('../dist/workflows/index.js');