@adhdev/mesh-shared 1.0.82-rc.4 → 1.0.82-rc.41

package/dist/assistant-protocol.d.ts

@@ -11,30 +11,58 @@
  *   - 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.
+ * 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", "project_status", "project_send", "project_read", "project_add", "discover_repos", "memory", "skill_view", "skill_manage", "project_note"];
+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", "memory_search", "skill_view", "skill_manage", "project_note", "launch_defaults", "launch_defaults_set", "driver_list", "driver_describe", "artifact_list", "artifact_read", "decision_answer", "decision_request", "session_control"];
 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 driverList: "driver_list";
+    readonly driverDescribe: "driver_describe";
     readonly projects: "assistant_projects";
+    readonly environment: "assistant_environment";
+    readonly action: "assistant_action";
+    readonly watch: "assistant_project_watch";
+    readonly executionState: "assistant_execution_state";
+    readonly executionSettings: "assistant_execution_settings";
     readonly projectStatus: "assistant_project_status";
     readonly projectSend: "assistant_project_send";
     readonly projectRead: "assistant_project_read";
     readonly projectAdd: "assistant_project_add";
+    readonly projectAttachRemote: "assistant_project_attach_remote";
     readonly discoverRepos: "assistant_discover_repos";
     readonly memory: "assistant_memory";
+    /** Pull-only FTS search over the archive tier (memory design 2026-11-01 §3.4). */
+    readonly memorySearch: "assistant_memory_search";
     readonly skillView: "assistant_skill_view";
     readonly skillManage: "assistant_skill_manage";
     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";
+    /** Owner-decision inbox (structured-missions design 2026-10-28 §6.3): the owner's words recorded as answers. */
+    readonly decisionAnswer: "assistant_decision_answer";
+    /** Register a plain-text question a coordinator put to the owner as a decision item (§5.2). */
+    readonly decisionRequest: "assistant_decision_request";
+    /** Stop / restart / switch the provider of a coordinator, worker or the assistant session (handoff design 2026-11-01 §4). */
+    readonly sessionControl: "assistant_session_control";
     readonly launch: "launch_assistant";
     readonly pendingRelays: "assistant_pending_relays";
     readonly stagedResolve: "assistant_staged_resolve";
     readonly storeAdmin: "assistant_store_admin";
     readonly importSkills: "assistant_import_skills";
+    /** Owner skill list (attach/view counts, save proposals, recent skill metrics); reads move no counter. */
+    readonly skillsList: "assistant_skills_list";
+    /** Owner: what the assistant remembered recently, with undo handles (memory design §3.2). */
+    readonly memoryDigest: "assistant_memory_digest";
+    /** Owner: reverse one remembered write or one batch (memory design §3.2). Never an assistant tool. */
+    readonly memoryUndo: "assistant_memory_undo";
+    /** Projects the assistant is following (open relay threads) — list / stop following. */
+    readonly threads: "assistant_threads";
+    readonly threadClose: "assistant_thread_close";
 };
 export type AssistantVerb = typeof ASSISTANT_VERB[keyof typeof ASSISTANT_VERB];
 /** The daemon verb each assistant tool calls. */
@@ -50,11 +78,138 @@ export declare const ASSISTANT_WRITE_TOOLS: readonly AssistantTool[];
 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
