deepseek-coordination 0.10.0 → 0.11.0

package/lib/index.d.mts

@@ -244,9 +244,75 @@ interface CoordinationConfig {
 }
 declare const Config: Schema<CoordinationConfig>;
 //#endregion
+//#region src/host/model-brand.d.ts
+/**
+ * Brand cache profiles — built-in policy for the mainstream model families.
+ *
+ * The harness owns the model catalog (`ctx.llm.resolveModelInfo(provider, model)`
+ * returns `{ provider, id, name, description, reasoning }`), but it does not say
+ * how each family caches prompts. This module turns the host's identity fields
+ * into one of a small set of known cache behaviours, so the proxy can reason
+ * about a model instead of guessing from the provider route alone.
+ *
+ * What the profile means, and what it does not:
+ *
+ *  - `automaticPrefixCache` — the provider caches a stable prompt prefix on its
+ *    own, with no request marker. When true the only useful local lever is
+ *    keeping that prefix byte-stable.
+ *  - `explicitCacheBreakpoints` — the provider needs cache markers inside the
+ *    request. This plugin cannot emit them (they are adapter/wire territory), so
+ *    the profile says so instead of pretending an optimization exists.
+ *  - `minPrefixTokens` — the documented (or conservatively assumed) prefix size
+ *    below which the provider does not cache at all.
+ *  - `effortBreaksCache` — whether changing `reasoningEffort` invalidates the
+ *    cached prefix for this family.
+ *  - `stripVolatileHelps` — whether removing volatile fragments (timestamps,
+ *    UUIDs, long hex) from outbound text can improve reuse. False for explicit
+ *    caching, where markers, not bytes, decide reuse.
+ *
+ * The numbers are policy defaults, never measurements: each profile carries the
+ * note the UI shows, and an unknown family gets the conservative row.
+ */
+/** Model family the cache policy knows about. */
+type ModelBrand = 'deepseek' | 'openai' | 'anthropic' | 'google' | 'xai' | 'moonshot' | 'qwen' | 'zhipu' | 'mistral' | 'meta' | 'unknown';
+//#endregion
 //#region src/index.d.ts
 declare const name = "deepseek-coordination";
 declare const inject: string[];
+/**
+ * Structural status of the proxy, exposed read-only to the host.
+ *
+ * Counts and identities only: no prompt, no answer, no tool payload, no
+ * credential ever reaches this object. It is the observability half of the
+ * proxy's security model — the host can see that it runs, not what it saw.
+ */
+interface CacheProxyStatus {
+  available: boolean;
+  enabled: boolean;
+  provider: string;
+  upstream?: {
+    provider: string;
+    model?: string;
+  };
+  /** Host-reported model identity mapped onto a built-in cache brand. */
+  model?: {
+    brand: ModelBrand;
+    label: string;
+    automaticPrefixCache: boolean;
+    explicitCacheBreakpoints: boolean;
+    minPrefixTokens: number;
+    effortBreaksCache: boolean;
+    stripVolatileHelps: boolean;
+    note: string;
+  };
+  forwards: number;
+  refusals: number;
+  lastForwardAt?: string;
+  /** True when the wiring supplies a content decorator (brand-gated per call). */
+  decorate: boolean;
+}
+/** The status snapshot handed to `GET /proxy/status`. */
+declare function cacheProxyStatus(): Readonly<CacheProxyStatus>;
 declare function apply(context: Context, configInput?: Partial<CoordinationConfig>): void;
 //#endregion
-export { Config, apply, inject, name };
+export { Config, apply, cacheProxyStatus, inject, name };