@animalabs/agent-framework 0.6.6 → 0.6.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animalabs/agent-framework",
-  "version": "0.6.6",
+  "version": "0.6.8",
   "description": "Multi-agent framework with pluggable modules, persistent state, and concurrent tool execution",
   "repository": {
     "type": "git",
@@ -21,10 +21,12 @@
     "src"
   ],
   "bin": {
-    "agent-framework-mcp": "./dist/src/api/mcp-server.js"
+    "agent-framework-mcp": "./dist/src/api/mcp-server.js",
+    "agent-framework-recover": "./dist/src/recovery/recover-cli.js"
   },
   "scripts": {
     "build": "tsc",
+    "postbuild": "node -e \"const fs=require('node:fs'); for (const p of ['dist/src/api/mcp-server.js','dist/src/recovery/recover-cli.js']) fs.chmodSync(p, 0o755)\"",
     "dev": "tsc --watch",
     "clean": "rm -rf dist",
     "typecheck": "tsc --noEmit",
@@ -44,7 +46,7 @@
   "license": "MIT",
   "dependencies": {
     "@animalabs/chronicle": "^0.2.2",
-    "@animalabs/context-manager": "^0.5.11",
+    "@animalabs/context-manager": "^0.5.13",
     "@animalabs/membrane": "^0.5.73",
     "chokidar": "^4.0.3",
     "discord.js": "^14.25.1",

package/src/agent.ts

@@ -17,6 +17,8 @@ import type {
 import type {
   AgentConfig,
   AgentState,
+  SameRoundThinkTextPolicy,
+  SameRoundThinkTextPolicySource,
   PendingToolCall,
   CompletedToolCall,
   ToolCallId,
@@ -33,6 +35,7 @@ import type {
 
 const DEFAULT_CONTEXT_BUDGET_TOKENS = 100_000;
 const DEFAULT_TRANSITION_PACE_TOKENS = 16_000;
+const DEFAULT_SAME_ROUND_THINK_TEXT_POLICY: SameRoundThinkTextPolicy = 'public';
 
 /**
  * An agent wraps a context manager and manages inference state.
@@ -63,6 +66,7 @@ export class Agent {
   readonly cacheTtl: NonNullable<AgentConfig['cacheTtl']>;
   /** Provider-specific request parameters forwarded unchanged by Membrane. */
   readonly providerParams?: Record<string, unknown>;
+  readonly sameRoundThinkTextPolicy: AgentConfig['sameRoundThinkTextPolicy'];
 
   private _state: AgentState = { status: 'idle' };
   private _inferenceStartedAt = 0;
@@ -76,6 +80,7 @@ export class Agent {
   private readonly configuredContextBudgetTokens?: number;
   private readonly configuredTailTokens?: number;
   private readonly configuredTransitionPaceTokens?: number;
+  private readonly configuredSameRoundThinkTextPolicy?: SameRoundThinkTextPolicy;
   private contextBudgetTargetTokens?: number;
   private runtimeSettingsOverrides: AgentRuntimeSettingsOverrides = {};
   private contextManager: ContextManager;
@@ -97,6 +102,7 @@ export class Agent {
     this.refusalHandling = config.refusalHandling;
     this.cacheTtl = config.cacheTtl ?? '1h';
     this.providerParams = config.providerParams;
+    this.sameRoundThinkTextPolicy = config.sameRoundThinkTextPolicy;
     this.maxStreamTokens = config.maxStreamTokens ?? 150_000;
     this.contextBudgetTokens = config.contextBudgetTokens;
     this.configuredContextBudgetTokens = config.contextBudgetTokens;
@@ -105,6 +111,7 @@ export class Agent {
     const hot = this.getHotContextSettings();
     this.configuredTailTokens = hot?.tailTokens;
     this.configuredTransitionPaceTokens = hot?.transitionPaceTokens;
+    this.configuredSameRoundThinkTextPolicy = config.sameRoundThinkTextPolicy;
   }
 
   /**
@@ -202,6 +209,8 @@ export class Agent {
       ...(hot?.transitionPaceTokens !== undefined
         ? { transitionPaceTokens: hot.transitionPaceTokens }
         : {}),
+      sameRoundThinkTextPolicy: this.getEffectiveSameRoundThinkTextPolicy(),
+      sameRoundThinkTextPolicySource: this.getSameRoundThinkTextPolicySource(),
       transition: this.contextBudgetTargetTokens === undefined
         ? 'stable'
         : hot?.blocked
@@ -219,6 +228,22 @@ export class Agent {
     return { ...this.runtimeSettingsOverrides };
   }
 
+  getEffectiveSameRoundThinkTextPolicy(): SameRoundThinkTextPolicy {
+    return this.runtimeSettingsOverrides.sameRoundThinkTextPolicy
+      ?? this.configuredSameRoundThinkTextPolicy
+      ?? DEFAULT_SAME_ROUND_THINK_TEXT_POLICY;
+  }
+
+  getSameRoundThinkTextPolicySource(): SameRoundThinkTextPolicySource {
+    if (this.runtimeSettingsOverrides.sameRoundThinkTextPolicy !== undefined) {
+      return 'runtime_override';
+    }
+    if (this.configuredSameRoundThinkTextPolicy !== undefined) {
+      return 'recipe';
+    }
+    return 'compatibility_default';
+  }
+
   updateRuntimeSettings(patch: AgentRuntimeSettingsPatch): AgentRuntimeSettingsSnapshot {
     this.validateRuntimeSettingsPatch(patch);
     let nextContextBudget = this.contextBudgetTokens;
@@ -263,13 +288,17 @@ export class Agent {
       this.runtimeSettingsOverrides.transitionPaceTokens = DEFAULT_TRANSITION_PACE_TOKENS;
     }
     for (const [key, value] of Object.entries(patch)) {
-      if (value !== undefined) (this.runtimeSettingsOverrides as Record<string, number>)[key] = value;
+      if (key === 'sameRoundThinkTextPolicy') continue;
+      if (value !== undefined) (this.runtimeSettingsOverrides as Record<string, unknown>)[key] = value;
+    }
+    if (patch.sameRoundThinkTextPolicy !== undefined) {
+      this.runtimeSettingsOverrides.sameRoundThinkTextPolicy = patch.sameRoundThinkTextPolicy;
     }
     return this.getRuntimeSettings();
   }
 
   resetRuntimeSettings(keys?: Array<keyof AgentRuntimeSettingsPatch>): AgentRuntimeSettingsSnapshot {
-    const reset = new Set(keys ?? ['contextBudgetTokens', 'tailTokens', 'transitionPaceTokens']);
+    const reset = new Set(keys ?? ['contextBudgetTokens', 'tailTokens', 'transitionPaceTokens', 'sameRoundThinkTextPolicy']);
     let nextContextBudget = this.contextBudgetTokens;
     let nextContextTarget = this.contextBudgetTargetTokens;
     const hotPatch: {
@@ -312,6 +341,9 @@ export class Agent {
     if (reset.has('transitionPaceTokens')) {
       delete this.runtimeSettingsOverrides.transitionPaceTokens;
     }
+    if (reset.has('sameRoundThinkTextPolicy')) {
+      delete this.runtimeSettingsOverrides.sameRoundThinkTextPolicy;
+    }
     return this.getRuntimeSettings();
   }
 
@@ -348,6 +380,11 @@ export class Agent {
         (!Number.isSafeInteger(patch.transitionPaceTokens) || patch.transitionPaceTokens <= 0)) {
       throw new Error('transitionPaceTokens must be a positive safe integer');
     }
+    if (patch.sameRoundThinkTextPolicy !== undefined &&
+        patch.sameRoundThinkTextPolicy !== 'public' &&
+        patch.sameRoundThinkTextPolicy !== 'private') {
+      throw new Error("sameRoundThinkTextPolicy must be 'public' or 'private'");
+    }
     if ((patch.tailTokens !== undefined || patch.transitionPaceTokens !== undefined) &&
         !this.getHotContextSettings()) {
       throw new Error('The active context strategy does not support live tail/transition settings');

package/src/api/server.ts

@@ -468,6 +468,10 @@ export class ApiServer {
     store.switchBranch(params.name);
     this.currentBranch = params.name;
 
+    // Reversible Discord awareness markers are part of the branch projection.
+    // Do not acknowledge the switch until add/remove operations were attempted.
+    await this.framework.syncDiscordAwarenessMarkers();
+
     // Materialize config files from the new branch
     const ws = this.framework.getModule('workspace');
     if (ws && 'materializeMount' in ws) {
@@ -511,7 +515,7 @@ export class ApiServer {
   // Undo/Redo Commands
   // ==========================================================================
 
-  private cmdUndo(params: { agentName: string }): unknown {
+  private async cmdUndo(params: { agentName: string }): Promise<unknown> {
     if (!params.agentName) {
       throw new Error('agentName is required');
     }
@@ -520,6 +524,7 @@ export class ApiServer {
 
     if (result.undone) {
       this.currentBranch = result.toBranch!;
+      await this.framework.syncDiscordAwarenessMarkers();
       this.broadcast('branch:switched', {
         from: result.fromBranch,
         to: result.toBranch,
@@ -530,7 +535,7 @@ export class ApiServer {
     return result;
   }
 
-  private cmdRedo(params: { agentName: string }): unknown {
+  private async cmdRedo(params: { agentName: string }): Promise<unknown> {
     if (!params.agentName) {
       throw new Error('agentName is required');
     }
@@ -539,6 +544,7 @@ export class ApiServer {
 
     if (result.redone) {
       this.currentBranch = result.toBranch!;
+      await this.framework.syncDiscordAwarenessMarkers();
       this.broadcast('branch:switched', {
         from: result.fromBranch,
         to: result.toBranch,