@adhdev/mesh-shared 1.0.75 → 1.0.76-rc.2

package/dist/assistant-protocol.d.ts

@@ -0,0 +1,60 @@
+/**
+ * assistant-protocol — the assistant layer's tool and daemon-verb names
+ * (docs/design/2026-10-07-assistant-layer.md §4.4).
+ *
+ * The single source for both halves of the assistant contract, like
+ * `WORKER_TOOLS` is for workers:
+ *   - `ASSISTANT_TOOLS` — exactly what `adhdev mcp --assistant` will advertise
+ *     (an mcp-server parity test pins ListTools to this tuple once that mode
+ *     lands);
+ *   - `ASSISTANT_TOOL_VERBS` — the daemon command each tool calls;
+ *   - the daemon-only verbs (launch / MCP-only pull / owner actions) that have
+ *     no tool.
+ *
+ * Assistant tools are a separate set from the mesh tools: none of these names
+ * belongs in `CANONICAL_MESH_TOOL_NAMES`, and the coordinator/worker MCP modes
+ * never publish them.
+ */
+export declare const ASSISTANT_TOOLS: readonly ["projects", "project_status", "project_send", "project_read", "project_add", "discover_repos", "memory", "skill_view", "skill_manage", "project_note"];
+export type AssistantTool = typeof ASSISTANT_TOOLS[number];
+export declare function isAssistantTool(value: unknown): value is AssistantTool;
+/** Daemon verb names (§4.4 table + the five verbs below it). */
+export declare const ASSISTANT_VERB: {
+    readonly projects: "assistant_projects";
+    readonly projectStatus: "assistant_project_status";
+    readonly projectSend: "assistant_project_send";
+    readonly projectRead: "assistant_project_read";
+    readonly projectAdd: "assistant_project_add";
+    readonly discoverRepos: "assistant_discover_repos";
+    readonly memory: "assistant_memory";
+    readonly skillView: "assistant_skill_view";
+    readonly skillManage: "assistant_skill_manage";
+    readonly projectNote: "assistant_project_note";
+    readonly launch: "launch_assistant";
+    readonly pendingRelays: "assistant_pending_relays";
+    readonly stagedResolve: "assistant_staged_resolve";
+    readonly storeAdmin: "assistant_store_admin";
+    readonly importSkills: "assistant_import_skills";
+};
+export type AssistantVerb = typeof ASSISTANT_VERB[keyof typeof ASSISTANT_VERB];
+/** The daemon verb each assistant tool calls. */
+export declare const ASSISTANT_TOOL_VERBS: Readonly<Record<AssistantTool, AssistantVerb>>;
+/**
+ * Tools annotated as writes; every other assistant tool is read-only. §4.4
+ * lists the three store writes; project_send and project_add are here too
+ * because they cause effects (a coordinator message or launch, a new
+ * project), and MCP clients use readOnlyHint to skip confirmation.
+ */
+export declare const ASSISTANT_WRITE_TOOLS: readonly AssistantTool[];
+/** Owner-only verbs: never reachable from the assistant's MCP server (no `ipc`). */
+export declare const ASSISTANT_OWNER_VERBS: readonly AssistantVerb[];
+/** The only assistant verbs accepted while an idle review turn is open (§4.10.7). */
+export declare const ASSISTANT_REVIEW_TURN_VERBS: readonly AssistantVerb[];
+/**
+ * Env var the daemon sets on the assistant CLI's process (§4.5), read by the
+ * assistant MCP server and forwarded on every verb as
+ * `ASSISTANT_SESSION_ID_ARG`. Routing / ownership only — never an auth gate.
+ */
+export declare const ASSISTANT_SESSION_ID_ENV = "ADHDEV_ASSISTANT_SESSION_ID";
+/** Request arg carrying the calling assistant session id. */
+export declare const ASSISTANT_SESSION_ID_ARG = "assistantSessionId";

package/dist/index.d.ts

@@ -32,6 +32,7 @@ export * from './session-status';
 export * from './mesh-vocabulary';
 export * from './outbound-message';
 export * from './worker-protocol';
+export * from './assistant-protocol';
 export * from './protocol';
 export * from './turn-evidence';
 export * from './session-launch';

package/dist/index.js

@@ -20,6 +20,14 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ASSISTANT_OWNER_VERBS: () => ASSISTANT_OWNER_VERBS,
+  ASSISTANT_REVIEW_TURN_VERBS: () => ASSISTANT_REVIEW_TURN_VERBS,
+  ASSISTANT_SESSION_ID_ARG: () => ASSISTANT_SESSION_ID_ARG,
+  ASSISTANT_SESSION_ID_ENV: () => ASSISTANT_SESSION_ID_ENV,
+  ASSISTANT_TOOLS: () => ASSISTANT_TOOLS,
+  ASSISTANT_TOOL_VERBS: () => ASSISTANT_TOOL_VERBS,
+  ASSISTANT_VERB: () => ASSISTANT_VERB,
+  ASSISTANT_WRITE_TOOLS: () => ASSISTANT_WRITE_TOOLS,
   CANCEL_REASONS: () => CANCEL_REASONS,
   CANONICAL_MESH_TOOL_COUNT: () => CANONICAL_MESH_TOOL_COUNT,
   CANONICAL_MESH_TOOL_NAMES: () => CANONICAL_MESH_TOOL_NAMES,
@@ -215,6 +223,7 @@ __export(index_exports, {
   hasGitStatusEvidence: () => hasGitStatusEvidence,
   hasWorkerProtocolFooter: () => hasWorkerProtocolFooter,
   interpolateString: () => interpolateString,
+  isAssistantTool: () => isAssistantTool,
   isBlockedStatus: () => isBlockedStatus,
   isBusyStatus: () => isBusyStatus,
   isChunkType: () => isChunkType,
@@ -900,18 +909,6 @@ var CLI_SLOT_RECIPES = Object.freeze({
       maxParallel: 1,
       rationale: "Easy tasks only; auto model selection."
     }
-  ],
-  "hermes-cli": [
-    {
-      difficulty: ["medium"],
-      maxParallel: 2,
-      provisional: true,
-      // NOTE: ESTIMATE, NOT OBSERVED. hermes-cli is absent from the live
-      // slot configuration this table was seeded from, so `medium` is a
-      // conservative placement rather than a transcription. Revisit once
-      // it has real usage data.
-      rationale: "ESTIMATE \u2014 no live slot to transcribe; conservative mid placement. Adjust after real use."
-    }
   ]
 });
 var UNKNOWN_CLI_SLOT_RECIPE = Object.freeze({
@@ -1768,7 +1765,7 @@ var MESSAGE_ID_PREFIX = "msg_";
 function isMessageId(value) {
   return typeof value === "string" && value.length > MESSAGE_ID_PREFIX.length && value.startsWith(MESSAGE_ID_PREFIX);
 }
-var OUTBOUND_MESSAGE_ORIGINS = ["dashboard", "mcp", "mesh", "api", "cli"];
+var OUTBOUND_MESSAGE_ORIGINS = ["dashboard", "mcp", "mesh", "api", "cli", "assistant"];
 function isOutboundMessageOrigin(value) {
   return typeof value === "string" && OUTBOUND_MESSAGE_ORIGINS.includes(value);
 }
@@ -1979,6 +1976,70 @@ function renderCoordinatorWorkerSection() {
   ].join("\n");
 }
 
+// src/assistant-protocol.ts
+var ASSISTANT_TOOLS = [
+  "projects",
+  "project_status",
+  "project_send",
+  "project_read",
+  "project_add",
+  "discover_repos",
+  "memory",
+  "skill_view",
+  "skill_manage",
+  "project_note"
+];
+var ASSISTANT_TOOL_SET = new Set(ASSISTANT_TOOLS);
+function isAssistantTool(value) {
+  return typeof value === "string" && ASSISTANT_TOOL_SET.has(value);
+}
+var ASSISTANT_VERB = {
+  // tool verbs
+  projects: "assistant_projects",
+  projectStatus: "assistant_project_status",
+  projectSend: "assistant_project_send",
+  projectRead: "assistant_project_read",
+  projectAdd: "assistant_project_add",
+  discoverRepos: "assistant_discover_repos",
+  memory: "assistant_memory",
+  skillView: "assistant_skill_view",
+  skillManage: "assistant_skill_manage",
+  projectNote: "assistant_project_note",
+  // assistant-side daemon verbs without a tool of the same name
+  launch: "launch_assistant",
+  pendingRelays: "assistant_pending_relays",
+  // owner verbs (dashboard only)
+  stagedResolve: "assistant_staged_resolve",
+  storeAdmin: "assistant_store_admin",
+  importSkills: "assistant_import_skills"
+};
+var ASSISTANT_TOOL_VERBS = {
+  projects: ASSISTANT_VERB.projects,
+  project_status: ASSISTANT_VERB.projectStatus,
+  project_send: ASSISTANT_VERB.projectSend,
+  project_read: ASSISTANT_VERB.projectRead,
+  project_add: ASSISTANT_VERB.projectAdd,
+  discover_repos: ASSISTANT_VERB.discoverRepos,
+  memory: ASSISTANT_VERB.memory,
+  skill_view: ASSISTANT_VERB.skillView,
+  skill_manage: ASSISTANT_VERB.skillManage,
+  project_note: ASSISTANT_VERB.projectNote
+};
+var ASSISTANT_WRITE_TOOLS = ["memory", "skill_manage", "project_note", "project_send", "project_add"];
+var ASSISTANT_OWNER_VERBS = [
+  ASSISTANT_VERB.stagedResolve,
+  ASSISTANT_VERB.storeAdmin,
+  ASSISTANT_VERB.importSkills
+];
+var ASSISTANT_REVIEW_TURN_VERBS = [
+  ASSISTANT_VERB.memory,
+  ASSISTANT_VERB.skillView,
+  ASSISTANT_VERB.skillManage,
+  ASSISTANT_VERB.projectNote
+];
+var ASSISTANT_SESSION_ID_ENV = "ADHDEV_ASSISTANT_SESSION_ID";
+var ASSISTANT_SESSION_ID_ARG = "assistantSessionId";
+
 // src/turn-evidence.ts
 var MESH_TOPIC_PROTOCOL_VERSION = 2;
 var EVIDENCE_SOURCE_IDS = [
@@ -2373,7 +2434,7 @@ var MODEL_AXIS_SOURCES = [
 function isModelAxisSource(value) {
   return typeof value === "string" && MODEL_AXIS_SOURCES.includes(value);
 }
-var SESSION_LAUNCHED_BY = ["dashboard", "mesh", "cli", "api", "restore"];
+var SESSION_LAUNCHED_BY = ["dashboard", "mesh", "cli", "api", "restore", "assistant"];
 function isSessionLaunchedBy(value) {
   return typeof value === "string" && SESSION_LAUNCHED_BY.includes(value);
 }
@@ -3646,6 +3707,14 @@ function stableMeshNodeRow(row) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ASSISTANT_OWNER_VERBS,
+  ASSISTANT_REVIEW_TURN_VERBS,
+  ASSISTANT_SESSION_ID_ARG,
+  ASSISTANT_SESSION_ID_ENV,
+  ASSISTANT_TOOLS,
+  ASSISTANT_TOOL_VERBS,
+  ASSISTANT_VERB,
+  ASSISTANT_WRITE_TOOLS,
   CANCEL_REASONS,
   CANONICAL_MESH_TOOL_COUNT,
   CANONICAL_MESH_TOOL_NAMES,
@@ -3841,6 +3910,7 @@ function stableMeshNodeRow(row) {
   hasGitStatusEvidence,
   hasWorkerProtocolFooter,
   interpolateString,
+  isAssistantTool,
   isBlockedStatus,
   isBusyStatus,
   isChunkType,