@agntk/core 0.3.0 → 0.3.1

package/dist/workflow/schedulers.d.ts

@@ -0,0 +1,231 @@
+/**
+ * @agntk/core - Scheduled Workflows
+ *
+ * Implements recurring task execution using Workflow DevKit's `sleep()`.
+ * Each scheduled workflow is a durable loop: execute → sleep → repeat.
+ * Zero compute cost during sleep — the workflow runtime suspends the process.
+ *
+ * @see ADV-SCHEDULER-018
+ * @see https://useworkflow.dev
+ */
+import { parseDuration, formatDuration } from './utils.js';
+/**
+ * Configuration for a scheduled workflow.
+ *
+ * @typeParam T - The return type of the task function
+ */
+export interface ScheduledWorkflowConfig<T = void> {
+    /** Human-readable name for this schedule. */
+    name: string;
+    /** Description of what the scheduled task does. */
+    description?: string;
+    /**
+     * Interval between executions.
+     * Duration string (e.g., "1h", "1d", "7d").
+     */
+    interval: string;
+    /**
+     * The task to execute on each tick.
+     * Receives the current iteration number (0-indexed) and returns a result.
+     */
+    task: (iteration: number) => Promise<T> | T;
+    /**
+     * Maximum number of iterations before the workflow stops.
+     * Omit or set to `Infinity` for an infinite loop.
+     * @default Infinity
+     */
+    maxIterations?: number;
+    /**
+     * Whether to run the task immediately on start, or wait for the first interval.
+     * @default true
+     */
+    immediate?: boolean;
+    /**
+     * Called after each successful task execution.
+     */
+    onTick?: (result: T, iteration: number) => void | Promise<void>;
+    /**
+     * Called when a task execution throws an error.
+     * Return `true` to continue the schedule despite the error (default).
+     * Return `false` to stop the schedule.
+     * @default continue
+     */
+    onError?: (error: Error, iteration: number) => boolean | Promise<boolean>;
+}
+/**
+ * A running scheduled workflow instance.
+ *
+ * @typeParam T - The return type of the task function
+ */
+export interface ScheduledWorkflow<T = void> {
+    /** The schedule configuration name. */
+    readonly name: string;
+    /** The schedule configuration description. */
+    readonly description?: string;
+    /** The interval between executions. */
+    readonly interval: string;
+    /**
+     * Start the schedule loop. Returns a promise that resolves
+     * when the schedule completes (hits maxIterations or is cancelled).
+     */
+    start: () => Promise<ScheduleResult<T>>;
+    /**
+     * Cancel the schedule. The current sleep will be interrupted,
+     * and the loop will exit after the current tick completes.
+     */
+    cancel: () => void;
+    /** Whether the schedule is currently running. */
+    readonly isRunning: boolean;
+    /** Number of completed iterations. */
+    readonly completedIterations: number;
+    /** Results from completed iterations. */
+    readonly results: ScheduleTickResult<T>[];
+}
+/**
+ * Result from a single scheduled tick.
+ */
+export interface ScheduleTickResult<T = void> {
+    /** 0-indexed iteration number. */
+    iteration: number;
+    /** Whether the tick succeeded. */
+    success: boolean;
+    /** The result value (if success). */
+    result?: T;
+    /** The error message (if failed). */
+    error?: string;
+    /** Timestamp when the tick completed. */
+    completedAt: Date;
+}
+/**
+ * Final result from a completed schedule.
+ */
+export interface ScheduleResult<T = void> {
+    /** Schedule name. */
+    name: string;
+    /** Total completed iterations. */
+    totalIterations: number;
+    /** Whether the schedule was cancelled. */
+    cancelled: boolean;
+    /** All tick results. */
+    ticks: ScheduleTickResult<T>[];
+}
+/**
+ * Create a scheduled workflow that loops with durable sleep.
+ *
+ * The workflow executes a task, sleeps for the configured interval,
+ * and repeats. Under the Workflow runtime, sleep is zero-compute.
+ *
+ * @param config - Schedule configuration
+ * @returns A `ScheduledWorkflow` instance (call `.start()` to begin)
+ *
+ * @example
+ * ```typescript
+ * const daily = createScheduledWorkflow({
+ *   name: 'daily-briefing',
+ *   interval: '1d',
+ *   task: async (iteration) => {
+ *     const agent = createAgent({ role: 'analyst' });
+ *     const result = await agent.generate({
+ *       prompt: 'Generate a daily briefing summary.',
+ *     });
+ *     return result.text;
+ *   },
+ *   onTick: (text, i) => console.log(`Briefing #${i}:`, text),
+ * });
+ *
+ * await daily.start(); // Loops forever with 1d sleep between ticks
+ * ```
+ */
+export declare function createScheduledWorkflow<T = void>(config: ScheduledWorkflowConfig<T>): ScheduledWorkflow<T>;
+/**
+ * Options for the daily briefing schedule preset.
+ */
+export interface DailyBriefingOptions {
+    /**
+     * The task that generates the briefing content.
+     * Receives the iteration number.
+     */
+    generateBriefing: (iteration: number) => Promise<string>;
+    /**
+     * Called with each briefing (e.g., send email, post to Slack).
+     */
+    deliver: (briefing: string, iteration: number) => void | Promise<void>;
+    /**
+     * Override the default interval. Default: "1d"
+     */
+    interval?: string;
+    /**
+     * Maximum number of briefings. Default: Infinity
+     */
+    maxIterations?: number;
+}
+/**
+ * Create a daily briefing scheduled workflow.
+ *
+ * Runs a briefing generation task once per day (configurable),
+ * delivering the result via a callback.
+ *
+ * @example
+ * ```typescript
+ * const briefing = createDailyBriefing({
+ *   generateBriefing: async () => {
+ *     const agent = createAgent({ role: 'analyst' });
+ *     const result = await agent.generate({
+ *       prompt: 'Summarize today\'s calendar, emails, and tasks.',
+ *     });
+ *     return result.text;
+ *   },
+ *   deliver: (text) => sendSlackMessage('#daily', text),
+ * });
+ *
+ * await briefing.start();
+ * ```
+ */
+export declare function createDailyBriefing(options: DailyBriefingOptions): ScheduledWorkflow<string>;
+/**
+ * Options for the weekly report schedule preset.
+ */
+export interface WeeklyReportOptions {
+    /**
+     * The task that generates the weekly report.
+     * Receives the iteration (week) number.
+     */
+    generateReport: (week: number) => Promise<string>;
+    /**
+     * Called with each report (e.g., send email, save to file).
+     */
+    deliver: (report: string, week: number) => void | Promise<void>;
+    /**
+     * Override the default interval. Default: "7d"
+     */
+    interval?: string;
+    /**
+     * Maximum number of reports. Default: Infinity
+     */
+    maxIterations?: number;
+}
+/**
+ * Create a weekly report scheduled workflow.
+ *
+ * Runs a report generation task once per week (configurable),
+ * delivering the result via a callback.
+ *
+ * @example
+ * ```typescript
+ * const report = createWeeklyReport({
+ *   generateReport: async (week) => {
+ *     const agent = createAgent({ role: 'analyst' });
+ *     const result = await agent.generate({
+ *       prompt: `Generate weekly report #${week + 1}.`,
+ *     });
+ *     return result.text;
+ *   },
+ *   deliver: (text) => sendEmail('team@company.com', 'Weekly Report', text),
+ * });
+ *
+ * await report.start();
+ * ```
+ */
+export declare function createWeeklyReport(options: WeeklyReportOptions): ScheduledWorkflow<string>;
+export { parseDuration, formatDuration };
+//# sourceMappingURL=schedulers.d.ts.map

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

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

