gauss-ai 4.0.0

package/dist/workflow/index.d.ts

@@ -0,0 +1,62 @@
+import { W as WorkflowContext, h as WorkflowStep, R as RetryConfig, a as WorkflowDefinition } from '../workflow.port-BaCttxrw.js';
+export { e as AnyStep, V as ValidationResult, f as WorkflowEvent, c as WorkflowEventListener, b as WorkflowPort, d as WorkflowResult } from '../workflow.port-BaCttxrw.js';
+
+type ConditionFn = (ctx: WorkflowContext) => boolean;
+type RollbackFn = (ctx: WorkflowContext) => Promise<void>;
+type PromptFn = (ctx: WorkflowContext) => string;
+interface ConditionalOpts {
+    condition: ConditionFn;
+    ifTrue: WorkflowStep;
+    ifFalse?: WorkflowStep;
+}
+interface LoopOpts {
+    body: WorkflowStep;
+    condition: ConditionFn;
+    maxIterations?: number;
+}
+interface ForeachOpts {
+    iterable: string;
+    step: WorkflowStep;
+    itemKey?: string;
+    indexKey?: string;
+    aggregateOutputKey?: string;
+    aggregationMode?: "array" | "concat" | "merge";
+    maxConcurrency?: number;
+    maxIterations?: number;
+}
+interface MapOpts {
+    input: string;
+    transform: WorkflowStep;
+    outputKey: string;
+    itemKey?: string;
+    indexKey?: string;
+    filter?: (item: unknown, index: number, ctx: WorkflowContext) => boolean;
+    maxConcurrency?: number;
+}
+declare class WorkflowBuilder {
+    private readonly id;
+    private readonly workflowName;
+    private readonly steps;
+    private timeoutMs?;
+    private initCtx?;
+    constructor(id: string, name: string);
+    step(id: string, name: string, execute: (ctx: WorkflowContext) => Promise<WorkflowContext>): this;
+    parallel(id: string, name: string, branches: WorkflowStep[], mergeStrategy?: 'all' | 'first' | 'race'): this;
+    conditional(id: string, name: string, opts: ConditionalOpts): this;
+    loop(id: string, name: string, opts: LoopOpts): this;
+    foreach(id: string, name: string, opts: ForeachOpts): this;
+    map(id: string, name: string, opts: MapOpts): this;
+    agentStep(id: string, name: string, prompt: string | PromptFn, outputKey: string): this;
+    /** Apply retry config to the last added step */
+    withRetry(config: Partial<RetryConfig>): this;
+    /** Apply rollback to the last added step */
+    withRollback(fn: RollbackFn): this;
+    /** Apply condition to the last added step */
+    withCondition(fn: ConditionFn): this;
+    withTimeout(ms: number): this;
+    withInitialContext(ctx: WorkflowContext): this;
+    build(): WorkflowDefinition;
+}
+declare function defineWorkflow(id: string, name: string): WorkflowBuilder;
+
+export { WorkflowBuilder, WorkflowContext, WorkflowDefinition, defineWorkflow };

package/dist/workflow/index.js

@@ -0,0 +1,9 @@
+import {
+  WorkflowBuilder,
+  defineWorkflow
+} from "../chunk-JKXKXB5O.js";
+export {
+  WorkflowBuilder,
+  defineWorkflow
+};
+//# sourceMappingURL=index.js.map

package/dist/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/workflow.port-BaCttxrw.d.cts

