mirror of
https://github.com/shareAI-lab/analysis_claude_code.git
synced 2026-09-21 21:03:38 +08:00
feat: build an AI agent from 0 to 1 -- 11 progressive sessions
- 11 sessions from basic agent loop to autonomous teams - Python MVP implementations for each session - Mental-model-first docs in en/zh/ja - Interactive web platform with step-through visualizations - Incremental architecture: each session adds one mechanism
This commit is contained in:
CrazyBoyM
278
web/src/data/execution-flows.ts
Normal file
278
web/src/data/execution-flows.ts
Normal file
@@ -0,0 +1,278 @@
|
||||
import type { FlowNode, FlowEdge } from "@/types/agent-data";
|
||||
|
||||
export interface FlowDefinition {
|
||||
nodes: FlowNode[];
|
||||
edges: FlowEdge[];
|
||||
}
|
||||
|
||||
const FLOW_WIDTH = 600;
|
||||
const COL_CENTER = FLOW_WIDTH / 2;
|
||||
const COL_LEFT = 140;
|
||||
const COL_RIGHT = FLOW_WIDTH - 140;
|
||||
|
||||
export const EXECUTION_FLOWS: Record<string, FlowDefinition> = {
|
||||
s01: {
|
||||
nodes: [
|
||||
{ id: "start", label: "User Input", type: "start", x: COL_CENTER, y: 30 },
|
||||
{ id: "llm", label: "LLM Call", type: "process", x: COL_CENTER, y: 110 },
|
||||
{ id: "tool_check", label: "tool_use?", type: "decision", x: COL_CENTER, y: 190 },
|
||||
{ id: "bash", label: "Execute Bash", type: "subprocess", x: COL_LEFT, y: 280 },
|
||||
{ id: "append", label: "Append Result", type: "process", x: COL_LEFT, y: 360 },
|
||||
{ id: "end", label: "Output", type: "end", x: COL_RIGHT, y: 280 },
|
||||
],
|
||||
edges: [
|
||||
{ from: "start", to: "llm" },
|
||||
{ from: "llm", to: "tool_check" },
|
||||
{ from: "tool_check", to: "bash", label: "yes" },
|
||||
{ from: "tool_check", to: "end", label: "no" },
|
||||
{ from: "bash", to: "append" },
|
||||
{ from: "append", to: "llm" },
|
||||
],
|
||||
},
|
||||
s02: {
|
||||
nodes: [
|
||||
{ id: "start", label: "User Input", type: "start", x: COL_CENTER, y: 30 },
|
||||
{ id: "llm", label: "LLM Call", type: "process", x: COL_CENTER, y: 110 },
|
||||
{ id: "tool_check", label: "tool_use?", type: "decision", x: COL_CENTER, y: 190 },
|
||||
{ id: "dispatch", label: "Tool Dispatch", type: "process", x: COL_LEFT, y: 280 },
|
||||
{ id: "exec", label: "bash / read / write / edit", type: "subprocess", x: COL_LEFT, y: 360 },
|
||||
{ id: "append", label: "Append Result", type: "process", x: COL_LEFT, y: 440 },
|
||||
{ id: "end", label: "Output", type: "end", x: COL_RIGHT, y: 280 },
|
||||
],
|
||||
edges: [
|
||||
{ from: "start", to: "llm" },
|
||||
{ from: "llm", to: "tool_check" },
|
||||
{ from: "tool_check", to: "dispatch", label: "yes" },
|
||||
{ from: "tool_check", to: "end", label: "no" },
|
||||
{ from: "dispatch", to: "exec" },
|
||||
{ from: "exec", to: "append" },
|
||||
{ from: "append", to: "llm" },
|
||||
],
|
||||
},
|
||||
s03: {
|
||||
nodes: [
|
||||
{ id: "start", label: "User Input", type: "start", x: COL_CENTER, y: 30 },
|
||||
{ id: "todo", label: "Create Todos", type: "process", x: COL_CENTER, y: 100 },
|
||||
{ id: "llm", label: "LLM Call", type: "process", x: COL_CENTER, y: 180 },
|
||||
{ id: "tool_check", label: "tool_use?", type: "decision", x: COL_CENTER, y: 260 },
|
||||
{ id: "exec", label: "Execute Tool", type: "subprocess", x: COL_LEFT, y: 340 },
|
||||
{ id: "append", label: "Append Result", type: "process", x: COL_LEFT, y: 410 },
|
||||
{ id: "end", label: "Output", type: "end", x: COL_RIGHT, y: 340 },
|
||||
],
|
||||
edges: [
|
||||
{ from: "start", to: "todo" },
|
||||
{ from: "todo", to: "llm" },
|
||||
{ from: "llm", to: "tool_check" },
|
||||
{ from: "tool_check", to: "exec", label: "yes" },
|
||||
{ from: "tool_check", to: "end", label: "no" },
|
||||
{ from: "exec", to: "append" },
|
||||
{ from: "append", to: "llm" },
|
||||
],
|
||||
},
|
||||
s04: {
|
||||
nodes: [
|
||||
{ id: "start", label: "User Input", type: "start", x: COL_CENTER, y: 30 },
|
||||
{ id: "llm", label: "LLM Call", type: "process", x: COL_CENTER, y: 110 },
|
||||
{ id: "tool_check", label: "tool_use?", type: "decision", x: COL_CENTER, y: 190 },
|
||||
{ id: "is_task", label: "task tool?", type: "decision", x: COL_LEFT, y: 280 },
|
||||
{ id: "spawn", label: "Spawn Subagent\n(fresh messages[])", type: "subprocess", x: 60, y: 380 },
|
||||
{ id: "sub_loop", label: "Subagent Loop", type: "process", x: 60, y: 460 },
|
||||
{ id: "exec", label: "Execute Tool", type: "subprocess", x: COL_LEFT + 80, y: 380 },
|
||||
{ id: "append", label: "Append Result", type: "process", x: COL_CENTER, y: 540 },
|
||||
{ id: "end", label: "Output", type: "end", x: COL_RIGHT, y: 280 },
|
||||
],
|
||||
edges: [
|
||||
{ from: "start", to: "llm" },
|
||||
{ from: "llm", to: "tool_check" },
|
||||
{ from: "tool_check", to: "is_task", label: "yes" },
|
||||
{ from: "tool_check", to: "end", label: "no" },
|
||||
{ from: "is_task", to: "spawn", label: "task" },
|
||||
{ from: "is_task", to: "exec", label: "other" },
|
||||
{ from: "spawn", to: "sub_loop" },
|
||||
{ from: "sub_loop", to: "append" },
|
||||
{ from: "exec", to: "append" },
|
||||
{ from: "append", to: "llm" },
|
||||
],
|
||||
},
|
||||
s05: {
|
||||
nodes: [
|
||||
{ id: "start", label: "User Input", type: "start", x: COL_CENTER, y: 30 },
|
||||
{ id: "llm", label: "LLM Call", type: "process", x: COL_CENTER, y: 110 },
|
||||
{ id: "tool_check", label: "tool_use?", type: "decision", x: COL_CENTER, y: 190 },
|
||||
{ id: "is_skill", label: "load_skill?", type: "decision", x: COL_LEFT, y: 280 },
|
||||
{ id: "load", label: "Read SKILL.md", type: "subprocess", x: 60, y: 370 },
|
||||
{ id: "inject", label: "Inject via\ntool_result", type: "process", x: 60, y: 450 },
|
||||
{ id: "exec", label: "Execute Tool", type: "subprocess", x: COL_LEFT + 80, y: 370 },
|
||||
{ id: "append", label: "Append Result", type: "process", x: COL_CENTER, y: 530 },
|
||||
{ id: "end", label: "Output", type: "end", x: COL_RIGHT, y: 280 },
|
||||
],
|
||||
edges: [
|
||||
{ from: "start", to: "llm" },
|
||||
{ from: "llm", to: "tool_check" },
|
||||
{ from: "tool_check", to: "is_skill", label: "yes" },
|
||||
{ from: "tool_check", to: "end", label: "no" },
|
||||
{ from: "is_skill", to: "load", label: "skill" },
|
||||
{ from: "is_skill", to: "exec", label: "other" },
|
||||
{ from: "load", to: "inject" },
|
||||
{ from: "inject", to: "append" },
|
||||
{ from: "exec", to: "append" },
|
||||
{ from: "append", to: "llm" },
|
||||
],
|
||||
},
|
||||
s06: {
|
||||
nodes: [
|
||||
{ id: "start", label: "User Input", type: "start", x: COL_CENTER, y: 30 },
|
||||
{ id: "compress_check", label: "Over token\nlimit?", type: "decision", x: COL_CENTER, y: 110 },
|
||||
{ id: "compress", label: "Compress Context", type: "subprocess", x: COL_RIGHT, y: 110 },
|
||||
{ id: "llm", label: "LLM Call", type: "process", x: COL_CENTER, y: 200 },
|
||||
{ id: "tool_check", label: "tool_use?", type: "decision", x: COL_CENTER, y: 280 },
|
||||
{ id: "exec", label: "Execute Tool", type: "subprocess", x: COL_LEFT, y: 360 },
|
||||
{ id: "append", label: "Append Result", type: "process", x: COL_LEFT, y: 430 },
|
||||
{ id: "end", label: "Output", type: "end", x: COL_RIGHT, y: 360 },
|
||||
],
|
||||
edges: [
|
||||
{ from: "start", to: "compress_check" },
|
||||
{ from: "compress_check", to: "compress", label: "yes" },
|
||||
{ from: "compress_check", to: "llm", label: "no" },
|
||||
{ from: "compress", to: "llm" },
|
||||
{ from: "llm", to: "tool_check" },
|
||||
{ from: "tool_check", to: "exec", label: "yes" },
|
||||
{ from: "tool_check", to: "end", label: "no" },
|
||||
{ from: "exec", to: "append" },
|
||||
{ from: "append", to: "compress_check" },
|
||||
],
|
||||
},
|
||||
s07: {
|
||||
nodes: [
|
||||
{ id: "start", label: "User Input", type: "start", x: COL_CENTER, y: 30 },
|
||||
{ id: "llm", label: "LLM Call", type: "process", x: COL_CENTER, y: 110 },
|
||||
{ id: "tool_check", label: "tool_use?", type: "decision", x: COL_CENTER, y: 190 },
|
||||
{ id: "is_task", label: "task_manager?", type: "decision", x: COL_LEFT, y: 280 },
|
||||
{ id: "crud", label: "CRUD Task\n(file-based)", type: "subprocess", x: 60, y: 370 },
|
||||
{ id: "dep_check", label: "Check\nDependencies", type: "process", x: 60, y: 450 },
|
||||
{ id: "exec", label: "Execute Tool", type: "subprocess", x: COL_LEFT + 80, y: 370 },
|
||||
{ id: "append", label: "Append Result", type: "process", x: COL_CENTER, y: 530 },
|
||||
{ id: "end", label: "Output", type: "end", x: COL_RIGHT, y: 280 },
|
||||
],
|
||||
edges: [
|
||||
{ from: "start", to: "llm" },
|
||||
{ from: "llm", to: "tool_check" },
|
||||
{ from: "tool_check", to: "is_task", label: "yes" },
|
||||
{ from: "tool_check", to: "end", label: "no" },
|
||||
{ from: "is_task", to: "crud", label: "task" },
|
||||
{ from: "is_task", to: "exec", label: "other" },
|
||||
{ from: "crud", to: "dep_check" },
|
||||
{ from: "dep_check", to: "append" },
|
||||
{ from: "exec", to: "append" },
|
||||
{ from: "append", to: "llm" },
|
||||
],
|
||||
},
|
||||
s08: {
|
||||
nodes: [
|
||||
{ id: "start", label: "User Input", type: "start", x: COL_CENTER, y: 30 },
|
||||
{ id: "llm", label: "LLM Call", type: "process", x: COL_CENTER, y: 110 },
|
||||
{ id: "tool_check", label: "tool_use?", type: "decision", x: COL_CENTER, y: 190 },
|
||||
{ id: "bg_check", label: "Background?", type: "decision", x: COL_LEFT, y: 280 },
|
||||
{ id: "bg_spawn", label: "Spawn Thread", type: "subprocess", x: 60, y: 370 },
|
||||
{ id: "exec", label: "Execute Tool", type: "subprocess", x: COL_LEFT + 80, y: 370 },
|
||||
{ id: "append", label: "Append Result", type: "process", x: COL_CENTER, y: 450 },
|
||||
{ id: "notify", label: "Notification\nQueue", type: "process", x: 60, y: 450 },
|
||||
{ id: "end", label: "Output", type: "end", x: COL_RIGHT, y: 280 },
|
||||
],
|
||||
edges: [
|
||||
{ from: "start", to: "llm" },
|
||||
{ from: "llm", to: "tool_check" },
|
||||
{ from: "tool_check", to: "bg_check", label: "yes" },
|
||||
{ from: "tool_check", to: "end", label: "no" },
|
||||
{ from: "bg_check", to: "bg_spawn", label: "bg" },
|
||||
{ from: "bg_check", to: "exec", label: "fg" },
|
||||
{ from: "bg_spawn", to: "notify" },
|
||||
{ from: "exec", to: "append" },
|
||||
{ from: "append", to: "llm" },
|
||||
{ from: "notify", to: "llm" },
|
||||
],
|
||||
},
|
||||
s09: {
|
||||
nodes: [
|
||||
{ id: "start", label: "User Input", type: "start", x: COL_CENTER, y: 30 },
|
||||
{ id: "llm", label: "LLM Call\n(team lead)", type: "process", x: COL_CENTER, y: 110 },
|
||||
{ id: "tool_check", label: "tool_use?", type: "decision", x: COL_CENTER, y: 200 },
|
||||
{ id: "is_team", label: "Team tool?", type: "decision", x: COL_LEFT, y: 290 },
|
||||
{ id: "spawn", label: "Spawn\nTeammate", type: "subprocess", x: 60, y: 390 },
|
||||
{ id: "msg", label: "Send Message\n(JSONL inbox)", type: "subprocess", x: 60, y: 470 },
|
||||
{ id: "exec", label: "Execute Tool", type: "subprocess", x: COL_LEFT + 80, y: 390 },
|
||||
{ id: "append", label: "Append Result", type: "process", x: COL_CENTER, y: 550 },
|
||||
{ id: "end", label: "Output", type: "end", x: COL_RIGHT, y: 290 },
|
||||
{ id: "teammate", label: "Teammate Agent\n(own loop)", type: "process", x: COL_RIGHT, y: 470 },
|
||||
],
|
||||
edges: [
|
||||
{ from: "start", to: "llm" },
|
||||
{ from: "llm", to: "tool_check" },
|
||||
{ from: "tool_check", to: "is_team", label: "yes" },
|
||||
{ from: "tool_check", to: "end", label: "no" },
|
||||
{ from: "is_team", to: "spawn", label: "spawn" },
|
||||
{ from: "is_team", to: "exec", label: "other" },
|
||||
{ from: "spawn", to: "teammate" },
|
||||
{ from: "spawn", to: "msg" },
|
||||
{ from: "msg", to: "append" },
|
||||
{ from: "exec", to: "append" },
|
||||
{ from: "append", to: "llm" },
|
||||
],
|
||||
},
|
||||
s10: {
|
||||
nodes: [
|
||||
{ id: "start", label: "User Input", type: "start", x: COL_CENTER, y: 30 },
|
||||
{ id: "llm", label: "LLM Call\n(team lead)", type: "process", x: COL_CENTER, y: 110 },
|
||||
{ id: "tool_check", label: "tool_use?", type: "decision", x: COL_CENTER, y: 200 },
|
||||
{ id: "is_proto", label: "Protocol?", type: "decision", x: COL_LEFT, y: 290 },
|
||||
{ id: "shutdown", label: "Shutdown\nRequest", type: "subprocess", x: 60, y: 390 },
|
||||
{ id: "fsm", label: "FSM:\npending->approved", type: "process", x: 60, y: 470 },
|
||||
{ id: "exec", label: "Execute Tool", type: "subprocess", x: COL_LEFT + 80, y: 390 },
|
||||
{ id: "append", label: "Append Result", type: "process", x: COL_CENTER, y: 550 },
|
||||
{ id: "end", label: "Output", type: "end", x: COL_RIGHT, y: 290 },
|
||||
{ id: "teammate", label: "Teammate\nreceives request_id", type: "process", x: COL_RIGHT, y: 470 },
|
||||
],
|
||||
edges: [
|
||||
{ from: "start", to: "llm" },
|
||||
{ from: "llm", to: "tool_check" },
|
||||
{ from: "tool_check", to: "is_proto", label: "yes" },
|
||||
{ from: "tool_check", to: "end", label: "no" },
|
||||
{ from: "is_proto", to: "shutdown", label: "shutdown" },
|
||||
{ from: "is_proto", to: "exec", label: "other" },
|
||||
{ from: "shutdown", to: "fsm" },
|
||||
{ from: "fsm", to: "teammate" },
|
||||
{ from: "teammate", to: "append" },
|
||||
{ from: "exec", to: "append" },
|
||||
{ from: "append", to: "llm" },
|
||||
],
|
||||
},
|
||||
s11: {
|
||||
nodes: [
|
||||
{ id: "start", label: "User Input", type: "start", x: COL_CENTER, y: 30 },
|
||||
{ id: "inbox", label: "Check Inbox", type: "process", x: COL_CENTER, y: 100 },
|
||||
{ id: "llm", label: "LLM Call", type: "process", x: COL_CENTER, y: 180 },
|
||||
{ id: "tool_check", label: "tool_use?", type: "decision", x: COL_CENTER, y: 260 },
|
||||
{ id: "exec", label: "Execute Tool", type: "subprocess", x: COL_LEFT, y: 340 },
|
||||
{ id: "append", label: "Append Result", type: "process", x: COL_LEFT, y: 410 },
|
||||
{ id: "end", label: "Output", type: "end", x: COL_RIGHT, y: 340 },
|
||||
{ id: "idle", label: "Idle Cycle", type: "process", x: COL_RIGHT, y: 420 },
|
||||
{ id: "poll", label: "Poll Tasks\n+ Auto-Claim", type: "subprocess", x: COL_RIGHT, y: 500 },
|
||||
],
|
||||
edges: [
|
||||
{ from: "start", to: "inbox" },
|
||||
{ from: "inbox", to: "llm" },
|
||||
{ from: "llm", to: "tool_check" },
|
||||
{ from: "tool_check", to: "exec", label: "yes" },
|
||||
{ from: "tool_check", to: "end", label: "no" },
|
||||
{ from: "exec", to: "append" },
|
||||
{ from: "append", to: "llm" },
|
||||
{ from: "end", to: "idle" },
|
||||
{ from: "idle", to: "poll" },
|
||||
{ from: "poll", to: "inbox" },
|
||||
],
|
||||
},
|
||||
};
|
||||
|
||||
export function getFlowForVersion(version: string): FlowDefinition | null {
|
||||
return EXECUTION_FLOWS[version] ?? null;
|
||||
}
|
||||
Reference in New Issue
Block a user