@funkai/agents 0.1.0

package/.generated/req.txt

@@ -0,0 +1 @@
+2026-03-03T19:12:46.284Z

package/.turbo/turbo-build.log

@@ -0,0 +1,21 @@
+
+
+> @funkai/agents@0.1.0 build /Users/zacrosenbauer/Code/joggr/funkai/packages/agents
+> tsdown
+
+ℹ tsdown v0.21.2 powered by rolldown v1.0.0-rc.9
+ℹ config file: /Users/zacrosenbauer/Code/joggr/funkai/packages/agents/tsdown.config.ts 
+ℹ entry: src/index.ts
+ℹ target: node22
+ℹ tsconfig: tsconfig.json
+
+ WARN  `external` is deprecated. Use `deps.neverBundle` instead.
+
+ℹ Build start
+ℹ Cleaning 4 files
+ℹ dist/index.mjs         66.70 kB │ gzip: 16.43 kB
+ℹ dist/index.mjs.map    154.48 kB │ gzip: 35.44 kB
+ℹ dist/index.d.mts.map   17.15 kB │ gzip:  4.77 kB
+ℹ dist/index.d.mts       92.50 kB │ gzip: 21.21 kB
+ℹ 4 files, total: 330.82 kB
+✔ Build complete in 546ms

package/.turbo/turbo-test$colon$coverage.log

