@agntk/core 0.3.5 → 1.1.0

package/dist/usage-limits.d.ts

@@ -1,45 +1,17 @@
-/**
- * @agntk/core - Usage Limits
- *
- * Token and request caps for agents. Prevents runaway loops from
- * burning API budget by enforcing maxRequests, maxInputTokens,
- * maxOutputTokens, and maxTotalTokens.
- */
 import type { ToolSet, StepResult } from 'ai';
-/** Usage limits for an agent run. All fields are optional — only set limits are enforced. */
 export interface UsageLimits {
-    /** Maximum number of LLM round-trips (steps). */
     maxRequests?: number;
-    /** Maximum cumulative input tokens across all steps. */
     maxInputTokens?: number;
-    /** Maximum cumulative output tokens across all steps. */
     maxOutputTokens?: number;
-    /** Maximum cumulative total tokens (input + output) across all steps. */
     maxTotalTokens?: number;
 }
-/** Which limit was exceeded. */
 export type UsageLimitType = 'maxRequests' | 'maxInputTokens' | 'maxOutputTokens' | 'maxTotalTokens';
-/** Current usage snapshot at the time a limit was exceeded. */
 export interface UsageSnapshot {
     requests: number;
     inputTokens: number;
     outputTokens: number;
     totalTokens: number;
 }
