@cmetech/otto 1.1.0 → 1.2.4

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 (425) hide show
  1. package/dist/coworker/persona-commands.d.ts +1 -0
  2. package/dist/coworker/persona-commands.js +5 -0
  3. package/dist/coworker/persona-commands.test.d.ts +1 -0
  4. package/dist/coworker/persona-commands.test.js +45 -0
  5. package/dist/resources/.managed-resources-content-hash +1 -1
  6. package/dist/resources/extensions/_coworker-paths.js +8 -0
  7. package/dist/resources/extensions/coworker-artifacts/artifacts-command.js +31 -0
  8. package/dist/resources/extensions/coworker-artifacts/artifacts-singleton.js +17 -0
  9. package/dist/resources/extensions/coworker-artifacts/extension-manifest.json +13 -0
  10. package/dist/resources/extensions/coworker-artifacts/index.js +125 -0
  11. package/dist/resources/extensions/coworker-artifacts/list-tool.js +27 -0
  12. package/dist/resources/extensions/coworker-artifacts/open-tool.js +25 -0
  13. package/dist/resources/extensions/coworker-memory/extension-manifest.json +13 -0
  14. package/dist/resources/extensions/coworker-memory/index.js +219 -0
  15. package/dist/resources/extensions/coworker-memory/memorize-tool.js +10 -0
  16. package/dist/resources/extensions/coworker-memory/memory-command.js +157 -0
  17. package/dist/resources/extensions/coworker-memory/memory-singleton.js +55 -0
  18. package/dist/resources/extensions/coworker-memory/recall-tool.js +18 -0
  19. package/dist/resources/extensions/coworker-memory/session-hooks.js +45 -0
  20. package/dist/resources/extensions/coworker-scratchpad/attach-banners.js +53 -0
  21. package/dist/resources/extensions/coworker-scratchpad/extension-manifest.json +13 -0
  22. package/dist/resources/extensions/coworker-scratchpad/format-age.js +9 -0
  23. package/dist/resources/extensions/coworker-scratchpad/helpers.js +38 -0
  24. package/dist/resources/extensions/coworker-scratchpad/index.js +199 -0
  25. package/dist/resources/extensions/coworker-scratchpad/mime-bundle.js +20 -0
  26. package/dist/resources/extensions/coworker-scratchpad/scratchpad-tool.js +118 -0
  27. package/dist/resources/extensions/coworker-scratchpad/session-sidecar.js +60 -0
  28. package/dist/resources/extensions/coworker-scratchpad/sp-command.js +597 -0
  29. package/dist/resources/extensions/coworker-scratchpad/workspace-pointer.js +41 -0
  30. package/dist/resources/extensions/coworker-scratchpad/workspace-root.js +17 -0
  31. package/dist/resources/extensions/coworker-vault/audit-command.js +35 -0
  32. package/dist/resources/extensions/coworker-vault/connect-command.js +42 -0
  33. package/dist/resources/extensions/coworker-vault/datasource-command.js +50 -0
  34. package/dist/resources/extensions/coworker-vault/extension-manifest.json +12 -0
  35. package/dist/resources/extensions/coworker-vault/index.js +171 -0
  36. package/dist/resources/extensions/coworker-vault/test-helpers.js +86 -0
  37. package/dist/resources/extensions/coworker-vault/vault-singleton.js +24 -0
  38. package/dist/resources/extensions/otto/commands/release-notes/_data.js +82 -0
  39. package/dist/resources/extensions/otto/commands/release-notes/command.js +15 -4
  40. package/dist/resources/extensions/subagent/index.js +8 -1
  41. package/dist/resources/extensions/subagent/launch.js +37 -5
  42. package/dist/resources/extensions/subagent/run-store.js +1 -0
  43. package/dist/resources/extensions/workflow/bootstrap/register-extension.js +2 -0
  44. package/dist/resources/extensions/workflow/bootstrap/register-hooks.js +10 -0
  45. package/dist/resources/extensions/workflow/persona-status.js +87 -0
  46. package/dist/update-cmd.d.ts +19 -0
  47. package/dist/update-cmd.js +177 -6
  48. package/package.json +25 -10
  49. package/packages/contracts/package.json +1 -1
  50. package/packages/coworker-artifacts/dist/artifact-store.d.ts +25 -0
  51. package/packages/coworker-artifacts/dist/artifact-store.js +187 -0
  52. package/packages/coworker-artifacts/dist/dir-snapshot.d.ts +7 -0
  53. package/packages/coworker-artifacts/dist/dir-snapshot.js +54 -0
  54. package/packages/coworker-artifacts/dist/errors.d.ts +18 -0
  55. package/packages/coworker-artifacts/dist/errors.js +37 -0
  56. package/packages/coworker-artifacts/dist/index.d.ts +7 -0
  57. package/packages/coworker-artifacts/dist/index.js +7 -0
  58. package/packages/coworker-artifacts/dist/readme-renderer.d.ts +5 -0
  59. package/packages/coworker-artifacts/dist/readme-renderer.js +47 -0
  60. package/packages/coworker-artifacts/dist/resolve-uri.d.ts +3 -0
  61. package/packages/coworker-artifacts/dist/resolve-uri.js +29 -0
  62. package/packages/coworker-artifacts/dist/slug.d.ts +4 -0
  63. package/packages/coworker-artifacts/dist/slug.js +32 -0
  64. package/packages/coworker-artifacts/dist/types.d.ts +52 -0
  65. package/packages/coworker-artifacts/dist/types.js +1 -0
  66. package/packages/coworker-artifacts/package.json +20 -0
  67. package/packages/coworker-artifacts/src/artifact-store.test.ts +188 -0
  68. package/packages/coworker-artifacts/src/artifact-store.ts +206 -0
  69. package/packages/coworker-artifacts/src/artifacts-integration.test.ts +109 -0
  70. package/packages/coworker-artifacts/src/dir-snapshot.test.ts +71 -0
  71. package/packages/coworker-artifacts/src/dir-snapshot.ts +52 -0
  72. package/packages/coworker-artifacts/src/errors.test.ts +37 -0
  73. package/packages/coworker-artifacts/src/errors.ts +28 -0
  74. package/packages/coworker-artifacts/src/index.test.ts +22 -0
  75. package/packages/coworker-artifacts/src/index.ts +7 -0
  76. package/packages/coworker-artifacts/src/readme-renderer.test.ts +72 -0
  77. package/packages/coworker-artifacts/src/readme-renderer.ts +56 -0
  78. package/packages/coworker-artifacts/src/resolve-uri.test.ts +46 -0
  79. package/packages/coworker-artifacts/src/resolve-uri.ts +29 -0
  80. package/packages/coworker-artifacts/src/slug.test.ts +47 -0
  81. package/packages/coworker-artifacts/src/slug.ts +31 -0
  82. package/packages/coworker-artifacts/src/types.ts +61 -0
  83. package/packages/coworker-artifacts/tsconfig.json +15 -0
  84. package/packages/coworker-artifacts/tsconfig.publish.json +4 -0
  85. package/packages/coworker-memory/dist/context-injection.d.ts +9 -0
  86. package/packages/coworker-memory/dist/context-injection.js +41 -0
  87. package/packages/coworker-memory/dist/errors.d.ts +25 -0
  88. package/packages/coworker-memory/dist/errors.js +51 -0
  89. package/packages/coworker-memory/dist/index.d.ts +12 -0
  90. package/packages/coworker-memory/dist/index.js +12 -0
  91. package/packages/coworker-memory/dist/layer-a-store.d.ts +16 -0
  92. package/packages/coworker-memory/dist/layer-a-store.js +78 -0
  93. package/packages/coworker-memory/dist/local-sqlite-backend.d.ts +28 -0
  94. package/packages/coworker-memory/dist/local-sqlite-backend.js +167 -0
  95. package/packages/coworker-memory/dist/memory-backend.d.ts +14 -0
  96. package/packages/coworker-memory/dist/memory-backend.js +1 -0
  97. package/packages/coworker-memory/dist/memory-recorder.d.ts +50 -0
  98. package/packages/coworker-memory/dist/memory-recorder.js +69 -0
  99. package/packages/coworker-memory/dist/migrations/001-init.sql +38 -0
  100. package/packages/coworker-memory/dist/migrations/002-artifact-kind.sql +50 -0
  101. package/packages/coworker-memory/dist/paste-detector.d.ts +5 -0
  102. package/packages/coworker-memory/dist/paste-detector.js +14 -0
  103. package/packages/coworker-memory/dist/persona-seed.d.ts +10 -0
  104. package/packages/coworker-memory/dist/persona-seed.js +38 -0
  105. package/packages/coworker-memory/dist/recall-formatter.d.ts +2 -0
  106. package/packages/coworker-memory/dist/recall-formatter.js +14 -0
  107. package/packages/coworker-memory/dist/scope-resolver.d.ts +9 -0
  108. package/packages/coworker-memory/dist/scope-resolver.js +10 -0
  109. package/packages/coworker-memory/dist/types.d.ts +51 -0
  110. package/packages/coworker-memory/dist/types.js +2 -0
  111. package/packages/coworker-memory/dist/workspace-id.d.ts +3 -0
  112. package/packages/coworker-memory/dist/workspace-id.js +54 -0
  113. package/packages/coworker-memory/package.json +35 -0
  114. package/packages/coworker-memory/src/activator-integration.test.ts +141 -0
  115. package/packages/coworker-memory/src/context-injection.test.ts +72 -0
  116. package/packages/coworker-memory/src/context-injection.ts +57 -0
  117. package/packages/coworker-memory/src/errors.test.ts +45 -0
  118. package/packages/coworker-memory/src/errors.ts +42 -0
  119. package/packages/coworker-memory/src/index.test.ts +21 -0
  120. package/packages/coworker-memory/src/index.ts +12 -0
  121. package/packages/coworker-memory/src/layer-a-store.test.ts +85 -0
  122. package/packages/coworker-memory/src/layer-a-store.ts +88 -0
  123. package/packages/coworker-memory/src/local-sqlite-backend.test.ts +110 -0
  124. package/packages/coworker-memory/src/local-sqlite-backend.ts +185 -0
  125. package/packages/coworker-memory/src/memory-backend.ts +10 -0
  126. package/packages/coworker-memory/src/memory-integration.test.ts +89 -0
  127. package/packages/coworker-memory/src/memory-recorder.test.ts +101 -0
  128. package/packages/coworker-memory/src/memory-recorder.ts +95 -0
  129. package/packages/coworker-memory/src/migrations/001-init.sql +38 -0
  130. package/packages/coworker-memory/src/migrations/002-artifact-kind.sql +50 -0
  131. package/packages/coworker-memory/src/paste-detector.test.ts +23 -0
  132. package/packages/coworker-memory/src/paste-detector.ts +18 -0
  133. package/packages/coworker-memory/src/persona-seed.test.ts +57 -0
  134. package/packages/coworker-memory/src/persona-seed.ts +46 -0
  135. package/packages/coworker-memory/src/recall-formatter.test.ts +34 -0
  136. package/packages/coworker-memory/src/recall-formatter.ts +15 -0
  137. package/packages/coworker-memory/src/scope-resolver.test.ts +23 -0
  138. package/packages/coworker-memory/src/scope-resolver.ts +18 -0
  139. package/packages/coworker-memory/src/types.ts +61 -0
  140. package/packages/coworker-memory/src/workspace-id.test.ts +48 -0
  141. package/packages/coworker-memory/src/workspace-id.ts +56 -0
  142. package/packages/coworker-memory/tsconfig.json +15 -0
  143. package/packages/coworker-memory/tsconfig.publish.json +4 -0
  144. package/packages/coworker-persona/dist/commands.d.ts +7 -0
  145. package/packages/coworker-persona/dist/commands.js +35 -0
  146. package/packages/coworker-persona/dist/defaults/manifest.yaml +12 -0
  147. package/packages/coworker-persona/dist/defaults/steering/identity.md +3 -0
  148. package/packages/coworker-persona/dist/index.d.ts +3 -0
  149. package/packages/coworker-persona/dist/index.js +3 -0
  150. package/packages/coworker-persona/dist/manifest.d.ts +24 -0
  151. package/packages/coworker-persona/dist/manifest.js +21 -0
  152. package/packages/coworker-persona/dist/registry.d.ts +22 -0
  153. package/packages/coworker-persona/dist/registry.js +142 -0
  154. package/packages/coworker-persona/package.json +28 -0
  155. package/packages/coworker-persona/scripts/copy-defaults.cjs +17 -0
  156. package/packages/coworker-persona/src/commands.ts +47 -0
  157. package/packages/coworker-persona/src/defaults/manifest.yaml +12 -0
  158. package/packages/coworker-persona/src/defaults/steering/identity.md +3 -0
  159. package/packages/coworker-persona/src/index.ts +3 -0
  160. package/packages/coworker-persona/src/manifest.test.ts +67 -0
  161. package/packages/coworker-persona/src/manifest.ts +49 -0
  162. package/packages/coworker-persona/src/registry.test.ts +89 -0
  163. package/packages/coworker-persona/src/registry.ts +147 -0
  164. package/packages/coworker-persona/tsconfig.json +15 -0
  165. package/packages/coworker-persona/tsconfig.publish.json +4 -0
  166. package/packages/coworker-scratchpad/dist/cell-archive.d.ts +39 -0
  167. package/packages/coworker-scratchpad/dist/cell-archive.js +77 -0
  168. package/packages/coworker-scratchpad/dist/cell-tree.d.ts +14 -0
  169. package/packages/coworker-scratchpad/dist/cell-tree.js +72 -0
  170. package/packages/coworker-scratchpad/dist/child-process-runtime.d.ts +129 -0
  171. package/packages/coworker-scratchpad/dist/child-process-runtime.js +427 -0
  172. package/packages/coworker-scratchpad/dist/collector-registry.d.ts +12 -0
  173. package/packages/coworker-scratchpad/dist/collector-registry.js +29 -0
  174. package/packages/coworker-scratchpad/dist/detect-kind.d.ts +3 -0
  175. package/packages/coworker-scratchpad/dist/detect-kind.js +19 -0
  176. package/packages/coworker-scratchpad/dist/file-collector.d.ts +15 -0
  177. package/packages/coworker-scratchpad/dist/file-collector.js +99 -0
  178. package/packages/coworker-scratchpad/dist/index.d.ts +13 -0
  179. package/packages/coworker-scratchpad/dist/index.js +13 -0
  180. package/packages/coworker-scratchpad/dist/kernel-bindings.d.ts +49 -0
  181. package/packages/coworker-scratchpad/dist/kernel-bindings.js +220 -0
  182. package/packages/coworker-scratchpad/dist/kernel-entry.d.ts +1 -0
  183. package/packages/coworker-scratchpad/dist/kernel-entry.js +355 -0
  184. package/packages/coworker-scratchpad/dist/kernel-protocol.d.ts +171 -0
  185. package/packages/coworker-scratchpad/dist/kernel-protocol.js +48 -0
  186. package/packages/coworker-scratchpad/dist/kernel-spawn.d.ts +3 -0
  187. package/packages/coworker-scratchpad/dist/kernel-spawn.js +54 -0
  188. package/packages/coworker-scratchpad/dist/namespace-codec.d.ts +22 -0
  189. package/packages/coworker-scratchpad/dist/namespace-codec.js +61 -0
  190. package/packages/coworker-scratchpad/dist/scratchpad-lock.d.ts +24 -0
  191. package/packages/coworker-scratchpad/dist/scratchpad-lock.js +86 -0
  192. package/packages/coworker-scratchpad/dist/scratchpad-manager.d.ts +193 -0
  193. package/packages/coworker-scratchpad/dist/scratchpad-manager.js +866 -0
  194. package/packages/coworker-scratchpad/dist/staleness-banner.d.ts +12 -0
  195. package/packages/coworker-scratchpad/dist/staleness-banner.js +27 -0
  196. package/packages/coworker-scratchpad/package.json +31 -0
  197. package/packages/coworker-scratchpad/src/cell-archive.test.ts +150 -0
  198. package/packages/coworker-scratchpad/src/cell-archive.ts +97 -0
  199. package/packages/coworker-scratchpad/src/cell-tree.test.ts +105 -0
  200. package/packages/coworker-scratchpad/src/cell-tree.ts +90 -0
  201. package/packages/coworker-scratchpad/src/child-process-runtime.test.ts +413 -0
  202. package/packages/coworker-scratchpad/src/child-process-runtime.ts +493 -0
  203. package/packages/coworker-scratchpad/src/collector-registry.test.ts +69 -0
  204. package/packages/coworker-scratchpad/src/collector-registry.ts +33 -0
  205. package/packages/coworker-scratchpad/src/detect-kind.test.ts +33 -0
  206. package/packages/coworker-scratchpad/src/detect-kind.ts +22 -0
  207. package/packages/coworker-scratchpad/src/file-collector.test.ts +109 -0
  208. package/packages/coworker-scratchpad/src/file-collector.ts +114 -0
  209. package/packages/coworker-scratchpad/src/index.ts +74 -0
  210. package/packages/coworker-scratchpad/src/kernel-bindings.test.ts +188 -0
  211. package/packages/coworker-scratchpad/src/kernel-bindings.ts +279 -0
  212. package/packages/coworker-scratchpad/src/kernel-entry.test.ts +123 -0
  213. package/packages/coworker-scratchpad/src/kernel-entry.ts +390 -0
  214. package/packages/coworker-scratchpad/src/kernel-protocol.test.ts +105 -0
  215. package/packages/coworker-scratchpad/src/kernel-protocol.ts +230 -0
  216. package/packages/coworker-scratchpad/src/kernel-spawn.test.ts +60 -0
  217. package/packages/coworker-scratchpad/src/kernel-spawn.ts +54 -0
  218. package/packages/coworker-scratchpad/src/namespace-codec.test.ts +102 -0
  219. package/packages/coworker-scratchpad/src/namespace-codec.ts +90 -0
  220. package/packages/coworker-scratchpad/src/scratchpad-lock.test.ts +98 -0
  221. package/packages/coworker-scratchpad/src/scratchpad-lock.ts +102 -0
  222. package/packages/coworker-scratchpad/src/scratchpad-manager.test.ts +1343 -0
  223. package/packages/coworker-scratchpad/src/scratchpad-manager.ts +891 -0
  224. package/packages/coworker-scratchpad/src/staleness-banner.test.ts +53 -0
  225. package/packages/coworker-scratchpad/src/staleness-banner.ts +33 -0
  226. package/packages/coworker-scratchpad/src/vault-integration.test.ts +221 -0
  227. package/packages/coworker-scratchpad/tsconfig.json +15 -0
  228. package/packages/coworker-scratchpad/tsconfig.publish.json +4 -0
  229. package/packages/coworker-types/dist/artifacts.d.ts +31 -0
  230. package/packages/coworker-types/dist/artifacts.js +2 -0
  231. package/packages/coworker-types/dist/contracts.d.ts +32 -0
  232. package/packages/coworker-types/dist/contracts.js +1 -0
  233. package/packages/coworker-types/dist/index.d.ts +5 -0
  234. package/packages/coworker-types/dist/index.js +5 -0
  235. package/packages/coworker-types/dist/memory.d.ts +61 -0
  236. package/packages/coworker-types/dist/memory.js +3 -0
  237. package/packages/coworker-types/dist/scratchpad.d.ts +43 -0
  238. package/packages/coworker-types/dist/scratchpad.js +2 -0
  239. package/packages/coworker-types/dist/vault.d.ts +34 -0
  240. package/packages/coworker-types/dist/vault.js +2 -0
  241. package/packages/coworker-types/package.json +24 -0
  242. package/packages/coworker-types/src/artifacts.test.ts +52 -0
  243. package/packages/coworker-types/src/artifacts.ts +35 -0
  244. package/packages/coworker-types/src/contracts.test.ts +43 -0
  245. package/packages/coworker-types/src/contracts.ts +36 -0
  246. package/packages/coworker-types/src/index.ts +5 -0
  247. package/packages/coworker-types/src/memory.test.ts +50 -0
  248. package/packages/coworker-types/src/memory.ts +79 -0
  249. package/packages/coworker-types/src/scratchpad.test.ts +46 -0
  250. package/packages/coworker-types/src/scratchpad.ts +51 -0
  251. package/packages/coworker-types/src/smoke.test.ts +34 -0
  252. package/packages/coworker-types/src/vault.test.ts +49 -0
  253. package/packages/coworker-types/src/vault.ts +40 -0
  254. package/packages/coworker-types/tsconfig.json +15 -0
  255. package/packages/coworker-types/tsconfig.publish.json +4 -0
  256. package/packages/coworker-utils/dist/audit-log.d.ts +34 -0
  257. package/packages/coworker-utils/dist/audit-log.js +88 -0
  258. package/packages/coworker-utils/dist/index.d.ts +6 -0
  259. package/packages/coworker-utils/dist/index.js +6 -0
  260. package/packages/coworker-utils/dist/lease.d.ts +7 -0
  261. package/packages/coworker-utils/dist/lease.js +67 -0
  262. package/packages/coworker-utils/dist/logger.d.ts +13 -0
  263. package/packages/coworker-utils/dist/logger.js +26 -0
  264. package/packages/coworker-utils/dist/migration-runner.d.ts +7 -0
  265. package/packages/coworker-utils/dist/migration-runner.js +36 -0
  266. package/packages/coworker-utils/dist/ndjson-channel.d.ts +3 -0
  267. package/packages/coworker-utils/dist/ndjson-channel.js +38 -0
  268. package/packages/coworker-utils/dist/secret-scanner.d.ts +10 -0
  269. package/packages/coworker-utils/dist/secret-scanner.js +42 -0
  270. package/packages/coworker-utils/package.json +24 -0
  271. package/packages/coworker-utils/src/audit-log.test.ts +140 -0
  272. package/packages/coworker-utils/src/audit-log.ts +107 -0
  273. package/packages/coworker-utils/src/index.ts +6 -0
  274. package/packages/coworker-utils/src/lease.test.ts +64 -0
  275. package/packages/coworker-utils/src/lease.ts +76 -0
  276. package/packages/coworker-utils/src/logger.test.ts +50 -0
  277. package/packages/coworker-utils/src/logger.ts +45 -0
  278. package/packages/coworker-utils/src/migration-runner.test.ts +65 -0
  279. package/packages/coworker-utils/src/migration-runner.ts +50 -0
  280. package/packages/coworker-utils/src/ndjson-channel.test.ts +76 -0
  281. package/packages/coworker-utils/src/ndjson-channel.ts +41 -0
  282. package/packages/coworker-utils/src/secret-scanner.test.ts +61 -0
  283. package/packages/coworker-utils/src/secret-scanner.ts +56 -0
  284. package/packages/coworker-utils/tsconfig.json +15 -0
  285. package/packages/coworker-utils/tsconfig.publish.json +4 -0
  286. package/packages/coworker-vault/dist/data-vault.d.ts +41 -0
  287. package/packages/coworker-vault/dist/data-vault.js +223 -0
  288. package/packages/coworker-vault/dist/engine-registry.d.ts +34 -0
  289. package/packages/coworker-vault/dist/engine-registry.js +90 -0
  290. package/packages/coworker-vault/dist/engines/jira.yaml +17 -0
  291. package/packages/coworker-vault/dist/errors.d.ts +28 -0
  292. package/packages/coworker-vault/dist/errors.js +57 -0
  293. package/packages/coworker-vault/dist/index.d.ts +6 -0
  294. package/packages/coworker-vault/dist/index.js +6 -0
  295. package/packages/coworker-vault/dist/injector.d.ts +19 -0
  296. package/packages/coworker-vault/dist/injector.js +77 -0
  297. package/packages/coworker-vault/dist/types.d.ts +28 -0
  298. package/packages/coworker-vault/dist/types.js +1 -0
  299. package/packages/coworker-vault/dist/vault-keep.d.ts +4 -0
  300. package/packages/coworker-vault/dist/vault-keep.js +21 -0
  301. package/packages/coworker-vault/package.json +29 -0
  302. package/packages/coworker-vault/src/data-vault.test.ts +199 -0
  303. package/packages/coworker-vault/src/data-vault.ts +257 -0
  304. package/packages/coworker-vault/src/engine-registry.test.ts +120 -0
  305. package/packages/coworker-vault/src/engine-registry.ts +107 -0
  306. package/packages/coworker-vault/src/engines/jira.yaml +17 -0
  307. package/packages/coworker-vault/src/errors.test.ts +58 -0
  308. package/packages/coworker-vault/src/errors.ts +50 -0
  309. package/packages/coworker-vault/src/index.test.ts +24 -0
  310. package/packages/coworker-vault/src/index.ts +6 -0
  311. package/packages/coworker-vault/src/injector.test.ts +109 -0
  312. package/packages/coworker-vault/src/injector.ts +98 -0
  313. package/packages/coworker-vault/src/types.ts +33 -0
  314. package/packages/coworker-vault/src/vault-keep.test.ts +49 -0
  315. package/packages/coworker-vault/src/vault-keep.ts +31 -0
  316. package/packages/coworker-vault/tsconfig.json +15 -0
  317. package/packages/coworker-vault/tsconfig.publish.json +4 -0
  318. package/packages/daemon/package.json +3 -3
  319. package/packages/mcp-server/package.json +3 -3
  320. package/packages/mcp-server/tsconfig.tsbuildinfo +1 -1
  321. package/packages/native/package.json +1 -1
  322. package/packages/native/tsconfig.tsbuildinfo +1 -1
  323. package/packages/pi-agent-core/package.json +1 -1
  324. package/packages/pi-agent-core/tsconfig.tsbuildinfo +1 -1
  325. package/packages/pi-ai/package.json +1 -1
  326. package/packages/pi-ai/tsconfig.tsbuildinfo +1 -1
  327. package/packages/pi-coding-agent/dist/core/extensions/runner.d.ts +6 -1
  328. package/packages/pi-coding-agent/dist/core/extensions/runner.d.ts.map +1 -1
  329. package/packages/pi-coding-agent/dist/core/extensions/runner.js +22 -3
  330. package/packages/pi-coding-agent/dist/core/extensions/runner.js.map +1 -1
  331. package/packages/pi-coding-agent/dist/core/resolve-config-value.test.js +11 -0
  332. package/packages/pi-coding-agent/dist/core/resolve-config-value.test.js.map +1 -1
  333. package/packages/pi-coding-agent/dist/modes/rpc/raw-stdout.d.ts +47 -0
  334. package/packages/pi-coding-agent/dist/modes/rpc/raw-stdout.d.ts.map +1 -0
  335. package/packages/pi-coding-agent/dist/modes/rpc/raw-stdout.js +107 -0
  336. package/packages/pi-coding-agent/dist/modes/rpc/raw-stdout.js.map +1 -0
  337. package/packages/pi-coding-agent/dist/modes/rpc/raw-stdout.regression.test.d.ts +19 -0
  338. package/packages/pi-coding-agent/dist/modes/rpc/raw-stdout.regression.test.d.ts.map +1 -0
  339. package/packages/pi-coding-agent/dist/modes/rpc/raw-stdout.regression.test.js +121 -0
  340. package/packages/pi-coding-agent/dist/modes/rpc/raw-stdout.regression.test.js.map +1 -0
  341. package/packages/pi-coding-agent/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  342. package/packages/pi-coding-agent/dist/modes/rpc/rpc-mode.js +17 -1
  343. package/packages/pi-coding-agent/dist/modes/rpc/rpc-mode.js.map +1 -1
  344. package/packages/pi-coding-agent/package.json +2 -2
  345. package/packages/pi-coding-agent/src/core/extensions/runner.ts +22 -3
  346. package/packages/pi-coding-agent/src/core/resolve-config-value.test.ts +11 -0
  347. package/packages/pi-coding-agent/src/modes/rpc/raw-stdout.regression.test.ts +129 -0
  348. package/packages/pi-coding-agent/src/modes/rpc/raw-stdout.ts +117 -0
  349. package/packages/pi-coding-agent/src/modes/rpc/rpc-mode.ts +18 -1
  350. package/packages/pi-coding-agent/tsconfig.tsbuildinfo +1 -1
  351. package/packages/pi-tui/package.json +1 -1
  352. package/packages/pi-tui/tsconfig.tsbuildinfo +1 -1
  353. package/packages/rpc-client/package.json +2 -2
  354. package/packages/rpc-client/tsconfig.tsbuildinfo +1 -1
  355. package/pkg/package.json +1 -1
  356. package/scripts/install.js +6 -5
  357. package/src/resources/extensions/_coworker-paths.test.ts +40 -0
  358. package/src/resources/extensions/_coworker-paths.ts +10 -0
  359. package/src/resources/extensions/coworker-artifacts/artifacts-command.test.ts +54 -0
  360. package/src/resources/extensions/coworker-artifacts/artifacts-command.ts +43 -0
  361. package/src/resources/extensions/coworker-artifacts/artifacts-singleton.test.ts +25 -0
  362. package/src/resources/extensions/coworker-artifacts/artifacts-singleton.ts +29 -0
  363. package/src/resources/extensions/coworker-artifacts/extension-manifest.json +13 -0
  364. package/src/resources/extensions/coworker-artifacts/index.test.ts +46 -0
  365. package/src/resources/extensions/coworker-artifacts/index.ts +154 -0
  366. package/src/resources/extensions/coworker-artifacts/list-tool.test.ts +29 -0
  367. package/src/resources/extensions/coworker-artifacts/list-tool.ts +53 -0
  368. package/src/resources/extensions/coworker-artifacts/open-tool.test.ts +30 -0
  369. package/src/resources/extensions/coworker-artifacts/open-tool.ts +43 -0
  370. package/src/resources/extensions/coworker-memory/extension-manifest.json +13 -0
  371. package/src/resources/extensions/coworker-memory/index.test.ts +137 -0
  372. package/src/resources/extensions/coworker-memory/index.ts +257 -0
  373. package/src/resources/extensions/coworker-memory/memorize-tool.test.ts +41 -0
  374. package/src/resources/extensions/coworker-memory/memorize-tool.ts +20 -0
  375. package/src/resources/extensions/coworker-memory/memory-command.test.ts +134 -0
  376. package/src/resources/extensions/coworker-memory/memory-command.ts +131 -0
  377. package/src/resources/extensions/coworker-memory/memory-singleton.test.ts +41 -0
  378. package/src/resources/extensions/coworker-memory/memory-singleton.ts +89 -0
  379. package/src/resources/extensions/coworker-memory/recall-tool.test.ts +50 -0
  380. package/src/resources/extensions/coworker-memory/recall-tool.ts +35 -0
  381. package/src/resources/extensions/coworker-memory/session-hooks.test.ts +77 -0
  382. package/src/resources/extensions/coworker-memory/session-hooks.ts +61 -0
  383. package/src/resources/extensions/coworker-scratchpad/attach-banners.test.ts +124 -0
  384. package/src/resources/extensions/coworker-scratchpad/attach-banners.ts +67 -0
  385. package/src/resources/extensions/coworker-scratchpad/extension-manifest.json +13 -0
  386. package/src/resources/extensions/coworker-scratchpad/format-age.test.ts +30 -0
  387. package/src/resources/extensions/coworker-scratchpad/format-age.ts +6 -0
  388. package/src/resources/extensions/coworker-scratchpad/helpers.test.ts +93 -0
  389. package/src/resources/extensions/coworker-scratchpad/helpers.ts +42 -0
  390. package/src/resources/extensions/coworker-scratchpad/index.test.ts +514 -0
  391. package/src/resources/extensions/coworker-scratchpad/index.ts +207 -0
  392. package/src/resources/extensions/coworker-scratchpad/mime-bundle.test.ts +61 -0
  393. package/src/resources/extensions/coworker-scratchpad/mime-bundle.ts +23 -0
  394. package/src/resources/extensions/coworker-scratchpad/scratchpad-tool.test.ts +137 -0
  395. package/src/resources/extensions/coworker-scratchpad/scratchpad-tool.ts +165 -0
  396. package/src/resources/extensions/coworker-scratchpad/session-sidecar.test.ts +133 -0
  397. package/src/resources/extensions/coworker-scratchpad/session-sidecar.ts +68 -0
  398. package/src/resources/extensions/coworker-scratchpad/sp-command.test.ts +836 -0
  399. package/src/resources/extensions/coworker-scratchpad/sp-command.ts +602 -0
  400. package/src/resources/extensions/coworker-scratchpad/workspace-pointer.test.ts +74 -0
  401. package/src/resources/extensions/coworker-scratchpad/workspace-pointer.ts +55 -0
  402. package/src/resources/extensions/coworker-scratchpad/workspace-root.test.ts +51 -0
  403. package/src/resources/extensions/coworker-scratchpad/workspace-root.ts +16 -0
  404. package/src/resources/extensions/coworker-vault/audit-command.test.ts +109 -0
  405. package/src/resources/extensions/coworker-vault/audit-command.ts +56 -0
  406. package/src/resources/extensions/coworker-vault/connect-command.test.ts +103 -0
  407. package/src/resources/extensions/coworker-vault/connect-command.ts +69 -0
  408. package/src/resources/extensions/coworker-vault/datasource-command.test.ts +80 -0
  409. package/src/resources/extensions/coworker-vault/datasource-command.ts +81 -0
  410. package/src/resources/extensions/coworker-vault/extension-manifest.json +12 -0
  411. package/src/resources/extensions/coworker-vault/index.test.ts +82 -0
  412. package/src/resources/extensions/coworker-vault/index.ts +181 -0
  413. package/src/resources/extensions/coworker-vault/test-helpers.ts +120 -0
  414. package/src/resources/extensions/coworker-vault/vault-singleton.test.ts +27 -0
  415. package/src/resources/extensions/coworker-vault/vault-singleton.ts +40 -0
  416. package/src/resources/extensions/otto/commands/release-notes/_data.ts +96 -0
  417. package/src/resources/extensions/otto/commands/release-notes/command.ts +16 -3
  418. package/src/resources/extensions/subagent/index.ts +9 -0
  419. package/src/resources/extensions/subagent/launch.test.ts +97 -0
  420. package/src/resources/extensions/subagent/launch.ts +42 -5
  421. package/src/resources/extensions/subagent/run-store.ts +3 -1
  422. package/src/resources/extensions/workflow/bootstrap/register-extension.ts +2 -0
  423. package/src/resources/extensions/workflow/bootstrap/register-hooks.ts +10 -0
  424. package/src/resources/extensions/workflow/persona-status.ts +109 -0
  425. package/src/resources/extensions/workflow/tests/auto-recovery.test.ts +34 -0