package/dist/workflow/schedulers.js

@@ -0,0 +1,250 @@
+/**
+ * @agntk/core - Scheduled Workflows
+ *
+ * Implements recurring task execution using Workflow DevKit's `sleep()`.
+ * Each scheduled workflow is a durable loop: execute → sleep → repeat.
+ * Zero compute cost during sleep — the workflow runtime suspends the process.
+ *
+ * @see ADV-SCHEDULER-018
+ * @see https://useworkflow.dev
+ */
+import { createLogger } from '@agntk/logger';
+import { sleep } from './hooks.js';
+import { parseDuration, formatDuration } from './utils.js';
+const log = createLogger('@agntk/core:workflow:scheduler');
+// ============================================================================
+// Scheduled Workflow Factory
+// ============================================================================
+/**
+ * Create a scheduled workflow that loops with durable sleep.
+ *
+ * The workflow executes a task, sleeps for the configured interval,
+ * and repeats. Under the Workflow runtime, sleep is zero-compute.
+ *
+ * @param config - Schedule configuration
+ * @returns A `ScheduledWorkflow` instance (call `.start()` to begin)
+ *
+ * @example
+ * ```typescript
+ * const daily = createScheduledWorkflow({
+ *   name: 'daily-briefing',
+ *   interval: '1d',
+ *   task: async (iteration) => {
+ *     const agent = createAgent({ role: 'analyst' });
+ *     const result = await agent.generate({
+ *       prompt: 'Generate a daily briefing summary.',
+ *     });
+ *     return result.text;
+ *   },
+ *   onTick: (text, i) => console.log(`Briefing #${i}:`, text),
+ * });
+ *
+ * await daily.start(); // Loops forever with 1d sleep between ticks
+ * ```
+ */
+export function createScheduledWorkflow(config) {
+    const { name, description, interval, task, maxIterations = Infinity, immediate = true, onTick, onError, } = config;
+    // Validate interval eagerly
+    const intervalMs = parseDuration(interval);
+    let _running = false;
+    let _cancelled = false;
+    let _iteration = 0;
+    const _results = [];
+    log.info('Scheduled workflow created', {
+        name,
+        interval,
+        intervalMs,
+        maxIterations: maxIterations === Infinity ? 'infinite' : maxIterations,
+        immediate,
+    });
+    async function executeTick(iteration) {
+        log.debug('Executing tick', { name, iteration });
+        try {
+            const result = await task(iteration);
+            const tickResult = {
+                iteration,
+                success: true,
+                result,
+                completedAt: new Date(),
+            };
+            if (onTick) {
+                await onTick(result, iteration);
+            }
+            log.info('Tick completed', { name, iteration });
+            return tickResult;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            log.error('Tick failed', { name, iteration, error: error.message });
+            const tickResult = {
+                iteration,
+                success: false,
+                error: error.message,
+                completedAt: new Date(),
+            };
+            if (onError) {
+                const shouldContinue = await onError(error, iteration);
+                if (!shouldContinue) {
+                    log.info('onError returned false — stopping schedule', { name });
+                    _cancelled = true;
+                }
+            }
+            return tickResult;
+        }
+    }
+    async function start() {
+        if (_running) {
+            throw new Error(`Schedule "${name}" is already running`);
+        }
+        _running = true;
+        _cancelled = false;
+        _iteration = 0;
+        _results.length = 0;
+        log.info('Schedule started', { name, interval, maxIterations: maxIterations === Infinity ? 'infinite' : maxIterations });
+        try {
+            while (_iteration < maxIterations && !_cancelled) {
+                // Sleep before first tick if not immediate
+                if (_iteration === 0 && !immediate) {
+                    log.debug('Waiting for first interval before executing', { name, interval });
+                    await sleep(interval, { reason: `${name}: waiting for first interval` });
+                    if (_cancelled)
+                        break;
+                }
+                // Execute the tick
+                const tickResult = await executeTick(_iteration);
+                _results.push(tickResult);
+                _iteration++;
+                if (_cancelled)
+                    break;
+                // Sleep between iterations (skip after last)
+                if (_iteration < maxIterations) {
+                    log.debug('Sleeping between ticks', {
+                        name,
+                        iteration: _iteration,
+                        interval,
+                        intervalMs,
+                    });
+                    await sleep(interval, {
+                        reason: `${name}: interval sleep (iteration ${_iteration})`,
+                    });
+                }
+            }
+        }
+        finally {
+            _running = false;
+        }
+        const result = {
+            name,
+            totalIterations: _results.length,
+            cancelled: _cancelled,
+            ticks: [..._results],
+        };
+        log.info('Schedule completed', {
+            name,
+            totalIterations: result.totalIterations,
+            cancelled: result.cancelled,
+        });
+        return result;
+    }
+    function cancel() {
+        if (!_running) {
+            log.warn('cancel() called but schedule is not running', { name });
+            return;
+        }
+        log.info('Schedule cancelled', { name, iteration: _iteration });
+        _cancelled = true;
+    }
+    return {
+        name,
+        description,
+        interval,
+        start,
+        cancel,
+        get isRunning() {
+            return _running;
+        },
+        get completedIterations() {
+            return _results.length;
+        },
+        get results() {
+            return [..._results];
+        },
+    };
+}
+/**
+ * Create a daily briefing scheduled workflow.
+ *
+ * Runs a briefing generation task once per day (configurable),
+ * delivering the result via a callback.
+ *
+ * @example
+ * ```typescript
+ * const briefing = createDailyBriefing({
+ *   generateBriefing: async () => {
+ *     const agent = createAgent({ role: 'analyst' });
+ *     const result = await agent.generate({
+ *       prompt: 'Summarize today\'s calendar, emails, and tasks.',
+ *     });
+ *     return result.text;
+ *   },
+ *   deliver: (text) => sendSlackMessage('#daily', text),
+ * });
+ *
+ * await briefing.start();
+ * ```
+ */
+export function createDailyBriefing(options) {
+    const { generateBriefing, deliver, interval = '1d', maxIterations, } = options;
+    return createScheduledWorkflow({
+        name: 'daily-briefing',
+        description: 'Generate and deliver a daily briefing summary',
+        interval,
+        maxIterations,
+        task: generateBriefing,
+        onTick: deliver,
+        onError: async (error, iteration) => {
+            log.error('Daily briefing failed', { iteration, error: error.message });
+            return true; // Continue schedule despite error
+        },
+    });
+}
+/**
+ * Create a weekly report scheduled workflow.
+ *
+ * Runs a report generation task once per week (configurable),
+ * delivering the result via a callback.
+ *
+ * @example
+ * ```typescript
+ * const report = createWeeklyReport({
+ *   generateReport: async (week) => {
+ *     const agent = createAgent({ role: 'analyst' });
+ *     const result = await agent.generate({
+ *       prompt: `Generate weekly report #${week + 1}.`,
+ *     });
+ *     return result.text;
+ *   },
+ *   deliver: (text) => sendEmail('team@company.com', 'Weekly Report', text),
+ * });
+ *
+ * await report.start();
+ * ```
+ */
+export function createWeeklyReport(options) {
+    const { generateReport, deliver, interval = '7d', maxIterations, } = options;
+    return createScheduledWorkflow({
+        name: 'weekly-report',
+        description: 'Generate and deliver a weekly report',
+        interval,
+        maxIterations,
+        task: generateReport,
+        onTick: deliver,
+        onError: async (error, iteration) => {
+            log.error('Weekly report failed', { week: iteration, error: error.message });
+            return true; // Continue schedule despite error
+        },
+    });
+}
+// Re-export used helpers for convenience
+export { parseDuration, formatDuration };
+//# sourceMappingURL=schedulers.js.map

