@mindot/will 0.9.0 → 0.10.0

package/dist/{mcp → surface/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-DbDj_TEH.js';
+import { E as EffectorHandler, W as Will } from '../../will-evj9_vrd.js';
 
 /** Where the tools live: spawn a local server, reach a remote one, or bring a connected client. */
 type McpToolsSource = {

package/dist/{mcp → surface/mcp}/effectors.js

@@ -2,8 +2,7 @@ import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StdioClientTransport, getDefaultEnvironment } from '@modelcontextprotocol/sdk/client/stdio.js';
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
 
-// src/mcp/effectors.ts
-var RESULT_DESCRIPTION_CAP = 700;
+// src/surface/mcp/effectors.ts
 var MEANING_CAP = 300;
 function describeMcpTool(tool) {
   const props = tool.inputSchema?.properties ?? {};
@@ -31,8 +30,15 @@ function buildMcpHandler(client, tool) {
     try {
       const res = await client.callTool({ name: tool.name, arguments: filtered });
       const text = (res.content ?? []).filter((c) => c.type === "text" && typeof c.text === "string").map((c) => c.text).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)}\u2026` : text;
-      return { success: !res.isError, description: bounded };
+      return {
+        success: !res.isError,
+        description: res.isError ? `${tool.name} reported an error.` : `${tool.name} ran.`,
+        // Whatever it said — including what it said when it failed. An error
+        // message is information about the world too, and cutting it or folding
+        // it into the fate is how a mind ends up knowing that something went
+        // wrong without ever learning what.
+        observation: text
+      };
     } catch (err) {
       return { success: false, description: `${tool.name} failed: ${err instanceof Error ? err.message : String(err)}` };
     }

package/dist/surface/mcp/effectors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/surface/mcp/effectors.ts"],"names":[],"mappings":"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","file":"effectors.js","sourcesContent":["// ─────────────────────────────────────────────────────────────\n// src/surface/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 '#surface/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 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      // The tool's output is what the act REVEALED, so it goes to `observation`\n      // and it goes WHOLE (SIGNAL_BOUNDARY P2). It used to be crammed into\n      // `description` and cut at 700 — a number nobody chose, deciding on the\n      // mind's behalf how much of an answer it was allowed to have, and doing\n      // it at the boundary where that was the only copy.\n      //\n      // `description` now carries what it is for: how the call went. Short by\n      // nature, because a fate is short.\n      return {\n        success:     !res.isError,\n        description: res.isError ? `${ tool.name } reported an error.` : `${ tool.name } ran.`,\n        // Whatever it said — including what it said when it failed. An error\n        // message is information about the world too, and cutting it or folding\n        // it into the fate is how a mind ends up knowing that something went\n        // wrong without ever learning what.\n        observation: text,\n      }\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"]}