@mindot/will 0.5.0 → 0.7.0

package/dist/mcp/effectors.d.ts

@@ -1,5 +1,5 @@
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { E as EffectorHandler, W as Will } from '../will-BDq-TMQr.js';
+import { E as EffectorHandler, W as Will } from '../will-DAW0l-lY.js';
 
 /** Where the tools live: spawn a local server, reach a remote one, or bring a connected client. */
 type McpToolsSource = {

package/dist/mcp/effectors.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/mcp/effectors.ts"],"names":[],"mappings":"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","file":"effectors.js","sourcesContent":["// ─────────────────────────────────────────────────────────────\n// src/mcp/effectors.ts — a Will EMPLOYING MCP tools (Seam 1)\n// ─────────────────────────────────────────────────────────────\n//\n// The other direction from server.ts: connect a Will to an external MCP server\n// and register that server's tools as the Will's own ABILITIES. Each tool\n// becomes a learnable affordance — its description (plus a compact hint of the\n// arguments it takes) is the ability's meaning, surfaced to the executive and\n// the deliberator; the WILL decides when to enact one (nothing here dispatches);\n// the tool's result feeds back through reafference, so the Will gets *skilled*\n// at the tools it uses.\n//\n// Arguments come from conscious intent: the executive supplies them via an\n// action's `args`, which ride the ideomotor leg into the invocation (see\n// executive commands.ts). A tool with required arguments enacted habitually\n// (without args) fails informatively — reafference then teaches the Will that\n// this ability wants deliberate articulation.\n//\n//   const { names, close } = await connectMcpEffectors( will, {\n//     command: 'npx', args: [ '-y', '@modelcontextprotocol/server-filesystem', '/tmp' ],\n//   } )\n//\n// Import from '@mindot/will/mcp' — kept off the main entry so non-MCP\n// consumers never load the MCP SDK.\n// ─────────────────────────────────────────────────────────────\n\nimport { Client } from '@modelcontextprotocol/sdk/client/index.js'\nimport { StdioClientTransport, getDefaultEnvironment } from '@modelcontextprotocol/sdk/client/stdio.js'\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'\nimport type { Will, EffectorHandler, EffectorResult } from '#sdk/will'\n\n/** Where the tools live: spawn a local server, reach a remote one, or bring a connected client. */\nexport type McpToolsSource =\n  | { command: string; args?: string[]; env?: Record<string, string> }\n  | { url: string }\n  | { client: Client }\n\nexport interface McpEffectorsOptions {\n  /** Intrinsic effort prior 0..1 seeded on every bridged ability (default 0.2). */\n  cost?: number\n  /** Prefix for the ability names (e.g. 'fs_') — avoids collisions across servers. */\n  prefix?: string\n}\n\n/** Minimal structural view of an MCP tool (the SDK's zod-inferred type, loosened). */\nexport interface McpToolInfo {\n  name:         string\n  description?: string\n  inputSchema?: {\n    type?:       string\n    properties?: Record<string, { type?: string; description?: string }>\n    required?:   string[]\n  }\n}\n\n/** Keep tool outcomes bounded — the description feeds reafference + episodic memory. */\nconst RESULT_DESCRIPTION_CAP = 700\n/** Keep ability meanings bounded — they render into the executive prompt. */\nconst MEANING_CAP = 300\n\n/**\n * The ability's *meaning*: the tool's description plus a compact hint of the\n * arguments it takes — so the executive knows what to supply in an action's\n * `args` when it enacts this ability.\n */\nexport function describeMcpTool( tool: McpToolInfo ): string {\n  const props    = tool.inputSchema?.properties ?? {}\n  const required = new Set( tool.inputSchema?.required ?? [] )\n  const argHints = Object.entries( props ).map( ( [ key, p ] ) =>\n    `${ key }${ required.has( key ) ? '' : '?' }${ p.description ? `: ${ p.description }` : '' }` )\n\n  const base = ( tool.description ?? `The ${ tool.name } tool.` ).trim().replace( /\\s+/g, ' ' )\n  const hint = argHints.length > 0 ? ` (args — ${ argHints.join( '; ' ) })` : ''\n  const full = `${ base }${ hint }`\n  return full.length > MEANING_CAP ? `${ full.slice( 0, MEANING_CAP - 1 ) }…` : full\n}\n\n/**\n * The effector handler for one bridged tool: checks required args (an ability\n * enacted without its needed articulation fails informatively — reafference\n * learns from it), calls the tool, and maps the result onto EffectorResult.\n */\nexport function buildMcpHandler( client: Client, tool: McpToolInfo ): EffectorHandler {\n  return async ( args ): Promise<EffectorResult> => {\n    const props = tool.inputSchema?.properties\n    // Only pass keys the tool declares — invocation params can carry situation\n    // extras (targetEntityName, learned priors) the tool never asked for.\n    const filtered: Record<string, unknown> = {}\n    for( const [ k, v ] of Object.entries( args ?? {} ) )\n      if( !props || k in props ) filtered[ k ] = v\n\n    const missing = ( tool.inputSchema?.required ?? [] ).filter(\n      k => filtered[ k ] === undefined || filtered[ k ] === '' )\n    if( missing.length > 0 )\n      return {\n        success: false,\n        description: `${ tool.name } needs ${ missing.join( ', ' ) } — enact it deliberately, supplying them in the action's args.`,\n      }\n\n    try {\n      const res  = await client.callTool( { name: tool.name, arguments: filtered } ) as\n        { content?: Array<{ type: string; text?: string }>; isError?: boolean }\n      const text = ( res.content ?? [] )\n        .filter( c => c.type === 'text' && typeof c.text === 'string' )\n        .map( c => c.text as string )\n        .join( '\\n' )\n        .trim() || ( res.isError ? 'The tool reported an error.' : 'Done (no output).' )\n      const bounded = text.length > RESULT_DESCRIPTION_CAP ? `${ text.slice( 0, RESULT_DESCRIPTION_CAP - 1 ) }…` : text\n      return { success: !res.isError, description: bounded }\n    }\n    catch( err ){\n      return { success: false, description: `${ tool.name } failed: ${ err instanceof Error ? err.message : String( err ) }` }\n    }\n  }\n}\n\nasync function connect( source: McpToolsSource ): Promise<{ client: Client; owned: boolean }> {\n  if( 'client' in source ) return { client: source.client, owned: false }\n\n  const client = new Client( { name: 'mindot-will', version: '0' } )\n  if( 'url' in source )\n    await client.connect( new StreamableHTTPClientTransport( new URL( source.url ) ) )\n  else\n    await client.connect( new StdioClientTransport( {\n      command: source.command,\n      ...( source.args ? { args: source.args } : {} ),\n      // Merge over the SDK's safe default env so PATH etc. survive a custom env.\n      env: { ...getDefaultEnvironment(), ...( source.env ?? {} ) },\n    } ) )\n  return { client, owned: true }\n}\n\n/**\n * Register an MCP server's tools as the Will's abilities. Returns the ability\n * names registered and a `close()` for the connection (call it when the Will\n * stops; a client passed in via `source.client` is left open).\n */\nexport async function connectMcpEffectors(\n  will:   Will,\n  source: McpToolsSource,\n  opts:   McpEffectorsOptions = {},\n): Promise<{ names: string[]; close: () => Promise<void> }> {\n  const { client, owned } = await connect( source )\n  const { tools } = await client.listTools() as unknown as { tools: McpToolInfo[] }\n\n  const names: string[] = []\n  for( const tool of tools ){\n    const name = `${ opts.prefix ?? '' }${ tool.name }`\n    will.effector( name, {\n      description: describeMcpTool( tool ),\n      cost:        opts.cost ?? 0.2,\n      tags:        [ 'mcp' ],\n      handler:     buildMcpHandler( client, tool ),\n    } )\n    names.push( name )\n  }\n\n  return { names, close: async () => { if( owned ) await client.close() } }\n}\n"]}
+{"version":3,"sources":["../../src/mcp/effectors.ts"],"names":[],"mappings":"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","file":"effectors.js","sourcesContent":["// ─────────────────────────────────────────────────────────────\n// src/mcp/effectors.ts — a Will EMPLOYING MCP tools (Seam 1)\n// ─────────────────────────────────────────────────────────────\n//\n// The other direction from server.ts: connect a Will to an external MCP server\n// and register that server's tools as the Will's own ABILITIES. Each tool\n// becomes a learnable affordance — its description (plus a compact hint of the\n// arguments it takes) is the ability's meaning, surfaced to the executive and\n// the deliberator; the WILL decides when to enact one (nothing here dispatches);\n// the tool's result feeds back through reafference, so the Will gets *skilled*\n// at the tools it uses.\n//\n// Arguments come from conscious intent: the executive supplies them via an\n// action's `args`, which ride the ideomotor leg into the invocation (see\n// executive commands.ts). A tool with required arguments enacted habitually\n// (without args) fails informatively — reafference then teaches the Will that\n// this ability wants deliberate articulation.\n//\n//   const { names, close } = await connectMcpEffectors( will, {\n//     command: 'npx', args: [ '-y', '@modelcontextprotocol/server-filesystem', '/tmp' ],\n//   } )\n//\n// Import from '@mindot/will/mcp' — kept off the main entry so non-MCP\n// consumers never load the MCP SDK.\n// ─────────────────────────────────────────────────────────────\n\nimport { Client } from '@modelcontextprotocol/sdk/client/index.js'\nimport { StdioClientTransport, getDefaultEnvironment } from '@modelcontextprotocol/sdk/client/stdio.js'\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'\nimport type { Will, EffectorHandler, EffectorResult } from '#sdk/will'\n\n/** Where the tools live: spawn a local server, reach a remote one, or bring a connected client. */\nexport type McpToolsSource =\n  | { command: string; args?: string[]; env?: Record<string, string> }\n  | { url: string }\n  | { client: Client }\n\nexport interface McpEffectorsOptions {\n  /** Intrinsic effort prior 0..1 seeded on every bridged ability (default 0.2). */\n  cost?: number\n  /** Prefix for the ability names (e.g. 'fs_') — avoids collisions across servers. */\n  prefix?: string\n}\n\n/** Minimal structural view of an MCP tool (the SDK's zod-inferred type, loosened). */\nexport interface McpToolInfo {\n  name:         string\n  description?: string\n  inputSchema?: {\n    type?:       string\n    properties?: Record<string, { type?: string; description?: string }>\n    required?:   string[]\n  }\n}\n\n/** Keep tool outcomes bounded — the description feeds reafference + episodic memory. */\nconst RESULT_DESCRIPTION_CAP = 700\n/** Keep ability meanings bounded — they render into the executive prompt. */\nconst MEANING_CAP = 300\n\n/**\n * The ability's *meaning*: the tool's description plus a compact hint of the\n * arguments it takes — so the executive knows what to supply in an action's\n * `args` when it enacts this ability.\n */\nexport function describeMcpTool( tool: McpToolInfo ): string {\n  const props    = tool.inputSchema?.properties ?? {}\n  const required = new Set( tool.inputSchema?.required ?? [] )\n  const argHints = Object.entries( props ).map( ( [ key, p ] ) =>\n    `${ key }${ required.has( key ) ? '' : '?' }${ p.description ? `: ${ p.description }` : '' }`)\n\n  const base = ( tool.description ?? `The ${ tool.name } tool.`).trim().replace( /\\s+/g, ' ')\n  const hint = argHints.length > 0 ? ` (args — ${ argHints.join('; ') })` : ''\n  const full = `${ base }${ hint }`\n  return full.length > MEANING_CAP ? `${ full.slice( 0, MEANING_CAP - 1 ) }…` : full\n}\n\n/**\n * The effector handler for one bridged tool: checks required args (an ability\n * enacted without its needed articulation fails informatively — reafference\n * learns from it), calls the tool, and maps the result onto EffectorResult.\n */\nexport function buildMcpHandler( client: Client, tool: McpToolInfo ): EffectorHandler {\n  return async ( args ): Promise<EffectorResult> => {\n    const props = tool.inputSchema?.properties\n    // Only pass keys the tool declares — invocation params can carry situation\n    // extras (targetEntityName, learned priors) the tool never asked for.\n    const filtered: Record<string, unknown> = {}\n    for( const [ k, v ] of Object.entries( args ?? {} ) )\n      if( !props || k in props ) filtered[ k ] = v\n\n    const missing = ( tool.inputSchema?.required ?? [] ).filter(\n      k => filtered[ k ] === undefined || filtered[ k ] === '')\n    if( missing.length > 0 )\n      return {\n        success: false,\n        description: `${ tool.name } needs ${ missing.join(', ') } — enact it deliberately, supplying them in the action's args.`,\n      }\n\n    try {\n      const res  = await client.callTool( { name: tool.name, arguments: filtered } ) as\n        { content?: Array<{ type: string; text?: string }>; isError?: boolean }\n      const text = ( res.content ?? [] )\n        .filter( c => c.type === 'text' && typeof c.text === 'string')\n        .map( c => c.text as string )\n        .join('\\n')\n        .trim() || ( res.isError ? 'The tool reported an error.' : 'Done (no output).')\n      const bounded = text.length > RESULT_DESCRIPTION_CAP ? `${ text.slice( 0, RESULT_DESCRIPTION_CAP - 1 ) }…` : text\n      return { success: !res.isError, description: bounded }\n    }\n    catch( err ){\n      return { success: false, description: `${ tool.name } failed: ${ err instanceof Error ? err.message : String( err ) }` }\n    }\n  }\n}\n\nasync function connect( source: McpToolsSource ): Promise<{ client: Client; owned: boolean }> {\n  if('client' in source ) return { client: source.client, owned: false }\n\n  const client = new Client( { name: 'mindot-will', version: '0' } )\n  if('url' in source )\n    await client.connect( new StreamableHTTPClientTransport( new URL( source.url ) ) )\n  else\n    await client.connect( new StdioClientTransport( {\n      command: source.command,\n      ...( source.args ? { args: source.args } : {} ),\n      // Merge over the SDK's safe default env so PATH etc. survive a custom env.\n      env: { ...getDefaultEnvironment(), ...( source.env ?? {} ) },\n    } ) )\n  return { client, owned: true }\n}\n\n/**\n * Register an MCP server's tools as the Will's abilities. Returns the ability\n * names registered and a `close()` for the connection (call it when the Will\n * stops; a client passed in via `source.client` is left open).\n */\nexport async function connectMcpEffectors(\n  will:   Will,\n  source: McpToolsSource,\n  opts:   McpEffectorsOptions = {},\n): Promise<{ names: string[]; close: () => Promise<void> }> {\n  const { client, owned } = await connect( source )\n  const { tools } = await client.listTools() as unknown as { tools: McpToolInfo[] }\n\n  const names: string[] = []\n  for( const tool of tools ){\n    const name = `${ opts.prefix ?? '' }${ tool.name }`\n    will.effector( name, {\n      description: describeMcpTool( tool ),\n      cost:        opts.cost ?? 0.2,\n      tags:        [ 'mcp' ],\n      handler:     buildMcpHandler( client, tool ),\n    } )\n    names.push( name )\n  }\n\n  return { names, close: async () => { if( owned ) await client.close() } }\n}\n"]}

package/dist/{will-BDq-TMQr.d.ts → will-DAW0l-lY.d.ts}

@@ -3347,6 +3347,8 @@ declare class AttentionAllocator implements SimulationEngine, CognitiveEngine {
     private _effort;
     /** A one-shot focus/rest request from the executive, applied next react(). */
     private _effortRequest;
+    /** ACP-P2: a self-caused precision attenuation is armed; react() restores after one observe. */
+    private _acpOneShot;
     private _bus;
     private readonly _model;
     constructor(config?: AttentionAllocatorConfig);
@@ -3435,6 +3437,8 @@ declare class StressRegulator implements SimulationEngine, CognitiveEngine {
     subscribes(): string[];
     publishes(): CognitiveEventSchema[];
     onCognitiveEvent(e: CognitiveEvent): StateCommands | void;
+    /** ACP-P2: self-caused stress attenuation armed; react() restores after one observe. */
+    private _acpOneShot;
     snapshot(): Record<string, unknown>;
     react(delta: Duration, _tick: Tick, state: ReadonlySimulationState, context: SimulationContext): Promise<EngineResult>;
     private _readConfigFromState;
@@ -3549,6 +3553,28 @@ declare class Exteroception implements SimulationEngine, CognitiveEngine {
      * Generate a meaningful summary for an entity.
      * Instead of "New percept: percept-54-0", produce something useful.
      */
+    /**
+     * The text the corollary-discharge matcher inspects for this entity — its
+     * content (a message body) over its description over its summary. Where our
+     * own delivered words would surface if the world echoes them back.
+     */
+    /**
+     * The affect→percept valence seam (registry #5). A percept carries how the
+     * mind *feels* about what it is a percept OF, resolved most-specific-first:
+     *
+     *   1. the KnownEntityTracker's dossier for this entity (`ke-<id>.valence`) —
+     *      a real per-entity felt valence, the honest signal;
+     *   2. otherwise the ambient `affect.valence` — the felt tone at perception
+     *      time. Weaker evidence, so it is tagged `'ambient'` and consumers
+     *      weight it down (mood is context, not appraisal of this thing).
+     *
+     * Absent both, no valence is stamped and every consumer keeps its
+     * pre-seam behaviour.
+     */
+    /** Spread-friendly form of `_valenceFor` for percept construction. */
+    private _valenceOf;
+    private _valenceFor;
+    private _matchText;
     private _summarizeEntity;
     /**
      * Compute salience of a percept based on entity characteristics.
@@ -4263,6 +4289,8 @@ declare class AffectiveBlender implements SimulationEngine, CognitiveEngine {
     private _previousPAD;
     private _emotionHistory;
     private _moodBaseline;
+    /** ACP-P2: self-caused arousal attenuation armed; react() restores after one observe. */
+    private _acpOneShot;
     private _energyLevel;
     private _comfort;
     private _sleepPressure;
@@ -5451,25 +5479,25 @@ declare class AccessGrants {
 declare class VisionEngine extends ShellSenseEngine {
     readonly name = "vision-engine";
     readonly domain: "vision";
-    protected readonly acceptedKinds: Set<"text" | "system" | "voice" | "image" | "video" | "webhook" | "ambient" | "background" | "self-eval" | "assessment">;
+    protected readonly acceptedKinds: Set<"text" | "system" | "ambient" | "voice" | "image" | "video" | "webhook" | "background" | "self-eval" | "assessment">;
 }
 
 declare class SomatosensationEngine extends ShellSenseEngine {
     readonly name = "somatosensation-engine";
     readonly domain: "somatosensation";
-    protected readonly acceptedKinds: Set<"text" | "system" | "voice" | "image" | "video" | "webhook" | "ambient" | "background" | "self-eval" | "assessment">;
+    protected readonly acceptedKinds: Set<"text" | "system" | "ambient" | "voice" | "image" | "video" | "webhook" | "background" | "self-eval" | "assessment">;
 }
 
 declare class OlfactionEngine extends ShellSenseEngine {
     readonly name = "olfaction-engine";
     readonly domain: "olfaction";
-    protected readonly acceptedKinds: Set<"text" | "system" | "voice" | "image" | "video" | "webhook" | "ambient" | "background" | "self-eval" | "assessment">;
+    protected readonly acceptedKinds: Set<"text" | "system" | "ambient" | "voice" | "image" | "video" | "webhook" | "background" | "self-eval" | "assessment">;
 }
 
 declare class GustationEngine extends ShellSenseEngine {
     readonly name = "gustation-engine";
     readonly domain: "gustation";
-    protected readonly acceptedKinds: Set<"text" | "system" | "voice" | "image" | "video" | "webhook" | "ambient" | "background" | "self-eval" | "assessment">;
+    protected readonly acceptedKinds: Set<"text" | "system" | "ambient" | "voice" | "image" | "video" | "webhook" | "background" | "self-eval" | "assessment">;
 }
 
 /**
@@ -5639,7 +5667,7 @@ declare class AuditionEngine extends BaseSenseEngine {
     readonly name = "audition-engine";
     readonly domain: "audition";
     /** Audition consumes language input; the base filters every other kind out. */
-    protected readonly acceptedKinds: Set<"text" | "system" | "voice" | "image" | "video" | "webhook" | "ambient" | "background" | "self-eval" | "assessment">;
+    protected readonly acceptedKinds: Set<"text" | "system" | "ambient" | "voice" | "image" | "video" | "webhook" | "background" | "self-eval" | "assessment">;
     /** Inbound is gated on the 'listen' effector — the base enforces it before _perceive(). */
     protected readonly gateEffector = "listen";
     private _executiveEngine;
@@ -5998,6 +6026,9 @@ declare class SchemaRepertoire {
     private _skills;
     /** Tracks which templates were learned at runtime (vs innate) so decay can forget them. */
     private _learned;
+    /** Availability layer (P2): schema → { value 0..1, lastRefusedTick }. Empty until
+     *  a refusal lands — a never-refused Will writes nothing here (byte-identical). */
+    private _availability;
     constructor(seed?: MotorSchema[]);
     schemas(): MotorSchema[];
     getSchema(id: string): MotorSchema | undefined;
@@ -6012,6 +6043,23 @@ declare class SchemaRepertoire {
     registerExternal(schema: MotorSchema): void;
     skills(): ReadonlyMap<string, LearnedSkill>;
     getSkill(id: string): LearnedSkill | undefined;
+    availability(): ReadonlyMap<string, {
+        value: number;
+        lastRefusedTick: number;
+    }>;
+    /**
+     * How available a schema is right now, 0..1. Absent from the ledger ⇒ 1
+     * (fully available — the common case). This is the ONLY value the
+     * AffordanceSynthesizer reads; it never touches competence.
+     */
+    availabilityOf(schema: string): number;
+    /**
+     * Fold a policy refusal into the availability layer (NOT competence). A
+     * `class` refusal cuts availability hard; an `instance` refusal dents it
+     * lightly. Multiplicative so repeated refusals compound toward — but never
+     * reach — zero, keeping re-probe alive.
+     */
+    recordRefusal(schema: string, finality: 'class' | 'instance', tick: number): number;
     /**
      * Fold one outcome into the schema's learned skill. Returns the updated skill
      * and whether it just crossed the proceduralization threshold this update.
@@ -6021,11 +6069,16 @@ declare class SchemaRepertoire {
         proceduralized: boolean;
     };
     /**
-     * Forgetting curve over the competence layer. Skills unused for IDLE_TICKS
-     * lose habit; learned composites that fall below DROP_HABIT are dropped
-     * entirely (template + skill). Returns the schema ids that were forgotten.
+     * Forgetting curve over the competence layer, plus availability recovery.
+     * Skills unused for IDLE_TICKS lose habit; learned composites below DROP_HABIT
+     * are dropped entirely (template + skill). Availability entries climb back
+     * toward 1 and are dropped once fully recovered. Returns the ids that were
+     * removed from each layer so their mirrored state entities can be deleted.
      */
-    decay(tick: number): string[];
+    decay(tick: number): {
+        skills: string[];
+        availability: string[];
+    };
     /** Learned composite templates + all skills above a confidence floor. */
     export(minHabit?: number): {
         composites: MotorSchema[];
@@ -6045,6 +6098,12 @@ declare class SchemaRepertoire {
      * Mirrors GoalManager._syncFromStateGoals.
      */
     restoreComposites(entities: ReadonlySimulationState['entities']): void;
+    /** Availability ledger encoded as `agency.availability` state entities (P2).
+     *  Empty until a refusal lands, so the quiet path writes nothing. */
+    availabilityEntities(): EntityInput[];
+    /** Rehydrate the availability ledger from state after a restore. Idempotent;
+     *  keeps whichever value is more restrictive so a concurrent refusal isn't lost. */
+    restoreAvailability(entities: ReadonlySimulationState['entities']): void;
 }
 
 type SkillAccessor = () => ReadonlyMap<string, LearnedSkill>;
@@ -6085,11 +6144,25 @@ declare class ActionSelector implements CognitiveEngine {
     private _bus;
     private _lastEntropy;
     private _lastDeliberate;
+    private _lastRevoked;
+    private _senseBuffer;
     attachBus(bus: CognitiveBus): void;
     publishes(): CognitiveEventSchema[];
     subscribes(): string[];
-    onCognitiveEvent(): void;
+    /**
+     * Mostly pull-model — but two afferent classes never become entities and
+     * would leave rupture blind: sense-channel percepts
+     * (ACTION_CONDITIONED_PREDICTION §2b) and the model-error state-change
+     * events (registry #6). Buffer both (cross-tick: bus flush at T, consumed
+     * by react at T+1 — FN9-snapshotted); the echo guard is applied at read
+     * time for texts, and at the SOURCE for model errors (ACP-P2 precision).
+     */
+    onCognitiveEvent(e: CognitiveEvent): void;
     snapshot(): Record<string, unknown>;
+    /** FN9: `_lastRevoked` has behavioral effect (the Channel-B `revokedBy` stamp),
+     *  so a restored mind must carry it — a rupture-driven letting-go survives a
+     *  snapshot boundary instead of silently losing its narrative thread. */
+    restore(s: Record<string, unknown>): void;
     react(_delta: Duration, tick: Tick, state: ReadonlySimulationState, _context: SimulationContext): Promise<EngineResult>;
 }
 
@@ -7653,6 +7726,13 @@ declare class WillStem {
         description: string;
         metrics?: Record<string, number>;
     }): void;
+    /**
+     * Resolve a policy escalation the Will raised (POLICY_REAFFERENCE P4).
+     * `approved` dispatches the held invocation to the world; otherwise it is
+     * refused. Applied at the next tick boundary. `invocationId` is the awaiting
+     * `agency.intent` id the escalation ask referenced.
+     */
+    resolveEscalation(id: string, invocationId: string, approved: boolean): void;
     /**
      * Confirm a message was received by the target entity. Writes a
      * message.delivery percept ("ear hears the word you spoke") and updates the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindot/will",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "author": "Fabrice <fabrice8@github.com>",
   "repository": {
     "type": "git",

package/src/channels/discord.ts

@@ -84,8 +84,8 @@ export interface DiscordBridgeOptions {
  * itself is not stopped; it simply loses this surface.
  */
 export async function connectDiscord( will: Will, opts: DiscordBridgeOptions ): Promise<ChannelBridge> {
-  const log     = opts.log ?? ( ( m: string ) => console.error( `[will:discord] ${ m }` ) )
-  const roster  = new ChannelRoster( opts.rosterPath ?? `.will/${ will.id }.discord.json` )
+  const log     = opts.log ?? ( ( m: string ) => console.error(`[will:discord] ${ m }`) )
+  const roster  = new ChannelRoster( opts.rosterPath ?? `.will/${ will.id }.discord.json`)
   const allowed = opts.channels?.length ? new Set( opts.channels ) : null
 
   const client = opts.client ?? await createDiscordClient()
@@ -94,7 +94,7 @@ export async function connectDiscord( will: Will, opts: DiscordBridgeOptions ):
   let lastActiveChannelId: string | null = opts.homeChannelId ?? null
 
   // ── inbound: platform message → stimulus ──────────────────────────────────
-  client.on( 'messageCreate', message => { void onMessage( message ) } )
+  client.on('messageCreate', message => { void onMessage( message ) } )
 
   async function onMessage( message: DiscordLikeMessage ): Promise<void> {
     const self = client.user
@@ -135,7 +135,7 @@ export async function connectDiscord( will: Will, opts: DiscordBridgeOptions ):
   // ── outbound: projected utterance → the addressee ─────────────────────────
   // The facade has no off(); the bridge gates its handler on `closed` instead.
   let closed = false
-  will.on( 'message', ( m: WillMessage ) => { if( !closed ) void deliver( m ) } )
+  will.on('message', ( m: WillMessage ) => { if( !closed ) void deliver( m ) } )
 
   async function deliver( m: WillMessage ): Promise<void> {
     const peer = m.to ? roster.resolve( m.to ) : undefined
@@ -161,7 +161,7 @@ export async function connectDiscord( will: Will, opts: DiscordBridgeOptions ):
       }
       catch { /* fall through */ }
     }
-    log( `no route for utterance to '${ m.to }' — dropped (${ m.content.length } chars)` )
+    log(`no route for utterance to '${ m.to }' — dropped (${ m.content.length } chars)`)
   }
 
   // ── lifecycle ──────────────────────────────────────────────────────────────
@@ -175,14 +175,14 @@ export async function connectDiscord( will: Will, opts: DiscordBridgeOptions ):
         const ready = new Promise<void>( resolve => {
           let poll: ReturnType<typeof setInterval> | null = null
           const done = (): void => { if( poll ) clearInterval( poll ); resolve() }
-          client.once( 'clientReady', done )
+          client.once('clientReady', done )
           poll = setInterval( () => { if( client.isReady?.() ) done() }, 100 )
           poll.unref?.()
         } )
-        await client.login( opts.token ?? '' )
+        await client.login( opts.token ?? '')
         await ready
       }
-      log( `${ will.name } is present on Discord as user ${ client.user?.id }` )
+      log(`${ will.name } is present on Discord as user ${ client.user?.id }`)
     },
     async close(): Promise<void> {
       if( closed ) return
@@ -196,10 +196,10 @@ export async function connectDiscord( will: Will, opts: DiscordBridgeOptions ):
 
 /** Build a real discord.js client (lazy import keeps it out of non-Discord hosts). */
 async function createDiscordClient(): Promise<DiscordLikeClient> {
-  let mod: typeof import( 'discord.js' )
-  try { mod = await import( 'discord.js' ) }
+  let mod: typeof import('discord.js')
+  try { mod = await import('discord.js') }
   catch {
-    throw new Error( 'discord.js is not installed (it is an optionalDependency) — run `bun add discord.js` / `npm i discord.js` and retry.' )
+    throw new Error('discord.js is not installed (it is an optionalDependency) — run `bun add discord.js` / `npm i discord.js` and retry.')
   }
   const { Client, GatewayIntentBits, Partials } = mod
   return new Client( {

package/src/channels/roster.ts

@@ -42,7 +42,7 @@ export class ChannelRoster {
   constructor( private readonly path: string ) {
     if( existsSync( path ) ){
       try {
-        const raw = JSON.parse( readFileSync( path, 'utf8' ) ) as RosterEntry[]
+        const raw = JSON.parse( readFileSync( path, 'utf8') ) as RosterEntry[]
         for( const e of Array.isArray( raw ) ? raw : [] ) this.entries.set( e.entityId, e )
       }
       catch { /* a corrupt roster is not worth failing a boot over — start fresh */ }

package/src/channels/types.ts

@@ -36,7 +36,7 @@ export function chunkText( text: string, max: number ): string[] {
   while( rest.length > max ){
     // Prefer a paragraph break, then a line break, then a space — else hard-cut.
     const window = rest.slice( 0, max )
-    const cut = Math.max( window.lastIndexOf( '\n\n' ), window.lastIndexOf( '\n' ), window.lastIndexOf( ' ' ) )
+    const cut = Math.max( window.lastIndexOf('\n\n'), window.lastIndexOf('\n'), window.lastIndexOf(' ') )
     const at = cut > max * 0.5 ? cut : max
     chunks.push( rest.slice( 0, at ).trimEnd() )
     rest = rest.slice( at ).trimStart()

package/src/channels/whatsapp.ts

@@ -82,10 +82,10 @@ export interface WhatsAppBridgeOptions {
 
 // ── Helpers ──────────────────────────────────────────────────────────────────
 
-const isGroupJid = ( jid: string ): boolean => jid.endsWith( '@g.us' )
+const isGroupJid = ( jid: string ): boolean => jid.endsWith('@g.us')
 
 /** '4915123:7@s.whatsapp.net' → '4915123' (device + server stripped). */
-const bareId = ( jid: string ): string => jid.split( '@' )[0]!.split( ':' )[0]!
+const bareId = ( jid: string ): string => jid.split('@')[0]!.split(':')[0]!
 
 /** A DM jid is derivable from the bare number — WhatsApp's gift to proactivity. */
 const dmJidFor = ( userId: string ): string => `${ userId }@s.whatsapp.net`
@@ -108,8 +108,8 @@ function textOf( m: WaLikeMessage ): string {
  * `ChannelBridge.close()` — the Will keeps ticking; it only loses this surface.
  */
 export async function connectWhatsApp( will: Will, opts: WhatsAppBridgeOptions = {} ): Promise<ChannelBridge> {
-  const log     = opts.log ?? ( ( m: string ) => console.error( `[will:whatsapp] ${ m }` ) )
-  const roster  = new ChannelRoster( opts.rosterPath ?? `.will/${ will.id }.whatsapp.json` )
+  const log     = opts.log ?? ( ( m: string ) => console.error(`[will:whatsapp] ${ m }`) )
+  const roster  = new ChannelRoster( opts.rosterPath ?? `.will/${ will.id }.whatsapp.json`)
   const allowed = opts.chats?.length ? new Set( opts.chats ) : null
 
   let closed = false
@@ -123,15 +123,15 @@ export async function connectWhatsApp( will: Will, opts: WhatsAppBridgeOptions =
   let lastActiveChatId: string | null = opts.homeChatId ?? null
 
   // ── inbound: platform message → stimulus ──────────────────────────────────
-  socket.ev.on( 'messages.upsert', ( { messages, type } ) => {
-    if( type && type !== 'notify' ) return   // history sync/corrections are not new percepts
+  socket.ev.on('messages.upsert', ( { messages, type } ) => {
+    if( type && type !== 'notify') return   // history sync/corrections are not new percepts
     for( const m of messages ) void onMessage( m )
   } )
 
   async function onMessage( m: WaLikeMessage ): Promise<void> {
     const jid = m.key.remoteJid
     if( !jid || m.key.fromMe || !m.message || m.messageStubType ) return
-    if( jid.endsWith( '@broadcast' ) || jid.endsWith( '@newsletter' ) ) return   // stories/broadcasts aren't a room the Will is in
+    if( jid.endsWith('@broadcast') || jid.endsWith('@newsletter') ) return   // stories/broadcasts aren't a room the Will is in
     if( allowed && !allowed.has( jid ) ) return
 
     const isGroup   = isGroupJid( jid )
@@ -157,7 +157,7 @@ export async function connectWhatsApp( will: Will, opts: WhatsAppBridgeOptions =
 
     // Same rule as Discord: a presence cue only when addressed — the mind may
     // still choose silence, and 'composing' expires on its own.
-    if( addressed ) await socket.sendPresenceUpdate?.( 'composing', jid ).catch( () => {} )
+    if( addressed ) await socket.sendPresenceUpdate?.('composing', jid ).catch( () => {} )
 
     const text = textOf( m )
     if( !text.trim() ) return
@@ -171,7 +171,7 @@ export async function connectWhatsApp( will: Will, opts: WhatsAppBridgeOptions =
   }
 
   // ── outbound: projected utterance → the addressee ─────────────────────────
-  will.on( 'message', ( m: WillMessage ) => { if( !closed ) void deliver( m ) } )
+  will.on('message', ( m: WillMessage ) => { if( !closed ) void deliver( m ) } )
 
   async function deliver( m: WillMessage ): Promise<void> {
     const peer   = m.to ? roster.resolve( m.to ) : undefined
@@ -180,7 +180,7 @@ export async function connectWhatsApp( will: Will, opts: WhatsAppBridgeOptions =
     // Last shared group → known DM → DM derived from the entity id itself →
     // home chat → last active chat. Unlike Discord, an unmet-but-addressed
     // entity is still reachable: `whatsapp:<number>` implies its DM jid.
-    const derivedDm = m.to?.startsWith( 'whatsapp:' ) ? dmJidFor( m.to.slice( 'whatsapp:'.length ) ) : undefined
+    const derivedDm = m.to?.startsWith('whatsapp:') ? dmJidFor( m.to.slice('whatsapp:'.length ) ) : undefined
     const targets = [ peer?.lastChannelId, peer?.dmChannelId, derivedDm, opts.homeChatId ?? undefined, lastActiveChatId ?? undefined ]
     for( const jid of targets ){
       if( !jid ) continue
@@ -190,7 +190,7 @@ export async function connectWhatsApp( will: Will, opts: WhatsAppBridgeOptions =
       }
       catch { /* try the next route */ }
     }
-    log( `no route for utterance to '${ m.to }' — dropped (${ m.content.length } chars)` )
+    log(`no route for utterance to '${ m.to }' — dropped (${ m.content.length } chars)`)
   }
 
   // ── lifecycle ──────────────────────────────────────────────────────────────
@@ -199,7 +199,7 @@ export async function connectWhatsApp( will: Will, opts: WhatsAppBridgeOptions =
     async start(): Promise<void> {
       // createWhatsAppSocket resolves already-open; an injected socket is the
       // caller's to have readied.
-      log( `${ will.name } is present on WhatsApp${ socket.user ? ` as ${ bareId( socket.user.id ) }` : '' }` )
+      log(`${ will.name } is present on WhatsApp${ socket.user ? ` as ${ bareId( socket.user.id ) }` : '' }`)
     },
     async close(): Promise<void> {
       if( closed ) return
@@ -226,10 +226,10 @@ interface SocketFactoryOpts {
  * Resolves once the first connection is open (after QR pairing on first run).
  */
 async function createWhatsAppSocket( o: SocketFactoryOpts ): Promise<WaLikeSocket> {
-  let baileys: typeof import( 'baileys' )
-  try { baileys = await import( 'baileys' ) }
+  let baileys: typeof import('baileys')
+  try { baileys = await import('baileys') }
   catch {
-    throw new Error( 'baileys is not installed (it is an optionalDependency) — run `bun add baileys` / `npm i baileys` and retry.' )
+    throw new Error('baileys is not installed (it is an optionalDependency) — run `bun add baileys` / `npm i baileys` and retry.')
   }
   const { default: makeWASocket, useMultiFileAuthState, DisconnectReason } = baileys
 
@@ -252,7 +252,7 @@ async function createWhatsAppSocket( o: SocketFactoryOpts ): Promise<WaLikeSocke
     get user(){ return inner?.user ? { id: inner.user.id, name: inner.user.name ?? undefined } : null },
     ev: { on: ( _e, fn ) => { subscribers.push( fn ) } },
     sendMessage: ( jid, content ) => {
-      if( !inner ) return Promise.reject( new Error( 'whatsapp socket not connected' ) )
+      if( !inner ) return Promise.reject( new Error('whatsapp socket not connected') )
       return inner.sendMessage( jid, content )
     },
     sendPresenceUpdate: ( state, jid ) => inner?.sendPresenceUpdate( state, jid ) ?? Promise.resolve(),
@@ -268,10 +268,10 @@ async function createWhatsAppSocket( o: SocketFactoryOpts ): Promise<WaLikeSocke
       const sock = makeWASocket( { auth: state, logger: logger as never } )
       inner = sock
 
-      sock.ev.on( 'creds.update', saveCreds )
-      sock.ev.on( 'messages.upsert', u => { for( const fn of subscribers ) fn( u as never ) } )
+      sock.ev.on('creds.update', saveCreds )
+      sock.ev.on('messages.upsert', u => { for( const fn of subscribers ) fn( u as never ) } )
 
-      sock.ev.on( 'connection.update', update => {
+      sock.ev.on('connection.update', update => {
         const { connection, lastDisconnect, qr } = update as {
           connection?: string; lastDisconnect?: { error?: unknown }; qr?: string
         }
@@ -282,16 +282,16 @@ async function createWhatsAppSocket( o: SocketFactoryOpts ): Promise<WaLikeSocke
           opened = true
           resolveOpen()
         }
-        if( connection === 'close' ){
+        if( connection === 'close'){
           const code = ( lastDisconnect?.error as { output?: { statusCode?: number } } | undefined )?.output?.statusCode
           if( code === DisconnectReason.loggedOut ){
-            const err = new Error( 'WhatsApp unlinked this device (logged out) — delete the auth dir and pair again.' )
+            const err = new Error('WhatsApp unlinked this device (logged out) — delete the auth dir and pair again.')
             o.log( err.message )
             if( !opened ) rejectOpen( err )
             return
           }
           if( o.stillOpen() ){
-            o.log( `connection closed (status ${ code ?? '?' }) — reconnecting…` )
+            o.log(`connection closed (status ${ code ?? '?' }) — reconnecting…`)
             setTimeout( connect, 3_000 )
           }
         }
@@ -306,13 +306,13 @@ async function createWhatsAppSocket( o: SocketFactoryOpts ): Promise<WaLikeSocke
 
 /** QR to the terminal; falls back to the raw pairing string if the tiny renderer is absent. */
 async function printQr( qr: string, log: ( m: string ) => void ): Promise<void> {
-  log( 'pair this device: WhatsApp → Settings → Linked devices → Link a device' )
+  log('pair this device: WhatsApp → Settings → Linked devices → Link a device')
   try {
     type QrModule = { generate( s: string, o: { small: boolean } ): void }
-    const qrt = ( await import( 'qrcode-terminal' as string ) ) as QrModule & { default?: QrModule }
+    const qrt = ( await import('qrcode-terminal' as string ) ) as QrModule & { default?: QrModule }
     ;( qrt.default ?? qrt ).generate( qr, { small: true } )
   }
   catch {
-    log( `qrcode-terminal not installed — raw pairing code:\n${ qr }` )
+    log(`qrcode-terminal not installed — raw pairing code:\n${ qr }`)
   }
 }

package/src/cli.ts

@@ -50,74 +50,74 @@ its PMA artifact.`
 async function main(): Promise<void> {
   const sub = process.argv[2]
 
-  if( sub !== 'mcp' && sub !== 'serve' && sub !== 'discord' && sub !== 'whatsapp' ){
+  if( sub !== 'mcp' && sub !== 'serve' && sub !== 'discord' && sub !== 'whatsapp'){
     console.error( sub ? `unknown subcommand: ${ sub }\n\n${ USAGE }` : USAGE )
     process.exit( sub ? 2 : 0 )
   }
 
   // Fail on missing platform credentials BEFORE raising a mind.
   if( sub === 'discord' && !process.env.DISCORD_BOT_TOKEN ){
-    console.error( '[will] DISCORD_BOT_TOKEN is required for `will discord` — create a bot at https://discord.com/developers/applications (enable the Message Content intent) and set the token.' )
+    console.error('[will] DISCORD_BOT_TOKEN is required for `will discord` — create a bot at https://discord.com/developers/applications (enable the Message Content intent) and set the token.')
     process.exit( 2 )
   }
 
   const { will, name, pmaPath, tickMs, anatomy, onCleanup, shutdown } = await bootWillFromEnv()
 
-  if( sub === 'mcp' ){
+  if( sub === 'mcp'){
     // The MCP client owns our stdin — its disconnect is the shutdown signal.
-    process.stdin.on( 'end', () => void shutdown( 'client disconnected' ) )
+    process.stdin.on('end', () => void shutdown('client disconnected') )
     const server = buildWillMcpServer( will, { pmaPath } )
     await server.connect( new StdioServerTransport() )
-    console.error( `[will] ${ name } is listening on MCP stdio (tick ${ tickMs }ms, anatomy ${ anatomy })` )
+    console.error(`[will] ${ name } is listening on MCP stdio (tick ${ tickMs }ms, anatomy ${ anatomy })`)
     return
   }
 
-  if( sub === 'discord' ){
-    const csv = ( v?: string ) => v?.split( ',' ).map( s => s.trim() ).filter( Boolean )
+  if( sub === 'discord'){
+    const csv = ( v?: string ) => v?.split(',').map( s => s.trim() ).filter( Boolean )
     const bridge = await connectDiscord( will, {
       token:         process.env.DISCORD_BOT_TOKEN!,
       channels:      csv( process.env.WILL_DISCORD_CHANNELS ),
-      mentionOnly:   /^(1|true|yes)$/i.test( process.env.WILL_DISCORD_MENTION_ONLY ?? '' ),
+      mentionOnly:   /^(1|true|yes)$/i.test( process.env.WILL_DISCORD_MENTION_ONLY ?? ''),
       homeChannelId: process.env.WILL_DISCORD_HOME_CHANNEL,
-      rosterPath:    pmaPath.replace( /(\.pma)?\.json$/, '' ) + '.discord.json',
+      rosterPath:    pmaPath.replace( /(\.pma)?\.json$/, '') + '.discord.json',
     } )
     onCleanup( () => bridge.close() )
     await bridge.start()
-    console.error( `[will] ${ name } is present on Discord (tick ${ tickMs }ms, anatomy ${ anatomy }) — it speaks when it decides to.` )
+    console.error(`[will] ${ name } is present on Discord (tick ${ tickMs }ms, anatomy ${ anatomy }) — it speaks when it decides to.`)
     return
   }
 
-  if( sub === 'whatsapp' ){
-    const csv = ( v?: string ) => v?.split( ',' ).map( s => s.trim() ).filter( Boolean )
-    const stem = pmaPath.replace( /(\.pma)?\.json$/, '' )
+  if( sub === 'whatsapp'){
+    const csv = ( v?: string ) => v?.split(',').map( s => s.trim() ).filter( Boolean )
+    const stem = pmaPath.replace( /(\.pma)?\.json$/, '')
     // connectWhatsApp blocks here on first run until the printed QR is scanned.
     const bridge = await connectWhatsApp( will, {
       chats:       csv( process.env.WILL_WHATSAPP_CHATS ),
-      mentionOnly: /^(1|true|yes)$/i.test( process.env.WILL_WHATSAPP_MENTION_ONLY ?? '' ),
+      mentionOnly: /^(1|true|yes)$/i.test( process.env.WILL_WHATSAPP_MENTION_ONLY ?? ''),
       homeChatId:  process.env.WILL_WHATSAPP_HOME_CHAT,
       authPath:    stem + '.wa-auth',
       rosterPath:  stem + '.whatsapp.json',
     } )
     onCleanup( () => bridge.close() )
     await bridge.start()
-    console.error( `[will] ${ name } is present on WhatsApp (tick ${ tickMs }ms, anatomy ${ anatomy }) — it speaks when it decides to.` )
+    console.error(`[will] ${ name } is present on WhatsApp (tick ${ tickMs }ms, anatomy ${ anatomy }) — it speaks when it decides to.`)
     return
   }
 
   // serve — the HTTP sidecar.
-  const port = parseInt( process.env.WILL_PORT ?? '7777' )
+  const port = parseInt( process.env.WILL_PORT ?? '7777')
   const host = process.env.WILL_HOST ?? '127.0.0.1'
   const server = buildWillHttpServer( will, { pmaPath } )
   onCleanup( () => new Promise<void>( r => server.close( () => r() ) ) )
   await new Promise<void>( ( resolve, reject ) => {
-    server.once( 'error', reject )
+    server.once('error', reject )
     server.listen( port, host, () => resolve() )
   } )
-  console.error( `[will] ${ name } is listening on http://${ host }:${ port } (tick ${ tickMs }ms, anatomy ${ anatomy })` )
-  console.error( `[will] try: curl -X POST http://${ host }:${ port }/perceive -H 'content-type: application/json' -d '{"text":"Hello"}'` )
+  console.error(`[will] ${ name } is listening on http://${ host }:${ port } (tick ${ tickMs }ms, anatomy ${ anatomy })`)
+  console.error(`[will] try: curl -X POST http://${ host }:${ port }/perceive -H 'content-type: application/json' -d '{"text":"Hello"}'`)
 }
 
 main().catch( e => {
-  console.error( `[will] fatal: ${ e instanceof Error ? e.stack ?? e.message : String( e ) }` )
+  console.error(`[will] fatal: ${ e instanceof Error ? e.stack ?? e.message : String( e ) }`)
   process.exit( 1 )
 } )