@agntk/core 0.3.0 → 0.3.1

package/dist/workflow/team/task-board.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Task board with dependency DAG for team coordination.
+ * Provides atomic task claiming and dependency gating.
+ */
+import type { TaskDefinition, TaskState } from './types.js';
+export declare class TaskBoard {
+    private tasks;
+    constructor(definitions?: TaskDefinition[]);
+    /**
+     * Add a task to the board.
+     */
+    addTask(task: TaskDefinition): void;
+    /**
+     * Attempt to claim a task (atomic — no double-claim).
+     * Returns true if claimed successfully, false otherwise.
+     */
+    claim(taskId: string, memberName: string): boolean;
+    /**
+     * Complete a claimed task with a result.
+     */
+    complete(taskId: string, result: string): boolean;
+    /**
+     * Check if all dependencies for a task are completed.
+     */
+    areDependenciesMet(task: TaskDefinition): boolean;
+    /**
+     * Get all available (claimable) tasks.
+     */
+    getAvailable(): TaskState[];
+    /**
+     * Get all tasks.
+     */
+    getAll(): TaskState[];
+    /**
+     * Check if all tasks are completed.
+     */
+    isAllCompleted(): boolean;
+    /**
+     * Get task count by status.
+     */
+    getCounts(): {
+        pending: number;
+        claimed: number;
+        completed: number;
+    };
+}
+//# sourceMappingURL=task-board.d.ts.map

package/dist/workflow/team/task-board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-board.d.ts","sourceRoot":"","sources":["../../../src/workflow/team/task-board.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzD,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAgC;gBAEjC,WAAW,GAAE,cAAc,EAAO;IAS9C;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAOnC;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAelD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAWjD;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IASjD;;OAEG;IACH,YAAY,IAAI,SAAS,EAAE;IAM3B;;OAEG;IACH,MAAM,IAAI,SAAS,EAAE;IAIrB;;OAEG;IACH,cAAc,IAAI,OAAO;IAKzB;;OAEG;IACH,SAAS,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;CAqBrE"}

package/dist/workflow/team/task-board.js

@@ -0,0 +1,111 @@
+/**
+ * @fileoverview Task board with dependency DAG for team coordination.
+ * Provides atomic task claiming and dependency gating.
+ */
+export class TaskBoard {
+    tasks = new Map();
+    constructor(definitions = []) {
+        for (const task of definitions) {
+            this.tasks.set(task.id, {
+                task,
+                status: 'pending',
+            });
+        }
+    }
+    /**
+     * Add a task to the board.
+     */
+    addTask(task) {
+        if (this.tasks.has(task.id)) {
+            throw new Error(`Task "${task.id}" already exists on the board.`);
+        }
+        this.tasks.set(task.id, { task, status: 'pending' });
+    }
+    /**
+     * Attempt to claim a task (atomic — no double-claim).
+     * Returns true if claimed successfully, false otherwise.
+     */
+    claim(taskId, memberName) {
+        const entry = this.tasks.get(taskId);
+        if (!entry)
+            return false;
+        if (entry.status !== 'pending')
+            return false;
+        // Check dependency gating
+        if (!this.areDependenciesMet(entry.task))
+            return false;
+        // Atomic claim
+        entry.status = 'claimed';
+        entry.claimedBy = memberName;
+        entry.claimedAt = Date.now();
+        return true;
+    }
+    /**
+     * Complete a claimed task with a result.
+     */
+    complete(taskId, result) {
+        const entry = this.tasks.get(taskId);
+        if (!entry)
+            return false;
+        if (entry.status !== 'claimed')
+            return false;
+        entry.status = 'completed';
+        entry.result = result;
+        entry.completedAt = Date.now();
+        return true;
+    }
+    /**
+     * Check if all dependencies for a task are completed.
+     */
+    areDependenciesMet(task) {
+        if (!task.dependsOn || task.dependsOn.length === 0)
+            return true;
+        return task.dependsOn.every((depId) => {
+            const dep = this.tasks.get(depId);
+            return dep?.status === 'completed';
+        });
+    }
+    /**
+     * Get all available (claimable) tasks.
+     */
+    getAvailable() {
+        return this.getAll().filter((entry) => entry.status === 'pending' && this.areDependenciesMet(entry.task));
+    }
+    /**
+     * Get all tasks.
+     */
+    getAll() {
+        return Array.from(this.tasks.values());
+    }
+    /**
+     * Check if all tasks are completed.
+     */
+    isAllCompleted() {
+        if (this.tasks.size === 0)
+            return true;
+        return Array.from(this.tasks.values()).every((t) => t.status === 'completed');
+    }
+    /**
+     * Get task count by status.
+     */
+    getCounts() {
+        let pending = 0;
+        let claimed = 0;
+        let completed = 0;
+        for (const entry of this.tasks.values()) {
+            switch (entry.status) {
+                case 'pending':
+                    pending++;
+                    break;
+                case 'claimed':
+                    claimed++;
+                    break;
+                case 'completed':
+                    completed++;
+                    break;
+            }
+        }
+        return { pending, claimed, completed };
+    }
+}
+//# sourceMappingURL=task-board.js.map

