agent-nuvira 3.3.13 → 3.3.15

package/dist/web-dashboard/workspace-resolution.js

@@ -0,0 +1,105 @@
+/**
+ * Cluster G — WHERE this turn's workspace came from, in one tested place.
+ *
+ * The dashboard chat used to answer "which folder is this turn about?" with a
+ * two-line rule: the path the browser posted, else the operator-configured
+ * `dashboard.cwd`, else nothing. Three measured failures came out of that:
+ *
+ * 1. THE BROWSER IS NOT THE ONLY PLACE A FOLDER CAN COME FROM. The dashboard
+ *    keeps a per-session `projectPath`, and the composer only re-sends it from
+ *    React state: a page reload mid-conversation, or an attach whose response
+ *    the UI never received, drops it — and the server then had no folder even
+ *    though the chat had one. The user's report was exactly this: "agent keep
+ *    refusing even after i attach the folder". A folder this chat already
+ *    attached is a folder the server can still read back.
+ *
+ * 2. THE USER CAN NAME A FOLDER IN THE MESSAGE. The workspace guard already
+ *    treats a typed absolute path as "the user is being specific, do not ask
+ *    them to attach anything" — and then threw the path away instead of
+ *    running there. "as user gives folder either path via chat … we can use
+ *    it" is the missing half of that rule.
+ *
+ * 3. A CONFIGURED DEFAULT IS NOT THE USER'S PROJECT. `dashboard.cwd` is an
+ *    operator's choice about where unattached work lands, and the turn was
+ *    told nothing about it — so a turn scoped to the default answered as if it
+ *    were inside a project the user had pointed at. See {@link WorkspaceSource}.
+ *
+ * The order is deliberate and safe-by-default: the folder the USER attached
+ * wins, then the one this conversation already attached, then one the user
+ * named in their own message, and only then the operator's default — and the
+ * default is the one case that carries a warning, because it is the one case
+ * the user did not choose.
+ */
+import { directoryFromMessage, isUsableDirectory } from '../utils/workspace-path.js';
+/**
+ * Re-exported so a caller of this module needs one import, not two. The rules
+ * themselves live in `utils/workspace-path.ts` because a TOOL also uses them
+ * (`ask_user`, adopting a folder the user names in a reply) and `src/tools`
+ * must not depend on the dashboard.
+ */
+export { directoryFromMessage, isUsableDirectory, normalizeWorkspacePath } from '../utils/workspace-path.js';
+/**
+ * The caption the SURFACE shows for a resolved workspace, or undefined when
+ * there is nothing to say.
+ *
+ * Nothing to say means exactly one case: the user's own attached folder. Every
+ * other source is a folder the user did not pick THIS turn, and a file that
+ * lands somewhere unexpected is the difference between a tool and a mystery —
+ * so each of those gets one plain sentence naming the directory and why.
+ */
+export function formatWorkspaceNoticeText(workspace) {
+    if (workspace.source === 'attached')
+        return undefined;
+    if (!workspace.path) {
+        return ('No project folder is attached — this turn is running UNSCOPED, so nothing will be ' +
+            'written to disk until you say where it should go.');
+    }
+    return workspace.notice ?? `Workspace: ${workspace.path} (${workspace.source}).`;
+}
+/** The warning a turn scoped to the operator's DEFAULT workspace must carry. */
+export function defaultWorkspaceNotice(path) {
+    return (`No project folder is attached to this chat, so this turn is running in the configured ` +
+        `default workspace (${path}). Anything created lands THERE — say so plainly if you create ` +
+        `a file, and name the path. If the work belongs in a different project, ask the user to ` +
+        `attach that folder (the Select Project Folder box above the composer) or to paste its ` +
+        `absolute path.`);
+}
+/**
+ * Decide the turn's workspace, in priority order, with the notice it must be
+ * told about. Pure and synchronous so the rule can be tested on its own; the
+ * only I/O is an existence check per candidate.
+ */
+export function resolveTurnWorkspace(input) {
+    if (isUsableDirectory(input.attachedPath)) {
+        return { path: input.attachedPath, source: 'attached', unscoped: false };
+    }
+    if (isUsableDirectory(input.sessionPath)) {
+        return {
+            path: input.sessionPath,
+            source: 'session',
+            unscoped: false,
+            notice: `Workspace: ${input.sessionPath} — restored from this conversation's earlier attachment ` +
+                '(the request did not carry it). The user attached this folder to this chat.',
+        };
+    }
+    const named = directoryFromMessage(input.message);
+    if (named) {
+        return {
+            path: named,
+            source: 'message',
+            unscoped: false,
+            notice: `Workspace: ${named} — taken from the folder the user named in their message. ` +
+                'They pointed at this directory; treat it as their project.',
+        };
+    }
+    if (isUsableDirectory(input.configuredCwd)) {
+        return {
+            path: input.configuredCwd,
+            source: 'default',
+            unscoped: false,
+            notice: defaultWorkspaceNotice(input.configuredCwd),
+        };
+    }
+    return { source: 'none', unscoped: true };
+}
+//# sourceMappingURL=workspace-resolution.js.map

package/dist/web-dashboard/workspace-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-resolution.js","sourceRoot":"","sources":["../../src/web-dashboard/workspace-resolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAErF;;;;;GAKG;AACH,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAuB7G;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,SAA4B;IACpE,IAAI,SAAS,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IACtD,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,CACL,oFAAoF;YACpF,mDAAmD,CACpD,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC,MAAM,IAAI,cAAc,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,MAAM,IAAI,CAAC;AACnF,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO,CACL,wFAAwF;QACxF,sBAAsB,IAAI,iEAAiE;QAC3F,yFAAyF;QACzF,wFAAwF;QACxF,gBAAgB,CACjB,CAAC;AACJ,CAAC;AAaD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAyB;IAC5D,IAAI,iBAAiB,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC3E,CAAC;IACD,IAAI,iBAAiB,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QACzC,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,WAAW;YACvB,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,KAAK;YACf,MAAM,EACJ,cAAc,KAAK,CAAC,WAAW,0DAA0D;gBACzF,6EAA6E;SAChF,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO;YACL,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,KAAK;YACf,MAAM,EACJ,cAAc,KAAK,4DAA4D;gBAC/E,4DAA4D;SAC/D,CAAC;IACJ,CAAC;IACD,IAAI,iBAAiB,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;QAC3C,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,aAAa;YACzB,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,sBAAsB,CAAC,KAAK,CAAC,aAAa,CAAC;SACpD,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-nuvira",
-  "version": "3.3.13",
+  "version": "3.3.15",
   "description": "Agent-Nuvira: Multi-agent AI coding CLI — plan, write, review, test, and publish code with local models (Ollama) or cloud APIs (Groq, NVIDIA NIM, Google Gemini, OpenRouter)",
   "type": "module",
   "main": "dist/index.js",