@@ -0,0 +1,153 @@
+interface RetryConfig {
+    maxAttempts: number;
+    backoffMs: number;
+    backoffMultiplier: number;
+}
+type WorkflowContext = Record<string, unknown>;
+interface OutputMapping {
+    /** Source path in the step output context */
+    source: string;
+    /** Target key in the next workflow context */
+    targetKey: string;
+    /** Optional value transform */
+    transform?: (value: unknown, result: WorkflowContext) => unknown;
+    /** Fallback value when source is missing/undefined */
+    defaultValue?: unknown;
+}
+interface InputMapping {
+    /** Explicit keys to project from workflow context */
+    keys?: string[];
+    /** Extract values from paths into new keys */
+    paths?: Record<string, string>;
+    /** Static default values merged first */
+    defaults?: Record<string, unknown>;
+    /** Static overrides merged last */
+    overrides?: Record<string, unknown>;
+}
+interface WorkflowStep {
+    id: string;
+    name: string;
+    type?: StepType;
+    condition?: (ctx: WorkflowContext) => boolean;
+    inputMapping?: InputMapping;
+    outputMapping?: OutputMapping[];
+    execute: (ctx: WorkflowContext) => Promise<WorkflowContext>;
+    rollback?: (ctx: WorkflowContext) => Promise<void>;
+    retry?: Partial<RetryConfig>;
+}
+interface WorkflowResult {
+    status: "completed" | "failed";
+    context: WorkflowContext;
+    completedSteps: string[];
+    skippedSteps: string[];
+    failedStep?: string;
+    error?: string;
+    totalDurationMs: number;
+}
+type StepType = 'sequential' | 'parallel' | 'conditional' | 'loop' | 'agent' | 'foreach' | 'map';
+interface ParallelStep {
+    id: string;
+    name: string;
+    type: 'parallel';
+    branches: WorkflowStep[];
+    mergeStrategy?: 'all' | 'first' | 'race';
+}
+interface ConditionalStep {
+    id: string;
+    name: string;
+    type: 'conditional';
+    condition: (ctx: WorkflowContext) => boolean;
+    ifTrue: WorkflowStep;
+    ifFalse?: WorkflowStep;
+}
+interface LoopStep {
+    id: string;
+    name: string;
+    type: 'loop';
+    body: WorkflowStep;
+    condition: (ctx: WorkflowContext) => boolean;
+    maxIterations?: number;
+}
+interface ForeachStep {
+    id: string;
+    name: string;
+    type: 'foreach';
+    /** Path to iterable in context, e.g. "items" or "payload.results" */
+    iterable: string;
+    /** Step executed for each item */
+    step: WorkflowStep;
+    /** Item variable name exposed in item context. Default: "item" */
+    itemKey?: string;
+    /** Optional index variable name. Default: "index" */
+    indexKey?: string;
+    /** Aggregate output key in final context. Default: step id */
+    aggregateOutputKey?: string;
+    /** Aggregate behavior for per-item outputs. Default: "array" */
+    aggregationMode?: 'array' | 'concat' | 'merge';
+    /** Maximum concurrent item executions. Default: 1 */
+    maxConcurrency?: number;
+    /** Safety cap on iterations */
+    maxIterations?: number;
+}
+interface MapStep {
+    id: string;
+    name: string;
+    type: 'map';
+    /** Path to input array in context */
+    input: string;
+    /** Transform step executed for each item */
+    transform: WorkflowStep;
+    /** Output collection key */
+    outputKey: string;
+    /** Item variable name exposed in item context. Default: "item" */
+    itemKey?: string;
+    /** Optional index variable name. Default: "index" */
+    indexKey?: string;
+    /** Optional item filter */
+    filter?: (item: unknown, index: number, ctx: WorkflowContext) => boolean;
+    /** Maximum concurrent item executions. Default: 1 */
+    maxConcurrency?: number;
+}
+interface AgentStep {
+    id: string;
+    name: string;
+    type: 'agent';
+    prompt: string | ((ctx: WorkflowContext) => string);
+    outputKey: string;
+    execute?: (ctx: WorkflowContext) => Promise<WorkflowContext>;
+    rollback?: (ctx: WorkflowContext) => Promise<void>;
+    retry?: Partial<RetryConfig>;
+}
+type AnyStep = WorkflowStep | ParallelStep | ConditionalStep | LoopStep | ForeachStep | MapStep | AgentStep;
+interface WorkflowDefinition {
+    id: string;
+    name: string;
+    steps: AnyStep[];
+    initialContext?: WorkflowContext;
+    maxDurationMs?: number;
+}
+interface ValidationResult$1 {
+    valid: boolean;
+    errors: string[];
+}
+type WorkflowEventType = 'step:start' | 'step:complete' | 'step:error';
+interface WorkflowEvent {
+    type: WorkflowEventType;
+    stepId: string;
+    stepName: string;
+    timestamp: number;
+    context?: WorkflowContext;
+    error?: string;
+}
+
+interface WorkflowPort {
+    execute(definition: WorkflowDefinition, context?: WorkflowContext): Promise<WorkflowResult>;
+    validate(definition: WorkflowDefinition): ValidationResult;
+}
+interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+type WorkflowEventListener = (event: WorkflowEvent) => void;
+
+export type { AgentStep as A, ConditionalStep as C, ForeachStep as F, InputMapping as I, LoopStep as L, MapStep as M, OutputMapping as O, ParallelStep as P, RetryConfig as R, StepType as S, ValidationResult as V, WorkflowContext as W, WorkflowDefinition as a, WorkflowPort as b, WorkflowEventListener as c, WorkflowResult as d, AnyStep as e, WorkflowEvent as f, WorkflowEventType as g, WorkflowStep as h, ValidationResult$1 as i };

