dsh-advisor-group 0.1.3 → 0.1.5

package/lib/index.d.mts

@@ -144,16 +144,86 @@ interface QuotaConfig {
   /** Max new consultations per UTC day when enabled (1–100000), default 50. */
   maxPerDay: number;
 }
+interface SwarmConfig {
+  /** Master switch for the cross-session tools (ask_session / list_sessions / ask_result). */
+  enabled: boolean;
+  /** Default response mode when the caller omits both `waitMs` and `detach`. */
+  defaultMode: 'wait' | 'detach';
+  /** Default wait ceiling in milliseconds when the caller omits `waitMs` (1–10 min). */
+  defaultWaitMs: number;
+  /** How long detached ask results are kept on disk, in hours (clamped to 1–720). */
+  resultTtlHours: number;
+  /**
+   * Copy a settled answer back into the asking session automatically
+   * (`state: done` only; timeout/error are never delivered back). On by
+   * default; off leaves results readable only through `ask_result`.
+   */
+  deliverBack?: boolean;
+  /** Whether the session roster lists subagent sessions. */
+  rosterIncludeSubagents: boolean;
+  /**
+   * Route an unnamed question to candidate sessions instead of guessing or
+   * sending it blind (pure keyword layer, no model call). Schema default is on.
+   */
+  routingEnabled?: boolean;
+  /** How many routing candidates to return (1–8, default 3). */
+  routingTopN?: number;
+  /**
+   * Which engine orders the routing candidates (2026-10-19): 'local' (default)
+   * uses the keyword scorer alone; 'jev' still recalls with the local scorer —
+   * it is the recall step and the safety net — and lets Jev re-rank that closed
+   * list. Jev reuses the `trigger.jev` credentials/endpoint config; when it is
+   * not configured, or on any failure, the local order is returned unchanged.
+   */
+  routingEngine?: 'local' | 'jev';
+  /**
+   * Whether a user turn should ask the cross-session engine for a suggestion
+   * (2026-10-19). 'off' never calls Jev; 'gated' (default) asks only when the
+   * pure prefilter thinks the turn points at another session/task; 'always'
+   * asks on every turn (one batched Jev call per turn). Any answer is a hint
+   * only: nothing is delivered and the model decides.
+   */
+  routingAsk?: 'off' | 'gated' | 'always';
+  /**
+   * Sessions excluded from the whole swarm (2026-10-19): an entry matches a
+   * session when it equals its session id (case-insensitive) or is a
+   * case-insensitive substring of its title / fallback display name. Excluded
+   * sessions never appear in the roster or routing candidates, routing aliases
+   * pointing at them are dropped, and an explicit ask_session target that
+   * resolves to one is refused with `swarm-excluded`.
+   */
+  routingExclude?: string[];
+}
 interface Config {
   enabled: boolean;
   discussion: DiscussionConfig;
   trigger: TriggerConfig;
   ui: UiConfig;
   quota: QuotaConfig;
+  swarm: SwarmConfig;
   advisors: AdvisorConfig[];
 }
 declare const Config: Schema<Config>;
 //#endregion
+//#region src/session-roster.d.ts
+/** The minimal session shape this module reads (structurally compatible with the host row). */
+interface RosterSource {
+  sessionId: string;
+  updatedAt: number;
+  running: boolean;
+  cwd?: string;
+  origin?: 'subagent';
+  /** The host marks a freshly created, never-used session as blank. */
+  blank?: boolean;
+  /** Byte size of the session's own log, when the caller already looked it up. */
+  sizeBytes?: number;
+  projections?: {
+    values?: {
+      title?: unknown;
+    };
+  };
+}
+//#endregion
 //#region src/types.d.ts
 interface DriverSource {
   provider: string;
@@ -236,6 +306,15 @@ interface ConsultSummary {
   stopped?: boolean;
 }
 //#endregion
+//#region src/session-router.d.ts
+/** One routed session: a choice handed to the user, never an auto-pick. */
+interface RouteCandidate {
+  sessionId: string;
+  name: string;
+  score: number;
+  reason: string;
+}
+//#endregion
 //#region src/events.d.ts
 declare module '@deepseek-ai/cordis' {
   interface Events {
@@ -267,6 +346,22 @@ declare module '@deepseek-ai/cordis' {
 //#region src/index.d.ts
 declare const name = "dsh-advisor-group";
 declare const inject: string[];
+/**
+ * Recall candidates for the background hint, restricted to the sessions the
+ * host actually shows: the registered set (workspace `sessionIds` minus
+ * archived). `registered === undefined` means "this host has no workspace
+ * registry" and filters nothing; a session no workspace registers must never be
+ * suggested by a hint. Pure except for the bounded log-size probe inside the
+ * router.
+ */
+declare function recallHintCandidates(input: {
+  sessions: readonly RosterSource[];
+  registered?: ReadonlySet<string>;
+  text: string;
+  topN?: number;
+  currentSessionId: string;
+  exclude?: readonly string[];
+}): RouteCandidate[];
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { Config, apply, inject, name };
+export { Config, apply, inject, name, recallHintCandidates };