@korso/shepherd 0.4.2 → 0.4.4

package/dist/index.js

@@ -109,9 +109,17 @@ function createHubClient({
         clearTimeout(timer);
       }
       if (!response.ok) {
+        let detail = "";
+        try {
+          const data = await response.json();
+          if (data && typeof data === "object" && "error" in data && typeof data.error === "string") {
+            detail = `: ${data.error}`;
+          }
+        } catch {
+        }
         throw new HubRequestError(
           response.status,
-          `Hub returned HTTP ${response.status} for ${path2}`
+          `Hub returned HTTP ${response.status} for ${path2}${detail}`
         );
       }
       return response.json();
@@ -357,6 +365,10 @@ var WorkspaceAnnouncement = z2.object({
   // (no agent session). The dashboard renders these as "me" (right-aligned).
   // Defaulted for version-skew safety with older hubs.
   fromAdmin: z2.boolean().default(false),
+  // True when an agent addressed the message TO the operator (the mirror of
+  // fromAdmin). The dashboard renders these as "<agent> → admin". Not delivered
+  // to other agents. Defaulted for version-skew safety with older hubs.
+  toAdmin: z2.boolean().default(false),
   createdAt: IsoTimestamp
 });
 var WorkspaceLandscapeResponse = z2.object({
@@ -421,7 +433,13 @@ var AnnounceRequest = z2.object({
   sessionId: z2.string().uuid(),
   body: z2.string().min(1).max(8192),
   // absent or null => broadcast to all agents in the workspace
-  targetAgentName: z2.string().nullable().optional()
+  targetAgentName: z2.string().nullable().optional(),
+  // true => address the human operator (the dashboard) instead of agents. The
+  // mirror of the operator's admin → agent DM: it shows in the workspace feed as
+  // "<agent> → admin" and is NOT delivered to other agents. Mutually exclusive
+  // with targetAgentName (the hub rejects setting both). Defaulted/optional for
+  // version skew with older clients.
+  toAdmin: z2.boolean().optional()
 });
 var AnnounceResponse = z2.object({
   ok: z2.literal(true),
@@ -1058,7 +1076,7 @@ ${msgs}` : base }
     "announce",
     {
       title: "Broadcast a message to teammates",
-      description: "Broadcast a heads-up to the other agents, or direct a finding to a specific agent. This is awareness only \u2014 not a task assignment. To direct it, pass that agent's name (exactly as shown in the landscape) as targetAgentName; omit it to broadcast to everyone in the workspace. Delivery is best-effort: the recipient sees it on their next work/sync, once.",
+      description: "Broadcast a heads-up to the other agents, direct a finding to a specific agent, or reply to the human operator. This is awareness only \u2014 not a task assignment. To direct it to an agent, pass that agent's EXACT name as shown in the landscape \u2014 including its numeric suffix (e.g. 'alex-rivera-2', NOT the bare handle 'alex-rivera') \u2014 as targetAgentName. Several agents can share one handle (alex-rivera-1, alex-rivera-2, \u2026); the suffix is what picks one, so the bare handle is rejected. The hub rejects any targetAgentName that doesn't match a live agent in your repo \u2014 if you mean the whole team, omit it to broadcast. To reply to the operator (the dashboard), pass toAdmin: true. targetAgentName and toAdmin are mutually exclusive. Delivery is best-effort: the recipient sees it on their next work/sync, once.",
       inputSchema: AnnounceAgentInput.shape
     },
     async (args) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@korso/shepherd",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Shepherd MCP server — gives any MCP-capable agent (Claude Code, Codex, etc.) four advisory cross-session coordination tools (work/done/announce/sync) backed by the shared Shepherd hub. Joins the workspace automatically and ships standing instructions so the agent self-coordinates.",
   "type": "module",
   "main": "dist/index.js",