package/dist/workflow.port-BaCttxrw.d.ts

@@ -0,0 +1,153 @@
+interface RetryConfig {
+    maxAttempts: number;
+    backoffMs: number;
+    backoffMultiplier: number;
+}
+type WorkflowContext = Record<string, unknown>;
+interface OutputMapping {
+    /** Source path in the step output context */
+    source: string;
+    /** Target key in the next workflow context */
+    targetKey: string;
+    /** Optional value transform */
+    transform?: (value: unknown, result: WorkflowContext) => unknown;
+    /** Fallback value when source is missing/undefined */
+    defaultValue?: unknown;
+}
+interface InputMapping {
+    /** Explicit keys to project from workflow context */
+    keys?: string[];
+    /** Extract values from paths into new keys */
+    paths?: Record<string, string>;
+    /** Static default values merged first */
+    defaults?: Record<string, unknown>;
+    /** Static overrides merged last */
+    overrides?: Record<string, unknown>;
+}
+interface WorkflowStep {
+    id: string;
+    name: string;
+    type?: StepType;
+    condition?: (ctx: WorkflowContext) => boolean;
+    inputMapping?: InputMapping;
+    outputMapping?: OutputMapping[];
+    execute: (ctx: WorkflowContext) => Promise<WorkflowContext>;
+    rollback?: (ctx: WorkflowContext) => Promise<void>;
+    retry?: Partial<RetryConfig>;
+}
+interface WorkflowResult {
+    status: "completed" | "failed";
+    context: WorkflowContext;
+    completedSteps: string[];
+    skippedSteps: string[];
+    failedStep?: string;
+    error?: string;
+    totalDurationMs: number;
+}
+type StepType = 'sequential' | 'parallel' | 'conditional' | 'loop' | 'agent' | 'foreach' | 'map';
+interface ParallelStep {
+    id: string;
+    name: string;
+    type: 'parallel';
+    branches: WorkflowStep[];
+    mergeStrategy?: 'all' | 'first' | 'race';
+}
+interface ConditionalStep {
+    id: string;
+    name: string;
+    type: 'conditional';
+    condition: (ctx: WorkflowContext) => boolean;
+    ifTrue: WorkflowStep;
+    ifFalse?: WorkflowStep;
+}
+interface LoopStep {
+    id: string;
+    name: string;
+    type: 'loop';
+    body: WorkflowStep;
+    condition: (ctx: WorkflowContext) => boolean;
+    maxIterations?: number;
+}
+interface ForeachStep {
+    id: string;
+    name: string;
+    type: 'foreach';
+    /** Path to iterable in context, e.g. "items" or "payload.results" */
+    iterable: string;
+    /** Step executed for each item */
+    step: WorkflowStep;
+    /** Item variable name exposed in item context. Default: "item" */
+    itemKey?: string;
+    /** Optional index variable name. Default: "index" */
+    indexKey?: string;
+    /** Aggregate output key in final context. Default: step id */
+    aggregateOutputKey?: string;
+    /** Aggregate behavior for per-item outputs. Default: "array" */
+    aggregationMode?: 'array' | 'concat' | 'merge';
+    /** Maximum concurrent item executions. Default: 1 */
+    maxConcurrency?: number;
+    /** Safety cap on iterations */
+    maxIterations?: number;
+}
+interface MapStep {
+    id: string;
+    name: string;
+    type: 'map';
+    /** Path to input array in context */
+    input: string;
+    /** Transform step executed for each item */
+    transform: WorkflowStep;
+    /** Output collection key */
+    outputKey: string;
+    /** Item variable name exposed in item context. Default: "item" */
+    itemKey?: string;
+    /** Optional index variable name. Default: "index" */
+    indexKey?: string;
+    /** Optional item filter */
+    filter?: (item: unknown, index: number, ctx: WorkflowContext) => boolean;
+    /** Maximum concurrent item executions. Default: 1 */
+    maxConcurrency?: number;
+}
+interface AgentStep {
+    id: string;
+    name: string;
+    type: 'agent';
+    prompt: string | ((ctx: WorkflowContext) => string);
+    outputKey: string;
+    execute?: (ctx: WorkflowContext) => Promise<WorkflowContext>;
+    rollback?: (ctx: WorkflowContext) => Promise<void>;
+    retry?: Partial<RetryConfig>;
+}
+type AnyStep = WorkflowStep | ParallelStep | ConditionalStep | LoopStep | ForeachStep | MapStep | AgentStep;
+interface WorkflowDefinition {
+    id: string;
+    name: string;
+    steps: AnyStep[];
+    initialContext?: WorkflowContext;
+    maxDurationMs?: number;
+}
+interface ValidationResult$1 {
+    valid: boolean;
+    errors: string[];
+}
+type WorkflowEventType = 'step:start' | 'step:complete' | 'step:error';
+interface WorkflowEvent {
+    type: WorkflowEventType;
+    stepId: string;
+    stepName: string;
+    timestamp: number;
+    context?: WorkflowContext;
+    error?: string;
+}
+
+interface WorkflowPort {
+    execute(definition: WorkflowDefinition, context?: WorkflowContext): Promise<WorkflowResult>;
+    validate(definition: WorkflowDefinition): ValidationResult;
+}
+interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+type WorkflowEventListener = (event: WorkflowEvent) => void;
+
+export type { AgentStep as A, ConditionalStep as C, ForeachStep as F, InputMapping as I, LoopStep as L, MapStep as M, OutputMapping as O, ParallelStep as P, RetryConfig as R, StepType as S, ValidationResult as V, WorkflowContext as W, WorkflowDefinition as a, WorkflowPort as b, WorkflowEventListener as c, WorkflowResult as d, AnyStep as e, WorkflowEvent as f, WorkflowEventType as g, WorkflowStep as h, ValidationResult$1 as i };

