stratagate-dsh 0.2.78 → 0.2.80

package/dist/plugin.js

@@ -5751,6 +5751,7 @@ var DshModelBridge = class {
     this.structuredReasoningEffort = config.structuredReasoningEffort ?? "auto";
     this.ctx.on?.("llm/adapters-updated", () => {
       this.offCapabilities.clear();
+      for (const listener of this.adaptersUpdatedListeners) listener();
     });
   }
   ctx;
@@ -5759,7 +5760,24 @@ var DshModelBridge = class {
   successfulResponses = [];
   offCapabilities = /* @__PURE__ */ new Map();
   warnedOffFallbackRoutes = /* @__PURE__ */ new Set();
+  adaptersUpdatedListeners = /* @__PURE__ */ new Set();
   structuredReasoningEffort;
+  /** True only when the exact provider route has a registered DSH adapter. */
+  isReady(session) {
+    try {
+      const { provider } = this.resolveRoute(session);
+      return this.ctx.llm.listProviders().some(({ id }) => id === provider);
+    } catch {
+      return false;
+    }
+  }
+  /** Wake durable workers when DSH changes the adapter registry. */
+  onAdaptersUpdated(listener) {
+    this.adaptersUpdatedListeners.add(listener);
+    return () => {
+      this.adaptersUpdatedListeners.delete(listener);
+    };
+  }
   setStructuredReasoningEffort(mode) {
     this.structuredReasoningEffort = mode;
   }
@@ -5970,6 +5988,7 @@ var DshModelBridge = class {
     let lastError;
     let lastResponse = "";
     let attemptsUsed = 0;
+    let noAdapterRetried = false;
     for (let attempt = 1; attempt <= JSON_RESPONSE_ATTEMPTS; attempt += 1) {
       attemptsUsed = attempt;
       const message = createUserMessage({
@@ -6000,6 +6019,11 @@ ${JSON_RETRY_INSTRUCTION}`,
       try {
         await this.consumeStructuredStream(request, assembler);
       } catch (error) {
+        if (!noAdapterRetried && isNoAdapter(error)) {
+          noAdapterRetried = true;
+          attempt -= 1;
+          continue;
+        }
         if (useOff && isOffRejection(error)) {
           this.offCapabilities.set(routeKey, "unsupported");
           useOff = false;
@@ -6012,6 +6036,11 @@ ${JSON_RETRY_INSTRUCTION}`,
       const finish = assembler.finish;
       if (finish.kind === "error" || finish.kind === "aborted") {
         const failure = new Error(`StrataGate model call failed [${finish.failure.code}]: ${finish.failure.message}`);
+        if (!noAdapterRetried && isNoAdapter(finish.failure)) {
+          noAdapterRetried = true;
+          attempt -= 1;
+          continue;
+        }
         if (useOff && isOffRejection(finish.failure)) {
           this.offCapabilities.set(routeKey, "unsupported");
           useOff = false;
@@ -6177,6 +6206,17 @@ ${JSON_RETRY_INSTRUCTION}`,
     return { provider: fallback.provider, model: fallback.model };
   }
 };
+function isNoAdapter(error) {
+  const seen = /* @__PURE__ */ new Set();
+  let current = error;
+  while (current && typeof current === "object" && !seen.has(current)) {
+    seen.add(current);
+    const candidate = current;
+    if (candidate.code === "NO_ADAPTER") return true;
+    current = candidate.cause;
+  }
+  return false;
+}
 function isOffRejection(error) {
   let detail;
   try {
@@ -6618,6 +6658,7 @@ var StrataGateRuntime = class {
     this.openPath = openPath;
     this.blockTurnSize = config.blockTurnSize;
     this.blockDecayLambda = config.blockDecayLambda;
+    this.disposeAdaptersUpdated = this.models.onAdaptersUpdated(() => this.wakeModelWorkers());
     this.scheduleBackgroundWorker(BACKGROUND_WORKER_INITIAL_DELAY_MS);
   }
   config;
@@ -6632,6 +6673,7 @@ var StrataGateRuntime = class {
   latestBatchIds = /* @__PURE__ */ new Map();
   workspaceNames = /* @__PURE__ */ new Map();
   migrationTimers = /* @__PURE__ */ new Map();
+  migrationRuns = /* @__PURE__ */ new Map();
   derivationTimers = /* @__PURE__ */ new Map();
   derivationRuns = /* @__PURE__ */ new Map();
   knownSessions = /* @__PURE__ */ new Map();
@@ -6650,6 +6692,8 @@ var StrataGateRuntime = class {
   backgroundNamespaceRuns = /* @__PURE__ */ new Map();
   backgroundWorkerTimer;
   backgroundWorkerRun;
+  backgroundWorkerWakePending = false;
+  disposeAdaptersUpdated;
   settingsTail = Promise.resolve();
   batchSequence = 0;
   closed = false;
@@ -6665,13 +6709,15 @@ var StrataGateRuntime = class {
       this.backgroundWorkerRun = run;
       void run.finally(() => {
         if (this.backgroundWorkerRun === run) this.backgroundWorkerRun = void 0;
-        this.scheduleBackgroundWorker(BACKGROUND_WORKER_INTERVAL_MS);
+        const delay = this.backgroundWorkerWakePending ? 0 : BACKGROUND_WORKER_INTERVAL_MS;
+        this.backgroundWorkerWakePending = false;
+        this.scheduleBackgroundWorker(delay);
       });
     }, delayMs);
     this.backgroundWorkerTimer.unref?.();
   }
   async runBackgroundWorker() {
-    if (this.closed) return;
+    if (this.closed || !this.models.isReady()) return;
     let namespaces;
     try {
       namespaces = await this.adminNamespaces();
@@ -6689,6 +6735,7 @@ var StrataGateRuntime = class {
     }
   }
   async runBackgroundNamespace(namespace) {
+    if (this.closed || !this.models.isReady()) return;
     const existing = this.backgroundNamespaceRuns.get(namespace);
     if (existing) return existing;
     const run = (async () => {
@@ -6704,9 +6751,11 @@ var StrataGateRuntime = class {
         const hasActiveSessionWork = [
           ...this.derivationTimers.keys(),
           ...this.derivationRuns.keys(),
-          ...this.migrationTimers.keys()
+          ...this.migrationTimers.keys(),
+          ...this.migrationRuns.keys()
         ].some((key) => key.startsWith(`${namespace}\0`) || key === namespace);
         if (hasActiveSessionWork) return;
+        if (!this.models.isReady()) return;
         const resumed = await this.models.runDetached(
           `stratagate-worker:${namespace}`,
           () => memory.resumePendingWork()
@@ -6734,6 +6783,33 @@ var StrataGateRuntime = class {
       if (this.backgroundNamespaceRuns.get(namespace) === run) this.backgroundNamespaceRuns.delete(namespace);
     }
   }
+  wakeBackgroundWorker() {
+    if (this.closed) return;
+    if (this.backgroundWorkerTimer) {
+      clearTimeout(this.backgroundWorkerTimer);
+      this.backgroundWorkerTimer = void 0;
+    }
+    if (this.backgroundWorkerRun) {
+      this.backgroundWorkerWakePending = true;
+      return;
+    }
+    this.scheduleBackgroundWorker(0);
+  }
+  wakeModelWorkers() {
+    if (this.closed) return;
+    this.wakeBackgroundWorker();
+    for (const reference of this.knownSessions.values()) {
+      const session = reference.deref();
+      if (!session || !this.models.isReady(session)) continue;
+      const opening = this.spaces.get(this.namespaceFor(session));
+      if (!opening) continue;
+      void opening.then((memory) => {
+        if (this.closed || !this.models.isReady(session)) return;
+        this.scheduleGraphMigration(session, memory);
+        this.scheduleBlockDerivation(session, memory);
+      }).catch((error) => this.onIngestError(error));
+    }
+  }
   acceptEvent(session, event) {
     if (this.closed) return;
     if (!this.config.ingestSubagents && session.header.origin === "subagent") return;
@@ -7217,6 +7293,7 @@ var StrataGateRuntime = class {
   async close() {
     if (this.closed) return;
     this.closed = true;
+    this.disposeAdaptersUpdated();
     if (this.backgroundWorkerTimer) clearTimeout(this.backgroundWorkerTimer);
     this.backgroundWorkerTimer = void 0;
     for (const timer of this.migrationTimers.values()) clearTimeout(timer);
@@ -7234,6 +7311,7 @@ var StrataGateRuntime = class {
     const settled = await Promise.allSettled(this.spaces.values());
     await Promise.allSettled(this.backgroundNamespaceRuns.values());
     if (this.backgroundWorkerRun) await Promise.allSettled([this.backgroundWorkerRun]);
+    await Promise.allSettled(this.migrationRuns.values());
     await Promise.allSettled(this.derivationRuns.values());
     await Promise.allSettled(this.externalImportRuns.values());
     await Promise.all(settled.flatMap((result) => result.status === "fulfilled" ? [result.value.close()] : []));
@@ -7770,6 +7848,9 @@ var StrataGateRuntime = class {
           if (kind === "event-extraction") return memory.retryEventExtraction(jobId);
           return memory.retryGraphProjection(jobId);
         };
+        if (!this.models.isReady(session)) {
+          throw new Error("StrataGate model adapter is not ready; retry after DSH finishes registering adapters");
+        }
         const result = session && this.namespaceFor(session) === key ? await this.models.run(session, retry) : await this.models.runDetached(threadId, retry);
         await this.persistSuccessfulResponses(memory);
         const currentBlock = blockId ? memory.listBlocks().find(({ id: candidateId }) => candidateId === blockId) : void 0;
@@ -7969,7 +8050,7 @@ var StrataGateRuntime = class {
   scheduleBlockDerivation(session, memory) {
     const threadId = String(session.id);
     const key = `${this.namespaceFor(session)}\0${threadId}`;
-    if (this.closed || this.derivationTimers.has(key) || this.derivationRuns.has(key)) return;
+    if (this.closed || !this.models.isReady(session) || this.derivationTimers.has(key) || this.derivationRuns.has(key)) return;
     const pendingBlockIds = new Set(memory.listBlocks().filter((block) => block.threadId === threadId && block.processingStatus === "pending").map((block) => block.id));
     if (pendingBlockIds.size === 0) return;
     const retryTimes = [
@@ -7980,7 +8061,7 @@ var StrataGateRuntime = class {
     const delay = Math.max(0, Math.min(...retryTimes) - Date.now());
     const timer = setTimeout(() => {
       this.derivationTimers.delete(key);
-      if (this.closed) return;
+      if (this.closed || !this.models.isReady(session)) return;
       const failedBefore = this.failedCoreJobs(memory);
       const run = this.models.run(session, () => memory.resumePendingWork({ threadId })).then(async (resumed) => {
         await this.persistSuccessfulResponses(memory);
@@ -8008,24 +8089,29 @@ var StrataGateRuntime = class {
   }
   scheduleGraphMigration(session, memory) {
     const namespace = this.namespaceFor(session);
-    if (this.closed || this.migrationTimers.has(namespace)) return;
+    if (this.closed || !this.models.isReady(session) || this.migrationTimers.has(namespace) || this.migrationRuns.has(namespace)) return;
     if (typeof memory.listGraphProjectionJobs !== "function") return;
     const pending = memory.listGraphProjectionJobs().some((job) => graphProjectionCanRun(job));
     if (!pending) return;
     const timer = setTimeout(() => {
       this.migrationTimers.delete(namespace);
-      if (this.closed) return;
+      if (this.closed || !this.models.isReady(session)) return;
       const failedBefore = this.failedCoreJobs(memory);
       const completedBefore = memory.listGraphProjectionJobs().filter(({ status }) => status === "completed").length;
-      void this.models.run(session, () => memory.resumePendingWork()).then(async () => {
+      let madeProgress = false;
+      const run = this.models.run(session, () => memory.resumePendingWork()).then(async () => {
         await this.persistSuccessfulResponses(memory);
         this.noteNewCoreJobFailures(session, failedBefore, memory);
         const completedAfter = memory.listGraphProjectionJobs().filter(({ status }) => status === "completed").length;
-        if (completedAfter > completedBefore) this.scheduleGraphMigration(session, memory);
+        madeProgress = completedAfter > completedBefore;
       }).catch((error) => {
         this.notePluginError(session, error);
         this.onIngestError(error);
+      }).finally(() => {
+        if (this.migrationRuns.get(namespace) === run) this.migrationRuns.delete(namespace);
+        if (madeProgress) this.scheduleGraphMigration(session, memory);
       });
+      this.migrationRuns.set(namespace, run);
     }, 1500);
     timer.unref?.();
     this.migrationTimers.set(namespace, timer);
@@ -8455,7 +8541,7 @@ function sessionOf(exec) {
 function registerMemoryTools(ctx, runtime) {
   ctx.tools.register(defineTool({
     name: "feedback_prepare",
-    description: 'Create or revise a local StrataGate feedback draft when the user directly requests it, or after a proactive suggestion permitted by the StrataGate feedback policy and the user explicitly agrees. A direct user request is already authorization. Use only facts known from the current conversation; leave unknown fields empty and never invent versions, logs, Block counts, or diagnostics. Never submit anything to GitHub. After success, briefly say the draft is local and not submitted, then render feedbackUrl as a Markdown link labeled "\u6253\u5F00\u53CD\u9988\u8349\u7A3F". Do not print draft fields or an Issue-content table, and do not direct the user through Settings manually.',
+    description: 'This tool is provided by the StrataGate plugin. Create or revise a local StrataGate feedback draft when the user directly requests it, or after a proactive suggestion permitted by the StrataGate feedback policy and the user explicitly agrees. A direct user request is already authorization. Use only facts known from the current conversation; leave unknown fields empty and never invent versions, logs, Block counts, or diagnostics. Never submit anything to GitHub. After success, briefly say the draft is local and not submitted, then render feedbackUrl as a Markdown link labeled "\u6253\u5F00\u53CD\u9988\u8349\u7A3F". Then ask exactly once: "\u8981\u4E0D\u8981\u987A\u4FBF\u8BA9\u6211\u5C1D\u8BD5\u4FEE\u590D\u8FD9\u4E2A\u95EE\u9898\uFF0C\u5E76\u63D0\u4EA4\u4E00\u4E2A PR\uFF1F" If the user does not respond or declines, do not ask again. Do not use a popup or other additional UI. Do not print draft fields or an Issue-content table, and do not direct the user through Settings manually.',
     parameters: {
       title: { type: "string" },
       description: { type: "string" },
@@ -8476,7 +8562,7 @@ function registerMemoryTools(ctx, runtime) {
   }));
   ctx.tools.register(defineTool({
     name: "memory_search_events",
-    description: "Search durable StrataGate event memories. Returns a compact batch of event cards (id, title, summary, time, and evidence refs); call memory_expand_event for narrative/quotes/source messages. rankScore is BM25/RRF ordering only, never confidence or factual accuracy. Pass batchId to memory_assess before relying on evidence.",
+    description: "This tool is provided by the StrataGate plugin. Search durable StrataGate event memories. Returns a compact batch of event cards (id, title, summary, time, and evidence refs); call memory_expand_event for narrative/quotes/source messages. rankScore is BM25/RRF ordering only, never confidence or factual accuracy. Pass batchId to memory_assess before relying on evidence.",
     parameters: {
       query: { type: "string", required: true, description: "What historical decision, event, preference, or outcome to find." },
       limit: { type: "integer", description: "Maximum results, 1-20." },
@@ -8494,7 +8580,7 @@ function registerMemoryTools(ctx, runtime) {
   }));
   ctx.tools.register(defineTool({
     name: "memory_search_graph",
-    description: "Search the Event-backed Knowledge Graph for current state and query-relevant history. Results explicitly label current, historical, or both; historical matches never imply current truth, disputed records remain marked, and Event evidence is bounded to the match. Endpoint names and aliases can match relations, while relation text alone is ranking context. rankScore is ranking-only, never confidence or factual accuracy.",
+    description: "This tool is provided by the StrataGate plugin. Search the Event-backed Knowledge Graph for current state and query-relevant history. Results explicitly label current, historical, or both; historical matches never imply current truth, disputed records remain marked, and Event evidence is bounded to the match. Endpoint names and aliases can match relations, while relation text alone is ranking context. rankScore is ranking-only, never confidence or factual accuracy.",
     parameters: {
       query: { type: "string", required: true },
       limit: { type: "integer", description: "Maximum results, 1-20." }
@@ -8504,14 +8590,14 @@ function registerMemoryTools(ctx, runtime) {
   }));
   ctx.tools.register(defineTool({
     name: "memory_expand_graph_node",
-    description: "Expand one Knowledge Graph node through the same Event-authoritative view as search: dynamic current state, marked disputed records, retrievable history, and bounded supporting Event evidence. Forgotten or archived Event provenance is never exposed.",
+    description: "This tool is provided by the StrataGate plugin. Expand one Knowledge Graph node through the same Event-authoritative view as search: dynamic current state, marked disputed records, retrievable history, and bounded supporting Event evidence. Forgotten or archived Event provenance is never exposed.",
     parameters: { id: { type: "string", required: true } },
     output: jsonOutput,
     execute: async (args, exec) => runtime.expandGraphNode(sessionOf(exec), args.id)
   }));
   ctx.tools.register(defineTool({
     name: "memory_search_elements",
-    description: "Deprecated compatibility search for legacy Element-card data. Returns compact fact hits; rankScore is BM25/RRF ordering only, never confidence or factual accuracy. Prefer memory_search_graph.",
+    description: "This tool is provided by the StrataGate plugin. Deprecated compatibility search for legacy Element-card data. Returns compact fact hits; rankScore is BM25/RRF ordering only, never confidence or factual accuracy. Prefer memory_search_graph.",
     parameters: {
       query: { type: "string", required: true },
       limit: { type: "integer" },
@@ -8527,7 +8613,7 @@ function registerMemoryTools(ctx, runtime) {
   }));
   ctx.tools.register(defineTool({
     name: "memory_search_raw",
-    description: "Search archived messages when summarized memories are insufficient. Returns compact raw hits (message id, blockId, excerpt, role, and time); use memory_expand_block with blockId for complete source details. By default searches the whole current namespace; use scope=session for the active thread. Returns evidence refs and batchId for assessment.",
+    description: "This tool is provided by the StrataGate plugin. Search archived messages when summarized memories are insufficient. Returns compact raw hits (message id, blockId, excerpt, role, and time); use memory_expand_block with blockId for complete source details. By default searches the whole current namespace; use scope=session for the active thread. Returns evidence refs and batchId for assessment.",
     parameters: {
       query: { type: "string", required: true },
       limit: { type: "integer" },
@@ -8538,7 +8624,7 @@ function registerMemoryTools(ctx, runtime) {
   }));
   ctx.tools.register(defineTool({
     name: "memory_get_blocks",
-    description: "List decayed conversation-block summaries and their current detail levels. Defaults to the active session only; use scope=namespace to inspect every thread in the current namespace. The response always reports scope, namespace, threadId, counts, and a machine-readable emptyReason when no blocks match.",
+    description: "This tool is provided by the StrataGate plugin. List decayed conversation-block summaries and their current detail levels. Defaults to the active session only; use scope=namespace to inspect every thread in the current namespace. The response always reports scope, namespace, threadId, counts, and a machine-readable emptyReason when no blocks match.",
     parameters: {
       scope: { type: "string", enum: ["session", "namespace"], description: "Query range. Defaults to session to preserve existing isolation behavior." }
     },
@@ -8547,7 +8633,7 @@ function registerMemoryTools(ctx, runtime) {
   }));
   ctx.tools.register(defineTool({
     name: "memory_expand_block",
-    description: "Expand one memory block to a more detailed layer. The result is a new evidence batch and must be assessed.",
+    description: "This tool is provided by the StrataGate plugin. Expand one memory block to a more detailed layer. The result is a new evidence batch and must be assessed.",
     parameters: {
       id: { type: "string", required: true },
       target: { oneOf: [{ type: "string" }, { type: "integer" }] }
@@ -8557,7 +8643,7 @@ function registerMemoryTools(ctx, runtime) {
   }));
   ctx.tools.register(defineTool({
     name: "memory_expand_event",
-    description: "Retrieve one complete Event card by id. The result is a new evidence batch and must be assessed.",
+    description: "This tool is provided by the StrataGate plugin. Retrieve one complete Event card by id. The result is a new evidence batch and must be assessed.",
     parameters: {
       id: { type: "string", required: true }
     },
@@ -8566,7 +8652,7 @@ function registerMemoryTools(ctx, runtime) {
   }));
   ctx.tools.register(defineTool({
     name: "memory_expand_element",
-    description: "Expand an Element card, optionally as it was at an ISO date. The result is a new evidence batch and must be assessed.",
+    description: "This tool is provided by the StrataGate plugin. Expand an Element card, optionally as it was at an ISO date. The result is a new evidence batch and must be assessed.",
     parameters: {
       id: { type: "string", required: true },
       at: { type: "string" }
@@ -8576,7 +8662,7 @@ function registerMemoryTools(ctx, runtime) {
   }));
   ctx.tools.register(defineTool({
     name: "memory_assess",
-    description: "Apply StrataGate Evidence Gate to a retrieval batch. Pass batch_id from the retrieval result; omitting it remains compatible with sequential flows and selects the latest batch. The response reports every input ref that was not adopted and why.",
+    description: "This tool is provided by the StrataGate plugin. Apply StrataGate Evidence Gate to a retrieval batch. Pass batch_id from the retrieval result; omitting it remains compatible with sequential flows and selects the latest batch. The response reports every input ref that was not adopted and why.",
     parameters: {
       batch_id: { type: "string", description: "The batchId returned by the retrieval to assess. Omit only in a strictly sequential flow." },
       verdict: { type: "string", enum: ["sufficient", "partial", "wrong"], required: true },
@@ -8594,7 +8680,7 @@ function registerMemoryTools(ctx, runtime) {
   }));
   ctx.tools.register(defineTool({
     name: "memory_record_use",
-    description: "Close one StrataGate retrieval batch. Pass its batch_id and exactly the evidenceRefs from that batch actually used in the answer, or [] when none were used. Non-empty refs require that batch's sufficient assessment. The host renders successful selections as answer-tail citations, so do not write a manual citation list. Omitting batch_id selects the latest batch for sequential compatibility.",
+    description: "This tool is provided by the StrataGate plugin. Close one StrataGate retrieval batch. Pass its batch_id and exactly the evidenceRefs from that batch actually used in the answer, or [] when none were used. Non-empty refs require that batch's sufficient assessment. The host renders successful selections as answer-tail citations, so do not write a manual citation list. Omitting batch_id selects the latest batch for sequential compatibility.",
     parameters: {
       batch_id: { type: "string", description: "The batchId to close. Omit only in a strictly sequential flow." },
       evidence_refs: { type: "array", items: { type: "string" }, required: true }