@adhdev/mesh-shared 1.0.82-rc.33 → 1.0.82-rc.34

package/dist/assistant-protocol.d.ts

@@ -14,7 +14,7 @@
  * Assistant-specific tools remain separate from mesh tools. Driver discovery
  * (list/describe) is shared across all three modes; invoke remains Worker-only.
  */
-export declare const ASSISTANT_TOOLS: readonly ["projects", "environment", "assistant_action", "project_watch", "project_status", "project_send", "project_read", "project_add", "project_attach_remote", "discover_repos", "memory", "skill_view", "skill_manage", "project_note", "launch_defaults", "launch_defaults_set", "driver_list", "driver_describe"];
+export declare const ASSISTANT_TOOLS: readonly ["projects", "environment", "assistant_action", "project_watch", "project_status", "project_send", "project_read", "project_add", "project_attach_remote", "discover_repos", "memory", "skill_view", "skill_manage", "project_note", "launch_defaults", "launch_defaults_set", "driver_list", "driver_describe", "artifact_list", "artifact_read"];
 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). */
@@ -39,6 +39,8 @@ export declare const ASSISTANT_VERB: {
     readonly projectNote: "assistant_project_note";
     readonly launchDefaults: "assistant_launch_defaults";
     readonly launchDefaultsSet: "assistant_launch_defaults_set";
+    readonly artifactList: "assistant_artifact_list";
+    readonly artifactRead: "assistant_artifact_read";
     readonly launch: "launch_assistant";
     readonly pendingRelays: "assistant_pending_relays";
     readonly stagedResolve: "assistant_staged_resolve";
@@ -90,7 +92,7 @@ export declare const ASSISTANT_REMOTE_FOLLOW_COMMAND: "assistant_remote_follow";
  * `assistant_remote_project` when the host's `assistantRemoteAccess` ACL is active.
  * `note`, `terminal`, and `inventory` remain strictly roster-member-only.
  */
-export declare const ASSISTANT_FOLLOWER_ALLOWED_OPS: readonly ["status", "read", "poll", "report", "send"];
+export declare const ASSISTANT_FOLLOWER_ALLOWED_OPS: readonly ["status", "read", "poll", "report", "send", "artifact_list", "artifact_read"];
 export type AssistantFollowerAllowedOp = typeof ASSISTANT_FOLLOWER_ALLOWED_OPS[number];
 export declare function isAssistantFollowerAllowedOp(value: unknown): value is AssistantFollowerAllowedOp;
 /**
@@ -108,6 +110,7 @@ export interface AssistantRemoteAccessBinding {
     status: 'active' | 'revoked';
     allowedOps: readonly AssistantFollowerAllowedOp[];
     allowCoordinatorLaunch?: boolean;
+    allowArtifactRead?: boolean;
     grantedAt: number;
     revokedAt?: number;
 }
@@ -144,6 +147,7 @@ export interface FollowedRemoteProjectEntry {
     bindingRevision: number;
     grantRevision: number;
     allowCoordinatorLaunch?: boolean;
+    allowArtifactRead?: boolean;
     state: FollowedRemoteProjectState;
     followedAt: number | string;
     updatedAt: number | string;
@@ -173,6 +177,7 @@ export interface RemoteProjectCatalogItem {
     sanitizedRepoIdentity: string | null;
     coordinatorState?: 'none' | 'idle' | 'working' | 'waiting' | string;
     allowCoordinatorLaunch?: boolean;
+    allowArtifactRead?: boolean;
     capabilities: {
         status: true;
         read: true;
@@ -181,6 +186,7 @@ export interface RemoteProjectCatalogItem {
         send: true;
         coordinatorPresent?: boolean;
         allowCoordinatorLaunch?: boolean;
+        allowArtifactRead?: boolean;
     };
     observedAt: number | string;
 }

package/dist/index.d.ts

@@ -46,3 +46,4 @@ export * from './provider-question';
 export * from './launch-defaults';
 export * from './role-launch';
 export * from './task-source-phase';
+export * from './relay-reprobe';

package/dist/index.js

@@ -112,9 +112,13 @@ __export(index_exports, {
   QUOTA_SUPPORTED_PROVIDERS: () => QUOTA_SUPPORTED_PROVIDERS,
   RECENT_SESSION_BUCKETS: () => RECENT_SESSION_BUCKETS,
   RECLAIMING_SEND_REFUSALS: () => RECLAIMING_SEND_REFUSALS,
+  RELAY_REPROBE_BASE_DELAY_MS: () => RELAY_REPROBE_BASE_DELAY_MS,
+  RELAY_REPROBE_JITTER_RATIO: () => RELAY_REPROBE_JITTER_RATIO,
+  RELAY_REPROBE_MAX_DELAY_MS: () => RELAY_REPROBE_MAX_DELAY_MS,
   RELEASE_CHANNELS: () => RELEASE_CHANNELS,
   REMOVED_MESH_TOOLS: () => REMOVED_MESH_TOOLS,
   RETIRED_MESH_TOOLS: () => RETIRED_MESH_TOOLS,
+  RelayReprobeScheduler: () => RelayReprobeScheduler,
   SEND_POLICY_MODES: () => SEND_POLICY_MODES,
   SEND_REFUSAL_REASONS: () => SEND_REFUSAL_REASONS,
   SERVER_STATUS_EVENT_NAMES: () => SERVER_STATUS_EVENT_NAMES,
@@ -164,6 +168,7 @@ __export(index_exports, {
   classifySessionStatus: () => classifySessionStatus,
   compareDashboardWireVersion: () => compareDashboardWireVersion,
   compareSemver: () => compareSemver,
+  computeRelayReprobeDelay: () => computeRelayReprobeDelay,
   daemonIdsEquivalent: () => daemonIdsEquivalent,
   decodeActiveWorkQueryRequest: () => decodeActiveWorkQueryRequest,
   decodeActiveWorkQueryResponse: () => decodeActiveWorkQueryResponse,
@@ -1158,6 +1163,7 @@ var CANONICAL_MESH_TOOL_NAMES = [
   "mesh_list_pending_approvals",
   "mesh_create",
   "mesh_add_node",
+  "mesh_reattach_source_parent",
   "mesh_attach_remote",
   "mesh_clone_node",
   "mesh_remove_node",
@@ -1181,7 +1187,9 @@ var CANONICAL_MESH_TOOL_NAMES = [
   "mesh_node_slots",
   "driver_list",
   "driver_describe",
-  "artifact_list"
+  "artifact_list",
+  "artifact_read",
+  "artifact_register"
 ];
 var CANONICAL_MESH_TOOL_COUNT = CANONICAL_MESH_TOOL_NAMES.length;
 var RETIRED_MESH_TOOLS = {
@@ -2067,7 +2075,14 @@ var WORKER_TOOLS = [
   "driver_list",
   "driver_describe",
   "driver_invoke",
-  "artifact_register"
+  "artifact_register",
+  "artifact_list",
+  "artifact_read",
+  // Contract versioning (Cut A): exact pinned-unit reads (E2), the explicit
+  // read claim (C1) and the authoritative head/notice pull.
+  "contract_read",
+  "contract_observe",
+  "contract_current"
 ];
 var WORKER_TOOL_SET = new Set(WORKER_TOOLS);
 function isWorkerTool(value) {
@@ -2168,7 +2183,9 @@ var ASSISTANT_TOOLS = [
   "launch_defaults",
   "launch_defaults_set",
   "driver_list",
-  "driver_describe"
+  "driver_describe",
+  "artifact_list",
+  "artifact_read"
 ];
 var ASSISTANT_TOOL_SET = new Set(ASSISTANT_TOOLS);
 function isAssistantTool(value) {
@@ -2196,6 +2213,8 @@ var ASSISTANT_VERB = {
   projectNote: "assistant_project_note",
   launchDefaults: "assistant_launch_defaults",
   launchDefaultsSet: "assistant_launch_defaults_set",
+  artifactList: "assistant_artifact_list",
+  artifactRead: "assistant_artifact_read",
   // assistant-side daemon verbs without a tool of the same name
   launch: "launch_assistant",
   pendingRelays: "assistant_pending_relays",
@@ -2225,7 +2244,9 @@ var ASSISTANT_TOOL_VERBS = {
   skill_manage: ASSISTANT_VERB.skillManage,
   project_note: ASSISTANT_VERB.projectNote,
   launch_defaults: ASSISTANT_VERB.launchDefaults,
-  launch_defaults_set: ASSISTANT_VERB.launchDefaultsSet
+  launch_defaults_set: ASSISTANT_VERB.launchDefaultsSet,
+  artifact_list: ASSISTANT_VERB.artifactList,
+  artifact_read: ASSISTANT_VERB.artifactRead
 };
 var ASSISTANT_WRITE_TOOLS = ["project_watch", "assistant_action", "memory", "skill_manage", "project_note", "project_send", "project_add", "project_attach_remote", "launch_defaults_set"];
 var ASSISTANT_OWNER_VERBS = [
@@ -2248,7 +2269,7 @@ var ASSISTANT_REMOTE_PROJECT_COMMAND = "assistant_remote_project";
 var ASSISTANT_REMOTE_PROJECT_CATALOG_COMMAND = "assistant_remote_project_catalog";
 var ASSISTANT_REMOTE_PROJECT_ACCESS_COMMAND = "assistant_remote_project_access";
 var ASSISTANT_REMOTE_FOLLOW_COMMAND = "assistant_remote_follow";
-var ASSISTANT_FOLLOWER_ALLOWED_OPS = ["status", "read", "poll", "report", "send"];
+var ASSISTANT_FOLLOWER_ALLOWED_OPS = ["status", "read", "poll", "report", "send", "artifact_list", "artifact_read"];
 var ASSISTANT_FOLLOWER_ALLOWED_OP_SET = new Set(ASSISTANT_FOLLOWER_ALLOWED_OPS);
 function isAssistantFollowerAllowedOp(value) {
   return typeof value === "string" && ASSISTANT_FOLLOWER_ALLOWED_OP_SET.has(value);
@@ -4140,6 +4161,86 @@ function isProviderQuestionBinding(value) {
   if (["sessionId", "generation", "threadId", "turnId", "itemId"].some((key) => typeof b[key] !== "string" || !b[key].trim())) return false;
   return b.transport === "codex_async" ? b.requestId === void 0 : typeof b.requestId === "string" && !!b.requestId.trim() || typeof b.requestId === "number" && Number.isFinite(b.requestId);
 }
+
+// src/relay-reprobe.ts
+var RELAY_REPROBE_BASE_DELAY_MS = 6e4;
+var RELAY_REPROBE_MAX_DELAY_MS = 5 * 6e4;
+var RELAY_REPROBE_JITTER_RATIO = 0.2;
+function computeRelayReprobeDelay(failures, random, timing = {}) {
+  const base = timing.baseDelayMs ?? RELAY_REPROBE_BASE_DELAY_MS;
+  const max = timing.maxDelayMs ?? RELAY_REPROBE_MAX_DELAY_MS;
+  const jitter = timing.jitterRatio ?? RELAY_REPROBE_JITTER_RATIO;
+  const grown = Math.min(max, base * 2 ** Math.max(0, failures));
+  const factor = 1 + jitter * (Math.min(1, Math.max(0, random())) * 2 - 1);
+  return Math.round(grown * factor);
+}
+var RelayReprobeScheduler = class {
+  constructor(options) {
+    this.options = options;
+  }
+  handle = null;
+  running = false;
+  inFlight = false;
+  failureCount = 0;
+  generation = 0;
+  get isRunning() {
+    return this.running;
+  }
+  get failures() {
+    return this.failureCount;
+  }
+  get probing() {
+    return this.inFlight;
+  }
+  /** Begin probing (idempotent). Call when a connection is selected as relay. */
+  start() {
+    if (this.running) return;
+    this.running = true;
+    this.failureCount = 0;
+    this.generation++;
+    this.schedule();
+  }
+  /** Stop for good (direct path found, connection closed, auth epoch changed). */
+  stop() {
+    this.running = false;
+    this.generation++;
+    if (this.handle !== null) {
+      this.options.clearTimer(this.handle);
+      this.handle = null;
+    }
+  }
+  schedule() {
+    if (!this.running) return;
+    const generation = this.generation;
+    const delay = computeRelayReprobeDelay(this.failureCount, this.options.random, this.options);
+    this.handle = this.options.setTimer(() => {
+      this.handle = null;
+      void this.tick(generation);
+    }, delay);
+  }
+  async tick(generation) {
+    if (!this.running || generation !== this.generation) return;
+    if (this.inFlight || !this.options.shouldProbe()) {
+      this.schedule();
+      return;
+    }
+    this.inFlight = true;
+    let outcome;
+    try {
+      outcome = await this.options.probe();
+    } catch {
+      outcome = "failed";
+    }
+    this.inFlight = false;
+    if (!this.running || generation !== this.generation) return;
+    if (outcome === "direct") {
+      this.stop();
+      return;
+    }
+    if (outcome !== "skipped") this.failureCount++;
+    this.schedule();
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ASSISTANT_ACCOUNT_SLOT,
@@ -4234,9 +4335,13 @@ function isProviderQuestionBinding(value) {
   QUOTA_SUPPORTED_PROVIDERS,
   RECENT_SESSION_BUCKETS,
   RECLAIMING_SEND_REFUSALS,
+  RELAY_REPROBE_BASE_DELAY_MS,
+  RELAY_REPROBE_JITTER_RATIO,
+  RELAY_REPROBE_MAX_DELAY_MS,
   RELEASE_CHANNELS,
   REMOVED_MESH_TOOLS,
   RETIRED_MESH_TOOLS,
+  RelayReprobeScheduler,
   SEND_POLICY_MODES,
   SEND_REFUSAL_REASONS,
   SERVER_STATUS_EVENT_NAMES,
@@ -4286,6 +4391,7 @@ function isProviderQuestionBinding(value) {
   classifySessionStatus,
   compareDashboardWireVersion,
   compareSemver,
+  computeRelayReprobeDelay,
   daemonIdsEquivalent,
   decodeActiveWorkQueryRequest,
   decodeActiveWorkQueryResponse,