@hybridaione/hybridclaw 0.2.3 → 0.2.7

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 (285) hide show
  1. package/.github/workflows/ci.yml +70 -0
  2. package/.husky/pre-commit +1 -0
  3. package/CHANGELOG.md +95 -0
  4. package/CONTRIBUTING.md +33 -0
  5. package/README.md +57 -19
  6. package/SECURITY.md +17 -0
  7. package/biome.json +35 -0
  8. package/config.example.json +72 -7
  9. package/container/package-lock.json +2 -2
  10. package/container/package.json +1 -1
  11. package/container/src/approval-policy.ts +1405 -0
  12. package/container/src/browser-tools.ts +672 -136
  13. package/container/src/extensions.ts +36 -12
  14. package/container/src/hybridai-client.ts +65 -16
  15. package/container/src/index.ts +463 -110
  16. package/container/src/ipc.ts +5 -3
  17. package/container/src/token-usage.ts +107 -18
  18. package/container/src/tools.ts +600 -225
  19. package/container/src/types.ts +49 -2
  20. package/container/src/web-fetch.ts +89 -32
  21. package/dist/agent.d.ts.map +1 -1
  22. package/dist/agent.js +15 -4
  23. package/dist/agent.js.map +1 -1
  24. package/dist/audit-cli.d.ts.map +1 -1
  25. package/dist/audit-cli.js +4 -2
  26. package/dist/audit-cli.js.map +1 -1
  27. package/dist/audit-events.d.ts.map +1 -1
  28. package/dist/audit-events.js +53 -3
  29. package/dist/audit-events.js.map +1 -1
  30. package/dist/audit-trail.d.ts.map +1 -1
  31. package/dist/audit-trail.js +17 -8
  32. package/dist/audit-trail.js.map +1 -1
  33. package/dist/channels/discord/attachments.d.ts.map +1 -1
  34. package/dist/channels/discord/attachments.js +14 -7
  35. package/dist/channels/discord/attachments.js.map +1 -1
  36. package/dist/channels/discord/debounce.d.ts +9 -0
  37. package/dist/channels/discord/debounce.d.ts.map +1 -0
  38. package/dist/channels/discord/debounce.js +20 -0
  39. package/dist/channels/discord/debounce.js.map +1 -0
  40. package/dist/channels/discord/delivery.d.ts +4 -1
  41. package/dist/channels/discord/delivery.d.ts.map +1 -1
  42. package/dist/channels/discord/delivery.js +24 -4
  43. package/dist/channels/discord/delivery.js.map +1 -1
  44. package/dist/channels/discord/human-delay.d.ts +16 -0
  45. package/dist/channels/discord/human-delay.d.ts.map +1 -0
  46. package/dist/channels/discord/human-delay.js +29 -0
  47. package/dist/channels/discord/human-delay.js.map +1 -0
  48. package/dist/channels/discord/inbound.d.ts +31 -0
  49. package/dist/channels/discord/inbound.d.ts.map +1 -1
  50. package/dist/channels/discord/inbound.js +156 -6
  51. package/dist/channels/discord/inbound.js.map +1 -1
  52. package/dist/channels/discord/mentions.d.ts.map +1 -1
  53. package/dist/channels/discord/mentions.js +16 -4
  54. package/dist/channels/discord/mentions.js.map +1 -1
  55. package/dist/channels/discord/presence.d.ts +33 -0
  56. package/dist/channels/discord/presence.d.ts.map +1 -0
  57. package/dist/channels/discord/presence.js +111 -0
  58. package/dist/channels/discord/presence.js.map +1 -0
  59. package/dist/channels/discord/rate-limiter.d.ts +14 -0
  60. package/dist/channels/discord/rate-limiter.d.ts.map +1 -0
  61. package/dist/channels/discord/rate-limiter.js +49 -0
  62. package/dist/channels/discord/rate-limiter.js.map +1 -0
  63. package/dist/channels/discord/reactions.d.ts +38 -0
  64. package/dist/channels/discord/reactions.d.ts.map +1 -0
  65. package/dist/channels/discord/reactions.js +151 -0
  66. package/dist/channels/discord/reactions.js.map +1 -0
  67. package/dist/channels/discord/runtime.d.ts +7 -4
  68. package/dist/channels/discord/runtime.d.ts.map +1 -1
  69. package/dist/channels/discord/runtime.js +755 -150
  70. package/dist/channels/discord/runtime.js.map +1 -1
  71. package/dist/channels/discord/stream.d.ts +4 -1
  72. package/dist/channels/discord/stream.d.ts.map +1 -1
  73. package/dist/channels/discord/stream.js +19 -12
  74. package/dist/channels/discord/stream.js.map +1 -1
  75. package/dist/channels/discord/tool-actions.d.ts.map +1 -1
  76. package/dist/channels/discord/tool-actions.js +24 -12
  77. package/dist/channels/discord/tool-actions.js.map +1 -1
  78. package/dist/channels/discord/typing.d.ts +15 -0
  79. package/dist/channels/discord/typing.d.ts.map +1 -0
  80. package/dist/channels/discord/typing.js +106 -0
  81. package/dist/channels/discord/typing.js.map +1 -0
  82. package/dist/chunk.d.ts.map +1 -1
  83. package/dist/chunk.js +4 -2
  84. package/dist/chunk.js.map +1 -1
  85. package/dist/cli.js +77 -23
  86. package/dist/cli.js.map +1 -1
  87. package/dist/config.d.ts +24 -0
  88. package/dist/config.d.ts.map +1 -1
  89. package/dist/config.js +113 -18
  90. package/dist/config.js.map +1 -1
  91. package/dist/container-runner.d.ts.map +1 -1
  92. package/dist/container-runner.js +59 -26
  93. package/dist/container-runner.js.map +1 -1
  94. package/dist/container-setup.d.ts.map +1 -1
  95. package/dist/container-setup.js +10 -9
  96. package/dist/container-setup.js.map +1 -1
  97. package/dist/conversation.d.ts +2 -2
  98. package/dist/conversation.d.ts.map +1 -1
  99. package/dist/conversation.js +1 -1
  100. package/dist/conversation.js.map +1 -1
  101. package/dist/db.d.ts +118 -2
  102. package/dist/db.d.ts.map +1 -1
  103. package/dist/db.js +1568 -50
  104. package/dist/db.js.map +1 -1
  105. package/dist/delegation-manager.d.ts.map +1 -1
  106. package/dist/delegation-manager.js +3 -2
  107. package/dist/delegation-manager.js.map +1 -1
  108. package/dist/gateway-client.d.ts +2 -2
  109. package/dist/gateway-client.d.ts.map +1 -1
  110. package/dist/gateway-client.js +10 -4
  111. package/dist/gateway-client.js.map +1 -1
  112. package/dist/gateway-service.d.ts +3 -3
  113. package/dist/gateway-service.d.ts.map +1 -1
  114. package/dist/gateway-service.js +624 -87
  115. package/dist/gateway-service.js.map +1 -1
  116. package/dist/gateway-types.d.ts +24 -0
  117. package/dist/gateway-types.d.ts.map +1 -1
  118. package/dist/gateway-types.js.map +1 -1
  119. package/dist/gateway.js +303 -26
  120. package/dist/gateway.js.map +1 -1
  121. package/dist/health.d.ts.map +1 -1
  122. package/dist/health.js +20 -10
  123. package/dist/health.js.map +1 -1
  124. package/dist/heartbeat.d.ts +4 -0
  125. package/dist/heartbeat.d.ts.map +1 -1
  126. package/dist/heartbeat.js +62 -20
  127. package/dist/heartbeat.js.map +1 -1
  128. package/dist/hybridai-bots.d.ts.map +1 -1
  129. package/dist/hybridai-bots.js +4 -2
  130. package/dist/hybridai-bots.js.map +1 -1
  131. package/dist/hybridai-models.d.ts +8 -0
  132. package/dist/hybridai-models.d.ts.map +1 -0
  133. package/dist/hybridai-models.js +94 -0
  134. package/dist/hybridai-models.js.map +1 -0
  135. package/dist/instruction-approval-audit.d.ts.map +1 -1
  136. package/dist/instruction-approval-audit.js.map +1 -1
  137. package/dist/instruction-integrity.d.ts.map +1 -1
  138. package/dist/instruction-integrity.js +8 -2
  139. package/dist/instruction-integrity.js.map +1 -1
  140. package/dist/ipc.d.ts.map +1 -1
  141. package/dist/ipc.js +6 -1
  142. package/dist/ipc.js.map +1 -1
  143. package/dist/logger.js.map +1 -1
  144. package/dist/memory-consolidation.d.ts +17 -0
  145. package/dist/memory-consolidation.d.ts.map +1 -0
  146. package/dist/memory-consolidation.js +25 -0
  147. package/dist/memory-consolidation.js.map +1 -0
  148. package/dist/memory-service.d.ts +200 -0
  149. package/dist/memory-service.d.ts.map +1 -0
  150. package/dist/memory-service.js +294 -0
  151. package/dist/memory-service.js.map +1 -0
  152. package/dist/mount-security.d.ts.map +1 -1
  153. package/dist/mount-security.js +31 -7
  154. package/dist/mount-security.js.map +1 -1
  155. package/dist/observability-ingest.d.ts.map +1 -1
  156. package/dist/observability-ingest.js +32 -11
  157. package/dist/observability-ingest.js.map +1 -1
  158. package/dist/onboarding.d.ts.map +1 -1
  159. package/dist/onboarding.js +32 -9
  160. package/dist/onboarding.js.map +1 -1
  161. package/dist/proactive-policy.d.ts.map +1 -1
  162. package/dist/proactive-policy.js +2 -1
  163. package/dist/proactive-policy.js.map +1 -1
  164. package/dist/prompt-hooks.d.ts.map +1 -1
  165. package/dist/prompt-hooks.js +11 -7
  166. package/dist/prompt-hooks.js.map +1 -1
  167. package/dist/runtime-config.d.ts +104 -1
  168. package/dist/runtime-config.d.ts.map +1 -1
  169. package/dist/runtime-config.js +503 -24
  170. package/dist/runtime-config.js.map +1 -1
  171. package/dist/scheduled-task-runner.d.ts +1 -0
  172. package/dist/scheduled-task-runner.d.ts.map +1 -1
  173. package/dist/scheduled-task-runner.js +43 -10
  174. package/dist/scheduled-task-runner.js.map +1 -1
  175. package/dist/scheduler.d.ts +43 -4
  176. package/dist/scheduler.d.ts.map +1 -1
  177. package/dist/scheduler.js +530 -56
  178. package/dist/scheduler.js.map +1 -1
  179. package/dist/session-export.d.ts +26 -0
  180. package/dist/session-export.d.ts.map +1 -0
  181. package/dist/session-export.js +149 -0
  182. package/dist/session-export.js.map +1 -0
  183. package/dist/session-maintenance.d.ts.map +1 -1
  184. package/dist/session-maintenance.js +75 -13
  185. package/dist/session-maintenance.js.map +1 -1
  186. package/dist/session-transcripts.d.ts.map +1 -1
  187. package/dist/session-transcripts.js.map +1 -1
  188. package/dist/side-effects.d.ts.map +1 -1
  189. package/dist/side-effects.js +14 -2
  190. package/dist/side-effects.js.map +1 -1
  191. package/dist/skills-guard.d.ts.map +1 -1
  192. package/dist/skills-guard.js +893 -130
  193. package/dist/skills-guard.js.map +1 -1
  194. package/dist/skills.d.ts +5 -0
  195. package/dist/skills.d.ts.map +1 -1
  196. package/dist/skills.js +29 -15
  197. package/dist/skills.js.map +1 -1
  198. package/dist/token-efficiency.d.ts.map +1 -1
  199. package/dist/token-efficiency.js.map +1 -1
  200. package/dist/tui.js +92 -11
  201. package/dist/tui.js.map +1 -1
  202. package/dist/types.d.ts +150 -0
  203. package/dist/types.d.ts.map +1 -1
  204. package/dist/types.js +24 -1
  205. package/dist/types.js.map +1 -1
  206. package/dist/update.d.ts.map +1 -1
  207. package/dist/update.js +42 -14
  208. package/dist/update.js.map +1 -1
  209. package/dist/workspace.d.ts.map +1 -1
  210. package/dist/workspace.js +49 -9
  211. package/dist/workspace.js.map +1 -1
  212. package/docs/chat.html +9 -3
  213. package/docs/index.html +72 -13
  214. package/package.json +8 -2
  215. package/src/agent.ts +31 -4
  216. package/src/audit-cli.ts +44 -16
  217. package/src/audit-events.ts +69 -5
  218. package/src/audit-trail.ts +41 -15
  219. package/src/channels/discord/attachments.ts +81 -27
  220. package/src/channels/discord/debounce.ts +25 -0
  221. package/src/channels/discord/delivery.ts +65 -14
  222. package/src/channels/discord/human-delay.ts +48 -0
  223. package/src/channels/discord/inbound.ts +190 -8
  224. package/src/channels/discord/mentions.ts +42 -18
  225. package/src/channels/discord/presence.ts +148 -0
  226. package/src/channels/discord/rate-limiter.ts +58 -0
  227. package/src/channels/discord/reactions.ts +211 -0
  228. package/src/channels/discord/runtime.ts +1161 -205
  229. package/src/channels/discord/stream.ts +85 -31
  230. package/src/channels/discord/tool-actions.ts +78 -37
  231. package/src/channels/discord/typing.ts +140 -0
  232. package/src/chunk.ts +12 -4
  233. package/src/cli.ts +174 -57
  234. package/src/config.ts +208 -36
  235. package/src/container-runner.ts +134 -42
  236. package/src/container-setup.ts +57 -22
  237. package/src/conversation.ts +9 -7
  238. package/src/db.ts +2217 -84
  239. package/src/delegation-manager.ts +6 -2
  240. package/src/gateway-client.ts +41 -17
  241. package/src/gateway-service.ts +996 -220
  242. package/src/gateway-types.ts +33 -0
  243. package/src/gateway.ts +487 -52
  244. package/src/health.ts +66 -26
  245. package/src/heartbeat.ts +99 -22
  246. package/src/hybridai-bots.ts +14 -5
  247. package/src/hybridai-models.ts +158 -0
  248. package/src/instruction-approval-audit.ts +4 -1
  249. package/src/instruction-integrity.ts +30 -9
  250. package/src/ipc.ts +23 -5
  251. package/src/logger.ts +4 -1
  252. package/src/memory-consolidation.ts +41 -0
  253. package/src/memory-service.ts +606 -0
  254. package/src/mount-security.ts +58 -13
  255. package/src/observability-ingest.ts +134 -35
  256. package/src/onboarding.ts +126 -35
  257. package/src/proactive-policy.ts +3 -1
  258. package/src/prompt-hooks.ts +42 -17
  259. package/src/runtime-config.ts +1112 -122
  260. package/src/scheduled-task-runner.ts +77 -11
  261. package/src/scheduler.ts +683 -60
  262. package/src/session-export.ts +196 -0
  263. package/src/session-maintenance.ts +125 -22
  264. package/src/session-transcripts.ts +12 -3
  265. package/src/side-effects.ts +28 -5
  266. package/src/skills-guard.ts +1067 -219
  267. package/src/skills.ts +163 -65
  268. package/src/token-efficiency.ts +31 -9
  269. package/src/tui.ts +166 -25
  270. package/src/types.ts +199 -2
  271. package/src/update.ts +79 -23
  272. package/src/workspace.ts +63 -11
  273. package/tests/approval-policy.test.ts +335 -0
  274. package/tests/discord.basic.test.ts +213 -4
  275. package/tests/discord.human-presence.test.ts +85 -0
  276. package/tests/gateway-service.media-routing.test.ts +8 -2
  277. package/tests/hybridai-client.test.ts +112 -0
  278. package/tests/hybridai-models.test.ts +46 -0
  279. package/tests/memory-service.test.ts +1114 -0
  280. package/tests/token-efficiency.basic.test.ts +8 -2
  281. package/tests/token-usage.cache.test.ts +128 -0
  282. package/vitest.e2e.config.ts +3 -1
  283. package/vitest.integration.config.ts +3 -1
  284. package/vitest.live.config.ts +3 -1
  285. package/vitest.unit.config.ts +9 -0
