@dotsetlabs/dotclaw 1.1.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 (170) hide show
  1. package/.env.example +54 -0
  2. package/LICENSE +21 -0
  3. package/README.md +111 -0
  4. package/config-examples/groups/global/CLAUDE.md +21 -0
  5. package/config-examples/groups/main/CLAUDE.md +47 -0
  6. package/config-examples/mount-allowlist.json +25 -0
  7. package/config-examples/plugin-http.json +18 -0
  8. package/config-examples/runtime.json +30 -0
  9. package/config-examples/tool-budgets.json +24 -0
  10. package/config-examples/tool-policy.json +51 -0
  11. package/container/.dockerignore +6 -0
  12. package/container/Dockerfile +74 -0
  13. package/container/agent-runner/package-lock.json +92 -0
  14. package/container/agent-runner/package.json +20 -0
  15. package/container/agent-runner/src/agent-config.ts +295 -0
  16. package/container/agent-runner/src/container-protocol.ts +73 -0
  17. package/container/agent-runner/src/daemon.ts +91 -0
  18. package/container/agent-runner/src/index.ts +1428 -0
  19. package/container/agent-runner/src/ipc.ts +321 -0
  20. package/container/agent-runner/src/memory.ts +336 -0
  21. package/container/agent-runner/src/prompt-packs.ts +341 -0
  22. package/container/agent-runner/src/tools.ts +1720 -0
  23. package/container/agent-runner/tsconfig.json +19 -0
  24. package/container/build.sh +23 -0
  25. package/container/skills/agent-browser.md +159 -0
  26. package/dist/admin-commands.d.ts +7 -0
  27. package/dist/admin-commands.d.ts.map +1 -0
  28. package/dist/admin-commands.js +87 -0
  29. package/dist/admin-commands.js.map +1 -0
  30. package/dist/agent-context.d.ts +42 -0
  31. package/dist/agent-context.d.ts.map +1 -0
  32. package/dist/agent-context.js +92 -0
  33. package/dist/agent-context.js.map +1 -0
  34. package/dist/agent-execution.d.ts +68 -0
  35. package/dist/agent-execution.d.ts.map +1 -0
  36. package/dist/agent-execution.js +169 -0
  37. package/dist/agent-execution.js.map +1 -0
  38. package/dist/agent-semaphore.d.ts +2 -0
  39. package/dist/agent-semaphore.d.ts.map +1 -0
  40. package/dist/agent-semaphore.js +52 -0
  41. package/dist/agent-semaphore.js.map +1 -0
  42. package/dist/behavior-config.d.ts +14 -0
  43. package/dist/behavior-config.d.ts.map +1 -0
  44. package/dist/behavior-config.js +52 -0
  45. package/dist/behavior-config.js.map +1 -0
  46. package/dist/cli.d.ts +3 -0
  47. package/dist/cli.d.ts.map +1 -0
  48. package/dist/cli.js +626 -0
  49. package/dist/cli.js.map +1 -0
  50. package/dist/config.d.ts +31 -0
  51. package/dist/config.d.ts.map +1 -0
  52. package/dist/config.js +38 -0
  53. package/dist/config.js.map +1 -0
  54. package/dist/container-protocol.d.ts +72 -0
  55. package/dist/container-protocol.d.ts.map +1 -0
  56. package/dist/container-protocol.js +3 -0
  57. package/dist/container-protocol.js.map +1 -0
  58. package/dist/container-runner.d.ts +59 -0
  59. package/dist/container-runner.d.ts.map +1 -0
  60. package/dist/container-runner.js +813 -0
  61. package/dist/container-runner.js.map +1 -0
  62. package/dist/cost.d.ts +9 -0
  63. package/dist/cost.d.ts.map +1 -0
  64. package/dist/cost.js +11 -0
  65. package/dist/cost.js.map +1 -0
  66. package/dist/dashboard.d.ts +58 -0
  67. package/dist/dashboard.d.ts.map +1 -0
  68. package/dist/dashboard.js +471 -0
  69. package/dist/dashboard.js.map +1 -0
  70. package/dist/db.d.ts +99 -0
  71. package/dist/db.d.ts.map +1 -0
  72. package/dist/db.js +423 -0
  73. package/dist/db.js.map +1 -0
  74. package/dist/error-messages.d.ts +17 -0
  75. package/dist/error-messages.d.ts.map +1 -0
  76. package/dist/error-messages.js +109 -0
  77. package/dist/error-messages.js.map +1 -0
  78. package/dist/index.d.ts +2 -0
  79. package/dist/index.d.ts.map +1 -0
  80. package/dist/index.js +2072 -0
  81. package/dist/index.js.map +1 -0
  82. package/dist/locks.d.ts +2 -0
  83. package/dist/locks.d.ts.map +1 -0
  84. package/dist/locks.js +26 -0
  85. package/dist/locks.js.map +1 -0
  86. package/dist/logger.d.ts +4 -0
  87. package/dist/logger.d.ts.map +1 -0
  88. package/dist/logger.js +15 -0
  89. package/dist/logger.js.map +1 -0
  90. package/dist/maintenance.d.ts +13 -0
  91. package/dist/maintenance.d.ts.map +1 -0
  92. package/dist/maintenance.js +151 -0
  93. package/dist/maintenance.js.map +1 -0
  94. package/dist/memory-embeddings.d.ts +13 -0
  95. package/dist/memory-embeddings.d.ts.map +1 -0
  96. package/dist/memory-embeddings.js +126 -0
  97. package/dist/memory-embeddings.js.map +1 -0
  98. package/dist/memory-recall.d.ts +8 -0
  99. package/dist/memory-recall.d.ts.map +1 -0
  100. package/dist/memory-recall.js +127 -0
  101. package/dist/memory-recall.js.map +1 -0
  102. package/dist/memory-store.d.ts +149 -0
  103. package/dist/memory-store.d.ts.map +1 -0
  104. package/dist/memory-store.js +787 -0
  105. package/dist/memory-store.js.map +1 -0
  106. package/dist/metrics.d.ts +12 -0
  107. package/dist/metrics.d.ts.map +1 -0
  108. package/dist/metrics.js +134 -0
  109. package/dist/metrics.js.map +1 -0
  110. package/dist/model-registry.d.ts +67 -0
  111. package/dist/model-registry.d.ts.map +1 -0
  112. package/dist/model-registry.js +230 -0
  113. package/dist/model-registry.js.map +1 -0
  114. package/dist/mount-security.d.ts +37 -0
  115. package/dist/mount-security.d.ts.map +1 -0
  116. package/dist/mount-security.js +284 -0
  117. package/dist/mount-security.js.map +1 -0
  118. package/dist/paths.d.ts +80 -0
  119. package/dist/paths.d.ts.map +1 -0
  120. package/dist/paths.js +149 -0
  121. package/dist/paths.js.map +1 -0
  122. package/dist/personalization.d.ts +6 -0
  123. package/dist/personalization.d.ts.map +1 -0
  124. package/dist/personalization.js +180 -0
  125. package/dist/personalization.js.map +1 -0
  126. package/dist/progress.d.ts +15 -0
  127. package/dist/progress.d.ts.map +1 -0
  128. package/dist/progress.js +92 -0
  129. package/dist/progress.js.map +1 -0
  130. package/dist/runtime-config.d.ts +227 -0
  131. package/dist/runtime-config.d.ts.map +1 -0
  132. package/dist/runtime-config.js +297 -0
  133. package/dist/runtime-config.js.map +1 -0
  134. package/dist/task-scheduler.d.ts +9 -0
  135. package/dist/task-scheduler.d.ts.map +1 -0
  136. package/dist/task-scheduler.js +195 -0
  137. package/dist/task-scheduler.js.map +1 -0
  138. package/dist/telegram-format.d.ts +3 -0
  139. package/dist/telegram-format.d.ts.map +1 -0
  140. package/dist/telegram-format.js +200 -0
  141. package/dist/telegram-format.js.map +1 -0
  142. package/dist/tool-budgets.d.ts +16 -0
  143. package/dist/tool-budgets.d.ts.map +1 -0
  144. package/dist/tool-budgets.js +83 -0
  145. package/dist/tool-budgets.js.map +1 -0
  146. package/dist/tool-policy.d.ts +18 -0
  147. package/dist/tool-policy.d.ts.map +1 -0
  148. package/dist/tool-policy.js +84 -0
  149. package/dist/tool-policy.js.map +1 -0
  150. package/dist/trace-writer.d.ts +39 -0
  151. package/dist/trace-writer.d.ts.map +1 -0
  152. package/dist/trace-writer.js +27 -0
  153. package/dist/trace-writer.js.map +1 -0
  154. package/dist/types.d.ts +81 -0
  155. package/dist/types.d.ts.map +1 -0
  156. package/dist/types.js +2 -0
  157. package/dist/types.js.map +1 -0
  158. package/dist/utils.d.ts +4 -0
  159. package/dist/utils.d.ts.map +1 -0
  160. package/dist/utils.js +30 -0
  161. package/dist/utils.js.map +1 -0
  162. package/launchd/com.dotclaw.plist +32 -0
  163. package/package.json +89 -0
  164. package/scripts/autotune.js +53 -0
  165. package/scripts/bootstrap.js +348 -0
  166. package/scripts/configure.js +200 -0
  167. package/scripts/doctor.js +164 -0
  168. package/scripts/init.js +209 -0
  169. package/scripts/install.sh +219 -0
  170. package/systemd/dotclaw.service +22 -0
