@shipers-dev/multi 0.51.0 → 0.52.0

package/dist/index.js

@@ -34148,7 +34148,7 @@ function parsePlanBlocks(text) {
   }
   return { actions, errors: errors3 };
 }
-var PLAN_SCHEMA_VERSION = 6, Priority, AssigneeType, IssueStatus, SessionRole, SkillFile, EvalPolicy, PlanActionSchema, PlanEnvelopeSchema, UiBlockSchema, UI_FENCE_RE, FENCE_RE;
+var PLAN_SCHEMA_VERSION = 7, Priority, AssigneeType, IssueStatus, SessionRole, SkillFile, EvalPolicy, PlanActionSchema, PlanEnvelopeSchema, UiBlockSchema, UI_FENCE_RE, FENCE_RE;
 var init_plans = __esm(() => {
   init_zod();
   Priority = exports_external.enum(["low", "medium", "high"]);
@@ -34268,6 +34268,20 @@ var init_plans = __esm(() => {
       score: exports_external.number().min(0).max(1),
       feedback: exports_external.string().min(1).max(8000),
       scores: exports_external.record(exports_external.string(), exports_external.number().min(0).max(1)).optional()
+    }),
+    exports_external.object({
+      type: exports_external.literal("memory.search"),
+      project_id: exports_external.string().optional(),
+      query: exports_external.string().min(1).max(1000),
+      limit: exports_external.number().int().min(1).max(50).optional()
+    }),
+    exports_external.object({
+      type: exports_external.literal("memory.write"),
+      project_id: exports_external.string().optional(),
+      text: exports_external.string().min(1).max(20000),
+      summary: exports_external.string().max(2000).optional(),
+      kind: exports_external.string().min(1).max(64).optional(),
+      source_id: exports_external.string().min(1).max(256).optional()
     })
   ]);
   PlanEnvelopeSchema = exports_external.object({
@@ -35366,7 +35380,9 @@ Issue actions:
   {"type":"issue.delete","id":"<issue id or key>"},
   {"type":"issue.delete_where","status":"todo"},
   {"type":"issue.list","status":"todo","assignee_id":"<agent id>","limit":20},
-  {"type":"issue.search","query":"flaky tests","limit":10}
+  {"type":"issue.search","query":"flaky tests","limit":10},
+  {"type":"memory.search","query":"how does the deploy pipeline work","limit":10},
+  {"type":"memory.write","text":"Long-form note worth remembering across sessions...","summary":"short index hint","kind":"agent_note"}
 ]}
 \`\`\`
 
@@ -35374,7 +35390,9 @@ Status values: \`todo\` | \`in_progress\` | \`blocked\` | \`done\` | \`archived\
 
 Prefer the bulk \`issue.delete_where\` over \`issue.list\` + per-issue \`issue.delete\` when the user's intent matches a filter ("delete all todo issues", "remove anything assigned to agent X"). It runs in one turn instead of two.
 
-Read actions (\`issue.list\`, \`issue.search\`) return the matched rows in the action summary comment. Use them to look up issue ids/keys before \`update\` / \`delegate\` / \`issue.delete\` ONLY when the per-row filter isn't enough (e.g. you need to inspect titles before acting).
+Read actions (\`issue.list\`, \`issue.search\`, \`memory.search\`) return the matched rows in the action summary comment. Use them to look up issue ids/keys before \`update\` / \`delegate\` / \`issue.delete\` ONLY when the per-row filter isn't enough (e.g. you need to inspect titles before acting).
+
+Memory actions are project-scoped persistent storage (FTS5 + vector). Use \`memory.search\` to recall facts learned in past sessions; the hits land in the next-turn context like \`issue.search\`. Use \`memory.write\` sparingly to record durable notes (decisions, gotchas, references) that will be useful to future agents on this project — not transient task state. \`kind\` defaults to \`agent_note\`; use a stable kind string (e.g. \`decision\`, \`gotcha\`) if you want to filter later.
 
 Agent + skill self-service (use sparingly — only when you genuinely need a new capability that isn't covered by an existing agent or skill):
 
@@ -35424,7 +35442,7 @@ async function executePlanActions(apiUrl, parentTask, actions, ctx, parseErrors
       results.push({ type: "note", status: "note", message: `${blocked3} non-update action(s) blocked (planning depth limit ${PLANNING_DEPTH_LIMIT})` });
     }
   }
-  const SUBCAPS = { "agent.create": 2, "skill.create": 3, "skill.attach": 5, "skill.detach": 5, "agent.update": 5, "session.create": 3 };
+  const SUBCAPS = { "agent.create": 2, "skill.create": 3, "skill.attach": 5, "skill.detach": 5, "agent.update": 5, "session.create": 3, "memory.search": 5, "memory.write": 5 };
   const counts = {};
   actions = actions.filter((a) => {
     const cap = SUBCAPS[a.type];
@@ -35606,6 +35624,57 @@ async function executePlanActions(apiUrl, parentTask, actions, ctx, parseErrors
           lines.push(`  - **${r.key}** [${r.status}] ${r.title}`);
         }
         results.push({ type: "issue.search", status: "ok", count: rows.length, query: a.query });
+      } else if (a.type === "memory.search") {
+        const projectId = a.project_id || parentProjectId;
+        if (!projectId) {
+          lines.push(`- [err] memory.search "${a.query}": no project_id`);
+          results.push({ type: "memory.search", status: "error", error: "no project_id", label: a.query });
+          continue;
+        }
+        const limit = a.limit ?? 10;
+        const qs = new URLSearchParams({ project_id: projectId, q: a.query, limit: String(limit) });
+        const res = await apiClient.get(`${apiUrl}/api/memory/search?${qs.toString()}`);
+        if (!res.success) {
+          lines.push(`- [err] memory.search "${a.query}": ${res.error || res.status}`);
+          results.push({ type: "memory.search", status: "error", error: String(res.error || res.status), label: a.query });
+          continue;
+        }
+        const rows = Array.isArray(res.data?.rows) ? res.data.rows : [];
+        if (!rows.length) {
+          lines.push(`- [ok] memory.search "${a.query}": 0 hits`);
+          results.push({ type: "memory.search", status: "ok", count: 0, query: a.query });
+          continue;
+        }
+        lines.push(`- [ok] memory.search "${a.query}": ${rows.length} hit(s)`);
+        for (const r of rows) {
+          const summary5 = (r.summary || r.text || "").replace(/\s+/g, " ").slice(0, 200);
+          lines.push(`  - [${r.source_kind || "memory"}] ${summary5}`);
+        }
+        results.push({ type: "memory.search", status: "ok", count: rows.length, query: a.query });
+      } else if (a.type === "memory.write") {
+        const projectId = a.project_id || parentProjectId;
+        if (!projectId) {
+          lines.push(`- [err] memory.write: no project_id`);
+          results.push({ type: "memory.write", status: "error", error: "no project_id" });
+          continue;
+        }
+        const body = {
+          project_id: projectId,
+          source_kind: a.kind || "agent_note",
+          source_id: a.source_id || `${parentTask.agent_id || "agent"}:${parentTask.issue_id || ""}:${Date.now()}`,
+          agent_id: parentTask.agent_id || null,
+          text: a.text,
+          summary: a.summary || null
+        };
+        const res = await apiClient.post(`${apiUrl}/api/memory/write`, body);
+        if (!res.success) {
+          lines.push(`- [err] memory.write: ${res.error || res.status}`);
+          results.push({ type: "memory.write", status: "error", error: String(res.error || res.status) });
+          continue;
+        }
+        const row = res.data?.row || {};
+        lines.push(`- [ok] memory.write -> ${row.id || "(no id)"}${row.embedding_id ? " (embedded)" : ""}`);
+        results.push({ type: "memory.write", status: "ok", memory_id: row.id, embedded: !!row.embedding_id });
       } else if (a.type === "agent.create") {
         if (!parentWsId) {
           lines.push(`- [err] agent.create "${a.name}": no tenant workspace id`);
@@ -36837,6 +36906,58 @@ async function executeChatPlanActions(actionsIn, parseErrors, ctx) {
           lines.push(`  - **${r.key}** [${r.status}] ${r.title}`);
         results.push({ type: "issue.search", status: "ok", count: rows.length, query: a.query });
         tally(true);
+      } else if (a.type === "memory.search") {
+        const project_id = a.project_id || ctx.projectId;
+        if (!project_id) {
+          lines.push(`- [err] memory.search "${a.query}": project_id required (chat has no pinned project)`);
+          results.push({ type: "memory.search", status: "error", error: "project_id required (chat has no pinned project)", label: a.query });
+          tally(false);
+          continue;
+        }
+        const limit = a.limit ?? 10;
+        const qs = new URLSearchParams({ project_id, q: a.query, limit: String(limit) });
+        const res = await apiClient.get(`${ctx.apiUrl}/api/memory/search?${qs.toString()}`);
+        if (!res.success) {
+          lines.push(`- [err] memory.search "${a.query}": ${res.error || res.status}`);
+          results.push({ type: "memory.search", status: "error", error: String(res.error || res.status), label: a.query });
+          tally(false);
+          continue;
+        }
+        const rows = Array.isArray(res.data?.rows) ? res.data.rows : [];
+        lines.push(`- [ok] memory.search "${a.query}": ${rows.length} hit(s)`);
+        for (const r of rows) {
+          const summary5 = (r.summary || r.text || "").replace(/\s+/g, " ").slice(0, 200);
+          lines.push(`  - [${r.source_kind || "memory"}] ${summary5}`);
+        }
+        results.push({ type: "memory.search", status: "ok", count: rows.length, query: a.query });
+        tally(true);
+      } else if (a.type === "memory.write") {
+        const project_id = a.project_id || ctx.projectId;
+        if (!project_id) {
+          lines.push(`- [err] memory.write: project_id required (chat has no pinned project)`);
+          results.push({ type: "memory.write", status: "error", error: "project_id required (chat has no pinned project)" });
+          tally(false);
+          continue;
+        }
+        const body = {
+          project_id,
+          source_kind: a.kind || "agent_note",
+          source_id: a.source_id || `chat:${ctx.chatId}:${Date.now()}`,
+          agent_id: ctx.agentId || null,
+          text: a.text,
+          summary: a.summary || null
+        };
+        const res = await apiClient.post(`${ctx.apiUrl}/api/memory/write`, body);
+        if (!res.success) {
+          lines.push(`- [err] memory.write: ${res.error || res.status}`);
+          results.push({ type: "memory.write", status: "error", error: String(res.error || res.status) });
+          tally(false);
+          continue;
+        }
+        const row = res.data?.row || {};
+        lines.push(`- [ok] memory.write -> ${row.id || "(no id)"}${row.embedding_id ? " (embedded)" : ""}`);
+        results.push({ type: "memory.write", status: "ok", memory_id: row.id, embedded: !!row.embedding_id });
+        tally(true);
       } else if (a.type === "agent.create") {
         const res = await apiClient.post(agentsMutateUrl, {
           action: "create",
@@ -36952,7 +37073,9 @@ var init_chat_plan_actions = __esm(() => {
     "skill.detach": 5,
     "agent.update": 5,
     "session.create": 3,
-    "issue.comment": 5
+    "issue.comment": 5,
+    "memory.search": 5,
+    "memory.write": 5
   };
 });
 
@@ -37330,6 +37453,8 @@ Action vocabulary:
   {"type":"issue.delete_where","status":"todo","limit":50},
   {"type":"issue.list","status":"todo","limit":20},
   {"type":"issue.search","query":"flaky tests","limit":10},
+  {"type":"memory.search","query":"deploy pipeline","limit":10},
+  {"type":"memory.write","text":"durable note worth recalling next session","summary":"short hint","kind":"agent_note"},
   {"type":"agent.create","name":"refactor-bot","prompt":"...","allowed_tools":["Read","Edit","Bash"]},
   {"type":"agent.update","id":"ag_xxx","prompt":"..."},
   {"type":"skill.create","name":"run-tests","description":"...","body":"---\\nname: run-tests\\n---\\n..."},
@@ -37341,7 +37466,8 @@ Action vocabulary:
 Rules:
 - Omit the block entirely if no actions are needed. Don't emit empty arrays.
 - Status values for \`update\`: \`todo\` | \`in_progress\` | \`blocked\` | \`done\` | \`archived\` | \`failed\`. **Use \`blocked\` (NOT \`done\`) when the issue is paused waiting on a human decision** — confirmation, choice, or missing context. Marking such an issue \`done\` misrepresents finished work. Use \`archived\` to hide a completed/abandoned issue from default views.
-- Max 10 actions per turn. Sub-caps: agent.create=2, skill.create=3, agent.update=5, skill.attach/detach=5, session.create=3, issue.comment=5.
+- Max 10 actions per turn. Sub-caps: agent.create=2, skill.create=3, agent.update=5, skill.attach/detach=5, session.create=3, issue.comment=5, memory.search=5, memory.write=5.
+- Memory actions are project-scoped persistent notes (FTS5 + vector). \`memory.search\` returns hits in the action summary; the agent reads them next turn. \`memory.write\` records durable facts for future sessions — use sparingly, not for transient task state. Both require a pinned project.
 - Chat-initiated agent.create / agent.update / skill.attach are auto-approved (the user is reading this reply right now). skill.create still queues for human review.
 - Use \`issue.comment\` with \`@<agent name>\` mention to dispatch an agent on an existing issue. Plain comments without an @mention are recorded but do not trigger a run. Issues whose autonomy is \`manual\` will not dispatch.
 - To create an issue AND assign/dispatch it to an agent in the same turn, set \`assignee_type\` + \`assignee_id\` directly on the \`create\` action. Do NOT emit a separate \`delegate\` or \`issue.comment\` action referring to a brand-new issue in the same plan block — actions execute as a flat list and the new issue's id/key is not available to later actions in the same block. \`delegate\` and \`issue.comment\` are for issues that already exist before this turn.
@@ -38115,7 +38241,7 @@ import { parseArgs } from "util";
 // package.json
 var package_default = {
   name: "@shipers-dev/multi",
-  version: "0.51.0",
+  version: "0.52.0",
   type: "module",
   bin: {
     "multi-agent": "./dist/index.js"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipers-dev/multi",
-  "version": "0.51.0",
+  "version": "0.52.0",
   "type": "module",
   "bin": {
     "multi-agent": "./dist/index.js"