@korso/shepherd-ui 0.7.0 → 0.9.0

package/dist/components/Chat.js

@@ -56,6 +56,9 @@ export function Chat({ announcements, selectedRepo, nowMs }) {
             return (
             // The feed has no stable id; index is acceptable because the list is
             // append-only oldest->newest and rows are never reordered in place.
-            _jsxs("div", { className: className, children: [_jsx("div", { className: "msg__avatar", style: { background: colorForName(a.fromAgentName) }, children: initialsFor(a.fromAgentName) }), _jsxs("div", { className: "msg__body", children: [_jsxs("div", { className: "msg__head", children: [_jsx("span", { className: "msg__who", style: { color: colorForName(a.fromAgentName) }, children: a.fromAgentName }), a.fromHuman ? _jsx("span", { className: "msg__human", children: a.fromHuman }) : null, a.targetAgentName !== null ? (_jsx("span", { className: "msg__to", children: `→ @${a.targetAgentName}` })) : a.toAdmin ? (_jsx("span", { className: "msg__to", children: "\u2192 admin" })) : null, _jsx("span", { className: "msg__time", children: formatRelative(a.createdAt, nowMs) })] }), _jsx("div", { className: "msg__text", children: a.body })] })] }, i));
+            _jsxs("div", { className: className, children: [_jsx("div", { className: "msg__avatar", style: { background: colorForName(a.fromAgentName) }, children: initialsFor(a.fromAgentName) }), _jsxs("div", { className: "msg__body", children: [_jsxs("div", { className: "msg__head", children: [_jsx("span", { className: "msg__who", style: { color: colorForName(a.fromAgentName) }, children: a.fromAgentName }), a.fromHuman ? _jsx("span", { className: "msg__human", children: a.fromHuman }) : null, a.targetAgentName !== null ? (_jsx("span", { className: "msg__to", children: `→ @${a.targetAgentName}` })) : a.targetMemberName !== null ? (
+                                    // An agent addressed a specific workspace member by name;
+                                    // legacy/collective operator messages fall through to "admin".
+                                    _jsx("span", { className: "msg__to", children: `→ @${a.targetMemberName}` })) : a.toAdmin ? (_jsx("span", { className: "msg__to", children: "\u2192 admin" })) : null, _jsx("span", { className: "msg__time", children: formatRelative(a.createdAt, nowMs) })] }), _jsx("div", { className: "msg__text", children: a.body })] })] }, i));
         })) }));
 }

package/dist/config/ConnectAgent.js

@@ -25,6 +25,68 @@ const ENV_FLAG = {
     claude: "-e",
     codex: "--env",
 };