package/dist/workflow/schedulers.js.map

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

package/dist/workflow/team/create-team.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview createTeam — public API for team coordination.
+ *
+ * Creates a Team that satisfies the Workflow interface, enabling
+ * composition with createPipeline and createParallel.
+ */
+import type { TeamConfig, Team } from './types.js';
+/**
+ * Create a team of agents that coordinate via messaging, claim tasks
+ * from a shared board, and produce synthesized results.
+ *
+ * Satisfies the Workflow interface so it can be used inside createPipeline
+ * or createParallel.
+ *
+ * @example
+ * ```typescript
+ * const team = createTeam({
+ *   name: 'research-team',
+ *   lead: { name: 'lead', agent: leadAgent },
+ *   members: [
+ *     { name: 'researcher', agent: researchAgent },
+ *     { name: 'writer', agent: writerAgent },
+ *   ],
+ *   tasks: [
+ *     { id: 'research', description: 'Research the topic' },
+ *     { id: 'write', description: 'Write the report', dependsOn: ['research'] },
+ *   ],
+ * });
+ *
+ * const result = await team.execute({ prompt: 'quantum computing' });
+ * ```
+ */
+export declare function createTeam(config: TeamConfig): Team;
+//# sourceMappingURL=create-team.d.ts.map

package/dist/workflow/team/create-team.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-team.d.ts","sourceRoot":"","sources":["../../../src/workflow/team/create-team.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,UAAU,EAEV,IAAI,EAOL,MAAM,SAAS,CAAC;AAOjB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CA4JnD"}