Add @theseus.run/core — Tool primitive

[romanonthego]

Summary

• Adds @theseus.run/core package (v0.1.0) with the Tool primitive — the typed boundary between AI reasoning and the world
• All-Effect pipeline: decode → execute → retry → validate → encode
• Schema-agnostic via SchemaAdapter with fromZod and fromEffectSchema adapters
• 4 tagged error types (ToolError, ToolErrorRetriable, ToolErrorInput, ToolErrorOutput)
• Safety levels (readonly/write/destructive) and capability-based filtering helpers
• 65 tests across 4 test files, full typecheck, CI matrix entry added

Exports

import { defineTool, type Tool } from "@theseus.run/core/Tool"
import { callTool } from "@theseus.run/core/Tool/run"
import { fromZod } from "@theseus.run/core/Tool/zod"
import { fromEffectSchema } from "@theseus.run/core/Tool/effect-schema"

Dependencies

• effect 4.0.0-beta.33 (direct)
• zod 4.3.6 (direct)

Test plan

• bun test packages/theseus-core/ — 65 pass, 0 fail
• tsc --noEmit — clean typecheck
• bun run build — 5KB dist (effect/zod external)
• CI matrix runs on PR

🤖 Generated with Claude Code