@adhdev/mesh-shared 1.0.82-rc.2 → 1.0.82-rc.21

package/dist/index.mjs

@@ -300,6 +300,50 @@ function defaultProviderPriorityFromNodeFacts(facts) {
   return orderProvidersByBuiltinPreference(detected.length ? detected : enabled);
 }
 
+// src/quota-freshness.ts
+var QUOTA_RETRY_INFLIGHT_GRACE_MS = 6e4;
+var QUOTA_BACKFILL_HORIZON_MS = 60 * 60 * 1e3;
+function hasUsableWindow(window) {
+  return !!window && typeof window.usedPercent === "number" && Number.isFinite(window.usedPercent);
+}
+function hasReading(quota) {
+  if (hasUsableWindow(quota.session) || hasUsableWindow(quota.weekly) || hasUsableWindow(quota.monthly)) return true;
+  return Array.isArray(quota.buckets) && quota.buckets.some((b) => !!b && typeof b.usedPercent === "number" && Number.isFinite(b.usedPercent));
+}
+function finiteMs(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
+}
+function backfillCheckAt(quota, now) {
+  const dataDue = finiteMs(quota.updatedAt);
+  const attempted = finiteMs(quota.metadata?.fetchedAt);
+  const dueAt = Math.max(
+    dataDue === void 0 ? Number.NEGATIVE_INFINITY : dataDue + QUOTA_BACKFILL_HORIZON_MS,
+    attempted === void 0 ? Number.NEGATIVE_INFINITY : attempted + QUOTA_BACKFILL_HORIZON_MS
+  );
+  return Number.isFinite(dueAt) && dueAt > now ? dueAt : void 0;
+}
+function assessQuotaFreshness(quota, now = Date.now()) {
+  const meta = quota.metadata;
+  const kind = meta?.failureKind;
+  const userMustAct = kind === "no-data" && quota.provider !== "codex-cli" || kind === "expired-token" && ["grok-cli", "kimi", "antigravity-cli"].includes(quota.provider);
+  if (userMustAct) return hasReading(quota) ? { cue: "stale", userMustAct: true } : { userMustAct: true };
+  if (meta?.lastGoodWindows !== true) {
+    const measuredAt = finiteMs(quota.updatedAt);
+    if (hasReading(quota) && (measuredAt === void 0 || now - measuredAt >= QUOTA_BACKFILL_HORIZON_MS)) {
+      return { cue: "stale", userMustAct };
+    }
+    return { userMustAct };
+  }
+  const retryAtMs = finiteMs(meta?.retryAtMs);
+  const retryStopped = meta?.retryExhausted === true || retryAtMs !== void 0 && retryAtMs + QUOTA_RETRY_INFLIGHT_GRACE_MS < now;
+  if (kind !== "no-data" && !retryStopped) return { cue: "refreshing", userMustAct: false };
+  const nextCheckAt = backfillCheckAt(quota, now);
+  return nextCheckAt === void 0 ? { cue: "stale", userMustAct: false } : { cue: "stale", userMustAct: false, nextCheckAt };
+}
+function minutesUntilQuotaCheck(nextCheckAt, now = Date.now()) {
+  return Math.max(1, Math.round((nextCheckAt - now) / 6e4));
+}
+
 // src/workspace-normalize.ts
 function normalizeMeshWorkspaceForCompare(dir) {
   if (typeof dir !== "string") return "";
@@ -691,6 +735,7 @@ var CANONICAL_MESH_TOOL_NAMES = [
   "mesh_list_pending_approvals",
   "mesh_create",
   "mesh_add_node",
+  "mesh_attach_remote",
   "mesh_clone_node",
   "mesh_remove_node",
   "mesh_cleanup_worktree_nodes",
@@ -1400,6 +1445,7 @@ var MESH_THINKING_LEVELS = ["low", "medium", "high"];
 var MESH_DELIVERY_MODES = ["when_idle", "interrupt"];
 var MESH_SESSION_CLEANUP_MODES = ["preserve", "stop", "delete_stopped", "stop_and_delete"];
 var WORKER_REPORT_OUTCOMES = ["completed", "blocked", "failed"];
+var WORKER_REPORT_SUMMARY_MAX_CHARS = 8e3;
 var WORKER_BRANCH_STATES = [
   "merged_to_main",
   "pushed_feature_branch_needs_merge",
@@ -1667,15 +1713,21 @@ function renderCoordinatorWorkerSection() {
 // src/assistant-protocol.ts
 var ASSISTANT_TOOLS = [
   "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"
+  "project_note",
+  "launch_defaults",
+  "launch_defaults_set"
 ];
 var ASSISTANT_TOOL_SET = new Set(ASSISTANT_TOOLS);
 function isAssistantTool(value) {
@@ -1684,40 +1736,59 @@ function isAssistantTool(value) {
 var ASSISTANT_VERB = {
   // tool verbs
   projects: "assistant_projects",
+  environment: "assistant_environment",
+  action: "assistant_action",
+  watch: "assistant_project_watch",
+  executionState: "assistant_execution_state",
+  executionSettings: "assistant_execution_settings",
   projectStatus: "assistant_project_status",
   projectSend: "assistant_project_send",
   projectRead: "assistant_project_read",
   projectAdd: "assistant_project_add",
+  projectAttachRemote: "assistant_project_attach_remote",
   discoverRepos: "assistant_discover_repos",
   memory: "assistant_memory",
   skillView: "assistant_skill_view",
   skillManage: "assistant_skill_manage",
   projectNote: "assistant_project_note",
+  launchDefaults: "assistant_launch_defaults",
+  launchDefaultsSet: "assistant_launch_defaults_set",
   // 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"
+  importSkills: "assistant_import_skills",
+  /** Projects the assistant is following (open relay threads) — list / stop following. */
+  threads: "assistant_threads",
+  threadClose: "assistant_thread_close"
 };
 var ASSISTANT_TOOL_VERBS = {
   projects: ASSISTANT_VERB.projects,
+  environment: ASSISTANT_VERB.environment,
+  assistant_action: ASSISTANT_VERB.action,
+  project_watch: ASSISTANT_VERB.watch,
   project_status: ASSISTANT_VERB.projectStatus,
   project_send: ASSISTANT_VERB.projectSend,
   project_read: ASSISTANT_VERB.projectRead,
   project_add: ASSISTANT_VERB.projectAdd,
+  project_attach_remote: ASSISTANT_VERB.projectAttachRemote,
   discover_repos: ASSISTANT_VERB.discoverRepos,
   memory: ASSISTANT_VERB.memory,
   skill_view: ASSISTANT_VERB.skillView,
   skill_manage: ASSISTANT_VERB.skillManage,
-  project_note: ASSISTANT_VERB.projectNote
+  project_note: ASSISTANT_VERB.projectNote,
+  launch_defaults: ASSISTANT_VERB.launchDefaults,
+  launch_defaults_set: ASSISTANT_VERB.launchDefaultsSet
 };
-var ASSISTANT_WRITE_TOOLS = ["memory", "skill_manage", "project_note", "project_send", "project_add"];
+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 = [
+  ASSISTANT_VERB.executionSettings,
   ASSISTANT_VERB.stagedResolve,
   ASSISTANT_VERB.storeAdmin,
-  ASSISTANT_VERB.importSkills
+  ASSISTANT_VERB.importSkills,
+  ASSISTANT_VERB.threadClose
 ];
 var ASSISTANT_REVIEW_TURN_VERBS = [
   ASSISTANT_VERB.memory,
@@ -1772,8 +1843,8 @@ function sanitizeRefusalCode(value) {
 var CONSUME_PROFILES = ["default", "native_source"];
 var SESSION_REBOUND_REASONS = ["restart", "live_holder"];
 var SUSPENSION_MODALS = ["approval", "choice"];
-var SUSPENSION_RESOLUTIONS = ["approved", "rejected", "answered"];
-var SUSPENSION_RESOLUTION_VIAS = ["modal_button", "auto_approve", "prompt_answer"];
+var SUSPENSION_RESOLUTIONS = ["approved", "rejected", "answered", "dismissed"];
+var SUSPENSION_RESOLUTION_VIAS = ["modal_button", "auto_approve", "prompt_answer", "modal_disappeared"];
 var TURN_END_STRENGTHS = ["genuine", "weak"];
 var TURN_END_BLOCK_REASONS = [
   "missing_final_assistant",
@@ -1781,9 +1852,9 @@ var TURN_END_BLOCK_REASONS = [
   "terminal_block_hard_cap",
   "decoupled_completion"
 ];
-var NATIVE_TURN_OUTCOMES = ["completed", "aborted"];
+var NATIVE_TURN_OUTCOMES = ["completed", "aborted", "failed"];
 var LIVENESS_RESULTS = ["alive", "unknown", "read_failed", "dead"];
-var PROVIDER_FAILURES = ["auth_failed", "billing_failed"];
+var PROVIDER_FAILURES = ["auth_failed", "billing_failed", "usage_limit_exceeded", "server_overloaded", "provider_error"];
 var SESSION_ERROR_REASONS = ["provider_error", "adapter_error", "spawn_failed", "auth_failed", "billing_failed", "unknown", "daemon_restart"];
 var CANCEL_REASONS = ["operator_cancel", "intentional_cleanup", "task_removed", "mission_abandoned", "superseded"];
 var OPERATOR_STATUSES = ["completed", "failed"];
@@ -1810,7 +1881,8 @@ var HOLD_REASONS = [
   // — a turn_end commits the report (R9t), expiry commits it anyway (R13t) so
   // a session whose FSM never shows the idle edge again does not wait for
   // liveness / hard_ceiling.
-  "await_end"
+  "await_end",
+  "report_correction"
 ];
 var TURN_OUTCOMES = ["completed", "failed", "cancelled"];
 var COMMIT_STRENGTHS = ["genuine", "weak", "tool_report", "operator"];
@@ -1821,9 +1893,15 @@ var TURN_REASONS = [
   "transcript_final",
   "worker_reported",
   "finalization_timeout_no_response",
+  "weak_end_liveness_unconfirmed",
+  "weak_end_probe_unobserved",
+  "report_correction_expired",
   "session_error",
   "provider_auth_failed",
   "provider_billing_failed",
+  "provider_usage_limit_exceeded",
+  "provider_server_overloaded",
+  "provider_error",
   "operator_cancel",
   "intentional_cleanup",
   "task_removed",
@@ -1900,8 +1978,8 @@ var TURN_EVIDENCE_FIELD_SPECS = {
   duplicate_dispatch_refusal: { holderSessionId: id, holderAttemptId: idOpt },
   session_rebound: { toSessionId: id, reason: en(SESSION_REBOUND_REASONS) },
   turn_started: { retro: bool },
-  suspension: { modal: en(SUSPENSION_MODALS), modalKey: idOpt },
-  suspension_resolved: { resolution: en(SUSPENSION_RESOLUTIONS), via: en(SUSPENSION_RESOLUTION_VIAS) },
+  suspension: { modal: en(SUSPENSION_MODALS), modalKey: idOpt, providerSetup: boolOpt, clockUnknown: boolOpt },
+  suspension_resolved: { resolution: en(SUSPENSION_RESOLUTIONS), via: en(SUSPENSION_RESOLUTION_VIAS), modalKey: idOpt },
   turn_end: {
     strength: en(TURN_END_STRENGTHS),
     afterFinalizationTimeout: boolOpt,
@@ -1911,6 +1989,7 @@ var TURN_EVIDENCE_FIELD_SPECS = {
     releasedByHardCap: boolOpt,
     nativeOutcome: enOpt(NATIVE_TURN_OUTCOMES),
     live: { t: "live", optional: true },
+    nativeMarker: { t: "native_marker", optional: true },
     reportExpected: boolOpt,
     providerFailure: enOpt(PROVIDER_FAILURES)
   },
@@ -1924,7 +2003,7 @@ var TURN_EVIDENCE_FIELD_SPECS = {
   },
   transcript_activity: { newestActivityAt: ms },
   no_progress: { stalledMs: ms, observedStatus: en(NO_PROGRESS_OBSERVED_STATUSES), finalAssistantPresent: bool },
-  liveness: { result: en(LIVENESS_RESULTS) },
+  liveness: { result: en(LIVENESS_RESULTS), probeStartedAtMs: msOpt },
   process_exit: { exitCode: { t: "int", nullable: true }, providerFailure: enOpt(PROVIDER_FAILURES) },
   session_error: { reason: en(SESSION_ERROR_REASONS) },
   worker_report: {
@@ -1934,6 +2013,7 @@ var TURN_EVIDENCE_FIELD_SPECS = {
     branchState: enOpt(WORKER_BRANCH_STATES),
     touchedFileCount: intOpt
   },
+  worker_report_correction_requested: { deliveryId: { t: "id", optional: true } },
   worker_progress: { note: { t: "summary_ref", optional: true } },
   git_side_effect: { dirty: bool, commitsSinceDispatch: { t: "int" }, attributable: bool },
   cancel: { reason: en(CANCEL_REASONS) },
@@ -1981,7 +2061,7 @@ function isLiveTurnPending(value) {
   return isRecord2(value) && hasOnlyKeys(value, ["modal", "adapterPending", "trailingTool", "newestActivityAt"]) && typeof value.modal === "boolean" && typeof value.adapterPending === "boolean" && typeof value.trailingTool === "boolean" && (value.newestActivityAt === void 0 || isFiniteNumber2(value.newestActivityAt));
 }
 function isNativeMarkerRef(value) {
-  return isRecord2(value) && hasOnlyKeys(value, ["outcome", "turnId"]) && NATIVE_TURN_OUTCOMES.includes(value.outcome) && (value.turnId === void 0 || isEvidenceIdentifier(value.turnId));
+  return isRecord2(value) && hasOnlyKeys(value, ["outcome", "turnId", "receivedAt", "startedAt", "errorAt"]) && NATIVE_TURN_OUTCOMES.includes(value.outcome) && (value.turnId === void 0 || isEvidenceIdentifier(value.turnId)) && ["receivedAt", "startedAt", "errorAt"].every((key) => value[key] === void 0 || isFiniteNumber2(value[key]));
 }
 function isCoordinatorIdentity(value) {
   return isRecord2(value) && hasOnlyKeys(value, ["daemonId", "coordinatorRunId", "sessionId"]) && isEvidenceIdentifier(value.daemonId) && isEvidenceIdentifier(value.coordinatorRunId) && (value.sessionId === void 0 || isEvidenceIdentifier(value.sessionId));
@@ -3050,14 +3130,11 @@ function normalizeOwnedPaths(input) {
 }
 function entryContains(base, path) {
   if (path === base.path) return true;
-  if (base.subtree && (path === base.path || path.startsWith(`${base.path}/`))) return true;
+  if (base.subtree && (base.path === "" || path.startsWith(`${base.path}/`))) return true;
   return false;
 }
 function entriesOverlap(a, b) {
-  if (a.path === b.path) return true;
-  if (a.subtree && (b.path === a.path || b.path.startsWith(`${a.path}/`))) return true;
-  if (b.subtree && (a.path === b.path || a.path.startsWith(`${b.path}/`))) return true;
-  return false;
+  return entryContains(a, b.path) || entryContains(b, a.path);
 }
 function pathsOverlap(a, b) {
   if (a.paths.length === 0 || b.paths.length === 0) return false;
@@ -3329,7 +3406,15 @@ function foldKeyedDoc(held, delta, spec) {
     const heldList = heldCollections.get(path);
     if (change?.absent) {
       const [head2, tail2] = splitPath(path);
-      if (!tail2) delete next[head2];
+      if (!tail2) {
+        delete next[head2];
+        continue;
+      }
+      const parent2 = next[head2];
+      if (!isRecord3(parent2) || !(tail2 in parent2)) continue;
+      const copy = { ...parent2 };
+      delete copy[tail2];
+      next[head2] = copy;
       continue;
     }
     if (!change && heldList === void 0) continue;
@@ -3393,6 +3478,105 @@ function stableMeshNodeRow(row) {
   }
   return out;
 }
+
+// src/provider-approval.ts
+function isActionableProviderApproval(approval) {
+  return !!approval && approval.source === "provider_modal" && approval.type === "tool_permission" && approval.lifecycle === "pending" && approval.evidence === "live" && approval.actionable && !!approval.modalKey && Array.isArray(approval.buttons) && approval.buttons.some((button) => typeof button === "string" && !!button.trim());
+}
+function readProviderDecision(approval, waiting, hasModal = false) {
+  if (approval !== void 0) return approval && ["provider_modal", "legacy_provider", "status_only", "ledger_approval"].includes(approval.source) ? approval : null;
+  if (!waiting) return null;
+  return {
+    source: hasModal ? "legacy_provider" : "status_only",
+    type: "unknown",
+    compatibility: hasModal ? "session_only" : "unknown",
+    evidence: "unavailable",
+    lifecycle: "pending",
+    modalKey: null,
+    createdAt: null,
+    resolvedAt: null,
+    description: "",
+    buttons: [],
+    actionable: false
+  };
+}
+function providerApprovalSnapshot(approval) {
+  if (!approval) return null;
+  const {
+    source,
+    type,
+    lifecycle,
+    modalKey,
+    createdAt,
+    resolvedAt,
+    providerType,
+    sessionId,
+    nodeId,
+    meshId,
+    taskId,
+    attemptId,
+    generation
+  } = approval;
+  return {
+    source,
+    type,
+    lifecycle,
+    modalKey,
+    createdAt,
+    resolvedAt,
+    providerType,
+    sessionId,
+    nodeId,
+    meshId,
+    taskId,
+    attemptId,
+    generation,
+    evidence: "cached",
+    actionable: false,
+    description: "",
+    buttons: []
+  };
+}
+
+// src/provider-question.ts
+function isProviderQuestionBinding(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const b = value;
+  if (b.transport !== "codex_rpc" && b.transport !== "codex_async") return false;
+  const keys = ["transport", "sessionId", "generation", "threadId", "turnId", "itemId", ...b.transport === "codex_rpc" ? ["requestId"] : []];
+  if (Reflect.ownKeys(b).some((key) => typeof key !== "string" || !keys.includes(key))) return false;
+  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/launch-defaults.ts
+var LAUNCH_DEFAULT_ROLES = ["assistant", "coordinator"];
+var LAUNCH_DEFAULT_SOURCES = ["user", "stored_default", "project_default", "provider_default"];
+var LAUNCH_DEFAULTS_NEXT_LAUNCH_NOTE = "Applies to the next launch; running sessions are unchanged.";
+function isLaunchDefaultRole(value) {
+  return typeof value === "string" && LAUNCH_DEFAULT_ROLES.includes(value);
+}
+function isLaunchDefaultSource(value) {
+  return typeof value === "string" && LAUNCH_DEFAULT_SOURCES.includes(value);
+}
+var LAUNCH_DEFAULT_ERROR_CODES = [
+  "invalid_args",
+  "launch_default_required",
+  "launch_default_unavailable",
+  "launch_selection_invalid",
+  "launch_default_invalid",
+  "revision_conflict",
+  "store_unavailable",
+  "store_busy",
+  "persistence_failed",
+  "project_not_found",
+  "project_ambiguous",
+  "project_not_hosted",
+  "project_storage_unavailable",
+  "staging_unavailable",
+  "staging_failed",
+  "review_turn_tool_denied"
+];
 export {
   ASSISTANT_OWNER_VERBS,
   ASSISTANT_REVIEW_TURN_VERBS,
@@ -3431,6 +3615,10 @@ export {
   EVIDENCE_ENVELOPE_FIELD_SPECS,
   EVIDENCE_SOURCE_IDS,
   HOLD_REASONS,
+  LAUNCH_DEFAULTS_NEXT_LAUNCH_NOTE,
+  LAUNCH_DEFAULT_ERROR_CODES,
+  LAUNCH_DEFAULT_ROLES,
+  LAUNCH_DEFAULT_SOURCES,
   LIVENESS_RESULTS,
   MAX_MESH_RECORD_STRING,
   MAX_OWNED_PATHS,
@@ -3471,6 +3659,8 @@ export {
   OUTBOUND_MESSAGE_ORIGINS,
   P2P_SIGNAL_TYPES,
   PROVIDER_FAILURES,
+  QUOTA_BACKFILL_HORIZON_MS,
+  QUOTA_RETRY_INFLIGHT_GRACE_MS,
   QUOTA_SUPPORTED_PROVIDERS,
   RECENT_SESSION_BUCKETS,
   RECLAIMING_SEND_REFUSALS,
@@ -3516,9 +3706,11 @@ export {
   WORKER_BRANCH_STATES,
   WORKER_PROTOCOL_FOOTER_MARKER,
   WORKER_REPORT_OUTCOMES,
+  WORKER_REPORT_SUMMARY_MAX_CHARS,
   WORKER_TOOLS,
   appendWorkerProtocolFooter,
   argsCarryStatusProbeMarker,
+  assessQuotaFreshness,
   buildSlotProposal,
   canonicalDaemonId,
   classifySessionStatus,
@@ -3599,6 +3791,7 @@ export {
   hasGitStatusEvidence,
   hasWorkerProtocolFooter,
   interpolateString,
+  isActionableProviderApproval,
   isAssistantTool,
   isBlockedStatus,
   isBusyStatus,
@@ -3620,6 +3813,8 @@ export {
   isFiniteNumber,
   isIdleSessionState,
   isInputEnvelopeWire,
+  isLaunchDefaultRole,
+  isLaunchDefaultSource,
   isMeshDeliveryMode,
   isMeshIndexQueryResponse,
   isMeshMissionStatusValue,
@@ -3634,12 +3829,14 @@ export {
   isMessageId,
   isMissionUpsertResponse,
   isModelAxisSource,
+  isNativeMarkerRef,
   isNonEmptyString,
   isNotifyKind,
   isOutboundMessage,
   isOutboundMessageOrigin,
   isP2PSignalType,
   isPhantomDaemonEntry,
+  isProviderQuestionBinding,
   isRawDaemonDoId,
   isReadyStatus,
   isRecord,
@@ -3677,6 +3874,7 @@ export {
   meshUtf8ByteLength,
   meshWorkspacesEquivalent,
   mintMessageId,
+  minutesUntilQuotaCheck,
   normalizeAuthOkLimits,
   normalizeBrainSlot,
   normalizeDifficultyBrainMap,
@@ -3699,11 +3897,13 @@ export {
   pickBestTransitGitStatus,
   projectFileDiffRow,
   projectTurnEvidenceEntry,
+  providerApprovalSnapshot,
   readBoolean,
   readEnvelopeFields,
   readGitSubmodules,
   readNumber,
   readOptionalRecord,
+  readProviderDecision,
   readRecord,
   readString,
   readStringArray,