@agntk/core 0.3.0 → 0.3.1

package/dist/types/agent-v2.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview V2 Agent types — minimal, zero-config interface.
+ *
+ * An agent is a fully-equipped worker. You give it a name, instructions,
+ * and a prompt. Everything else is auto-detected.
+ */
+export {};
+//# sourceMappingURL=agent-v2.js.map

package/dist/types/agent-v2.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @agntk/core - Minimal Logger
+ * Zero-dependency logger that works in Node, Bun, and browser environments
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LoggerOptions {
+    level?: LogLevel;
+    enableColors?: boolean;
+    enableTimestamps?: boolean;
+    prefix?: string;
+}
+export interface AgentContext {
+    type: 'main' | 'spawned';
+    taskId?: string;
+}
+export interface LogEntry {
+    timestamp: number;
+    level: LogLevel;
+    message: string;
+    meta: Record<string, unknown> | undefined;
+    formattedMessage: string;
+}
+export type LogSubscriber = (entry: LogEntry) => void;
+export interface Logger {
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+    setLevel(level: LogLevel): void;
+    setAgentContext(context: AgentContext): void;
+    subscribe(callback: LogSubscriber): () => void;
+}
+export declare function createLogger(options?: LoggerOptions): Logger;
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC1C,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAEtD,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IAChC,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7C,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI,CAAC;CAChD;AAgCD,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CA2IhE;AAED,eAAO,MAAM,MAAM,QAAiB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,149 @@
+/**
+ * @agntk/core - Minimal Logger
+ * Zero-dependency logger that works in Node, Bun, and browser environments
+ */
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+const LOG_COLORS = {
+    debug: '\x1b[36m',
+    info: '\x1b[32m',
+    warn: '\x1b[33m',
+    error: '\x1b[31m',
+};
+const RESET_COLOR = '\x1b[0m';
+// Runtime detection for browser vs Node/Bun
+const isBrowser = typeof globalThis !== 'undefined'
+    && typeof globalThis.document !== 'undefined';
+function getEnvLogLevel() {
+    if (isBrowser)
+        return 'info';
+    const envLevel = (typeof process !== 'undefined' ? process.env?.['LOG_LEVEL'] : undefined)?.toLowerCase();
+    if (envLevel && envLevel in LOG_LEVELS) {
+        return envLevel;
+    }
+    return 'info';
+}
+export function createLogger(options = {}) {
+    let currentLevel = options.level ?? getEnvLogLevel();
+    const enableColors = options.enableColors ?? !isBrowser;
+    const enableTimestamps = options.enableTimestamps ?? true;
+    const prefix = options.prefix;
+    let agentContext;
+    const subscribers = new Set();
+    function shouldLog(level) {
+        return LOG_LEVELS[level] >= LOG_LEVELS[currentLevel];
+    }
+    function formatMessage(level, message, meta, useColors = enableColors) {
+        const parts = [];
+        if (enableTimestamps) {
+            const timestamp = new Date().toISOString();
+            parts.push(`[${timestamp}]`);
+        }
+        const levelString = level.toUpperCase().padEnd(5);
+        if (useColors && !isBrowser) {
+            parts.push(`${LOG_COLORS[level]}${levelString}${RESET_COLOR}`);
+        }
+        else {
+            parts.push(levelString);
+        }
+        if (prefix) {
+            parts.push(`[${prefix}]`);
+        }
+        if (agentContext) {
+            if (agentContext.type === 'main') {
+                const ctxLabel = useColors && !isBrowser ? '\x1b[1m[MAIN]\x1b[0m' : '[MAIN]';
+                parts.push(ctxLabel);
+            }
+            else if (agentContext.type === 'spawned') {
+                const taskLabel = agentContext.taskId ? agentContext.taskId.slice(-8) : 'sub';
+                const ctxLabel = useColors && !isBrowser
+                    ? `\x1b[90m[SUB:${taskLabel}]\x1b[0m`
+                    : `[SUB:${taskLabel}]`;
+                parts.push(ctxLabel);
+            }
+        }
+        parts.push(message);
+        if (meta && Object.keys(meta).length > 0) {
+            parts.push(JSON.stringify(meta));
+        }
+        return parts.join(' ');
+    }
+    function log(level, message, meta) {
+        if (!shouldLog(level)) {
+            return;
+        }
+        const formatted = formatMessage(level, message, meta);
+        if (isBrowser) {
+            // Browser-compatible logging with colors via console API
+            const style = level === 'error' ? 'color: red'
+                : level === 'warn' ? 'color: orange'
+                    : level === 'debug' ? 'color: cyan'
+                        : 'color: green';
+            console[level === 'debug' ? 'log' : level](`%c${formatted}`, style);
+        }
+        else {
+            // Node/Bun logging
+            switch (level) {
+                case 'error':
+                    console.error(formatted);
+                    break;
+                case 'warn':
+                    console.warn(formatted);
+                    break;
+                case 'info':
+                case 'debug':
+                    console.log(formatted);
+                    break;
+            }
+        }
+        if (subscribers.size > 0) {
+            const entry = {
+                timestamp: Date.now(),
+                level,
+                message,
+                meta,
+                formattedMessage: formatMessage(level, message, meta, false),
+            };
+            for (const callback of Array.from(subscribers)) {
+                try {
+                    callback(entry);
+                }
+                catch {
+                    // Ignore subscriber errors
+                }
+            }
+        }
+    }
+    return {
+        debug(message, meta) {
+            log('debug', message, meta);
+        },
+        info(message, meta) {
+            log('info', message, meta);
+        },
+        warn(message, meta) {
+            log('warn', message, meta);
+        },
+        error(message, meta) {
+            log('error', message, meta);
+        },
+        setLevel(level) {
+            currentLevel = level;
+        },
+        setAgentContext(context) {
+            agentContext = context;
+        },
+        subscribe(callback) {
+            subscribers.add(callback);
+            return () => {
+                subscribers.delete(callback);
+            };
+        },
+    };
+}
+export const logger = createLogger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/workflow/builders/adapt.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @agntk/core - Agent → WorkflowStep Adapter
+ *
+ * Converts an Agent to a WorkflowStep so agents and workflows are interchangeable.
+ */
+import type { Agent } from '../../agent.js';
+import type { WorkflowStep } from './types.js';
+/**
+ * Adapt an Agent to a WorkflowStep.
+ * The agent's generate() method is called with the workflow input prompt.
+ *
+ * @example
+ * ```typescript
+ * const pipeline = createPipeline({
+ *   steps: [asStep(researchAgent), asStep(writerAgent)],
+ * });
+ * ```
+ */
+export declare function asStep(agent: Agent): WorkflowStep;
+//# sourceMappingURL=adapt.d.ts.map