@@ -0,0 +1,109 @@
+
+> @funkai/agents@0.4.0 test:coverage /Users/zacrosenbauer/Code/joggr/funkai/packages/agents
+> vitest run --coverage
+
+
+ RUN  v4.1.0 /Users/zacrosenbauer/Code/joggr/funkai/packages/agents
+      Coverage enabled with v8
+
+ ✓ src/lib/trace.test.ts (19 tests) 4ms
+ ✓ src/utils/zod.test.ts (11 tests) 5ms
+ ✓ src/core/agents/flow/steps/race.test.ts (13 tests) 7ms
+ ✓ src/core/agents/flow/steps/reduce.test.ts (14 tests) 10ms
+ ✓ src/core/agents/flow/steps/agent.test.ts (14 tests) 13ms
+ ✓ src/core/agents/flow/steps/step.test.ts (19 tests) 14ms
+ ✓ src/core/agents/flow/steps/while.test.ts (14 tests) 14ms
+ ✓ src/lib/middleware.test.ts (5 tests) 10ms
+ ✓ src/core/agents/flow/steps/all.test.ts (14 tests) 38ms
+stdout | src/core/agents/flow/flow-agent.test.ts > edge cases > uses default logger when none provided
+{ flowAgentId: 'no-logger-flow', name: 'no-logger-flow' } flowAgent.generate start
+
+stdout | src/core/agents/flow/flow-agent.test.ts > edge cases > uses default logger when none provided
+{ flowAgentId: 'no-logger-flow', name: 'no-logger-flow', duration: 1 } flowAgent.generate finish
+
+ ✓ src/core/agents/flow/engine.test.ts (14 tests) 8ms
+ ✓ src/core/agents/base/output.test.ts (9 tests) 46ms
+ ✓ src/core/agents/flow/flow-agent.test.ts (47 tests) 22ms
+ ✓ src/core/agents/flow/steps/map.test.ts (13 tests) 74ms
+ ✓ src/core/agents/flow/steps/factory.test.ts (35 tests) 72ms
+ ✓ src/lib/hooks.test.ts (7 tests) 6ms
+ ✓ src/core/logger.test.ts (14 tests) 4ms
+stdout | src/core/agents/base/agent.test.ts > edge cases > uses default logger when none provided
+{ agentId: 'no-logger-agent', name: 'no-logger-agent' } agent.generate start
+
+stdout | src/core/agents/base/agent.test.ts > edge cases > uses default logger when none provided
+{ agentId: 'no-logger-agent', name: 'no-logger-agent', duration: 1 } agent.generate finish
+
+ ✓ src/lib/context.test.ts (10 tests) 5ms
+ ✓ src/core/agents/base/agent.test.ts (69 tests) 95ms
+ ✓ src/core/agents/flow/steps/each.test.ts (13 tests) 6ms
+ ✓ src/core/provider/provider.test.ts (9 tests) 5ms
+ ✓ src/core/models/index.test.ts (16 tests) 4ms
+ ✓ src/core/provider/usage.test.ts (17 tests) 4ms
+ ✓ src/core/agents/flow/messages.test.ts (14 tests) 3ms
+ ✓ src/utils/result.test.ts (10 tests) 4ms
+ ✓ src/core/agents/base/utils.test.ts (28 tests) 6ms
+ ✓ src/utils/error.test.ts (32 tests) 3ms
+ ✓ src/utils/attempt.test.ts (12 tests) 3ms
+ ✓ src/lib/runnable.test.ts (5 tests) 2ms
+ ✓ src/utils/resolve.test.ts (6 tests) 3ms
+ ✓ src/core/tool.test.ts (6 tests) 3ms
+
+ Test Files  30 passed (30)
+      Tests  509 passed (509)
+   Start at  20:28:55
+   Duration  627ms (transform 1.16s, setup 0ms, import 2.72s, tests 492ms, environment 1ms)
+
+ % Coverage report from v8
+-------------------|---------|----------|---------|---------|-------------------
+File               | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s 
+-------------------|---------|----------|---------|---------|-------------------
+All files          |   92.68 |    87.01 |    91.2 |   92.58 |                   
+ core              |      88 |    78.57 |     100 |      88 |                   
+  logger.ts        |     100 |      100 |     100 |     100 |                   
+  tool.ts          |   78.57 |       70 |     100 |   78.57 | 152,156,160       
+  types.ts         |       0 |        0 |       0 |       0 |                   
+ core/agents/base  |   89.03 |    88.67 |   79.59 |   89.03 |                   
+  agent.ts         |   85.97 |       80 |   66.66 |   85.97 | ...26-427,470-475 
+  output.ts        |     100 |      100 |     100 |     100 |                   
+  types.ts         |       0 |        0 |       0 |       0 |                   
+  utils.ts         |   96.36 |      100 |      90 |   96.36 | 174,180           
+ core/agents/flow  |    93.7 |    82.81 |   84.37 |   93.66 |                   
+  engine.ts        |   97.14 |    83.33 |     100 |   97.05 | 252               
+  flow-agent.ts    |   94.84 |     82.5 |   85.71 |   94.84 | ...23,346,352-353 
+  messages.ts      |   72.72 |    83.33 |   66.66 |   72.72 | 136-138           
+  types.ts         |       0 |        0 |       0 |       0 |                   
+ ...nts/flow/steps |   91.86 |    79.36 |   92.59 |   91.77 |                   
+  agent.ts         |       0 |        0 |       0 |       0 |                   
+  all.ts           |       0 |        0 |       0 |       0 |                   
+  builder.ts       |       0 |        0 |       0 |       0 |                   
+  each.ts          |       0 |        0 |       0 |       0 |                   
+  factory.ts       |   91.86 |    79.36 |   92.59 |   91.77 | ...29,265-284,613 
+  map.ts           |       0 |        0 |       0 |       0 |                   
+  race.ts          |       0 |        0 |       0 |       0 |                   
+  reduce.ts        |       0 |        0 |       0 |       0 |                   
+  result.ts        |       0 |        0 |       0 |       0 |                   
+  step.ts          |       0 |        0 |       0 |       0 |                   
+  while.ts         |       0 |        0 |       0 |       0 |                   
+ ...dels/providers |     100 |      100 |     100 |     100 |                   
+  openai.ts        |     100 |      100 |     100 |     100 |                   
+ core/provider     |     100 |      100 |     100 |     100 |                   
+  provider.ts      |     100 |      100 |     100 |     100 |                   
+  types.ts         |       0 |        0 |       0 |       0 |                   
+  usage.ts         |     100 |      100 |     100 |     100 |                   
+ lib               |     100 |    94.11 |     100 |     100 |                   
+  context.ts       |       0 |        0 |       0 |       0 |                   
+  hooks.ts         |     100 |      100 |     100 |     100 |                   
+  middleware.ts    |     100 |    88.88 |     100 |     100 | 39                
+  runnable.ts      |     100 |      100 |     100 |     100 |                   
+  trace.ts         |     100 |      100 |     100 |     100 |                   
+ testing           |     100 |      100 |     100 |     100 |                   
+  context.ts       |     100 |      100 |     100 |     100 |                   
+  logger.ts        |     100 |      100 |     100 |     100 |                   
+ utils             |     100 |      100 |     100 |     100 |                   
+  attempt.ts       |     100 |      100 |     100 |     100 |                   
+  error.ts         |     100 |      100 |     100 |     100 |                   
+  resolve.ts       |     100 |      100 |     100 |     100 |                   
+  result.ts        |     100 |      100 |     100 |     100 |                   
+  zod.ts           |     100 |      100 |     100 |     100 |                   
+-------------------|---------|----------|---------|---------|-------------------

package/.turbo/turbo-test.log

