1
export interface AgentDefinition {
2
  id: string;
3
  name: string;
4
  displayName: string;
5
  version: string;
6
  owner: string;                    // Team
7
  status: "draft" | "active" | "deprecated" | "retired";
8
  tools: Array<{
9
    name: string;
10
    source: "built-in" | "mcp-server";
11
    required: boolean;
12
    permissions: string[];
13
  }>;
14
  deployment: {
15
    replicas: number;
16
    regions: string[];
17
    environment: "development" | "staging" | "production";
18
  };
19
  promptVersionId: string | null;
20
}
21

22
export class AgentRegistry {
23
  private agents = new Map<string, AgentDefinition>();
24

25
  async register(def: Omit<AgentDefinition, "id" | "createdAt" | "updatedAt">): Promise<AgentDefinition> {
26
    const id = def.name.toLowerCase().replace(/[^a-z0-9-]/g, "-");
27
    const agent = { ...def, id, createdAt: Date.now(), updatedAt: Date.now() };
28
    this.validate(agent);
29
    this.agents.set(id, agent);
30
    return agent;
31
  }
32

33
  list(filters?: { status?: string; environment?: string; owner?: string }): AgentDefinition[] {
34
    let r = Array.from(this.agents.values());
35
    if (filters?.status) r = r.filter(a => a.status === filters.status);
36
    if (filters?.owner) r = r.filter(a => a.owner === filters.owner);
37
    return r.sort((a, b) => b.updatedAt - a.updatedAt);
38
  }
39

40
  getToolUsage(): Map<string, string[]> {
41
    const usage = new Map<string, string[]>();
42
    for (const agent of this.agents.values()) {
43
      for (const tool of agent.tools) {
44
        const agents = usage.get(tool.name) || [];
45
        agents.push(agent.name);
46
        usage.set(tool.name, agents);
47
      }
48
    }
49
    return usage;
50
  }
51
}

1
interface AgentTemplate {
2
  id: string;
3
  name: string;
4
  description: string;
5
  tools: string[];
6
  defaultPrompt: string;
7
  icon: string;
8
}
9

10
export class AgentBuilder {
11
  private templates = new Map<string, AgentTemplate>();
12

13
  registerTemplate(t: AgentTemplate): void { this.templates.set(t.id, t); }
14

15
  async createFromTemplate(params: {
16
    templateId: string; name: string; team: string; environment?: string;
17
  }) {
18
    const t = this.templates.get(params.templateId);
19
    if (!t) throw new Error(`Template "${params.templateId}" not found`);
20

21
    // Auto-generate agent definition + default prompt
22
    // Activate prompt at 100%
23
    // Return agent + promptVersionId
24
  }
25
}
26

27
// Templates built-in
28
builder.registerTemplate({
29
  id: "github-issue-manager",
30
  name: "GitHub Issue Manager",
31
  tools: ["list_issues", "get_issue", "create_issue", "search_issues", "add_comment"],
32
  defaultPrompt: "You are {{name}}, a GitHub issue management agent...",
33
  icon: "🐙",
34
});
35

36
builder.registerTemplate({
37
  id: "code-review-assistant",
38
  name: "Code Review Assistant",
39
  tools: ["list_prs", "get_pr_diff", "comment_on_pr", "check_lint", "run_tests"],
40
  defaultPrompt: "You are {{name}}, a code review assistant...",
41
  icon: "📝",
42
});

1
export class GovernanceEngine {
2
  private policies = new Map<string, ApprovalPolicy>();
3

4
  addPolicy(p: ApprovalPolicy): void { /* ... */ }
5

6
  needsApproval(agent: AgentDefinition, type: string): boolean {
7
    // Kiểm tra tất cả policies
8
    // Nếu agent deploy production → cần 2 approvals từ platform-engineering
9
  }
10

11
  async requestApproval(agentId: string, changeType: string, requestedBy: string): Promise<ApprovalRequest> {
12
    // Tạo request pending
13
  }
14

15
  async approve(id: string, by: string): Promise<ApprovalRequest> {
16
    // Nếu đủ approvals → auto-approve
17
  }
18
}
19

20
// Policies mặc định:
21
governance.addPolicy({
22
  id: "prod-deploy",
23
  conditions: [{ attribute: "deployment.environment", operator: "eq", value: "production" }],
24
  requiredApprovals: 2,
25
  approverTeams: ["platform-engineering"],
26
});

1
GET    /v1/agents                  → list agents
2
GET    /v1/agents/:id              → get agent
3
POST   /v1/agents                  → register agent
4
PATCH  /v1/agents/:id              → update agent
5
POST   /v1/agents/create           → create from template
6
GET    /v1/agents/:id/prompts      → list prompt versions
7
POST   /v1/agents/:id/prompts     → new prompt version
8
POST   /v1/agents/:id/experiments → start A/B test
9
POST   /v1/agents/:id/deploy      → deploy / rollout
10
GET    /v1/tools/usage             → tool impact analysis
11
POST   /v1/approvals/:id/approve  → approve deployment
12
POST   /v1/approvals/:id/reject   → reject deployment
13
GET    /v1/dashboard               → aggregated metrics
14
GET    /v1/infra/regions           → region status