@flowriki/agent 0.1.0-beta.39 → 0.1.0-beta.40

package/dist/{chunk-7CH5XDEE.js → chunk-T7I2US4Y.js}

@@ -6,7 +6,7 @@ import os from "os";
 import path from "path";
 import { createRequire } from "module";
 import { spawnSync } from "child_process";
-var AGENT_VERSION = "0.1.0-beta.39";
+var AGENT_VERSION = "0.1.0-beta.40";
 async function prepareBrowsers() {
   if (browsersReady()) {
     return { ok: true, already: true, message: "chromium is already installed" };
@@ -1879,7 +1879,8 @@ var SourceVersionSchema = z5.object({
   v: z5.number().int().positive(),
   hash: z5.string().min(1),
   extractedText: z5.string(),
-  /** Where the original file is kept, for an upload. */
+  /** Where an uploaded file WAS kept. Only text is kept since 2026-10-11;
+   *  read so older records still parse, and cleared at start-up. */
   originalKey: z5.string().optional(),
   mediaType: z5.string().optional(),
   at: z5.string(),
@@ -2022,37 +2023,6 @@ var ConversationSchema = z7.object({
   createdAt: z7.string(),
   updatedAt: z7.string()
 }).strict();
-var INTEGRATION_PLATFORMS = ["jira", "linear", "github", "figma", "confluence"];
-var IntegrationSchema = z7.object({
-  id: z7.string().regex(/^int_[A-Za-z0-9]+$/),
-  projectId: z7.string().min(1),
-  platform: z7.enum(INTEGRATION_PLATFORMS),
-  name: z7.string().min(1).max(120),
-  /** Where it is: a Jira or Confluence site, a GitHub repository, a Figma
-   *  file, a Linear team. Never a credential. */
-  config: z7.object({
-    baseUrl: z7.string().url().optional(),
-    email: z7.string().optional(),
-    jql: z7.string().max(2e3).optional(),
-    projectKey: z7.string().max(40).optional(),
-    repository: z7.string().regex(/^[\w.-]+\/[\w.-]+$/).optional(),
-    fileKey: z7.string().max(120).optional(),
-    teamKey: z7.string().max(40).optional(),
-    spaceKey: z7.string().max(80).optional(),
-    pageIds: z7.array(z7.string().max(40)).max(200).optional(),
-    /** Raise bugs here when asked. */
-    bugs: z7.boolean().optional(),
-    /** Read items here as sources. */
-    sources: z7.boolean().optional()
-  }).strict(),
-  /** The vault reference for its token. */
-  tokenRef: z7.string().regex(/^[a-z][a-z0-9_]*$/),
-  status: z7.enum(["connected", "failing"]).default("connected"),
-  lastSyncAt: z7.string().nullable().default(null),
-  lastError: z7.string().nullable().default(null),
-  createdAt: z7.string(),
-  createdBy: z7.string().default("")
-}).strict();
 
 // ../engine-playwright/dist/index.js
 import { createHmac, randomBytes as randomBytes2 } from "crypto";
@@ -9943,7 +9913,7 @@ function adapt(socket) {
   };
 }
 function dialWebSocket(opts) {
-  return () => new Promise((resolve, reject) => {
+  return () => new Promise((resolve2, reject) => {
     const socket = new WebSocket(opts.url, {
       handshakeTimeout: opts.handshakeTimeoutMs ?? 1e4,
       ...opts.headers ? { headers: opts.headers } : {}
@@ -9957,7 +9927,7 @@ function dialWebSocket(opts) {
     };
     socket.once("open", () => {
       socket.off("error", failed);
-      resolve(adapt(socket));
+      resolve2(adapt(socket));
     });
     socket.once("error", failed);
   });
@@ -10366,7 +10336,7 @@ var AgentLink = class {
       try {
         const socket = await this.opts.dial();
         this.socket = socket;
-        const closed = new Promise((resolve) => socket.onClose(resolve));
+        const closed = new Promise((resolve2) => socket.onClose(resolve2));
         socket.onMessage((data) => void this.receive(data));
         const auth = {
           type: "auth",
@@ -11150,11 +11120,21 @@ var file = () => path34.join(flowrikiHome(), "assistant-folders.json");
 function readAll() {
   try {
     const parsed = JSON.parse(fs34.readFileSync(file(), "utf8"));
-    return parsed && typeof parsed === "object" ? parsed : {};
+    if (!parsed || typeof parsed !== "object") return {};
+    const out = {};
+    for (const [id, value] of Object.entries(parsed)) {
+      const list = typeof value === "string" ? [value] : Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
+      if (list.length) out[id] = list;
+    }
+    return out;
   } catch {
     return {};
   }
 }
+function writeAll(all) {
+  fs34.mkdirSync(path34.dirname(file()), { recursive: true, mode: 448 });
+  fs34.writeFileSync(file(), JSON.stringify(all, null, 2), { mode: 384 });
+}
 function gitHead(folder) {
   try {
     const head = fs34.readFileSync(path34.join(folder, ".git", "HEAD"), "utf8").trim();
@@ -11170,7 +11150,7 @@ function gitHead(folder) {
     return { commit: null, branch: null };
   }
 }
-function describeFolder(folder) {
+function describeFolder(folder, name = path34.basename(folder)) {
   const exists = (() => {
     try {
       return fs34.statSync(folder).isDirectory();
@@ -11178,26 +11158,46 @@ function describeFolder(folder) {
       return false;
     }
   })();
-  return { path: folder, exists, ...exists ? gitHead(folder) : { commit: null, branch: null } };
+  return { path: folder, name, exists, ...exists ? gitHead(folder) : { commit: null, branch: null } };
 }
-function folderFor(projectId) {
-  const folder = readAll()[projectId];
-  return folder ? describeFolder(folder) : null;
+function foldersFor(projectId) {
+  const list = readAll()[projectId] ?? [];
+  const base = (p) => path34.basename(p);
+  return list.map((p) => describeFolder(p, list.filter((o) => base(o) === base(p)).length > 1 ? `${path34.basename(path34.dirname(p))}-${base(p)}` : base(p)));
 }
-function setFolder(projectId, folder) {
+function resolve(folder) {
+  const resolved = path34.resolve(folder.replace(/^~(?=$|\/)/, process.env["HOME"] ?? "~"));
+  if (!path34.isAbsolute(resolved)) throw new Error("give the folder's full path");
+  if (!describeFolder(resolved).exists) throw new Error(`there is no folder at ${resolved} on this computer`);
+  if (resolved === path34.parse(resolved).root || resolved === process.env["HOME"]) throw new Error("link the project's own folder, not the whole disk or home folder");
+  return resolved;
+}
+function addFolder(projectId, folder) {
   const all = readAll();
-  if (folder === null) {
-    delete all[projectId];
-  } else {
-    const resolved = path34.resolve(folder.replace(/^~(?=$|\/)/, process.env["HOME"] ?? "~"));
-    if (!path34.isAbsolute(resolved)) throw new Error("give the folder's full path");
-    if (!describeFolder(resolved).exists) throw new Error(`there is no folder at ${resolved} on this computer`);
-    if (resolved === path34.parse(resolved).root || resolved === process.env["HOME"]) throw new Error("link the project's own folder, not the whole disk or home folder");
-    all[projectId] = resolved;
+  const resolved = resolve(folder);
+  const list = all[projectId] ?? [];
+  if (list.some((p) => p === resolved)) return foldersFor(projectId);
+  if (list.some((p) => resolved.startsWith(`${p}${path34.sep}`) || p.startsWith(`${resolved}${path34.sep}`))) {
+    throw new Error("that folder is inside one already linked, or holds one \u2014 link each checkout once");
   }
-  fs34.mkdirSync(path34.dirname(file()), { recursive: true, mode: 448 });
-  fs34.writeFileSync(file(), JSON.stringify(all, null, 2), { mode: 384 });
-  return folder === null ? null : folderFor(projectId);
+  all[projectId] = [...list, resolved];
+  writeAll(all);
+  return foldersFor(projectId);
+}
+function removeFolder(projectId, folder) {
+  const all = readAll();
+  const list = (all[projectId] ?? []).filter((p) => p !== folder);
+  if (list.length) all[projectId] = list;
+  else delete all[projectId];
+  writeAll(all);
+  return foldersFor(projectId);
+}
+function setFolder(projectId, folder) {
+  const all = readAll();
+  if (folder === null) delete all[projectId];
+  else all[projectId] = [resolve(folder)];
+  writeAll(all);
+  return foldersFor(projectId);
 }
 var MAX_PROMPT = 4e3;
 function assistantHandlers({ deps }) {
@@ -11226,28 +11226,29 @@ function assistantHandlers({ deps }) {
       if (!status2.installed) return { ok: false, reason: "failed", detail: status2.detail ?? "the assistant is not installed on this machine" };
       if (!status2.signedIn) return { ok: false, reason: "failed", detail: "the assistant is not signed in on this machine" };
       const askId = randomUUID2();
-      const linked = folderFor(project.id);
+      const linked = foldersFor(project.id).filter((f) => f.exists).map((f) => f.path);
       const mode = command.args["mode"] === "ask" ? "ask" : command.args["mode"] === "do" ? "do" : void 0;
       const started = assistant.ask({
         askId,
         prompt,
         projectId: project.id,
         projectName: project.name,
-        ...linked?.exists ? { folder: linked.path } : {},
+        ...linked.length ? { folders: linked } : {},
         ...mode ? { mode } : {},
         ...typeof sessionId === "string" ? { sessionId } : {},
         emit
       });
       return started.started ? { ok: true, result: { askId } } : { ok: false, reason: "busy", detail: started.detail ?? "the assistant is busy" };
     },
-    /** Which folder on this computer holds the project's code — read with no
-     *  `path`, linked with a path, unlinked with null. */
+    /** Which folders on this computer hold the project's code — read with
+     *  nothing, one more linked with `add`, one unlinked with `remove`.
+     *  `path` (one folder, or null for none) is what older dashboards send.
+     *  `folder` is answered too, for them: the first one. */
     "assistant.folder": async (command, project) => {
       try {
-        if (command.args["path"] === void 0) return { ok: true, result: { folder: folderFor(project.id) } };
-        const asked = command.args["path"];
-        const folder = setFolder(project.id, asked === null ? null : String(asked));
-        return { ok: true, result: { folder } };
+        const { add, remove, path: asked } = command.args;
+        const folders = typeof add === "string" ? addFolder(project.id, add) : typeof remove === "string" ? removeFolder(project.id, remove) : asked !== void 0 ? setFolder(project.id, asked === null ? null : String(asked)) : foldersFor(project.id);
+        return { ok: true, result: { folders, folder: folders[0] ?? null } };
       } catch (error) {
         return { ok: false, reason: "failed", detail: error.message };
       }
@@ -11348,18 +11349,18 @@ var ASK_MODE_TOOLS = [
   "library_cases",
   "test_cycles",
   "bugs",
-  "list_my_branches",
-  "integrations"
+  "list_my_branches"
 ];
 function buildAskArgs(opts) {
   const ask = opts.mode === "ask";
+  const folders = opts.folders ?? [];
   const guidance = [
     `You are the Flowriki assistant for the project "${opts.projectName}" (id ${opts.projectId}). Use the Flowriki tools, and pass projectId "${opts.projectId}" wherever a tool takes one. Start with project_brief: it is this project's memory.`,
     ask ? "ASK MODE: answer the question; change nothing. Cite what you rely on as [[testCase:TC-12]], [[source:src_x@v2]], [[requirement:req_x]], [[knowledge:features/checkout.md]], [[automation:tc_x]], [[cycle:cyc_x]], [[bug:BUG-3]] or [[file:path/in/repo.ts]]." : "DO MODE: do what is asked, on Claude's working branch, for a person to review. Ask in the chat and wait before publishing, deleting, or sending anything to another system. End by writing a short summary of what you did with write_knowledge (memory/sessions/<date>-<topic>.md, append) so the next session knows.",
-    opts.folder ? `The project's code is in ${opts.folder}. Read it with Read, Grep and Glob when it helps; you cannot change it.` : ""
+    folders.length ? `The project's code is in ${folders.join(" and ")}. Read it with Read, Grep and Glob when it helps; you cannot change it.` : ""
   ].filter(Boolean).join("\n");
   const flowriki = ask ? ASK_MODE_TOOLS.map((t) => `mcp__${MCP_SERVER_NAME}__${t}`) : [`mcp__${MCP_SERVER_NAME}`];
-  const files = opts.folder ? ["Read", "Grep", "Glob"] : [];
+  const files = folders.length ? ["Read", "Grep", "Glob"] : [];
   return [
     "-p",
     opts.prompt,
@@ -11373,7 +11374,7 @@ function buildAskArgs(opts) {
     // edits, no web.
     "--tools",
     files.join(","),
-    ...opts.folder ? ["--add-dir", opts.folder] : [],
+    ...folders.flatMap((f) => ["--add-dir", f]),
     // Only these, and anything else is denied rather than asked about: there
     // is nobody at a terminal to answer.
     "--allowedTools",
@@ -11448,19 +11449,19 @@ function createClaudeCli(options) {
   let current = null;
   let cancelled = null;
   function capture(args, timeoutMs = 15e3) {
-    return new Promise((resolve) => {
+    return new Promise((resolve2) => {
       let out = "", err = "", settled = false;
       const finish = (code, failed) => {
         if (settled) return;
         settled = true;
         clearTimeout(timer);
-        resolve({ code, out, err, failed });
+        resolve2({ code, out, err, failed });
       };
       let child;
       try {
         child = spawn2(binary, args, { stdio: ["ignore", "pipe", "pipe"] });
       } catch {
-        return resolve({ code: null, out: "", err: "", failed: true });
+        return resolve2({ code: null, out: "", err: "", failed: true });
       }
       const timer = setTimeout(() => {
         child.kill("SIGKILL");
@@ -11536,7 +11537,7 @@ function createClaudeCli(options) {
             projectId: ask.projectId,
             projectName: ask.projectName,
             ...ask.sessionId ? { sessionId: ask.sessionId } : {},
-            ...ask.folder ? { folder: ask.folder } : {},
+            ...ask.folders?.length ? { folders: ask.folders } : {},
             ...ask.mode ? { mode: ask.mode } : {}
           }),
           // THE SCRATCH FOLDER, not the project: nothing here to read or write.

package/dist/cli.js

@@ -23,7 +23,7 @@ import {
   similarity,
   start,
   status
-} from "./chunk-7CH5XDEE.js";
+} from "./chunk-T7I2US4Y.js";
 
 // src/cli.ts
 import { parseArgs } from "util";
@@ -261,7 +261,7 @@ var ServiceClient = class {
   updateBug(projectId, id, body) {
     return this.call(this.scoped(`/bugs/${encodeURIComponent(id)}`, projectId), { method: "PATCH", body: JSON.stringify(body) });
   }
-  // ── Knowledge, sources, requirements, integrations ──────────────────────
+  // ── Knowledge, sources, requirements ──────────────────────
   knowledgePages(projectId) {
     return this.call(this.scoped("/knowledge", projectId));
   }
@@ -297,18 +297,6 @@ var ServiceClient = class {
   updateRequirement(projectId, id, body) {
     return this.call(this.scoped(`/requirements/${encodeURIComponent(id)}`, projectId), { method: "PATCH", body: JSON.stringify(body) });
   }
-  refreshBug(projectId, id) {
-    return this.call(this.scoped(`/bugs/${encodeURIComponent(id)}/refresh`, projectId), { method: "POST" });
-  }
-  integrations(projectId) {
-    return this.call(this.scoped("/integrations", projectId));
-  }
-  syncIntegration(projectId, id) {
-    return this.call(this.scoped(`/integrations/${encodeURIComponent(id)}/sync`, projectId), { method: "POST" });
-  }
-  pushBug(projectId, bugId, integrationId) {
-    return this.call(this.scoped(`/bugs/${encodeURIComponent(bugId)}/push`, projectId), { method: "POST", body: JSON.stringify({ integrationId }) });
-  }
   /** Gather Claude's open branches here into one. */
   gatherChanges(projectId, opts = {}) {
     return this.call(
@@ -884,13 +872,20 @@ same thing twice is harmless), and after save_case, link the automation to the
 test cases it proves with link_test_case.
 
 KNOWLEDGE: project_brief is the project's memory \u2014 read it first. Search
-everything (knowledge pages, sources, requirements, test cases) with
-knowledge_search; read a page with knowledge_read; read source documents with
-sources. Keep what you learn: write_knowledge writes product.md, glossary.md,
-features/<name>.md, memory/decisions.md or a session summary, on Claude's
-branch for review \u2014 never a password, key or token.
+everything (knowledge pages, documents, requirements, test cases) with
+knowledge_search; read a page with knowledge_read; read documents with
+sources. product.md is "About the product": the person's own description of
+the product, in their words, as long as they like \u2014 read it first. They
+write it, often with you in a conversation beside it; propose text there and
+let them decide, rather than writing product.md unless they ask you to.
+A linked codebase folder is learned into
+codebase/<folder>.md, which must start "# <folder>", then "Commit: <full sha>"
+and "Learned: <yyyy-mm-dd>" lines: that is how the Knowledge screen shows it
+as learned. Keep what you learn with write_knowledge (features/<name>.md,
+memory/decisions.md, a session summary), on Claude's branch for review \u2014
+never a password, key or token.
 
-FROM DOCUMENTS TO TESTS: sources are PRDs, CRs, Jira stories, Figma frames.
+FROM DOCUMENTS TO TESTS: documents (sources) are PRDs, CRs, feature docs.
 requirements lists what was found in them and what the latest version changed
 (new / changed / removed). For a new requirement: write test cases that cover
 it (save_test_cases with covers: [requirement id]) \u2014 but first check
@@ -904,10 +899,6 @@ and helpers it needs, and anything that cannot be automated and why. Show it
 and wait for the person to approve before recording. Then record, save_case,
 and link_test_case.
 
-INTEGRATIONS: integrations lists Jira, Linear, GitHub, Figma and Confluence
-connections; sync_integration reads them as sources. push_bug raises a bug in
-a tracker \u2014 it reaches outside Flowriki, so only after the person says to.
-
 MANUAL TESTING: a test cycle is a set of library cases a person runs by hand
 ("Release 4.2 regression"); each case is marked passed, failed, blocked or
 skipped, step by step, with a bug raised from the step that broke. Read them
@@ -1547,33 +1538,33 @@ ${lines.join("\n")}`);
     {
       name: "project_brief",
       title: "Read the project's memory",
-      description: "The project's own knowledge, in one call: product.md, glossary.md, memory/decisions.md, the list of feature pages and session summaries, the codebase summary's header, and the sources and integrations it has. Call it first in every conversation.",
+      description: "The project's own knowledge, in one call: About the product (product.md), memory/decisions.md, what each linked codebase folder was learned as, the list of feature pages and session summaries, and the documents it has. Call it first in every conversation.",
       inputSchema: { type: "object", properties: { projectId: { type: "string" } }, additionalProperties: false },
       annotations: { readOnlyHint: true },
       run: async (args) => {
         const projectId = await projectFor(args["projectId"]);
-        const [{ pages }, { sources }, { integrations }] = await Promise.all([
+        const [{ pages }, { sources }] = await Promise.all([
           service.knowledgePages(projectId),
-          service.sources(projectId).catch(() => ({ sources: [] })),
-          service.integrations(projectId).catch(() => ({ integrations: [] }))
+          service.sources(projectId).catch(() => ({ sources: [] }))
         ]);
         const read = async (path) => pages.some((p) => p.path === path) ? (await service.knowledgePage(projectId, path)).content : null;
-        const [product, glossary, decisions, codebase] = await Promise.all(["product.md", "glossary.md", "memory/decisions.md", "codebase.json"].map(read));
+        const [product, glossary, decisions] = await Promise.all(["product.md", "glossary.md", "memory/decisions.md"].map(read));
+        const codebases = pages.filter((p) => p.path.startsWith("codebase/"));
+        const headers = await Promise.all(codebases.map(async (p) => `- ${p.path}: ${(await read(p.path))?.split("\n").filter((l) => l.trim()).slice(0, 3).join(" \xB7 ") ?? ""}`));
+        const shown = /* @__PURE__ */ new Set(["product.md", "glossary.md", "memory/decisions.md", ...codebases.map((p) => p.path)]);
         const parts = [
-          product ? `## product.md
-${product}` : "No product.md yet \u2014 write one with write_knowledge once you understand the product.",
-          glossary ? `## glossary.md
+          product ? `## About the product (product.md)
+${product}` : "No About the product yet \u2014 the person writes it on the Knowledge screen; offer to help draft it.",
+          glossary ? `## glossary.md (older page; terms now belong in product.md)
 ${glossary}` : "",
           decisions ? `## memory/decisions.md
 ${decisions}` : "",
-          codebase ? `## codebase.json (first 1500 characters)
-${codebase.slice(0, 1500)}` : "No codebase summary yet.",
+          codebases.length ? `## Codebase, as learned
+${headers.join("\n")}` : "No codebase learned yet.",
           `## Other pages
-${pages.filter((p) => !["product.md", "glossary.md", "memory/decisions.md", "codebase.json"].includes(p.path)).map((p) => `- ${p.path}`).join("\n") || "none"}`,
-          `## Sources
-${sources.map((s) => `- ${s.title} (id ${s.id}, v${s.version}, ${s.kind}) \u2014 requirements: ${s.requirements["new"] ?? 0} new, ${s.requirements["changed"] ?? 0} changed, ${s.requirements["active"] ?? 0} unchanged, ${s.requirements["removed"] ?? 0} removed`).join("\n") || "none"}`,
-          `## Integrations
-${integrations.map((i) => `- ${i.name} (${i.platform}, id ${i.id}, ${i.status}${i.lastSyncAt ? `, last read ${i.lastSyncAt}` : ""})`).join("\n") || "none"}`
+${pages.filter((p) => !shown.has(p.path)).map((p) => `- ${p.path}`).join("\n") || "none"}`,
+          `## Documents
+${sources.map((s) => `- ${s.title} (id ${s.id}, v${s.version}) \u2014 requirements: ${s.requirements["new"] ?? 0} new, ${s.requirements["changed"] ?? 0} changed, ${s.requirements["active"] ?? 0} unchanged, ${s.requirements["removed"] ?? 0} removed`).join("\n") || "none"}`
         ];
         return text(parts.filter(Boolean).join("\n\n"));
       }
@@ -1595,7 +1586,7 @@ ${integrations.map((i) => `- ${i.name} (${i.platform}, id ${i.id}, ${i.status}${
     {
       name: "knowledge_read",
       title: "Read a knowledge page",
-      description: "Read one knowledge page by path (product.md, glossary.md, features/<name>.md, memory/\u2026, codebase.json, index.json).",
+      description: "Read one knowledge page by path (product.md, codebase/<folder>.md, features/<name>.md, memory/\u2026).",
       inputSchema: { type: "object", properties: { projectId: { type: "string" }, path: { type: "string" } }, required: ["path"], additionalProperties: false },
       annotations: { readOnlyHint: true },
       run: async (args) => {
@@ -1607,7 +1598,7 @@ ${integrations.map((i) => `- ${i.name} (${i.platform}, id ${i.id}, ${i.status}${
     {
       name: "write_knowledge",
       title: "Write a knowledge page",
-      description: "Write what the project should remember, on Claude's working branch for review: product.md (what the app is, roles, environments), glossary.md, features/<name>.md (screens, rules, quirks), memory/decisions.md (decisions and conventions), memory/sessions/<yyyy-mm-dd>-<topic>.md (what a job did), codebase.json (the codebase summary: routes, screens, forms, roles, APIs, and the commit read). append: true adds to the end instead of replacing. Never a password, key or token \u2014 those are refused.",
+      description: `Write what the project should remember, on Claude's working branch for review: product.md (About the product \u2014 the person's own description; write it only when they ask), codebase/<folder>.md (what a linked folder holds \u2014 starting with "# <folder>", "Commit: <sha>" and "Learned: <yyyy-mm-dd>" lines, then routes, screens, forms and their validation, roles, APIs, flags; summarised, never copied code), features/<name>.md (screens, rules, quirks), memory/decisions.md (decisions and conventions), memory/sessions/<yyyy-mm-dd>-<topic>.md (what a job did). append: true adds to the end instead of replacing. Never a password, key or token \u2014 those are refused.`,
       inputSchema: {
         type: "object",
         properties: { projectId: { type: "string" }, path: { type: "string" }, content: { type: "string" }, append: { type: "boolean" }, branch: { type: "string" } },
@@ -1761,46 +1752,6 @@ ${c.steps.map((st, i) => `   ${i + 1}. ${st.action}${st.expected ? ` \u2192 ${st
         return text(`Saved the ${args["approved"] === true ? "approved " : ""}automation plan for ${target.key} "${target.title}" on Claude's working branch ${saved.branch}.`);
       }
     },
-    {
-      name: "integrations",
-      title: "Read integrations",
-      description: "The project's connections to Jira, Linear, GitHub, Figma and Confluence: what each is, whether it works, when it was last read, and which take bugs.",
-      inputSchema: { type: "object", properties: { projectId: { type: "string" } }, additionalProperties: false },
-      annotations: { readOnlyHint: true },
-      run: async (args) => {
-        const projectId = await projectFor(args["projectId"]);
-        const { integrations } = await service.integrations(projectId);
-        if (!integrations.length) return text("No integrations. An owner connects them on the Knowledge screen.");
-        return text(integrations.map((i) => `${i.name} (${i.platform}, id ${i.id}) \u2014 ${i.status}${i.lastSyncAt ? `, last read ${i.lastSyncAt}` : ", never read"}${["jira", "linear", "github"].includes(i.platform) ? ", takes bugs" : ""}`).join("\n"));
-      }
-    },
-    {
-      name: "sync_integration",
-      title: "Read an integration's items as sources",
-      description: "Read what an integration holds (Jira stories, Linear and GitHub issues, Confluence pages, Figma frames) as sources. Items unchanged since the last read stay as they are.",
-      inputSchema: { type: "object", properties: { projectId: { type: "string" }, integrationId: { type: "string" } }, required: ["integrationId"], additionalProperties: false },
-      run: async (args) => {
-        const projectId = await projectFor(args["projectId"]);
-        const done = await service.syncIntegration(projectId, str(args["integrationId"]) ?? "");
-        return text(`Read ${done.items} item${done.items === 1 ? "" : "s"}: ${done.newSources} new, ${done.newVersions} changed, ${done.unchanged} unchanged. Requirements: ${done.requirements["added"] ?? 0} new, ${done.requirements["changed"] ?? 0} changed, ${done.requirements["removed"] ?? 0} removed.`);
-      }
-    },
-    {
-      name: "push_bug",
-      title: "Raise a bug in a tracker",
-      description: "Raise a Flowriki bug (BUG-n or its id) in Jira, Linear or GitHub through one of the project's integrations. This reaches outside Flowriki: only after the person has said to.",
-      inputSchema: { type: "object", properties: { projectId: { type: "string" }, bug: { type: "string" }, integrationId: { type: "string" } }, required: ["bug", "integrationId"], additionalProperties: false },
-      annotations: { destructiveHint: true },
-      run: async (args) => {
-        const projectId = await projectFor(args["projectId"]);
-        const ref = str(args["bug"]) ?? "";
-        const { bugs } = await service.bugs(projectId);
-        const bug = bugs.find((b) => b.id === ref || b.key.toLowerCase() === ref.toLowerCase());
-        if (!bug) return text(`No bug ${ref}.`);
-        const pushed = await service.pushBug(projectId, bug.id, str(args["integrationId"]) ?? "");
-        return text(`${bug.key} is now ${pushed.externalKey} in ${pushed.tracker}: ${pushed.url}`);
-      }
-    },
     {
       name: "test_cycles",
       title: "Read manual test cycles",
@@ -1964,7 +1915,7 @@ ${lines.join("\n")}`);
     {
       name: "save_bug",
       title: "Raise or update a bug",
-      description: "New: {title, description?, severity?: critical|major|minor|trivial, cycleId?, testCase?, step? (its number)} \u2014 found in a cycle, it is attached to that case's result there. Update: {bugId, title?, description?, severity?, status?: open|in-progress|fixed|verified|closed|wont-fix}. {bugId, refresh: true} reads a pushed bug's status back from its tracker.",
+      description: "New: {title, description?, severity?: critical|major|minor|trivial, cycleId?, testCase?, step? (its number)} \u2014 found in a cycle, it is attached to that case's result there. Update: {bugId, title?, description?, severity?, status?: open|in-progress|fixed|verified|closed|wont-fix}.",
       inputSchema: {
         type: "object",
         properties: {
@@ -1976,18 +1927,13 @@ ${lines.join("\n")}`);
           status: { type: "string" },
           cycleId: { type: "string" },
           testCase: { type: "string" },
-          step: { type: "number" },
-          refresh: { type: "boolean" }
+          step: { type: "number" }
         },
         additionalProperties: false
       },
       run: async (args) => {
         const projectId = await projectFor(args["projectId"]);
         const bugId = str(args["bugId"]);
-        if (bugId && args["refresh"] === true) {
-          const fresh = await service.refreshBug(projectId, bugId);
-          return text(`${fresh.key} is ${fresh.status} in its tracker.`);
-        }
         if (bugId) {
           const body2 = Object.fromEntries(["title", "description", "severity", "status"].filter((k) => typeof args[k] === "string").map((k) => [k, args[k]]));
           const saved = await service.updateBug(projectId, bugId, body2);

package/dist/engine.js

@@ -9,7 +9,7 @@ import {
   resolveCheckouts,
   start,
   status
-} from "./chunk-7CH5XDEE.js";
+} from "./chunk-T7I2US4Y.js";
 export {
   AGENT_VERSION,
   browsersReady,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowriki/agent",
-  "version": "0.1.0-beta.39",
+  "version": "0.1.0-beta.40",
   "description": "Run Flowriki UI tests on your own computer. Connects this machine to your Flowriki account.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",