package/dist/workflow/team/task-board.js.map

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

package/dist/workflow/team/tools.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview AI SDK tools for team coordination.
+ *
+ * 6 tools: team_message, team_broadcast, team_tasks, team_claim,
+ * team_complete, team_status.
+ */
+import type { Team } from './types.js';
+/**
+ * Create all 6 team coordination tools.
+ * These are injected into each team member agent's tool set.
+ */
+export declare function createTeamTools(team: Team, memberName: string): {
+    team_message: import("ai").Tool<{
+        content: string;
+        to: string;
+    }, {
+        sent: boolean;
+        to: string;
+        content: string;
+    }>;
+    team_broadcast: import("ai").Tool<{
+        content: string;
+    }, {
+        broadcasted: boolean;
+        content: string;
+    }>;
+    team_tasks: import("ai").Tool<{}, {
+        total: number;
+        tasks: {
+            id: string;
+            description: string;
+            status: "completed" | "pending" | "claimed";
+            claimedBy: string | undefined;
+            dependsOn: string[] | undefined;
+        }[];
+    }>;
+    team_claim: import("ai").Tool<{
+        taskId: string;
+    }, {
+        claimed: boolean;
+        taskId: string;
+        memberName: string;
+    }>;
+    team_complete: import("ai").Tool<{
+        result: string;
+        taskId: string;
+    }, {
+        completed: boolean;
+        taskId: string;
+    }>;
+    team_status: import("ai").Tool<{}, {
+        phase: import("./types").TeamPhase;
+        members: {
+            name: string;
+            phase: import("./types").TeammatePhase;
+        }[];
+        taskCounts: {
+            total: number;
+            pending: number;
+            claimed: number;
+            completed: number;
+        };
+        recentMessages: import("./types").TeamMessage[];
+    }>;
+};
+//# sourceMappingURL=tools.d.ts.map

package/dist/workflow/team/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/workflow/team/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiG7D"}