@@ -1,5 +1,5 @@
1
- import fs from 'fs';
2
- import path from 'path';
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
3
 
4
4
  import type { ContainerInput, ContainerOutput } from './types.js';
5
5
 
@@ -10,7 +10,9 @@ const OUTPUT_PATH = path.join(IPC_DIR, 'output.json');
10
10
  /**
11
11
  * Poll for input.json. Returns null if idle timeout expires.
12
12
  */
13
- export async function waitForInput(idleTimeoutMs: number): Promise<ContainerInput | null> {
13
+ export async function waitForInput(
14
+ idleTimeoutMs: number,
15
+ ): Promise<ContainerInput | null> {
14
16
  const pollInterval = 200;
15
17
  const deadline = Date.now() + idleTimeoutMs;
16
18
 
@@ -1,7 +1,15 @@
1
- import type { ChatCompletionResponse, ChatMessage, TokenUsageStats } from './types.js';
1
+ import type {
2
+ ChatCompletionResponse,
3
+ ChatMessage,
4
+ TokenUsageStats,
5
+ } from './types.js';
2
6
 
3
7
  const CHARS_PER_TOKEN = 4;
4
8
 
9
+ function isRecord(value: unknown): value is Record<string, unknown> {
10
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
11
+ }
12
+
5
13
  function parseUsageNumber(value: unknown): number {
6
14
  if (typeof value === 'number' && Number.isFinite(value)) {
7
15
  return Math.max(0, Math.floor(value));
@@ -13,6 +21,24 @@ function parseUsageNumber(value: unknown): number {
13
21
  return 0;
14
22
  }
15
23
 
24
+ function parseOptionalUsageNumber(value: unknown): number | undefined {
25
+ if (typeof value === 'number' && Number.isFinite(value)) {
26
+ return Math.max(0, Math.floor(value));
27
+ }
28
+ if (typeof value === 'string' && value.trim()) {
29
+ const parsed = Number.parseInt(value, 10);
30
+ if (Number.isFinite(parsed)) return Math.max(0, parsed);
31
+ }
32
+ return undefined;
33
+ }
34
+
35
+ function firstDefined(values: unknown[]): unknown {
36
+ for (const value of values) {
37
+ if (value !== undefined && value !== null) return value;
38
+ }
39
+ return undefined;
40
+ }
41
+
16
42
  export function createTokenUsageStats(): TokenUsageStats {
17
43
  return {
18
44
  modelCalls: 0,
@@ -20,6 +46,9 @@ export function createTokenUsageStats(): TokenUsageStats {
20
46
  apiPromptTokens: 0,
21
47
  apiCompletionTokens: 0,
22
48
  apiTotalTokens: 0,
49
+ apiCacheUsageAvailable: false,
50
+ apiCacheReadTokens: 0,
51
+ apiCacheWriteTokens: 0,
23
52
  estimatedPromptTokens: 0,
24
53
  estimatedCompletionTokens: 0,
25
54
  estimatedTotalTokens: 0,
@@ -56,7 +85,8 @@ export function estimateMessageTokens(messages: ChatMessage[]): number {
56
85
  total += 4;
57
86
  total += estimateTextTokens(message.role);
58
87
  total += estimateTextTokens(normalizeContentText(message.content));
59
- if (message.tool_calls) total += estimateTextTokens(JSON.stringify(message.tool_calls));
88
+ if (message.tool_calls)
89
+ total += estimateTextTokens(JSON.stringify(message.tool_calls));
60
90
  if (message.tool_call_id) total += estimateTextTokens(message.tool_call_id);
61
91
  }
62
92
  return total;
@@ -68,30 +98,89 @@ export function accumulateApiUsage(
68
98
  ): void {
69
99
  const usage = response.usage;
70
100
  if (!usage) return;
101
+ const usageRecord = isRecord(usage) ? (usage as Record<string, unknown>) : {};
102
+
103
+ const hasTokenUsageFields =
104
+ usage.prompt_tokens != null ||
105
+ usage.completion_tokens != null ||
106
+ usage.total_tokens != null ||
107
+ usage.input_tokens != null ||
108
+ usage.output_tokens != null ||
109
+ usageRecord.promptTokens != null ||
110
+ usageRecord.completionTokens != null ||
111
+ usageRecord.totalTokens != null ||
112
+ usageRecord.inputTokens != null ||
113
+ usageRecord.outputTokens != null;
114
+ const promptTokenDetails = isRecord(usage.prompt_tokens_details)
115
+ ? usage.prompt_tokens_details
116
+ : null;
117
+ const cacheReadTokens = parseOptionalUsageNumber(
118
+ firstDefined([
119
+ usageRecord.cacheRead,
120
+ usageRecord.cache_read,
121
+ usageRecord.cacheReadTokens,
122
+ usage.cache_read_tokens,
123
+ usageRecord.cacheReadInputTokens,
124
+ usage.cache_read_input_tokens,
125
+ usageRecord.cached_tokens,
126
+ usage.cached_tokens,
127
+ promptTokenDetails?.cached_tokens,
128
+ ]),
129
+ );
130
+ const cacheWriteTokens = parseOptionalUsageNumber(
131
+ firstDefined([
132
+ usageRecord.cacheWrite,
133
+ usageRecord.cache_write,
134
+ usageRecord.cacheWriteTokens,
135
+ usage.cache_write_tokens,
136
+ usageRecord.cacheWriteInputTokens,
137
+ usage.cache_write_input_tokens,
138
+ usage.cache_creation_input_tokens,
139
+ ]),
140
+ );
141
+ const hasCacheUsageFields =
142
+ cacheReadTokens !== undefined || cacheWriteTokens !== undefined;
143
+ if (!hasTokenUsageFields && !hasCacheUsageFields) return;
71
144
 
72
- const hasUsageFields =
73
- usage.prompt_tokens != null
74
- || usage.completion_tokens != null
75
- || usage.total_tokens != null
76
- || usage.input_tokens != null
77
- || usage.output_tokens != null;
78
- if (!hasUsageFields) return;
79
-
80
- const promptTokens = parseUsageNumber(usage.prompt_tokens ?? usage.input_tokens);
81
- const completionTokens = parseUsageNumber(usage.completion_tokens ?? usage.output_tokens);
82
- let totalTokens = parseUsageNumber(usage.total_tokens);
145
+ const promptTokens = parseUsageNumber(
146
+ firstDefined([
147
+ usage.prompt_tokens,
148
+ usage.input_tokens,
149
+ usageRecord.promptTokens,
150
+ usageRecord.inputTokens,
151
+ ]),
152
+ );
153
+ const completionTokens = parseUsageNumber(
154
+ firstDefined([
155
+ usage.completion_tokens,
156
+ usage.output_tokens,
157
+ usageRecord.completionTokens,
158
+ usageRecord.outputTokens,
159
+ ]),
160
+ );
161
+ let totalTokens = parseUsageNumber(
162
+ firstDefined([usage.total_tokens, usageRecord.totalTokens]),
163
+ );
83
164
  if (totalTokens === 0 && (promptTokens > 0 || completionTokens > 0)) {
84
165
  totalTokens = promptTokens + completionTokens;
85
166
  }
86
167
 
87
- stats.apiUsageAvailable = true;
88
- stats.apiPromptTokens += promptTokens;
89
- stats.apiCompletionTokens += completionTokens;
90
- stats.apiTotalTokens += totalTokens;
168
+ if (hasTokenUsageFields) {
169
+ stats.apiUsageAvailable = true;
170
+ stats.apiPromptTokens += promptTokens;
171
+ stats.apiCompletionTokens += completionTokens;
172
+ stats.apiTotalTokens += totalTokens;
173
+ }
174
+ if (hasCacheUsageFields) {
175
+ stats.apiCacheUsageAvailable = true;
176
+ stats.apiCacheReadTokens += cacheReadTokens ?? 0;
177
+ stats.apiCacheWriteTokens += cacheWriteTokens ?? 0;
178
+ }
91
179
  }
92
180
 
93
181
  export function finalizeTokenUsage(stats: TokenUsageStats): TokenUsageStats {
94
- const estimatedTotalTokens = stats.estimatedPromptTokens + stats.estimatedCompletionTokens;
182
+ const estimatedTotalTokens =
183
+ stats.estimatedPromptTokens + stats.estimatedCompletionTokens;
95
184
  let apiTotalTokens = stats.apiTotalTokens;
96
185
  if (stats.apiUsageAvailable && apiTotalTokens === 0) {
97
186
  apiTotalTokens = stats.apiPromptTokens + stats.apiCompletionTokens;