+// The shepherd-inbox-hook bin: delivers teammate announcements out-of-band AND
+// nudges the agent to run `link` before its first write in an unlinked repo.
+// The MCP server installs this ITSELF the first time the agent runs (once per
+// machine, additive-only, `SHEPHERD_NO_AUTO_HOOKS=1` to opt out) — Claude,
+// Codex, and Cursor get their config merged, Pi gets the bundled extension
+// file copied in. So the dashboard's job is to SAY that, name where the write
+// lands, and keep the manual equivalent as a collapsed reference for users who
+// opted out or want to audit the change.
+const HOOK_COMMAND = "npx -y --package=@korso/shepherd shepherd-inbox-hook";
+function hookSetup(tool) {
+    if (tool === "claude") {
+        // SessionStart front-loads the link ask; PreToolUse delivers announcements
+        // and re-nudges right before a write in a still-unlinked repo.
+        return {
+            target: "~/.claude/settings.json",
+            snippet: JSON.stringify({
+                hooks: {
+                    SessionStart: [{ hooks: [{ type: "command", command: HOOK_COMMAND }] }],
+                    PreToolUse: [
+                        { matcher: "*", hooks: [{ type: "command", command: HOOK_COMMAND }] },
+                    ],
+                },
+            }, null, 2),
+        };
+    }
+    if (tool === "codex") {
+        // Codex's PreToolUse only fires for Bash, so UserPromptSubmit is the
+        // frequent event there; hooks must be feature-flagged on.
+        return {
+            target: "~/.codex/config.toml",
+            snippet: [
+                "[features]",
+                "hooks = true",
+                "",
+                "[[hooks.UserPromptSubmit]]",
+                'command = ["npx", "-y", "--package=@korso/shepherd", "shepherd-inbox-hook"]',
+            ].join("\n"),
+        };
+    }
+    if (tool === "pi") {
+        // Pi delivery is a bundled extension FILE, not a config edit — the
+        // auto-install copies it into place; there is nothing to paste manually.
+        return {
+            target: "~/.pi/agent/extensions/shepherd-inbox.js",
+            snippet: null,
+        };
+    }
+    if (tool === "cursor") {
+        // Only beforeSubmitPrompt is wired: it is the one Cursor event verified
+        // (spike, Cursor 3.9.16) to inject the hook's output into model context.
+        return {
+            target: "~/.cursor/hooks.json",
+            snippet: JSON.stringify({
+                version: 1,
+                hooks: {
+                    beforeSubmitPrompt: [{ command: HOOK_COMMAND }],
+                },
+            }, null, 2),
+        };
+    }
+    return null;
+}
 // "created 3d ago · never used" / "created 3d ago · last used 2h ago" — helps
 // an operator tell which tokens are still active before revoking one.
 function tokenMeta(token, nowMs) {
@@ -105,6 +167,7 @@ export function ConnectAgent({ hubUrl }) {
     async function generate() {
         setBusy(true);
         setError(null);
+        setStatus(null);
         try {
             const res = await client.mintAccountToken(name.trim() ? { name: name.trim() } : {});
             setRawToken(res.token);
@@ -137,12 +200,18 @@ export function ConnectAgent({ hubUrl }) {
         }
     }
     const command = installCommand(tool, directHubUrl, rawToken ?? TOKEN_PLACEHOLDER);
+    const hook = hookSetup(tool);
     async function copyCommand() {
         await navigator.clipboard.writeText(command);
         setCopied(true);
         setTimeout(() => setCopied(false), 2000);
     }
-    return (_jsxs("section", { className: "shepherd-connect-agent", "aria-labelledby": headingId, children: [_jsxs("div", { className: "card-head", children: [_jsx("h3", { id: headingId, children: "Connect your agent" }), _jsx("p", { className: "card-sub", children: "Generate a token \u2014 it works across all your workspaces \u2014 then paste the command into your coding tool." }), _jsx("p", { className: "card-sub", children: "The first time the agent opens a repo, it'll ask which workspace to coordinate that repo with." })] }), _jsxs("div", { className: "card-body", children: [_jsxs("div", { className: "field", children: [_jsx("label", { htmlFor: "connect-tool", children: "Tool" }), _jsx("select", { id: "connect-tool", value: tool, onChange: (e) => setTool(e.target.value), children: TOOLS.map((t) => (_jsx("option", { value: t.id, children: t.label }, t.id))) })] }), _jsxs("div", { className: "field generate", children: [_jsx("label", { htmlFor: "token-name", children: "Token name (optional)" }), _jsxs("div", { className: "field__row", children: [_jsx("input", { id: "token-name", type: "text", value: name, onChange: (e) => setName(e.target.value), placeholder: "e.g. laptop" }), _jsx("button", { type: "button", onClick: () => void generate(), disabled: busy, children: "Generate token" })] })] }), error && _jsx("p", { role: "alert", children: error }), status && _jsx("p", { role: "status", children: status }), rawToken && (_jsx("p", { className: "token-once", role: "status", children: "Copy this token now \u2014 it won't be shown again." })), _jsxs("div", { className: "install-command", children: [_jsx("pre", { "data-testid": "install-command", children: command }), _jsx("button", { type: "button", className: "install-command__copy", "aria-label": copied ? "Copied" : "Copy command", title: copied ? "Copied" : "Copy", onClick: () => void copyCommand(), children: copied ? (_jsx("svg", { width: "15", height: "15", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M20 6 9 17l-5-5" }) })) : (_jsxs("svg", { width: "15", height: "15", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("rect", { x: "9", y: "9", width: "13", height: "13", rx: "2" }), _jsx("path", { d: "M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" })] })) })] }), _jsx("h4", { children: "Existing tokens" }), loading ? (_jsx("p", { role: "status", children: "Loading\u2026" })) : tokens.length === 0 ? (_jsx("p", { children: "No tokens yet." })) : (_jsx("ul", { children: tokens.map((t) => {
+    return (_jsxs("section", { className: "shepherd-connect-agent", "aria-labelledby": headingId, children: [_jsxs("div", { className: "card-head", children: [_jsx("h3", { id: headingId, children: "Connect your agent" }), _jsx("p", { className: "card-sub", children: "Generate a token \u2014 it works across all your workspaces \u2014 then paste the command into your coding tool." }), _jsx("p", { className: "card-sub", children: "The first time the agent changes files in a repo, Shepherd asks which workspace to coordinate that repo with \u2014 once per repo, right in your tool." })] }), _jsxs("div", { className: "card-body", children: [_jsxs("div", { className: "field", children: [_jsx("label", { htmlFor: "connect-tool", children: "Tool" }), _jsx("select", { id: "connect-tool", value: tool, onChange: (e) => setTool(e.target.value), children: TOOLS.map((t) => (_jsx("option", { value: t.id, children: t.label }, t.id))) })] }), _jsxs("div", { className: "field generate", children: [_jsx("label", { htmlFor: "token-name", children: "Token name (optional)" }), _jsxs("div", { className: "field__row", children: [_jsx("input", { id: "token-name", type: "text", value: name, onChange: (e) => setName(e.target.value), onKeyDown: (e) => {
+                                            if (e.key === "Enter" && !busy) {
+                                                e.preventDefault();
+                                                void generate();
+                                            }
+                                        }, placeholder: "e.g. laptop" }), _jsx("button", { type: "button", onClick: () => void generate(), disabled: busy, children: "Generate token" })] })] }), error && _jsx("p", { role: "alert", children: error }), status && _jsx("p", { role: "status", children: status }), rawToken && (_jsx("p", { className: "token-once", role: "status", children: "Copy this token now \u2014 it won't be shown again." })), _jsxs("div", { className: "install-command", children: [_jsx("pre", { "data-testid": "install-command", children: command }), _jsx("button", { type: "button", className: "install-command__copy", "aria-label": copied ? "Copied" : "Copy command", title: copied ? "Copied" : "Copy", onClick: () => void copyCommand(), children: copied ? (_jsx("svg", { width: "15", height: "15", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: _jsx("path", { d: "M20 6 9 17l-5-5" }) })) : (_jsxs("svg", { width: "15", height: "15", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("rect", { x: "9", y: "9", width: "13", height: "13", rx: "2" }), _jsx("path", { d: "M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" })] })) })] }), hook && (_jsxs("div", { className: "hook-setup", children: [_jsxs("p", { className: "card-sub", children: ["Message delivery sets itself up: the first time the agent runs, Shepherd adds its inbox hook to ", _jsx("code", { children: hook.target }), " ", "automatically \u2014 it delivers teammate announcements and reminds the agent to link each repo before its first write. Happens at most once; set ", _jsx("code", { children: "SHEPHERD_NO_AUTO_HOOKS=1" }), " to opt out."] }), hook.snippet && (_jsxs("details", { className: "hook-reference", children: [_jsx("summary", { children: "What gets added (manual equivalent)" }), _jsx("div", { className: "install-command", children: _jsx("pre", { "data-testid": "hook-snippet", children: hook.snippet }) })] }))] })), _jsx("h4", { children: "Existing tokens" }), loading ? (_jsx("p", { role: "status", children: "Loading\u2026" })) : tokens.length === 0 ? (_jsx("p", { children: "No tokens yet." })) : (_jsx("ul", { children: tokens.map((t) => {
                             const name = t.name ?? t.id;
                             return (_jsxs("li", { children: [_jsx("span", { children: name }), _jsx("span", { className: "token-meta", children: tokenMeta(t, Date.now()) }), t.revokedAt ? (_jsx("span", { className: "revoked", children: "revoked" })) : (_jsx("button", { type: "button", "aria-label": `Revoke token ${name}`, onClick: () => void revoke(t.id), disabled: revokingId === t.id, children: "Revoke" }))] }, t.id));
                         }) }))] })] }));