@@ -0,0 +1,28 @@
1
+ // packages/coworker-artifacts/src/errors.ts
2
+ export class ArtifactNotFound extends Error {
3
+ constructor(public readonly slug: string) {
4
+ super(`Artifact not found: ${slug}. /artifacts list to see available.`);
5
+ this.name = 'ArtifactNotFound';
6
+ }
7
+ }
8
+
9
+ export class ArtifactKindRejected extends Error {
10
+ constructor(public readonly kind: string) {
11
+ super(`Artifact kind '${kind}' is not supported. v1 ships only 'report'.`);
12
+ this.name = 'ArtifactKindRejected';
13
+ }
14
+ }
15
+
16
+ export class ArtifactUriMalformed extends Error {
17
+ constructor(public readonly uri: string, public readonly reason: string) {
18
+ super(`Bad artifact URI ${uri}: ${reason}.`);
19
+ this.name = 'ArtifactUriMalformed';
20
+ }
21
+ }
22
+
23
+ export class ArtifactSlugCollision extends Error {
24
+ constructor(public readonly base: string, public readonly attempts: number) {
25
+ super(`Slug collision: '${base}' has ${attempts} colliding suffixes (-2…-${attempts + 1}). Pick a different name.`);
26
+ this.name = 'ArtifactSlugCollision';
27
+ }
28
+ }
@@ -0,0 +1,22 @@
1
+ import { describe, it } from 'node:test';
2
+ import assert from 'node:assert/strict';
3
+ import * as artifacts from './index.js';
4
+
5
+ describe('@otto/coworker-artifacts barrel', () => {
6
+ it('exports key surface', () => {
7
+ assert.equal(typeof artifacts.ArtifactStore, 'function');
8
+ assert.equal(typeof artifacts.deriveSlug, 'function');
9
+ assert.equal(typeof artifacts.nextCollisionSlug, 'function');
10
+ assert.equal(typeof artifacts.takeSnapshot, 'function');
11
+ assert.equal(typeof artifacts.diffSnapshots, 'function');
12
+ assert.equal(typeof artifacts.resolveArtifactUri, 'function');
13
+ assert.equal(typeof artifacts.renderReadme, 'function');
14
+ assert.equal(artifacts.ARTIFACT_URI_SCHEME, 'artifact://');
15
+ });
16
+ it('exports error classes', () => {
17
+ assert.equal(typeof artifacts.ArtifactNotFound, 'function');
18
+ assert.equal(typeof artifacts.ArtifactKindRejected, 'function');
19
+ assert.equal(typeof artifacts.ArtifactUriMalformed, 'function');
20
+ assert.equal(typeof artifacts.ArtifactSlugCollision, 'function');
21
+ });
22
+ });
@@ -0,0 +1,7 @@
1
+ export * from './types.js';
2
+ export * from './errors.js';
3
+ export * from './slug.js';
4
+ export * from './dir-snapshot.js';
5
+ export * from './resolve-uri.js';
6
+ export * from './readme-renderer.js';
7
+ export * from './artifact-store.js';
@@ -0,0 +1,72 @@
1
+ // packages/coworker-artifacts/src/readme-renderer.test.ts
2
+ import { describe, it } from 'node:test';
3
+ import assert from 'node:assert/strict';
4
+ import { renderReadme } from './readme-renderer.js';
5
+ import type { ArtifactMetadata, Provenance } from './types.js';
6
+
7
+ const META: ArtifactMetadata = {
8
+ _schema: 1,
9
+ slug: 'rca-1',
10
+ kind: 'report',
11
+ name: 'RCA: load balancer 503',
12
+ created_at: '2026-06-02T14:32:00Z',
13
+ last_updated_at: '2026-06-02T15:18:00Z',
14
+ turn_count: 2,
15
+ primary_file: 'report.md',
16
+ uri: 'artifact://rca-1',
17
+ };
18
+
19
+ const PROV: Provenance = [
20
+ {
21
+ _schema: 1, ts: '2026-06-02T14:32:00Z', action: 'create',
22
+ turn_id: 'turn-abc', agent_turn_id: 'agent-xyz',
23
+ user_prompt: 'draft the RCA', scratchpad_name: 'p1',
24
+ files_touched: ['report.md'],
25
+ },
26
+ {
27
+ _schema: 1, ts: '2026-06-02T15:18:00Z', action: 'update',
28
+ turn_id: 'turn-def', user_prompt: 'add timeline',
29
+ scratchpad_name: 'p1', files_touched: ['report.md'],
30
+ },
31
+ ];
32
+
33
+ describe('renderReadme', () => {
34
+ it('renders header with name + uri + dates + turn count', () => {
35
+ const md = renderReadme(META, PROV, [{ path: 'report.md', sizeBytes: 4200 }]);
36
+ assert.match(md, /^# RCA: load balancer 503/m);
37
+ assert.match(md, /\*\*Kind:\*\* report/);
38
+ assert.match(md, /\*\*URI:\*\* `artifact:\/\/rca-1`/);
39
+ assert.match(md, /\*\*Created:\*\* 2026-06-02T14:32:00Z/);
40
+ assert.match(md, /\*\*Last updated:\*\* 2026-06-02T15:18:00Z/);
41
+ assert.match(md, /\*\*Turns:\*\* 2/);
42
+ });
43
+ it('renders files section with human-readable sizes', () => {
44
+ const md = renderReadme(META, PROV, [{ path: 'report.md', sizeBytes: 4200 }]);
45
+ assert.match(md, /## Files/);
46
+ assert.match(md, /`report.md` — 4\.1 KB/);
47
+ });
48
+ it('renders provenance table', () => {
49
+ const md = renderReadme(META, PROV, [{ path: 'report.md', sizeBytes: 4200 }]);
50
+ assert.match(md, /## Provenance/);
51
+ assert.match(md, /\| # \| ts \| action \| turn \| prompt \|/);
52
+ assert.match(md, /\| 1 \| 2026-06-02T14:32:00Z \| create \| turn-abc \| draft the RCA \|/);
53
+ assert.match(md, /\| 2 \| 2026-06-02T15:18:00Z \| update \| turn-def \| add timeline \|/);
54
+ });
55
+ it('is deterministic — same inputs produce byte-identical output', () => {
56
+ const a = renderReadme(META, PROV, [{ path: 'report.md', sizeBytes: 4200 }]);
57
+ const b = renderReadme(META, PROV, [{ path: 'report.md', sizeBytes: 4200 }]);
58
+ assert.equal(a, b);
59
+ });
60
+ it('handles empty provenance', () => {
61
+ const md = renderReadme(META, [], [{ path: 'report.md', sizeBytes: 0 }]);
62
+ assert.match(md, /## Provenance/);
63
+ // No table rows beyond header
64
+ const tableRows = (md.match(/^\| \d+ \|/gm) ?? []).length;
65
+ assert.equal(tableRows, 0);
66
+ });
67
+ it('handles empty file stats', () => {
68
+ const md = renderReadme(META, PROV, []);
69
+ assert.match(md, /## Files/);
70
+ assert.match(md, /\(none\)/);
71
+ });
72
+ });
@@ -0,0 +1,56 @@
1
+ // packages/coworker-artifacts/src/readme-renderer.ts
2
+ import type { ArtifactMetadata, Provenance } from './types.js';
3
+
4
+ const UNITS = ['B', 'KB', 'MB', 'GB'] as const;
5
+
6
+ function humanSize(bytes: number): string {
7
+ if (bytes < 1024) return `${bytes} B`;
8
+ let value = bytes;
9
+ let unit = 0;
10
+ while (value >= 1024 && unit < UNITS.length - 1) {
11
+ value /= 1024;
12
+ unit++;
13
+ }
14
+ return `${value.toFixed(1)} ${UNITS[unit]}`;
15
+ }
16
+
17
+ function escapeMarkdownPipe(s: string): string {
18
+ return s.replace(/\|/g, '\\|').replace(/\n/g, ' ');
19
+ }
20
+
21
+ export function renderReadme(
22
+ metadata: ArtifactMetadata,
23
+ provenance: Provenance,
24
+ fileStats: Array<{ path: string; sizeBytes: number }>,
25
+ ): string {
26
+ const firstTurn = provenance[0]?.turn_id ?? '';
27
+ const lastTurn = provenance.length > 0 ? provenance[provenance.length - 1]!.turn_id : '';
28
+
29
+ const lines: string[] = [];
30
+ lines.push(`# ${metadata.name}`);
31
+ lines.push('');
32
+ lines.push(`**Kind:** ${metadata.kind}`);
33
+ lines.push(`**URI:** \`${metadata.uri}\``);
34
+ lines.push(`**Created:** ${metadata.created_at}${firstTurn ? ` (turn \`${firstTurn}\`)` : ''}`);
35
+ lines.push(`**Last updated:** ${metadata.last_updated_at}${lastTurn ? ` (turn \`${lastTurn}\`)` : ''}`);
36
+ lines.push(`**Turns:** ${metadata.turn_count}`);
37
+ lines.push('');
38
+ lines.push('## Files');
39
+ lines.push('');
40
+ if (fileStats.length === 0) {
41
+ lines.push('(none)');
42
+ } else {
43
+ for (const f of fileStats) {
44
+ lines.push(`- \`${f.path}\` — ${humanSize(f.sizeBytes)}`);
45
+ }
46
+ }
47
+ lines.push('');
48
+ lines.push('## Provenance');
49
+ lines.push('');
50
+ lines.push('| # | ts | action | turn | prompt |');
51
+ lines.push('|---|---|---|---|---|');
52
+ provenance.forEach((e, i) => {
53
+ lines.push(`| ${i + 1} | ${e.ts} | ${e.action} | ${e.turn_id} | ${escapeMarkdownPipe(e.user_prompt)} |`);
54
+ });
55
+ return lines.join('\n') + '\n';
56
+ }
@@ -0,0 +1,46 @@
1
+ // packages/coworker-artifacts/src/resolve-uri.test.ts
2
+ import { describe, it } from 'node:test';
3
+ import assert from 'node:assert/strict';
4
+ import { resolveArtifactUri, ARTIFACT_URI_SCHEME } from './resolve-uri.js';
5
+ import { ArtifactUriMalformed } from './errors.js';
6
+
7
+ describe('resolveArtifactUri', () => {
8
+ const ws = '/tmp/workspace';
9
+ it('parses simple slug', () => {
10
+ const r = resolveArtifactUri('artifact://rca-1', ws);
11
+ assert.equal(r.slug, 'rca-1');
12
+ assert.equal(r.dir, '/tmp/workspace/.otto/artifacts/rca-1');
13
+ assert.equal(r.primaryPath, '/tmp/workspace/.otto/artifacts/rca-1/report.md');
14
+ assert.equal(r.metadataPath, '/tmp/workspace/.otto/artifacts/rca-1/metadata.json');
15
+ assert.equal(r.provenancePath, '/tmp/workspace/.otto/artifacts/rca-1/provenance.json');
16
+ assert.equal(r.readmePath, '/tmp/workspace/.otto/artifacts/rca-1/README.md');
17
+ });
18
+ it('accepts single-char slug', () => {
19
+ const r = resolveArtifactUri('artifact://x', ws);
20
+ assert.equal(r.slug, 'x');
21
+ });
22
+ it('rejects bad scheme', () => {
23
+ assert.throws(() => resolveArtifactUri('memory://x', ws), ArtifactUriMalformed);
24
+ });
25
+ it('rejects uppercase slug', () => {
26
+ assert.throws(() => resolveArtifactUri('artifact://RCA', ws), ArtifactUriMalformed);
27
+ });
28
+ it('rejects path traversal', () => {
29
+ assert.throws(() => resolveArtifactUri('artifact://../escape', ws), ArtifactUriMalformed);
30
+ });
31
+ it('rejects leading dash', () => {
32
+ assert.throws(() => resolveArtifactUri('artifact://-foo', ws), ArtifactUriMalformed);
33
+ });
34
+ it('rejects trailing dash', () => {
35
+ assert.throws(() => resolveArtifactUri('artifact://foo-', ws), ArtifactUriMalformed);
36
+ });
37
+ it('rejects > 64 chars', () => {
38
+ assert.throws(() => resolveArtifactUri(`artifact://${'a'.repeat(65)}`, ws), ArtifactUriMalformed);
39
+ });
40
+ it('rejects empty slug', () => {
41
+ assert.throws(() => resolveArtifactUri('artifact://', ws), ArtifactUriMalformed);
42
+ });
43
+ it('exports scheme constant', () => {
44
+ assert.equal(ARTIFACT_URI_SCHEME, 'artifact://');
45
+ });
46
+ });
@@ -0,0 +1,29 @@
1
+ // packages/coworker-artifacts/src/resolve-uri.ts
2
+ import { join } from 'node:path';
3
+ import { ArtifactUriMalformed } from './errors.js';
4
+ import type { ResolvedArtifactUri } from './types.js';
5
+
6
+ export const ARTIFACT_URI_SCHEME = 'artifact://';
7
+ const SLUG_REGEX = /^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$/;
8
+
9
+ export function resolveArtifactUri(uri: string, workspaceDir: string): ResolvedArtifactUri {
10
+ if (!uri.startsWith(ARTIFACT_URI_SCHEME)) {
11
+ throw new ArtifactUriMalformed(uri, `must start with ${ARTIFACT_URI_SCHEME}`);
12
+ }
13
+ const slug = uri.slice(ARTIFACT_URI_SCHEME.length);
14
+ if (!slug) throw new ArtifactUriMalformed(uri, 'empty slug');
15
+ if (slug.includes('..')) throw new ArtifactUriMalformed(uri, 'path traversal');
16
+ if (slug.length > 64) throw new ArtifactUriMalformed(uri, 'slug exceeds 64 chars');
17
+ if (!SLUG_REGEX.test(slug)) {
18
+ throw new ArtifactUriMalformed(uri, 'slug must match ^[a-z0-9][a-z0-9-]*[a-z0-9]$');
19
+ }
20
+ const dir = join(workspaceDir, '.otto', 'artifacts', slug);
21
+ return {
22
+ slug,
23
+ dir,
24
+ primaryPath: join(dir, 'report.md'),
25
+ metadataPath: join(dir, 'metadata.json'),
26
+ provenancePath: join(dir, 'provenance.json'),
27
+ readmePath: join(dir, 'README.md'),
28
+ };
29
+ }
@@ -0,0 +1,47 @@
1
+ // packages/coworker-artifacts/src/slug.test.ts
2
+ import { describe, it } from 'node:test';
3
+ import assert from 'node:assert/strict';
4
+ import { deriveSlug, nextCollisionSlug, MAX_COLLISION_ATTEMPTS } from './slug.js';
5
+ import { ArtifactSlugCollision } from './errors.js';
6
+
7
+ describe('deriveSlug', () => {
8
+ it('lowercases and kebab-cases simple input', () => {
9
+ assert.equal(deriveSlug('RCA: Load Balancer 503'), 'rca-load-balancer-503');
10
+ });
11
+ it('strips non-ASCII and punctuation', () => {
12
+ assert.equal(deriveSlug('résumé — final draft!'), 'resume-final-draft');
13
+ });
14
+ it('collapses runs of dashes', () => {
15
+ assert.equal(deriveSlug('foo --- bar'), 'foo-bar');
16
+ });
17
+ it('trims leading + trailing dashes', () => {
18
+ assert.equal(deriveSlug('---hello---'), 'hello');
19
+ });
20
+ it('truncates to 64 chars', () => {
21
+ const long = 'a'.repeat(100);
22
+ assert.equal(deriveSlug(long).length, 64);
23
+ });
24
+ it('produces fallback for fully-stripped input', () => {
25
+ assert.match(deriveSlug('!!!'), /^artifact-/);
26
+ });
27
+ it('single-char input is preserved', () => {
28
+ assert.equal(deriveSlug('x'), 'x');
29
+ });
30
+ });
31
+
32
+ describe('nextCollisionSlug', () => {
33
+ it('returns -2 on first collision', () => {
34
+ assert.equal(nextCollisionSlug('rca', new Set(['rca'])), 'rca-2');
35
+ });
36
+ it('skips already-taken numeric suffixes', () => {
37
+ assert.equal(nextCollisionSlug('rca', new Set(['rca', 'rca-2', 'rca-3'])), 'rca-4');
38
+ });
39
+ it('throws ArtifactSlugCollision after MAX_COLLISION_ATTEMPTS', () => {
40
+ const taken = new Set<string>(['rca']);
41
+ for (let i = 2; i <= MAX_COLLISION_ATTEMPTS + 1; i++) taken.add(`rca-${i}`);
42
+ assert.throws(() => nextCollisionSlug('rca', taken), ArtifactSlugCollision);
43
+ });
44
+ it('returns base if base not taken', () => {
45
+ assert.equal(nextCollisionSlug('rca', new Set()), 'rca');
46
+ });
47
+ });
@@ -0,0 +1,31 @@
1
+ // packages/coworker-artifacts/src/slug.ts
2
+ import { ArtifactSlugCollision } from './errors.js';
3
+
4
+ export const MAX_SLUG_LENGTH = 64;
5
+ export const MAX_COLLISION_ATTEMPTS = 100;
6
+
7
+ export function deriveSlug(name: string): string {
8
+ let s = name.toLowerCase();
9
+ // Strip diacritics (NFKD + remove combining marks U+0300–U+036F)
10
+ s = s.normalize('NFKD').replace(/[̀-ͯ]/g, '');
11
+ // Replace non a-z 0-9 with dash
12
+ s = s.replace(/[^a-z0-9]+/g, '-');
13
+ // Collapse runs of dashes
14
+ s = s.replace(/-+/g, '-');
15
+ // Trim leading/trailing dashes
16
+ s = s.replace(/^-+|-+$/g, '');
17
+ // Truncate
18
+ if (s.length > MAX_SLUG_LENGTH) s = s.slice(0, MAX_SLUG_LENGTH).replace(/-+$/, '');
19
+ // Fallback if empty
20
+ if (!s) s = `artifact-${Date.now().toString(36)}`;
21
+ return s;
22
+ }
23
+
24
+ export function nextCollisionSlug(base: string, taken: Set<string>): string {
25
+ if (!taken.has(base)) return base;
26
+ for (let n = 2; n <= MAX_COLLISION_ATTEMPTS + 1; n++) {
27
+ const candidate = `${base}-${n}`;
28
+ if (!taken.has(candidate)) return candidate;
29
+ }
30
+ throw new ArtifactSlugCollision(base, MAX_COLLISION_ATTEMPTS);
31
+ }
@@ -0,0 +1,61 @@
1
+ // packages/coworker-artifacts/src/types.ts
2
+ export type ArtifactKind = 'report';
3
+ export const ARTIFACT_KINDS = ['report'] as const;
4
+
5
+ export interface ArtifactHandle {
6
+ slug: string;
7
+ kind: ArtifactKind;
8
+ name: string;
9
+ dir: string;
10
+ uri: string;
11
+ primaryPath: string;
12
+ metadataPath: string;
13
+ provenancePath: string;
14
+ readmePath: string;
15
+ }
16
+
17
+ export interface ArtifactMetadata {
18
+ _schema: 1;
19
+ slug: string;
20
+ kind: ArtifactKind;
21
+ name: string;
22
+ created_at: string;
23
+ last_updated_at: string;
24
+ turn_count: number;
25
+ primary_file: string;
26
+ uri: string;
27
+ }
28
+
29
+ export interface TurnEntry {
30
+ _schema: 1;
31
+ ts: string;
32
+ action: 'create' | 'update';
33
+ turn_id: string;
34
+ agent_turn_id?: string;
35
+ user_prompt: string;
36
+ scratchpad_name?: string;
37
+ files_touched: string[];
38
+ }
39
+
40
+ export type Provenance = TurnEntry[];
41
+
42
+ export interface DirSnapshotEntry {
43
+ mtimeNs: bigint;
44
+ sizeBytes: number;
45
+ }
46
+
47
+ export type DirSnapshot = Map<string, DirSnapshotEntry>;
48
+
49
+ export interface FileWrite {
50
+ path: string;
51
+ content: string;
52
+ }
53
+
54
+ export interface ResolvedArtifactUri {
55
+ slug: string;
56
+ dir: string;
57
+ primaryPath: string;
58
+ metadataPath: string;
59
+ provenancePath: string;
60
+ readmePath: string;
61
+ }
@@ -0,0 +1,15 @@
1
+ {
2
+ "compilerOptions": {
3
+ "module": "NodeNext",
4
+ "moduleResolution": "NodeNext",
5
+ "target": "ES2022",
6
+ "outDir": "dist",
7
+ "rootDir": "src",
8
+ "strict": true,
9
+ "declaration": true,
10
+ "esModuleInterop": true,
11
+ "skipLibCheck": true
12
+ },
13
+ "include": ["src"],
14
+ "exclude": ["src/**/*.test.ts"]
15
+ }
@@ -0,0 +1,4 @@
1
+ {
2
+ "extends": "./tsconfig.json",
3
+ "compilerOptions": { "incremental": false }
4
+ }
@@ -0,0 +1,9 @@
1
+ import type { ScopeMode } from './types.js';
2
+ import type { LayerAStore } from './layer-a-store.js';
3
+ export interface ContextInjectionArgs {
4
+ mode: ScopeMode;
5
+ globalStore: LayerAStore;
6
+ workspaceStore: LayerAStore;
7
+ tokenLimit: number;
8
+ }
9
+ export declare function buildLayerAContext(args: ContextInjectionArgs): Promise<string>;
@@ -0,0 +1,41 @@
1
+ const CHARS_PER_TOKEN = 4;
2
+ export async function buildLayerAContext(args) {
3
+ const charLimit = args.tokenLimit * CHARS_PER_TOKEN;
4
+ const readScopes = args.mode === 'global'
5
+ ? ['global']
6
+ : args.mode === 'per-project'
7
+ ? ['workspace']
8
+ : ['workspace', 'global'];
9
+ const sections = [];
10
+ const PRIORITIES = { profile: 0, rules: 1, lessons: 2 };
11
+ for (const scope of readScopes) {
12
+ const store = scope === 'global' ? args.globalStore : args.workspaceStore;
13
+ const profile = await store.read('profile');
14
+ const rules = await store.read('rule');
15
+ const lessons = await store.read('lesson');
16
+ if (profile)
17
+ sections.push({ title: `Profile (${scope})`, body: profile, priority: PRIORITIES.profile });
18
+ if (rules)
19
+ sections.push({ title: `Rules (${scope})`, body: rules, priority: PRIORITIES.rules });
20
+ if (lessons)
21
+ sections.push({ title: `Recent lessons (${scope})`, body: lessons, priority: PRIORITIES.lessons });
22
+ }
23
+ if (sections.length === 0)
24
+ return '';
25
+ // workspace comes first because we iterated readScopes in that order; stable sort by priority.
26
+ sections.sort((a, b) => a.priority - b.priority);
27
+ let total = 0;
28
+ const include = [];
29
+ for (const s of sections) {
30
+ const cost = s.title.length + s.body.length + 10;
31
+ if (total + cost > charLimit && include.length > 0)
32
+ break;
33
+ include.push(s);
34
+ total += cost;
35
+ }
36
+ const lines = ['## Memory (Layer A)\n'];
37
+ for (const s of include) {
38
+ lines.push(`### ${s.title}\n${s.body}\n`);
39
+ }
40
+ return lines.join('\n');
41
+ }
@@ -0,0 +1,25 @@
1
+ export declare class MemoryNotInitialized extends Error {
2
+ readonly reason: string;
3
+ constructor(reason: string);
4
+ }
5
+ export declare class BackendUnavailable extends Error {
6
+ readonly reason: string;
7
+ constructor(reason: string);
8
+ }
9
+ export declare class DrawerKindRejected extends Error {
10
+ readonly kind: string;
11
+ constructor(kind: string);
12
+ }
13
+ export declare class LayerAWriteBlocked extends Error {
14
+ readonly secretKind: string;
15
+ constructor(secretKind: string);
16
+ }
17
+ export declare class RecallQueryMalformed extends Error {
18
+ readonly reason: string;
19
+ constructor(reason: string);
20
+ }
21
+ export declare class MemoryEntryMalformed extends Error {
22
+ readonly path: string;
23
+ readonly reason: string;
24
+ constructor(path: string, reason: string);
25
+ }
@@ -0,0 +1,51 @@
1
+ // packages/coworker-memory/src/errors.ts
2
+ export class MemoryNotInitialized extends Error {
3
+ reason;
4
+ constructor(reason) {
5
+ super(`Memory not initialized: ${reason}. /memory status to inspect.`);
6
+ this.reason = reason;
7
+ this.name = 'MemoryNotInitialized';
8
+ }
9
+ }
10
+ export class BackendUnavailable extends Error {
11
+ reason;
12
+ constructor(reason) {
13
+ super(`Memory backend unavailable: ${reason}.`);
14
+ this.reason = reason;
15
+ this.name = 'BackendUnavailable';
16
+ }
17
+ }
18
+ export class DrawerKindRejected extends Error {
19
+ kind;
20
+ constructor(kind) {
21
+ super(`Drawer kind '${kind}' is not in v1 vocabulary. Allowed: turn, paste, file_load, ticket, email, rca, note.`);
22
+ this.kind = kind;
23
+ this.name = 'DrawerKindRejected';
24
+ }
25
+ }
26
+ export class LayerAWriteBlocked extends Error {
27
+ secretKind;
28
+ constructor(secretKind) {
29
+ super(`Refused to store: contains secret-shaped value (kind: ${secretKind}). Remove the secret and retry. Vault entries should land in /connect, not memorize.`);
30
+ this.secretKind = secretKind;
31
+ this.name = 'LayerAWriteBlocked';
32
+ }
33
+ }
34
+ export class RecallQueryMalformed extends Error {
35
+ reason;
36
+ constructor(reason) {
37
+ super(`Bad recall query: ${reason}.`);
38
+ this.reason = reason;
39
+ this.name = 'RecallQueryMalformed';
40
+ }
41
+ }
42
+ export class MemoryEntryMalformed extends Error {
43
+ path;
44
+ reason;
45
+ constructor(path, reason) {
46
+ super(`Layer A file ${path} is malformed: ${reason}. Move it aside and re-create.`);
47
+ this.path = path;
48
+ this.reason = reason;
49
+ this.name = 'MemoryEntryMalformed';
50
+ }
51
+ }
@@ -0,0 +1,12 @@
1
+ export * from './types.js';
2
+ export * from './errors.js';
3
+ export * from './memory-backend.js';
4
+ export * from './workspace-id.js';
5
+ export * from './scope-resolver.js';
6
+ export * from './paste-detector.js';
7
+ export * from './layer-a-store.js';
8
+ export * from './local-sqlite-backend.js';
9
+ export * from './memory-recorder.js';
10
+ export * from './recall-formatter.js';
11
+ export * from './context-injection.js';
12
+ export * from './persona-seed.js';
@@ -0,0 +1,12 @@
1
+ export * from './types.js';
2
+ export * from './errors.js';
3
+ export * from './memory-backend.js';
4
+ export * from './workspace-id.js';
5
+ export * from './scope-resolver.js';
6
+ export * from './paste-detector.js';
7
+ export * from './layer-a-store.js';
8
+ export * from './local-sqlite-backend.js';
9
+ export * from './memory-recorder.js';
10
+ export * from './recall-formatter.js';
11
+ export * from './context-injection.js';
12
+ export * from './persona-seed.js';
@@ -0,0 +1,16 @@
1
+ import { AuditLog, SecretScanner } from '@otto/coworker-utils';
2
+ import type { LayerAEntry, LayerAKind } from './types.js';
3
+ export interface LayerAStoreOptions {
4
+ scopeDir: string;
5
+ scope: 'global' | 'workspace';
6
+ audit: AuditLog;
7
+ scanner: SecretScanner;
8
+ }
9
+ export declare class LayerAStore {
10
+ private readonly opts;
11
+ constructor(opts: LayerAStoreOptions);
12
+ append(entry: LayerAEntry): Promise<void>;
13
+ read(kind: LayerAKind): Promise<string>;
14
+ private split;
15
+ private composeFile;
16
+ }