strands-darwin 0.0.35 → 0.0.37

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 (254) hide show
  1. package/README.md +23 -6
  2. package/README.zh-CN.md +23 -6
  3. package/dist/patches/{@strands-agents+sdk+1.16.0.patch → @strands-agents+sdk+1.18.0.patch} +320 -9
  4. package/dist/src/agent/compact.js +1 -1
  5. package/dist/src/agent/prompt-cache.js +15 -2
  6. package/dist/src/agent/prompt-cache.js.map +1 -1
  7. package/dist/src/agent/rewind.d.ts +2 -0
  8. package/dist/src/agent/rewind.js +4 -1
  9. package/dist/src/agent/rewind.js.map +1 -1
  10. package/dist/src/agent/runtime.d.ts +81 -20
  11. package/dist/src/agent/runtime.js +227 -43
  12. package/dist/src/agent/runtime.js.map +1 -1
  13. package/dist/src/agent/session.d.ts +96 -4
  14. package/dist/src/agent/session.js +249 -9
  15. package/dist/src/agent/session.js.map +1 -1
  16. package/dist/src/agent/stream-idle.d.ts +16 -0
  17. package/dist/src/agent/stream-idle.js +127 -0
  18. package/dist/src/agent/stream-idle.js.map +1 -0
  19. package/dist/src/agent/system-prompt.d.ts +1 -1
  20. package/dist/src/agent/system-prompt.js +12 -0
  21. package/dist/src/agent/system-prompt.js.map +1 -1
  22. package/dist/src/agent/task-terminal-delivery.d.ts +25 -2
  23. package/dist/src/agent/task-terminal-delivery.js +80 -7
  24. package/dist/src/agent/task-terminal-delivery.js.map +1 -1
  25. package/dist/src/agent/working-context.d.ts +21 -1
  26. package/dist/src/agent/working-context.js +28 -1
  27. package/dist/src/agent/working-context.js.map +1 -1
  28. package/dist/src/agent/workspace-trust.d.ts +112 -0
  29. package/dist/src/agent/workspace-trust.js +207 -0
  30. package/dist/src/agent/workspace-trust.js.map +1 -0
  31. package/dist/src/agentcore/auto-policy.d.ts +7 -0
  32. package/dist/src/agentcore/auto-policy.js +50 -0
  33. package/dist/src/agentcore/auto-policy.js.map +1 -0
  34. package/dist/src/agentcore/auto-state.d.ts +43 -0
  35. package/dist/src/agentcore/auto-state.js +73 -0
  36. package/dist/src/agentcore/auto-state.js.map +1 -0
  37. package/dist/src/agentcore/cli.d.ts +2 -0
  38. package/dist/src/agentcore/cli.js +38 -0
  39. package/dist/src/agentcore/cli.js.map +1 -0
  40. package/dist/src/agentcore/config.d.ts +48 -0
  41. package/dist/src/agentcore/config.js +44 -0
  42. package/dist/src/agentcore/config.js.map +1 -0
  43. package/dist/src/agentcore/controller.d.ts +105 -0
  44. package/dist/src/agentcore/controller.js +979 -0
  45. package/dist/src/agentcore/controller.js.map +1 -0
  46. package/dist/src/agentcore/projection.d.ts +2 -0
  47. package/dist/src/agentcore/projection.js +8 -0
  48. package/dist/src/agentcore/projection.js.map +1 -0
  49. package/dist/src/agentcore/records.d.ts +41 -0
  50. package/dist/src/agentcore/records.js +149 -0
  51. package/dist/src/agentcore/records.js.map +1 -0
  52. package/dist/src/agentcore/state.d.ts +16 -0
  53. package/dist/src/agentcore/state.js +149 -0
  54. package/dist/src/agentcore/state.js.map +1 -0
  55. package/dist/src/agentcore/tools.d.ts +3 -0
  56. package/dist/src/agentcore/tools.js +11 -0
  57. package/dist/src/agentcore/tools.js.map +1 -0
  58. package/dist/src/agentcore/transport.d.ts +37 -0
  59. package/dist/src/agentcore/transport.js +242 -0
  60. package/dist/src/agentcore/transport.js.map +1 -0
  61. package/dist/src/agentcore/upload-projection.d.ts +208 -0
  62. package/dist/src/agentcore/upload-projection.js +823 -0
  63. package/dist/src/agentcore/upload-projection.js.map +1 -0
  64. package/dist/src/agents/child-recipe.js +4 -1
  65. package/dist/src/agents/child-recipe.js.map +1 -1
  66. package/dist/src/agents/loader.d.ts +12 -0
  67. package/dist/src/agents/loader.js +15 -1
  68. package/dist/src/agents/loader.js.map +1 -1
  69. package/dist/src/agents/subagent-tool.js +2 -4
  70. package/dist/src/agents/subagent-tool.js.map +1 -1
  71. package/dist/src/agents/workflow-tool.js +2 -4
  72. package/dist/src/agents/workflow-tool.js.map +1 -1
  73. package/dist/src/cli-doctor.js +7 -0
  74. package/dist/src/cli-doctor.js.map +1 -1
  75. package/dist/src/cli-import.d.ts +1 -0
  76. package/dist/src/cli-import.js +26 -0
  77. package/dist/src/cli-import.js.map +1 -0
  78. package/dist/src/cli-main.js +60 -10
  79. package/dist/src/cli-main.js.map +1 -1
  80. package/dist/src/cli-permissions.d.ts +2 -0
  81. package/dist/src/cli-permissions.js +20 -0
  82. package/dist/src/cli-permissions.js.map +1 -0
  83. package/dist/src/cli-sessions.js +6 -2
  84. package/dist/src/cli-sessions.js.map +1 -1
  85. package/dist/src/cli-usage.d.ts +9 -1
  86. package/dist/src/cli-usage.js +13 -0
  87. package/dist/src/cli-usage.js.map +1 -1
  88. package/dist/src/cli.js +19 -2
  89. package/dist/src/cli.js.map +1 -1
  90. package/dist/src/commands/custom-commands.d.ts +1 -1
  91. package/dist/src/commands/custom-commands.js +14 -6
  92. package/dist/src/commands/custom-commands.js.map +1 -1
  93. package/dist/src/commands/review-command.d.ts +10 -0
  94. package/dist/src/commands/review-command.js +28 -0
  95. package/dist/src/commands/review-command.js.map +1 -0
  96. package/dist/src/config-file.d.ts +9 -0
  97. package/dist/src/config-file.js +82 -0
  98. package/dist/src/config-file.js.map +1 -0
  99. package/dist/src/config.d.ts +66 -5
  100. package/dist/src/config.js +126 -42
  101. package/dist/src/config.js.map +1 -1
  102. package/dist/src/dev-repl.js +17 -1
  103. package/dist/src/dev-repl.js.map +1 -1
  104. package/dist/src/headless-protocol.d.ts +24 -1
  105. package/dist/src/headless-protocol.js +18 -0
  106. package/dist/src/headless-protocol.js.map +1 -1
  107. package/dist/src/headless-runner.d.ts +8 -0
  108. package/dist/src/headless-runner.js +37 -1
  109. package/dist/src/headless-runner.js.map +1 -1
  110. package/dist/src/hooks/hook-process.js +7 -2
  111. package/dist/src/hooks/hook-process.js.map +1 -1
  112. package/dist/src/hooks/lifecycle-hooks.js +3 -1
  113. package/dist/src/hooks/lifecycle-hooks.js.map +1 -1
  114. package/dist/src/hooks/tool-hooks.js +3 -1
  115. package/dist/src/hooks/tool-hooks.js.map +1 -1
  116. package/dist/src/import-claude-files.d.ts +28 -0
  117. package/dist/src/import-claude-files.js +227 -0
  118. package/dist/src/import-claude-files.js.map +1 -0
  119. package/dist/src/import-claude-snippets.d.ts +2 -0
  120. package/dist/src/import-claude-snippets.js +105 -0
  121. package/dist/src/import-claude-snippets.js.map +1 -0
  122. package/dist/src/import-claude.d.ts +13 -0
  123. package/dist/src/import-claude.js +287 -0
  124. package/dist/src/import-claude.js.map +1 -0
  125. package/dist/src/mcp/registry.d.ts +57 -1
  126. package/dist/src/mcp/registry.js +78 -6
  127. package/dist/src/mcp/registry.js.map +1 -1
  128. package/dist/src/memory/command.d.ts +1 -1
  129. package/dist/src/memory/command.js +89 -4
  130. package/dist/src/memory/command.js.map +1 -1
  131. package/dist/src/memory/controller.d.ts +32 -0
  132. package/dist/src/memory/controller.js +39 -3
  133. package/dist/src/memory/controller.js.map +1 -1
  134. package/dist/src/memory/state.d.ts +6 -0
  135. package/dist/src/memory/state.js +6 -1
  136. package/dist/src/memory/state.js.map +1 -1
  137. package/dist/src/memory/store.d.ts +13 -0
  138. package/dist/src/memory/store.js +38 -2
  139. package/dist/src/memory/store.js.map +1 -1
  140. package/dist/src/memory/tools.d.ts +7 -0
  141. package/dist/src/memory/tools.js +12 -1
  142. package/dist/src/memory/tools.js.map +1 -1
  143. package/dist/src/npm-package/patch-package-format.d.ts +5 -5
  144. package/dist/src/npm-package/patch-package-format.js +4 -4
  145. package/dist/src/paths.js +3 -0
  146. package/dist/src/paths.js.map +1 -1
  147. package/dist/src/permissions-test.d.ts +18 -0
  148. package/dist/src/permissions-test.js +207 -0
  149. package/dist/src/permissions-test.js.map +1 -0
  150. package/dist/src/pricing/model-prices.d.ts +8 -5
  151. package/dist/src/pricing/model-prices.js +30 -15
  152. package/dist/src/pricing/model-prices.js.map +1 -1
  153. package/dist/src/project-identity.d.ts +3 -0
  154. package/dist/src/project-identity.js +8 -0
  155. package/dist/src/project-identity.js.map +1 -0
  156. package/dist/src/project-overrides.d.ts +57 -0
  157. package/dist/src/project-overrides.js +79 -0
  158. package/dist/src/project-overrides.js.map +1 -0
  159. package/dist/src/sdk-patch-preflight.js +1 -1
  160. package/dist/src/skills/builtin/developer/SKILL.md +2 -0
  161. package/dist/src/skills/builtin/self-reflection/references/reflection-template.md +2 -1
  162. package/dist/src/skills/builtin/setup-agentcore-memory/SKILL.md +158 -0
  163. package/dist/src/skills/loader.d.ts +1 -1
  164. package/dist/src/skills/loader.js +4 -1
  165. package/dist/src/skills/loader.js.map +1 -1
  166. package/dist/src/tools/background-bash.d.ts +13 -1
  167. package/dist/src/tools/background-bash.js +36 -8
  168. package/dist/src/tools/background-bash.js.map +1 -1
  169. package/dist/src/tools/shell-env.d.ts +24 -0
  170. package/dist/src/tools/shell-env.js +34 -0
  171. package/dist/src/tools/shell-env.js.map +1 -1
  172. package/dist/src/trajectory/reader.d.ts +1 -1
  173. package/dist/src/trajectory/reader.js +23 -3
  174. package/dist/src/trajectory/reader.js.map +1 -1
  175. package/dist/src/trajectory/record.d.ts +50 -2
  176. package/dist/src/trajectory/record.js +32 -0
  177. package/dist/src/trajectory/record.js.map +1 -1
  178. package/dist/src/trajectory/replay.d.ts +12 -1
  179. package/dist/src/trajectory/replay.js +31 -2
  180. package/dist/src/trajectory/replay.js.map +1 -1
  181. package/dist/src/trajectory/resume-recap.d.ts +11 -1
  182. package/dist/src/trajectory/resume-recap.js +10 -1
  183. package/dist/src/trajectory/resume-recap.js.map +1 -1
  184. package/dist/src/trajectory/rewind-history.d.ts +8 -0
  185. package/dist/src/trajectory/rewind-history.js +81 -0
  186. package/dist/src/trajectory/rewind-history.js.map +1 -0
  187. package/dist/src/trajectory/writer.d.ts +14 -1
  188. package/dist/src/trajectory/writer.js +38 -0
  189. package/dist/src/trajectory/writer.js.map +1 -1
  190. package/dist/src/tui/App.d.ts +5 -1
  191. package/dist/src/tui/App.js +284 -51
  192. package/dist/src/tui/App.js.map +1 -1
  193. package/dist/src/tui/InputBox.d.ts +1 -1
  194. package/dist/src/tui/InputBox.js +3 -2
  195. package/dist/src/tui/InputBox.js.map +1 -1
  196. package/dist/src/tui/MessageList.js +1 -1
  197. package/dist/src/tui/MessageList.js.map +1 -1
  198. package/dist/src/tui/PermissionPrompt.js +5 -3
  199. package/dist/src/tui/PermissionPrompt.js.map +1 -1
  200. package/dist/src/tui/QueuedMessages.js +14 -8
  201. package/dist/src/tui/QueuedMessages.js.map +1 -1
  202. package/dist/src/tui/ToolCallPanel.js +2 -2
  203. package/dist/src/tui/ToolCallPanel.js.map +1 -1
  204. package/dist/src/tui/WorkspaceTrustPrompt.d.ts +8 -0
  205. package/dist/src/tui/WorkspaceTrustPrompt.js +37 -0
  206. package/dist/src/tui/WorkspaceTrustPrompt.js.map +1 -0
  207. package/dist/src/tui/draft-stash.d.ts +25 -0
  208. package/dist/src/tui/draft-stash.js +49 -0
  209. package/dist/src/tui/draft-stash.js.map +1 -0
  210. package/dist/src/tui/frame-budget.d.ts +2 -2
  211. package/dist/src/tui/frame-budget.js +3 -3
  212. package/dist/src/tui/frame-budget.js.map +1 -1
  213. package/dist/src/tui/help-format.d.ts +2 -2
  214. package/dist/src/tui/help-format.js +3 -3
  215. package/dist/src/tui/help-format.js.map +1 -1
  216. package/dist/src/tui/mcp-format.d.ts +9 -0
  217. package/dist/src/tui/mcp-format.js +5 -3
  218. package/dist/src/tui/mcp-format.js.map +1 -1
  219. package/dist/src/tui/permission-rule-preview.d.ts +23 -0
  220. package/dist/src/tui/permission-rule-preview.js +38 -0
  221. package/dist/src/tui/permission-rule-preview.js.map +1 -0
  222. package/dist/src/tui/prompt-editor.d.ts +12 -0
  223. package/dist/src/tui/prompt-editor.js +57 -37
  224. package/dist/src/tui/prompt-editor.js.map +1 -1
  225. package/dist/src/tui/prompt-history-search.js +3 -2
  226. package/dist/src/tui/prompt-history-search.js.map +1 -1
  227. package/dist/src/tui/prompt-queue.d.ts +4 -2
  228. package/dist/src/tui/prompt-queue.js +18 -3
  229. package/dist/src/tui/prompt-queue.js.map +1 -1
  230. package/dist/src/tui/rewind-search.js +4 -3
  231. package/dist/src/tui/rewind-search.js.map +1 -1
  232. package/dist/src/tui/search-preview.d.ts +2 -0
  233. package/dist/src/tui/search-preview.js +9 -0
  234. package/dist/src/tui/search-preview.js.map +1 -0
  235. package/dist/src/tui/shell-command.js +4 -1
  236. package/dist/src/tui/shell-command.js.map +1 -1
  237. package/dist/src/tui/spinner.d.ts +1 -0
  238. package/dist/src/tui/spinner.js +6 -0
  239. package/dist/src/tui/spinner.js.map +1 -0
  240. package/dist/src/tui/status-format.d.ts +9 -0
  241. package/dist/src/tui/status-format.js +37 -2
  242. package/dist/src/tui/status-format.js.map +1 -1
  243. package/dist/src/tui/subagent-format.js +6 -0
  244. package/dist/src/tui/subagent-format.js.map +1 -1
  245. package/dist/src/tui/task-format.d.ts +5 -0
  246. package/dist/src/tui/task-format.js +15 -0
  247. package/dist/src/tui/task-format.js.map +1 -1
  248. package/dist/src/tui/trust-format.d.ts +31 -0
  249. package/dist/src/tui/trust-format.js +102 -0
  250. package/dist/src/tui/trust-format.js.map +1 -0
  251. package/dist/src/tui/turn-state.d.ts +1 -0
  252. package/dist/src/tui/turn-state.js +2 -0
  253. package/dist/src/tui/turn-state.js.map +1 -1
  254. package/package.json +4 -3
