Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 9 additions & 16 deletions agents/artist/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,25 +3,18 @@
## What this is

Ready `@corbits/code-agent-artist` agent + independently importable components:
`agent`, `defineAgent`, `director`, `tools`, `systemPrompt`, `config`.

## Consume (runLocal)

```ts
import { agent } from "@corbits/code-agent-artist";
const run = runLocal(defining(agent), env);
```

## Consume (deploy runWorkflow / hub / sidecar)

Hand the same `AgentDefinition` to a workflow — the package never exports a
workflow itself.
`director`, `tools`, `systemPrompt`, `config`.

## Remix components

```ts
import { director, tools, systemPrompt, config } from "@corbits/code-agent-artist";
defineAgent({ director, ... }); // or swap tools / systemPrompt / config
import {
director,
tools,
systemPrompt,
config,
} from "@corbits/code-agent-artist";
// or swap tools / systemPrompt / config
```

Each of `director`, `tools`, `systemPrompt`, and `config` is a named,
Expand All @@ -30,6 +23,6 @@ independently importable part.
## Single authority

`prompt.ts` `systemPrompt.build()` is byte-stable (the raw card, no formatting).
`toolset.ts` `tools` literal equals the `REVIEW_TOOLS` surface constant in
`toolset.ts` `tools` re-exports the `REVIEW_TOOLS` surface constant in
`src/agent/directors/tool-sets.ts`; drift is enforced by the in-tree drift-guard
`src/agent/directors/artist/package.test.ts`.
17 changes: 0 additions & 17 deletions agents/artist/src/agent.ts

This file was deleted.

1 change: 0 additions & 1 deletion agents/artist/src/index.ts
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@
export { agent, defineAgent } from "./agent.js";
export { director } from "./director.js";
export { tools } from "./toolset.js";
export { systemPrompt } from "./prompt.js";
Expand Down
18 changes: 3 additions & 15 deletions agents/artist/src/toolset.ts
Original file line number Diff line number Diff line change
@@ -1,15 +1,3 @@
export const tools: readonly string[] = [
"read_file",
"grep",
"search_files",
"list_dir",
"lsp",
"run_shell",
"web_fetch",
"web_search",
"skill_search",
"use_skill",
"write_file",
"edit_file",
"delete_file",
] as const;
import { REVIEW_TOOLS } from "../../../src/agent/directors/tool-sets.js";

export const tools = REVIEW_TOOLS;
27 changes: 10 additions & 17 deletions agents/coder/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,35 +3,28 @@
## What this is

Ready `@corbits/code-agent-coder` agent + independently importable components:
`agent`, `defineAgent`, `director`, `tools`, `systemPrompt`, `config`. Coder is
`director`, `tools`, `systemPrompt`, `config`. Coder is
the implementation specialist: minimal safe diffs, root-cause fixes at the proper
layer, zero unnecessary abstractions, tests landed with changes, repo check gate.

## Consume (runLocal)

```ts
import { agent } from "@corbits/code-agent-coder";
const run = runLocal(defining(agent), env);
```

## Consume (deploy runWorkflow / hub / sidecar)

Hand the same `AgentDefinition` to a workflow — the package never exports a
workflow itself.

## Remix components

```ts
import { director, tools, systemPrompt, config } from "@corbits/code-agent-coder";
defineAgent({ director, ... }); // or swap tools / systemPrompt / config
import {
director,
tools,
systemPrompt,
config,
} from "@corbits/code-agent-coder";
// or swap tools / systemPrompt / config
```

Each of `agent`, `defineAgent`, `director`, `tools`, `systemPrompt`, `config` is a
Each of `director`, `tools`, `systemPrompt`, `config` is a
named, independently importable part.

## Single authority

`prompt.ts` `systemPrompt.build()` is byte-stable (the raw card, no formatting).
`toolset.ts` `tools` literal equals the `BUILD_TOOLS` surface constant in
`toolset.ts` `tools` re-exports the `BUILD_TOOLS` surface constant in
`src/agent/directors/tool-sets.ts`; drift is enforced by the in-tree drift-guard
`src/agent/directors/coder/package.test.ts`.
17 changes: 0 additions & 17 deletions agents/coder/src/agent.ts

This file was deleted.

1 change: 0 additions & 1 deletion agents/coder/src/index.ts
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@
export { agent, defineAgent } from "./agent.js";
export { director } from "./director.js";
export { tools } from "./toolset.js";
export { systemPrompt } from "./prompt.js";
Expand Down
18 changes: 2 additions & 16 deletions agents/coder/src/toolset.ts
Original file line number Diff line number Diff line change
@@ -1,17 +1,3 @@
// BUILD_TOOLS literal; drift-guarded against src/agent/directors/tool-sets.ts.
import { BUILD_TOOLS } from "../../../src/agent/directors/tool-sets.js";

export const tools = [
"read_file",
"grep",
"search_files",
"list_dir",
"lsp",
"run_shell",
"web_fetch",
"web_search",
"skill_search",
"use_skill",
"write_file",
"edit_file",
"delete_file",
] as const;
export const tools = BUILD_TOOLS;
25 changes: 9 additions & 16 deletions agents/designer/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,25 +3,18 @@
## What this is

Ready `@corbits/code-agent-designer` agent + independently importable components:
`agent`, `defineAgent`, `director`, `tools`, `systemPrompt`, `config`.

