opencode-multiagent 0.4.0 → 0.6.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.
Files changed (33) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/README.md +1 -1
  3. package/README.tr.md +1 -1
  4. package/agents/brainstormer.md +113 -0
  5. package/commands/brainstorm-conclude.md +14 -0
  6. package/commands/brainstorm.md +14 -0
  7. package/defaults/opencode-multiagent.json +64 -105
  8. package/defaults/opencode-multiagent.schema.json +41 -208
  9. package/dist/index.js +251 -105
  10. package/dist/opencode-multiagent/compiler.d.ts.map +1 -1
  11. package/dist/opencode-multiagent/constants.d.ts +0 -66
  12. package/dist/opencode-multiagent/constants.d.ts.map +1 -1
  13. package/dist/opencode-multiagent/defaults.d.ts +0 -2
  14. package/dist/opencode-multiagent/defaults.d.ts.map +1 -1
  15. package/dist/opencode-multiagent/hooks.d.ts.map +1 -1
  16. package/dist/opencode-multiagent/markdown.d.ts.map +1 -1
  17. package/dist/opencode-multiagent/runtime.d.ts.map +1 -1
  18. package/dist/opencode-multiagent/supervision.d.ts +4 -0
  19. package/dist/opencode-multiagent/supervision.d.ts.map +1 -1
  20. package/dist/opencode-multiagent/task-manager.d.ts +22 -0
  21. package/dist/opencode-multiagent/task-manager.d.ts.map +1 -1
  22. package/dist/opencode-multiagent/telemetry.d.ts +6 -0
  23. package/dist/opencode-multiagent/telemetry.d.ts.map +1 -1
  24. package/dist/opencode-multiagent/tools.d.ts +11 -0
  25. package/dist/opencode-multiagent/tools.d.ts.map +1 -1
  26. package/{agents → docs}/AGENTS.md +6 -2
  27. package/docs/agents.md +107 -17
  28. package/docs/agents.tr.md +107 -17
  29. package/docs/configuration.md +24 -16
  30. package/docs/configuration.tr.md +24 -17
  31. package/docs/usage-guide.md +54 -11
  32. package/docs/usage-guide.tr.md +56 -12
  33. package/package.json +1 -1
package/dist/opencode-multiagent/markdown.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/opencode-multiagent/markdown.ts"],"names":[],"mappings":"AAGA,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA0E/C,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;UAC/B,eAAe;UAAQ,MAAM;YAAU,MAAM;IAcnF"}
1
+ {"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/opencode-multiagent/markdown.ts"],"names":[],"mappings":"AAGA,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA0E/C,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;UAC/B,eAAe;UAAQ,MAAM;YAAU,MAAM;IAgBnF"}
package/dist/opencode-multiagent/runtime.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/opencode-multiagent/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiC,MAAM,gBAAgB,CAAC;AAG7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAgBhD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC;IACnD,KAAK,EAAE,OAAO,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC,CA8BD"}
1
+ {"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/opencode-multiagent/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAehD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC;IACnD,KAAK,EAAE,OAAO,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC,CA0BD"}
package/dist/opencode-multiagent/supervision.d.ts CHANGED
@@ -6,6 +6,9 @@ type ChildInfo = {
6
6
  remindedAt: number;
7
7
  lastToolErrorAt: number;
8
8
  hasUnverifiedEdits: boolean;
9
+ startedAt: number;
10
+ timeoutMs: number;
11
+ timeoutNotifiedAt: number;
9
12
  };