+/** 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";
+/**
+ * Conceptual single-assistant slot in the verified account namespace.
+ * Fixed to `'personal'` — one logical assistant per account with one
+ * owner-selected active execution daemon binding per project ACL.
+ */
+export declare const ASSISTANT_ACCOUNT_SLOT: "personal";
+export type AssistantAccountSlot = typeof ASSISTANT_ACCOUNT_SLOT;
+/**
+ * Daemon commands for remote project discovery, host ACL grant/revoke, and
+ * assistant-side follow/unfollow. Registered outside `ASSISTANT_VERB` so the
+ * assistant MCP server tool/verb parity table remains untouched.
+ */
+export declare const ASSISTANT_REMOTE_PROJECT_COMMAND: "assistant_remote_project";
+export declare const ASSISTANT_REMOTE_PROJECT_CATALOG_COMMAND: "assistant_remote_project_catalog";
+export declare const ASSISTANT_REMOTE_PROJECT_ACCESS_COMMAND: "assistant_remote_project_access";
+export declare const ASSISTANT_REMOTE_FOLLOW_COMMAND: "assistant_remote_follow";
+/**
+ * Narrow operations a non-roster follower deputy is permitted to invoke on
+ * `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", "artifact_list", "artifact_read", "decision_list", "decision_answer", "decision_request"];
+export type AssistantFollowerAllowedOp = typeof ASSISTANT_FOLLOWER_ALLOWED_OPS[number];
+export declare function isAssistantFollowerAllowedOp(value: unknown): value is AssistantFollowerAllowedOp;
+export declare function followerOpPermitted(op: string, allowedOps: readonly AssistantFollowerAllowedOp[]): boolean;
+/**
+ * Host-authoritative narrow project ACL persisted on the hosting daemon's
+ * `LocalMeshEntry` in `meshes.json`. Revocation increments `grantRevision`
+ * and retains a `'revoked'` tombstone so stale follower caches cannot replay.
+ */
+export interface AssistantRemoteAccessBinding {
+    hostDaemonId: string;
+    meshId: string;
+    accountSlot: AssistantAccountSlot;
+    activeDaemonId: string;
+    bindingRevision: number;
+    grantRevision: number;
+    status: 'active' | 'revoked';
+    allowedOps: readonly AssistantFollowerAllowedOp[];
+    allowCoordinatorLaunch?: boolean;
+    allowArtifactRead?: boolean;
+    grantedAt: number;
+    revokedAt?: number;
+}
+/**
+ * Durable owner-binding receipt persisted in the assistant daemon's
+ * `assistant.json`. Survives ordinary daemon restarts and session/provider
+ * replacements (`bindSession`), while missing/corrupt/mismatched receipts
+ * fail closed until owner reconciliation.
+ */
+export interface AssistantOwnerBindingReceipt {
+    accountSlot: AssistantAccountSlot;
+    daemonId: string;
+    bindingRevision: number;
+    boundAt: number | string;
+}
+export type FollowedRemoteProjectState = 'followed' | 'unfollowed' | 'revoked';
+export type RemoteAccessState = 'not_granted' | 'granted_unfollowed' | 'followed' | 'revoked' | 'host_unreachable' | 'binding_mismatch';
+/**
+ * Assistant-local followed remote project reference persisted in `assistant.json`.
+ * Never injected into `meshes.json`, `mesh-host-records.json`, `mesh-node-state-push.json`,
+ * or `inlineMeshCache`.
+ */
+export interface FollowedRemoteProjectEntry {
+    /** Canonical key: `${canonicalDaemonId(hostDaemonId)}::${meshId}` */
+    key: string;
+    hostDaemonId: string;
+    hostLabel?: string;
+    meshId: string;
+    name: string;
+    slug: string;
+    sanitizedRepoIdentity: string | null;
+    repoIdentity?: string;
+    accountSlot: AssistantAccountSlot;
+    bindingRevision: number;
+    grantRevision: number;
+    allowCoordinatorLaunch?: boolean;
+    allowArtifactRead?: boolean;
+    state: FollowedRemoteProjectState;
+    followedAt: number | string;
+    updatedAt: number | string;
+    unfollowedAt?: number | string;
+    revokedAt?: number | string;
+    revokedReason?: string;
+    lastCursor?: string | null;
+    coordinatorSessionId?: string | null;
+    lastErrorCode?: string;
+    lastObserved?: {
+        observedAt: number | string;
+        coordinatorState?: string;
+        coordinatorMissing?: boolean;
+        coordinatorPresent?: boolean;
+        lastHeadline?: string;
+        summary?: string;
+    };
+}
+/**
+ * Content-free canonical catalog metadata returned by `assistant_remote_project_catalog`
+ * for meshes actually hosted on the queried remote daemon.
+ */
+export interface RemoteProjectCatalogItem {
+    hostDaemonId: string;
+    meshId: string;
+    name: string;
+    sanitizedRepoIdentity: string | null;
+    coordinatorState?: 'none' | 'idle' | 'working' | 'waiting' | string;
+    allowCoordinatorLaunch?: boolean;
+    allowArtifactRead?: boolean;
+    capabilities: {
+        status: true;
+        read: true;
+        poll: true;
+        report: true;
+        send: true;
+        coordinatorPresent?: boolean;
+        allowCoordinatorLaunch?: boolean;
+        allowArtifactRead?: boolean;
+    };
+    observedAt: number | string;
+}
+/** Build the canonical `(hostDaemonId, meshId)` key used across assistant follow state. */
+export declare function followedRemoteProjectKey(hostDaemonId: string, meshId: string): string;
+/**
+ * Sanitize a repository identity or remote URL into a content-free `host/path`
+ * identifier suitable for remote discovery catalogs. Strips credentials, query
+ * strings, fragments, and `.git` suffixes, and rejects local filesystem paths.
+ */
+export declare function sanitizeRemoteRepoIdentity(raw: string | null | undefined): string | null;

package/dist/decision-push-relay.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Opt-in "answer a decision from the push notification" relay (mission 4ae3edf2, owner 2026-10-29).
+ *
+ * ★ A deliberate, narrow exception to "no dashboard command relay over server WS" (CLAUDE.md).
+ * With the user's opt-in setting ON and no dashboard window open, the notification's
+ * recommended-option action is POSTed by the service worker to the server, which forwards it to the
+ * owning daemon over the existing daemon WS as ONE fixed command. What crosses the server is exactly
+ * `{ meshId, itemId, optionId }` (+ the single-use answer token that authorizes it) — never the
+ * question, context or free text. Shared so the server's frame and the daemon's ingress cannot drift.
+ */
+/** Daemon command the server sends; its only accepted source is {@link DECISION_PUSH_RELAY_SOURCE}. */
+export declare const DECISION_PUSH_RELAY_COMMAND = "mission_decision_push_relay_answer";
+/** Command source the server stamps on the relayed frame (never settable by REST/API callers). */
+export declare const DECISION_PUSH_RELAY_SOURCE = "push_relay";
+/** The complete relayed payload — ids only. */
+export type DecisionPushRelayPayload = {
+    meshId: string;
+    itemId: string;
+    optionId: string;
+};

package/dist/index.d.ts

@@ -15,6 +15,7 @@ export * from './git-normalize';
 export * from './session-normalize';
 export * from './node-normalize';
 export * from './node-facts';
+export * from './quota-freshness';
 export * from './workspace-normalize';
 export * from './daemon-normalize';
 export * from './git-summarize';
@@ -39,4 +40,14 @@ export * from './session-launch';
 export * from './turn-ipc';
 export * from './path-ownership';
 export * from './mission-brief';
+export * from './mission-items';
+export * from './mission-git-state';
+export * from './release';
+export * from './decision-push-relay';
 export * from './keyed-doc-delta';
+export * from './provider-approval';
+export * from './provider-question';
+export * from './launch-defaults';
+export * from './role-launch';
+export * from './task-source-phase';
+export * from './relay-reprobe';