## Consume (runLocal)

```ts
import { agent } from "@corbits/code-agent-designer";
const run = runLocal(defining(agent), env);
```

## Consume (deploy runWorkflow / hub / sidecar)

Hand the same `AgentDefinition` to a workflow — the package never exports a
workflow itself.
`director`, `tools`, `systemPrompt`, `config`.

## Remix components

```ts
import { director, tools, systemPrompt, config } from "@corbits/code-agent-designer";
defineAgent({ director, ... }); // or swap tools / systemPrompt / config
import {
director,
tools,
systemPrompt,
config,
} from "@corbits/code-agent-designer";
// or swap tools / systemPrompt / config
```

Each of `director`, `tools`, `systemPrompt`, and `config` is a named,
Expand All @@ -30,6 +23,6 @@ independently importable part.
## Single authority

`prompt.ts` `systemPrompt.build()` is byte-stable (the raw card, no formatting).
`toolset.ts` `tools` literal equals the `REVIEW_TOOLS` surface constant in
`toolset.ts` `tools` re-exports the `REVIEW_TOOLS` surface constant in
`src/agent/directors/tool-sets.ts`; drift is enforced by the in-tree drift-guard
`src/agent/directors/designer/package.test.ts`.
17 changes: 0 additions & 17 deletions agents/designer/src/agent.ts

This file was deleted.

1 change: 0 additions & 1 deletion agents/designer/src/index.ts
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@
export { agent, defineAgent } from "./agent.js";
export { director } from "./director.js";
export { tools } from "./toolset.js";
export { systemPrompt } from "./prompt.js";
Expand Down
20 changes: 3 additions & 17 deletions agents/designer/src/toolset.ts
Original file line number Diff line number Diff line change
@@ -1,17 +1,3 @@
// BUILD_TOOLS literal (= REVIEW_TOOLS); drift-guarded against REVIEW_TOOLS
// by src/agent/directors/designer/package.test.ts.
export const tools = [
"read_file",
"grep",
"search_files",
"list_dir",
"lsp",
"run_shell",
"web_fetch",
"web_search",
"skill_search",
"use_skill",
"write_file",
"edit_file",
"delete_file",
] as const;
import { REVIEW_TOOLS } from "../../../src/agent/directors/tool-sets.js";

export const tools = REVIEW_TOOLS;
18 changes: 2 additions & 16 deletions agents/dispatch/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,18 +7,6 @@ plus its named component parts so a consumer can recreate or remix it. Dispatch
the Tier-1 primary orchestrator: it classifies work, DIYs obvious mechanical
corrections, and spawns named specialists.

## Consume (runLocal)

```ts
import { agent } from "@corbits/code-agent-dispatch";
const run = runLocal(defining(agent), env);
```

## Consume (deploy runWorkflow / hub / sidecar)

Hand the same `AgentDefinition` (`agent`) to a workflow, hub, or sidecar. The
package never exports a workflow itself — a workflow _consumes_ `agent`.

## Remix components

```ts
Expand All @@ -27,20 +15,18 @@ import {
tools,
systemPrompt,
config,
defineAgent,
} from "@corbits/code-agent-dispatch";

// Swap components at the consumer side.
defineAgent({ director, tools, systemPrompt, config }); // or spread overrides
```

Each of `agent`, `defineAgent`, `director`, `tools`, `systemPrompt`, `config` is a
Each of `director`, `tools`, `systemPrompt`, `config` is a
named, independently importable part.

## Byte-stability & single authority

- `systemPrompt.build()` is pure and byte-stable — identical string every call.
- `tools` is the literal expansion of the app's `DISPATCH_TOOLS` surface constant
- `tools` re-exports the app's `DISPATCH_TOOLS` surface constant
(`src/agent/directors/tool-sets.ts`); the in-tree drift-guard
(`src/agent/directors/dispatch/package.test.ts`) enforces they match.
- This package is the single prompt authority for dispatch; the in-tree
Expand Down
19 changes: 0 additions & 19 deletions agents/dispatch/src/agent.ts

This file was deleted.

1 change: 0 additions & 1 deletion agents/dispatch/src/index.ts
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@
export { agent, defineAgent } from "./agent.js";
export { director } from "./director.js";
export { tools } from "./toolset.js";
export { systemPrompt } from "./prompt.js";
Expand Down
30 changes: 3 additions & 27 deletions agents/dispatch/src/toolset.ts
Original file line number Diff line number Diff line change
@@ -1,27 +1,3 @@
// Dispatch primary: orchestrator surface plus fleet discovery (Tier-1 only).
// Drift against the app's DISPATCH_TOOLS is enforced by the in-tree
// src/agent/directors/dispatch/package.test.ts.
export const tools = [
"read_file",
"grep",
"search_files",
"list_dir",
"lsp",
"run_shell",
"web_fetch",
"web_search",
"skill_search",
"use_skill",
"write_file",
"edit_file",
"delete_file",
"spawn_agent",
"list_agents",
"close_agent",
"resume_agent",
"interrupt_agent",
"send_input",
"approve_worker_call",
"read_agent_trace",
"search_agents",
] as const;
import { DISPATCH_TOOLS } from "../../../src/agent/directors/tool-sets.js";

export const tools = DISPATCH_TOOLS;
Loading
Loading