package/package.json

@@ -0,0 +1,230 @@
+{
+  "name": "gauss-ai",
+  "version": "4.0.0",
+  "description": "Gauss — The most complete AI agent framework for TypeScript. 57+ features including multi-agent teams, RAG, workflow DSL, voice STT/TTS, multimodal vision, MCP/A2A protocols, 40+ LLM providers, hexagonal architecture, and visual agent builder.",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "ai",
+    "agent",
+    "agentic",
+    "framework",
+    "llm",
+    "rag",
+    "workflow",
+    "middleware",
+    "mcp",
+    "tools",
+    "multi-agent",
+    "typescript",
+    "hexagonal-architecture",
+    "voice",
+    "multimodal",
+    "a2a"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/giulio-leone/gauss.git",
+    "directory": "gauss-flow"
+  },
+  "homepage": "https://giulio-leone.github.io/gauss/",
+  "bugs": {
+    "url": "https://github.com/giulio-leone/gauss/issues"
+  },
+  "author": "Giulio Leone <https://github.com/giulio-leone>",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "import": "./dist/node/index.js",
+      "require": "./dist/node/index.cjs"
+    },
+    "./deno": {
+      "types": "./dist/deno/index.d.ts",
+      "import": "./dist/deno/index.js"
+    },
+    "./edge": {
+      "types": "./dist/edge/index.d.ts",
+      "import": "./dist/edge/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser/index.d.ts",
+      "import": "./dist/browser/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    },
+    "./rest": {
+      "types": "./dist/rest/index.d.ts",
+      "import": "./dist/rest/index.js",
+      "require": "./dist/rest/index.cjs"
+    },
+    "./scraping": {
+      "types": "./dist/scraping/index.d.ts",
+      "import": "./dist/scraping/index.js",
+      "require": "./dist/scraping/index.cjs"
+    },
+    "./workflow": {
+      "types": "./dist/workflow/index.d.ts",
+      "import": "./dist/workflow/index.js",
+      "require": "./dist/workflow/index.cjs"
+    },
+    "./a2a": {
+      "types": "./dist/a2a/index.d.ts",
+      "import": "./dist/a2a/index.js",
+      "require": "./dist/a2a/index.cjs"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js",
+      "require": "./dist/testing/index.cjs"
+    },
+    "./plugins": {
+      "types": "./dist/plugins/index.d.ts",
+      "import": "./dist/plugins/index.js",
+      "require": "./dist/plugins/index.cjs"
+    },
+    "./runtime/node": {
+      "types": "./dist/runtime-node.d.ts",
+      "import": "./dist/runtime-node.js"
+    },
+    "./runtime/deno": {
+      "types": "./dist/runtime-deno.d.ts",
+      "import": "./dist/runtime-deno.js"
+    },
+    "./runtime/edge": {
+      "types": "./dist/runtime-edge.d.ts",
+      "import": "./dist/runtime-edge.js"
+    },
+    "./providers": {
+      "types": "./dist/providers/index.d.ts",
+      "import": "./dist/providers/index.js",
+      "require": "./dist/providers/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "bin": {
+    "gauss": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:quality:semantic": "vitest run src/evals/__tests__/semantic-search.quality-gate.test.ts src/evals/__tests__/semantic-search-harness.test.ts",
+    "test:benchmark:semantic": "vitest run src/evals/__tests__/semantic-search-benchmark.test.ts src/evals/__tests__/semantic-search.benchmark-gate.test.ts",
+    "test:stress:semantic": "vitest run src/evals/__tests__/semantic-search-stress-suite.test.ts src/evals/__tests__/semantic-search.stress-gate.test.ts",
+    "quality:gate": "npm run test:quality:semantic",
+    "benchmark:gate": "npm run test:benchmark:semantic",
+    "stress:gate": "npm run test:stress:semantic",
+    "prepublishOnly": "npm run build",
+    "clean": "rimraf dist"
+  },
+  "dependencies": {
+    "zod": "^3.25.76"
+  },
+  "peerDependencies": {
+    "@ai-sdk/anthropic": "^3.0.49",
+    "@ai-sdk/google": "^3.0.33",
+    "@ai-sdk/groq": "^3.0.25",
+    "@ai-sdk/mcp": "^1.0.21",
+    "@ai-sdk/mistral": "^3.0.20",
+    "@ai-sdk/openai": "^3.0.36",
+    "@aws-sdk/client-s3": ">=3.0.0",
+    "@aws-sdk/s3-request-presigner": ">=3.0.0",
+    "@openrouter/ai-sdk-provider": "^2.2.3",
+    "@supabase/supabase-js": "^2.95.3",
+    "bullmq": ">=5.0.0",
+    "ioredis": ">=5.0.0",
+    "pg": ">=8.0.0",
+    "tiktoken": "^1.0.22"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/openai": {
+      "optional": true
+    },
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/google": {
+      "optional": true
+    },
+    "@ai-sdk/groq": {
+      "optional": true
+    },
+    "@ai-sdk/mistral": {
+      "optional": true
+    },
+    "@ai-sdk/mcp": {
+      "optional": true
+    },
+    "@openrouter/ai-sdk-provider": {
+      "optional": true
+    },
+    "@supabase/supabase-js": {
+      "optional": true
+    },
+    "tiktoken": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    },
+    "ioredis": {
+      "optional": true
+    },
+    "bullmq": {
+      "optional": true
+    },
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
+    "@aws-sdk/s3-request-presigner": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@ai-sdk/anthropic": "^3.0.50",
+    "@ai-sdk/google": "^3.0.34",
+    "@ai-sdk/groq": "^3.0.26",
+    "@ai-sdk/mcp": "^1.0.0",
+    "@ai-sdk/mistral": "^3.0.21",
+    "@ai-sdk/openai": "^3.0.37",
+    "@aws-sdk/client-s3": "^3.1000.0",
+    "@aws-sdk/s3-request-presigner": "^3.1000.0",
+    "@openrouter/ai-sdk-provider": "^2.2.3",
+    "@supabase/supabase-js": "^2.0.0",
+    "@types/node": "^25.2.3",
+    "@types/pg": "^8.16.0",
+    "@vitest/coverage-v8": "^4.0.15",
+    "bullmq": "^5.70.1",
+    "ioredis": "^5.10.0",
+    "pg": "^8.19.0",
+    "rimraf": "^6.1.2",
+    "tiktoken": "^1.0.0",
+    "tsup": "^8.0.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.15"
+  }
+}