dsh-advisor-group 0.1.0 → 0.1.2

package/lib/index.d.mts

@@ -17,6 +17,27 @@ interface AdvisorConfig {
   apiKeyEnv?: string;
   protocol?: ProviderProtocol;
   authMode?: ProviderAuthMode;
+  /**
+   * Per-advisor thinking mode; unset = provider default. `disabled` forces
+   * every request from this advisor to run without a thinking/reasoning block
+   * (mapped to `reasoningEffort: 'off'` on the DSH built-in channel; on the
+   * direct-http channel it maps to provider-specific "no thinking" params
+   * where supported). When `enabled`, the selected `reasoningEffort` applies.
+   */
+  thinking?: 'enabled' | 'disabled';
+  /**
+   * Per-advisor thinking strength; unset = provider/model default. Standard
+   * DSH effort ids (`off` disables thinking per request). On the direct-http
+   * channel the ids are mapped to provider-specific reasoning parameters
+   * (OpenAI `reasoning_effort`, Anthropic thinking budget, Gemini
+   * `thinkingConfig`).
+   */
+  reasoningEffort?: 'off' | 'low' | 'high' | 'max';
+  /**
+   * Per-advisor tool calling scope override; unset = the global default
+   * (`discussion.advisorTools`). Only meaningful on the direct-http channel.
+   */
+  tools?: 'readonly' | 'all' | 'off';
   /**
    * Server-side per-provider direct-key history for one advisor.
    * Keys are never returned to the browser; they let a user switch back to a
@@ -69,39 +90,108 @@ interface DiscussionConfig {
    */
   stopOnConsensus: boolean;
   /**
-   * Per-advisor call timeout in milliseconds (default 120000 = 2 min).
+   * Per-advisor call timeout in milliseconds (default 600000 = 10 min).
    * Applied to both the ctx.llm and direct-http channels.
    */
   advisorTimeoutMs?: number;
+  /**
+   * Advisor tool calling scope (2026-09-05): 'readonly' (default) exposes only
+   * a read-only whitelist of the session's tools (read/grep/glob/web_search…);
+   * 'all' exposes every session-visible tool (incl. writable ones); 'off'
+   * disables tool calling. Only the direct-http OpenAI/Anthropic channel
+   * supports tool calling (ctx.llm / dsh-llm does not expose tool calling).
+   */
+  advisorTools?: 'readonly' | 'all' | 'off';
+  /**
+   * Driver (deep-question / conclusion) generation timeout in milliseconds
+   * (default 600000 = 10 min).
+   */
+  driverTimeoutMs?: number;
 }
 interface TriggerConfig {
   requireClassifier: boolean;
   allowWebFallback: boolean;
   confidenceThreshold: number;
+  jev?: JevConfig;
+}
+type JevProvider = 'typesafe' | 'openrouter';
+interface JevConfig {
+  enabled: boolean;
+  provider: JevProvider;
+  model: string;
+  baseURL?: string;
+  apiKey?: string;
+  apiKeyEnv?: string;
+  timeoutMs: number;
+  confidenceThreshold: number;
+  /** Judge with the caller-provided English gist (questionEn) as the Jev state; default keeps the Chinese question. */
+  useEnglishState?: boolean;
+  /** Threshold for the high_risk question; unset means follow confidenceThreshold. */
+  highRiskThreshold?: number;
+  apiKeyMeta?: {
+    configured: boolean;
+    last4?: string;
+  };
 }
 interface UiConfig {
   theme: 'retro-green' | 'retro-amber' | 'retro-blue';
   showTimestamps: boolean;
   autoExpand: boolean;
 }
+interface QuotaConfig {
+  /** Enable the per-UTC-day new-consultation cap (cost safety valve). */
+  enabled: boolean;
+  /** Max new consultations per UTC day when enabled (1–100000), default 50. */
+  maxPerDay: number;
+}
 interface Config {
   enabled: boolean;
   discussion: DiscussionConfig;
   trigger: TriggerConfig;
   ui: UiConfig;
+  quota: QuotaConfig;
   advisors: AdvisorConfig[];
 }
 declare const Config: Schema<Config>;
 //#endregion
 //#region src/types.d.ts
+interface DriverSource {
+  provider: string;
+  model: string;
+}
 type ChatRole = 'main' | 'advisor' | 'system';
+/** Why an advisor stream ended before producing a complete answer body. */
+interface TruncationInfo {
+  reason: 'timeout' | 'network';
+  atMs: number;
+}
+/** One tool step (agent-loop style) attached to the advisor message. */
+interface AdvisorToolStep {
+  kind: 'call' | 'result';
+  name: string;
+  text: string;
+  atMs: number;
+}
 interface ChatMessage {
   role: ChatRole;
   advisorId?: string;
   advisorName?: string;
   content: string;
   thinking?: string;
+  /** Thinking split at each tool-call boundary, in stream order — the card
+   *  renders ONE row per segment (第 N 步思考), interleaved with tool rows. */
+  thinkingSegments?: string[];
+  /**
+   * The model's TEXT blocks spoken before each tool round (the DSH block order
+   * text → reasoning → tool-call): the "我要做什么" announcement the model
+   * makes to the user. Precise source for the card's 📋 行动·N rows.
+   */
+  actionDescriptions?: string[];
   round?: number;
+  /** Tool-calling steps streamed as independent rows (not part of thinking). */
+  toolSteps?: AdvisorToolStep[];
+  /** Set when the stream was cut before a complete body (e.g. advisor timeout). */
+  truncated?: TruncationInfo;
   ts: number;
 }
 interface ConsultSession {
@@ -112,6 +202,18 @@ interface ConsultSession {
   advisors: AdvisorConfig[];
   maxRounds: number;
   messages: ChatMessage[];
+  /** Working directory of the agent session (for cross-restart recovery). */
+  cwd?: string;
+  /** The agent's DSH session id: resume rebuilds THIS session so the card
+   *  (assembled from the agent session log) keeps receiving events. */
+  dshSessionId?: string;
+  /** Driver model source captured at first run; resume reuses it because the
+   *  rebuilt session has no request/header event to read the agent model from. */
+  driverSource?: DriverSource;
+  /** Why the consultation was interrupted: 'user-stop' (explicit stop button),
+   *  'exec-cancel' (host signal), 'abort-error' (unclassified AbortError),
+   *  or an advisor-level reason mirrored from truncated (timeout/network). */
+  stopReason?: string;
   createdAt: number;
   updatedAt: number;
 }
@@ -130,6 +232,8 @@ interface ConsultSummary {
   riskNotes: string[];
   /** Driver-model synthesis appended after all auto-deepen rounds (2026-09-05). */
   conclusion?: string;
+  /** True when the consultation was stopped by the user (partial content). */
+  stopped?: boolean;
 }
 //#endregion
 //#region src/events.d.ts
@@ -154,6 +258,9 @@ declare module '@deepseek-ai/cordis' {
       sessionId: string;
       summary: ConsultSummary;
     }): void;
+    'advisor-group/resume'(payload: {
+      sessionId: string;
+    }): void;
   }
 }
 //#endregion