deepseek-coordination 0.1.9 → 0.10.0

package/lib/index.d.mts

@@ -0,0 +1,252 @@
+import { Schema } from "@deepseek-ai/schemastery";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/shared/enum.d.ts
+/**
+ * Enumerations shared by the Host and Client halves.
+ *
+ * Every union is a closed domain. The Chinese labels and tooltips live next to
+ * the English identifiers so the composer controls and the settings page never
+ * duplicate copy that the model-facing service also needs.
+ */
+/** A task's single accountable duty. Locked for the duration of one task. */
+type Profession = 'decision' | 'outcome' | 'resource' | 'personnel' | 'qualification' | 'execution';
+/** How the agent organises its response. */
+type Interaction = 'emotion' | 'think' | 'heuristic' | 'converge' | 'orchestrate';
+/** The working scenario (v24: writing sits between dialogue and office). */
+type Scene = 'dialogue' | 'writing' | 'office' | 'research' | 'engineering' | 'iterate';
+/** Evidence and inference depth. */
+type Validation = 'low' | 'medium' | 'high';
+/** The input command face; `none` runs the complete coordination pipeline. */
+type CommandType = 'none' | 'goal' | 'plan' | 'feedback' | 'compact' | 'permission';
+/**
+ * Per-scene execution policy (v24 §19). One table shared by the config
+ * defaults, the plan pipeline, and the UI copy, so a scene is never described
+ * in one place and enforced in another.
+ */
+interface SceneProfile {
+  thinking: 'enabled' | 'disabled';
+  reasoningEffort: string;
+  requirePlan: boolean;
+  requireScore: boolean;
+  requireOutline: boolean;
+  requireRevision: boolean;
+  requirePredict: boolean;
+  requireCitation: boolean;
+  allowBash: boolean;
+  allowWeb: boolean;
+  sandboxOnly: boolean;
+  maxIteration: number;
+  scoreThreshold: number;
+}
+//#endregion
+//#region src/host/config.d.ts
+interface ProfessionConfig {
+  /** Forced true by the resolver; kept for schema compatibility. */
+  enabled: boolean;
+  /** Forced true by the resolver: the lock is a core safety constraint. */
+  lock: boolean;
+  /**
+   * Documented alias of `defaults.profession`. `resolveConfig()` mirrors the
+   * effective default here so neither key is dead; new deployments should set
+   * `defaults.profession`.
+   */
+  default: Profession;
+  /** Forced true by the resolver: a rebuild always creates a new task. */
+  rebuildCanReselect: boolean;
+  /** Forced true by the resolver: the next task may choose a new profession. */
+  abandonCanReselect: boolean;
+  /**
+   * Reserved: the profession module always appends its lock/rebuild/abandon
+   * events to `orchestration_trace`, so this flag does not gate anything yet.
+   * Kept for schema compatibility until a trace-audit policy actually exists.
+   */
+  audit: boolean;
+  /** Whether lock rejections carry the rebuild/abandon escape hatch. */
+  errorHint: boolean;
+}
+interface PlanWeights {
+  feasibility: number;
+  coverage: number;
+  clarity: number;
+  specificity: number;
+  alignment: number;
+  risk: number;
+  cost: number;
+  efficiency: number;
+}
+interface PlanDimensionThreshold {
+  feasibility: number;
+  coverage: number;
+  clarity: number;
+  specificity: number;
+  alignment: number;
+  risk: number;
+  cost: number;
+  efficiency: number;
+}
+interface PlanConfig {
+  threshold: number;
+  maxRebuild: number;
+  weights: PlanWeights;
+  dimensions: PlanDimensionThreshold;
+}
+interface OrchestrationConfig {
+  maxReject: number;
+  maxSubTask: number;
+  groundTruth: boolean;
+  groundTruthTimeout: number;
+  allowShellGroundTruth: boolean;
+  modelRouting: boolean;
+}
+interface CacheConfig {
+  enabled: boolean;
+  ttl: number;
+  fingerprintWindow: number;
+  effortWarning: boolean;
+}
+/**
+ * Automatic token-governor policy (v24 §5/§9.3, `src/host/token.ts`).
+ *
+ * This group is deliberately distinct from the `compact` table and the
+ * `compact` command: those record an explicit, user-requested compaction,
+ * while these thresholds tune when the governor *proposes* one. `auto: false`
+ * disables only the automatic proposal; an explicit compact command still
+ * runs. `soft`/`hard` are utilisation ratios against the effective window
+ * (`contextWindow - reserve`), `cooldown` and `maxPerSession` bound how often
+ * the host adapter may act on a proposal.
+ */
+interface CompactionPolicyConfig {
+  auto: boolean;
+  soft: number;
+  hard: number;
+  reserve: number;
+  recentTurns: number;
+  cooldown: number;
+  maxPerSession: number;
+}
+interface BayesianConfig {
+  prior: number;
+  stopEntropy: number;
+  infoGain: number;
+  maxRoutes: number;
+  calibrationFloor: number;
+}
+interface ComprehensionConfig {
+  stageTimeout: number;
+  searchEnabled: boolean;
+  maxEvidence: number;
+  highHistoryWindow: number;
+}
+interface UiConfig {
+  /**
+   * @deprecated Legacy alias of the composer workflow flag. It is projected as
+   * `SelectionStateConfig.workflow` and kept so the schema stays compatible;
+   * new deployments should not build a setting around it.
+   */
+  toolbar: boolean;
+  showTooltip: boolean;
+  takeover: boolean;
+  refreshInterval: number;
+  compact: boolean;
+  /** 'auto' follows the DSH locale; zh-CN/en-US force the host-side copy. */
+  locale: string;
+}
+/**
+ * File-processing policy (v24 `docs/file-processing-v24.md` §4, domain model §7).
+ *
+ * The values are the documented hard caps: 1 MiB of source text, 200 000
+ * tokens, AST depth 256, a 2 s parse budget, a 256-entry parse cache and the
+ * 20 000 / 100 000 dependency-graph bounds. They live in the schema so a
+ * deployment can tighten them in one place.
+ *
+ * Consumers and timing (`src/host/tools.ts`): `enabled` gates the four file
+ * tools at registration time and is re-checked live (a disabled parser makes the
+ * registered tools fail closed); every limit is re-applied to the lazy
+ * `ToolRuntime` when the config signature changes, so a `/config` patch reaches
+ * the next tool call instead of waiting for a restart. `maxAstDepth` is threaded
+ * into the parser's `maxDepth` and the two dependency-graph caps bound
+ * `ParseService.dependencyGraph`; all three are clamped to the parser-layer hard
+ * caps. The settings catalog still marks those three keys `planned`; that is a
+ * catalog flag, not a missing consumer.
+ */
+interface ParserConfig {
+  /** Master switch for the file tools; read at registration and on every call. */
+  enabled: boolean;
+  /** Maximum source text in bytes; the parser truncates and marks `truncated`. */
+  maxFileBytes: number;
+  /** Maximum tokens emitted by one parse. */
+  maxTokens: number;
+  /** AST depth handed to the parser (`maxDepth`), capped to `MAX_AST_DEPTH`. */
+  maxAstDepth: number;
+  /** Parse wall-clock budget in milliseconds. */
+  timeoutMs: number;
+  /** Parse-result cache capacity in files. */
+  cacheCapacity: number;
+  /** Dependency-graph vertex cap, capped to the parser layer's hard cap. */
+  dependencyGraphMaxVertices: number;
+  /** Dependency-graph edge cap, capped to the parser layer's hard cap. */
+  dependencyGraphMaxEdges: number;
+}
+/**
+ * Chain-projection budget (domain model §3, §7): depth ≤ 8, links ≤ 50,
+ * ~1 500 tokens.
+ *
+ * `src/host/tools.ts` re-applies all three to the lazy `ToolRuntime` whenever the
+ * file-layer config signature changes, so a live `/config` patch reaches the
+ * next query while indexed handles stay valid (`ChainEngine.retune`).
+ */
+interface ChainConfig {
+  depth: number;
+  links: number;
+  tokenBudget: number;
+}
+/**
+ * Model-facing tool output budget. `0` means "no byte cap" (the historical
+ * unbounded `renderJson`); a positive value makes `renderJson` emit a valid JSON
+ * truncation envelope with an explicit marker and byte counts. The value is read
+ * per render, not captured at registration, so a live `/config` change applies
+ * to the very next tool result.
+ */
+interface ToolConfig {
+  maxResultBytes: number;
+}
+interface CoordinationConfig {
+  database: string;
+  databasePath: string;
+  maxTurnPerSession: number;
+  defaultLease: number;
+  clarifyTimeout: number;
+  profession: ProfessionConfig;
+  plan: PlanConfig;
+  orchestration: OrchestrationConfig;
+  cache: CacheConfig;
+  /** Automatic token-governor thresholds; distinct from the `compact` tables. */
+  compaction: CompactionPolicyConfig;
+  bayesian: BayesianConfig;
+  comprehension: ComprehensionConfig;
+  ui: UiConfig;
+  /** v24 file-processing policy (`docs/file-processing-v24.md` §4). */
+  parser: ParserConfig;
+  /** Chain-projection budget (domain model §3); applied live by `ToolRuntime`. */
+  chain: ChainConfig;
+  /** Model-facing tool output budget; `0` keeps the unbounded render. */
+  tools: ToolConfig;
+  /** v24 §19: per-scene execution policy. */
+  scenes: Record<Scene, SceneProfile>;
+  /** Defaults used when the composer sends no explicit selection. */
+  defaults: {
+    profession: Profession;
+    interaction: Interaction;
+    scene: Scene;
+    validation: Validation;
+    command: CommandType;
+  };
+}
+declare const Config: Schema<CoordinationConfig>;
+//#endregion
+//#region src/index.d.ts
+declare const name = "deepseek-coordination";
+declare const inject: string[];
+declare function apply(context: Context, configInput?: Partial<CoordinationConfig>): void;
+//#endregion
+export { Config, apply, inject, name };