@cereworker/core 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Producible
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/dist/events.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import type { Message, ToolCall, ToolResult, TaskAction, CerebellumStatus } from './types.js';
1
+ import type { Message, ToolCall, ToolResult, TaskAction, CerebellumStatus, VerificationResult, AgentHealthAction } from './types.js';
2
2
  export type OrchestratorEvent = {
3
3
  type: 'message:user';
4
4
  message: Message;
@@ -21,12 +21,34 @@ export type OrchestratorEvent = {
21
21
  } | {
22
22
  type: 'tool:end';
23
23
  result: ToolResult;
24
+ } | {
25
+ type: 'verification:start';
26
+ callId: string;
27
+ toolName: string;
28
+ } | {
29
+ type: 'verification:end';
30
+ result: VerificationResult;
24
31
  } | {
25
32
  type: 'heartbeat:tick';
26
33
  actions: TaskAction[];
27
34
  } | {
28
35
  type: 'cerebellum:status';
29
36
  status: CerebellumStatus;
37
+ } | {
38
+ type: 'agent:spawned';
39
+ agentId: string;
40
+ task: string;
41
+ } | {
42
+ type: 'agent:completed';
43
+ agentId: string;
44
+ result: string;
45
+ } | {
46
+ type: 'agent:failed';
47
+ agentId: string;
48
+ error: string;
49
+ } | {
50
+ type: 'agent:health';
51
+ actions: AgentHealthAction[];
30
52
  } | {
31
53
  type: 'error';
32
54
  error: Error;
@@ -1 +1 @@
1
- {"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9F,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,2BAA2B,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpC,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAE1C,KAAK,QAAQ,GAAG;KACb,CAAC,IAAI,iBAAiB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,iBAAiB,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC;CAC1E,CAAC;AAEF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAA2D;IAE3E,EAAE,CAAC,CAAC,SAAS,iBAAiB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAYhG,IAAI,CAAC,CAAC,SAAS,iBAAiB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IASnE,kBAAkB,IAAI,IAAI;CAG3B"}
1
+ {"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErI,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,2BAA2B,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,UAAU,EAAE,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpC,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAE1C,KAAK,QAAQ,GAAG;KACb,CAAC,IAAI,iBAAiB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,iBAAiB,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC;CAC1E,CAAC;AAEF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAA2D;IAE3E,EAAE,CAAC,CAAC,SAAS,iBAAiB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAYhG,IAAI,CAAC,CAAC,SAAS,iBAAiB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IASnE,kBAAkB,IAAI,IAAI;CAG3B"}
@@ -1 +1 @@
1
- {"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAoBA,MAAM,OAAO,iBAAiB;IACpB,QAAQ,GAAG,IAAI,GAAG,EAAgD,CAAC;IAE3E,EAAE,CAAsC,IAAO,EAAE,OAAkC;QACjF,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,YAAY,GAAG,OAA0C,CAAC;QAChE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAE3C,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAsC,KAAkB;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}
1
+ {"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AA0BA,MAAM,OAAO,iBAAiB;IACpB,QAAQ,GAAG,IAAI,GAAG,EAAgD,CAAC;IAE3E,EAAE,CAAsC,IAAO,EAAE,OAAkC;QACjF,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,YAAY,GAAG,OAA0C,CAAC;QAChE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAE3C,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAsC,KAAkB;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,kBAAkB;QAChB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}
package/dist/index.d.ts CHANGED
@@ -1,6 +1,10 @@
1
- export type { Message, MessageRole, ToolCall, ToolResult, Conversation, TaskAction, CerebellumStatus, OrchestratorConfig, } from './types.js';
1
+ export type { Message, MessageRole, ToolCall, ToolResult, Conversation, TaskAction, CerebellumStatus, OrchestratorConfig, VerificationResult, VerificationCheck, SubAgentState, SubAgentStatus, SubAgentCleanup, SubAgentSummary, AgentHealthAction, SystemStatus, } from './types.js';
2
2
  export type { OrchestratorEvent } from './events.js';
3
3
  export { TypedEventEmitter } from './events.js';
4
4
  export { ConversationStore } from './conversation.js';
5
5
  export { Orchestrator } from './orchestrator.js';
6
+ export type { CerebrumAdapter, CerebellumAdapter, ToolDefinition, StreamCallbacks } from './orchestrator.js';
7
+ export { SubAgentManager } from './sub-agent-manager.js';
8
+ export type { SubAgentManagerOptions } from './sub-agent-manager.js';
9
+ export { createSubAgentTools } from './sub-agent-tools.js';
6
10
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,WAAW,EACX,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,WAAW,EACX,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC7G,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}
package/dist/index.js CHANGED
@@ -1,4 +1,6 @@
1
1
  export { TypedEventEmitter } from './events.js';
2
2
  export { ConversationStore } from './conversation.js';
3
3
  export { Orchestrator } from './orchestrator.js';
4
+ export { SubAgentManager } from './sub-agent-manager.js';
5
+ export { createSubAgentTools } from './sub-agent-tools.js';
4
6
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}
@@ -1,5 +1,6 @@
1
1
  import { TypedEventEmitter } from './events.js';
2
- import type { Message, ToolCall, ToolResult } from './types.js';
2
+ import { SubAgentManager } from './sub-agent-manager.js';
3
+ import type { Message, ToolCall, ToolResult, AgentHealthAction } from './types.js';
3
4
  export interface CerebrumAdapter {
4
5
  stream(messages: Message[], tools: Record<string, ToolDefinition>, callbacks: StreamCallbacks): Promise<void>;
5
6
  }
@@ -14,13 +15,52 @@ export interface StreamCallbacks {
14
15
  onFinish: (content: string) => void;
15
16
  onError: (error: Error) => void;
16
17
  }
18
+ export interface CerebellumAdapter {
19
+ isConnected(): boolean;
20
+ verifyToolResult(toolName: string, toolArgs: Record<string, string>, toolOutput: string, claimedSuccess: boolean): Promise<{
21
+ passed: boolean;
22
+ checks: Array<{
23
+ name: string;
24
+ passed: boolean;
25
+ description: string;
26
+ }>;
27
+ modelVerdict: boolean;
28
+ } | null>;
29
+ reportAgentStates?(agents: Array<{
30
+ id: string;
31
+ task: string;
32
+ status: string;
33
+ spawnedAt: number;
34
+ lastActivityAt: number;
35
+ timeoutMs: number;
36
+ messagesCount: number;
37
+ toolCallsCount: number;
38
+ retryCount: number;
39
+ }>): Promise<AgentHealthAction[]>;
40
+ }
17
41
  export declare class Orchestrator extends TypedEventEmitter {
18
42
  private conversations;
19
43
  private cerebrum;
44
+ private cerebellum;
45
+ private subAgentManager;
20
46
  private tools;
21
47
  private activeConversationId;
48
+ private verificationEnabled;
49
+ private verificationTimeoutMs;
50
+ private monitorIntervalMs;
51
+ private monitorTimer;
22
52
  constructor();
23
53
  setCerebrum(cerebrum: CerebrumAdapter): void;
54
+ setCerebellum(cerebellum: CerebellumAdapter, options?: {
55
+ enabled?: boolean;
56
+ timeoutMs?: number;
57
+ }): void;
58
+ setupSubAgents(options?: {
59
+ maxConcurrent?: number;
60
+ baseDir?: string;
61
+ monitorIntervalMs?: number;
62
+ }): SubAgentManager | null;
63
+ getSubAgentManager(): SubAgentManager | null;
24
64
  registerTool(name: string, tool: ToolDefinition): void;
25
65
  getActiveConversationId(): string | null;
26
66
  getConversation(id: string): import("./types.js").Conversation | undefined;
@@ -29,5 +69,6 @@ export declare class Orchestrator extends TypedEventEmitter {
29
69
  sendMessage(content: string, conversationId?: string): Promise<void>;
30
70
  start(): Promise<void>;
31
71
  stop(): Promise<void>;
72
+ private startMonitorLoop;
32
73
  }
33
74
  //# sourceMappingURL=orchestrator.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,MAAM,CACJ,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACrC,SAAS,EAAE,eAAe,GACzB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACxD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAED,qBAAa,YAAa,SAAQ,iBAAiB;IACjD,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,oBAAoB,CAAuB;;IAOnD,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAI5C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAItD,uBAAuB,IAAI,MAAM,GAAG,IAAI;IAIxC,eAAe,CAAC,EAAE,EAAE,MAAM;IAI1B,WAAW,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE;IAM/C,iBAAiB,IAAI,MAAM;IAMrB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkEpE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}
1
+ {"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"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"}
@@ -1,10 +1,18 @@
1
1
  import { TypedEventEmitter } from './events.js';
2
2
  import { ConversationStore } from './conversation.js';
3
+ import { SubAgentManager } from './sub-agent-manager.js';
4
+ import { createSubAgentTools } from './sub-agent-tools.js';
3
5
  export class Orchestrator extends TypedEventEmitter {
4
6
  conversations;
5
7
  cerebrum = null;
8
+ cerebellum = null;
9
+ subAgentManager = null;
6
10
  tools = new Map();
7
11
  activeConversationId = null;
12
+ verificationEnabled = true;
13
+ verificationTimeoutMs = 5000;
14
+ monitorIntervalMs = 30_000;
15
+ monitorTimer = null;
8
16
  constructor() {
9
17
  super();
10
18
  this.conversations = new ConversationStore();
@@ -12,6 +20,34 @@ export class Orchestrator extends TypedEventEmitter {
12
20
  setCerebrum(cerebrum) {
13
21
  this.cerebrum = cerebrum;
14
22
  }
23
+ setCerebellum(cerebellum, options) {
24
+ this.cerebellum = cerebellum;
25
+ if (options?.enabled !== undefined)
26
+ this.verificationEnabled = options.enabled;
27
+ if (options?.timeoutMs !== undefined)
28
+ this.verificationTimeoutMs = options.timeoutMs;
29
+ }
30
+ setupSubAgents(options) {
31
+ if (!this.cerebrum)
32
+ return null;
33
+ if (options?.monitorIntervalMs)
34
+ this.monitorIntervalMs = options.monitorIntervalMs;
35
+ this.subAgentManager = new SubAgentManager({
36
+ cerebrum: this.cerebrum,
37
+ tools: this.tools,
38
+ maxConcurrent: options?.maxConcurrent,
39
+ baseDir: options?.baseDir,
40
+ });
41
+ // Register sub-agent tools with the orchestrator
42
+ const agentTools = createSubAgentTools(this.subAgentManager);
43
+ for (const [name, tool] of Object.entries(agentTools)) {
44
+ this.tools.set(name, tool);
45
+ }
46
+ return this.subAgentManager;
47
+ }
48
+ getSubAgentManager() {
49
+ return this.subAgentManager;
50
+ }
15
51
  registerTool(name, tool) {
16
52
  this.tools.set(name, tool);
17
53
  }
@@ -72,6 +108,39 @@ export class Orchestrator extends TypedEventEmitter {
72
108
  result = { callId: toolCall.id, output: `Unknown tool: ${toolCall.name}`, isError: true };
73
109
  }
74
110
  this.emit({ type: 'tool:end', result });
111
+ // Cerebellum verification (non-blocking)
112
+ if (this.cerebellum?.isConnected() && this.verificationEnabled) {
113
+ try {
114
+ this.emit({ type: 'verification:start', callId: toolCall.id, toolName: toolCall.name });
115
+ const toolArgs = {};
116
+ for (const [k, v] of Object.entries(toolCall.args)) {
117
+ toolArgs[k] = String(v);
118
+ }
119
+ const verifyPromise = this.cerebellum.verifyToolResult(toolCall.name, toolArgs, result.output, !result.isError);
120
+ const timeoutPromise = new Promise((resolve) => setTimeout(() => resolve(null), this.verificationTimeoutMs));
121
+ const verification = await Promise.race([verifyPromise, timeoutPromise]);
122
+ if (verification && !verification.passed) {
123
+ const failedChecks = verification.checks
124
+ .filter((c) => !c.passed)
125
+ .map((c) => c.description)
126
+ .join(', ');
127
+ result.output += `\n[Cerebellum warning: ${failedChecks}]`;
128
+ }
129
+ if (verification) {
130
+ const vResult = {
131
+ passed: verification.passed,
132
+ checks: verification.checks,
133
+ modelVerdict: verification.modelVerdict,
134
+ toolCallId: toolCall.id,
135
+ toolName: toolCall.name,
136
+ };
137
+ this.emit({ type: 'verification:end', result: vResult });
138
+ }
139
+ }
140
+ catch {
141
+ // Verification failure should never block tool execution
142
+ }
143
+ }
75
144
  this.conversations.appendMessage(convId, 'tool', result.output, {
76
145
  toolResult: result,
77
146
  });
@@ -97,9 +166,65 @@ export class Orchestrator extends TypedEventEmitter {
97
166
  if (!this.activeConversationId) {
98
167
  this.startConversation();
99
168
  }
169
+ // Start sub-agent monitoring loop if cerebellum + sub-agents are enabled
170
+ if (this.subAgentManager && this.cerebellum?.reportAgentStates) {
171
+ this.startMonitorLoop();
172
+ }
100
173
  }
101
174
  async stop() {
175
+ if (this.monitorTimer) {
176
+ clearInterval(this.monitorTimer);
177
+ this.monitorTimer = null;
178
+ }
102
179
  this.removeAllListeners();
103
180
  }
181
+ startMonitorLoop() {
182
+ if (this.monitorTimer)
183
+ return;
184
+ this.monitorTimer = setInterval(async () => {
185
+ if (!this.subAgentManager || !this.cerebellum?.reportAgentStates)
186
+ return;
187
+ const agents = this.subAgentManager.listAgents();
188
+ const activeAgents = agents.filter((a) => a.status === 'running' || a.status === 'pending');
189
+ if (activeAgents.length === 0)
190
+ return;
191
+ try {
192
+ const actions = await this.cerebellum.reportAgentStates(activeAgents.map((a) => ({
193
+ id: a.id,
194
+ task: a.task,
195
+ status: a.status,
196
+ spawnedAt: a.spawnedAt,
197
+ lastActivityAt: a.lastActivityAt,
198
+ timeoutMs: a.timeoutMs,
199
+ messagesCount: a.messagesCount,
200
+ toolCallsCount: a.toolCallsCount,
201
+ retryCount: a.retryCount,
202
+ })));
203
+ const actionable = actions.filter((a) => a.action !== 'ok');
204
+ if (actionable.length > 0) {
205
+ this.emit({ type: 'agent:health', actions: actionable });
206
+ }
207
+ for (const action of actions) {
208
+ switch (action.action) {
209
+ case 'ping':
210
+ this.subAgentManager.ping(action.agentId);
211
+ break;
212
+ case 'retry':
213
+ await this.subAgentManager.retry(action.agentId);
214
+ break;
215
+ case 'cancel':
216
+ case 'timeout':
217
+ this.subAgentManager.cancel(action.agentId);
218
+ break;
219
+ }
220
+ }
221
+ }
222
+ catch {
223
+ // Monitor failure is non-blocking
224
+ }
225
+ // Prune old completed agents
226
+ this.subAgentManager.prune();
227
+ }, this.monitorIntervalMs);
228
+ }
104
229
  }
105
230
  //# sourceMappingURL=orchestrator.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ import type { Message, SubAgentState, SubAgentCleanup, SubAgentSummary } from './types.js';
2
+ import type { CerebrumAdapter, ToolDefinition } from './orchestrator.js';
3
+ export interface SubAgentManagerOptions {
4
+ cerebrum: CerebrumAdapter;
5
+ tools: Map<string, ToolDefinition>;
6
+ maxConcurrent?: number;
7
+ baseDir?: string;
8
+ }
9
+ export declare class SubAgentManager {
10
+ private agents;
11
+ private cerebrum;
12
+ private tools;
13
+ private maxConcurrent;
14
+ private baseDir;
15
+ constructor(opts: SubAgentManagerOptions);
16
+ private ensureDir;
17
+ spawn(task: string, opts?: {
18
+ timeoutMs?: number;
19
+ label?: string;
20
+ cleanup?: SubAgentCleanup;
21
+ parentSessionKey?: string;
22
+ }): Promise<string>;
23
+ getAgent(id: string): SubAgentState | null;
24
+ listAgents(): SubAgentState[];
25
+ getSummary(): SubAgentSummary;
26
+ cancel(id: string): void;
27
+ retry(id: string): Promise<string>;
28
+ ping(id: string): void;
29
+ prune(maxAgeMs?: number): void;
30
+ readTranscript(id: string): Message[] | null;
31
+ private runAgent;
32
+ private createAgentTools;
33
+ private saveSessionMeta;
34
+ private appendTranscript;
35
+ private toState;
36
+ }
37
+ //# sourceMappingURL=sub-agent-manager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sub-agent-manager.d.ts","sourceRoot":"","sources":["../src/sub-agent-manager.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EAEb,eAAe,EACf,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAmB,MAAM,mBAAmB,CAAC;AAwB1F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,EAAE,sBAAsB;IAQxC,OAAO,CAAC,SAAS;IAMX,KAAK,CACT,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,eAAe,CAAC;QAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GACA,OAAO,CAAC,MAAM,CAAC;IAmDlB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAM1C,UAAU,IAAI,aAAa,EAAE;IAI7B,UAAU,IAAI,eAAe;IAU7B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAUlB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA4BxC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAatB,KAAK,CAAC,QAAQ,GAAE,MAAoB,GAAG,IAAI;IAiB3C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,EAAE,GAAG,IAAI;YAM9B,QAAQ;IA0GtB,OAAO,CAAC,gBAAgB;IA+ExB,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,OAAO;CAoBhB"}
@@ -0,0 +1,372 @@
1
+ import { nanoid } from 'nanoid';
2
+ import { existsSync, mkdirSync, writeFileSync, readFileSync, appendFileSync, readdirSync, rmSync, } from 'node:fs';
3
+ import { join } from 'node:path';
4
+ import { homedir } from 'node:os';
5
+ import { ConversationStore } from './conversation.js';
6
+ export class SubAgentManager {
7
+ agents = new Map();
8
+ cerebrum;
9
+ tools;
10
+ maxConcurrent;
11
+ baseDir;
12
+ constructor(opts) {
13
+ this.cerebrum = opts.cerebrum;
14
+ this.tools = opts.tools;
15
+ this.maxConcurrent = opts.maxConcurrent ?? 5;
16
+ this.baseDir = opts.baseDir ?? join(homedir(), '.cereworker', 'agents');
17
+ this.ensureDir(this.baseDir);
18
+ }
19
+ ensureDir(dir) {
20
+ if (!existsSync(dir)) {
21
+ mkdirSync(dir, { recursive: true });
22
+ }
23
+ }
24
+ async spawn(task, opts) {
25
+ const running = this.listAgents().filter((a) => a.status === 'running' || a.status === 'pending');
26
+ if (running.length >= this.maxConcurrent) {
27
+ throw new Error(`Max concurrent sub-agents (${this.maxConcurrent}) reached`);
28
+ }
29
+ const id = nanoid(10);
30
+ const sessionKey = `agent:main:subagent:${id}`;
31
+ const agentDir = join(this.baseDir, id);
32
+ const memoryDir = join(agentDir, 'memory');
33
+ this.ensureDir(agentDir);
34
+ this.ensureDir(memoryDir);
35
+ // Initialize empty MEMORY.md for the agent
36
+ writeFileSync(join(memoryDir, 'MEMORY.md'), '', 'utf-8');
37
+ const conversation = new ConversationStore();
38
+ const conv = conversation.create();
39
+ const instance = {
40
+ id,
41
+ sessionKey,
42
+ parentSessionKey: opts?.parentSessionKey ?? 'agent:main',
43
+ task,
44
+ label: opts?.label,
45
+ status: 'pending',
46
+ cleanup: opts?.cleanup ?? 'delete',
47
+ spawnedAt: Date.now(),
48
+ lastActivityAt: Date.now(),
49
+ timeoutMs: opts?.timeoutMs ?? 5 * 60_000,
50
+ retryCount: 0,
51
+ conversation,
52
+ conversationId: conv.id,
53
+ agentDir,
54
+ abortController: new AbortController(),
55
+ messagesCount: 0,
56
+ toolCallsCount: 0,
57
+ };
58
+ this.agents.set(id, instance);
59
+ this.saveSessionMeta(instance);
60
+ // Run agent asynchronously (fire and forget, errors are captured)
61
+ this.runAgent(instance).catch(() => {
62
+ // Errors are already handled inside runAgent
63
+ });
64
+ return id;
65
+ }
66
+ getAgent(id) {
67
+ const instance = this.agents.get(id);
68
+ if (!instance)
69
+ return null;
70
+ return this.toState(instance);
71
+ }
72
+ listAgents() {
73
+ return Array.from(this.agents.values()).map((i) => this.toState(i));
74
+ }
75
+ getSummary() {
76
+ const agents = this.listAgents();
77
+ return {
78
+ total: agents.length,
79
+ running: agents.filter((a) => a.status === 'running' || a.status === 'pending').length,
80
+ completed: agents.filter((a) => a.status === 'completed').length,
81
+ failed: agents.filter((a) => a.status === 'failed' || a.status === 'timeout' || a.status === 'cancelled').length,
82
+ };
83
+ }
84
+ cancel(id) {
85
+ const instance = this.agents.get(id);
86
+ if (!instance)
87
+ return;
88
+ if (instance.status !== 'running' && instance.status !== 'pending')
89
+ return;
90
+ instance.abortController.abort();
91
+ instance.status = 'cancelled';
92
+ this.saveSessionMeta(instance);
93
+ }
94
+ async retry(id) {
95
+ const instance = this.agents.get(id);
96
+ if (!instance)
97
+ throw new Error(`Agent ${id} not found`);
98
+ if (instance.status === 'running' || instance.status === 'pending') {
99
+ throw new Error(`Agent ${id} is still running`);
100
+ }
101
+ // Re-spawn with same task in the same directory
102
+ instance.status = 'pending';
103
+ instance.retryCount++;
104
+ instance.lastActivityAt = Date.now();
105
+ instance.abortController = new AbortController();
106
+ instance.result = undefined;
107
+ instance.error = undefined;
108
+ // Create a new conversation for the retry
109
+ const conv = instance.conversation.create();
110
+ instance.conversationId = conv.id;
111
+ instance.messagesCount = 0;
112
+ instance.toolCallsCount = 0;
113
+ this.saveSessionMeta(instance);
114
+ this.runAgent(instance).catch(() => { });
115
+ return id;
116
+ }
117
+ ping(id) {
118
+ const instance = this.agents.get(id);
119
+ if (!instance || instance.status !== 'running')
120
+ return;
121
+ instance.conversation.appendMessage(instance.conversationId, 'system', 'You appear to be stalled. Please continue working on your task or report your findings.');
122
+ instance.lastActivityAt = Date.now();
123
+ instance.messagesCount++;
124
+ }
125
+ prune(maxAgeMs = 30 * 60_000) {
126
+ const now = Date.now();
127
+ for (const [id, instance] of this.agents) {
128
+ if (instance.status === 'running' || instance.status === 'pending')
129
+ continue;
130
+ if (now - instance.lastActivityAt < maxAgeMs)
131
+ continue;
132
+ if (instance.cleanup === 'delete') {
133
+ try {
134
+ rmSync(instance.agentDir, { recursive: true, force: true });
135
+ }
136
+ catch {
137
+ // Ignore cleanup errors
138
+ }
139
+ }
140
+ this.agents.delete(id);
141
+ }
142
+ }
143
+ readTranscript(id) {
144
+ const instance = this.agents.get(id);
145
+ if (!instance)
146
+ return null;
147
+ return instance.conversation.getMessages(instance.conversationId);
148
+ }
149
+ async runAgent(instance) {
150
+ instance.status = 'running';
151
+ this.saveSessionMeta(instance);
152
+ // Set up timeout
153
+ const timeoutId = setTimeout(() => {
154
+ instance.abortController.abort();
155
+ }, instance.timeoutMs);
156
+ try {
157
+ // Send the task as the first message
158
+ instance.conversation.appendMessage(instance.conversationId, 'system', 'You are a sub-agent. Complete the given task and respond with your findings. Use memory_write to save important findings to your own memory.');
159
+ instance.conversation.appendMessage(instance.conversationId, 'user', instance.task);
160
+ instance.messagesCount += 2;
161
+ this.appendTranscript(instance, { role: 'system', content: 'You are a sub-agent...' });
162
+ this.appendTranscript(instance, { role: 'user', content: instance.task });
163
+ const agentTools = this.createAgentTools(instance.agentDir);
164
+ // Stream the cerebrum response
165
+ const messages = instance.conversation.getMessages(instance.conversationId);
166
+ const toolDefs = Object.fromEntries(agentTools);
167
+ let fullContent = '';
168
+ await new Promise((resolve, reject) => {
169
+ if (instance.abortController.signal.aborted) {
170
+ reject(new Error('Agent aborted'));
171
+ return;
172
+ }
173
+ const abortHandler = () => reject(new Error('Agent aborted'));
174
+ instance.abortController.signal.addEventListener('abort', abortHandler, { once: true });
175
+ this.cerebrum
176
+ .stream(messages, toolDefs, {
177
+ onChunk: (chunk) => {
178
+ fullContent += chunk;
179
+ instance.lastActivityAt = Date.now();
180
+ },
181
+ onToolCall: async (toolCall) => {
182
+ instance.lastActivityAt = Date.now();
183
+ instance.toolCallsCount++;
184
+ const tool = agentTools.get(toolCall.name);
185
+ if (!tool) {
186
+ return { callId: toolCall.id, output: `Unknown tool: ${toolCall.name}`, isError: true };
187
+ }
188
+ try {
189
+ const output = await tool.execute(toolCall.args);
190
+ const result = { callId: toolCall.id, output, isError: false };
191
+ instance.conversation.appendMessage(instance.conversationId, 'tool', output, {
192
+ toolResult: result,
193
+ });
194
+ instance.messagesCount++;
195
+ this.appendTranscript(instance, { role: 'tool', content: output, toolName: toolCall.name });
196
+ return result;
197
+ }
198
+ catch (err) {
199
+ const errMsg = err instanceof Error ? err.message : String(err);
200
+ const result = { callId: toolCall.id, output: errMsg, isError: true };
201
+ instance.conversation.appendMessage(instance.conversationId, 'tool', errMsg, {
202
+ toolResult: result,
203
+ });
204
+ instance.messagesCount++;
205
+ return result;
206
+ }
207
+ },
208
+ onFinish: (content) => {
209
+ instance.conversation.appendMessage(instance.conversationId, 'cerebrum', content);
210
+ instance.messagesCount++;
211
+ instance.result = content;
212
+ this.appendTranscript(instance, { role: 'cerebrum', content });
213
+ instance.abortController.signal.removeEventListener('abort', abortHandler);
214
+ resolve();
215
+ },
216
+ onError: (error) => {
217
+ instance.abortController.signal.removeEventListener('abort', abortHandler);
218
+ reject(error);
219
+ },
220
+ })
221
+ .catch(reject);
222
+ });
223
+ instance.status = 'completed';
224
+ }
225
+ catch (err) {
226
+ if (instance.abortController.signal.aborted) {
227
+ // Check if it was a timeout or manual cancel (status may have been
228
+ // set to 'cancelled' externally by cancel())
229
+ if (instance.status !== 'cancelled') {
230
+ instance.status = 'timeout';
231
+ }
232
+ }
233
+ else {
234
+ instance.status = 'failed';
235
+ instance.error = err instanceof Error ? err.message : String(err);
236
+ }
237
+ }
238
+ finally {
239
+ clearTimeout(timeoutId);
240
+ this.saveSessionMeta(instance);
241
+ }
242
+ }
243
+ createAgentTools(agentDir) {
244
+ const agentTools = new Map();
245
+ const memoryDir = join(agentDir, 'memory');
246
+ // Copy shared tools (shell, file ops, etc.) but NOT sub-agent tools (no recursion)
247
+ for (const [name, tool] of this.tools) {
248
+ if (name === 'spawn_agent' || name === 'query_agents' || name === 'cancel_agent') {
249
+ continue;
250
+ }
251
+ // Replace memory tools with agent-scoped versions
252
+ if (name.startsWith('memory_')) {
253
+ continue;
254
+ }
255
+ agentTools.set(name, tool);
256
+ }
257
+ // Agent-scoped memory tools
258
+ agentTools.set('memory_read', {
259
+ description: 'Read your memory file (MEMORY.md or a daily log)',
260
+ parameters: {},
261
+ execute: async (args) => {
262
+ const file = args.file ?? 'MEMORY.md';
263
+ const safeName = file.replace(/[/\\]/g, '');
264
+ const path = join(memoryDir, safeName);
265
+ if (!existsSync(path))
266
+ return `File "${file}" not found.`;
267
+ return readFileSync(path, 'utf-8') || '(empty file)';
268
+ },
269
+ });
270
+ agentTools.set('memory_write', {
271
+ description: 'Write/update your MEMORY.md file',
272
+ parameters: {},
273
+ execute: async (args) => {
274
+ const content = args.content;
275
+ writeFileSync(join(memoryDir, 'MEMORY.md'), content, 'utf-8');
276
+ return 'MEMORY.md updated successfully.';
277
+ },
278
+ });
279
+ agentTools.set('memory_log', {
280
+ description: "Append a note to today's daily log",
281
+ parameters: {},
282
+ execute: async (args) => {
283
+ const content = args.content;
284
+ const today = new Date().toISOString().slice(0, 10);
285
+ const entry = `\n---\n_${new Date().toISOString()}_\n\n${content}\n`;
286
+ appendFileSync(join(memoryDir, `${today}.md`), entry, 'utf-8');
287
+ return `Logged to ${today}.md`;
288
+ },
289
+ });
290
+ agentTools.set('memory_search', {
291
+ description: 'Search across your memory files',
292
+ parameters: {},
293
+ execute: async (args) => {
294
+ const query = args.query.toLowerCase();
295
+ const files = existsSync(memoryDir)
296
+ ? readdirSync(memoryDir).filter((f) => f.endsWith('.md'))
297
+ : [];
298
+ const results = [];
299
+ for (const file of files) {
300
+ const content = readFileSync(join(memoryDir, file), 'utf-8');
301
+ if (content.toLowerCase().includes(query)) {
302
+ const lines = content
303
+ .split('\n')
304
+ .filter((l) => l.toLowerCase().includes(query))
305
+ .slice(0, 5);
306
+ results.push(`## ${file}\n${lines.join('\n')}`);
307
+ }
308
+ }
309
+ return results.length > 0 ? results.join('\n\n') : `No matches found for "${query}"`;
310
+ },
311
+ });
312
+ return agentTools;
313
+ }
314
+ saveSessionMeta(instance) {
315
+ const meta = {
316
+ id: instance.id,
317
+ sessionKey: instance.sessionKey,
318
+ parentSessionKey: instance.parentSessionKey,
319
+ task: instance.task,
320
+ label: instance.label,
321
+ status: instance.status,
322
+ cleanup: instance.cleanup,
323
+ spawnedAt: instance.spawnedAt,
324
+ lastActivityAt: instance.lastActivityAt,
325
+ timeoutMs: instance.timeoutMs,
326
+ result: instance.result,
327
+ error: instance.error,
328
+ messagesCount: instance.messagesCount,
329
+ toolCallsCount: instance.toolCallsCount,
330
+ retryCount: instance.retryCount,
331
+ };
332
+ try {
333
+ writeFileSync(join(instance.agentDir, 'session.json'), JSON.stringify(meta, null, 2), 'utf-8');
334
+ }
335
+ catch {
336
+ // Ignore write errors
337
+ }
338
+ }
339
+ appendTranscript(instance, entry) {
340
+ const line = JSON.stringify({
341
+ ...entry,
342
+ timestamp: Date.now(),
343
+ });
344
+ try {
345
+ appendFileSync(join(instance.agentDir, 'transcript.jsonl'), line + '\n', 'utf-8');
346
+ }
347
+ catch {
348
+ // Ignore write errors
349
+ }
350
+ }
351
+ toState(instance) {
352
+ return {
353
+ id: instance.id,
354
+ sessionKey: instance.sessionKey,
355
+ parentSessionKey: instance.parentSessionKey,
356
+ task: instance.task,
357
+ label: instance.label,
358
+ status: instance.status,
359
+ cleanup: instance.cleanup,
360
+ spawnedAt: instance.spawnedAt,
361
+ lastActivityAt: instance.lastActivityAt,
362
+ timeoutMs: instance.timeoutMs,
363
+ result: instance.result,
364
+ error: instance.error,
365
+ messagesCount: instance.messagesCount,
366
+ toolCallsCount: instance.toolCallsCount,
367
+ retryCount: instance.retryCount,
368
+ memoryDir: join(instance.agentDir, 'memory'),
369
+ };
370
+ }
371
+ }
372
+ //# sourceMappingURL=sub-agent-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sub-agent-manager.js","sourceRoot":"","sources":["../src/sub-agent-manager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { ToolDefinition } from './orchestrator.js';
2
+ import type { SubAgentManager } from './sub-agent-manager.js';
3
+ export declare function createSubAgentTools(manager: SubAgentManager): Record<string, ToolDefinition>;
4
+ //# sourceMappingURL=sub-agent-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sub-agent-tools.d.ts","sourceRoot":"","sources":["../src/sub-agent-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CA2F5F"}
@@ -0,0 +1,82 @@
1
+ export function createSubAgentTools(manager) {
2
+ return {
3
+ spawn_agent: {
4
+ description: 'Spawn a sub-agent to handle a task in the background. Returns the agent ID. The sub-agent has its own isolated memory and conversation.',
5
+ parameters: {
6
+ task: { type: 'string', description: 'The task for the sub-agent to complete' },
7
+ timeoutMinutes: { type: 'number', description: 'Max lifetime in minutes (default: 5)' },
8
+ label: { type: 'string', description: 'Optional short label for the agent' },
9
+ cleanup: {
10
+ type: 'string',
11
+ description: '"delete" to remove after completion, "keep" to persist (default: delete)',
12
+ },
13
+ },
14
+ execute: async (args) => {
15
+ const { task, timeoutMinutes, label, cleanup } = args;
16
+ try {
17
+ const id = await manager.spawn(task, {
18
+ timeoutMs: (timeoutMinutes || 5) * 60_000,
19
+ label,
20
+ cleanup: cleanup === 'keep' ? 'keep' : 'delete',
21
+ });
22
+ return `Sub-agent ${id} spawned${label ? ` (${label})` : ''}. Use query_agents to check status.`;
23
+ }
24
+ catch (err) {
25
+ return `Failed to spawn agent: ${err instanceof Error ? err.message : String(err)}`;
26
+ }
27
+ },
28
+ },
29
+ query_agents: {
30
+ description: 'Query the status of all sub-agents, or a specific one by ID. Returns status, task, result, and other details.',
31
+ parameters: {
32
+ agentId: { type: 'string', description: 'Optional: query a specific agent by ID' },
33
+ },
34
+ execute: async (args) => {
35
+ const { agentId } = args;
36
+ if (agentId) {
37
+ const agent = manager.getAgent(agentId);
38
+ if (!agent)
39
+ return `Agent ${agentId} not found.`;
40
+ return JSON.stringify(agent, null, 2);
41
+ }
42
+ const agents = manager.listAgents();
43
+ if (agents.length === 0)
44
+ return 'No sub-agents.';
45
+ const summary = manager.getSummary();
46
+ const header = `${summary.total} agents: ${summary.running} running, ${summary.completed} completed, ${summary.failed} failed\n`;
47
+ const list = agents
48
+ .map((a) => {
49
+ const elapsed = Math.round((Date.now() - a.spawnedAt) / 1000);
50
+ const line = `- [${a.status}] ${a.id}${a.label ? ` (${a.label})` : ''}: ${a.task.slice(0, 80)}${a.task.length > 80 ? '...' : ''} (${elapsed}s)`;
51
+ if (a.status === 'completed' && a.result) {
52
+ return `${line}\n Result: ${a.result.slice(0, 200)}${a.result.length > 200 ? '...' : ''}`;
53
+ }
54
+ if (a.error) {
55
+ return `${line}\n Error: ${a.error}`;
56
+ }
57
+ return line;
58
+ })
59
+ .join('\n');
60
+ return header + list;
61
+ },
62
+ },
63
+ cancel_agent: {
64
+ description: 'Cancel a running sub-agent by ID.',
65
+ parameters: {
66
+ agentId: { type: 'string', description: 'The agent ID to cancel' },
67
+ },
68
+ execute: async (args) => {
69
+ const { agentId } = args;
70
+ const agent = manager.getAgent(agentId);
71
+ if (!agent)
72
+ return `Agent ${agentId} not found.`;
73
+ if (agent.status !== 'running' && agent.status !== 'pending') {
74
+ return `Agent ${agentId} is already ${agent.status}.`;
75
+ }
76
+ manager.cancel(agentId);
77
+ return `Agent ${agentId} cancelled.`;
78
+ },
79
+ },
80
+ };
81
+ }
82
+ //# sourceMappingURL=sub-agent-tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sub-agent-tools.js","sourceRoot":"","sources":["../src/sub-agent-tools.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,mBAAmB,CAAC,OAAwB;IAC1D,OAAO;QACL,WAAW,EAAE;YACX,WAAW,EACT,yIAAyI;YAC3I,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE;gBAC/E,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;gBACvF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;gBAC5E,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0EAA0E;iBACxF;aACF;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAKhD,CAAC;gBAEF,IAAI,CAAC;oBACH,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE;wBACnC,SAAS,EAAE,CAAC,cAAc,IAAI,CAAC,CAAC,GAAG,MAAM;wBACzC,KAAK;wBACL,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;qBAChD,CAAC,CAAC;oBACH,OAAO,aAAa,EAAE,WAAW,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,qCAAqC,CAAC;gBACnG,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,0BAA0B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtF,CAAC;YACH,CAAC;SACF;QAED,YAAY,EAAE;YACZ,WAAW,EACT,+GAA+G;YACjH,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE;aACnF;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,EAAE,OAAO,EAAE,GAAG,IAA4B,CAAC;gBAEjD,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;oBACxC,IAAI,CAAC,KAAK;wBAAE,OAAO,SAAS,OAAO,aAAa,CAAC;oBACjD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACxC,CAAC;gBAED,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;gBACpC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,gBAAgB,CAAC;gBAEjD,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;gBACrC,MAAM,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,YAAY,OAAO,CAAC,OAAO,aAAa,OAAO,CAAC,SAAS,eAAe,OAAO,CAAC,MAAM,WAAW,CAAC;gBAEjI,MAAM,IAAI,GAAG,MAAM;qBAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACT,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;oBAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,IAAI,CAAC;oBAChJ,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;wBACzC,OAAO,GAAG,IAAI,eAAe,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBAC7F,CAAC;oBACD,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;wBACZ,OAAO,GAAG,IAAI,cAAc,CAAC,CAAC,KAAK,EAAE,CAAC;oBACxC,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC,CAAC;qBACD,IAAI,CAAC,IAAI,CAAC,CAAC;gBAEd,OAAO,MAAM,GAAG,IAAI,CAAC;YACvB,CAAC;SACF;QAED,YAAY,EAAE;YACZ,WAAW,EAAE,mCAAmC;YAChD,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;aACnE;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,EAAE,OAAO,EAAE,GAAG,IAA2B,CAAC;gBAChD,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACxC,IAAI,CAAC,KAAK;oBAAE,OAAO,SAAS,OAAO,aAAa,CAAC;gBACjD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC7D,OAAO,SAAS,OAAO,eAAe,KAAK,CAAC,MAAM,GAAG,CAAC;gBACxD,CAAC;gBACD,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACxB,OAAO,SAAS,OAAO,aAAa,CAAC;YACvC,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}
package/dist/types.d.ts CHANGED
@@ -35,6 +35,60 @@ export interface CerebellumStatus {
35
35
  uptimeSeconds: number;
36
36
  tasksRegistered: number;
37
37
  }
38
+ export interface VerificationCheck {
39
+ name: string;
40
+ passed: boolean;
41
+ description: string;
42
+ }
43
+ export interface VerificationResult {
44
+ passed: boolean;
45
+ checks: VerificationCheck[];
46
+ modelVerdict: boolean;
47
+ toolCallId: string;
48
+ toolName: string;
49
+ }
50
+ export type SubAgentStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' | 'timeout';
51
+ export type SubAgentCleanup = 'delete' | 'keep';
52
+ export interface SubAgentState {
53
+ id: string;
54
+ sessionKey: string;
55
+ parentSessionKey: string;
56
+ task: string;
57
+ label?: string;
58
+ status: SubAgentStatus;
59
+ cleanup: SubAgentCleanup;
60
+ spawnedAt: number;
61
+ lastActivityAt: number;
62
+ timeoutMs: number;
63
+ result?: string;
64
+ error?: string;
65
+ messagesCount: number;
66
+ toolCallsCount: number;
67
+ retryCount: number;
68
+ memoryDir: string;
69
+ }
70
+ export interface SubAgentSummary {
71
+ total: number;
72
+ running: number;
73
+ completed: number;
74
+ failed: number;
75
+ }
76
+ export interface AgentHealthAction {
77
+ agentId: string;
78
+ action: 'ok' | 'ping' | 'retry' | 'cancel' | 'timeout';
79
+ reason: string;
80
+ }
81
+ export interface SystemStatus {
82
+ healthy: boolean;
83
+ modelName: string;
84
+ uptimeSeconds: number;
85
+ tasksRegistered: number;
86
+ agentsTotal: number;
87
+ agentsRunning: number;
88
+ agentsCompleted: number;
89
+ agentsFailed: number;
90
+ pendingActions: AgentHealthAction[];
91
+ }
38
92
  export interface OrchestratorConfig {
39
93
  cerebrum: {
40
94
  defaultProvider: string;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE;QACR,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,UAAU,EAAE;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cereworker/core",
3
- "version": "0.1.0",
3
+ "version": "0.3.0",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -17,7 +17,7 @@
17
17
  },
18
18
  "dependencies": {
19
19
  "nanoid": "^5.0.9",
20
- "@cereworker/config": "0.1.0"
20
+ "@cereworker/config": "0.3.0"
21
21
  },
22
22
  "devDependencies": {
23
23
  "typescript": "^5.7.3"