package/dist/workflow/builders/adapt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapt.d.ts","sourceRoot":"","sources":["../../../src/workflow/builders/adapt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,SAAS,CAAC;AAE3E;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAejD"}

package/dist/workflow/builders/adapt.js

@@ -0,0 +1,33 @@
+/**
+ * @agntk/core - Agent → WorkflowStep Adapter
+ *
+ * Converts an Agent to a WorkflowStep so agents and workflows are interchangeable.
+ */
+/**
+ * Adapt an Agent to a WorkflowStep.
+ * The agent's generate() method is called with the workflow input prompt.
+ *
+ * @example
+ * ```typescript
+ * const pipeline = createPipeline({
+ *   steps: [asStep(researchAgent), asStep(writerAgent)],
+ * });
+ * ```
+ */
+export function asStep(agent) {
+    return {
+        async execute(input) {
+            const result = await agent.generate({ prompt: input.prompt });
+            return {
+                text: result.text ?? '',
+                metadata: {
+                    agentId: agent.agentId,
+                    role: agent.role,
+                    steps: result.steps?.length ?? 0,
+                    usage: result.totalUsage,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=adapt.js.map

package/dist/workflow/builders/adapt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapt.js","sourceRoot":"","sources":["../../../src/workflow/builders/adapt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,MAAM,CAAC,KAAY;IACjC,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,KAAoB;YAChC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9D,OAAO;gBACL,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;gBACvB,QAAQ,EAAE;oBACR,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;oBAChC,KAAK,EAAE,MAAM,CAAC,UAAU;iBACzB;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/workflow/builders/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Workflow builders public API.
+ */
+export type { Workflow, WorkflowStep, WorkflowInput, WorkflowOutput, SynthesizeFn, PipelineConfig, ParallelConfig, } from './types.js';
+export { createPipeline } from './pipeline.js';
+export { createParallel } from './parallel.js';
+export { asStep } from './adapt.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/workflow/builders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflow/builders/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC"}

package/dist/workflow/builders/index.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Workflow builders public API.
+ */
+export { createPipeline } from './pipeline.js';
+export { createParallel } from './parallel.js';
+export { asStep } from './adapt.js';
+//# sourceMappingURL=index.js.map

package/dist/workflow/builders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workflow/builders/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC"}

package/dist/workflow/builders/parallel.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @agntk/core - Parallel Workflow Builder
+ *
+ * Fan out to multiple agents/workflows concurrently,
+ * then synthesize the results.
+ */
+import type { Workflow, ParallelConfig } from './types.js';
+/**
+ * Create a parallel workflow that fans out to multiple steps concurrently.
+ * All steps receive the same input prompt. Results are merged by the synthesize function.
+ *
+ * @example
+ * ```typescript
+ * const parallel = createParallel({
+ *   name: 'multi-analysis',
+ *   steps: [securityAgent, performanceAgent, codeQualityAgent],
+ *   synthesize: (outputs) => ({
+ *     text: outputs.map(o => o.text).join('\n\n---\n\n'),
+ *   }),
+ * });
+ * const result = await parallel.execute({ prompt: 'Analyze this codebase' });
+ * ```
+ */
+export declare function createParallel(config: ParallelConfig): Workflow;
+//# sourceMappingURL=parallel.d.ts.map

package/dist/workflow/builders/parallel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../../src/workflow/builders/parallel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAiC,cAAc,EAAE,MAAM,SAAS,CAAC;AAIvF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CA2C/D"}

package/dist/workflow/builders/parallel.js

@@ -0,0 +1,60 @@
+/**
+ * @agntk/core - Parallel Workflow Builder
+ *
+ * Fan out to multiple agents/workflows concurrently,
+ * then synthesize the results.
+ */
+import { createLogger } from '@agntk/logger';
+const log = createLogger('@agntk/core:workflow:parallel');
+/**
+ * Create a parallel workflow that fans out to multiple steps concurrently.
+ * All steps receive the same input prompt. Results are merged by the synthesize function.
+ *
+ * @example
+ * ```typescript
+ * const parallel = createParallel({
+ *   name: 'multi-analysis',
+ *   steps: [securityAgent, performanceAgent, codeQualityAgent],
+ *   synthesize: (outputs) => ({
+ *     text: outputs.map(o => o.text).join('\n\n---\n\n'),
+ *   }),
+ * });
+ * const result = await parallel.execute({ prompt: 'Analyze this codebase' });
+ * ```
+ */
+export function createParallel(config) {
+    const { name = 'parallel', steps, synthesize } = config;
+    if (steps.length === 0) {
+        throw new Error('Parallel workflow must have at least one step');
+    }
+    return {
+        name,
+        stepCount: steps.length,
+        async execute(input) {
+            log.info('Parallel started', { name, stepCount: steps.length, promptLength: input.prompt.length });
+            const results = await Promise.allSettled(steps.map((step, i) => {
+                log.debug('Parallel step launched', { name, step: i + 1 });
+                return step.execute(input);
+            }));
+            const outputs = [];
+            for (let i = 0; i < results.length; i++) {
+                const result = results[i];
+                if (result.status === 'fulfilled') {
+                    outputs.push(result.value);
+                }
+                else {
+                    log.error('Parallel step failed', { name, step: i + 1, error: String(result.reason) });
+                    outputs.push({
+                        text: `[Step ${i + 1} failed: ${result.reason instanceof Error ? result.reason.message : String(result.reason)}]`,
+                        metadata: { error: true },
+                    });
+                }
+            }
+            log.debug('Synthesizing parallel outputs', { name, outputCount: outputs.length });
+            const synthesized = await synthesize(outputs);
+            log.info('Parallel completed', { name, textLength: synthesized.text.length });
+            return synthesized;
+        },
+    };
+}
+//# sourceMappingURL=parallel.js.map

package/dist/workflow/builders/parallel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.js","sourceRoot":"","sources":["../../../src/workflow/builders/parallel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,GAAG,GAAG,YAAY,CAAC,+BAA+B,CAAC,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,MAAM,EAAE,IAAI,GAAG,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAExD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,KAAK,CAAC,MAAM;QAEvB,KAAK,CAAC,OAAO,CAAC,KAAoB;YAChC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAEnG,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;gBACpB,GAAG,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,OAAO,GAAqB,EAAE,CAAC;YACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC1B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;oBAClC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACN,GAAG,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACvF,OAAO,CAAC,IAAI,CAAC;wBACX,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG;wBACjH,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;qBAC1B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,GAAG,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAClF,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;YAE9C,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAE9E,OAAO,WAAW,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/workflow/builders/pipeline.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @agntk/core - Pipeline Workflow Builder
+ *
+ * Chain agents/workflows sequentially. Each step's output
+ * becomes the next step's input prompt.
+ */
+import type { Workflow, PipelineConfig } from './types.js';
+/**
+ * Create a pipeline that chains steps sequentially.
+ * Each step's text output becomes the next step's prompt.
+ *
+ * @example
+ * ```typescript
+ * const pipeline = createPipeline({
+ *   name: 'research-then-write',
+ *   steps: [researchAgent, writerAgent],
+ * });
+ * const result = await pipeline.execute({ prompt: 'Write about quantum computing' });
+ * ```
+ */
+export declare function createPipeline(config: PipelineConfig): Workflow;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/workflow/builders/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/workflow/builders/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAiC,cAAc,EAAE,MAAM,SAAS,CAAC;AAIvF;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CAkC/D"}

package/dist/workflow/builders/pipeline.js

@@ -0,0 +1,48 @@
+/**
+ * @agntk/core - Pipeline Workflow Builder
+ *
+ * Chain agents/workflows sequentially. Each step's output
+ * becomes the next step's input prompt.
+ */
+import { createLogger } from '@agntk/logger';
+const log = createLogger('@agntk/core:workflow:pipeline');
+/**
+ * Create a pipeline that chains steps sequentially.
+ * Each step's text output becomes the next step's prompt.
+ *
+ * @example
+ * ```typescript
+ * const pipeline = createPipeline({
+ *   name: 'research-then-write',
+ *   steps: [researchAgent, writerAgent],
+ * });
+ * const result = await pipeline.execute({ prompt: 'Write about quantum computing' });
+ * ```
+ */
+export function createPipeline(config) {
+    const { name = 'pipeline', steps, transform } = config;
+    if (steps.length === 0) {
+        throw new Error('Pipeline must have at least one step');
+    }
+    return {
+        name,
+        stepCount: steps.length,
+        async execute(input) {
+            log.info('Pipeline started', { name, stepCount: steps.length, promptLength: input.prompt.length });
+            let currentOutput = { text: input.prompt };
+            for (let i = 0; i < steps.length; i++) {
+                const step = steps[i];
+                const prompt = i === 0
+                    ? input.prompt
+                    : transform
+                        ? transform(currentOutput, i)
+                        : currentOutput.text;
+                log.debug('Pipeline step', { name, step: i + 1, total: steps.length, promptLength: prompt.length });
+                currentOutput = await step.execute({ prompt });
+            }
+            log.info('Pipeline completed', { name, textLength: currentOutput.text.length });
+            return currentOutput;
+        },
+    };
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/workflow/builders/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../src/workflow/builders/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,GAAG,GAAG,YAAY,CAAC,+BAA+B,CAAC,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,MAAM,EAAE,IAAI,GAAG,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAEvD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,KAAK,CAAC,MAAM;QAEvB,KAAK,CAAC,OAAO,CAAC,KAAoB;YAChC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAEnG,IAAI,aAAa,GAAmB,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;YAE3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC;oBACpB,CAAC,CAAC,KAAK,CAAC,MAAM;oBACd,CAAC,CAAC,SAAS;wBACT,CAAC,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC;wBAC7B,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;gBAEzB,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBAEpG,aAAa,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;YACjD,CAAC;YAED,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAEhF,OAAO,aAAa,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/workflow/builders/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview Types for workflow builders (Pipeline, Parallel).
+ */
+/**
+ * A Workflow step that can execute with a prompt and return text.
+ * Compatible with the Agent interface so agents and workflows are interchangeable.
+ */
+export interface WorkflowStep {
+    /** Execute the step with a prompt. */
+    execute: (input: WorkflowInput) => Promise<WorkflowOutput>;
+}
+/** Input to a workflow step. */
+export interface WorkflowInput {
+    prompt: string;
+}
+/** Output from a workflow step. */
+export interface WorkflowOutput {
+    text: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A Workflow that composes multiple steps.
+ * Implements WorkflowStep so it can nest inside other workflows.
+ */
+export interface Workflow extends WorkflowStep {
+    /** Name of this workflow. */
+    name: string;
+    /** Number of steps in this workflow. */
+    stepCount: number;
+}
+/**
+ * Synthesize function for parallel workflows.
+ * Receives all outputs and produces a merged result.
+ */
+export type SynthesizeFn = (outputs: WorkflowOutput[]) => WorkflowOutput | Promise<WorkflowOutput>;
+/** Configuration for createPipeline. */
+export interface PipelineConfig {
+    /** Pipeline name. */
+    name?: string;
+    /** Steps to execute sequentially. */
+    steps: WorkflowStep[];
+    /** Optional transform between steps (receives previous output, returns next prompt). */
+    transform?: (output: WorkflowOutput, stepIndex: number) => string;
+}
+/** Configuration for createParallel. */
+export interface ParallelConfig {
+    /** Parallel workflow name. */
+    name?: string;
+    /** Steps to execute concurrently. */
+    steps: WorkflowStep[];
+    /** Function to synthesize/merge parallel outputs. */
+    synthesize: SynthesizeFn;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workflow/builders/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/workflow/builders/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5D;AAED,gCAAgC;AAChC,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,QAAS,SAAQ,YAAY;IAC5C,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAEnG,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,wFAAwF;IACxF,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CACnE;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,qDAAqD;IACrD,UAAU,EAAE,YAAY,CAAC;CAC1B"}

package/dist/workflow/builders/types.js

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Types for workflow builders (Pipeline, Parallel).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/workflow/builders/types.js.map

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