callee

module
v0.22.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 23, 2026 License: MIT

README

Callee

Test Lint Security Latest release npm version

Put repeatable agent work in the repository

Useful agent workflows quickly outgrow a chat prompt. They need several roles, local checks, approval points, routing, bounded iteration, and shared context. When that logic lives in one conversation, it is difficult to review, reproduce, or improve as a team.

Callee turns that logic into versioned Markdown or YAML resources. Compose AI roles, shell scripts, human decisions, and typed model judgments with sequential, parallel, loop, and router control flow. Callee validates the whole graph before execution, carries one explicit state object through the run, and returns one final artifact.

  • Review the workflow like code. Prompts, models, permissions, inputs, and control flow live beside the project that uses them.
  • Use the right kind of step. A workflow can call a coding model, run a deterministic check, ask a person, or request a typed decision from TypeSafe or OpenRouter.
  • Run it anywhere. Invoke the same resource from a terminal or through Codex, Claude Code, Grok Build, Copilot CLI, OpenCode, or Cursor.

Supported agent kinds

All ten public callee.metalagman.dev/v1alpha1 kinds fit into three groups. See Choose an agent kind for the complete chooser.

  • Leaves: Role gives a coding agent a task with static provider configuration; DynamicRole renders provider configuration from visit-time state; Script runs a deterministic local shell step; Human pauses for one operator response.
  • Typed evaluators: TypeSafeJev is the native TypeSafe System One/Jev evaluator; OpenRouterDecision uses the OpenRouter Decisions API with a selected model and is not Jev-only.
  • Composite workflows: Sequential orders children; Parallel fans out and joins unattended work; Loop repeats children within a bound; Router deterministically selects one branch.

A workflow is a small, inspectable graph

This workflow runs several reviewers concurrently, then gives their combined output to an architect:

apiVersion: callee.metalagman.dev/v1alpha1
kind: Sequential
spec:
  description: Collects independent reviews, then produces one plan.
  body: "{{ .Input }}"
  children:
    - ref: workflows/parallel-review
      alias: reviews
    - ref: roles/architect
      alias: architect
      input: |
        Task:
        {{ .Input }}

        Reviews:
        {{ .State.outputs.reviews }}
  output: "{{ .State.outputs.architect }}"

References resolve before the run starts. Each Role or DynamicRole visit gets a fresh model session; Scripts run local commands; Human nodes collect an operator response; typed evaluation nodes call their own HTTP APIs. Composite nodes only control data flow and execution order, so a child can be any resource kind.

Try it

Install six editable starter resources and the integration for your coding agent:

npx --yes @baldaworks/callee@latest setup codex

Replace codex with claude, grok, copilot, opencode, or cursor as needed. Then inspect and run a workflow directly:

npx --yes @baldaworks/callee@latest agent view workflows/investigate
npx --yes @baldaworks/callee@latest agent run workflows/investigate \
  --message "Explain this project's architecture and main entry points"

Or ask your coding agent to run it. In Codex:

$callee Run workflows/investigate to explain this project's architecture and main entry points.

Provider executables and credentials are separate runtime prerequisites for Roles and DynamicRoles. Scripts and Human nodes need no model provider; TypeSafeJev and OpenRouterDecision use their respective HTTP APIs. See the Quickstart for the complete first run and Installation for CLI-only and other coding-agent setup options.

Explore

License and notices

Callee is released under the MIT License. See Third-party notices for embedded and statically linked dependencies.

Directories

Path Synopsis
cmd
callee command
internal
agent
Package agent defines Callee's versioned Markdown and YAML agents.
Package agent defines Callee's versioned Markdown and YAML agents.
cli
Package cli implements the Callee command-line surface.
Package cli implements the Callee command-line surface.
doctor
Package doctor validates agent graphs and provider runtimes.
Package doctor validates agent graphs and provider runtimes.
evaluation
Package evaluation implements typed remote evaluations independently of workflow and ACP.
Package evaluation implements typed remote evaluations independently of workflow and ACP.
logging
Package logging configures Callee's zerolog and slog loggers.
Package logging configures Callee's zerolog and slog loggers.
registry
Package registry discovers and resolves versioned Callee agent resources.
Package registry discovers and resolves versioned Callee agent resources.
runtime
Package runtime adapts Callee agents to Norma Runtime ACP processes.
Package runtime adapts Callee agents to Norma Runtime ACP processes.
workflow
Package workflow executes resolved Callee agent trees.
Package workflow executes resolved Callee agent trees.
plugins
callee
Package callee contains contract tests for the distributable Callee plugin.
Package callee contains contract tests for the distributable Callee plugin.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL