chainlesschain 0.166.20 → 0.166.21

package/src/gateways/ws/ws-agent-handler.js

@@ -74,6 +74,8 @@ import {
   settleWsTurnClaim,
 } from "../../harness/jsonl-session-store.js";
 import { sessionBudgetAdmissionError } from "../../lib/session-budget-production-root.js";
+import { captureAgentSkillOutcomeIndex } from "../../lib/evolution/agent-evolution-runtime-composition-brand.js";
+import { captureSkillVectorAuthority } from "../../lib/skill-vector-authority.js";
 import {
   beginSessionBudgetUsage,
   markSessionBudgetUsageUnknown,
@@ -178,6 +180,8 @@ export class WSAgentHandler {
     sessionBudgetRoot = null,
     hostResourceBudget = null,
     evolutionCompositionFactory = null,
+    skillOutcomeIndex = null,
+    skillVectorAuthority = null,
   }) {
     this.session = session;
     this.interaction = interaction;
@@ -252,6 +256,23 @@ export class WSAgentHandler {
       throw new TypeError("evolutionCompositionFactory must be a function");
     }
     this._evolutionCompositionFactory = evolutionCompositionFactory;
+    this._skillOutcomeIndex =
+      skillOutcomeIndex === null
+        ? null
+        : captureAgentSkillOutcomeIndex(skillOutcomeIndex);
+    this._skillVectorAuthority =
+      skillVectorAuthority === null
+        ? null
+        : captureSkillVectorAuthority(skillVectorAuthority);
+    if (
+      this._skillOutcomeIndex !== null &&
+      this._skillVectorAuthority !== null &&
+      this._skillOutcomeIndex.tenantId !== this._skillVectorAuthority.tenantId
+    ) {
+      throw new TypeError(
+        "WebSocket retrieval authorities must share one tenant",
+      );
+    }
     this._compactionLlmQuery = compactionLlmQuery || null;
     this._compactionSettlementBlock = null;
     this._compactionChatFn =
@@ -333,6 +354,22 @@ export class WSAgentHandler {
           "Agent evolution composition belongs to another WebSocket turn",
         );
       }
+      if (
+        this._skillOutcomeIndex !== null &&
+        composition.tenantId !== this._skillOutcomeIndex.tenantId
+      ) {
+        throw new TypeError(
+          "WebSocket evolution composition and Skill outcome index must share one tenant",
+        );
+      }
+      if (
+        this._skillVectorAuthority !== null &&
+        composition.tenantId !== this._skillVectorAuthority.tenantId
+      ) {
+        throw new TypeError(
+          "WebSocket evolution composition and Skill vector authority must share one tenant",
+        );
+      }
       await composition.evolutionIngress.start();
       return composition;
     } catch (cause) {
@@ -821,44 +858,50 @@ export class WSAgentHandler {
     let result;
     try {
       this._sessionHostLease?.assert?.();
-      result = await this._compactContextMemory(session.messages, {
-        provider: session.provider,
-        model: session.model,
-        baseUrl: session.baseUrl,
-        apiKey: session.apiKey,
-        signal:
-          signal || this._sessionBudgetSignal || this._sessionHostLease?.signal,
-        onlyIfNeeded: true,
-        preserveCompletedExchange: true,
-        llmQuery: this._compactionLlmQuery,
-        chatFn: this._compactionChatFn,
-        chatOptions: {
-          cwd: session.projectRoot,
-          sessionId: session.id,
-        },
-        ...(meterCompaction
-          ? {
-              onProviderCallStart: () => {
-                const call = this._beginCanonicalCompactionUsage();
-                compactionUsageCall = call;
-                return call.callId;
-              },
+      result = await this._compactContextMemory(
+        session.messages,
+        {
+          provider: session.provider,
+          model: session.model,
+          baseUrl: session.baseUrl,
+          apiKey: session.apiKey,
+          signal:
+            signal ||
+            this._sessionBudgetSignal ||
+            this._sessionHostLease?.signal,
+          onlyIfNeeded: true,
+          preserveCompletedExchange: true,
+          llmQuery: this._compactionLlmQuery,
+          chatFn: this._compactionChatFn,
+          chatOptions: {
+            cwd: session.projectRoot,
+            sessionId: session.id,
+          },
+          ...(meterCompaction
+            ? {
+                onProviderCallStart: () => {
+                  const call = this._beginCanonicalCompactionUsage();
+                  compactionUsageCall = call;
+                  return call.callId;
+                },
+              }
+            : {}),
+          maxMessages: session.compactionMaxMessages,
+          maxTokens: session.compactionMaxTokens,
+          maxOutputTokens: session.compactionMaxOutputTokens,
+          summaryInputMaxChars: session.compactionInputMaxChars,
+          onContextMemorySummarySettled: (summaryResult) => {
+            if (compactionUsageCall && !compactionUsageSettled) {
+              this._settleCanonicalCompactionUsage(
+                compactionUsageCall,
+                summaryResult,
+              );
+              compactionUsageSettled = true;
             }
-          : {}),
-        maxMessages: session.compactionMaxMessages,
-        maxTokens: session.compactionMaxTokens,
-        maxOutputTokens: session.compactionMaxOutputTokens,
-        summaryInputMaxChars: session.compactionInputMaxChars,
-        onContextMemorySummarySettled: (summaryResult) => {
-          if (compactionUsageCall && !compactionUsageSettled) {
-            this._settleCanonicalCompactionUsage(
-              compactionUsageCall,
-              summaryResult,
-            );
-            compactionUsageSettled = true;
-          }
+          },
         },
-      }, "auto");
+        "auto",
+      );
       if (compactionUsageCall && !compactionUsageSettled) {
         this._settleCanonicalCompactionUsage(compactionUsageCall, result);
         compactionUsageSettled = true;
@@ -1471,6 +1514,12 @@ export class WSAgentHandler {
         shellPolicyOverrides: session.shellPolicyOverrides || null,
         slotFiller,
         interaction: this.interaction,
+        ...(this._skillOutcomeIndex === null
+          ? {}
+          : { skillOutcomeIndex: this._skillOutcomeIndex }),
+        ...(this._skillVectorAuthority === null
+          ? {}
+          : { skillVectorAuthority: this._skillVectorAuthority }),
         signal: turnSignal,
         sessionBudget: this._sessionBudget,
         // P0 authority: null unless opted in (byte-identical default — agent
@@ -1567,6 +1616,7 @@ export class WSAgentHandler {
               ? event.result?.skill || event.result?.skill_name || undefined
               : undefined),
           durationMs,
+          invocationReceipt: event.result?.invocationReceipt,
         });
         if (record.providerId) activeToolCalls.delete(record.providerId);
         const index = activeToolCallOrder.indexOf(record);
@@ -2183,41 +2233,46 @@ export class WSAgentHandler {
         try {
           this.assertSessionBudgetAdmission("WebSocket compaction");
           this._sessionHostLease?.assert?.();
-          result = await this._compactContextMemory(session.messages, {
-            provider: session.provider,
-            model: session.model,
-            baseUrl: session.baseUrl,
-            apiKey: session.apiKey,
-            signal: this._sessionBudgetSignal || this._sessionHostLease?.signal,
-            force: true,
-            preserveCompletedExchange: true,
-            llmQuery: this._compactionLlmQuery,
-            chatFn: this._compactionChatFn,
-            chatOptions: {
-              cwd: session.projectRoot,
-              sessionId: session.id,
-            },
-            ...(meterCompaction
-              ? {
-                  onProviderCallStart: () => {
-                    const call = this._beginCanonicalCompactionUsage();
-                    compactionUsageCall = call;
-                    return call.callId;
-                  },
+          result = await this._compactContextMemory(
+            session.messages,
+            {
+              provider: session.provider,
+              model: session.model,
+              baseUrl: session.baseUrl,
+              apiKey: session.apiKey,
+              signal:
+                this._sessionBudgetSignal || this._sessionHostLease?.signal,
+              force: true,
+              preserveCompletedExchange: true,
+              llmQuery: this._compactionLlmQuery,
+              chatFn: this._compactionChatFn,
+              chatOptions: {
+                cwd: session.projectRoot,
+                sessionId: session.id,
+              },
+              ...(meterCompaction
+                ? {
+                    onProviderCallStart: () => {
+                      const call = this._beginCanonicalCompactionUsage();
+                      compactionUsageCall = call;
+                      return call.callId;
+                    },
+                  }
+                : {}),
+              maxOutputTokens: session.compactionMaxOutputTokens,
+              summaryInputMaxChars: session.compactionInputMaxChars,
+              onContextMemorySummarySettled: (summaryResult) => {
+                if (compactionUsageCall && !compactionUsageSettled) {
+                  this._settleCanonicalCompactionUsage(
+                    compactionUsageCall,
+                    summaryResult,
+                  );
+                  compactionUsageSettled = true;
                 }
-              : {}),
-            maxOutputTokens: session.compactionMaxOutputTokens,
-            summaryInputMaxChars: session.compactionInputMaxChars,
-            onContextMemorySummarySettled: (summaryResult) => {
-              if (compactionUsageCall && !compactionUsageSettled) {
-                this._settleCanonicalCompactionUsage(
-                  compactionUsageCall,
-                  summaryResult,
-                );
-                compactionUsageSettled = true;
-              }
+              },
             },
-          }, "manual");
+            "manual",
+          );
           if (compactionUsageCall && !compactionUsageSettled) {
             this._settleCanonicalCompactionUsage(compactionUsageCall, result);
             compactionUsageSettled = true;

package/src/gateways/ws/ws-server.js

@@ -15,6 +15,8 @@ import { createHash, randomBytes, timingSafeEqual } from "node:crypto";
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
 import { WebSocketServer } from "ws";
+import { captureAgentSkillOutcomeIndex } from "../../lib/evolution/agent-evolution-runtime-composition-brand.js";
+import { captureSkillVectorAuthority } from "../../lib/skill-vector-authority.js";
 import {
   createEnvelope,
   envelopeFromStreamEvent,
@@ -330,6 +332,23 @@ export class ChainlessChainWSServer extends EventEmitter {
     }
     this.evolutionCompositionFactory =
       options.evolutionCompositionFactory || null;
+    this.skillOutcomeIndex =
+      options.skillOutcomeIndex == null
+        ? null
+        : captureAgentSkillOutcomeIndex(options.skillOutcomeIndex);
+    this.skillVectorAuthority =
+      options.skillVectorAuthority == null
+        ? null
+        : captureSkillVectorAuthority(options.skillVectorAuthority);
+    if (
+      this.skillOutcomeIndex !== null &&
+      this.skillVectorAuthority !== null &&
+      this.skillOutcomeIndex.tenantId !== this.skillVectorAuthority.tenantId
+    ) {
+      throw new TypeError(
+        "WebSocket retrieval authorities must share one tenant",
+      );
+    }
 
     /** Optional Phase-5 envelope bus for fan-out to hosted HTTP SSE. */
     this.envelopeBus = options.envelopeBus || null;

package/src/generated/cc-agent-protocol.schema.json

@@ -3649,7 +3649,13 @@
                     "graph/status",
                     "graph/history",
                     "graph/cancel",
-                    "graph/reconcile"
+                    "graph/reconcile",
+                    "evolution/workbench/list",
+                    "evolution/workbench/compare",
+                    "evolution/workbench/review",
+                    "evolution/workbench/rollback",
+                    "evolution/knowledge/conflicts",
+                    "evolution/knowledge/merge"
                   ]
                 }
               }

package/src/harness/jsonl-session-store.js

@@ -90,6 +90,9 @@ import {
   verifyExecutionLocationResultBundle,
 } from "../lib/execution-location-result.js";
 import { normalizeExecutionLocationResultStoreReceipt } from "../lib/execution-location-result-store.js";
+import skillInvocationReceipt from "@chainlesschain/session-core/skill-invocation-receipt";
+
+const { verifySkillInvocationReceipt } = skillInvocationReceipt;
 
 let securedSessionsDir = null;
 let securedSessionsDirIdentity = null;
@@ -3189,7 +3192,16 @@ export function appendToolCall(sessionId, toolName, args) {
  */
 export function appendToolCallCompact(
   sessionId,
-  { id, tool, isError, skill, plugin, pluginVersion, durationMs } = {},
+  {
+    id,
+    tool,
+    isError,
+    skill,
+    plugin,
+    pluginVersion,
+    durationMs,
+    invocationReceipt,
+  } = {},
 ) {
   const cleanId =
     id === undefined
@@ -3203,6 +3215,15 @@ export function appendToolCallCompact(
   if (id !== undefined && !cleanId) {
     throw new TypeError("compact tool call id must be a bounded string");
   }
+  const verifiedInvocationReceipt =
+    invocationReceipt === undefined || invocationReceipt === null
+      ? null
+      : verifySkillInvocationReceipt(invocationReceipt);
+  if (verifiedInvocationReceipt !== null && tool !== "run_skill") {
+    throw new TypeError(
+      "Skill invocation receipt can only be attached to run_skill",
+    );
+  }
   const duration = normalizeCompactDuration(durationMs);
   appendEvent(sessionId, "tool_call", {
     ...(cleanId ? { id: cleanId } : {}),
@@ -3212,6 +3233,9 @@ export function appendToolCallCompact(
     ...(plugin ? { plugin: String(plugin) } : {}),
     ...(pluginVersion ? { plugin_version: String(pluginVersion) } : {}),
     ...(duration !== null ? { duration_ms: duration } : {}),
+    ...(verifiedInvocationReceipt
+      ? { skill_invocation_receipt: verifiedInvocationReceipt }
+      : {}),
   });
 }
 

package/src/index.js

@@ -99,7 +99,7 @@ export function createProgram(options = {}) {
           `Register function '${entry.register}' not found in ${entry.module}`,
         );
       }
-      registerFn(program);
+      registerFn(program, options.commandDependencies?.[entry.name]);
     } catch (err) {
       if (process.env.DEBUG) {
         console.warn(

package/src/lib/app-server/cli-agent-kernel-adapter.js

@@ -200,6 +200,14 @@ export class CliAgentKernelAdapter {
           turnOptions.evolutionIngress ??
           this.sessionOptions.evolutionIngress ??
           null,
+        skillOutcomeIndex:
+          turnOptions.skillOutcomeIndex ??
+          this.sessionOptions.skillOutcomeIndex ??
+          null,
+        skillVectorAuthority:
+          turnOptions.skillVectorAuthority ??
+          this.sessionOptions.skillVectorAuthority ??
+          null,
       },
       {
         ...this.dependencies,

package/src/lib/app-server/graph-runtime.js

@@ -6,7 +6,11 @@ import {
 import { createGraphAuthorityBinding } from "../graph-kernel/authority.js";
 import { GraphEventStore } from "../graph-kernel/event-store.js";
 import { GraphKernel } from "../graph-kernel/runtime.js";
-import { captureAgentEvolutionRuntimeComposition } from "../evolution/agent-evolution-runtime-composition-brand.js";
+import {
+  captureAgentEvolutionRuntimeComposition,
+  captureAgentSkillOutcomeIndex,
+} from "../evolution/agent-evolution-runtime-composition-brand.js";
+import { captureSkillVectorAuthority } from "../skill-vector-authority.js";
 import {
   diffGraphTrace,
   locateBlockedRoot,
@@ -145,6 +149,8 @@ export class AppServerGraphRuntime {
     createId = randomUUID,
     onEvent = null,
     evolutionCompositionFactory = null,
+    skillOutcomeIndex = null,
+    skillVectorAuthority = null,
     writerLeaseTtlMs = 24 * 60 * 60 * 1000,
   } = {}) {
     if (typeof executeNode !== "function") {
@@ -165,6 +171,21 @@ export class AppServerGraphRuntime {
     this.createId = createId;
     this.onEvent = typeof onEvent === "function" ? onEvent : null;
     this.evolutionCompositionFactory = evolutionCompositionFactory;
+    this.skillOutcomeIndex =
+      skillOutcomeIndex === null
+        ? null
+        : captureAgentSkillOutcomeIndex(skillOutcomeIndex);
+    this.skillVectorAuthority =
+      skillVectorAuthority === null
+        ? null
+        : captureSkillVectorAuthority(skillVectorAuthority);
+    if (
+      this.skillOutcomeIndex !== null &&
+      this.skillVectorAuthority !== null &&
+      this.skillOutcomeIndex.tenantId !== this.skillVectorAuthority.tenantId
+    ) {
+      throw new TypeError("Graph retrieval authorities must share one tenant");
+    }
     this.writerLeaseTtlMs = writerLeaseTtlMs;
     this.runs = new Map();
     this.drives = new Map();
@@ -190,6 +211,22 @@ export class AppServerGraphRuntime {
               "Agent evolution composition belongs to another Graph run",
             );
           }
+          if (
+            this.skillOutcomeIndex !== null &&
+            composition.tenantId !== this.skillOutcomeIndex.tenantId
+          ) {
+            throw new TypeError(
+              "Graph evolution composition and Skill outcome index must share one tenant",
+            );
+          }
+          if (
+            this.skillVectorAuthority !== null &&
+            composition.tenantId !== this.skillVectorAuthority.tenantId
+          ) {
+            throw new TypeError(
+              "Graph evolution composition and Skill vector authority must share one tenant",
+            );
+          }
           if (
             typeof composition.evolutionIngress?.start !== "function" ||
             typeof composition.evolutionIngress?.complete !== "function"
@@ -693,6 +730,8 @@ export class AppServerGraphRuntime {
         input: nodeInput(entry.inputs, nodeId),
         signal: controller.signal,
         evolutionIngress: evolutionComposition?.evolutionIngress || null,
+        skillOutcomeIndex: this.skillOutcomeIndex,
+        skillVectorAuthority: this.skillVectorAuthority,
       });
       if (!result || !["succeeded", "completed"].includes(result.status)) {
         const error = runtimeError(