@agntk/core 0.2.0 → 0.3.1

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"}

package/dist/workflow/durable-agent.d.ts

@@ -0,0 +1,128 @@
+/**
+ * @agntk/core - Durable Agent Factory
+ *
+ * Creates agents with workflow durability features.
+ * Uses the Workflow DevKit ("use workflow" / "use step" directives)
+ * for crash recovery, auto-retry, and step-level observability.
+ *
+ * When the `workflow` package is installed and the app runs under the
+ * Workflow runtime, every LLM call and tool execution becomes a
+ * discrete, checkpointed step. Without the runtime, the directives
+ * are inert string literals and the agent operates normally.
+ *
+ * @see https://useworkflow.dev
+ */
+import type { Agent } from '../agent.js';
+import type { AgentOptions, WorkflowOptions } from '../types/agent.js';
+/**
+ * Extended options for creating a durable agent.
+ * Includes all standard AgentOptions plus workflow-specific config.
+ */
+export interface DurableAgentOptions extends AgentOptions {
+    /** Force durability even if detection is uncertain. Default: true */
+    durable?: boolean;
+    /** Workflow-specific configuration. */
+    workflowOptions?: WorkflowOptions;
+}
+/**
+ * Result from a durable generation.
+ */
+export interface DurableGenerateResult {
+    text: string;
+    workflowRunId?: string;
+    steps?: Array<{
+        name: string;
+        status: 'completed' | 'failed' | 'skipped';
+        durationMs?: number;
+    }>;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+/**
+ * Webhook response for approval workflows.
+ */
+export interface WebhookResponse {
+    approved: boolean;
+    feedback?: string;
+    modifiedContent?: string;
+}
+/**
+ * Extended agent interface with durable workflow capabilities.
+ * Extends the base Agent interface with workflow-specific methods.
+ */
+export interface DurableAgent extends Agent {
+    /**
+     * Durable generate that wraps the LLM call as a workflow step.
+     * Survives crashes — the workflow runtime checkpoints progress.
+     */
+    durableGenerate: (prompt: string) => Promise<DurableGenerateResult>;
+    /**
+     * Generate with approval workflow.
+     * Pauses execution (zero compute) until webhook approval is received.
+     */
+    withApproval: (prompt: string, webhookPath: string) => Promise<DurableGenerateResult>;
+    /**
+     * Scheduled generation with durable delay.
+     * Uses workflow sleep() — doesn't hold compute during the delay.
+     */
+    scheduled: (prompt: string, delay: string) => Promise<DurableGenerateResult>;
+    /** Whether workflows are actually active (runtime detected). */
+    readonly isWorkflowActive: boolean;
+    /** The workflow run ID (set after first workflow execution). */
+    readonly workflowRunId: string | undefined;
+}
+/**
+ * Check if the Workflow DevKit runtime is available.
+ * Result is cached after first check.
+ */
+export declare function checkWorkflowAvailability(): Promise<boolean>;
+/**
+ * Reset workflow availability cache (for testing).
+ * @internal
+ */
+export declare function _resetWorkflowCache(): void;
+/**
+ * Create a durable agent with workflow integration.
+ *
+ * The durable agent wraps a standard Agent with workflow directives
+ * that make every LLM call and tool execution a recoverable step.
+ *
+ * @param baseAgent - The base agent to wrap with durability
+ * @param options - Durable agent options
+ * @returns DurableAgent instance with both standard and durable methods
+ *
+ * @example
+ * ```typescript
+ * import { createAgent } from '@agntk/core';
+ * import { createDurableAgent } from '@agntk/core/workflow';
+ *
+ * const base = createAgent({ role: 'coder', toolPreset: 'standard' });
+ * const agent = createDurableAgent(base);
+ *
+ * // Standard generation (no durability)
+ * const result = await agent.generate({ prompt: 'Hello' });
+ *
+ * // Durable generation (survives crashes)
+ * const durable = await agent.durableGenerate('Create a component');
+ *
+ * // With approval workflow
+ * const approved = await agent.withApproval('Draft email', '/api/approve');
+ *
+ * // Scheduled generation
+ * const delayed = await agent.scheduled('Send reminder', '1h');
+ * ```
+ */
+export declare function createDurableAgent(baseAgent: Agent, options?: DurableAgentOptions): DurableAgent;
+/**
+ * Parse a duration string into milliseconds.
+ * Supports: 30s, 5m, 1h, 1d
+ */
+export declare function parseDuration(duration: string): number;
+/**
+ * Format milliseconds as a human-readable duration.
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=durable-agent.d.ts.map

package/dist/workflow/durable-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-agent.d.ts","sourceRoot":"","sources":["../../src/workflow/durable-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQpE;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;QAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,KAAK;IACzC;;;OAGG;IACH,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAEpE;;;OAGG;IACH,YAAY,EAAE,CACZ,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,KAChB,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAEpC;;;OAGG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAE7E,gEAAgE;IAChE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAEnC,gEAAgE;IAChE,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAgBD;;;GAGG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,OAAO,CAAC,CAalE;AAeD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AA4KD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,KAAK,EAChB,OAAO,GAAE,mBAAwB,GAChC,YAAY,CAsEd;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqBtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjD"}