dsh-advisor-group 0.1.0

package/lib/index.d.mts

@@ -0,0 +1,165 @@
+import Schema from "@deepseek-ai/schemastery";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/config.d.ts
+type ProviderProtocol = 'openai' | 'anthropic' | 'gemini';
+type ProviderAuthMode = 'x-api-key' | 'bearer';
+interface AdvisorConfig {
+  id: string;
+  name: string;
+  avatar?: string;
+  provider: string;
+  model: string;
+  systemPrompt: string;
+  temperature?: number;
+  maxTokens?: number;
+  baseURL?: string;
+  apiKey?: string;
+  apiKeyEnv?: string;
+  protocol?: ProviderProtocol;
+  authMode?: ProviderAuthMode;
+  /**
+   * 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
+   * previously used provider without losing that provider's API key.
+   */
+  apiKeysByProvider?: Record<string, string>;
+  /**
+   * Client→server only: an explicit "clear the current provider's key" intent
+   * (SecretField semantics — an empty apiKey now means "keep the stored key").
+   * Stripped before persistence and never returned to the browser.
+   */
+  clearApiKey?: boolean;
+  /**
+   * Server→client only: per-provider key presence facts (no key material).
+   * Derived by `sanitizeConfig`; never persisted and never sent by the client.
+   */
+  apiKeyMetaByProvider?: Record<string, {
+    configured: boolean;
+    last4?: string;
+  }>;
+}
+interface DiscussionConfig {
+  maxRounds: number;
+  maxAdvisorsPerCall: number;
+  /**
+   * Deprecated (2026-09-05): rounds are now a sequential A → B → C relay,
+   * advisors are never invoked in parallel. Kept for stored-config
+   * compatibility only.
+   */
+  parallel: boolean;
+  /**
+   * Auto-deepen pipeline (2026-09-05): when true, the consultation runs up to
+   * `maxRounds` rounds automatically — after each round the driver model
+   * (the current agent's provider/model) asks a deeper follow-up, and a final
+   * synthesis closes the consultation.
+   */
+  autoDeepen: boolean;
+  /**
+   * Fallback driver model used when the session header cannot be read
+   * (e.g. resumed sessions without a request/header event).
+   */
+  driverModel?: {
+    provider: string;
+    model: string;
+  };
+  /**
+   * Deprecated (2026-09-05): the auto-deepen pipeline made this dormant.
+   * Kept in the schema only for stored-config compatibility;
+   * no longer rendered in the settings card.
+   */
+  stopOnConsensus: boolean;
+  /**
+   * Per-advisor call timeout in milliseconds (default 120000 = 2 min).
+   * Applied to both the ctx.llm and direct-http channels.
+   */
+  advisorTimeoutMs?: number;
+}
+interface TriggerConfig {
+  requireClassifier: boolean;
+  allowWebFallback: boolean;
+  confidenceThreshold: number;
+}
+interface UiConfig {
+  theme: 'retro-green' | 'retro-amber' | 'retro-blue';
+  showTimestamps: boolean;
+  autoExpand: boolean;
+}
+interface Config {
+  enabled: boolean;
+  discussion: DiscussionConfig;
+  trigger: TriggerConfig;
+  ui: UiConfig;
+  advisors: AdvisorConfig[];
+}
+declare const Config: Schema<Config>;
+//#endregion
+//#region src/types.d.ts
+type ChatRole = 'main' | 'advisor' | 'system';
+interface ChatMessage {
+  role: ChatRole;
+  advisorId?: string;
+  advisorName?: string;
+  content: string;
+  thinking?: string;
+  round?: number;
+  ts: number;
+}
+interface ConsultSession {
+  id: string;
+  status: 'active' | 'completed' | 'cancelled';
+  question: string;
+  context?: string;
+  advisors: AdvisorConfig[];
+  maxRounds: number;
+  messages: ChatMessage[];
+  createdAt: number;
+  updatedAt: number;
+}
+interface AdvisorSummary {
+  advisorId: string;
+  advisorName: string;
+  corePoints: string[];
+  uncertainty?: string;
+}
+interface ConsultSummary {
+  sessionId: string;
+  question: string;
+  advisors: AdvisorSummary[];
+  consensus: string[];
+  disagreements: string[];
+  riskNotes: string[];
+  /** Driver-model synthesis appended after all auto-deepen rounds (2026-09-05). */
+  conclusion?: string;
+}
+//#endregion
+//#region src/events.d.ts
+declare module '@deepseek-ai/cordis' {
+  interface Events {
+    'advisor-group/session-start'(session: ConsultSession): void;
+    'advisor-group/message'(payload: {
+      sessionId: string;
+      message: ChatMessage;
+    }): void;
+    'advisor-group/delta'(payload: {
+      sessionId: string;
+      turn: number;
+      step: number;
+      advisorId: string;
+      advisorName?: string;
+      contentDelta?: string;
+      thinkingDelta?: string;
+      done?: boolean;
+    }): void;
+    'advisor-group/session-end'(payload: {
+      sessionId: string;
+      summary: ConsultSummary;
+    }): void;
+  }
+}
+//#endregion
+//#region src/index.d.ts
+declare const name = "dsh-advisor-group";
+declare const inject: string[];
+declare function apply(ctx: Context, config: Config): void;
+//#endregion
+export { Config, apply, inject, name };