@@ -0,0 +1,169 @@
1
+ import { buildAgentContext } from './agent-context.js';
2
+ import { runContainerAgent, writeTasksSnapshot, writeGroupsSnapshot } from './container-runner.js';
3
+ import { getAllTasks, setGroupSession, logToolCalls } from './db.js';
4
+ import { MAIN_GROUP_FOLDER } from './config.js';
5
+ import { runWithAgentSemaphore } from './agent-semaphore.js';
6
+ import { withGroupLock } from './locks.js';
7
+ import { getModelPricing } from './model-registry.js';
8
+ import { computeCostUSD } from './cost.js';
9
+ import { writeTrace } from './trace-writer.js';
10
+ import { recordLatency, recordTokenUsage, recordCost, recordMemoryRecall, recordMemoryUpsert, recordMemoryExtract, recordToolCall, recordError } from './metrics.js';
11
+ export class AgentExecutionError extends Error {
12
+ context;
13
+ constructor(message, context) {
14
+ super(message);
15
+ this.context = context;
16
+ }
17
+ }
18
+ export function createTraceBase(params) {
19
+ return {
20
+ trace_id: `trace-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
21
+ timestamp: new Date().toISOString(),
22
+ created_at: Date.now(),
23
+ chat_id: params.chatId,
24
+ group_folder: params.groupFolder,
25
+ user_id: params.userId ?? undefined,
26
+ input_text: params.inputText,
27
+ source: params.source
28
+ };
29
+ }
30
+ function buildTaskSnapshot() {
31
+ const tasks = getAllTasks();
32
+ return tasks.map(t => ({
33
+ id: t.id,
34
+ groupFolder: t.group_folder,
35
+ prompt: t.prompt,
36
+ schedule_type: t.schedule_type,
37
+ schedule_value: t.schedule_value,
38
+ status: t.status,
39
+ next_run: t.next_run,
40
+ state_json: t.state_json ?? null,
41
+ retry_count: t.retry_count ?? 0,
42
+ last_error: t.last_error ?? null
43
+ }));
44
+ }
45
+ export async function executeAgentRun(params) {
46
+ const group = params.group;
47
+ const isMain = group.folder === MAIN_GROUP_FOLDER;
48
+ const persistSession = params.persistSession !== false;
49
+ const useGroupLock = params.useGroupLock !== false;
50
+ writeTasksSnapshot(group.folder, isMain, buildTaskSnapshot());
51
+ if (isMain && params.availableGroups) {
52
+ writeGroupsSnapshot(group.folder, isMain, params.availableGroups);
53
+ }
54
+ const context = await buildAgentContext({
55
+ groupFolder: group.folder,
56
+ userId: params.userId ?? null,
57
+ recallQuery: params.recallQuery,
58
+ recallMaxResults: params.recallMaxResults,
59
+ recallMaxTokens: params.recallMaxTokens,
60
+ toolDeny: params.toolDeny
61
+ });
62
+ const runContainer = () => runContainerAgent(group, {
63
+ prompt: params.prompt,
64
+ sessionId: params.sessionId,
65
+ groupFolder: group.folder,
66
+ chatJid: params.chatJid,
67
+ isMain,
68
+ isScheduledTask: params.isScheduledTask,
69
+ isBackgroundTask: params.isBackgroundTask,
70
+ taskId: params.taskId,
71
+ userId: params.userId ?? undefined,
72
+ userName: params.userName,
73
+ memoryRecall: context.memoryRecall,
74
+ userProfile: context.userProfile,
75
+ memoryStats: context.memoryStats,
76
+ tokenEstimate: context.tokenEstimate,
77
+ toolReliability: context.toolReliability,
78
+ behaviorConfig: context.behaviorConfig,
79
+ toolPolicy: context.toolPolicy,
80
+ modelOverride: context.resolvedModel.model,
81
+ modelContextTokens: context.resolvedModel.override?.context_window,
82
+ modelMaxOutputTokens: context.resolvedModel.override?.max_output_tokens,
83
+ modelTemperature: context.resolvedModel.override?.temperature,
84
+ streaming: params.streaming
85
+ }, { abortSignal: params.abortSignal });
86
+ let output;
87
+ try {
88
+ output = await runWithAgentSemaphore(() => useGroupLock
89
+ ? withGroupLock(group.folder, () => runContainer())
90
+ : runContainer());
91
+ }
92
+ catch (err) {
93
+ const message = err instanceof Error ? err.message : String(err);
94
+ throw new AgentExecutionError(message, context);
95
+ }
96
+ if (output.newSessionId && persistSession) {
97
+ params.onSessionUpdate?.(output.newSessionId);
98
+ setGroupSession(group.folder, output.newSessionId);
99
+ }
100
+ return { output, context };
101
+ }
102
+ export function recordAgentTelemetry(params) {
103
+ const { traceBase, output, context } = params;
104
+ const pricing = output?.model
105
+ ? getModelPricing(context.modelRegistry, output.model)
106
+ : context.modelPricing;
107
+ const cost = computeCostUSD(output?.tokens_prompt, output?.tokens_completion, pricing);
108
+ writeTrace({
109
+ ...traceBase,
110
+ output_text: output?.result ?? null,
111
+ model_id: output?.model || 'unknown',
112
+ prompt_pack_versions: output?.prompt_pack_versions,
113
+ memory_summary: output?.memory_summary,
114
+ memory_facts: output?.memory_facts,
115
+ memory_recall: context.memoryRecall,
116
+ tool_calls: output?.tool_calls,
117
+ latency_ms: output?.latency_ms,
118
+ tokens_prompt: output?.tokens_prompt,
119
+ tokens_completion: output?.tokens_completion,
120
+ cost_prompt_usd: cost?.prompt,
121
+ cost_completion_usd: cost?.completion,
122
+ cost_total_usd: cost?.total,
123
+ memory_recall_count: output?.memory_recall_count,
124
+ session_recall_count: output?.session_recall_count,
125
+ memory_items_upserted: output?.memory_items_upserted,
126
+ memory_items_extracted: output?.memory_items_extracted,
127
+ error_code: params.errorMessage || (output?.status === 'error' ? output?.error : undefined)
128
+ });
129
+ if (params.errorMessage || output?.status === 'error') {
130
+ if (params.errorType) {
131
+ recordError(params.errorType);
132
+ }
133
+ }
134
+ if (params.metricsSource) {
135
+ if (output?.latency_ms) {
136
+ recordLatency(output.latency_ms);
137
+ }
138
+ if (Number.isFinite(output?.tokens_prompt) || Number.isFinite(output?.tokens_completion)) {
139
+ const modelId = output?.model || context.resolvedModel.model;
140
+ recordTokenUsage(modelId, params.metricsSource, output?.tokens_prompt || 0, output?.tokens_completion || 0);
141
+ if (cost) {
142
+ recordCost(modelId, params.metricsSource, cost.total);
143
+ }
144
+ }
145
+ if (Number.isFinite(output?.memory_recall_count)) {
146
+ recordMemoryRecall(params.metricsSource, output?.memory_recall_count || 0);
147
+ }
148
+ if (Number.isFinite(output?.memory_items_upserted)) {
149
+ recordMemoryUpsert(params.metricsSource, output?.memory_items_upserted || 0);
150
+ }
151
+ if (Number.isFinite(output?.memory_items_extracted)) {
152
+ recordMemoryExtract(params.metricsSource, output?.memory_items_extracted || 0);
153
+ }
154
+ }
155
+ if (output?.tool_calls && output.tool_calls.length > 0) {
156
+ logToolCalls({
157
+ traceId: traceBase.trace_id,
158
+ chatJid: traceBase.chat_id,
159
+ groupFolder: traceBase.group_folder,
160
+ userId: traceBase.user_id ?? null,
161
+ toolCalls: output.tool_calls,
162
+ source: params.toolAuditSource
163
+ });
164
+ for (const call of output.tool_calls) {
165
+ recordToolCall(call.name, call.ok);
166
+ }
167
+ }
168
+ }
169
+ //# sourceMappingURL=agent-execution.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-execution.js","sourceRoot":"","sources":["../src/agent-execution.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export declare function runWithAgentSemaphore<T>(fn: () => Promise<T>): Promise<T>;
2
+ //# sourceMappingURL=agent-semaphore.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-semaphore.d.ts","sourceRoot":"","sources":["../src/agent-semaphore.ts"],"names":[],"mappings":"AAkDA,wBAAsB,qBAAqB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAU/E"}
@@ -0,0 +1,52 @@
1
+ import { AGENT_QUEUE_TIMEOUT_MS, MAX_CONCURRENT_AGENTS } from './config.js';
2
+ class AsyncSemaphore {
3
+ available;
4
+ queue = [];
5
+ constructor(limit) {
6
+ this.available = Number.isFinite(limit) && limit > 0 ? limit : Infinity;
7
+ }
8
+ async acquire(timeoutMs) {
9
+ if (this.available > 0) {
10
+ this.available -= 1;
11
+ return () => this.release();
12
+ }
13
+ return new Promise((resolve, reject) => {
14
+ const entry = { resolve, reject };
15
+ if (timeoutMs && timeoutMs > 0) {
16
+ entry.timeout = setTimeout(() => {
17
+ const idx = this.queue.indexOf(entry);
18
+ if (idx >= 0)
19
+ this.queue.splice(idx, 1);
20
+ reject(new Error(`Agent queue timeout after ${timeoutMs}ms`));
21
+ }, timeoutMs);
22
+ }
23
+ this.queue.push(entry);
24
+ });
25
+ }
26
+ release() {
27
+ if (this.queue.length === 0) {
28
+ this.available += 1;
29
+ return;
30
+ }
31
+ const next = this.queue.shift();
32
+ if (!next)
33
+ return;
34
+ if (next.timeout)
35
+ clearTimeout(next.timeout);
36
+ next.resolve(() => this.release());
37
+ }
38
+ }
39
+ const semaphore = new AsyncSemaphore(MAX_CONCURRENT_AGENTS);
40
+ export async function runWithAgentSemaphore(fn) {
41
+ if (!Number.isFinite(MAX_CONCURRENT_AGENTS) || MAX_CONCURRENT_AGENTS <= 0) {
42
+ return fn();
43
+ }
44
+ const release = await semaphore.acquire(AGENT_QUEUE_TIMEOUT_MS);
45
+ try {
46
+ return await fn();
47
+ }
48
+ finally {
49
+ release();
50
+ }
51
+ }
52
+ //# sourceMappingURL=agent-semaphore.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-semaphore.js","sourceRoot":"","sources":["../src/agent-semaphore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAS5E,MAAM,cAAc;IACV,SAAS,CAAS;IACT,KAAK,GAAiB,EAAE,CAAC;IAE1C,YAAY,KAAa;QACvB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,SAAkB;QAC9B,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;YACpB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;QAED,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,MAAM,KAAK,GAAe,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YAC9C,IAAI,SAAS,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBAC/B,KAAK,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;oBACtC,IAAI,GAAG,IAAI,CAAC;wBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;oBACxC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,SAAS,IAAI,CAAC,CAAC,CAAC;gBAChE,CAAC,EAAE,SAAS,CAAC,CAAC;YAChB,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,OAAO;QACb,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,IAAI,CAAC,OAAO;YAAE,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC,qBAAqB,CAAC,CAAC;AAE5D,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAI,EAAoB;IACjE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,qBAAqB,IAAI,CAAC,EAAE,CAAC;QAC1E,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAChE,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}
@@ -0,0 +1,14 @@
1
+ export type ResponseStyle = 'concise' | 'balanced' | 'detailed';
2
+ export interface BehaviorConfig {
3
+ tool_calling_bias: number;
4
+ memory_importance_threshold: number;
5
+ response_style: ResponseStyle;
6
+ caution_bias: number;
7
+ last_updated: string;
8
+ notes?: string;
9
+ }
10
+ export declare function getBehaviorConfigPath(): string;
11
+ export declare function loadBehaviorConfig(): BehaviorConfig;
12
+ export declare function saveBehaviorConfig(config: BehaviorConfig): void;
13
+ export declare function adjustBehaviorConfig(config: BehaviorConfig, updates: Partial<BehaviorConfig>): BehaviorConfig;
14
+ //# sourceMappingURL=behavior-config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"behavior-config.d.ts","sourceRoot":"","sources":["../src/behavior-config.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2BAA2B,EAAE,MAAM,CAAC;IACpC,cAAc,EAAE,aAAa,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAgB,kBAAkB,IAAI,cAAc,CAYnD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAE/D;AAYD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAW7G"}
@@ -0,0 +1,52 @@
1
+ import { BEHAVIOR_CONFIG_PATH } from './paths.js';
2
+ import { loadJson, saveJson } from './utils.js';
3
+ const DEFAULT_CONFIG = {
4
+ tool_calling_bias: 0.5,
5
+ memory_importance_threshold: 0.55,
6
+ response_style: 'balanced',
7
+ caution_bias: 0.5,
8
+ last_updated: new Date(0).toISOString()
9
+ };
10
+ const CONFIG_PATH = BEHAVIOR_CONFIG_PATH;
11
+ export function getBehaviorConfigPath() {
12
+ return CONFIG_PATH;
13
+ }
14
+ export function loadBehaviorConfig() {
15
+ const raw = loadJson(CONFIG_PATH, {});
16
+ const merged = {
17
+ ...DEFAULT_CONFIG,
18
+ ...raw,
19
+ tool_calling_bias: clamp(raw.tool_calling_bias ?? DEFAULT_CONFIG.tool_calling_bias),
20
+ memory_importance_threshold: clamp(raw.memory_importance_threshold ?? DEFAULT_CONFIG.memory_importance_threshold),
21
+ caution_bias: clamp(raw.caution_bias ?? DEFAULT_CONFIG.caution_bias),
22
+ response_style: validateStyle(raw.response_style) ?? DEFAULT_CONFIG.response_style,
23
+ last_updated: raw.last_updated || DEFAULT_CONFIG.last_updated
24
+ };
25
+ return merged;
26
+ }
27
+ export function saveBehaviorConfig(config) {
28
+ saveJson(CONFIG_PATH, config);
29
+ }
30
+ function clamp(value) {
31
+ if (!Number.isFinite(value))
32
+ return 0.5;
33
+ return Math.min(1, Math.max(0, value));
34
+ }
35
+ function validateStyle(style) {
36
+ if (style === 'concise' || style === 'balanced' || style === 'detailed')
37
+ return style;
38
+ return null;
39
+ }
40
+ export function adjustBehaviorConfig(config, updates) {
41
+ const next = {
42
+ ...config,
43
+ ...updates,
44
+ tool_calling_bias: clamp(updates.tool_calling_bias ?? config.tool_calling_bias),
45
+ memory_importance_threshold: clamp(updates.memory_importance_threshold ?? config.memory_importance_threshold),
46
+ caution_bias: clamp(updates.caution_bias ?? config.caution_bias),
47
+ response_style: validateStyle(updates.response_style) ?? config.response_style,
48
+ last_updated: new Date().toISOString()
49
+ };
50
+ return next;
51
+ }
52
+ //# sourceMappingURL=behavior-config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"behavior-config.js","sourceRoot":"","sources":["../src/behavior-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAahD,MAAM,cAAc,GAAmB;IACrC,iBAAiB,EAAE,GAAG;IACtB,2BAA2B,EAAE,IAAI;IACjC,cAAc,EAAE,UAAU;IAC1B,YAAY,EAAE,GAAG;IACjB,YAAY,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;CACxC,CAAC;AAEF,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEzC,MAAM,UAAU,qBAAqB;IACnC,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,GAAG,GAAG,QAAQ,CAA0B,WAAW,EAAE,EAAE,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAmB;QAC7B,GAAG,cAAc;QACjB,GAAG,GAAG;QACN,iBAAiB,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,IAAI,cAAc,CAAC,iBAAiB,CAAC;QACnF,2BAA2B,EAAE,KAAK,CAAC,GAAG,CAAC,2BAA2B,IAAI,cAAc,CAAC,2BAA2B,CAAC;QACjH,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,YAAY,IAAI,cAAc,CAAC,YAAY,CAAC;QACpE,cAAc,EAAE,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,cAAc,CAAC,cAAc;QAClF,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,cAAc,CAAC,YAAY;KAC9D,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAsB;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,KAAK,CAAC,KAAa;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACtF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAsB,EAAE,OAAgC;IAC3F,MAAM,IAAI,GAAmB;QAC3B,GAAG,MAAM;QACT,GAAG,OAAO;QACV,iBAAiB,EAAE,KAAK,CAAC,OAAO,CAAC,iBAAiB,IAAI,MAAM,CAAC,iBAAiB,CAAC;QAC/E,2BAA2B,EAAE,KAAK,CAAC,OAAO,CAAC,2BAA2B,IAAI,MAAM,CAAC,2BAA2B,CAAC;QAC7G,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC;QAChE,cAAc,EAAE,aAAa,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,MAAM,CAAC,cAAc;QAC9E,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACvC,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC"}
package/dist/cli.d.ts ADDED
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ export {};
3
+ //# sourceMappingURL=cli.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}