10
13
  export declare const createSupervisionController: ({ flags, client, }: {
11
14
  flags: Record<string, any>;
@@ -19,6 +22,7 @@ export declare const createSupervisionController: ({ flags, client, }: {
19
22
  recordToolError: (sessionID: string) => void;
20
23
  recordVerification: (sessionID: string) => void;
21
24
  getActiveChildCount: (parentID: string) => number;
25
+ setSessionTimeout: (sessionID: string, timeoutMs: number) => void;
22
26
  getChildInfo(sessionID: string): ChildInfo | undefined;
23
27
  getParentID(sessionID: string): string | undefined;
24
28
  };
package/dist/opencode-multiagent/supervision.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"supervision.d.ts","sourceRoot":"","sources":["../../src/opencode-multiagent/supervision.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,KAAK,SAAS,GAAG;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,oBAGzC;IACD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,MAAM,EAAE,YAAY,CAAC;CACtB;+BA+ByC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,GAAG,CAAA;KAAE,KAAG,OAAO,CAAC,IAAI,CAAC;;iCAwGvD,MAAM,KAAG,IAAI;oCAKV,MAAM,KAAG,IAAI;oCAKb,MAAM,KAAG,MAAM;4BAU5B,MAAM,GAAG,SAAS,GAAG,SAAS;2BAG/B,MAAM,GAAG,MAAM,GAAG,SAAS;CAIrD,CAAC"}
1
+ {"version":3,"file":"supervision.d.ts","sourceRoot":"","sources":["../../src/opencode-multiagent/supervision.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,KAAK,SAAS,GAAG;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,oBAGzC;IACD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,MAAM,EAAE,YAAY,CAAC;CACtB;+BA+ByC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,GAAG,CAAA;KAAE,KAAG,OAAO,CAAC,IAAI,CAAC;;iCAwIvD,MAAM,KAAG,IAAI;oCAKV,MAAM,KAAG,IAAI;oCAKb,MAAM,KAAG,MAAM;mCAIhB,MAAM,aAAa,MAAM,KAAG,IAAI;4BAY5C,MAAM,GAAG,SAAS,GAAG,SAAS;2BAG/B,MAAM,GAAG,MAAM,GAAG,SAAS;CAIrD,CAAC"}
package/dist/opencode-multiagent/task-manager.d.ts CHANGED
@@ -11,7 +11,11 @@ type Task = {
11
11
  createdBy?: string;
12
12
  dependencies: string[];
13
13
  result?: string;
14
+ findings?: string;
14
15
  sessionID?: string;
16
+ retryCount: number;
17
+ maxRetries: number;
18
+ escalationModel?: string;
15
19
  createdAt: number;
16
20
  updatedAt: number;
17
21
  };
@@ -22,11 +26,14 @@ type CreateTaskInput = {
22
26
  dependencies?: string[];
23
27
  priority?: TaskPriority;
24
28
  createdBy?: string;
29
+ maxRetries?: number;
30
+ escalationModel?: string;
25
31
  };
26
32
  type UpdateTaskInput = {
27
33
  status?: TaskStatus;
28
34
  result?: string;
29
35
  assignedAgent?: string;
36
+ findings?: string;
30
37
  };
31
38
  type TaskFilter = {
32
39
  status?: string;
@@ -48,6 +55,21 @@ export declare const createTaskManager: (projectRoot?: string) => {
48
55
  load: () => Promise<void>;
49
56
  getActiveSummary: () => string;
50
57
  linkSession: (taskID: string, sessionID: string) => boolean;
58
+ getSiblingFindings: (taskID: string) => string;
59
+ getReadyTasks: () => Task[];
60
+ getDependentsOf: (taskID: string) => Task[];
61
+ listWithDepInfo: (filter?: TaskFilter) => Array<Task & {
62
+ depsMet: boolean;
63
+ unmetDeps: string[];
64
+ }>;
65
+ shouldRetry: (taskID: string) => {
66
+ retry: boolean;
67
+ escalate: boolean;
68
+ model?: string;
69
+ };
70
+ incrementRetry: (taskID: string) => Task | {
71
+ error: string;
72
+ };
51
73
  };
52
74
  export type TaskManager = ReturnType<typeof createTaskManager>;
53
75
  export {};
package/dist/opencode-multiagent/task-manager.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"task-manager.d.ts","sourceRoot":"","sources":["../../src/opencode-multiagent/task-manager.ts"],"names":[],"mappings":"AAGA,KAAK,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC7F,KAAK,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE9C,KAAK,IAAI,GAAG;IACV,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,cAAc,MAAM;oBA+F7B,eAAe,KAAG,IAAI;qBAkBrB,MAAM,SAAS,eAAe,KAAG,IAAI,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;kBA0B5D,MAAM,KAAG,IAAI,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;oBAM/B,UAAU,KAAG,IAAI,EAAE;gBAlGnB,OAAO,CAAC,IAAI,CAAC;4BA4GP,MAAM;0BAWN,MAAM,aAAa,MAAM,KAAG,OAAO;CAUjE,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
1
+ {"version":3,"file":"task-manager.d.ts","sourceRoot":"","sources":["../../src/opencode-multiagent/task-manager.ts"],"names":[],"mappings":"AAGA,KAAK,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC7F,KAAK,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE9C,KAAK,IAAI,GAAG;IACV,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,cAAc,MAAM;oBA+F7B,eAAe,KAAG,IAAI;qBAqBrB,MAAM,SAAS,eAAe,KAAG,IAAI,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;kBA2B5D,MAAM,KAAG,IAAI,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;oBAM/B,UAAU,KAAG,IAAI,EAAE;gBAtGnB,OAAO,CAAC,IAAI,CAAC;4BAgHP,MAAM;0BAgBN,MAAM,aAAa,MAAM,KAAG,OAAO;iCAS5B,MAAM,KAAG,MAAM;yBAazB,IAAI,EAAE;8BAQC,MAAM,KAAG,IAAI,EAAE;+BAId,UAAU,KAAG,KAAK,CAAC,IAAI,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;0BAOzE,MAAM,KAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;6BAQ3D,MAAM,KAAG,IAAI,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;CAgBlE,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
package/dist/opencode-multiagent/telemetry.d.ts CHANGED
@@ -9,6 +9,8 @@ type SessionTelemetryState = {
9
9
  filesEdited: number;
10
10
  tasksDispatched: number;
11
11
  permissionDenied: number;
12
+ inputTokens: number;
13
+ outputTokens: number;
12
14
  flushed: boolean;
13
15
  };
14
16
  export declare const createTelemetryController: ({ flags }: {
@@ -21,6 +23,10 @@ export declare const createTelemetryController: ({ flags }: {
21
23
  trackToolError(sessionID: string | undefined, extra?: Partial<SessionTelemetryState>): void;
22
24
  trackTaskDispatch(sessionID: string | undefined, extra?: Partial<SessionTelemetryState>): void;
23
25
  trackPermissionDenied(sessionID: string | undefined, extra?: Partial<SessionTelemetryState>): void;
26
+ trackTokenUsage(sessionID: string | undefined, usage: {
27
+ inputTokens?: number;
28
+ outputTokens?: number;
29
+ }, extra?: Partial<SessionTelemetryState>): void;
24
30
  flushSession(sessionID: string, reason?: string): Promise<void>;
25
31
  flushAll(): Promise<void>;
26
32
  };
package/dist/opencode-multiagent/telemetry.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/opencode-multiagent/telemetry.ts"],"names":[],"mappings":"AAGA,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,WAAW;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE;;+BAwClE,MAAM,GAAG,SAAS,UACtB,OAAO,CAAC,qBAAqB,CAAC,GACpC,IAAI;yBAIc,MAAM,GAAG,SAAS,GAAG,IAAI;6BAMjC,MAAM,GAAG,SAAS,UACtB,OAAO,CAAC,qBAAqB,CAAC,GACpC,IAAI;8BAMM,MAAM,GAAG,SAAS,UACtB,OAAO,CAAC,qBAAqB,CAAC,GACpC,IAAI;iCAMM,MAAM,GAAG,SAAS,UACtB,OAAO,CAAC,qBAAqB,CAAC,GACpC,IAAI;qCAMM,MAAM,GAAG,SAAS,UACtB,OAAO,CAAC,qBAAqB,CAAC,GACpC,IAAI;4BAKuB,MAAM,oBAA+B,OAAO,CAAC,IAAI,CAAC;gBAmB9D,OAAO,CAAC,IAAI,CAAC;CAOlC,CAAC"}
1
+ {"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/opencode-multiagent/telemetry.ts"],"names":[],"mappings":"AAGA,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,WAAW;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE;;+BA0ClE,MAAM,GAAG,SAAS,UACtB,OAAO,CAAC,qBAAqB,CAAC,GACpC,IAAI;yBAIc,MAAM,GAAG,SAAS,GAAG,IAAI;6BAMjC,MAAM,GAAG,SAAS,UACtB,OAAO,CAAC,qBAAqB,CAAC,GACpC,IAAI;8BAMM,MAAM,GAAG,SAAS,UACtB,OAAO,CAAC,qBAAqB,CAAC,GACpC,IAAI;iCAMM,MAAM,GAAG,SAAS,UACtB,OAAO,CAAC,qBAAqB,CAAC,GACpC,IAAI;qCAMM,MAAM,GAAG,SAAS,UACtB,OAAO,CAAC,qBAAqB,CAAC,GACpC,IAAI;+BAMM,MAAM,GAAG,SAAS,SACtB;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,UAC9C,OAAO,CAAC,qBAAqB,CAAC,GACrC,IAAI;4BAMuB,MAAM,oBAA+B,OAAO,CAAC,IAAI,CAAC;gBAqB9D,OAAO,CAAC,IAAI,CAAC;CAOlC,CAAC"}
package/dist/opencode-multiagent/tools.d.ts CHANGED
@@ -20,6 +20,8 @@ export declare const createTaskTools: (taskManager: TaskManager, taskManagerRead
20
20
  medium: "medium";
21
21
  low: "low";
22
22
  }>>;
23
+ maxRetries: import("zod").ZodOptional<import("zod").ZodNumber>;
24
+ escalationModel: import("zod").ZodOptional<import("zod").ZodString>;
23
25
  };
24
26
  execute(args: {
25
27
  title: string;
@@ -27,6 +29,8 @@ export declare const createTaskTools: (taskManager: TaskManager, taskManagerRead
27
29
  assignedAgent?: string | undefined;
28
30
  dependencies?: string[] | undefined;
29
31
  priority?: "high" | "medium" | "low" | undefined;
32
+ maxRetries?: number | undefined;
33
+ escalationModel?: string | undefined;
30
34
  }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
31
35
  };
32
36
  task_dispatch: {
@@ -53,12 +57,14 @@ export declare const createTaskTools: (taskManager: TaskManager, taskManagerRead
53
57
  completed: "completed";
54
58
  }>;
55
59
  result: import("zod").ZodOptional<import("zod").ZodString>;
60
+ findings: import("zod").ZodOptional<import("zod").ZodString>;
56
61
  force: import("zod").ZodOptional<import("zod").ZodBoolean>;
57
62
  };
58
63
  execute(args: {
59
64
  taskID: string;
60
65
  status: "blocked" | "failed" | "pending" | "claimed" | "in_progress" | "completed";
61
66
  result?: string | undefined;
67
+ findings?: string | undefined;
62
68
  force?: boolean | undefined;
63
69
  }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
64
70
  };
@@ -82,6 +88,11 @@ export declare const createTaskTools: (taskManager: TaskManager, taskManagerRead
82
88
  assignedAgent?: string | undefined;
83
89
  }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
84
90
  };
91
+ task_ready: {
92
+ description: string;
93
+ args: {};
94
+ execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
95
+ };
85
96
  };
86
97
  export {};
87
98
  //# sourceMappingURL=tools.d.ts.map
package/dist/opencode-multiagent/tools.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/opencode-multiagent/tools.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,KAAK,cAAc,GAAG;IACpB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E,CAAC;AAEF,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEzC,eAAO,MAAM,eAAe,GAC1B,aAAa,WAAW,EACxB,kBAAkB,OAAO,CAAC,IAAI,CAAC,EAC/B,cAAc,qBAAqB,EACnC,UAAU,cAAc,EACxB,QAAQ,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyJrB,CAAC"}
1
+ {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/opencode-multiagent/tools.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,KAAK,cAAc,GAAG;IACpB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E,CAAC;AAEF,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEzC,eAAO,MAAM,eAAe,GAC1B,aAAa,WAAW,EACxB,kBAAkB,OAAO,CAAC,IAAI,CAAC,EAC/B,cAAc,qBAAqB,EACnC,UAAU,cAAc,EACxB,QAAQ,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8KrB,CAAC"}
package/{agents → docs}/AGENTS.md RENAMED
@@ -61,15 +61,19 @@ The following agent names are reserved and suppressed by the plugin to prevent c
61
61
 
62
62
  Do not create agent files with these names.
63
63
 
64
- ## Current Agents (9)
64
+ ## Current Agents (10)
65
65
 
66
- **Primary:** `planner`, `executor`
66
+ **Primary:** `planner`, `executor`, `brainstormer`
67
67
 
68
68
  **Subagents:** `coder`, `ui-coder`, `sec-coder`, `reviewer`, `auditor`, `scout`, `docmaster`
69
69
 
70
70
  ## Agent Hierarchy
71
71
 
72
72
  ```
73
+ brainstormer (pre-planning exploration + idea refinement)
74
+ ├── scout (research)
75
+ └── auditor (stress-test ideas)
76
+
73
77
  planner (triage + planning + inspection)
74
78
  ├── executor (execution coordination)
75
79
  │ ├── coder (standard coding)
package/docs/agents.md CHANGED
@@ -4,12 +4,12 @@
4
4
 
5
5
  # Agent Reference
6
6
 
7
- `opencode-multiagent` ships 9 bundled agents:
7
+ `opencode-multiagent` ships 10 bundled agents:
8
8
 
9
- - 2 primary agents
9
+ - 3 primary agents
10
10
  - 7 subagents
11
11
 
12
- All bundled agents currently default to `temperature: 0`.
12
+ Most bundled agents default to `temperature: 0`. The exception is `brainstormer` which uses `temperature: 0.3` for more creative exploration.
13
13
 
14
14
  ## System Shape
15
15
 
@@ -22,6 +22,10 @@ The system is intentionally layered:
22
22
  ## High-Level Hierarchy
23
23
 
24
24
  ```text
25
+ brainstormer (pre-planning exploration + idea refinement)
26
+ ├── scout (research)
27
+ └── auditor (stress-test ideas)
28
+
25
29
  planner (triage + planning + inspection)
26
30
  ├── executor (execution coordination)
27
31
  │ ├── coder (standard coding) -> reviewer, scout
@@ -38,6 +42,15 @@ planner (triage + planning + inspection)
38
42
 
39
43
  ## Primary Agents
40
44
 
45
+ ### `brainstormer`
46
+
47
+ - Mode: `primary`
48
+ - Default model: `anthropic/claude-opus-4-6`
49
+ - Temperature: `0.3`
50
+ - Steps: `200`
51
+ - Purpose: pre-planning exploration and idea refinement
52
+ - Best for: exploring ideas with the user before planning begins, surfacing gaps and alternatives, challenging assumptions, and producing a planner-ready brief when the discussion concludes
53
+
41
54
  ### `planner`
42
55
 
43
56
  - Mode: `primary`
@@ -120,9 +133,9 @@ planner (triage + planning + inspection)
120
133
 
121
134
  ## Agent Categories at a Glance
122
135
 
123
- | Category | Agents |
124
- | --------------------- | --------------------------------- |
125
- | Primary orchestration | `planner`, `executor` |
136
+ | Category | Agents |
137
+ | --------------------- | ------------------------------------------ |
138
+ | Primary orchestration | `brainstormer`, `planner`, `executor` |
126
139
  | Coding | `coder`, `ui-coder`, `sec-coder` |
127
140
  | Quality | `reviewer`, `auditor` |
128
141
  | Research | `scout` |
@@ -130,17 +143,94 @@ planner (triage + planning + inspection)
130
143
 
131
144
  ## Summary Table
132
145
 
133
- | Agent | Category | Mode | Model | Steps | Primary use |
134
- | ----------- | ------------- | ---------- | ----------------------------- | ----- | ---------------------------------------- |
135
- | `planner` | Primary | `primary` | `anthropic/claude-opus-4-6` | `200` | Triage, planning, challenge, inspection |
136
- | `executor` | Primary | `primary` | `anthropic/claude-sonnet-4-6` | `200` | Execution orchestration |
137
- | `coder` | Coding | `subagent` | `anthropic/claude-sonnet-4-6` | `40` | Standard bounded coding work |
138
- | `ui-coder` | Coding | `subagent` | `anthropic/claude-sonnet-4-6` | `40` | UI and UX work |
139
- | `sec-coder` | Coding | `subagent` | `anthropic/claude-opus-4-6` | `60` | Security-sensitive implementation |
140
- | `reviewer` | Quality | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | Code review, QA, and validation |
141
- | `auditor` | Quality | `subagent` | `anthropic/claude-opus-4-6` | `40` | Plan gap finding before execution |
142
- | `scout` | Research | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | File discovery and external research |
143
- | `docmaster` | Documentation | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | Docs and `.magent` writing |
146
+ | Agent | Category | Mode | Model | Steps | Primary use |
147
+ | -------------- | ------------- | ---------- | ----------------------------- | ----- | ---------------------------------------- |
148
+ | `brainstormer` | Primary | `primary` | `anthropic/claude-opus-4-6` | `200` | Pre-planning exploration and ideation |
149
+ | `planner` | Primary | `primary` | `anthropic/claude-opus-4-6` | `200` | Triage, planning, challenge, inspection |
150
+ | `executor` | Primary | `primary` | `anthropic/claude-sonnet-4-6` | `200` | Execution orchestration |
151
+ | `coder` | Coding | `subagent` | `anthropic/claude-sonnet-4-6` | `40` | Standard bounded coding work |
152
+ | `ui-coder` | Coding | `subagent` | `anthropic/claude-sonnet-4-6` | `40` | UI and UX work |
153
+ | `sec-coder` | Coding | `subagent` | `anthropic/claude-opus-4-6` | `60` | Security-sensitive implementation |
154
+ | `reviewer` | Quality | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | Code review, QA, and validation |
155
+ | `auditor` | Quality | `subagent` | `anthropic/claude-opus-4-6` | `40` | Plan gap finding before execution |
156
+ | `scout` | Research | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | File discovery and external research |
157
+ | `docmaster` | Documentation | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | Docs and `.magent` writing |
158
+
159
+ ## Model Parameters
160
+
161
+ Each agent supports the following model parameters through `agentSettings`:
162
+
163
+ | Parameter | Type | Default | Description |
164
+ | ------------- | -------- | ------- | ------------------------------------------------------------------ |
165
+ | `model` | `string` | varies | Provider-qualified model ID (e.g., `anthropic/claude-opus-4-6`). |
166
+ | `temperature` | `number` | `0` | Sampling temperature (0–2). Higher values increase randomness. |
167
+ | `steps` | `number` | varies | Maximum tool-use steps the agent can take. |
168
+ | `top_p` | `number` | `1` | Top-p (nucleus) sampling parameter (0–1). |
169
+ | `options` | `object` | `{}` | Provider-specific options (e.g., thinking budget, reasoning mode). |
170
+ | `timeout_ms` | `number` | `0` | Absolute timeout in milliseconds for agent sessions. `0` = disabled. |
171
+ | `retry` | `number` | `0` | Maximum retry attempts on failure. `0` = no retry. |
172
+ | `escalation_model` | `string` | `""` | Model to escalate to when retries are exhausted. |
173
+
174
+ These parameters are applied at two layers:
175
+
176
+ 1. **Config time** — `compileAgents` writes them into the agent config
177
+ 2. **Runtime** — `chat.params` hook injects `top_p` and `options` directly into LLM call parameters
178
+
179
+ Example: enabling thinking mode for the planner agent:
180
+
181
+ ```json
182
+ {
183
+ "agentSettings": {
184
+ "planner": {
185
+ "model": "anthropic/claude-opus-4-6",
186
+ "options": {
187
+ "thinking": { "type": "enabled", "budget_tokens": 10000 }
188
+ }
189
+ }
190
+ }
191
+ }
192
+ ```
193
+
194
+ ## Agent Timeout
195
+
196
+ Each agent can have an absolute timeout via `timeout_ms`. When the elapsed time since session
197
+ creation exceeds this value, the supervision system notifies the parent session. The default
198
+ value of `0` disables the timeout entirely.
199
+
200
+ Example: limit coder sessions to 5 minutes:
201
+
202
+ ```json
203
+ {
204
+ "agentSettings": {
205
+ "coder": {
206
+ "timeout_ms": 300000
207
+ }
208
+ }
209
+ }
210
+ ```
211
+
212
+ ## Retry and Escalation
213
+
214
+ When a child session ends with a failure, the task lifecycle system can automatically retry or
215
+ escalate the task:
216
+
217
+ - **Retry** — if `retry > 0`, the task is reset to `pending` and the parent is notified to
218
+ re-dispatch. The retry count increments on each attempt.
219
+ - **Escalation** — when retries are exhausted and `escalation_model` is set, the task is reset
220
+ to `pending` with a note to re-dispatch using the escalation model.
221
+
222
+ Example: allow one retry then escalate to Opus:
223
+
224
+ ```json
225
+ {
226
+ "agentSettings": {
227
+ "coder": {
228
+ "retry": 1,
229
+ "escalation_model": "anthropic/claude-opus-4-6"
230
+ }
231
+ }
232
+ }
233
+ ```
144
234
 
145
235
  ## Related Docs
146
236
 
package/docs/agents.tr.md CHANGED
@@ -4,12 +4,12 @@
4
4
 
5
5
  # Ajan Referansı
6
6
 
7
- `opencode-multiagent`, 9 paketlenmiş ajan ile gelir:
7
+ `opencode-multiagent`, 10 paketlenmiş ajan ile gelir:
8
8
 
9
- - 2 ana ajan
9
+ - 3 ana ajan
10
10
  - 7 alt ajan
11
11
 
12
- Paketlenmiş tüm ajanlar şu anda varsayılan olarak `temperature: 0` kullanır.
12
+ Paketlenmiş ajanların çoğu varsayılan olarak `temperature: 0` kullanır. Tek istisna, daha yaratıcı keşif için `temperature: 0.3` kullanan `brainstormer` ajanıdır.
13
13
 
14
14
  ## Sistem Yapısı
15
15
 
@@ -23,6 +23,10 @@ Sistem katmanlı olacak şekilde tasarlanmıştır:
23
23
 
24
24
  ```text
25
25
  kullanici
26
+ -> brainstormer (planlama öncesi keşif + fikir olgunlaştırma)
27
+ -> scout (araştırma)
28
+ -> auditor (fikirleri stres-test)
29
+
26
30
  -> planner (triage + planlama + inspeksiyon)
27
31
  -> executor (yürütme koordinasyonu)
28
32
  -> coder (standart kodlama) -> reviewer, scout
@@ -39,6 +43,15 @@ kullanici
39
43
 
40
44
  ## Ana Ajanlar
41
45
 
46
+ ### `brainstormer`
47
+
48
+ - Mod: `primary`
49
+ - Varsayılan model: `anthropic/claude-opus-4-6`
50
+ - Temperature: `0.3`
51
+ - Steps: `200`
52
+ - Amaç: planlama öncesi keşif ve fikir olgunlaştırma
53
+ - En uygun kullanım: planlama başlamadan önce kullanıcıyla birlikte fikirleri keşfetmek, boşlukları ve alternatifleri ortaya çıkarmak, varsayımları sorgulamak ve tartışma tamamlandığında planner'a hazır bir brief üretmek
54
+
42
55
  ### `planner`
43
56
 
44
57
  - Mod: `primary`
@@ -121,9 +134,9 @@ kullanici
121
134
 
122
135
  ## Kategori Özeti
123
136
 
124
- | Kategori | Ajanlar |
125
- | ------------------- | ------------------------------------ |
126
- | Ana orkestrasyon | `planner`, `executor` |
137
+ | Kategori | Ajanlar |
138
+ | ------------------- | ---------------------------------------------- |
139
+ | Ana orkestrasyon | `brainstormer`, `planner`, `executor` |
127
140
  | Kodlama ajanları | `coder`, `ui-coder`, `sec-coder` |
128
141
  | Kalite | `reviewer`, `auditor` |
129
142
  | Araştırma | `scout` |
@@ -131,17 +144,94 @@ kullanici
131
144
 
132
145
  ## Özet Tablo
133
146
 
134
- | Agent | Kategori | Mod | Model | Steps | Ana kullanım |
135
- | ----------- | ------------- | ---------- | ----------------------------- | ----- | ------------------------------------------------------- |
136
- | `planner` | Primary | `primary` | `anthropic/claude-opus-4-6` | `200` | Triage, planlama, challenge, inspeksiyon |
137
- | `executor` | Primary | `primary` | `anthropic/claude-sonnet-4-6` | `200` | Yürütme orkestrasyonu |
138
- | `coder` | Coding | `subagent` | `anthropic/claude-sonnet-4-6` | `40` | Standart kodlama |
139
- | `ui-coder` | Coding | `subagent` | `anthropic/claude-sonnet-4-6` | `40` | UI/UX kodlama |
140
- | `sec-coder` | Coding | `subagent` | `anthropic/claude-opus-4-6` | `60` | Güvenlik hassas kodlama |
141
- | `reviewer` | Quality | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | Kod inceleme, QA, doğrulama |
142
- | `auditor` | Quality | `subagent` | `anthropic/claude-opus-4-6` | `40` | Plan açığı bulma ve denetim |
143
- | `scout` | Research | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | Dosya keşfi ve araştırma |
144
- | `docmaster` | Documentation | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | Doküman, `.magent` yazımı ve GitHub |
147
+ | Agent | Kategori | Mod | Model | Steps | Ana kullanım |
148
+ | -------------- | ------------- | ---------- | ----------------------------- | ----- | ------------------------------------------------------- |
149
+ | `brainstormer` | Primary | `primary` | `anthropic/claude-opus-4-6` | `200` | Planlama öncesi keşif ve fikir olgunlaştırma |
150
+ | `planner` | Primary | `primary` | `anthropic/claude-opus-4-6` | `200` | Triage, planlama, challenge, inspeksiyon |
151
+ | `executor` | Primary | `primary` | `anthropic/claude-sonnet-4-6` | `200` | Yürütme orkestrasyonu |
152
+ | `coder` | Coding | `subagent` | `anthropic/claude-sonnet-4-6` | `40` | Standart kodlama |
153
+ | `ui-coder` | Coding | `subagent` | `anthropic/claude-sonnet-4-6` | `40` | UI/UX kodlama |
154
+ | `sec-coder` | Coding | `subagent` | `anthropic/claude-opus-4-6` | `60` | Güvenlik hassas kodlama |
155
+ | `reviewer` | Quality | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | Kod inceleme, QA, doğrulama |
156
+ | `auditor` | Quality | `subagent` | `anthropic/claude-opus-4-6` | `40` | Plan açığı bulma ve denetim |
157
+ | `scout` | Research | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | Dosya keşfi ve araştırma |
158
+ | `docmaster` | Documentation | `subagent` | `anthropic/claude-sonnet-4-6` | `30` | Doküman, `.magent` yazımı ve GitHub |
159
+
160
+ ## Model Parametreleri
161
+
162
+ Her ajan, `agentSettings` üzerinden aşağıdaki model parametrelerini destekler:
163
+
164
+ | Parametre | Tip | Varsayılan | Açıklama |
165
+ | ------------- | -------- | ---------- | ---------------------------------------------------------------------------- |
166
+ | `model` | `string` | değişken | Provider-nitelikli model ID (ör. `anthropic/claude-opus-4-6`). |
167
+ | `temperature` | `number` | `0` | Sampling temperature (0–2). Yüksek değerler rastgeleliği artırır. |
168
+ | `steps` | `number` | değişken | Ajanın atabileceği maksimum tool-use adımı. |
169
+ | `top_p` | `number` | `1` | Top-p (nucleus) sampling parametresi (0–1). |
170
+ | `options` | `object` | `{}` | Provider'a özgü seçenekler (ör. thinking budget, reasoning mode). |
171
+ | `timeout_ms` | `number` | `0` | Ajan session'ları için mutlak timeout (milisaniye). `0` = devre dışı. |
172
+ | `retry` | `number` | `0` | Başarısızlık durumunda maksimum yeniden deneme sayısı. `0` = yeniden deneme yok. |
173
+ | `escalation_model` | `string` | `""` | Yeniden denemeler tükendiğinde yükseltilecek model. |
174
+
175
+ Bu parametreler iki katmanda uygulanır:
176
+
177
+ 1. **Config zamanı** — `compileAgents` bunları agent config'e yazar
178
+ 2. **Runtime** — `chat.params` hook'u `top_p` ve `options`'ı doğrudan LLM çağrı parametrelerine enjekte eder
179
+
180
+ Örnek: planner ajanında thinking modunu açma:
181
+
182
+ ```json
183
+ {
184
+ "agentSettings": {
185
+ "planner": {
186
+ "model": "anthropic/claude-opus-4-6",
187
+ "options": {
188
+ "thinking": { "type": "enabled", "budget_tokens": 10000 }
189
+ }
190
+ }
191
+ }
192
+ }
193
+ ```
194
+
195
+ ## Ajan Timeout
196
+
197
+ Her ajan `timeout_ms` ile mutlak bir timeout'a sahip olabilir. Session oluşturulmasından itibaren
198
+ geçen süre bu değeri aştığında, supervision sistemi parent session'ı bilgilendirir. Varsayılan
199
+ `0` değeri timeout'u tamamen devre dışı bırakır.
200
+
201
+ Örnek: coder session'larını 5 dakikayla sınırlama:
202
+
203
+ ```json
204
+ {
205
+ "agentSettings": {
206
+ "coder": {
207
+ "timeout_ms": 300000
208
+ }
209
+ }
210
+ }
211
+ ```
212
+
213
+ ## Yeniden Deneme ve Yükseltme (Retry & Escalation)
214
+
215
+ Bir child session hatayla sonlandığında, task yaşam döngüsü sistemi otomatik olarak görevi
216
+ yeniden deneyebilir veya yükseltebilir:
217
+
218
+ - **Retry** — `retry > 0` ise görev `pending` durumuna sıfırlanır ve parent yeniden dispatch
219
+ etmesi için bilgilendirilir.
220
+ - **Escalation** — yeniden denemeler tükendiğinde ve `escalation_model` tanımlıysa, görev
221
+ yükseltme modeliyle yeniden dispatch edilmesi için `pending` durumuna sıfırlanır.
222
+
223
+ Örnek: bir yeniden deneme izni verip ardından Opus'a yükseltme:
224
+
225
+ ```json
226
+ {
227
+ "agentSettings": {
228
+ "coder": {
229
+ "retry": 1,
230
+ "escalation_model": "anthropic/claude-opus-4-6"
231
+ }
232
+ }
233
+ }
234
+ ```
145
235
 
146
236
  ## İlgili Dokümanlar
147
237
 
package/docs/configuration.md CHANGED
@@ -39,8 +39,10 @@ the built-in baseline.
39
39
 
40
40
  ### Agent settings
41
41
 
42
- `agentSettings` is applied during agent compilation and only fills `model`, `temperature`, and
43
- `steps` when those fields are not already explicitly set in the host config.
42
+ `agentSettings` is applied during agent compilation and only fills `model`, `temperature`,
43
+ `steps`, `top_p`, `options`, `timeout_ms`, `retry`, and `escalation_model` when those fields are not already explicitly set in the host config.
44
+
45
+ Unrecognized agent names in `agentSettings` are logged as warnings during compilation.
44
46
 
45
47
  Practical rule:
46
48
 
@@ -129,20 +131,26 @@ This section centralizes per-agent defaults for:
129
131
  - `model`
130
132
  - `temperature`
131
133
  - `steps`
132
-
133
- All bundled agents currently default to `temperature: 0`.
134
-
135
- | Agent | Category | Default model | Steps |
136
- | ----------- | ------------- | ----------------------------- | ----- |
137
- | `planner` | Primary | `anthropic/claude-opus-4-6` | `200` |
138
- | `executor` | Primary | `anthropic/claude-sonnet-4-6` | `200` |
139
- | `coder` | Coding | `anthropic/claude-sonnet-4-6` | `40` |
140
- | `ui-coder` | Coding | `anthropic/claude-sonnet-4-6` | `40` |
141
- | `sec-coder` | Coding | `anthropic/claude-opus-4-6` | `60` |
142
- | `reviewer` | Quality | `anthropic/claude-sonnet-4-6` | `30` |
143
- | `auditor` | Quality | `anthropic/claude-opus-4-6` | `40` |
144
- | `scout` | Research | `anthropic/claude-sonnet-4-6` | `30` |
145
- | `docmaster` | Documentation | `anthropic/claude-sonnet-4-6` | `30` |
134
+ - `top_p` — top-p sampling parameter (0–1). All agents default to `1`.
135
+ - `options` — provider-specific model options (e.g., thinking budget, reasoning mode). Defaults to `{}`.
136
+ - `timeout_ms` — absolute timeout in milliseconds for agent sessions. `0` = disabled.
137
+ - `retry` — maximum retry attempts on failure. `0` = no retry.
138
+ - `escalation_model` — model to escalate to when retries are exhausted. Empty string = disabled.
139
+
140
+ Most bundled agents default to `temperature: 0`. The exception is `brainstormer` which uses `temperature: 0.3` for more creative exploration.
141
+
142
+ | Agent | Category | Default model | Steps | top_p | options | timeout_ms | retry | escalation_model |
143
+ | -------------- | ------------- | ----------------------------- | ----- | ----- | ------- | ---------- | ----- | ---------------- |
144
+ | `brainstormer` | Primary | `anthropic/claude-opus-4-6` | `200` | `1` | `{}` | `0` | `0` | |
145
+ | `planner` | Primary | `anthropic/claude-opus-4-6` | `200` | `1` | `{}` | `0` | `0` | |
146
+ | `executor` | Primary | `anthropic/claude-sonnet-4-6` | `200` | `1` | `{}` | `0` | `0` | |
147
+ | `coder` | Coding | `anthropic/claude-sonnet-4-6` | `40` | `1` | `{}` | `0` | `0` | |
148
+ | `ui-coder` | Coding | `anthropic/claude-sonnet-4-6` | `40` | `1` | `{}` | `0` | `0` | |
149
+ | `sec-coder` | Coding | `anthropic/claude-opus-4-6` | `60` | `1` | `{}` | `0` | `0` | |
150
+ | `reviewer` | Quality | `anthropic/claude-sonnet-4-6` | `30` | `1` | `{}` | `0` | `0` | |
151
+ | `auditor` | Quality | `anthropic/claude-opus-4-6` | `40` | `1` | `{}` | `0` | `0` | |
152
+ | `scout` | Research | `anthropic/claude-sonnet-4-6` | `30` | `1` | `{}` | `0` | `0` | |
153
+ | `docmaster` | Documentation | `anthropic/claude-sonnet-4-6` | `30` | `1` | `{}` | `0` | `0` | |
146
154
 
147
155
  ## `mcpDefaults`
148
156
 
package/docs/configuration.tr.md CHANGED
@@ -39,9 +39,10 @@ ayarların üstüne yazar.
39
39
 
40
40
  ### Agent ayarları
41
41
 
42
- `agentSettings`, agent compilation sırasında uygulanır ve sadece `model`, `temperature` ve
43
- `steps` alanlarını doldurur; ancak bu alanlar host config içinde zaten açıkça tanımlanmışsa
44
- dokunulmaz.
42
+ `agentSettings`, agent compilation sırasında uygulanır ve sadece `model`, `temperature`,
43
+ `steps`, `top_p`, `options`, `timeout_ms`, `retry` ve `escalation_model` alanlarını doldurur; ancak bu alanlar host config içinde zaten açıkça tanımlanmışsa dokunulmaz.
44
+
45
+ `agentSettings` içinde tanınmayan ajan adları derleme sırasında uyarı olarak loglanır.
45
46
 
46
47
  Pratik kural:
47
48
 
@@ -130,20 +131,26 @@ Bu bölüm, agent bazında şu varsayılanları merkezi olarak yönetir:
130
131
  - `model`
131
132
  - `temperature`
132
133
  - `steps`
133
-
134
- Paketlenmiş tüm agent'lar şu anda varsayılan olarak `temperature: 0` kullanır.
135
-
136
- | Agent | Kategori | Varsayılan model | Steps |
137
- | ----------- | ------------- | ----------------------------- | ----- |
138
- | `planner` | Primary | `anthropic/claude-opus-4-6` | `200` |
139
- | `executor` | Primary | `anthropic/claude-sonnet-4-6` | `200` |
140
- | `coder` | Coding | `anthropic/claude-sonnet-4-6` | `40` |
141
- | `ui-coder` | Coding | `anthropic/claude-sonnet-4-6` | `40` |
142
- | `sec-coder` | Coding | `anthropic/claude-opus-4-6` | `60` |
143
- | `reviewer` | Quality | `anthropic/claude-sonnet-4-6` | `30` |
144
- | `auditor` | Quality | `anthropic/claude-opus-4-6` | `40` |
145
- | `scout` | Research | `anthropic/claude-sonnet-4-6` | `30` |
146
- | `docmaster` | Documentation | `anthropic/claude-sonnet-4-6` | `30` |
134
+ - `top_p` — top-p sampling parametresi (0–1). Tüm ajanlar varsayılan olarak `1` kullanır.
135
+ - `options` — provider'a özgü model seçenekleri (ör. thinking budget, reasoning mode). Varsayılan: `{}`.
136
+ - `timeout_ms` — ajan session'ları için mutlak timeout (milisaniye). `0` = devre dışı.
137
+ - `retry` — başarısızlık durumunda maksimum yeniden deneme sayısı. `0` = yeniden deneme yok.
138
+ - `escalation_model` — yeniden denemeler tükendiğinde yükseltilecek model. Boş string = devre dışı.
139
+
140
+ Paketlenmiş ajanların çoğu varsayılan olarak `temperature: 0` kullanır. Tek istisna, daha yaratıcı keşif için `temperature: 0.3` kullanan `brainstormer` ajanıdır.
141
+
142
+ | Agent | Kategori | Varsayılan model | Steps | top_p | options | timeout_ms | retry | escalation_model |
143
+ | -------------- | ------------- | ----------------------------- | ----- | ----- | ------- | ---------- | ----- | ---------------- |
144
+ | `brainstormer` | Primary | `anthropic/claude-opus-4-6` | `200` | `1` | `{}` | `0` | `0` | |
145
+ | `planner` | Primary | `anthropic/claude-opus-4-6` | `200` | `1` | `{}` | `0` | `0` | |
146
+ | `executor` | Primary | `anthropic/claude-sonnet-4-6` | `200` | `1` | `{}` | `0` | `0` | |
147
+ | `coder` | Coding | `anthropic/claude-sonnet-4-6` | `40` | `1` | `{}` | `0` | `0` | |
148
+ | `ui-coder` | Coding | `anthropic/claude-sonnet-4-6` | `40` | `1` | `{}` | `0` | `0` | |
149
+ | `sec-coder` | Coding | `anthropic/claude-opus-4-6` | `60` | `1` | `{}` | `0` | `0` | |
150
+ | `reviewer` | Quality | `anthropic/claude-sonnet-4-6` | `30` | `1` | `{}` | `0` | `0` | |
151
+ | `auditor` | Quality | `anthropic/claude-opus-4-6` | `40` | `1` | `{}` | `0` | `0` | |
152
+ | `scout` | Research | `anthropic/claude-sonnet-4-6` | `30` | `1` | `{}` | `0` | `0` | |
153
+ | `docmaster` | Documentation | `anthropic/claude-sonnet-4-6` | `30` | `1` | `{}` | `0` | `0` | |
147
154
 
148
155
  ## `mcpDefaults`
149
156