@limo-labs/deity 0.1.0-alpha.0

package/dist/src/stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage.d.ts","sourceRoot":"","sources":["../../src/stage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAElF;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,MAAM,EAAE,CAAC,CAAC;IACV,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,YAAY,EAAE,mBAAmB,CAAC;IAElC;;;OAGG;IACH,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1B,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAE3B,WAAW,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEtE,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IAEf,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC;IAEhE,KAAK,CAAC,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB;;;WAGG;QACH,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,KAAK,CAAC,EAAE;QACN;;;;;;;;WAQG;QACH,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;QAE9D;;;;;;WAMG;QACH,QAAQ,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC;QAE9C;;;;;WAKG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;CACH"}

package/dist/src/stage.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stage.js.map

package/dist/src/stage.js.map

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

package/dist/src/store.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Record of a single stage checkpoint in the state store.
+ */
+export interface StageRecord {
+    stageId: string;
+    status: "completed" | "failed";
+    output?: unknown;
+    promptHash: string;
+    modelName?: string;
+    generationConfig?: Record<string, unknown>;
+    toolCalls?: Array<{
+        toolName: string;
+        arguments: Record<string, unknown>;
+        result: unknown;
+    }>;
+    validationErrors?: string[];
+    timestamp: string;
+}
+/**
+ * State store interface for persisting stage checkpoints.
+ * Implementations must be crash-safe (write then rename).
+ */
+export interface StateStore {
+    /**
+     * Check if a valid checkpoint exists for a stage.
+     * Returns false if no checkpoint, if stage failed, or if prompt hash changed.
+     */
+    hasValidCheckpoint(stageId: string, currentPromptHash: string): Promise<boolean>;
+    /**
+     * Load a completed stage's output.
+     * Returns undefined if no valid checkpoint.
+     */
+    load(stageId: string): Promise<unknown | undefined>;
+    /**
+     * Save a completed stage's output with metadata.
+     */
+    save(stageId: string, output: unknown, metadata: Omit<StageRecord, "stageId" | "status" | "output" | "timestamp">): Promise<void>;
+    /**
+     * Mark a stage as permanently failed.
+     */
+    markFailed(stageId: string, errors: string[], metadata: Omit<StageRecord, "stageId" | "status" | "validationErrors" | "timestamp">): Promise<void>;
+    /**
+     * Load all stage records (for building ExecutionContext).
+     */
+    loadAll(): Promise<Record<string, StageRecord>>;
+    /**
+     * Clear a specific stage's checkpoint (for cache invalidation).
+     */
+    clear(stageId: string): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/src/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjF;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAEpD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElI;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,QAAQ,GAAG,kBAAkB,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnJ;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAEhD;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC"}

package/dist/src/store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.js.map

package/dist/src/store.js.map

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

package/dist/src/tool.d.ts

@@ -0,0 +1,12 @@
+import { type ZodSchema } from "zod";
+/**
+ * Tool definition for LLM function calling.
+ * Tools are executed by the runtime, never directly by the model.
+ */
+export interface Tool {
+    name: string;
+    description: string;
+    inputSchema: ZodSchema<any>;
+    execute(input: any): Promise<any>;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/src/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,KAAK,CAAC;AAErC;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACnC"}

package/dist/src/tool.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool.js.map

package/dist/src/tool.js.map

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

package/dist/src/trace.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Memory statistics snapshot for trace logging.
+ * @since 2.0.0
+ */
+export interface TraceMemoryStats {
+    /** Hot memory tier statistics */
+    hot?: {
+        itemCount: number;
+        estimatedSize: number;
+        hitCount: number;
+        missCount: number;
+    };
+    /** Warm storage tier statistics */
+    warm?: {
+        fileCount: number;
+        totalSize: number;
+    };
+    /** Cold storage tier statistics */
+    cold?: {
+        fileCount: number;
+        totalSize: number;
+    };
+}
+/**
+ * Performance metrics for trace logging.
+ * @since 2.0.0
+ */
+export interface TracePerformanceMetrics {
+    /** Execution duration in milliseconds */
+    duration?: number;
+    /** LLM call duration in milliseconds */
+    llmDuration?: number;
+    /** Tool execution duration in milliseconds */
+    toolDuration?: number;
+    /** Memory operation duration in milliseconds */
+    memoryDuration?: number;
+}
+/**
+ * A single trace entry recorded during pipeline execution.
+ */
+export interface TraceEntry {
+    timestamp: string;
+    stageId: string;
+    event: "stage_start" | "stage_complete" | "stage_failed" | "llm_request" | "llm_response" | "tool_call" | "tool_result" | "validation_pass" | "validation_fail" | "parse_error" | "retry";
+    data?: Record<string, unknown>;
+    /** Memory statistics at time of event (Phase 5.4) */
+    memory?: TraceMemoryStats;
+    /** Performance metrics (Phase 5.4) */
+    performance?: TracePerformanceMetrics;
+}
+/**
+ * Append-only trace logger interface.
+ * Records all execution steps for debugging and inspection.
+ */
+export interface TraceLogger {
+    log(entry: Omit<TraceEntry, "timestamp">): void;
+    getEntries(): TraceEntry[];
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=trace.d.ts.map

package/dist/src/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/trace.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,GAAG,CAAC,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,mCAAmC;IACnC,IAAI,CAAC,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,mCAAmC;IACnC,IAAI,CAAC,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EACD,aAAa,GACb,gBAAgB,GAChB,cAAc,GACd,aAAa,GACb,cAAc,GACd,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,iBAAiB,GACjB,aAAa,GACb,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,qDAAqD;IACrD,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,sCAAsC;IACtC,WAAW,CAAC,EAAE,uBAAuB,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;IAChD,UAAU,IAAI,UAAU,EAAE,CAAC;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/src/trace.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=trace.js.map

package/dist/src/trace.js.map

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

package/dist/src/validator.d.ts

@@ -0,0 +1,17 @@
+import type { ValidationResult } from "./component.js";
+import type { ZodSchema } from "zod";
+/**
+ * Validate an output against a Zod schema.
+ * Returns a ValidationResult with detailed error messages.
+ */
+export declare function validateSchema<T>(output: unknown, schema: ZodSchema<T>): ValidationResult;
+/**
+ * Format a Zod error into a human-readable string.
+ */
+export declare function formatZodError(error: {
+    issues: Array<{
+        path: Array<string | number>;
+        message: string;
+    }>;
+}): string;
+//# sourceMappingURL=validator.d.ts.map

package/dist/src/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAErC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAUzF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE;IAAE,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,MAAM,CAIlH"}

package/dist/src/validator.js

@@ -0,0 +1,21 @@
+/**
+ * Validate an output against a Zod schema.
+ * Returns a ValidationResult with detailed error messages.
+ */
+export function validateSchema(output, schema) {
+    const result = schema.safeParse(output);
+    if (result.success) {
+        return { valid: true };
+    }
+    const errors = result.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`);
+    return { valid: false, errors };
+}
+/**
+ * Format a Zod error into a human-readable string.
+ */
+export function formatZodError(error) {
+    return error.issues
+        .map((issue) => `${issue.path.join(".")}: ${issue.message}`)
+        .join("; ");
+}
+//# sourceMappingURL=validator.js.map

package/dist/src/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/validator.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAI,MAAe,EAAE,MAAoB;IACrE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CACpC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CACvD,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAA2E;IACxG,OAAO,KAAK,CAAC,MAAM;SAChB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;SAC3D,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/src/workflow.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Workflow types and configuration (Deity 2.0 terminology).
+ *
+ * This module defines the core workflow types using the new v2.0 terminology.
+ * The old "Pipeline" terminology is deprecated but still available for backward compatibility.
+ *
+ * **Terminology Change:**
+ * - `Pipeline` → `Workflow` (single agent's sequential execution)
+ * - `PipelineConfig` → `WorkflowConfig`
+ * - `definePipeline()` → `defineWorkflow()`
+ * - `runPipeline()` → `runWorkflow()`
+ *
+ * See TERMINOLOGY.md for migration guide.
+ *
+ * @module workflow
+ * @since 2.0.0
+ */
+import type { AgentComponent } from "./stage.js";
+import type { LLMAdapter, GenerationConfig } from "./llm.js";
+import type { MemoryConfig } from "./memory/memory-config.js";
+import { MemoryPresets } from "./memory/memory-config.js";
+/**
+ * Workflow configuration.
+ *
+ * Defines the settings for a single agent's workflow execution.
+ * A workflow is a deterministic sequence of steps (AgentComponents) that the agent executes.
+ *
+ * **Key Concept:** Deity manages a single agent's workflow, not a multi-agent pipeline.
+ * This terminology clarifies Deity's scope and purpose.
+ *
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const workflowConfig: WorkflowConfig = {
+ *   name: "research-workflow",
+ *   description: "Researches a topic and generates a report",
+ *   defaultModel: {
+ *     adapter: new OpenAIAdapter({ apiKey: "..." }),
+ *     config: { temperature: 0.7, maxTokens: 2000 }
+ *   },
+ *   onStageFailure: "abort",
+ *   maxToolRounds: 10,
+ *   memoryConfig: "production"
+ * };
+ * ```
+ */
+export interface WorkflowConfig {
+    /** Unique name for this workflow */
+    name: string;
+    /** Optional description of what this workflow does */
+    description?: string;
+    /**
+     * Default LLM adapter and generation config for all steps.
+     *
+     * Individual steps can override this with their own model configuration.
+     */
+    defaultModel?: {
+        adapter: LLMAdapter;
+        config?: GenerationConfig;
+    };
+    /**
+     * Behavior when a step fails after exhausting retries.
+     *
+     * - `"abort"` (default): Stop workflow execution and throw error
+     * - `"skip"`: Continue to next step, marking this step as failed
+     */
+    onStageFailure?: "abort" | "skip";
+    /**
+     * Maximum tool calling rounds per step.
+     *
+     * Prevents infinite tool calling loops.
+     * @default 10
+     */
+    maxToolRounds?: number;
+    /**
+     * Maximum number of tool calls to execute concurrently.
+     *
+     * When the LLM returns multiple independent tool calls, they can be executed
+     * in parallel. This setting limits how many tools run simultaneously to prevent
+     * resource exhaustion.
+     *
+     * Set to 1 to disable parallel execution (sequential only).
+     * Set to Infinity for unlimited concurrency.
+     *
+     * @default Infinity
+     * @since 2.0.0
+     */
+    parallelToolConcurrency?: number;
+    /**
+     * Memory configuration for tiered storage system.
+     *
+     * Defines how the workflow manages its memory across hot/warm/cold tiers:
+     * - **Hot memory**: In-memory LRU cache for frequently accessed data
+     * - **Warm storage**: Compressed disk cache for less frequently accessed data
+     * - **Cold storage**: Uncompressed disk archive for long-term storage
+     *
+     * You can use preset names ("development", "production", "minimal") or provide
+     * a full MemoryConfig object.
+     *
+     * **Note:** This configuration will be integrated with TieredStateStore in future tasks.
+     * For now, you still need to pass a StateStore directly to runWorkflow().
+     *
+     * @since 2.0.0
+     * @example
+     * ```typescript
+     * // Use a preset
+     * const workflow = defineWorkflow({
+     *   name: "my-workflow",
+     *   memoryConfig: "production",
+     *   steps: [Step1, Step2],
+     * });
+     *
+     * // Use custom config
+     * const workflow = defineWorkflow({
+     *   name: "my-workflow",
+     *   memoryConfig: {
+     *     hot: { maxItems: 2000 },
+     *     warm: { enabled: true, maxSize: 1024 * 1024 * 1024 },
+     *     cold: { enabled: true, directory: ".archive" },
+     *   },
+     *   steps: [Step1, Step2],
+     * });
+     * ```
+     */
+    memoryConfig?: MemoryConfig | keyof typeof MemoryPresets;
+}
+/**
+ * Workflow definition combining config and steps.
+ *
+ * A workflow represents a single agent's complete execution path through
+ * a sequence of steps (AgentComponents).
+ *
+ * **Design Philosophy:**
+ * Deity is a framework for building **single AI agents**, not multi-agent systems.
+ * A workflow is one agent's deterministic execution flow.
+ *
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const workflow: Workflow = {
+ *   config: {
+ *     name: "research-workflow",
+ *     defaultModel: { adapter: llm }
+ *   },
+ *   steps: [
+ *     ResearchComponent,
+ *     AnalysisComponent,
+ *     ReportComponent
+ *   ]
+ * };
+ * ```
+ */
+export interface Workflow {
+    /** Workflow configuration */
+    config: WorkflowConfig;
+    /** Sequence of steps to execute (AgentComponents) */
+    steps: AgentComponent<any, any>[];
+}
+/**
+ * Define a workflow with configuration and steps.
+ *
+ * This is the primary way to create a workflow definition in Deity 2.0.
+ *
+ * **Terminology Note:** Replaces `definePipeline()` from v1.x. The old function
+ * still works but is deprecated.
+ *
+ * @param options - Workflow configuration with steps
+ * @returns Workflow definition ready for execution
+ *
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * import { defineWorkflow } from '@limo-labs/deity';
+ *
+ * const workflow = defineWorkflow({
+ *   name: "my-workflow",
+ *   description: "Processes data through multiple steps",
+ *   defaultModel: { adapter: llm },
+ *   steps: [Step1, Step2, Step3]
+ * });
+ *
+ * // Execute the workflow
+ * const result = await runWorkflow(workflow, inputs, store, trace);
+ * ```
+ */
+export declare function defineWorkflow(options: WorkflowConfig & {
+    steps: AgentComponent<any, any>[];
+}): Workflow;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/src/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,YAAY,CAAC,EAAE;QACb,OAAO,EAAE,UAAU,CAAC;QACpB,MAAM,CAAC,EAAE,gBAAgB,CAAC;KAC3B,CAAC;IAEF;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAElC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;;;;;;;;OAYG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,YAAY,CAAC,EAAE,YAAY,GAAG,MAAM,OAAO,aAAa,CAAC;CAC1D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,QAAQ;IACvB,6BAA6B;IAC7B,MAAM,EAAE,cAAc,CAAC;IAEvB,qDAAqD;IACrD,KAAK,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,GAAG;IAAE,KAAK,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAA;CAAE,GAC9D,QAAQ,CAGV"}

package/dist/src/workflow.js

@@ -0,0 +1,50 @@
+/**
+ * Workflow types and configuration (Deity 2.0 terminology).
+ *
+ * This module defines the core workflow types using the new v2.0 terminology.
+ * The old "Pipeline" terminology is deprecated but still available for backward compatibility.
+ *
+ * **Terminology Change:**
+ * - `Pipeline` → `Workflow` (single agent's sequential execution)
+ * - `PipelineConfig` → `WorkflowConfig`
+ * - `definePipeline()` → `defineWorkflow()`
+ * - `runPipeline()` → `runWorkflow()`
+ *
+ * See TERMINOLOGY.md for migration guide.
+ *
+ * @module workflow
+ * @since 2.0.0
+ */
+/**
+ * Define a workflow with configuration and steps.
+ *
+ * This is the primary way to create a workflow definition in Deity 2.0.
+ *
+ * **Terminology Note:** Replaces `definePipeline()` from v1.x. The old function
+ * still works but is deprecated.
+ *
+ * @param options - Workflow configuration with steps
+ * @returns Workflow definition ready for execution
+ *
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * import { defineWorkflow } from '@limo-labs/deity';
+ *
+ * const workflow = defineWorkflow({
+ *   name: "my-workflow",
+ *   description: "Processes data through multiple steps",
+ *   defaultModel: { adapter: llm },
+ *   steps: [Step1, Step2, Step3]
+ * });
+ *
+ * // Execute the workflow
+ * const result = await runWorkflow(workflow, inputs, store, trace);
+ * ```
+ */
+export function defineWorkflow(options) {
+    const { steps, ...config } = options;
+    return { config, steps };
+}
+//# sourceMappingURL=workflow.js.map

package/dist/src/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA2JH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA+D;IAE/D,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IACrC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@limo-labs/deity",
+  "version": "0.1.0-alpha.0",
+  "description": "Deterministic orchestration runtime for AI agents with checkpoint & resume",
+  "keywords": [
+    "ai",
+    "agents",
+    "llm",
+    "orchestration",
+    "workflow",
+    "deterministic",
+    "checkpoint",
+    "typescript",
+    "zod",
+    "validation"
+  ],
+  "homepage": "https://github.com/Limo-Deity/Limo-Deity#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Limo-Deity/Limo-Deity.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/Limo-Deity/Limo-Deity/issues"
+  },
+  "license": "MIT",
+  "author": "Limo-Deity Contributors",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "dist/src/**/*.js",
+    "dist/src/**/*.d.ts",
+    "dist/src/**/*.js.map",
+    "dist/src/**/*.d.ts.map",
+    "!dist/src/__tests__",
+    "!dist/src/**/*.test.*",
+    "!dist/src/poc",
+    "!dist/src/examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "lru-cache": "^11.2.6",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "npm": ">=9.0.0"
+  }
+}