@mindot/will 0.4.0 → 0.6.0

package/src/llm/index.ts

@@ -12,7 +12,68 @@ import type { LLMCompletionRecord } from '#core/completion.recorder'
 import { withGate } from '#llm/gate'
 import { matchConversationFocus, wrapReplyText } from '#llm/wire.contracts'
 
-export type LLMProvider = 'anthropic' | 'deepseek' | 'openai' | 'google'
+export type LLMProvider = 'anthropic' | 'glm' | 'deepseek' | 'openai' | 'google'
+
+/**
+ * Providers that speak the Anthropic Messages wire.
+ *
+ * Z.ai ships a real Anthropic-compatible endpoint for GLM — it is what Claude
+ * Code itself targets — so GLM rides this path rather than the OpenAI scaffold.
+ * That buys it everything the path already has: token streaming, the first-byte
+ * deadline, prompt-cache breakpoints, and the structured-output contract. GLM is
+ * therefore a second *production* provider, not a fifth scaffold.
+ */
+const ANTHROPIC_WIRE = new Set<LLMProvider>( [ 'anthropic', 'glm' ] )
+
+/** Does this provider accept Anthropic-shaped requests? */
+export function speaksAnthropicWire( provider: LLMProvider ): boolean {
+  return ANTHROPIC_WIRE.has( provider )
+}
+
+/** Official API base URL (including version segment) for a provider. */
+export function defaultBaseFor( provider: LLMProvider ): string {
+  switch( provider ){
+    case 'anthropic': return 'https://api.anthropic.com/v1'
+    // Z.ai documents the base as `…/api/anthropic` because the Anthropic SDK
+    // appends `/v1/messages`; this client appends `/messages`, so the version
+    // segment belongs here — verified against the live endpoint.
+    case 'glm':       return 'https://api.z.ai/api/anthropic/v1'
+    case 'openai':    return 'https://api.openai.com/v1'
+    case 'deepseek':  return 'https://api.deepseek.com/v1'
+    case 'google':    return 'https://generativelanguage.googleapis.com/v1beta'
+  }
+}
+
+/**
+ * The model the executive recruits when none is pinned.
+ *
+ * Provider-specific because the default is *sent* — a GLM Will with no
+ * `WILL_LLM_MODEL` would otherwise ask Z.ai for a Claude id and get a 404 it
+ * could do nothing with. The scaffolded providers (openai/deepseek/google) keep
+ * today's value: they need an explicit `WILL_LLM_MODEL` to work at all, and
+ * inventing ids for them here would look like support that does not exist.
+ */
+export function defaultModelFor( provider: LLMProvider ): string {
+  return provider === 'glm' ? 'glm-5.2' : 'claude-sonnet-4-5-20250929'
+}
+
+/**
+ * Auth + version headers for the Anthropic wire.
+ *
+ * Anthropic authenticates with `x-api-key`. Z.ai's compat endpoint accepts
+ * either that or the `Authorization: Bearer` its own docs describe (both were
+ * probed against the live endpoint; each is read and validated). GLM sends both
+ * — same secret, same host — so the mind keeps working whichever one Z.ai
+ * eventually settles on.
+ */
+export function anthropicWireHeaders( provider: LLMProvider, apiKey: string ): Record<string, string> {
+  return {
+    'Content-Type':      'application/json',
+    'anthropic-version': '2023-06-01',
+    'x-api-key':         apiKey,
+    ...( provider === 'glm' ? { Authorization: `Bearer ${ apiKey }` } : {} ),
+  }
+}
 export interface LLMDirectorConfig {
   willId: string
   model: string
@@ -126,7 +187,7 @@ export class LLMDirector {
    *   {"actions":[{"type":"...","reasoning":"...","expectedOutcome":"..."}],...}
    *   Strategy 1 (JSON.parse) handles this directly.
    */
-  private _mockResponse( tick: number, userMessage: string = '' ): LLMCallResult {
+  private _mockResponse( tick: number, userMessage: string = ''): LLMCallResult {
     // ── Conversation facet turn ────────────────────────────────
     // Detect the AuditionEngine facet focus via the SHARED contract (see
     // llm/wire.contracts.ts) — the render/match pair whose earlier drift
@@ -216,7 +277,7 @@ export class LLMDirector {
       return result
     }
 
-    const result = this._provider === 'anthropic'
+    const result = speaksAnthropicWire( this._provider )
       ? await this._callAnthropicStream( systemPrompt, userMessage, onChunk, temperature )
       : await ( async () => {
           // Other providers: fall back to regular call, emit whole response as one chunk
@@ -328,11 +389,7 @@ export class LLMDirector {
     try {
       res = await fetch(`${this._resolvedBase()}/messages`, {
         method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          'anthropic-version': '2023-06-01',
-          'x-api-key': this._apiKey,
-        },
+        headers: anthropicWireHeaders( this._provider, this._apiKey ),
         body: JSON.stringify({
           model:      this._model,
           max_tokens: this._maxOutputTokens,
@@ -347,7 +404,7 @@ export class LLMDirector {
     catch( err ){
       clearTimeout( timer )
       if( controller.signal.aborted )
-        throw new Error( `LLM stream to ${this._provider} timed out after ${this._timeoutMs}ms (no response)` )
+        throw new Error(`LLM stream to ${this._provider} timed out after ${this._timeoutMs}ms (no response)`)
       throw err
     }
 
@@ -377,7 +434,7 @@ export class LLMDirector {
         for( const line of lines ){
           if( !line.startsWith('data: ') ) continue
           const raw = line.slice(6).trim()
-          if( raw === '[DONE]' ) break
+          if( raw === '[DONE]') break
 
           try {
             const ev = JSON.parse( raw ) as {
@@ -438,13 +495,14 @@ export class LLMDirector {
       return result
     }
 
-    // Anthropic routes through the streaming path so the deadline is first-byte
-    // (TTFT), not whole-request: a long-but-healthy executive completion (often
-    // 20–40s on Sonnet) no longer trips the timeout mid-generation. onChunk is a
-    // no-op here — call() returns the full accumulated text; live token chunks go
-    // through callStream(). Other providers keep the whole-request deadline.
+    // The Anthropic-wire providers route through the streaming path so the
+    // deadline is first-byte (TTFT), not whole-request: a long-but-healthy
+    // executive completion (often 20–40s on Sonnet) no longer trips the timeout
+    // mid-generation. onChunk is a no-op here — call() returns the full
+    // accumulated text; live token chunks go through callStream(). Other
+    // providers keep the whole-request deadline.
     const result = await withGate(
-      () => this._provider === 'anthropic'
+      () => speaksAnthropicWire( this._provider )
         ? this._callAnthropicStream( systemPrompt, userMessage, () => {}, temperature )
         : this._callProvider( systemPrompt, userMessage, temperature ),
       'executive/direct',
@@ -465,6 +523,7 @@ export class LLMDirector {
   ): Promise<LLMCallResult> {
     switch( this._provider ){
       case 'anthropic': return this._callAnthropic( systemPrompt, userMessage, temperature )
+      case 'glm': return this._callAnthropic( systemPrompt, userMessage, temperature )
       case 'deepseek': return this._callOpenAI( systemPrompt, userMessage, temperature )
       case 'openai': return this._callOpenAI( systemPrompt, userMessage, temperature )
       case 'google': return this._callGoogle( systemPrompt, userMessage, temperature )
@@ -474,12 +533,7 @@ export class LLMDirector {
 
   /** Default API base URL (including version segment) for a provider. */
   private _baseFor( provider: LLMProvider ): string {
-    switch( provider ){
-      case 'anthropic': return 'https://api.anthropic.com/v1'
-      case 'openai':    return 'https://api.openai.com/v1'
-      case 'deepseek':  return 'https://api.deepseek.com/v1'
-      case 'google':    return 'https://generativelanguage.googleapis.com/v1beta'
-    }
+    return defaultBaseFor( provider )
   }
 
   /** Resolved API base: explicit override wins, else the provider default. */
@@ -498,8 +552,8 @@ export class LLMDirector {
     }
     catch( err ){
       // AbortSignal.timeout rejects with a DOMException named 'TimeoutError'.
-      if( err instanceof Error && err.name === 'TimeoutError' )
-        throw new Error( `LLM request to ${this._provider} timed out after ${this._timeoutMs}ms` )
+      if( err instanceof Error && err.name === 'TimeoutError')
+        throw new Error(`LLM request to ${this._provider} timed out after ${this._timeoutMs}ms`)
       throw err
     }
   }
@@ -526,23 +580,19 @@ export class LLMDirector {
 
     const res = await this._fetchWithTimeout(`${this._resolvedBase()}/messages`, {
       method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'anthropic-version': '2023-06-01',
-        'x-api-key': this._apiKey
-      },
+      headers: anthropicWireHeaders( this._provider, this._apiKey ),
       body: JSON.stringify( body )
     })
 
     if( !res.ok )
-      throw new Error(`Anthropic API ${res.status}: ${( await res.text() ).slice(0, 300)}`)
+      throw new Error(`${this._provider} API ${res.status}: ${( await res.text() ).slice(0, 300)}`)
 
     const
     data = await res.json() as {
       content: Array<{ type: string; text: string }>
       usage: { input_tokens: number; output_tokens: number; cache_read_input_tokens?: number; cache_creation_input_tokens?: number }
     },
-    text = data.content.find( b => b.type === 'text' )?.text ?? ''
+    text = data.content.find( b => b.type === 'text')?.text ?? ''
 
     return {
       text,
@@ -623,7 +673,7 @@ export class LLMDirector {
     }
 
     const text = ( data.candidates?.[ 0 ]?.content?.parts ?? [] )
-      .map( p => p.text ?? '' )
+      .map( p => p.text ?? '')
       .join('')
 
     return {
@@ -665,7 +715,7 @@ export class LLMDirector {
         userMessage,
       ].join('\n')
 
-      const filepath = `${debugDir}/prompt-tick-${String( tick ).padStart( 6, '0' )}.txt`
+      const filepath = `${debugDir}/prompt-tick-${String( tick ).padStart( 6, '0')}.txt`
       writeFileSync( filepath, content )
 
       logger.info(`[executive] Debug prompt written → ${filepath} (~${estimatedTokens} tok estimated)`)
@@ -705,7 +755,7 @@ export class LLMDirector {
         responseText,
       ].join('\n')
 
-      const filepath = `${debugDir}/response-tick-${String( tick ).padStart( 6, '0' )}.txt`
+      const filepath = `${debugDir}/response-tick-${String( tick ).padStart( 6, '0')}.txt`
       writeFileSync( filepath, content )
     }
     catch {

package/src/llm/summarizer.ts

@@ -130,7 +130,7 @@ export class ExecutiveSummarizer {
 
   private async _run(): Promise<void> {
     if( !this._llmDirector ){
-      logger.warn( '[summarizer] skipping — LLMDirector not attached yet' )
+      logger.warn('[summarizer] skipping — LLMDirector not attached yet')
       return
     }
 
@@ -139,8 +139,8 @@ export class ExecutiveSummarizer {
 
     try {
       const userMessage = snapshot
-        .map( ( r, i ) => `[Cycle ${i + 1}]\n${r}` )
-        .join( '\n\n---\n\n' )
+        .map( ( r, i ) => `[Cycle ${i + 1}]\n${r}`)
+        .join('\n\n---\n\n')
 
       // Use _callCount as the tick value — it's only used for token tracking/logging
       const result = await this._llmDirector.call(
@@ -161,7 +161,7 @@ export class ExecutiveSummarizer {
       }
     }
     catch( err ){
-      logger.warn( '[summarizer] failed:', err instanceof Error ? err.message : err )
+      logger.warn('[summarizer] failed:', err instanceof Error ? err.message : err )
     }
     finally {
       this._summarizing = false

package/src/llm/wire.contracts.ts

@@ -36,7 +36,7 @@ export const REPLY_TEXT_CLOSE = `[/${REPLY_TEXT_TAG}]`
 
 /** Wrap a reply body in the block markers (the mock's emission shape). */
 export function wrapReplyText( body: string ): string {
-  return [ REPLY_TEXT_OPEN, body, REPLY_TEXT_CLOSE ].join( '\n' )
+  return [ REPLY_TEXT_OPEN, body, REPLY_TEXT_CLOSE ].join('\n')
 }
 
 // ── Conversation-facet focus — render ↔ match pair ────────────

package/src/mcp/effectors.ts

@@ -67,10 +67,10 @@ export function describeMcpTool( tool: McpToolInfo ): string {
   const props    = tool.inputSchema?.properties ?? {}
   const required = new Set( tool.inputSchema?.required ?? [] )
   const argHints = Object.entries( props ).map( ( [ key, p ] ) =>
-    `${ key }${ required.has( key ) ? '' : '?' }${ p.description ? `: ${ p.description }` : '' }` )
+    `${ key }${ required.has( key ) ? '' : '?' }${ p.description ? `: ${ p.description }` : '' }`)
 
-  const base = ( tool.description ?? `The ${ tool.name } tool.` ).trim().replace( /\s+/g, ' ' )
-  const hint = argHints.length > 0 ? ` (args — ${ argHints.join( '; ' ) })` : ''
+  const base = ( tool.description ?? `The ${ tool.name } tool.`).trim().replace( /\s+/g, ' ')
+  const hint = argHints.length > 0 ? ` (args — ${ argHints.join('; ') })` : ''
   const full = `${ base }${ hint }`
   return full.length > MEANING_CAP ? `${ full.slice( 0, MEANING_CAP - 1 ) }…` : full
 }
@@ -90,21 +90,21 @@ export function buildMcpHandler( client: Client, tool: McpToolInfo ): EffectorHa
       if( !props || k in props ) filtered[ k ] = v
 
     const missing = ( tool.inputSchema?.required ?? [] ).filter(
-      k => filtered[ k ] === undefined || filtered[ k ] === '' )
+      k => filtered[ k ] === undefined || filtered[ k ] === '')
     if( missing.length > 0 )
       return {
         success: false,
-        description: `${ tool.name } needs ${ missing.join( ', ' ) } — enact it deliberately, supplying them in the action's args.`,
+        description: `${ tool.name } needs ${ missing.join(', ') } — enact it deliberately, supplying them in the action's args.`,
       }
 
     try {
       const res  = await client.callTool( { name: tool.name, arguments: filtered } ) as
         { content?: Array<{ type: string; text?: string }>; isError?: boolean }
       const text = ( res.content ?? [] )
-        .filter( c => c.type === 'text' && typeof c.text === 'string' )
+        .filter( c => c.type === 'text' && typeof c.text === 'string')
         .map( c => c.text as string )
-        .join( '\n' )
-        .trim() || ( res.isError ? 'The tool reported an error.' : 'Done (no output).' )
+        .join('\n')
+        .trim() || ( res.isError ? 'The tool reported an error.' : 'Done (no output).')
       const bounded = text.length > RESULT_DESCRIPTION_CAP ? `${ text.slice( 0, RESULT_DESCRIPTION_CAP - 1 ) }…` : text
       return { success: !res.isError, description: bounded }
     }
@@ -115,10 +115,10 @@ export function buildMcpHandler( client: Client, tool: McpToolInfo ): EffectorHa
 }
 
 async function connect( source: McpToolsSource ): Promise<{ client: Client; owned: boolean }> {
-  if( 'client' in source ) return { client: source.client, owned: false }
+  if('client' in source ) return { client: source.client, owned: false }
 
   const client = new Client( { name: 'mindot-will', version: '0' } )
-  if( 'url' in source )
+  if('url' in source )
     await client.connect( new StreamableHTTPClientTransport( new URL( source.url ) ) )
   else
     await client.connect( new StdioClientTransport( {

package/src/mcp/server.ts

@@ -35,7 +35,7 @@ export interface WillMcpOptions {
 function serverVersion(): string {
   // Same relative depth from src/mcp/ and dist/mcp/ — resolves in both.
   try {
-    return JSON.parse( readFileSync( new URL( '../../package.json', import.meta.url ), 'utf8' ) ).version ?? '0.0.0'
+    return JSON.parse( readFileSync( new URL('../../package.json', import.meta.url ), 'utf8') ).version ?? '0.0.0'
   }
   catch { return '0.0.0' }
 }
@@ -54,7 +54,7 @@ export function buildWillMcpServer( will: Will, opts: WillMcpOptions = {} ): Mcp
 
   // ── Tools ─────────────────────────────────────────────────
 
-  server.registerTool( 'perceive', {
+  server.registerTool('perceive', {
     title: 'Perceive',
     description:
       `Deliver a stimulus (something said or observed) into ${ will.name }'s sensory field. ` +
@@ -62,9 +62,9 @@ export function buildWillMcpServer( will: Will, opts: WillMcpOptions = {} ): Mcp
       `NOT when it has responded. Its response — if it chooses to give one — arrives as its next ` +
       `utterance (use the next_utterance tool). Staying silent is a valid choice, not an error.`,
     inputSchema: {
-      text:    z.string().describe( 'What is said or observed.' ),
+      text:    z.string().describe('What is said or observed.'),
       from:    z.string().optional().describe( "Who it's from (entity id, default 'user'). Use a stable id per person." ),
-      speaker: z.string().optional().describe( 'Display name of the speaker.' ),
+      speaker: z.string().optional().describe('Display name of the speaker.'),
     },
   }, async ( { text, from, speaker } ) => {
     await will.perceive( { text, ...( from ? { from } : {} ), ...( speaker ? { speaker } : {} ) } )
@@ -77,15 +77,15 @@ export function buildWillMcpServer( will: Will, opts: WillMcpOptions = {} ): Mcp
     }
   } )
 
-  server.registerTool( 'next_utterance', {
+  server.registerTool('next_utterance', {
     title: 'Next utterance',
     description:
       `Await ${ will.name }'s next spontaneous utterance. Returns what it says next, or reports ` +
       `that it chose silence within the wait window — silence is a real outcome, not a failure. ` +
       `Call after perceive to hear the response, or on its own to listen for unprompted speech.`,
     inputSchema: {
-      within_ms: z.number().optional().describe( 'How long to wait before accepting silence (default 15000, max 120000).' ),
-      from:      z.string().optional().describe( 'Only accept an utterance addressed to this entity id.' ),
+      within_ms: z.number().optional().describe('How long to wait before accepting silence (default 15000, max 120000).'),
+      from:      z.string().optional().describe('Only accept an utterance addressed to this entity id.'),
     },
   }, async ( { within_ms, from } ) => {
     const within = Math.min( Math.max( within_ms ?? 15_000, 100 ), 120_000 )
@@ -101,7 +101,7 @@ export function buildWillMcpServer( will: Will, opts: WillMcpOptions = {} ): Mcp
     }
   } )
 
-  server.registerTool( 'state', {
+  server.registerTool('state', {
     title: 'Inner state',
     description:
       `Read a snapshot of ${ will.name }'s current inner life: tick, body/affect metrics ` +
@@ -112,7 +112,7 @@ export function buildWillMcpServer( will: Will, opts: WillMcpOptions = {} ): Mcp
     { content: [ { type: 'text', text: JSON.stringify( will.state(), null, 2 ) } ] }
   ) )
 
-  server.registerTool( 'save', {
+  server.registerTool('save', {
     title: 'Save (checkpoint)',
     description:
       `Checkpoint ${ will.name } into a portable PMA artifact on disk — non-destructive, it keeps ` +
@@ -130,12 +130,12 @@ export function buildWillMcpServer( will: Will, opts: WillMcpOptions = {} ): Mcp
 
   // ── Resources (read-only projections) ─────────────────────
 
-  server.registerResource( 'state', 'will://state',
+  server.registerResource('state', 'will://state',
     { title: `${ will.name } — inner state`, description: 'Live snapshot of the mind: metrics, goals, beliefs, narrative.', mimeType: 'application/json' },
     async uri => ( { contents: [ { uri: uri.href, mimeType: 'application/json', text: JSON.stringify( will.state(), null, 2 ) } ] } ),
   )
 
-  server.registerResource( 'narrative', 'will://narrative',
+  server.registerResource('narrative', 'will://narrative',
     { title: `${ will.name } — self-narrative`, description: 'The story the mind currently tells about itself.', mimeType: 'text/plain' },
     async uri => ( { contents: [ { uri: uri.href, mimeType: 'text/plain', text: will.state().narrative || '(no narrative formed yet)' } ] } ),
   )

package/src/pma/eval.ts

@@ -368,7 +368,7 @@ export class PMAEvalHarness {
     let loadedTraits: Record<string, number> = {}
 
     for( const entity of state.entities.values() ){
-      if( entity.type === 'will.identity' ){
+      if( entity.type === 'will.identity'){
         loadedTraits = ( entity.metadata?.['traits'] as Record<string, number> ) ?? {}
         break
       }

package/src/pma/index.ts

@@ -345,7 +345,7 @@ export class PMADistiller {
    */
   private _extractPersona( state: SimulationState ): PMASnapshot['persona'] {
     const priorMeta = state.entities.get( PERSONA_PRIOR_ID )?.metadata as { priors?: Record<string, Record<string, number>> } | undefined
-    const calibMeta = state.entities.get( 'calibration-state' )?.metadata as { domainBias?: Record<string, number> } | undefined
+    const calibMeta = state.entities.get('calibration-state')?.metadata as { domainBias?: Record<string, number> } | undefined
 
     const configPriors    = priorMeta?.priors    ?? {}
     const calibrationBias = calibMeta?.domainBias ?? {}
@@ -358,7 +358,7 @@ export class PMADistiller {
 
   private _extractIdentity( state: SimulationState ): PMAIdentity {
     for( const entity of state.entities.values() ){
-      if( entity.type === 'will.identity' ){
+      if( entity.type === 'will.identity'){
         const m = entity.metadata ?? {}
         return {
           prompt:  ( m['prompt']  as string )                     ?? '',
@@ -390,9 +390,9 @@ export class PMADistiller {
     // If socialOrientation not explicitly set, infer from top actions
     if( !enhanced.socialOrientation && behavioral.fingerprint.topActions.length > 0 ){
       const topAction = behavioral.fingerprint.topActions[0] ?? ''
-      if( topAction.includes( 'social' ) || topAction.includes( 'talk' ) || topAction.includes( 'text' ) ){
+      if( topAction.includes('social') || topAction.includes('talk') || topAction.includes('text') ){
         enhanced.socialOrientation = 'gregarious'
-      } else if( topAction.includes( 'reflect' ) || topAction.includes( 'meditate' ) ){
+      } else if( topAction.includes('reflect') || topAction.includes('meditate') ){
         enhanced.socialOrientation = 'reserved'
       } else {
         enhanced.socialOrientation = 'ambivert'
@@ -418,7 +418,7 @@ export class PMADistiller {
     const raw: PMABelief[] = []
 
     for( const entity of state.entities.values() ){
-      if( entity.type !== 'belief' ) continue
+      if( entity.type !== 'belief') continue
 
       const m = entity.metadata ?? {}
       raw.push({
@@ -446,11 +446,11 @@ export class PMADistiller {
     const goals: PMAGoal[] = []
 
     for( const entity of state.entities.values() ){
-      if( entity.type !== 'goal' ) continue
+      if( entity.type !== 'goal') continue
 
       const m      = entity.metadata ?? {}
       const status = ( m['status'] as string ) ?? 'active'
-      if( status !== 'active' && status !== 'in_progress' ) continue
+      if( status !== 'active' && status !== 'in_progress') continue
 
       goals.push({
         id:                  entity.id,
@@ -459,7 +459,7 @@ export class PMADistiller {
         progress:            ( m['progress']            as number   ) ?? 0,
         status,
         tags:                ( m['tags']                as string[] ) ?? [],
-        completionType:      ( m['completionType']      as 'metric' | 'action' | 'epistemic' ) ?? 'epistemic',
+        completionType:      ( m['completionType']      as 'metric' | 'action' | 'epistemic') ?? 'epistemic',
         completionCondition: ( m['completionCondition'] as string   ) ?? undefined,
       })
     }
@@ -475,7 +475,7 @@ export class PMADistiller {
     const digestTick = new Map<string, number>()
 
     for( const entity of state.entities.values() ){
-      if( entity.type === 'attachment.bond' ){
+      if( entity.type === 'attachment.bond'){
         const m       = entity.metadata ?? {}
         const keid = m['keid'] as string | undefined
         if( !keid ) continue
@@ -492,7 +492,7 @@ export class PMADistiller {
         stubs.set( keid, stub )
       }
 
-      else if( entity.type === 'reputation' ){
+      else if( entity.type === 'reputation'){
         const m       = entity.metadata ?? {}
         const keid = m['keid'] as string | undefined
         if( !keid ) continue
@@ -512,7 +512,7 @@ export class PMADistiller {
         stubs.set( keid, stub )
       }
 
-      else if( entity.type === 'theory_of_mind' ){
+      else if( entity.type === 'theory_of_mind'){
         const m       = entity.metadata ?? {}
         const keid = m['keid'] as string | undefined
         if( !keid ) continue
@@ -526,15 +526,15 @@ export class PMADistiller {
         stubs.set( keid, stub )
       }
 
-      else if( entity.type === 'known-entity' ){
+      else if( entity.type === 'known-entity'){
         const m    = entity.metadata ?? {}
         const keid = m['keid'] as string | undefined
         if( !keid ) continue
 
         const stub = stubs.get( keid ) ?? { keid }
-        if( !stub.agentName && typeof m['name'] === 'string' ) stub.agentName = m['name'] as string
+        if( !stub.agentName && typeof m['name'] === 'string') stub.agentName = m['name'] as string
         stub.dossier = {
-          kind:                 ( m['kind']                 as 'sentient' | 'thing' ) ?? 'sentient',
+          kind:                 ( m['kind']                 as 'sentient' | 'thing') ?? 'sentient',
           name:                 ( m['name']                 as string | undefined ),
           familiarity:          ( m['familiarity']          as number ) ?? 0,
           valence:              ( m['valence']              as number ) ?? 0,
@@ -550,7 +550,7 @@ export class PMADistiller {
       // AuditionEngine memory sink + ProactiveCommunicator). The most recent
       // exchange summary wins.
       else if( entity.type === 'episodic_memory'
-            && entity.metadata?.['sourceType'] === 'conversation.exchange' ){
+            && entity.metadata?.['sourceType'] === 'conversation.exchange'){
         const content = ( entity.metadata['content'] as Record<string, unknown> | undefined ) ?? {}
         const keid = content['entityId'] as string | undefined
         if( !keid ) continue
@@ -599,7 +599,7 @@ export class PMADistiller {
       reactivity:          0.5,
     }
 
-    const filePath = join( dataDir, 'wills', willId, 'profiles', 'emotional_biography.jsonl' )
+    const filePath = join( dataDir, 'wills', willId, 'profiles', 'emotional_biography.jsonl')
     if( !existsSync( filePath ) ) return { baseline: defaultBaseline, sessionsRead: 0 }
 
     const summaries = _readLastNSummaries( filePath, 'session_summary', 5 )
@@ -673,7 +673,7 @@ export class PMADistiller {
       impulsivity:      0.3,
     }
 
-    const filePath = join( dataDir, 'wills', willId, 'profiles', 'behavioral.jsonl' )
+    const filePath = join( dataDir, 'wills', willId, 'profiles', 'behavioral.jsonl')
     if( !existsSync( filePath ) ) return { fingerprint: defaultFingerprint, sessionsRead: 0 }
 
     const summaries = _readLastNSummaries( filePath, 'session_summary', 5 )
@@ -860,7 +860,7 @@ export class PMALoader {
 
     // ── 3. Goals ──────────────────────────────────────────────
     for( const g of pma.goals ){
-      if( g.status !== 'active' && g.status !== 'in_progress' ) continue
+      if( g.status !== 'active' && g.status !== 'in_progress') continue
 
       cognition.goalManager.addGoal(
         g.description,
@@ -882,8 +882,8 @@ export class PMALoader {
       pma.emotionalBaseline.arousalProfile === 'calm'        ? 0.30 :
       0.45
 
-    sm.setMetric( 'affect.valence', valence )
-    sm.setMetric( 'affect.arousal', arousal )
+    sm.setMetric('affect.valence', valence )
+    sm.setMetric('affect.arousal', arousal )
 
     // ── 5. Temperament (influences emotional set-point) ───────
     const temperamentValence = pma.emotionalBaseline.temperamentValence
@@ -1068,7 +1068,7 @@ function _readLastNSummaries(
   n:        number
 ): Array<Record<string, unknown>> {
   try {
-    return readFileSync( filePath, 'utf8' )
+    return readFileSync( filePath, 'utf8')
       .split('\n')
       .filter( l => l.trim().length > 0 )
       .map( l => { try { return JSON.parse(l) as Record<string, unknown> } catch { return null } })

package/src/runners/outreach.runner.ts

@@ -111,8 +111,8 @@ async function main(): Promise<void> {
     lastBlocked   = g('agency.communicate.blocked')
 
     if( tick % 10 === 0 ){
-      const goals = [ ...snap.entities.values() ].filter( e => e.type === 'goal' && e.metadata?.status === 'active' ).length
-      const sent  = [ ...snap.entities.values() ].filter( e => e.type === 'conversation.sent' ).length
+      const goals = [ ...snap.entities.values() ].filter( e => e.type === 'goal' && e.metadata?.status === 'active').length
+      const sent  = [ ...snap.entities.values() ].filter( e => e.type === 'conversation.sent').length
       console.log(
         `[t${tick}] v=${g('affect.valence').toFixed(2)} arousal=${g('affect.arousal').toFixed(2)} ` +
         `frust=${g('emotion.frustration').toFixed(2)} energy=${g('energy.level').toFixed(0)} ` +
@@ -130,7 +130,7 @@ async function main(): Promise<void> {
   const startedAt = Date.now()
   while( true ){
     const s = m.listWills().find( w => w.id === WILL_ID )
-    if( !s || s.status === 'archived' ) break
+    if( !s || s.status === 'archived') break
     if( s.tickCount >= END_TICK ) break
     if( sawReactive && sawProactive ){ console.log('\n[scenario] both paths observed — wrapping up'); break }
     if( Date.now() - startedAt > SAFETY_MS ){ console.log('\n[scenario] safety cap hit'); break }

package/src/runners/social.runner.ts

@@ -134,7 +134,7 @@ async function main(): Promise<void> {
 
     // Beliefs the Will formed ABOUT Dr. Chen (social cognition evidence)
     const chenBeliefs = ( ( pma as { beliefs?: Array<{ statement?: string; content?: string }> } ).beliefs ?? [] )
-      .map( b => b.statement ?? b.content ?? '' )
+      .map( b => b.statement ?? b.content ?? '')
       .filter( s => /chen|she|her|researcher|observ/i.test( s ) )
       .slice( 0, 6 )
     if( chenBeliefs.length ){

package/src/runners/thin-shim.runner.ts

@@ -26,7 +26,7 @@ const TICK_MS        = parseInt( process.env.WILL_TICK_MS       ?? '1000')
 const MAX_TICKS      = parseInt( process.env.WILL_MAX_TICKS     ?? '0'    )
 const LOG_INTERVAL   = parseInt( process.env.WILL_LOG_INTERVAL  ?? '10'   )
 const RANDOM_SEED    = parseInt( process.env.WILL_SEED          ?? String( Date.now() ) )
-const ANATOMY        = ( process.env.WILL_ANATOMY ?? 'mind' ) as WillConfig['anatomy']
+const ANATOMY        = ( process.env.WILL_ANATOMY ?? 'mind') as WillConfig['anatomy']
 const EXECUTIVE_INT    = process.env.WILL_EXECUTIVE_INTERVAL
   ? parseInt( process.env.WILL_EXECUTIVE_INTERVAL )
   : undefined