package/dist/workflow/team/tools.js

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview AI SDK tools for team coordination.
+ *
+ * 6 tools: team_message, team_broadcast, team_tasks, team_claim,
+ * team_complete, team_status.
+ */
+import { z } from 'zod';
+import { tool } from 'ai';
+/**
+ * Create all 6 team coordination tools.
+ * These are injected into each team member agent's tool set.
+ */
+export function createTeamTools(team, memberName) {
+    return {
+        team_message: tool({
+            description: 'Send a direct message to a specific team member. ' +
+                'Use this to coordinate, share findings, or request help.',
+            inputSchema: z.object({
+                to: z.string().describe('Name of the team member to message.'),
+                content: z.string().describe('Message content to send.'),
+            }),
+            execute: async ({ to, content }) => {
+                team.sendMessage(memberName, to, content);
+                return { sent: true, to, content: content.slice(0, 100) };
+            },
+        }),
+        team_broadcast: tool({
+            description: 'Broadcast a message to all team members. ' +
+                'Use this for announcements, status updates, or sharing results.',
+            inputSchema: z.object({
+                content: z.string().describe('Message to broadcast to all team members.'),
+            }),
+            execute: async ({ content }) => {
+                team.broadcast(memberName, content);
+                return { broadcasted: true, content: content.slice(0, 100) };
+            },
+        }),
+        team_tasks: tool({
+            description: 'View the current task board. Shows all tasks with their status, ' +
+                'who claimed them, and which are available to claim.',
+            inputSchema: z.object({}),
+            execute: async () => {
+                const tasks = team.getTaskBoard();
+                return {
+                    total: tasks.length,
+                    tasks: tasks.map((t) => ({
+                        id: t.task.id,
+                        description: t.task.description,
+                        status: t.status,
+                        claimedBy: t.claimedBy,
+                        dependsOn: t.task.dependsOn,
+                    })),
+                };
+            },
+        }),
+        team_claim: tool({
+            description: 'Claim a task from the task board. The task must be pending and have ' +
+                'all dependencies satisfied. Only one member can claim a task (atomic).',
+            inputSchema: z.object({
+                taskId: z.string().describe('The ID of the task to claim.'),
+            }),
+            execute: async ({ taskId }) => {
+                const success = team.claimTask(taskId, memberName);
+                return { claimed: success, taskId, memberName };
+            },
+        }),
+        team_complete: tool({
+            description: 'Mark a previously claimed task as completed with a result. ' +
+                'Call this after you have finished the task.',
+            inputSchema: z.object({
+                taskId: z.string().describe('The ID of the task to complete.'),
+                result: z.string().describe('The result/output of the completed task.'),
+            }),
+            execute: async ({ taskId, result }) => {
+                const success = team.completeTask(taskId, result);
+                return { completed: success, taskId };
+            },
+        }),
+        team_status: tool({
+            description: 'Get the current status of the team: phase, member states, ' +
+                'task progress, and recent messages.',
+            inputSchema: z.object({}),
+            execute: async () => {
+                const snapshot = team.getPersistedSnapshot();
+                return {
+                    phase: snapshot.phase,
+                    members: snapshot.members,
+                    taskCounts: {
+                        total: snapshot.tasks.length,
+                        pending: snapshot.tasks.filter((t) => t.status === 'pending').length,
+                        claimed: snapshot.tasks.filter((t) => t.status === 'claimed').length,
+                        completed: snapshot.tasks.filter((t) => t.status === 'completed').length,
+                    },
+                    recentMessages: snapshot.messages.slice(-5),
+                };
+            },
+        }),
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/workflow/team/tools.js.map

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

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

@@ -0,0 +1,109 @@
+/**
+ * @fileoverview Types for the Team coordination system.
+ */
+import type { Agent } from '../../agent.js';
+import type { WorkflowStep } from '../builders/types.js';
+/** Configuration for creating a team. */
+export interface TeamConfig {
+    /** Team name. */
+    name: string;
+    /** The lead agent that coordinates the team. */
+    lead: TeamMemberConfig;
+    /** Team member configurations. */
+    members: TeamMemberConfig[];
+    /** Initial tasks for the task board. */
+    tasks?: TaskDefinition[];
+    /** Function to synthesize the final result from all completed outputs. */
+    synthesize?: (outputs: TeamOutput[]) => string | Promise<string>;
+}
+/** Configuration for a team member (lead or member). */
+export interface TeamMemberConfig {
+    /** Unique name for this team member. */
+    name: string;
+    /** The agent instance or factory. */
+    agent: Agent;
+    /** Role description for this member. */
+    role?: string;
+}
+/** A task definition on the team task board. */
+export interface TaskDefinition {
+    /** Unique task ID. */
+    id: string;
+    /** Task description. */
+    description: string;
+    /** Task IDs that must be completed before this task can be claimed. */
+    dependsOn?: string[];
+}
+/** Runtime state of a task on the board. */
+export interface TaskState {
+    /** Task definition. */
+    task: TaskDefinition;
+    /** Current status. */
+    status: 'pending' | 'claimed' | 'completed';
+    /** Name of the member who claimed this task. */
+    claimedBy?: string;
+    /** Result produced by the member. */
+    result?: string;
+    /** When the task was claimed. */
+    claimedAt?: number;
+    /** When the task was completed. */
+    completedAt?: number;
+}
+/** A message between team members. */
+export interface TeamMessage {
+    /** Sender name. */
+    from: string;
+    /** Recipient name (or 'all' for broadcast). */
+    to: string;
+    /** Message content. */
+    content: string;
+    /** When the message was sent. */
+    timestamp: number;
+}
+/** Output from a team member's work. */
+export interface TeamOutput {
+    /** Member name. */
+    memberName: string;
+    /** Task ID (if task-based). */
+    taskId?: string;
+    /** The output text. */
+    text: string;
+}
+export type TeamPhase = 'planning' | 'executing' | 'synthesizing' | 'completed' | 'error';
+export type TeammatePhase = 'idle' | 'working' | 'completed' | 'error';
+/** A Team that satisfies the Workflow interface. */
+export interface Team extends WorkflowStep {
+    /** Team name. */
+    name: string;
+    /** Number of members (including lead). */
+    memberCount: number;
+    /** Get the current task board state. */
+    getTaskBoard(): TaskState[];
+    /** Get all messages exchanged. */
+    getMessages(): TeamMessage[];
+    /** Get the team's current phase. */
+    getPhase(): TeamPhase;
+    /** Send a direct message between members. */
+    sendMessage(from: string, to: string, content: string): void;
+    /** Broadcast a message to all members. */
+    broadcast(from: string, content: string): void;
+    /** Claim a task from the board. */
+    claimTask(taskId: string, memberName: string): boolean;
+    /** Complete a task with a result. */
+    completeTask(taskId: string, result: string): boolean;
+    /** Get a serializable snapshot of the team state. */
+    getPersistedSnapshot(): TeamSnapshot;
+}
+/** Serializable team state snapshot. */
+export interface TeamSnapshot {
+    name: string;
+    phase: TeamPhase;
+    members: Array<{
+        name: string;
+        phase: TeammatePhase;
+    }>;
+    tasks: TaskState[];
+    messages: TeamMessage[];
+    outputs: TeamOutput[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/workflow/team/types.js

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Types for the Team coordination system.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

package/dist/workflow/templates.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @agntk/core - Standalone Workflow Templates
+ *
+ * Composable workflow templates (withApproval, withSchedule) that work
+ * with any Agent instance. No special DurableAgent required.
+ */
+import type { Agent } from '../agent.js';
+/** Result from a workflow template execution. */
+export interface WorkflowTemplateResult {
+    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 ApprovalResponse {
+    approved: boolean;
+    feedback?: string;
+    modifiedContent?: string;
+}
+/** Options for the withApproval template. */
+export interface WithApprovalOptions {
+    /** The webhook path where approval will be posted. */
+    webhookPath: string;
+}
+/** Options for the withSchedule template. */
+export interface WithScheduleOptions {
+    /** Delay before execution. Format: "30s", "5m", "1h", "1d". */
+    delay: string;
+}
+/**
+ * Run an agent with a human-in-the-loop approval workflow.
+ *
+ * 1. Agent generates a draft response
+ * 2. Execution pauses waiting for webhook approval (zero compute)
+ * 3. If approved, finalizes; if rejected, throws with feedback
+ *
+ * Requires the workflow package when running under the Workflow runtime.
+ * Falls back to auto-approve when the runtime is not available.
+ *
+ * @example
+ * ```typescript
+ * const result = await withApproval(agent, 'Draft a press release', {
+ *   webhookPath: '/api/approve',
+ * });
+ * ```
+ */
+export declare function withApproval(agent: Agent, prompt: string, options: WithApprovalOptions): Promise<WorkflowTemplateResult>;
+/**
+ * Schedule an agent execution after a delay.
+ *
+ * Under the Workflow runtime, uses durable sleep (zero compute during delay).
+ * Without the runtime, falls back to setTimeout.
+ *
+ * @example
+ * ```typescript
+ * const result = await withSchedule(agent, 'Send reminder email', {
+ *   delay: '1h',
+ * });
+ * ```
+ */
+export declare function withSchedule(agent: Agent, prompt: string, options: WithScheduleOptions): Promise<WorkflowTemplateResult>;
+//# sourceMappingURL=templates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/workflow/templates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAStC,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,KAAK,CAAC;QACX,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,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;CACf;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CAoDjC;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CA0CjC"}