@cleocode/core 2026.3.71 → 2026.3.73

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 (54) hide show
  1. package/dist/cleo.d.ts.map +1 -1
  2. package/dist/hooks/handlers/agent-hooks.d.ts +48 -0
  3. package/dist/hooks/handlers/agent-hooks.d.ts.map +1 -0
  4. package/dist/hooks/handlers/context-hooks.d.ts +53 -0
  5. package/dist/hooks/handlers/context-hooks.d.ts.map +1 -0
  6. package/dist/hooks/handlers/error-hooks.d.ts +4 -4
  7. package/dist/hooks/handlers/error-hooks.d.ts.map +1 -1
  8. package/dist/hooks/handlers/file-hooks.d.ts +3 -3
  9. package/dist/hooks/handlers/file-hooks.d.ts.map +1 -1
  10. package/dist/hooks/handlers/index.d.ts +8 -1
  11. package/dist/hooks/handlers/index.d.ts.map +1 -1
  12. package/dist/hooks/handlers/mcp-hooks.d.ts +29 -7
  13. package/dist/hooks/handlers/mcp-hooks.d.ts.map +1 -1
  14. package/dist/hooks/handlers/session-hooks.d.ts +5 -5
  15. package/dist/hooks/handlers/session-hooks.d.ts.map +1 -1
  16. package/dist/hooks/handlers/task-hooks.d.ts +5 -5
  17. package/dist/hooks/handlers/task-hooks.d.ts.map +1 -1
  18. package/dist/hooks/handlers/work-capture-hooks.d.ts +7 -7
  19. package/dist/hooks/handlers/work-capture-hooks.d.ts.map +1 -1
  20. package/dist/hooks/payload-schemas.d.ts +177 -11
  21. package/dist/hooks/payload-schemas.d.ts.map +1 -1
  22. package/dist/hooks/provider-hooks.d.ts +33 -7
  23. package/dist/hooks/provider-hooks.d.ts.map +1 -1
  24. package/dist/hooks/registry.d.ts +26 -6
  25. package/dist/hooks/registry.d.ts.map +1 -1
  26. package/dist/hooks/types.d.ts +132 -38
  27. package/dist/hooks/types.d.ts.map +1 -1
  28. package/dist/index.d.ts +2 -0
  29. package/dist/index.d.ts.map +1 -1
  30. package/dist/index.js +497 -59
  31. package/dist/index.js.map +4 -4
  32. package/dist/sessions/snapshot.d.ts +125 -0
  33. package/dist/sessions/snapshot.d.ts.map +1 -0
  34. package/package.json +6 -6
  35. package/src/cleo.ts +12 -0
  36. package/src/hooks/handlers/__tests__/hook-automation-e2e.test.ts +634 -0
  37. package/src/hooks/handlers/agent-hooks.ts +148 -0
  38. package/src/hooks/handlers/context-hooks.ts +156 -0
  39. package/src/hooks/handlers/error-hooks.ts +8 -5
  40. package/src/hooks/handlers/file-hooks.ts +6 -4
  41. package/src/hooks/handlers/index.ts +12 -1
  42. package/src/hooks/handlers/mcp-hooks.ts +74 -9
  43. package/src/hooks/handlers/session-hooks.ts +7 -7
  44. package/src/hooks/handlers/task-hooks.ts +7 -7
  45. package/src/hooks/handlers/work-capture-hooks.ts +12 -12
  46. package/src/hooks/payload-schemas.ts +96 -26
  47. package/src/hooks/provider-hooks.ts +50 -9
  48. package/src/hooks/registry.ts +86 -23
  49. package/src/hooks/types.ts +175 -39
  50. package/src/index.ts +10 -0
  51. package/src/sessions/index.ts +4 -4
  52. package/src/sessions/snapshot.ts +343 -0
  53. package/src/store/json.ts +2 -2
  54. package/src/task-work/index.ts +4 -4