@@ -0,0 +1,50 @@
1
+ import path from 'node:path';
2
+ import { randomUUID } from 'node:crypto';
3
+ import { userDarwinDir } from '../paths.js';
4
+ import { projectIdentity } from '../project-identity.js';
5
+ import { updateConfigFile } from '../config-file.js';
6
+ import { cloudBinding, effectiveCloudPolicy, parseProjectOverrides } from '../project-overrides.js';
7
+ import { parseAgentCoreConfig } from './config.js';
8
+ /** Called only from the existing user TUI management authority. No model tool. */
9
+ export async function persistUploadMode(root, expected, mode, signal) {
10
+ return updateConfigFile(path.join(userDarwinDir(), 'config.json'), record => {
11
+ const global = parseAgentCoreConfig(record['agentCoreMemory']);
12
+ if (!global || cloudBinding(global, root) !== cloudBinding(expected, root))
13
+ throw new Error('Cloud scope changed; restart and re-confirm this project');
14
+ if (record['trajectory'] === false)
15
+ throw new Error('Uploads require trajectory recording');
16
+ const overrides = parseProjectOverrides(record['projectOverrides']) ?? Object.create(null);
17
+ const key = projectIdentity(root);
18
+ const prior = overrides[key] ?? {};
19
+ overrides[key] = { ...prior, agentCoreMemory: { ...prior.agentCoreMemory, upload: mode,
20
+ ...(mode === 'auto' ? { authorization: { version: 2, epoch: randomUUID(), at: new Date().toISOString(), scope: cloudBinding(global, root), project: key } } : {}),
21
+ } };
22
+ if (mode === 'manual')
23
+ delete overrides[key].agentCoreMemory.authorization;
24
+ parseProjectOverrides(overrides); // Includes the bound after insertion.
25
+ record['projectOverrides'] = overrides;
26
+ return effectiveCloudPolicy(global, overrides, root);
27
+ }, signal);
28
+ }
29
+ /** No success classifier, sensitivity filter, whitelist or omitted-percent veto. */
30
+ export function autoHoldReason(turn, settlement) {
31
+ if (!settlement.durable)
32
+ return 'Turn close not durable';
33
+ if (settlement.failure || settlement.partial || settlement.stopReason !== 'endTurn')
34
+ return 'Cancelled, incomplete or provider-failed turn; manual review required';
35
+ if (turn.observerErrors || turn.unmatchedResults || turn.backgroundResultsDropped)
36
+ return 'Serious collection loss or ambiguous pairing; manual review required';
37
+ const integrity = turn.integrity;
38
+ if (integrity.identityAmbiguous || integrity.lateOriginsOverflow)
39
+ return 'Source identity/attribution loss; manual review required';
40
+ if (integrity.sourceUnavailable)
41
+ return 'Source collection unavailable; manual review required';
42
+ if (integrity.unresolvedResults || integrity.resultUnavailable)
43
+ return 'Missing or ambiguous results; manual review required';
44
+ if (!integrity.completedResults)
45
+ return 'No traceable action/result; management or acknowledgement-only turn';
46
+ if (!turn.goal.retainedBytes && !integrity.lateResults)
47
+ return 'No goal or traceable original late result';
48
+ return undefined;
49
+ }
50
+ //# sourceMappingURL=auto-policy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auto-policy.js","sourceRoot":"","sources":["../../../src/agentcore/auto-policy.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,43 @@
1
+ import { z } from 'zod';
2
+ import { type AgentCoreConfig } from './config.js';
3
+ export declare const MAX_OUTBOX_FILES = 32768;
4
+ export declare const MAX_OUTBOX_BODIES = 4096;
5
+ export declare const MAX_PENDING_BODIES = 512;
6
+ export declare const AUTO_RETENTION_MS: number;
7
+ export declare const autoProofSchema: z.ZodObject<{
8
+ version: z.ZodLiteral<1>;
9
+ hash: z.ZodString;
10
+ authorization: z.ZodDiscriminatedUnion<[z.ZodObject<{
11
+ epoch: z.ZodString;
12
+ at: z.ZodString;
13
+ scope: z.ZodString;
14
+ version: z.ZodLiteral<1>;
15
+ }, z.core.$strict>, z.ZodObject<{
16
+ epoch: z.ZodString;
17
+ at: z.ZodString;
18
+ scope: z.ZodString;
19
+ version: z.ZodLiteral<2>;
20
+ project: z.ZodString;
21
+ }, z.core.$strict>], "version">;
22
+ session: z.ZodString;
23
+ turn: z.ZodNumber;
24
+ reason: z.ZodOptional<z.ZodString>;
25
+ }, z.core.$strict>;
26
+ export type AutoProof = z.infer<typeof autoProofSchema>;
27
+ export declare function receiptFile(directory: string, token: string): string;
28
+ export declare function tokenReceipt(directory: string, token: string): Promise<{
29
+ token: string;
30
+ disposition: "accepted" | "discarded";
31
+ at: string;
32
+ } | undefined>;
33
+ export declare function receiptCapacity(directory: string, tokens: string[]): Promise<void>;
34
+ export declare function saveReceipt(directory: string, token: string, disposition: 'accepted' | 'discarded', signal?: AbortSignal): Promise<void>;
35
+ export declare function quotaDirectory(root: string, config?: AgentCoreConfig): string;
36
+ export declare function quotaUsage(root: string, now?: Date, config?: AgentCoreConfig): Promise<{
37
+ day: string;
38
+ events: number;
39
+ bytes: number;
40
+ }>;
41
+ /** A reservation is one network attempt, not one extracted memory or unique event.
42
+ * Exact Smithy-serialized request body bytes; crashes/unknown acks consume budget. */
43
+ export declare function reserveQuota(root: string, config: AgentCoreConfig, bytes: number, signal: AbortSignal, now?: Date): Promise<void>;
@@ -0,0 +1,73 @@
1
+ import path from 'node:path';
2
+ import { z } from 'zod';
3
+ import { userDarwinDir } from '../paths.js';
4
+ import { projectIdentity } from '../project-identity.js';
5
+ import { authorizationSchema } from './config.js';
6
+ import { readState, stateNames, withStateLock, writeState } from './state.js';
7
+ export const MAX_OUTBOX_FILES = 32768;
8
+ export const MAX_OUTBOX_BODIES = 4096;
9
+ export const MAX_PENDING_BODIES = 512;
10
+ export const AUTO_RETENTION_MS = 7 * 86400000;
11
+ const hash = z.string().regex(/^[a-f0-9]{64}$/);
12
+ export const autoProofSchema = z.object({ version: z.literal(1), hash, authorization: authorizationSchema,
13
+ session: z.string().max(128), turn: z.number().int().positive(), reason: z.string().max(240).optional(),
14
+ }).strict();
15
+ const receiptSchema = z.object({ token: hash, disposition: z.enum(['accepted', 'discarded']), at: z.string().datetime() }).strict();
16
+ export function receiptFile(directory, token) {
17
+ hash.parse(token);
18
+ return path.join(directory, 'receipts', token.slice(0, 2), `${token}.json`);
19
+ }
20
+ export async function tokenReceipt(directory, token) {
21
+ const value = await readState(receiptFile(directory, token));
22
+ if (value === undefined)
23
+ return undefined;
24
+ const receipt = receiptSchema.parse(value);
25
+ if (receipt.token !== token)
26
+ throw new Error('Receipt identity mismatch');
27
+ return receipt;
28
+ }
29
+ export async function receiptCapacity(directory, tokens) {
30
+ const shards = new Map();
31
+ for (const token of tokens) {
32
+ const file = receiptFile(directory, token);
33
+ const shard = path.dirname(file);
34
+ if (!shards.has(shard))
35
+ shards.set(shard, new Set(await stateNames(shard, 4096)));
36
+ shards.get(shard).add(path.basename(file));
37
+ if (shards.get(shard).size > 4096)
38
+ throw new Error('Receipt partition full (4096); paused without removing data');
39
+ }
40
+ }
41
+ export async function saveReceipt(directory, token, disposition, signal) {
42
+ const prior = await tokenReceipt(directory, token);
43
+ if (prior) {
44
+ if (prior.disposition !== disposition)
45
+ throw new Error('Receipt disposition cannot change');
46
+ return;
47
+ }
48
+ await receiptCapacity(directory, [token]);
49
+ await writeState(receiptFile(directory, token), { token, disposition, at: new Date().toISOString() }, true, signal);
50
+ }
51
+ const quotaSchema = z.object({ day: z.string().regex(/^\d{4}-\d{2}-\d{2}$/), events: z.number().int().nonnegative().max(100000), bytes: z.number().int().nonnegative().max(107374182400) }).strict();
52
+ export function quotaDirectory(root, config) { return path.join(userDarwinDir(), 'agentcore', 'auto-quota', projectIdentity(root, config?.projectId)); }
53
+ export async function quotaUsage(root, now = new Date(), config) {
54
+ const day = now.toISOString().slice(0, 10);
55
+ const value = await readState(path.join(quotaDirectory(root, config), 'usage.json'));
56
+ const usage = value === undefined ? { day, events: 0, bytes: 0 } : quotaSchema.parse(value);
57
+ if (usage.day > day)
58
+ throw new Error('Quota clock moved backwards; auto paused');
59
+ return usage.day === day ? usage : { day, events: 0, bytes: 0 };
60
+ }
61
+ /** A reservation is one network attempt, not one extracted memory or unique event.
62
+ * Exact Smithy-serialized request body bytes; crashes/unknown acks consume budget. */
63
+ export async function reserveQuota(root, config, bytes, signal, now = new Date()) {
64
+ if (!Number.isSafeInteger(bytes) || bytes < 1 || bytes > 262144)
65
+ throw new Error('Invalid wire request size');
66
+ await withStateLock(quotaDirectory(root, config), async () => {
67
+ const usage = await quotaUsage(root, now, config);
68
+ if (usage.events + 1 > config.autoDailyEvents || usage.bytes + bytes > config.autoDailyBytes)
69
+ throw new Error('Auto paused: daily budget exhausted; pending retained until next ordinary authorized activity');
70
+ await writeState(path.join(quotaDirectory(root, config), 'usage.json'), { day: usage.day, events: usage.events + 1, bytes: usage.bytes + bytes }, false, signal);
71
+ }, signal);
72
+ }
73
+ //# sourceMappingURL=auto-state.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auto-state.js","sourceRoot":"","sources":["../../../src/agentcore/auto-state.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ /** Routed before runtime imports: SDK bash installs exit(0) signal handlers. */
2
+ export declare function runCloudMemoryCli(root: string, args: string[]): Promise<void>;
@@ -0,0 +1,38 @@
1
+ import process from 'node:process';
2
+ import { loadConfig } from '../config.js';
3
+ import { AGENTCORE_CLI_PATH_NOTICE } from './config.js';
4
+ import { CloudMemory, cloudReadArguments, CLOUD_READ_USAGE } from './controller.js';
5
+ /** Routed before runtime imports: SDK bash installs exit(0) signal handlers. */
6
+ export async function runCloudMemoryCli(root, args) {
7
+ const input = args.join(' ');
8
+ if (!cloudReadArguments(input)) {
9
+ process.stderr.write(`Headless mutations unavailable; use user-submitted TUI management. ${CLOUD_READ_USAGE}\n`);
10
+ process.exitCode = 1;
11
+ return;
12
+ }
13
+ const config = await loadConfig(root);
14
+ if (config.agentCoreMemory === undefined) {
15
+ process.stdout.write('AgentCore: disabled (local project memory unchanged)\n');
16
+ if (input !== '' && input !== 'status')
17
+ process.exitCode = 1;
18
+ return;
19
+ }
20
+ if (config.agentCoreMemory.cliPath !== undefined)
21
+ process.stderr.write(`${AGENTCORE_CLI_PATH_NOTICE}\n`);
22
+ const memory = new CloudMemory(config.agentCoreMemory, root, 'management');
23
+ const cancel = () => { process.exitCode = 1; memory.cancel(); };
24
+ process.once('SIGINT', cancel);
25
+ process.once('SIGTERM', cancel);
26
+ try {
27
+ const result = await memory.commandResult(input);
28
+ process.stdout.write(`${result.text}\n`);
29
+ if (!result.ok)
30
+ process.exitCode = 1;
31
+ }
32
+ finally {
33
+ process.off('SIGINT', cancel);
34
+ process.off('SIGTERM', cancel);
35
+ await memory.close();
36
+ }
37
+ }
38
+ //# sourceMappingURL=cli.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/agentcore/cli.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEpF,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAAc;IAClE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sEAAsE,gBAAgB,IAAI,CAAC,CAAC;QACjH,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC/E,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,QAAQ;YAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QAC7D,OAAO;IACT,CAAC;IACD,IAAI,MAAM,CAAC,eAAe,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,yBAAyB,IAAI,CAAC,CAAC;IACzG,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACjD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvC,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}
@@ -0,0 +1,48 @@
1
+ import { z } from 'zod';
2
+ export declare const agentCoreConfigSchema: z.ZodObject<{
3
+ enabled: z.ZodLiteral<true>;
4
+ region: z.ZodString;
5
+ memoryId: z.ZodString;
6
+ episodicStrategyId: z.ZodString;
7
+ preferenceStrategyId: z.ZodString;
8
+ actorId: z.ZodString;
9
+ projectId: z.ZodOptional<z.ZodString>;
10
+ cliPath: z.ZodOptional<z.ZodString>;
11
+ timeoutMs: z.ZodDefault<z.ZodNumber>;
12
+ preferences: z.ZodDefault<z.ZodBoolean>;
13
+ upload: z.ZodDefault<z.ZodEnum<{
14
+ auto: "auto";
15
+ manual: "manual";
16
+ off: "off";
17
+ }>>;
18
+ autoDailyEvents: z.ZodDefault<z.ZodNumber>;
19
+ autoDailyBytes: z.ZodDefault<z.ZodNumber>;
20
+ }, z.core.$strict>;
21
+ export declare const authorizationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
22
+ epoch: z.ZodString;
23
+ at: z.ZodString;
24
+ scope: z.ZodString;
25
+ version: z.ZodLiteral<1>;
26
+ }, z.core.$strict>, z.ZodObject<{
27
+ epoch: z.ZodString;
28
+ at: z.ZodString;
29
+ scope: z.ZodString;
30
+ version: z.ZodLiteral<2>;
31
+ project: z.ZodString;
32
+ }, z.core.$strict>], "version">;
33
+ export type AutoAuthorization = z.infer<typeof authorizationSchema>;
34
+ export type AgentCoreConfig = z.infer<typeof agentCoreConfigSchema> & {
35
+ /** Derived only by the project registry; never accepted at the global root. */
36
+ authorization?: AutoAuthorization;
37
+ autoProblem?: string;
38
+ projectOverride?: boolean;
39
+ };
40
+ export declare const AGENTCORE_CLI_PATH_NOTICE = "agentCoreMemory.cliPath is deprecated and ignored; runtime memory uses the AWS SDK. Remove cliPath from your private config; retain all other memory settings.";
41
+ export declare function parseAgentCoreConfig(value: unknown): AgentCoreConfig | undefined;
42
+ export declare function scopeFor(config: AgentCoreConfig, root: string): {
43
+ projectId: string;
44
+ project: string;
45
+ episodes: string;
46
+ preferences: string;
47
+ };
48
+ export declare function digest(value: unknown): string;
@@ -0,0 +1,44 @@
1
+ import { z } from 'zod';
2
+ import { createHash } from 'node:crypto';
3
+ import { projectIdentity } from '../project-identity.js';
4
+ const segment = z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,127}$/);
5
+ export const agentCoreConfigSchema = z.object({
6
+ enabled: z.literal(true),
7
+ region: z.string().regex(/^[a-z]{2}(?:-[a-z]+)+-\d$/),
8
+ memoryId: z.string().regex(/^[a-zA-Z][a-zA-Z0-9_]{0,99}-[a-zA-Z0-9]{10}$/),
9
+ episodicStrategyId: segment,
10
+ preferenceStrategyId: segment,
11
+ actorId: segment,
12
+ projectId: z.string().regex(/^[a-z0-9][a-z0-9_-]{0,63}$/).optional(),
13
+ // Compatibility only: validated, ignored, never executed or displayed.
14
+ cliPath: z.string().regex(/^\//).max(1024).optional(),
15
+ timeoutMs: z.number().int().min(100).max(15000).default(5000),
16
+ preferences: z.boolean().default(true),
17
+ upload: z.enum(['off', 'manual', 'auto']).default('off'),
18
+ autoDailyEvents: z.number().int().min(1).max(100000).default(500),
19
+ autoDailyBytes: z.number().int().min(1).max(107374182400).default(104857600),
20
+ }).strict().refine((value) => value.episodicStrategyId !== value.preferenceStrategyId, 'strategies must be distinct');
21
+ const authorizationFields = { epoch: z.string().uuid(), at: z.string().datetime(), scope: z.string().regex(/^[a-f0-9]{64}$/) };
22
+ // V1 is readable only so old config/provenance remains inspectable and held manual.
23
+ export const authorizationSchema = z.discriminatedUnion('version', [
24
+ z.object({ version: z.literal(1), ...authorizationFields }).strict(),
25
+ z.object({ version: z.literal(2), ...authorizationFields, project: z.string().regex(/^[a-f0-9]{64}$/) }).strict(),
26
+ ]);
27
+ export const AGENTCORE_CLI_PATH_NOTICE = 'agentCoreMemory.cliPath is deprecated and ignored; runtime memory uses the AWS SDK. Remove cliPath from your private config; retain all other memory settings.';
28
+ export function parseAgentCoreConfig(value) {
29
+ if (value === undefined || value === false)
30
+ return undefined;
31
+ const result = agentCoreConfigSchema.safeParse(value);
32
+ if (!result.success)
33
+ throw new Error('agentCoreMemory: invalid configuration; use enabled:true, region, memoryId, distinct strategy IDs and opaque actorId; upload is off, manual or project-authorized auto.');
34
+ return result.data;
35
+ }
36
+ export function scopeFor(config, root) {
37
+ const projectId = projectIdentity(root, config.projectId);
38
+ const project = `/users/${config.actorId}/projects/${projectId}/strategy/${config.episodicStrategyId}/`;
39
+ return { projectId, project, episodes: `${project}sessions/`, preferences: `/users/${config.actorId}/strategy/${config.preferenceStrategyId}/preferences/` };
40
+ }
41
+ export function digest(value) {
42
+ return createHash('sha256').update(JSON.stringify(value)).digest('hex');
43
+ }
44
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/agentcore/config.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,105 @@
1
+ import type { TurnSettlement } from '../trajectory/writer.js';
2
+ import { scopeFor, type AgentCoreConfig } from './config.js';
3
+ import { MemoryTransport } from './transport.js';
4
+ import { type RecordKind, type ValidatedRecord } from './records.js';
5
+ import { UploadObserver } from './upload-projection.js';
6
+ export interface CloudCommandResult {
7
+ ok: boolean;
8
+ text: string;
9
+ }
10
+ export declare const CLOUD_CLOSE_TIMEOUT_MS = 2000;
11
+ export declare const LIST_PAGE_SIZE = 32;
12
+ export declare const LIST_PREVIEW_CODE_POINTS = 120;
13
+ export declare const CLOUD_READ_USAGE = "usage: darwin cloud-memory [status|preferences|list [preferences|episodes|reflections] [after <token>]|inspect <record-id>|pending [accepted] [after <token>]|preview <token>]";
14
+ export declare function cloudReadArguments(input: string): boolean;
15
+ export declare const CLOUD_USAGE = "usage: /cloud-memory [status|auto|manual|discard-legacy [<manifest-hash>]|preferences|list [preferences|episodes|reflections] [after <token>]|inspect <record-id>|confirm <record-id> <hash> global|forget <record-id>|delete <record-id> cloud|pending [accepted] [after <token>]|preview <token>|send <token> <preview-hash>|discard <token>|clear-accepted]";
16
+ export declare class CloudMemory {
17
+ config: AgentCoreConfig;
18
+ readonly root: string;
19
+ readonly session: string;
20
+ readonly transport: MemoryTransport;
21
+ uploadObserver: UploadObserver | undefined;
22
+ private autoAbort;
23
+ private origins;
24
+ private closes;
25
+ private autoSuspended;
26
+ private autoStopped;
27
+ private autoWork;
28
+ private static autoOwners;
29
+ private autoRunning;
30
+ private autoAgain;
31
+ private originEpochs;
32
+ private autoSummary;
33
+ readonly scope: ReturnType<typeof scopeFor>;
34
+ problem: string | undefined;
35
+ private chain;
36
+ private pendingJobs;
37
+ droppedTurns: number;
38
+ private readonly projectionAbort;
39
+ private closed;
40
+ private management;
41
+ private approvedContext;
42
+ private approvalsNeedingReview;
43
+ private started;
44
+ constructor(config: AgentCoreConfig, root: string, session: string);
45
+ begin(turn: number, goal: string): void;
46
+ discardTurn(turn: number): void;
47
+ /** Driver-owned fact, never inferred from an SDK agentResultEvent. */
48
+ sealTurn(turn: number, completed: boolean): void;
49
+ private stoppedSessionFile;
50
+ /** Stop synchronously before successor construction; persist only this origin session,
51
+ * never project consent. Old proofs remain manual across successor/restart drains. */
52
+ stopAutoForSuccessor(): Promise<void>;
53
+ refreshPolicy(): Promise<void>;
54
+ status(): string;
55
+ cancelGeneration: number;
56
+ cancel(): void;
57
+ close(): Promise<void>;
58
+ recall(kind: RecordKind, query: string, limit: number, signal?: AbortSignal): Promise<{
59
+ records: ValidatedRecord[];
60
+ omitted: number;
61
+ warning: string;
62
+ }>;
63
+ private preferenceFile;
64
+ /**
65
+ * The user-facing "my cloud memories" panel: one bounded read-only page of records for one
66
+ * kind, listed with id, time and a one-line content preview. Every returned record's scope
67
+ * is validated before any content is decoded (a scope mismatch refuses the whole page, as
68
+ * in `recall`); a record whose content fails its kind schema is still listed by id — the
69
+ * user must be able to see and delete what they cannot read — with the content withheld.
70
+ * Nothing is adopted, cached into `approvedContext`, written locally or sent to the model.
71
+ */
72
+ private listRecords;
73
+ private preferenceCapacity;
74
+ private preference;
75
+ startup(): Promise<void>;
76
+ private refreshPreferences;
77
+ context(): Promise<string>;
78
+ private binding;
79
+ private names;
80
+ private receipt;
81
+ private outbox;
82
+ /** Synchronous observer: detached local publication precedes an independent sender pass. */
83
+ settle(settlement: TurnSettlement): void;
84
+ private publish;
85
+ private sessionStopped;
86
+ private checkAutoAuthority;
87
+ private validateAutoAuthority;
88
+ private kickAuto;
89
+ /** Finite activity-owned pass, never a daemon or a model invocation. */
90
+ private drainAuto;
91
+ private inspectAutoState;
92
+ private expireAutoBodies;
93
+ /** Cleanup publishes a terminal receipt before removing bodies. A concurrent
94
+ * user discard/accept must not abort an unrelated activity-earned drain. */
95
+ private pendingEntry;
96
+ private unpartitioned;
97
+ private entry;
98
+ private send;
99
+ private receipts;
100
+ private cleanup;
101
+ private discardLegacy;
102
+ command(input: string, authority?: 'read' | 'user'): Promise<string>;
103
+ commandResult(input: string, authority?: 'read' | 'user'): Promise<CloudCommandResult>;
104
+ private runCommand;
105
+ }