-/**
- * Thrown when an agent exceeds a configured usage limit.
- *
- * @example
- * ```typescript
- * try {
- *   const result = await agent.stream({ prompt: 'do something' });
- * } catch (error) {
- *   if (error instanceof UsageLimitExceeded) {
- *     console.log(`Hit ${error.limitType}: ${error.currentValue}/${error.limitValue}`);
- *   }
- * }
- * ```
- */
 export declare class UsageLimitExceeded extends Error {
     readonly name = "UsageLimitExceeded";
     readonly limitType: UsageLimitType;
@@ -48,15 +20,6 @@ export declare class UsageLimitExceeded extends Error {
     readonly usage: UsageSnapshot;
     constructor(limitType: UsageLimitType, limitValue: number, currentValue: number, usage: UsageSnapshot);
 }
-/**
- * Create a StopCondition that checks usage limits after each step.
- *
- * Compatible with AI SDK's `stopWhen` array — combine with `stepCountIs()`.
- *
- * When a limit is exceeded, the condition throws `UsageLimitExceeded`
- * rather than returning `true`, because returning `true` would silently
- * stop the agent. Throwing gives the caller a clear signal with details.
- */
 export declare function usageLimitStop<TOOLS extends ToolSet>(limits: UsageLimits): (options: {
     steps: Array<StepResult<TOOLS>>;
 }) => boolean;

package/dist/usage-limits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage-limits.d.ts","sourceRoot":"","sources":["../src/usage-limits.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAM9C,6FAA6F;AAC7F,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gCAAgC;AAChC,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAErG,+DAA+D;AAC/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAkB,IAAI,wBAAwB;IAC9C,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;gBAG5B,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,aAAa;CAUvB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAS,OAAO,EAClD,MAAM,EAAE,WAAW,GAClB,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;CAAE,KAAK,OAAO,CAsB3D"}
+{"version":3,"file":"usage-limits.d.ts","sourceRoot":"","sources":["../src/usage-limits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,gBAAgB,GAChB,iBAAiB,GACjB,gBAAgB,CAAC;AAErB,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAkB,IAAI,wBAAwB;IAC9C,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;gBAG5B,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,aAAa;CAQvB;AAED,wBAAgB,cAAc,CAAC,KAAK,SAAS,OAAO,EAClD,MAAM,EAAE,WAAW,GAClB,CAAC,OAAO,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;CAAE,KAAK,OAAO,CAqC3D"}

package/dist/usage-limits.js

@@ -1,27 +1,3 @@
-/**
- * @agntk/core - Usage Limits
- *
- * Token and request caps for agents. Prevents runaway loops from
- * burning API budget by enforcing maxRequests, maxInputTokens,
- * maxOutputTokens, and maxTotalTokens.
- */
-// ============================================================================
-// Error
-// ============================================================================
-/**
- * Thrown when an agent exceeds a configured usage limit.
- *
- * @example
- * ```typescript
- * try {
- *   const result = await agent.stream({ prompt: 'do something' });
- * } catch (error) {
- *   if (error instanceof UsageLimitExceeded) {
- *     console.log(`Hit ${error.limitType}: ${error.currentValue}/${error.limitValue}`);
- *   }
- * }
- * ```
- */
 export class UsageLimitExceeded extends Error {
     name = 'UsageLimitExceeded';
     limitType;
@@ -36,18 +12,6 @@ export class UsageLimitExceeded extends Error {
         this.usage = usage;
     }
 }
-// ============================================================================
-// Stop Condition Factory
-// ============================================================================
-/**
- * Create a StopCondition that checks usage limits after each step.
- *
- * Compatible with AI SDK's `stopWhen` array — combine with `stepCountIs()`.
- *
- * When a limit is exceeded, the condition throws `UsageLimitExceeded`
- * rather than returning `true`, because returning `true` would silently
- * stop the agent. Throwing gives the caller a clear signal with details.
- */
 export function usageLimitStop(limits) {
     return ({ steps }) => {
         const usage = computeUsage(steps);
@@ -63,12 +27,9 @@ export function usageLimitStop(limits) {
         if (limits.maxTotalTokens !== undefined && usage.totalTokens > limits.maxTotalTokens) {
             throw new UsageLimitExceeded('maxTotalTokens', limits.maxTotalTokens, usage.totalTokens, usage);
         }
-        return false; // Don't stop — limits not reached
+        return false;
     };
 }
-// ============================================================================
-// Helpers
-// ============================================================================
 function computeUsage(steps) {
     let inputTokens = 0;
     let outputTokens = 0;

package/dist/usage-limits.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage-limits.js","sourceRoot":"","sources":["../src/usage-limits.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+BH,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACzB,IAAI,GAAG,oBAAoB,CAAC;IACrC,SAAS,CAAiB;IAC1B,UAAU,CAAS;IACnB,YAAY,CAAS;IACrB,KAAK,CAAgB;IAE9B,YACE,SAAyB,EACzB,UAAkB,EAClB,YAAoB,EACpB,KAAoB;QAEpB,KAAK,CACH,yBAAyB,SAAS,MAAM,YAAY,YAAY,UAAU,GAAG,CAC9E,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAmB;IAEnB,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QACnB,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAElC,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5E,MAAM,IAAI,kBAAkB,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACzF,CAAC;QAED,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;YACrF,MAAM,IAAI,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAClG,CAAC;QAED,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;YACxF,MAAM,IAAI,kBAAkB,CAAC,iBAAiB,EAAE,MAAM,CAAC,eAAe,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QACrG,CAAC;QAED,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;YACrF,MAAM,IAAI,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAClG,CAAC;QAED,OAAO,KAAK,CAAC,CAAC,kCAAkC;IAClD,CAAC,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,SAAS,YAAY,CAAwB,KAA+B;IAC1E,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,WAAW,IAAI,IAAI,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC;QAC5C,YAAY,IAAI,IAAI,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC;QAC9C,WAAW,IAAI,IAAI,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,MAAM;QACtB,WAAW;QACX,YAAY;QACZ,WAAW;KACZ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"usage-limits.js","sourceRoot":"","sources":["../src/usage-limits.ts"],"names":[],"mappings":"AAyBA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACzB,IAAI,GAAG,oBAAoB,CAAC;IACrC,SAAS,CAAiB;IAC1B,UAAU,CAAS;IACnB,YAAY,CAAS;IACrB,KAAK,CAAgB;IAE9B,YACE,SAAyB,EACzB,UAAkB,EAClB,YAAoB,EACpB,KAAoB;QAEpB,KAAK,CAAC,yBAAyB,SAAS,MAAM,YAAY,YAAY,UAAU,GAAG,CAAC,CAAC;QACrF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAC5B,MAAmB;IAEnB,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QACnB,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAElC,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5E,MAAM,IAAI,kBAAkB,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACzF,CAAC;QAED,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;YACrF,MAAM,IAAI,kBAAkB,CAC1B,gBAAgB,EAChB,MAAM,CAAC,cAAc,EACrB,KAAK,CAAC,WAAW,EACjB,KAAK,CACN,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;YACxF,MAAM,IAAI,kBAAkB,CAC1B,iBAAiB,EACjB,MAAM,CAAC,eAAe,EACtB,KAAK,CAAC,YAAY,EAClB,KAAK,CACN,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;YACrF,MAAM,IAAI,kBAAkB,CAC1B,gBAAgB,EAChB,MAAM,CAAC,cAAc,EACrB,KAAK,CAAC,WAAW,EACjB,KAAK,CACN,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAwB,KAA+B;IAC1E,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,WAAW,IAAI,IAAI,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC;QAC5C,YAAY,IAAI,IAAI,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC;QAC9C,WAAW,IAAI,IAAI,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,MAAM;QACtB,WAAW;QACX,YAAY;QACZ,WAAW;KACZ,CAAC;AACJ,CAAC"}

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