dsh-advisor-group 0.1.4 → 0.1.5

package/lib/index.d.mts

@@ -153,6 +153,12 @@ interface SwarmConfig {
   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;
   /**
@@ -199,6 +205,25 @@ interface Config {
 }
 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;
@@ -281,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 {
@@ -312,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 };