@sogni-ai/sogni-intelligence-client 2.1.0

package/dist/workflows/types.d.ts

@@ -0,0 +1,302 @@
+export type WorkflowCategory = 'portrait' | 'video-social' | 'makeover' | 'cinematic' | 'music' | 'analysis' | 'custom' | 'other';
+export type WorkflowStability = 'production' | 'beta' | 'experimental';
+export type WorkflowVisibility = 'private' | 'public';
+export interface WorkflowAuthor {
+    userId: string;
+    displayName: string;
+}
+export type WorkflowInputType = 'image' | 'audio' | 'video' | 'text' | 'number' | 'select' | 'boolean';
+export interface WorkflowInput {
+    name: string;
+    type: WorkflowInputType;
+    required: boolean;
+    description: string;
+    default?: unknown;
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+    multiple?: {
+        min: number;
+        max: number;
+    };
+    internal?: boolean;
+    jsonSchema?: Record<string, unknown>;
+}
+export interface WorkflowPreviewArtifact {
+    stageId: string;
+    label: string;
+    mediaType: 'image' | 'video';
+    url: string;
+    posterUrl?: string;
+}
+export interface WorkflowGraphLayout {
+    nodes: Array<{
+        stageId: string;
+        x: number;
+        y: number;
+        collapsed?: boolean;
+    }>;
+    edges?: Array<{
+        from: string;
+        to: string;
+        label?: string;
+    }>;
+    viewport?: {
+        x: number;
+        y: number;
+        zoom: number;
+    };
+}
+export interface WorkflowTemplate {
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    brief?: string;
+    category: WorkflowCategory;
+    stability: WorkflowStability;
+    author: 'system' | WorkflowAuthor;
+    visibility: WorkflowVisibility;
+    inputs: WorkflowInput[];
+    stages: WorkflowStage[];
+    reviewFocus?: string[];
+    estimatedCredits?: {
+        min: number;
+        max: number;
+    };
+    estimatedCapacityUnits?: {
+        min: number;
+        max: number;
+    };
+    exposeToLLM: boolean;
+    llmPriority?: number;
+    graph?: WorkflowGraphLayout;
+    thumbnailUrl?: string;
+    previewArtifacts?: WorkflowPreviewArtifact[];
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+    openMontageImport?: {
+        sourceSchema: string;
+        importedAt: number;
+        unmappedStages?: string[];
+        unmappedTools?: string[];
+    };
+    createdAt: number | string;
+    updatedAt: number | string;
+}
+export type WorkflowStage = FixedStage | InteractiveStage | BatchStage;
+export interface StageBase {
+    id: string;
+    label?: string;
+    produces?: string[];
+    requiredArtifactsIn?: string[];
+    optionalArtifactsIn?: string[];
+    reviewFocus?: string[];
+    successCriteria?: string[];
+    checkpointRequired?: boolean;
+    humanApprovalDefault?: boolean;
+    condition?: StageCondition;
+    onError?: 'stop' | 'continue' | 'skip' | 'retry_once';
+    subStages?: WorkflowStage[];
+}
+export interface FixedStage extends StageBase {
+    type: 'fixed';
+    tool: string;
+    args: Record<string, unknown>;
+}
+export interface InteractiveStage extends StageBase {
+    type: 'interactive';
+    systemPrompt: string;
+    allowedTools: string[];
+    userMessage?: string;
+    skillRef?: string;
+}
+export interface BatchStage extends StageBase {
+    type: 'batch';
+    overBinding: string;
+    itemName: string;
+    itemStage: FixedStage | InteractiveStage;
+    concurrency?: number;
+    partialExecutionEnabled: boolean;
+    itemLabelTemplate?: string;
+}
+export interface StageCondition {
+    type: 'always' | 'if_success_of' | 'if_error_in' | 'if_artifact_exists' | 'expr';
+    stageId?: string;
+    artifactName?: string;
+    expression?: string;
+}
+export type ArtifactKind = 'image' | 'video' | 'audio' | 'text' | 'structured';
+export interface Artifact {
+    name: string;
+    kind: ArtifactKind;
+    items: ArtifactItem[];
+}
+export interface ArtifactItem {
+    id: string;
+    label?: string;
+    versions: ArtifactVersion[];
+    selectedVersionId: string;
+    locked?: boolean;
+    metadata?: Record<string, unknown>;
+    status?: 'pending' | 'running' | 'ready' | 'failed';
+    progress?: number;
+    workerName?: string;
+    error?: string;
+}
+export interface ArtifactVersion {
+    id: string;
+    createdAt: number;
+    url?: string;
+    content?: string;
+    generatedBy: {
+        stageId: string;
+        tool: string;
+        args: Record<string, unknown>;
+    };
+    cost?: {
+        spark?: number;
+        sogni?: number;
+    };
+    thumbnailUrl?: string;
+}
+export type RunState = 'draft' | 'running' | 'awaiting_input' | 'awaiting_checkpoint' | 'paused' | 'completed' | 'failed' | 'canceled';
+export interface Run {
+    id: string;
+    workflowId: string;
+    workflowSnapshot: WorkflowTemplate;
+    state: RunState;
+    inputs: Record<string, unknown>;
+    currentStageIndex: number;
+    stages: StageExecution[];
+    artifacts: Record<string, Artifact>;
+    chatSessionId?: string;
+    createdAt: number;
+    updatedAt: number;
+    totalCostCredits?: number;
+    staleStageIds: string[];
+}
+export type StageExecutionState = 'pending' | 'running' | 'awaiting_checkpoint' | 'completed' | 'failed' | 'stale' | 'skipped';
+export interface StageItemState {
+    state: 'pending' | 'running' | 'ready' | 'failed';
+    artifactItemId: string;
+    error?: string;
+}
+export interface StageExecution {
+    stageId: string;
+    state: StageExecutionState;
+    startedAt?: number;
+    completedAt?: number;
+    error?: string;
+    itemStates?: Record<string, StageItemState>;
+}
+export type ToolExecutionProgress = Record<string, unknown>;
+export type ExecutorEvent = {
+    type: 'run_started';
+    run: Run;
+} | {
+    type: 'stage_started';
+    stageIndex: number;
+    stage: WorkflowStage;
+} | {
+    type: 'stage_item_started';
+    stageIndex: number;
+    itemId: string;
+    index: number;
+} | {
+    type: 'stage_item_progress';
+    stageIndex: number;
+    itemId: string;
+    progress: number;
+    workerName?: string;
+    toolProgress?: ToolExecutionProgress;
+} | {
+    type: 'stage_item_completed';
+    stageIndex: number;
+    itemId: string;
+    version: ArtifactVersion;
+} | {
+    type: 'stage_item_failed';
+    stageIndex: number;
+    itemId: string;
+    error: string;
+} | {
+    type: 'stage_completed';
+    stageIndex: number;
+} | {
+    type: 'stage_awaiting_checkpoint';
+    stageIndex: number;
+    reviewFocus?: string[];
+} | {
+    type: 'stage_awaiting_interactive';
+    stageIndex: number;
+    stage: InteractiveStage;
+} | {
+    type: 'run_completed';
+    run: Run;
+} | {
+    type: 'run_failed';
+    error: Error;
+    run: Run;
+} | {
+    type: 'run_paused';
+    run: Run;
+};
+export type ResumeInput = {
+    type: 'approve_checkpoint';
+} | {
+    type: 'redo_item';
+    artifactName: string;
+    itemId: string;
+    overrideArgs?: Record<string, unknown>;
+} | {
+    type: 'redo_stage';
+    stageId: string;
+    overrideArgs?: Record<string, unknown>;
+} | {
+    type: 'lock_item';
+    artifactName: string;
+    itemId: string;
+    locked: boolean;
+} | {
+    type: 'select_version';
+    artifactName: string;
+    itemId: string;
+    versionId: string;
+} | {
+    type: 'jump_to_stage';
+    stageId: string;
+} | {
+    type: 'interactive_complete';
+    stageId: string;
+    result: string;
+    producedArtifacts?: Record<string, Artifact>;
+} | {
+    type: 'cancel';
+};
+export interface ValidationIssue {
+    severity: 'error' | 'warning';
+    code: string;
+    message: string;
+    path?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    issues: ValidationIssue[];
+}
+export interface BindingContext {
+    inputs: Record<string, unknown>;
+    artifacts: Record<string, Artifact>;
+    item?: Record<string, unknown> & {
+        index: number;
+    };
+    runtime?: {
+        uploadedFiles?: Array<Record<string, unknown>>;
+    };
+    run?: {
+        id: string;
+        state: RunState;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workflows/types.d.ts.map

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

package/dist/workflows/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/workflows/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workflows/types.ts"],"names":[],"mappings":""}

package/dist/workflows/validation.d.ts

@@ -0,0 +1,10 @@
+import type { Artifact, ArtifactItem, Run, ValidationResult, WorkflowStage, WorkflowTemplate } from './types.js';
+export declare function validateWorkflow(def: WorkflowTemplate): ValidationResult;
+export declare function computeStaleStageIds(run: Run, mutatedArtifactNames: string[]): string[];
+export declare function persistedArtifactItem(item: ArtifactItem): ArtifactItem;
+export declare function persistedArtifact(artifact: Artifact): Artifact;
+export declare function persistedRun(run: Run): Run;
+export declare function walkStages(stages: WorkflowStage[]): Generator<WorkflowStage>;
+export declare function getFlatWorkflowStages(stages: WorkflowStage[]): WorkflowStage[];
+export declare function getCurrentRunStage(run: Run): WorkflowStage | undefined;
+//# sourceMappingURL=validation.d.ts.map

package/dist/workflows/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/workflows/validation.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EAIZ,GAAG,EAEH,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAMpB,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,gBAAgB,CAwMxE;AAcD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,GAAG,EACR,oBAAoB,EAAE,MAAM,EAAE,GAC7B,MAAM,EAAE,CAwCV;AAaD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAMtE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAK9D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAW1C;AAOD,wBAAiB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,SAAS,CAAC,aAAa,CAAC,CAU7E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAE9E;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,GAAG,SAAS,CAEtE"}

package/dist/workflows/validation.js

@@ -0,0 +1,340 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateWorkflow = validateWorkflow;
+exports.computeStaleStageIds = computeStaleStageIds;
+exports.persistedArtifactItem = persistedArtifactItem;
+exports.persistedArtifact = persistedArtifact;
+exports.persistedRun = persistedRun;
+exports.walkStages = walkStages;
+exports.getFlatWorkflowStages = getFlatWorkflowStages;
+exports.getCurrentRunStage = getCurrentRunStage;
+const bindings_js_1 = require("./bindings.js");
+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 = (0, bindings_js_1.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 bindings_js_1.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 };
+}
+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',
+];
+function persistedArtifactItem(item) {
+    const clone = { ...item };
+    for (const field of TRANSIENT_ITEM_FIELDS) {
+        delete clone[field];
+    }
+    return clone;
+}
+function persistedArtifact(artifact) {
+    return {
+        ...artifact,
+        items: artifact.items.map(persistedArtifactItem),
+    };
+}
+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 };
+}
+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;
+        }
+    }
+}
+function getFlatWorkflowStages(stages) {
+    return Array.from(walkStages(stages));
+}
+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(...(0, bindings_js_1.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(...(0, bindings_js_1.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