@@ -1 +1 @@
1
- {"version":3,"file":"cleo.d.ts","sourceRoot":"","sources":["../src/cleo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,eAAe,EAEf,eAAe,EACf,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,EACT,MAAM,qBAAqB,CAAC;AA+H7B,YAAY,EACV,QAAQ,EACR,SAAS,EACT,eAAe,EACf,eAAe,EACf,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAM7B,qBAAa,IAAI;IACf,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAE7C,OAAO;WAKM,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhF,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAK5C,IAAI,KAAK,IAAI,QAAQ,CAyDpB;IAGD,IAAI,QAAQ,IAAI,WAAW,CAiC1B;IAGD,IAAI,MAAM,IAAI,SAAS,CAetB;IAGD,IAAI,aAAa,IAAI,gBAAgB,CAapC;IAGD,IAAI,SAAS,IAAI,YAAY,CAc5B;IAGD,IAAI,OAAO,IAAI,UAAU,CAWxB;IAGD,IAAI,KAAK,IAAI,QAAQ,CAMpB;IAGD,IAAI,MAAM,IAAI,SAAS,CAgCtB;IAGD,IAAI,KAAK,IAAI,QAAQ,CAcpB;IAGD,IAAI,MAAM,IAAI,SAAS,CAmBtB;IAGD,IAAI,YAAY,IAAI,eAAe,CAOlC;IAGD,IAAI,IAAI,IAAI,OAAO,CAqBlB;CACF"}
1
+ {"version":3,"file":"cleo.d.ts","sourceRoot":"","sources":["../src/cleo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,eAAe,EAEf,eAAe,EACf,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAiI7B,YAAY,EACV,QAAQ,EACR,SAAS,EACT,eAAe,EACf,eAAe,EACf,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAM7B,qBAAa,IAAI;IACf,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAE7C,OAAO;WAKM,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhF,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAK5C,IAAI,KAAK,IAAI,QAAQ,CAyDpB;IAGD,IAAI,QAAQ,IAAI,WAAW,CA2C1B;IAGD,IAAI,MAAM,IAAI,SAAS,CAetB;IAGD,IAAI,aAAa,IAAI,gBAAgB,CAapC;IAGD,IAAI,SAAS,IAAI,YAAY,CAc5B;IAGD,IAAI,OAAO,IAAI,UAAU,CAWxB;IAGD,IAAI,KAAK,IAAI,QAAQ,CAMpB;IAGD,IAAI,MAAM,IAAI,SAAS,CAgCtB;IAGD,IAAI,KAAK,IAAI,QAAQ,CAcpB;IAGD,IAAI,MAAM,IAAI,SAAS,CAmBtB;IAGD,IAAI,YAAY,IAAI,eAAe,CAOlC;IAGD,IAAI,IAAI,IAAI,OAAO,CAqBlB;CACF"}
@@ -0,0 +1,48 @@
1
+ /**
2
+ * Agent (Subagent) Lifecycle Hook Handlers
3
+ *
4
+ * Captures SubagentStart and SubagentStop events to BRAIN so that
5
+ * multi-agent orchestration runs leave an auditable trail of which
6
+ * subagents were spawned, what tasks they were assigned, and how
7
+ * they completed.
8
+ *
9
+ * Gated behind brain.autoCapture config. Never throws — all errors are
10
+ * swallowed so that brain capture never blocks agent orchestration.
11
+ *
12
+ * Auto-registers on module load.
13
+ *
14
+ * @task T166
15
+ * @epic T134
16
+ */
17
+ import type { SubagentStartPayload, SubagentStopPayload } from '../types.js';
18
+ /**
19
+ * Handle SubagentStart — log subagent spawn as a BRAIN observation.
20
+ *
21
+ * Records the agent ID, role, and task assignment so orchestrators can
22
+ * trace which agents were active in a given session.
23
+ *
24
+ * Gated behind brain.autoCapture config. Never throws.
25
+ *
26
+ * @param projectRoot - Absolute path to the project root directory.
27
+ * @param payload - SubagentStart event payload.
28
+ *
29
+ * @task T166
30
+ * @epic T134
31
+ */
32
+ export declare function handleSubagentStart(projectRoot: string, payload: SubagentStartPayload): Promise<void>;
33
+ /**
34
+ * Handle SubagentStop — log subagent completion result as a BRAIN observation.
35
+ *
36
+ * Records the agent ID, completion status, assigned task, and optional
37
+ * summary reference so orchestrators can audit subagent outcomes.
38
+ *
39
+ * Gated behind brain.autoCapture config. Never throws.
40
+ *
41
+ * @param projectRoot - Absolute path to the project root directory.
42
+ * @param payload - SubagentStop event payload.
43
+ *
44
+ * @task T166
45
+ * @epic T134
46
+ */
47
+ export declare function handleSubagentStop(projectRoot: string, payload: SubagentStopPayload): Promise<void>;
48
+ //# sourceMappingURL=agent-hooks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/agent-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAoC7E;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAoBf"}
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Context Compaction Hook Handlers
3
+ *
4
+ * Captures PreCompact and PostCompact events to BRAIN so that agents
5
+ * can later observe when context compactions occurred and what state
6
+ * preceded them. This is especially useful for long sessions where
7
+ * context is compacted multiple times.
8
+ *
9
+ * PreCompact saves a session context snapshot before compaction begins.
10
+ * PostCompact records that compaction occurred and the resulting token counts.
11
+ *
12
+ * Gated behind brain.autoCapture config. Never throws — all errors are
13
+ * swallowed so brain capture never blocks context compaction.
14
+ *
15
+ * Auto-registers on module load.
16
+ *
17
+ * @task T166
18
+ * @epic T134
19
+ */
20
+ import type { PostCompactPayload, PreCompactPayload } from '../types.js';
21
+ /**
22
+ * Handle PreCompact — snapshot current session memory context to BRAIN.
23
+ *
24
+ * Fires immediately before context compaction begins. Records the token
25
+ * count and compaction reason so the brain retains context about what
26
+ * was in scope before compaction.
27
+ *
28
+ * Gated behind brain.autoCapture config. Never throws.
29
+ *
30
+ * @param projectRoot - Absolute path to the project root directory.
31
+ * @param payload - PreCompact event payload.
32
+ *
33
+ * @task T166
34
+ * @epic T134
35
+ */
36
+ export declare function handlePreCompact(projectRoot: string, payload: PreCompactPayload): Promise<void>;
37
+ /**
38
+ * Handle PostCompact — record compaction completion to BRAIN.
39
+ *
40
+ * Fires immediately after context compaction completes. Records the
41
+ * before/after token counts so agents can correlate observations made
42
+ * before compaction with those made after.
43
+ *
44
+ * Gated behind brain.autoCapture config. Never throws.
45
+ *
46
+ * @param projectRoot - Absolute path to the project root directory.
47
+ * @param payload - PostCompact event payload.
48
+ *
49
+ * @task T166
50
+ * @epic T134
51
+ */
52
+ export declare function handlePostCompact(projectRoot: string, payload: PostCompactPayload): Promise<void>;
53
+ //# sourceMappingURL=context-hooks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/context-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoCzE;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAsBf"}
@@ -5,14 +5,14 @@
5
5
  * Includes infinite-loop guard to prevent onError triggering onError.
6
6
  * Auto-registers on module load.
7
7
  */
8
- import type { OnErrorPayload } from '../types.js';
8
+ import type { PostToolUseFailurePayload } from '../types.js';
9
9
  /**
10
- * Handle onError - capture operation errors to BRAIN
10
+ * Handle PostToolUseFailure - capture operation errors to BRAIN
11
11
  *
12
12
  * Includes infinite-loop guard: if the payload has _fromHook marker,
13
- * the handler skips to prevent onError -> observeBrain -> onError loops.
13
+ * the handler skips to prevent PostToolUseFailure -> observeBrain -> PostToolUseFailure loops.
14
14
  * Additionally, ALL observeBrain errors are silently suppressed to prevent
15
15
  * re-entrant hook firing.
16
16
  */
17
- export declare function handleError(projectRoot: string, payload: OnErrorPayload): Promise<void>;
17
+ export declare function handleError(projectRoot: string, payload: PostToolUseFailurePayload): Promise<void>;
18
18
  //# sourceMappingURL=error-hooks.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"error-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/error-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB7F"}
1
+ {"version":3,"file":"error-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/error-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAoBf"}
@@ -9,9 +9,9 @@
9
9
  * - Config: brain.captureFiles = true (checked first)
10
10
  * - Env: CLEO_BRAIN_CAPTURE_FILES=true (overrides config)
11
11
  */
12
- import type { OnFileChangePayload } from '../types.js';
12
+ import type { NotificationPayload } from '../types.js';
13
13
  /**
14
- * Handle onFileChange - capture file changes to BRAIN
14
+ * Handle Notification (file-change variant) - capture file changes to BRAIN
15
15
  *
16
16
  * Gated behind brain.captureFiles config or CLEO_BRAIN_CAPTURE_FILES env var.
17
17
  * Env var takes precedence over config for backward compatibility.
@@ -19,5 +19,5 @@ import type { OnFileChangePayload } from '../types.js';
19
19
  * Filters out .cleo/ internal files and test temp directories.
20
20
  * Converts absolute paths to project-relative paths.
21
21
  */
22
- export declare function handleFileChange(projectRoot: string, payload: OnFileChangePayload): Promise<void>;
22
+ export declare function handleFileChange(projectRoot: string, payload: NotificationPayload): Promise<void>;
23
23
  //# sourceMappingURL=file-hooks.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"file-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/file-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAoDvD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA8Bf"}
1
+ {"version":3,"file":"file-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/file-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAoDvD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAgCf"}
@@ -3,6 +3,9 @@
3
3
  *
4
4
  * Barrel export for all hook handlers. Importing this module will
5
5
  * auto-register all handlers with the hook registry.
6
+ *
7
+ * @task T166
8
+ * @epic T134
6
9
  */
7
10
  import './session-hooks.js';
8
11
  import './task-hooks.js';
@@ -10,9 +13,13 @@ import './error-hooks.js';
10
13
  import './file-hooks.js';
11
14
  import './mcp-hooks.js';
12
15
  import './work-capture-hooks.js';
16
+ import './agent-hooks.js';
17
+ import './context-hooks.js';
18
+ export { handleSubagentStart, handleSubagentStop } from './agent-hooks.js';
19
+ export { handlePostCompact, handlePreCompact } from './context-hooks.js';
13
20
  export { handleError } from './error-hooks.js';
14
21
  export { handleFileChange } from './file-hooks.js';
15
- export { handlePromptSubmit, handleResponseComplete } from './mcp-hooks.js';
22
+ export { handlePromptSubmit, handleResponseComplete, handleSystemNotification, } from './mcp-hooks.js';
16
23
  export { handleSessionEnd, handleSessionStart } from './session-hooks.js';
17
24
  export { handleToolComplete, handleToolStart } from './task-hooks.js';
18
25
  export { handleWorkPromptSubmit, handleWorkResponseComplete } from './work-capture-hooks.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,oBAAoB,CAAC;AAC5B,OAAO,iBAAiB,CAAC;AACzB,OAAO,kBAAkB,CAAC;AAC1B,OAAO,iBAAiB,CAAC;AACzB,OAAO,gBAAgB,CAAC;AACxB,OAAO,yBAAyB,CAAC;AAEjC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,oBAAoB,CAAC;AAC5B,OAAO,iBAAiB,CAAC;AACzB,OAAO,kBAAkB,CAAC;AAC1B,OAAO,iBAAiB,CAAC;AACzB,OAAO,gBAAgB,CAAC;AACxB,OAAO,yBAAyB,CAAC;AACjC,OAAO,kBAAkB,CAAC;AAC1B,OAAO,oBAAoB,CAAC;AAE5B,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC"}
@@ -1,26 +1,48 @@
1
1
  /**
2
2
  * MCP Prompt/Response Hook Handlers - Wave 2 of T5237
3
3
  *
4
- * Handlers for onPromptSubmit and onResponseComplete events that capture
5
- * ALL gateway operations (read and write) to BRAIN.
4
+ * Handlers for onPromptSubmit, onResponseComplete, and system Notification
5
+ * events that capture ALL gateway operations (read and write) to BRAIN.
6
6
  * By default, NO brain capture (too noisy). Enable via:
7
7
  * - Config: brain.captureMcp = true (checked first)
8
8
  * - Env: CLEO_BRAIN_CAPTURE_MCP=true (overrides config)
9
9
  * Auto-registers on module load.
10
+ *
11
+ * Note: File-change Notification events (those with filePath + changeType) are
12
+ * handled by file-hooks.ts. This module handles message-bearing system
13
+ * notifications (Notification payloads with a message field).
14
+ *
15
+ * @task T166
10
16
  */
11
- import type { OnPromptSubmitPayload, OnResponseCompletePayload } from '../types.js';
17
+ import type { NotificationPayload, PromptSubmitPayload, ResponseCompletePayload } from '../types.js';
12
18
  /**
13
- * Handle onPromptSubmit - optionally capture ALL gateway prompt events to BRAIN.
19
+ * Handle PromptSubmit - optionally capture ALL gateway prompt events to BRAIN.
14
20
  *
15
21
  * No-op by default. Enable via brain.captureMcp config or CLEO_BRAIN_CAPTURE_MCP env.
16
22
  * For selective mutation-only capture, use work-capture-hooks.ts instead.
17
23
  */
18
- export declare function handlePromptSubmit(projectRoot: string, payload: OnPromptSubmitPayload): Promise<void>;
24
+ export declare function handlePromptSubmit(projectRoot: string, payload: PromptSubmitPayload): Promise<void>;
19
25
  /**
20
- * Handle onResponseComplete - optionally capture ALL gateway response events to BRAIN.
26
+ * Handle ResponseComplete - optionally capture ALL gateway response events to BRAIN.
21
27
  *
22
28
  * No-op by default. Enable via brain.captureMcp config or CLEO_BRAIN_CAPTURE_MCP env.
23
29
  * For selective mutation-only capture, use work-capture-hooks.ts instead.
24
30
  */
25
- export declare function handleResponseComplete(projectRoot: string, payload: OnResponseCompletePayload): Promise<void>;
31
+ export declare function handleResponseComplete(projectRoot: string, payload: ResponseCompletePayload): Promise<void>;
32
+ /**
33
+ * Handle Notification — capture system notifications as BRAIN observations.
34
+ *
35
+ * Only fires for Notification payloads that carry a message field (i.e. system
36
+ * notifications). File-change notifications (filePath + changeType) are
37
+ * handled exclusively by file-hooks.ts and are skipped here to avoid
38
+ * double-capture.
39
+ *
40
+ * Gated behind brain.autoCapture config. Never throws.
41
+ *
42
+ * @param projectRoot - Absolute path to the project root directory.
43
+ * @param payload - Notification event payload.
44
+ *
45
+ * @task T166
46
+ */
47
+ export declare function handleSystemNotification(projectRoot: string, payload: NotificationPayload): Promise<void>;
26
48
  //# sourceMappingURL=mcp-hooks.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"mcp-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/mcp-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AA+BpF;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAef"}
1
+ {"version":3,"file":"mcp-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/mcp-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AA+BrB;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA2Bf"}
@@ -8,19 +8,19 @@
8
8
  * T139: Regenerates bridge with session scope on start.
9
9
  * T144: Extracts transcript observations on session end.
10
10
  */
11
- import type { OnSessionEndPayload, OnSessionStartPayload } from '../types.js';
11
+ import type { SessionEndPayload, SessionStartPayload } from '../types.js';
12
12
  /**
13
- * Handle onSessionStart - capture initial session context
13
+ * Handle SessionStart - capture initial session context
14
14
  *
15
15
  * T138: Refresh memory bridge on session start.
16
16
  * T139: Regenerate bridge with session scope context.
17
17
  */
18
- export declare function handleSessionStart(projectRoot: string, payload: OnSessionStartPayload): Promise<void>;
18
+ export declare function handleSessionStart(projectRoot: string, payload: SessionStartPayload): Promise<void>;
19
19
  /**
20
- * Handle onSessionEnd - capture session summary
20
+ * Handle SessionEnd - capture session summary
21
21
  *
22
22
  * T138: Refresh memory bridge after session ends.
23
23
  * T144: Extract transcript observations via cross-provider adapter.
24
24
  */
25
- export declare function handleSessionEnd(projectRoot: string, payload: OnSessionEndPayload): Promise<void>;
25
+ export declare function handleSessionEnd(projectRoot: string, payload: SessionEndPayload): Promise<void>;
26
26
  //# sourceMappingURL=session-hooks.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"session-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/session-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAS9E;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA8Cf"}
1
+ {"version":3,"file":"session-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/session-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAS1E;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CA8Cf"}
@@ -6,15 +6,15 @@
6
6
  *
7
7
  * T138: Triggers memory bridge refresh after task completion.
8
8
  */
9
- import type { OnToolCompletePayload, OnToolStartPayload } from '../types.js';
9
+ import type { PostToolUsePayload, PreToolUsePayload } from '../types.js';
10
10
  /**
11
- * Handle onToolStart (maps to task.start in CLEO)
11
+ * Handle PreToolUse (maps to task.start in CLEO, canonical: was onToolStart)
12
12
  */
13
- export declare function handleToolStart(projectRoot: string, payload: OnToolStartPayload): Promise<void>;
13
+ export declare function handleToolStart(projectRoot: string, payload: PreToolUsePayload): Promise<void>;
14
14
  /**
15
- * Handle onToolComplete (maps to task.complete in CLEO)
15
+ * Handle PostToolUse (maps to task.complete in CLEO, canonical: was onToolComplete)
16
16
  *
17
17
  * T138: Refresh memory bridge after task completion.
18
18
  */
19
- export declare function handleToolComplete(projectRoot: string, payload: OnToolCompletePayload): Promise<void>;
19
+ export declare function handleToolComplete(projectRoot: string, payload: PostToolUsePayload): Promise<void>;
20
20
  //# sourceMappingURL=task-hooks.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"task-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/task-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAS7E;;GAEG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAgBf"}
1
+ {"version":3,"file":"task-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/task-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AASzE;;GAEG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAgBf"}
@@ -15,26 +15,26 @@
15
15
  *
16
16
  * @task T142
17
17
  */
18
- import type { OnPromptSubmitPayload, OnResponseCompletePayload } from '../types.js';
18
+ import type { PromptSubmitPayload, ResponseCompletePayload } from '../types.js';
19
19
  /**
20
- * Handle onPromptSubmit — log incoming mutation intents to BRAIN.
20
+ * Handle PromptSubmit — log incoming mutation intents to BRAIN.
21
21
  *
22
22
  * Only fires for mutate operations in CAPTURE_OPERATIONS.
23
23
  * Gated behind brain.captureWork config (or CLEO_BRAIN_CAPTURE_WORK env).
24
24
  *
25
25
  * @param projectRoot - Absolute path to the project root
26
- * @param payload - onPromptSubmit event payload
26
+ * @param payload - PromptSubmit event payload
27
27
  */
28
- export declare function handleWorkPromptSubmit(projectRoot: string, payload: OnPromptSubmitPayload): Promise<void>;
28
+ export declare function handleWorkPromptSubmit(projectRoot: string, payload: PromptSubmitPayload): Promise<void>;
29
29
  /**
30
- * Handle onResponseComplete — capture completed mutations to BRAIN.
30
+ * Handle ResponseComplete — capture completed mutations to BRAIN.
31
31
  *
32
32
  * Only fires for successful mutate operations in CAPTURE_OPERATIONS.
33
33
  * Failures are skipped — the intent was already captured by handleWorkPromptSubmit.
34
34
  * Gated behind brain.captureWork config (or CLEO_BRAIN_CAPTURE_WORK env).
35
35
  *
36
36
  * @param projectRoot - Absolute path to the project root
37
- * @param payload - onResponseComplete event payload
37
+ * @param payload - ResponseComplete event payload
38
38
  */
39
- export declare function handleWorkResponseComplete(projectRoot: string, payload: OnResponseCompletePayload): Promise<void>;
39
+ export declare function handleWorkResponseComplete(projectRoot: string, payload: ResponseCompletePayload): Promise<void>;
40
40
  //# sourceMappingURL=work-capture-hooks.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"work-capture-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/work-capture-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAkFpF;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAmBf"}
1
+ {"version":3,"file":"work-capture-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/handlers/work-capture-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAkFhF;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAmBf"}
@@ -17,7 +17,18 @@ export declare const HookPayloadSchema: z.ZodObject<{
17
17
  providerId: z.ZodOptional<z.ZodString>;
18
18
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
19
19
  }, z.core.$strip>;
20
- /** Zod schema for {@link OnSessionStartPayload}. */
20
+ /** Zod schema for {@link SessionStartPayload}. */
21
+ export declare const SessionStartPayloadSchema: z.ZodObject<{
22
+ timestamp: z.ZodISODateTime;
23
+ taskId: z.ZodOptional<z.ZodString>;
24
+ providerId: z.ZodOptional<z.ZodString>;
25
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
26
+ sessionId: z.ZodString;
27
+ name: z.ZodString;
28
+ scope: z.ZodString;
29
+ agent: z.ZodOptional<z.ZodString>;
30
+ }, z.core.$strip>;
31
+ /** @deprecated Use {@link SessionStartPayloadSchema}. Kept for backward compatibility. */
21
32
  export declare const OnSessionStartPayloadSchema: z.ZodObject<{
22
33
  timestamp: z.ZodISODateTime;
23
34
  taskId: z.ZodOptional<z.ZodString>;
@@ -28,7 +39,17 @@ export declare const OnSessionStartPayloadSchema: z.ZodObject<{
28
39
  scope: z.ZodString;
29
40
  agent: z.ZodOptional<z.ZodString>;
30
41
  }, z.core.$strip>;
31
- /** Zod schema for {@link OnSessionEndPayload}. */
42
+ /** Zod schema for {@link SessionEndPayload}. */
43
+ export declare const SessionEndPayloadSchema: z.ZodObject<{
44
+ timestamp: z.ZodISODateTime;
45
+ taskId: z.ZodOptional<z.ZodString>;
46
+ providerId: z.ZodOptional<z.ZodString>;
47
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
48
+ sessionId: z.ZodString;
49
+ duration: z.ZodNumber;
50
+ tasksCompleted: z.ZodArray<z.ZodString>;
51
+ }, z.core.$strip>;
52
+ /** @deprecated Use {@link SessionEndPayloadSchema}. Kept for backward compatibility. */
32
53
  export declare const OnSessionEndPayloadSchema: z.ZodObject<{
33
54
  timestamp: z.ZodISODateTime;
34
55
  taskId: z.ZodOptional<z.ZodString>;
@@ -38,7 +59,19 @@ export declare const OnSessionEndPayloadSchema: z.ZodObject<{
38
59
  duration: z.ZodNumber;
39
60
  tasksCompleted: z.ZodArray<z.ZodString>;
40
61
  }, z.core.$strip>;
41
- /** Zod schema for {@link OnToolStartPayload}. */
62
+ /** Zod schema for {@link PreToolUsePayload}. */
63
+ export declare const PreToolUsePayloadSchema: z.ZodObject<{
64
+ timestamp: z.ZodISODateTime;
65
+ sessionId: z.ZodOptional<z.ZodString>;
66
+ providerId: z.ZodOptional<z.ZodString>;
67
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
68
+ taskId: z.ZodString;
69
+ taskTitle: z.ZodString;
70
+ previousTask: z.ZodOptional<z.ZodString>;
71
+ toolName: z.ZodOptional<z.ZodString>;
72
+ toolInput: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
73
+ }, z.core.$strip>;
74
+ /** @deprecated Use {@link PreToolUsePayloadSchema}. Kept for backward compatibility. */
42
75
  export declare const OnToolStartPayloadSchema: z.ZodObject<{
43
76
  timestamp: z.ZodISODateTime;
44
77
  sessionId: z.ZodOptional<z.ZodString>;
@@ -47,8 +80,25 @@ export declare const OnToolStartPayloadSchema: z.ZodObject<{
47
80
  taskId: z.ZodString;
48
81
  taskTitle: z.ZodString;
49
82
  previousTask: z.ZodOptional<z.ZodString>;
83
+ toolName: z.ZodOptional<z.ZodString>;
84
+ toolInput: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
85
+ }, z.core.$strip>;
86
+ /** Zod schema for {@link PostToolUsePayload}. */
87
+ export declare const PostToolUsePayloadSchema: z.ZodObject<{
88
+ timestamp: z.ZodISODateTime;
89
+ sessionId: z.ZodOptional<z.ZodString>;
90
+ providerId: z.ZodOptional<z.ZodString>;
91
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
92
+ taskId: z.ZodString;
93
+ taskTitle: z.ZodString;
94
+ status: z.ZodEnum<{
95
+ cancelled: "cancelled";
96
+ done: "done";
97
+ archived: "archived";
98
+ }>;
99
+ toolResult: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
50
100
  }, z.core.$strip>;
51
- /** Zod schema for {@link OnToolCompletePayload}. */
101
+ /** @deprecated Use {@link PostToolUsePayloadSchema}. Kept for backward compatibility. */
52
102
  export declare const OnToolCompletePayloadSchema: z.ZodObject<{
53
103
  timestamp: z.ZodISODateTime;
54
104
  sessionId: z.ZodOptional<z.ZodString>;
@@ -61,23 +111,55 @@ export declare const OnToolCompletePayloadSchema: z.ZodObject<{
61
111
  done: "done";
62
112
  archived: "archived";
63
113
  }>;
114
+ toolResult: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
64
115
  }, z.core.$strip>;
65
- /** Zod schema for {@link OnFileChangePayload}. */
116
+ /** Zod schema for {@link NotificationPayload}. */
117
+ export declare const NotificationPayloadSchema: z.ZodObject<{
118
+ timestamp: z.ZodISODateTime;
119
+ sessionId: z.ZodOptional<z.ZodString>;
120
+ taskId: z.ZodOptional<z.ZodString>;
121
+ providerId: z.ZodOptional<z.ZodString>;
122
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
123
+ filePath: z.ZodOptional<z.ZodString>;
124
+ changeType: z.ZodOptional<z.ZodEnum<{
125
+ write: "write";
126
+ create: "create";
127
+ delete: "delete";
128
+ }>>;
129
+ sizeBytes: z.ZodOptional<z.ZodNumber>;
130
+ message: z.ZodOptional<z.ZodString>;
131
+ }, z.core.$strip>;
132
+ /** @deprecated Use {@link NotificationPayloadSchema}. Kept for backward compatibility. */
66
133
  export declare const OnFileChangePayloadSchema: z.ZodObject<{
67
134
  timestamp: z.ZodISODateTime;
68
135
  sessionId: z.ZodOptional<z.ZodString>;
69
136
  taskId: z.ZodOptional<z.ZodString>;
70
137
  providerId: z.ZodOptional<z.ZodString>;
71
138
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
72
- filePath: z.ZodString;
73
- changeType: z.ZodEnum<{
139
+ filePath: z.ZodOptional<z.ZodString>;
140
+ changeType: z.ZodOptional<z.ZodEnum<{
74
141
  write: "write";
75
142
  create: "create";
76
143
  delete: "delete";
77
- }>;
144
+ }>>;
78
145
  sizeBytes: z.ZodOptional<z.ZodNumber>;
146
+ message: z.ZodOptional<z.ZodString>;
147
+ }, z.core.$strip>;
148
+ /** Zod schema for {@link PostToolUseFailurePayload}. */
149
+ export declare const PostToolUseFailurePayloadSchema: z.ZodObject<{
150
+ timestamp: z.ZodISODateTime;
151
+ sessionId: z.ZodOptional<z.ZodString>;
152
+ taskId: z.ZodOptional<z.ZodString>;
153
+ providerId: z.ZodOptional<z.ZodString>;
154
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
155
+ errorCode: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
156
+ message: z.ZodString;
157
+ domain: z.ZodOptional<z.ZodString>;
158
+ operation: z.ZodOptional<z.ZodString>;
159
+ gateway: z.ZodOptional<z.ZodString>;
160
+ stack: z.ZodOptional<z.ZodString>;
79
161
  }, z.core.$strip>;
80
- /** Zod schema for {@link OnErrorPayload}. */
162
+ /** @deprecated Use {@link PostToolUseFailurePayloadSchema}. Kept for backward compatibility. */
81
163
  export declare const OnErrorPayloadSchema: z.ZodObject<{
82
164
  timestamp: z.ZodISODateTime;
83
165
  sessionId: z.ZodOptional<z.ZodString>;
@@ -91,7 +173,19 @@ export declare const OnErrorPayloadSchema: z.ZodObject<{
91
173
  gateway: z.ZodOptional<z.ZodString>;
92
174
  stack: z.ZodOptional<z.ZodString>;
93
175
  }, z.core.$strip>;
94
- /** Zod schema for {@link OnPromptSubmitPayload}. */
176
+ /** Zod schema for {@link PromptSubmitPayload}. */
177
+ export declare const PromptSubmitPayloadSchema: z.ZodObject<{
178
+ timestamp: z.ZodISODateTime;
179
+ sessionId: z.ZodOptional<z.ZodString>;
180
+ taskId: z.ZodOptional<z.ZodString>;
181
+ providerId: z.ZodOptional<z.ZodString>;
182
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
183
+ gateway: z.ZodString;
184
+ domain: z.ZodString;
185
+ operation: z.ZodString;
186
+ source: z.ZodOptional<z.ZodString>;
187
+ }, z.core.$strip>;
188
+ /** @deprecated Use {@link PromptSubmitPayloadSchema}. Kept for backward compatibility. */
95
189
  export declare const OnPromptSubmitPayloadSchema: z.ZodObject<{
96
190
  timestamp: z.ZodISODateTime;
97
191
  sessionId: z.ZodOptional<z.ZodString>;
@@ -103,7 +197,21 @@ export declare const OnPromptSubmitPayloadSchema: z.ZodObject<{
103
197
  operation: z.ZodString;
104
198
  source: z.ZodOptional<z.ZodString>;
105
199
  }, z.core.$strip>;
106
- /** Zod schema for {@link OnResponseCompletePayload}. */
200
+ /** Zod schema for {@link ResponseCompletePayload}. */
201
+ export declare const ResponseCompletePayloadSchema: z.ZodObject<{
202
+ timestamp: z.ZodISODateTime;
203
+ sessionId: z.ZodOptional<z.ZodString>;
204
+ taskId: z.ZodOptional<z.ZodString>;
205
+ providerId: z.ZodOptional<z.ZodString>;
206
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
207
+ gateway: z.ZodString;
208
+ domain: z.ZodString;
209
+ operation: z.ZodString;
210
+ success: z.ZodBoolean;
211
+ durationMs: z.ZodOptional<z.ZodNumber>;
212
+ errorCode: z.ZodOptional<z.ZodString>;
213
+ }, z.core.$strip>;
214
+ /** @deprecated Use {@link ResponseCompletePayloadSchema}. Kept for backward compatibility. */
107
215
  export declare const OnResponseCompletePayloadSchema: z.ZodObject<{
108
216
  timestamp: z.ZodISODateTime;
109
217
  sessionId: z.ZodOptional<z.ZodString>;
@@ -117,6 +225,64 @@ export declare const OnResponseCompletePayloadSchema: z.ZodObject<{
117
225
  durationMs: z.ZodOptional<z.ZodNumber>;
118
226
  errorCode: z.ZodOptional<z.ZodString>;
119
227
  }, z.core.$strip>;
228
+ /** Zod schema for {@link SubagentStartPayload}. */
229
+ export declare const SubagentStartPayloadSchema: z.ZodObject<{
230
+ timestamp: z.ZodISODateTime;
231
+ sessionId: z.ZodOptional<z.ZodString>;
232
+ providerId: z.ZodOptional<z.ZodString>;
233
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
234
+ agentId: z.ZodString;
235
+ role: z.ZodOptional<z.ZodString>;
236
+ taskId: z.ZodOptional<z.ZodString>;
237
+ }, z.core.$strip>;
238
+ /** Zod schema for {@link SubagentStopPayload}. */
239
+ export declare const SubagentStopPayloadSchema: z.ZodObject<{
240
+ timestamp: z.ZodISODateTime;
241
+ sessionId: z.ZodOptional<z.ZodString>;
242
+ providerId: z.ZodOptional<z.ZodString>;
243
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
244
+ agentId: z.ZodString;
245
+ status: z.ZodOptional<z.ZodEnum<{
246
+ partial: "partial";
247
+ failed: "failed";
248
+ blocked: "blocked";
249
+ complete: "complete";
250
+ }>>;
251
+ taskId: z.ZodOptional<z.ZodString>;
252
+ summary: z.ZodOptional<z.ZodString>;
253
+ }, z.core.$strip>;
254
+ /** Zod schema for {@link PreCompactPayload}. */
255
+ export declare const PreCompactPayloadSchema: z.ZodObject<{
256
+ timestamp: z.ZodISODateTime;
257
+ sessionId: z.ZodOptional<z.ZodString>;
258
+ taskId: z.ZodOptional<z.ZodString>;
259
+ providerId: z.ZodOptional<z.ZodString>;
260
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
261
+ tokensBefore: z.ZodOptional<z.ZodNumber>;
262
+ reason: z.ZodOptional<z.ZodString>;
263
+ }, z.core.$strip>;
264
+ /** Zod schema for {@link PostCompactPayload}. */
265
+ export declare const PostCompactPayloadSchema: z.ZodObject<{
266
+ timestamp: z.ZodISODateTime;
267
+ sessionId: z.ZodOptional<z.ZodString>;
268
+ taskId: z.ZodOptional<z.ZodString>;
269
+ providerId: z.ZodOptional<z.ZodString>;
270
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
271
+ tokensBefore: z.ZodOptional<z.ZodNumber>;
272
+ tokensAfter: z.ZodOptional<z.ZodNumber>;
273
+ success: z.ZodBoolean;
274
+ }, z.core.$strip>;
275
+ /** Zod schema for {@link ConfigChangePayload}. */
276
+ export declare const ConfigChangePayloadSchema: z.ZodObject<{
277
+ timestamp: z.ZodISODateTime;
278
+ sessionId: z.ZodOptional<z.ZodString>;
279
+ taskId: z.ZodOptional<z.ZodString>;
280
+ providerId: z.ZodOptional<z.ZodString>;
281
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
282
+ key: z.ZodString;
283
+ previousValue: z.ZodOptional<z.ZodUnknown>;
284
+ newValue: z.ZodOptional<z.ZodUnknown>;
285
+ }, z.core.$strip>;
120
286
  /** Zod schema for {@link OnWorkAvailablePayload}. */
121
287
  export declare const OnWorkAvailablePayloadSchema: z.ZodObject<{
122
288
  timestamp: z.ZodISODateTime;
@@ -1 +1 @@
1
- {"version":3,"file":"payload-schemas.d.ts","sourceRoot":"","sources":["../../src/hooks/payload-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB;;;;;;iBAM5B,CAAC;AAMH,oDAAoD;AACpD,eAAO,MAAM,2BAA2B;;;;;;;;;iBAKtC,CAAC;AAEH,kDAAkD;AAClD,eAAO,MAAM,yBAAyB;;;;;;;;iBAIpC,CAAC;AAEH,iDAAiD;AACjD,eAAO,MAAM,wBAAwB;;;;;;;;iBAInC,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;iBAItC,CAAC;AAEH,kDAAkD;AAClD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;iBAIpC,CAAC;AAEH,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAO/B,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,2BAA2B;;;;;;;;;;iBAKtC,CAAC;AAEH,wDAAwD;AACxD,eAAO,MAAM,+BAA+B;;;;;;;;;;;;iBAO1C,CAAC;AAMH,qDAAqD;AACrD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;iBAKvC,CAAC;AAEH,kDAAkD;AAClD,eAAO,MAAM,yBAAyB;;;;;;;;;iBAKpC,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;iBAMvC,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,2BAA2B;;;;;;;;;;iBAKtC,CAAC;AAEH,8CAA8C;AAC9C,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;iBAIhC,CAAC;AAgCH,oCAAoC;AACpC,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,4CAA4C;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,uBAAuB,CAW3F"}
1
+ {"version":3,"file":"payload-schemas.d.ts","sourceRoot":"","sources":["../../src/hooks/payload-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB;;;;;;iBAM5B,CAAC;AAMH,kDAAkD;AAClD,eAAO,MAAM,yBAAyB;;;;;;;;;iBAKpC,CAAC;AAEH,0FAA0F;AAC1F,eAAO,MAAM,2BAA2B;;;;;;;;;iBAA4B,CAAC;AAErE,gDAAgD;AAChD,eAAO,MAAM,uBAAuB;;;;;;;;iBAIlC,CAAC;AAEH,wFAAwF;AACxF,eAAO,MAAM,yBAAyB;;;;;;;;iBAA0B,CAAC;AAEjE,gDAAgD;AAChD,eAAO,MAAM,uBAAuB;;;;;;;;;;iBAMlC,CAAC;AAEH,wFAAwF;AACxF,eAAO,MAAM,wBAAwB;;;;;;;;;;iBAA0B,CAAC;AAEhE,iDAAiD;AACjD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;iBAKnC,CAAC;AAEH,yFAAyF;AACzF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;iBAA2B,CAAC;AAEpE,kDAAkD;AAClD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;iBAKpC,CAAC;AAEH,0FAA0F;AAC1F,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;iBAA4B,CAAC;AAEnE,wDAAwD;AACxD,eAAO,MAAM,+BAA+B;;;;;;;;;;;;iBAO1C,CAAC;AAEH,gGAAgG;AAChG,eAAO,MAAM,oBAAoB;;;;;;;;;;;;iBAAkC,CAAC;AAEpE,kDAAkD;AAClD,eAAO,MAAM,yBAAyB;;;;;;;;;;iBAKpC,CAAC;AAEH,0FAA0F;AAC1F,eAAO,MAAM,2BAA2B;;;;;;;;;;iBAA4B,CAAC;AAErE,sDAAsD;AACtD,eAAO,MAAM,6BAA6B;;;;;;;;;;;;iBAOxC,CAAC;AAEH,8FAA8F;AAC9F,eAAO,MAAM,+BAA+B;;;;;;;;;;;;iBAAgC,CAAC;AAE7E,mDAAmD;AACnD,eAAO,MAAM,0BAA0B;;;;;;;;iBAIrC,CAAC;AAEH,kDAAkD;AAClD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;iBAKpC,CAAC;AAEH,gDAAgD;AAChD,eAAO,MAAM,uBAAuB;;;;;;;;iBAGlC,CAAC;AAEH,iDAAiD;AACjD,eAAO,MAAM,wBAAwB;;;;;;;;;iBAInC,CAAC;AAEH,kDAAkD;AAClD,eAAO,MAAM,yBAAyB;;;;;;;;;iBAIpC,CAAC;AAMH,qDAAqD;AACrD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;iBAKvC,CAAC;AAEH,kDAAkD;AAClD,eAAO,MAAM,yBAAyB;;;;;;;;;iBAKpC,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;iBAMvC,CAAC;AAEH,oDAAoD;AACpD,eAAO,MAAM,2BAA2B;;;;;;;;;;iBAKtC,CAAC;AAEH,8CAA8C;AAC9C,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;iBAIhC,CAAC;AAuCH,oCAAoC;AACpC,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,4CAA4C;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,uBAAuB,CAW3F"}