@joe-broadhead/opencode-mem 0.8.5 → 0.9.1

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 (58) hide show
  1. package/CHANGELOG.md +512 -0
  2. package/README.md +127 -61
  3. package/docs/agent-protocol.md +67 -177
  4. package/package.json +1453 -100
  5. package/skills/mem.pages/SKILL.md +146 -0
  6. package/skills/mem.sharing/SKILL.md +91 -0
  7. package/skills/mem.sources/SKILL.md +94 -0
  8. package/skills/mem.usage/SKILL.md +129 -492
  9. package/src/backend/records.js +285 -0
  10. package/src/backend/v3.js +3 -0
  11. package/src/bootstrap.js +49 -45
  12. package/src/call-shapes.js +41 -10
  13. package/src/collector-lock.js +162 -0
  14. package/src/collector-service.js +441 -0
  15. package/src/collector.js +381 -0
  16. package/src/commands.js +3 -3
  17. package/src/config.js +15 -1
  18. package/src/credentials.js +26 -1
  19. package/src/curation.js +1 -1
  20. package/src/permissions.js +87 -10
  21. package/src/protocol.js +29 -20
  22. package/src/recall.js +104 -27
  23. package/src/records-store.js +267 -121
  24. package/src/records.js +63 -11
  25. package/src/runtime.js +23 -14
  26. package/src/skills.js +44 -18
  27. package/src/sources.js +58 -0
  28. package/src/spaces.js +93 -10
  29. package/src/tools/aliases.js +164 -0
  30. package/src/tools/commitments.js +12 -9
  31. package/src/tools/held-write.js +82 -0
  32. package/src/tools/index.js +100 -23
  33. package/src/tools/ingest.js +277 -0
  34. package/src/tools/knowledge.js +6 -1
  35. package/src/tools/memory.js +722 -229
  36. package/src/tools/page.js +423 -0
  37. package/src/tools/recall.js +371 -113
  38. package/src/tools/records-kit.js +142 -0
  39. package/src/tools/share.js +1042 -0
  40. package/src/tools/shared.js +16 -2
  41. package/src/tools/spaces.js +431 -143
  42. package/src/tools/status.js +87 -58
  43. package/src/tools/wiki.js +8 -4
  44. package/src/views/contracts.js +293 -3
  45. package/src/views/inbox-decision.js +59 -0
  46. package/src/views/recall-result.js +12 -0
  47. package/src/views/records-reads.js +675 -0
  48. package/src/views/rpc.js +58 -99
  49. package/src/views/shape.js +61 -0
  50. package/views/commitments.html +4 -0
  51. package/views/graph.html +753 -0
  52. package/views/home.html +11 -5
  53. package/views/journal.html +621 -0
  54. package/views/memory.html +7 -1
  55. package/views/pages.html +636 -0
  56. package/views/recall.html +123 -0
  57. package/views/review.html +406 -0
  58. package/views/today.html +309 -0
@@ -1,6 +1,7 @@
1
1
  import { contextScopeLabel, scopeLabel, taskKey } from "../scope.js"
2
2
  import { errorMessage, oneLine } from "../util.js"
3
3
  import { isCoded } from "../errors.js"
4
+ import { hasSharedWritePolicy } from "../permissions.js"
4
5
 
5
6
  /**
6
7
  * Roles that may write to a shared space. The plugin reads this from the
@@ -88,7 +89,12 @@ export function createToolkit(ctx, runtime) {
88
89
  invalid: `visibility=private uses your personal space; ${oneLine(requested, 80)} is not personal. Omit space or pass your personal space.`,
89
90
  }
90
91
  }
91
- return { context: resolved }
92
+ const personal = await runtime.captureContext(context?.sessionID, context?.agent, "private")
93
+ if (!personal || personal.space_kind !== "personal") throw new Error("the control plane returned no personal space")
94
+ if (resolved.space_id !== personal.space_id) {
95
+ return { invalid: `visibility=private uses your personal space; ${oneLine(requested, 80)} is not your personal space.` }
96
+ }
97
+ return { context: personal }
92
98
  }
93
99
  const personal = await runtime.captureContext(context?.sessionID, context?.agent, "private")
94
100
  if (!personal || personal.space_kind !== "personal") {
@@ -214,7 +220,7 @@ export function createToolkit(ctx, runtime) {
214
220
  return { key, declared: true }
215
221
  }
216
222
 
217
- /** Team-visible writes and deletes pass through the host approval gate. */
223
+ /** An assertion enforces host policy, but does not prove a prompt appeared. */
218
224
  async function assertTeamWrite(context, action, resources, metadata) {
219
225
  await ctx.permission.assert({
220
226
  sessionID: context?.sessionID,
@@ -225,6 +231,12 @@ export function createToolkit(ctx, runtime) {
225
231
  save: [],
226
232
  metadata,
227
233
  })
234
+ // On older hosts a default * allow may pass with no action policy. Require
235
+ // a visible action-specific rule there; never infer that a prompt appeared.
236
+ if (["memory.remember", "memory.revise", "page.write", "wiki.write"].includes(action) &&
237
+ !(await hasSharedWritePolicy(ctx, context, action, resources))) {
238
+ throw new Error(`no explicit permission rule for ${action} is visible on this host; no write was made. Add an allow or ask rule for ${action} (or memory.* for memory actions), or update OpenCode`)
239
+ }
228
240
  }
229
241
 
230
242
  /**
@@ -315,6 +327,8 @@ export function createToolkit(ctx, runtime) {
315
327
  log,
316
328
  control,
317
329
  runtime,
330
+ /** The project's directory: where mem_page export writes `.opencode-mem/exports/`. */
331
+ directory: typeof ctx?.location?.directory === "string" ? ctx.location.directory : "",
318
332
  scope: runtime.scope,
319
333
  scopeFor: runtime.scopeFor,
320
334
  resolveContext: runtime.resolveContext,