@@ -0,0 +1,141 @@
+
+
+> @funkai/agents@0.4.0 test /Users/zacrosenbauer/Code/joggr/funkai/packages/agents
+> vitest run --typecheck
+
+[?25lTesting types with tsc and vue-tsc is an experimental feature.
+Breaking changes might not follow SemVer, please pin Vitest's version when using it.
+
+ RUN  v4.1.0 /Users/zacrosenbauer/Code/joggr/funkai/packages/agents
+
+[?2026h
+ ❯ src/core/agents/base/output.test.ts [queued]
+
+ Test Files 0 passed (32)
+      Tests 0 passed (0)
+   Start at 21:15:41
+   Duration 100ms
+[?2026l[?2026h
+ ❯ src/core/agents/base/agent.test.ts [queued]
+ ❯ src/core/agents/base/output.test.ts 0/9
+ ❯ src/core/agents/base/utils.test.ts [queued]
+ ❯ src/core/agents/flow/engine.test.ts [queued]
+ ❯ src/core/agents/flow/flow-agent.test.ts [queued]
+ ❯ src/core/agents/flow/steps/agent.test.ts [queued]
+ ❯ src/core/agents/flow/steps/all.test.ts [queued]
+ ❯ src/core/agents/flow/steps/each.test.ts [queued]
+ ❯ src/core/agents/flow/steps/factory.test.ts [queued]
+ ❯ src/core/agents/flow/steps/map.test.ts [queued]
+ ❯ src/core/agents/flow/steps/race.test.ts [queued]
+ ❯ src/core/agents/flow/steps/reduce.test.ts [queued]
+ ❯ src/core/agents/flow/steps/step.test.ts [queued]
+ ❯ src/core/agents/flow/steps/while.test.ts [queued]
+ ❯ src/lib/middleware.test.ts [queued]
+
+ Test Files 0 passed (32)
+      Tests 0 passed (9)
+   Start at 21:15:41
+   Duration 203ms
+[?2026l[?2026h ✓ src/lib/middleware.test.ts (6 tests) 9ms
+ ✓ src/core/agents/flow/steps/race.test.ts (13 tests) 6ms
+ ✓ src/core/agents/flow/steps/each.test.ts (13 tests) 5ms
+ ✓ src/core/agents/flow/steps/reduce.test.ts (14 tests) 5ms
+ ✓ src/core/agents/base/utils.test.ts (30 tests) 5ms
+ ✓ src/core/agents/flow/steps/while.test.ts (14 tests) 8ms
+ ✓ src/core/agents/flow/steps/agent.test.ts (14 tests) 7ms
+ ✓ src/core/agents/flow/steps/step.test.ts (19 tests) 13ms
+ ✓ src/core/agents/base/output.test.ts (9 tests) 33ms
+stdout | src/core/agents/flow/engine.test.ts > createFlowEngine > edge cases > falls back to createDefaultLogger when logger is omitted from config
+{ flowAgentId: 'no-logger-flow', name: 'no-logger-flow' } flowAgent.generate start
+
+stdout | src/core/agents/flow/engine.test.ts > createFlowEngine > edge cases > falls back to createDefaultLogger when logger is omitted from config
+{ flowAgentId: 'no-logger-flow', name: 'no-logger-flow', duration: 1 } flowAgent.generate finish
+
+ ✓ src/core/agents/flow/engine.test.ts (17 tests) 10ms
+stdout | src/core/agents/flow/flow-agent.test.ts > edge cases > uses default logger when none provided
+{ flowAgentId: 'no-logger-flow', name: 'no-logger-flow' } flowAgent.generate start
+
+stdout | src/core/agents/flow/flow-agent.test.ts > edge cases > uses default logger when none provided
+{ flowAgentId: 'no-logger-flow', name: 'no-logger-flow', duration: 0 } flowAgent.generate finish
+
+ ✓ src/core/agents/flow/steps/all.test.ts (14 tests) 40ms
+ ✓ src/core/agents/flow/flow-agent.test.ts (52 tests) 19ms
+ ✓ src/core/agents/flow/steps/factory.test.ts (40 tests) 65ms
+ ✓ src/core/agents/flow/steps/map.test.ts (13 tests) 75ms
+
+ ❯ src/core/agents/base/agent.test.ts 0/76
+ ❯ src/core/agents/base/output.test.ts 9/9
+ ❯ src/core/agents/base/utils.test.ts 30/30
+ ❯ src/core/agents/flow/engine.test.ts 17/17
+ ❯ src/core/agents/flow/flow-agent.test.ts 52/52
+ ❯ src/core/agents/flow/steps/agent.test.ts 14/14
+ ❯ src/core/agents/flow/steps/all.test.ts 14/14
+ ❯ src/core/agents/flow/steps/each.test.ts 13/13
+ ❯ src/core/agents/flow/steps/factory.test.ts 40/40
+ ❯ src/core/agents/flow/steps/map.test.ts 13/13
+ ❯ src/core/agents/flow/steps/race.test.ts 13/13
+ ❯ src/core/agents/flow/steps/reduce.test.ts 14/14
+ ❯ src/core/agents/flow/steps/step.test.ts 19/19
+ ❯ src/core/agents/flow/steps/while.test.ts 14/14
+ ❯ src/core/provider/provider.test.ts [queued]
+
+ Test Files 14 passed (32)
+      Tests 268 passed (344)
+   Start at 21:15:41
+   Duration 404ms
+[?2026l[?2026h ✓ src/lib/hooks.test.ts (7 tests) 3ms
+ ✓ src/lib/trace.test.ts (19 tests) 3ms
+ ✓ src/lib/context.test.ts (10 tests) 3ms
+ ✓ src/core/logger.test.ts (14 tests) 4ms
+ ✓ src/core/provider/provider.test.ts (9 tests) 4ms
+ ✓ src/core/models/index.test.ts (16 tests) 4ms
+ ✓ src/utils/zod.test.ts (11 tests) 4ms
+stdout | src/core/agents/base/agent.test.ts > edge cases > uses default logger when none provided
+{ agentId: 'no-logger-agent', name: 'no-logger-agent' } agent.generate start
+
+stdout | src/core/agents/base/agent.test.ts > edge cases > uses default logger when none provided
+{ agentId: 'no-logger-agent', name: 'no-logger-agent', duration: 1 } agent.generate finish
+
+ ✓ src/core/agents/flow/messages.test.ts (18 tests) 3ms
+ ✓ src/utils/error.test.ts (32 tests) 3ms
+ ✓ src/core/provider/usage.test.ts (17 tests) 3ms
+ ✓ src/utils/attempt.test.ts (12 tests) 3ms
+ ✓ src/lib/runnable.test.ts (5 tests) 2ms
+ ✓ src/utils/resolve.test.ts (6 tests) 2ms
+
+
+
+
+ ❯ src/core/agents/base/agent.test.ts 55/76
+ ❯ src/core/tool.test.ts [queued]
+ ❯ src/lib/trace.test.ts 19/19
+ ❯ src/utils/result.test.ts 0/10
+
+ Test Files 27 passed (32)
+      Tests 499 passed (530)
+   Start at 21:15:41
+   Duration 504ms
+[?2026l[?2026h ✓ src/utils/result.test.ts (10 tests) 2ms
+ ✓ src/core/tool.test.ts (6 tests) 2ms
+ ✓ src/core/agents/base/agent.test.ts (76 tests) 225ms
+
+
+
+
+ ❯  TS  src/core/agents/base/types.test-d.ts 0/13
+ ❯  TS  src/core/agents/flow/steps/factory.test-d.ts 0/8
+
+ Test Files 30 passed (32)
+      Tests 536 passed (557)
+   Start at 21:15:41
+   Duration 908ms
+[?2026l ✓  TS  src/core/agents/base/types.test-d.ts (13 tests)
+ ✓  TS  src/core/agents/flow/steps/factory.test-d.ts (8 tests)
+
+ Test Files  32 passed (32)
+      Tests  557 passed (557)
+Type Errors  no errors
+   Start at  21:15:41
+   Duration  1.05s (transform 1.34s, setup 0ms, import 2.93s, tests 573ms, environment 2ms, typecheck 481ms)
+
+[?25h

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+
+> @funkai/agents@0.1.0 typecheck /Users/zacrosenbauer/Code/joggr/funkai/packages/agents
+> tsc --noEmit
+

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# @funkai/agents
+
+## 0.1.0
+
+### Minor Changes
+
+- Initial release of `@funkai/agents` — lightweight workflow and agent orchestration framework built on the Vercel AI SDK.
+
+  - `agent()` — Create AI agents with typed input/output, system prompts, and tool integration
+  - `tool()` — Define function-calling tools with Zod-validated schemas
+  - `workflow()` — Build multi-step workflows with typed I/O and tracked steps via the `$` step builder
+  - `createWorkflowEngine()` — Create workflow factories with shared configuration and custom step types
+  - `openrouter()` / `createOpenRouter()` — OpenRouter provider integration
+  - Result-based error handling — all public methods return `Result<T>` discriminated unions
+  - Streaming support for both agents and workflows
+  - Step builder (`$`) with `step`, `agent`, `map`, `each`, `reduce`, `while`, `all`, and `race` operations