borgmcp 3.17.0 → 4.0.0

package/src/tool-manifest.ts

@@ -208,7 +208,8 @@ export const TOOL_MANIFEST: ToolManifestEntry[] = [
             'this reads oldest-unread-first from your server cursor and ' +
             'advances the watermark so bursts are not skipped. Optional `since` is a strict-after ' +
             'cursor for explicit bounded reads only; do not use it with the same timestamp as a ' +
-            'notification preview because it can skip the boundary entry.',
+            'notification preview because it can skip the boundary entry. Use `borg_read-entry` ' +
+            'to fetch one known entry without changing the unread cursor.',
           inputSchema: {
             type: 'object',
             properties: {
@@ -229,6 +230,22 @@ export const TOOL_MANIFEST: ToolManifestEntry[] = [
             },
           },
         },
+        {
+          name: 'borg_read-entry',
+          description:
+            'Read one complete activity-log entry by its canonical UUID or unique 8-hex prefix without changing the unread cursor. Returns the same entry shape and structured routing recipients as borg_read-log. Use borg_read-log unread_only=true for routine wake drains. Direct routing controls delivery and wakes, not read confidentiality inside the cube.',
+          inputSchema: {
+            type: 'object',
+            properties: {
+              entry_id: {
+                type: 'string',
+                pattern: '^(?:[0-9A-Fa-f]{8}|[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[1-8][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12})$',
+                description: 'Canonical activity-log entry UUID or unique 8-hex prefix.',
+              },
+            },
+            required: ['entry_id'],
+          },
+        },
         {
           name: 'borg_ack',
           description:
@@ -385,26 +402,29 @@ export const TOOL_MANIFEST: ToolManifestEntry[] = [
         {
           name: 'borg_log',
           description:
-            'Append a message to the cube\'s activity log. By default entries broadcast to all drones. Cite durable cube documents by passing their full ids in `documents`; citations carry current metadata but do not inline document content. When a cube declares a message taxonomy, borg_log applies class-based smart defaults: prefix-matched directed classes route to their default recipients unless you pass `to:`, `class`, or explicit visibility. Pass `to: [...]` to direct by exact drone label, drone id, the 8-hex short-uuid (the `id:` token shown in roster/read-log — a drone_id prefix that is STABLE across label renumber), role name, or role slug.',
+            'Append a message to the cube\'s activity log with an explicit audience. Every call must pass `to: "broadcast"` for all drones or a non-empty selector array for direct delivery. Selectors accept an exact drone label, drone id, the stable 8-hex `id:` token shown in roster/read-log, role name, or role slug. Message text and taxonomy classes never choose the audience; optional `class` records classification/lifecycle metadata only. Cite durable cube documents through `documents`; citations carry current metadata but do not inline document content. Direct routing controls delivery and wakes, not read confidentiality inside the cube.',
           inputSchema: {
             type: 'object',
             properties: {
               message: { type: 'string', description: 'The log message (max 10KB).' },
               to: {
-                type: 'array',
-                items: { type: 'string' },
+                oneOf: [
+                  { type: 'string', enum: ['broadcast'] },
+                  {
+                    type: 'array',
+                    items: { type: 'string', minLength: 1, maxLength: 120 },
+                    minItems: 1,
+                    maxItems: 100,
+                    uniqueItems: true,
+                  },
+                ],
                 description:
-                  'Optional direct-message recipients by exact drone label, drone id, the 8-hex short-uuid (`id:` token from roster/read-log; stable across label renumber), role name, or role slug (resolves to all drones in that role). Omit to let class-based routing or broadcast defaults apply.',
+                  'Required explicit audience: "broadcast" for every drone, or a non-empty array of exact drone labels, drone ids, stable 8-hex `id:` tokens, role names, or role slugs.',
               },
               class: {
                 type: 'string',
                 description:
-                  'Optional declared message class. Overrides prefix auto-classification when the cube declares a message taxonomy.',
-              },
-              visibility: {
-                type: 'string',
-                enum: ['broadcast', 'direct'],
-                description: 'Optional explicit visibility. Overrides class-based routing defaults.',
+                  'Optional declared message class for classification/lifecycle metadata. It never changes the required `to` audience.',
               },
               documents: {
                 type: 'array',
@@ -415,7 +435,7 @@ export const TOOL_MANIFEST: ToolManifestEntry[] = [
                 description: 'Optional full opaque ids of 1-100 same-cube documents to cite atomically. Unknown, duplicate, or foreign ids are refused.',
               },
             },
-            required: ['message'],
+            required: ['message', 'to'],
           },
         },
         {
@@ -456,14 +476,12 @@ export const TOOL_MANIFEST: ToolManifestEntry[] = [
               cube_directive: { type: 'string', description: 'New cube directive markdown (optional).' },
               message_taxonomy: {
                 type: 'array',
-                description: 'New message-class taxonomy (optional). REPLACES the whole taxonomy; the worker re-validates the full array (non-overlapping prefixes, unique class names, directed classes need default_to). Pass [] to clear. To change ONE class without resending the whole array, use borg_patch-taxonomy-class instead. In default_to, pass @human-seat to route to drones in the cube human-seat role(s); literal role names/slugs/labels still work. Optional lifecycle tags mark dispatch/completion classes for stuck-dispatch detection.',
+                description: 'New classification/lifecycle taxonomy (optional). REPLACES the whole taxonomy; the server re-validates non-overlapping prefixes and unique class names. Pass [] to clear. To change ONE class without resending the whole array, use borg_patch-taxonomy-class instead. Optional lifecycle tags mark dispatch/completion classes for stuck-dispatch detection. Taxonomy never chooses log recipients.',
                 items: {
                   type: 'object',
                   properties: {
                     class: { type: 'string', description: 'Unique class name.' },
-                    prefixes: { type: 'array', items: { type: 'string' }, description: 'Message prefixes routed by this class.' },
-                    routing: { type: 'string', enum: ['broadcast', 'directed'], description: 'Routing mode.' },
-                    default_to: { type: 'array', items: { type: 'string' }, description: 'Default recipients (role name/slug/label, or @human-seat) for a directed class.' },
+                    prefixes: { type: 'array', items: { type: 'string' }, description: 'Message prefixes classified by this class.' },
                     lifecycle: { type: 'string', enum: ['dispatch', 'completion'], description: 'Optional lifecycle marker for stuck-dispatch detection.' },
                   },
                 },
@@ -475,7 +493,7 @@ export const TOOL_MANIFEST: ToolManifestEntry[] = [
         {
           name: 'borg_patch-taxonomy-class',
           description:
-            "Patch ONE message-class in a cube's message_taxonomy without resending the whole taxonomy (avoids clobbering). action=add|replace|remove (replace/remove match name case-insensitively). The full taxonomy is re-validated after the patch (non-overlapping prefixes, unique names, directed classes need default_to) — a patch that breaks a rule against an untouched class is rejected. In default_to, @human-seat routes to the cube's human-seat role(s); literal names/slugs/labels also work. Optional lifecycle tags mark dispatch/completion classes for stuck-dispatch detection.",
+            "Patch ONE classification/lifecycle class in a cube's message_taxonomy without resending the whole taxonomy (avoids clobbering). action=add|replace|remove (replace/remove match name case-insensitively). The full taxonomy is re-validated for non-overlapping prefixes and unique names. Optional lifecycle tags mark dispatch/completion classes for stuck-dispatch detection. Taxonomy never chooses log recipients.",
           inputSchema: {
             type: 'object',
             properties: {
@@ -483,15 +501,13 @@ export const TOOL_MANIFEST: ToolManifestEntry[] = [
               action: { type: 'string', enum: ['add', 'replace', 'remove'], description: 'add / replace / remove a single class.' },
               class_def: {
                 type: 'object',
-                description: 'The class definition (for add/replace). Shape: { class, prefixes?, routing: "broadcast"|"directed", default_to?, lifecycle? }.',
+                description: 'The class definition (for add/replace). Shape: { class, prefixes?, lifecycle? }.',
                 properties: {
                   class: { type: 'string', description: 'Unique class name.' },
-                  prefixes: { type: 'array', items: { type: 'string' }, description: 'Message prefixes routed by this class.' },
-                  routing: { type: 'string', enum: ['broadcast', 'directed'], description: 'Routing mode.' },
-                  default_to: { type: 'array', items: { type: 'string' }, description: 'Default recipients (required for directed classes): role name/slug/label, or @human-seat.' },
+                  prefixes: { type: 'array', items: { type: 'string' }, description: 'Message prefixes classified by this class.' },
                   lifecycle: { type: 'string', enum: ['dispatch', 'completion'], description: 'Optional lifecycle marker for stuck-dispatch detection.' },
                 },
-                required: ['class', 'routing'],
+                required: ['class'],
               },
               class: { type: 'string', description: 'For remove only: the name of the class to drop (case-insensitive).' },
             },
@@ -524,7 +540,7 @@ export const TOOL_MANIFEST: ToolManifestEntry[] = [
               is_mandatory: { type: 'boolean', description: 'If true, role-less assimilation prioritizes this unoccupied role before ordinary worker roles. Platform-wide management roles are never auto-assigned; a mandatory human-operator role is selected first until occupied.' },
               is_human_seat: { type: 'boolean', description: 'If true, this role represents the cube\'s human-occupied seat (where the human Queen sits directly). The class-hierarchy guard in reassign-drone allows promotion FROM a human-seat role TO the platform Queen role; promotion from non-human-seat roles is rejected.' },
               can_broadcast: { type: 'boolean', description: 'If true, drones in this role may post broadcast log entries when strict broadcast gating is enabled.' },
-              receives_all_direct: { type: 'boolean', description: 'If true, drones in this role can see direct log entries as observer/audit recipients.' },
+              receives_all_direct: { type: 'boolean', description: 'If true, drones in this role are included as observer/audit recipients for every direct route.' },
             },
             required: ['cube_id', 'name', 'short_description', 'detailed_description'],
           },
@@ -543,7 +559,7 @@ export const TOOL_MANIFEST: ToolManifestEntry[] = [
               is_mandatory: { type: 'boolean', description: 'Set true/false to prioritize this unoccupied role during role-less assimilation. Platform-wide management roles are never auto-assigned.' },
               is_human_seat: { type: 'boolean', description: 'Set true/false to mark/unmark this as the cube\'s human-occupied seat (the elevation source for the platform Queen role).' },
               can_broadcast: { type: 'boolean', description: 'Set true/false to allow or deny broadcast log entries when strict broadcast gating is enabled.' },
-              receives_all_direct: { type: 'boolean', description: 'Set true/false to grant or remove observer visibility into direct log entries.' },
+              receives_all_direct: { type: 'boolean', description: 'Set true/false to include or remove this role as observer/audit recipients for every direct route.' },
             },
             required: ['role_id'],
           },
@@ -566,7 +582,7 @@ export const TOOL_MANIFEST: ToolManifestEntry[] = [
         },
         {
           name: 'borg_delete-role',
-          description: 'Delete a role using the selected local client\'s cube-management grant. Unknown or inaccessible roles refuse. Also refuses for the default, mandatory, or human-seat role; a role referenced by message-taxonomy routing; or a role assigned to an active drone. Reassign active drones with borg_reassign-drone or remove them with borg_evict-drone first. Evicted drones that held the deleted role are reassigned to the cube\'s default role; their activity-log attribution is unaffected.',
+          description: 'Delete a role using the selected local client\'s cube-management grant. Unknown or inaccessible roles refuse. Also refuses for the default, mandatory, or human-seat role, or a role assigned to an active drone. Reassign active drones with borg_reassign-drone or remove them with borg_evict-drone first. Evicted drones that held the deleted role are reassigned to the cube\'s default role; their activity-log attribution is unaffected.',
           inputSchema: {
             type: 'object',
             properties: {

package/src/tool-scope.ts

@@ -20,6 +20,7 @@ export const UNIVERSAL_TOOLS = [
   'borg_regen',
   'borg_log',
   'borg_read-log',
+  'borg_read-entry',
   'borg_roster',
   'borg_stream-status',
   'borg_whoami',

package/dist/local-log-routing.d.ts

@@ -1,19 +0,0 @@
-export interface LocalRoutingDrone {
-    id: string;
-    label?: string | null;
-    role_id?: string | null;
-}
-export interface LocalRoutingRole {
-    id: string;
-    name: string;
-    is_human_seat?: boolean;
-}
-/**
- * Resolve the public `borg_log to:` addressing forms against the local
- * server's authoritative cube roster. This intentionally mirrors the hosted
- * route resolver: exact drone id/label first, then displayed short UUID, then
- * role name/slug expansion. Every failure is closed before the log POST so a
- * miss can never degrade into a broadcast.
- */
-export declare function resolveLocalLogRecipients(recipients: readonly string[], drones: readonly LocalRoutingDrone[], roles: readonly LocalRoutingRole[]): string[];
-//# sourceMappingURL=local-log-routing.d.ts.map

package/dist/local-log-routing.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"local-log-routing.d.ts","sourceRoot":"","sources":["../src/local-log-routing.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,MAAM,EAAE,SAAS,iBAAiB,EAAE,EACpC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GACjC,MAAM,EAAE,CAgFV"}

package/dist/local-log-routing.js

@@ -1,67 +0,0 @@
-import { roleSlug } from './role-resolver.js';
-/**
- * Resolve the public `borg_log to:` addressing forms against the local
- * server's authoritative cube roster. This intentionally mirrors the hosted
- * route resolver: exact drone id/label first, then displayed short UUID, then
- * role name/slug expansion. Every failure is closed before the log POST so a
- * miss can never degrade into a broadcast.
- */
-export function resolveLocalLogRecipients(recipients, drones, roles) {
-    const ids = new Set();
-    for (const recipient of recipients) {
-        if (recipient === '@human-seat') {
-            const roleIds = new Set(roles.filter((role) => role.is_human_seat === true).map((role) => role.id));
-            const matches = drones.filter((drone) => drone.role_id !== null && drone.role_id !== undefined && roleIds.has(drone.role_id));
-            if (roleIds.size === 0 || matches.length === 0) {
-                throw new Error('Direct-message role recipient has no active drones: @human-seat. ' +
-                    'Use borg_roster to find active recipients, or omit to broadcast if your role can broadcast.');
-            }
-            for (const drone of matches)
-                ids.add(drone.id);
-            continue;
-        }
-        const droneMatches = drones.filter((drone) => drone.id === recipient || drone.label === recipient);
-        const uniqueDroneIds = [...new Set(droneMatches.map((drone) => drone.id))];
-        if (uniqueDroneIds.length > 1) {
-            throw new Error(`Ambiguous direct-message recipient: ${recipient} matches multiple drones`);
-        }
-        if (uniqueDroneIds.length === 1) {
-            ids.add(uniqueDroneIds[0]);
-            continue;
-        }
-        const shortUuid = recipient.replace(/`/g, '').replace(/^id:/i, '').toLowerCase();
-        if (/^[0-9a-f]{8,}$/.test(shortUuid)) {
-            const prefixMatches = drones.filter((drone) => drone.id.toLowerCase().startsWith(shortUuid));
-            const uniquePrefixIds = [...new Set(prefixMatches.map((drone) => drone.id))];
-            if (uniquePrefixIds.length > 1) {
-                const listed = prefixMatches
-                    .map((drone) => `${drone.id} (${drone.label ?? 'unlabeled'})`)
-                    .join(', ');
-                throw new Error(`Ambiguous short-uuid recipient: ${recipient} matches multiple drones — ${listed}. ` +
-                    'Address by the full drone id.');
-            }
-            if (uniquePrefixIds.length === 1) {
-                ids.add(uniquePrefixIds[0]);
-                continue;
-            }
-        }
-        const roleMatches = roles.filter((role) => roleSlug(role.name) === roleSlug(recipient));
-        const uniqueRoleIds = [...new Set(roleMatches.map((role) => role.id))];
-        if (uniqueRoleIds.length > 1) {
-            throw new Error(`Ambiguous direct-message recipient: ${recipient} matches multiple roles`);
-        }
-        if (uniqueRoleIds.length === 0) {
-            throw new Error(`Unknown direct-message recipient: ${recipient}. ` +
-                'Use an exact drone label, drone id, role name, or role slug.');
-        }
-        const roleDrones = drones.filter((drone) => drone.role_id === uniqueRoleIds[0]);
-        if (roleDrones.length === 0) {
-            throw new Error(`Direct-message role recipient has no active drones: ${recipient}. ` +
-                'Use borg_roster to find active recipients, or omit to broadcast if your role can broadcast.');
-        }
-        for (const drone of roleDrones)
-            ids.add(drone.id);
-    }
-    return [...ids];
-}
-//# sourceMappingURL=local-log-routing.js.map

package/dist/local-log-routing.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"local-log-routing.js","sourceRoot":"","sources":["../src/local-log-routing.ts"],"names":[],"mappings":"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"}

package/src/local-log-routing.ts

@@ -1,106 +0,0 @@
-import { roleSlug } from './role-resolver.js';
-
-export interface LocalRoutingDrone {
-  id: string;
-  label?: string | null;
-  role_id?: string | null;
-}
-
-export interface LocalRoutingRole {
-  id: string;
-  name: string;
-  is_human_seat?: boolean;
-}
-
-/**
- * Resolve the public `borg_log to:` addressing forms against the local
- * server's authoritative cube roster. This intentionally mirrors the hosted
- * route resolver: exact drone id/label first, then displayed short UUID, then
- * role name/slug expansion. Every failure is closed before the log POST so a
- * miss can never degrade into a broadcast.
- */
-export function resolveLocalLogRecipients(
-  recipients: readonly string[],
-  drones: readonly LocalRoutingDrone[],
-  roles: readonly LocalRoutingRole[],
-): string[] {
-  const ids = new Set<string>();
-
-  for (const recipient of recipients) {
-    if (recipient === '@human-seat') {
-      const roleIds = new Set(
-        roles.filter((role) => role.is_human_seat === true).map((role) => role.id),
-      );
-      const matches = drones.filter((drone) =>
-        drone.role_id !== null && drone.role_id !== undefined && roleIds.has(drone.role_id)
-      );
-      if (roleIds.size === 0 || matches.length === 0) {
-        throw new Error(
-          'Direct-message role recipient has no active drones: @human-seat. ' +
-          'Use borg_roster to find active recipients, or omit to broadcast if your role can broadcast.',
-        );
-      }
-      for (const drone of matches) ids.add(drone.id);
-      continue;
-    }
-
-    const droneMatches = drones.filter(
-      (drone) => drone.id === recipient || drone.label === recipient,
-    );
-    const uniqueDroneIds = [...new Set(droneMatches.map((drone) => drone.id))];
-    if (uniqueDroneIds.length > 1) {
-      throw new Error(
-        `Ambiguous direct-message recipient: ${recipient} matches multiple drones`,
-      );
-    }
-    if (uniqueDroneIds.length === 1) {
-      ids.add(uniqueDroneIds[0]!);
-      continue;
-    }
-
-    const shortUuid = recipient.replace(/`/g, '').replace(/^id:/i, '').toLowerCase();
-    if (/^[0-9a-f]{8,}$/.test(shortUuid)) {
-      const prefixMatches = drones.filter((drone) =>
-        drone.id.toLowerCase().startsWith(shortUuid)
-      );
-      const uniquePrefixIds = [...new Set(prefixMatches.map((drone) => drone.id))];
-      if (uniquePrefixIds.length > 1) {
-        const listed = prefixMatches
-          .map((drone) => `${drone.id} (${drone.label ?? 'unlabeled'})`)
-          .join(', ');
-        throw new Error(
-          `Ambiguous short-uuid recipient: ${recipient} matches multiple drones — ${listed}. ` +
-          'Address by the full drone id.',
-        );
-      }
-      if (uniquePrefixIds.length === 1) {
-        ids.add(uniquePrefixIds[0]!);
-        continue;
-      }
-    }
-
-    const roleMatches = roles.filter((role) => roleSlug(role.name) === roleSlug(recipient));
-    const uniqueRoleIds = [...new Set(roleMatches.map((role) => role.id))];
-    if (uniqueRoleIds.length > 1) {
-      throw new Error(
-        `Ambiguous direct-message recipient: ${recipient} matches multiple roles`,
-      );
-    }
-    if (uniqueRoleIds.length === 0) {
-      throw new Error(
-        `Unknown direct-message recipient: ${recipient}. ` +
-        'Use an exact drone label, drone id, role name, or role slug.',
-      );
-    }
-    const roleDrones = drones.filter((drone) => drone.role_id === uniqueRoleIds[0]);
-    if (roleDrones.length === 0) {
-      throw new Error(
-        `Direct-message role recipient has no active drones: ${recipient}. ` +
-        'Use borg_roster to find active recipients, or omit to broadcast if your role can broadcast.',
-      );
-    }
-    for (const drone of roleDrones) ids.add(drone.id);
-  }
-
-  return [...ids];
-}