pi-fabric 0.92.29 → 0.92.31

package/README.md

@@ -109,6 +109,7 @@ Pi loads advanced patterns after direct user invocation. Run `/skill:fabric-guid
 | Help choosing the smallest advanced mechanism | `/skill:fabric-guide Choose a mechanism to audit every auth file and verify the findings.` |
 | Parallel audits, migrations, or research with verification | `/skill:fabric-workflow Audit every auth file and synthesize verified findings.` |
 | Work too big for one context window | `/skill:fabric-rlm Produce a compact architecture map of this repo.` |
+| A Jev foreman above coding work, per turn or at settlement | `/skill:fabric-foreman Watch this migration, request verification, and flag blockers.` |
 | A persistent watcher for one measurable goal | `/skill:fabric-supervisor Watch this migration until it is complete and tested.` |
 | A strict auditor for one feature design spec | `/skill:fabric-spec Implement docs/specs/checkout.md to the tee; nothing missing, nothing extra.` |
 | A quiet decision-point reviewer | `/skill:fabric-advisor Focus on migration correctness.` |

package/dist/agents.js

@@ -1,7 +1,7 @@
 import {
   AGENTS_ACTION_DESCRIPTORS,
   normalizeAgentRunRequest
-} from "./chunks/chunk-BYOGRJME.js";
+} from "./chunks/chunk-327VLBDU.js";
 import {
   validateAgentResult
 } from "./chunks/chunk-3QECYQGA.js";
@@ -18,7 +18,7 @@ import {
   waitForAgent
 } from "./chunks/chunk-AYBIR4YV.js";
 import "./chunks/chunk-OTCASLY2.js";
-import "./chunks/chunk-KI277YNS.js";
+import "./chunks/chunk-A4VP7HDF.js";
 import "./chunks/chunk-MGWQOKBV.js";
 import "./chunks/chunk-3H7SDWZI.js";
 

package/dist/chunks/{chunk-BYOGRJME.js → chunk-327VLBDU.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-OTCASLY2.js";
 import {
   aliasThinking
-} from "./chunk-KI277YNS.js";
+} from "./chunk-A4VP7HDF.js";
 import {
   isFabricThinking
 } from "./chunk-MGWQOKBV.js";
@@ -36,7 +36,7 @@ var runProperties = {
   },
   model: {
     type: "string",
-    description: "Pi provider/id, a configured models.aliases name, or a search term resolved to the closest authenticated model (recency from pi-model-sort breaks ties); Claude runtime value or Veda backend model/alias are forwarded verbatim."
+    description: 'Pi provider/id copied from agents.models({ runner: "pi" }), a configured models.aliases name, or a search term resolved to the closest authenticated model (recency from pi-model-sort breaks ties). Reuse returned keys; never infer version numbers from agent names. Exact keys win; near-miss IDs resolve to the closest visible model on the same provider. Handles report the canonical model. Claude runtime value or Veda backend model/alias are forwarded verbatim.'
   },
   persona: {
     type: "string",
@@ -167,7 +167,7 @@ var AGENTS_ACTION_DESCRIPTORS = [
   },
   {
     name: "spawn",
-    description: "Start a child agent through Pi or Claude Code and return a handle immediately. Detached runs send Main a follow-up on terminal completion when agents.notifyOnComplete is enabled; use wait when this Fabric program needs the result and status only for progress inspection.",
+    description: "Start a child agent through Pi or Claude Code and return a handle immediately. For independent launches, await Promise.allSettled and inspect every result so one rejection does not abort pending sibling calls at program exit. Detached runs send Main a follow-up on terminal completion when agents.notifyOnComplete is enabled; use wait when this Fabric program needs the result and status only for progress inspection.",
     inputSchema: spawnSchema,
     risk: "agent"
   },
@@ -744,4 +744,4 @@ export {
   AGENTS_ACTION_DESCRIPTORS,
   normalizeAgentRunRequest
 };
-//# sourceMappingURL=chunk-BYOGRJME.js.map
+//# sourceMappingURL=chunk-327VLBDU.js.map

package/dist/chunks/chunk-327VLBDU.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/providers/agents-actions.ts", "../../src/agents/request.ts"],
+  "sourcesContent": ["import { FABRIC_ACTOR_HOST_EVENTS } from \"../actors/types.js\";\nimport {\n  MAX_COMPACTION_INSTRUCTIONS_CHARS,\n  MAX_PRESERVE_ITEM_CHARS,\n  MAX_PRESERVE_ITEMS,\n} from \"../compaction/instructions.js\";\nimport { FABRIC_LIFECYCLE_EVENTS } from \"../lifecycle/types.js\";\nimport type { FabricActionDescriptor } from \"../protocol.js\";\n\nconst runProperties = {\n  task: { type: \"string\", description: \"A self-contained task for the child agent\" },\n  name: { type: \"string\" },\n  runner: {\n    type: \"string\",\n    enum: [\"pi\", \"claude\", \"veda\"],\n    description: \"Execution harness. Defaults to agents.runner.\",\n  },\n  kernel: {\n    type: \"string\",\n    enum: [\"typescript\", \"python\", \"inherit\"],\n    description: \"Fabric execution language. Omitted/inherit uses the caller executor.kernel; concrete choices require Pi with extensions enabled. Python uses the configured backend; CPython is native execution.\",\n  },\n  transport: {\n    type: \"string\",\n    enum: [\"auto\", \"process\", \"tmux\", \"screen\", \"localterm\", \"herdr\"],\n  },\n  model: {\n    type: \"string\",\n    description:\n      \"Pi provider/id copied from agents.models({ runner: \\\"pi\\\" }), a configured models.aliases name, or a search term resolved to the closest authenticated model (recency from pi-model-sort breaks ties). Reuse returned keys; never infer version numbers from agent names. Exact keys win; near-miss IDs resolve to the closest visible model on the same provider. Handles report the canonical model. Claude runtime value or Veda backend model/alias are forwarded verbatim.\",\n  },\n  persona: {\n    type: \"string\",\n    description: \"Veda persona name for this run, such as frontend, reviewer, worker, or a custom persona.\",\n  },\n  thinking: {\n    type: \"string\",\n    enum: [\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\", \"max\"],\n  },\n  tools: { type: \"array\", items: { type: \"string\" } },\n  timeoutMs: {\n    type: \"number\",\n    description:\n      \"Optional longer wall-clock limit in milliseconds. Omit to use agents.timeoutMs (60 minutes by default); values below the configured default are ignored.\",\n  },\n  extensions: { type: \"boolean\" },\n  recursive: { type: \"boolean\" },\n  cwd: {\n    type: \"string\",\n    description: \"Filesystem execution directory for leaf or recursive Pi runs; relative paths resolve from the caller cwd. Does not change project/mesh ownership or grant target project trust.\",\n  },\n  worktree: { type: \"boolean\" },\n  schema: { type: \"object\", description: \"Optional JSON Schema for validated structured output\" },\n  systemPrompt: {\n    type: \"string\",\n    description: \"Optional extra system prompt body for this child run. Pi runners merge it below component guidance and forward it via --system-prompt; Claude runners receive it via --append-system-prompt. Useful for reliability-focused prompt rules on models with weak behavioral defaults.\",\n  },\n};\n\nconst runSchema = {\n  type: \"object\",\n  properties: runProperties,\n  required: [\"task\"],\n  additionalProperties: false,\n};\n\nconst residencySchema = {\n  type: \"string\",\n  enum: [\"session\", \"durable\"],\n  description: \"session stops with the current Pi host; durable transfers execution to Fabric's hidden resident host.\",\n};\n\nconst actorBindingScopeSchema = {\n  type: \"string\",\n  enum: [\"session\", \"project\"],\n  description: \"session (default) changes only this Pi session; project pins the shared actor default and requires ownership.\",\n};\n\nconst actorInvocationProperties = {\n  id: { type: \"string\" },\n  message: { type: \"string\" },\n  data: {},\n  model: {\n    ...runProperties.model,\n    description: \"Optional model pinned only for this actor activation.\",\n  },\n  thinking: runProperties.thinking,\n};\n\nconst spawnSchema = {\n  ...runSchema,\n  properties: { ...runProperties, residency: residencySchema },\n};\n\nconst handoffCompactionSchema = {\n  anyOf: [\n    { type: \"boolean\" },\n    {\n      type: \"object\",\n      properties: {\n        instructions: {\n          type: \"string\",\n          maxLength: MAX_COMPACTION_INSTRUCTIONS_CHARS,\n          description: \"Custom compaction instructions for the inherited trajectory\",\n        },\n        preserve: {\n          type: \"array\",\n          items: { type: \"string\", maxLength: MAX_PRESERVE_ITEM_CHARS },\n          maxItems: MAX_PRESERVE_ITEMS,\n          description: \"Explicit bounded facts the trajectory summary must preserve\",\n        },\n      },\n      additionalProperties: false,\n    },\n  ],\n  description:\n    \"Compact the inherited trajectory with Fabric's deterministic compactor before the executor resumes it. `true` applies the default summary; an object customizes instructions and bounded preserve facts. Omitted keeps the full raw trajectory.\",\n};\n\nconst handoffSchema = {\n  type: \"object\",\n  properties: {\n    task: {\n      type: \"string\",\n      description: \"Optional instructions for the executor in addition to the inherited trajectory\",\n    },\n    name: runProperties.name,\n    kernel: runProperties.kernel,\n    transport: runProperties.transport,\n    model: {\n      ...runProperties.model,\n      description: \"Explicit Pi provider/id target that will continue the inherited trajectory\",\n    },\n    thinking: runProperties.thinking,\n    tools: runProperties.tools,\n    timeoutMs: runProperties.timeoutMs,\n    extensions: runProperties.extensions,\n    recursive: runProperties.recursive,\n    schema: runProperties.schema,\n    compact: handoffCompactionSchema,\n  },\n  required: [\"model\"],\n  additionalProperties: false,\n};\n\nconst idSchema = {\n  type: \"object\",\n  properties: { id: { type: \"string\" } },\n  required: [\"id\"],\n  additionalProperties: false,\n};\n\nconst lifecycleEventSchema = {\n  type: \"string\",\n  enum: [...FABRIC_LIFECYCLE_EVENTS],\n};\n\nexport const AGENTS_ACTION_DESCRIPTORS: FabricActionDescriptor[] = [\n  {\n    name: \"run\",\n    description: \"Run a child agent through Pi or Claude Code and wait for its final result\",\n    inputSchema: runSchema,\n    risk: \"agent\",\n  },\n  {\n    name: \"handoff\",\n    description:\n      \"Schedule a Pi trajectory handoff after the current outer fabric_exec result, then wait for implementation at that boundary\",\n    inputSchema: handoffSchema,\n    risk: \"agent\",\n  },\n  {\n    name: \"spawn\",\n    description:\n      \"Start a child agent through Pi or Claude Code and return a handle immediately. For independent launches, await Promise.allSettled and inspect every result so one rejection does not abort pending sibling calls at program exit. Detached runs send Main a follow-up on terminal completion when agents.notifyOnComplete is enabled; use wait when this Fabric program needs the result and status only for progress inspection.\",\n    inputSchema: spawnSchema,\n    risk: \"agent\",\n  },\n  {\n    name: \"wait\",\n    description: \"Wait for a previously spawned child agent\",\n    inputSchema: idSchema,\n    risk: \"read\",\n  },\n  {\n    name: \"join\",\n    description: \"Alias for agents.wait: wait for a previously spawned child agent with the same progress and completion-notification behavior\",\n    inputSchema: idSchema,\n    risk: \"read\",\n  },\n  {\n    name: \"status\",\n    description: \"Get the latest status of any known project participant\",\n    inputSchema: idSchema,\n    risk: \"read\",\n  },\n  {\n    name: \"list\",\n    description: \"List agent participants locally, across the current lineage, or across the project\",\n    inputSchema: {\n      type: \"object\",\n      properties: { scope: { type: \"string\", enum: [\"local\", \"lineage\", \"project\"] } },\n      additionalProperties: false,\n    },\n    risk: \"read\",\n  },\n  {\n    name: \"members\",\n    description: \"List the unified project topology of roots, agents, and actors\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        scope: { type: \"string\", enum: [\"local\", \"lineage\", \"project\"] },\n        kinds: {\n          type: \"array\",\n          items: { type: \"string\", enum: [\"root\", \"agent\", \"actor\"] },\n        },\n        includeStale: { type: \"boolean\" },\n      },\n      additionalProperties: false,\n    },\n    risk: \"read\",\n  },\n  {\n    name: \"self\",\n    description: \"Return this caller's intrinsic participant identity in the unified topology\",\n    inputSchema: { type: \"object\", properties: {}, additionalProperties: false },\n    risk: \"read\",\n  },\n  {\n    name: \"main\",\n    description:\n      \"Return the root user-facing Main Pi agent target. The stable alias main is also accepted by agents.steer and agents.followUp.\",\n    inputSchema: { type: \"object\", properties: {}, additionalProperties: false },\n    risk: \"read\",\n  },\n  {\n    name: \"sessions\",\n    description: \"List all live root Pi session agents in the project, including the current lineage root and peers, with symmetric participant identities.\",\n    inputSchema: { type: \"object\", properties: {}, additionalProperties: false },\n    risk: \"read\",\n  },\n  {\n    name: \"peers\",\n    description: \"List other live root Pi sessions sharing this project mesh. The dashboard-owning session remains Main; these targets are named peers.\",\n    inputSchema: { type: \"object\", properties: {}, additionalProperties: false },\n    risk: \"read\",\n  },\n  {\n    name: \"subscribe\",\n    description:\n      \"Create a durable source-qualified participant lifecycle subscription. Events are delivered to Main by default or to another participant through steer/follow-up routing.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        from: { type: \"string\", description: \"Exact source participant id; main means this lineage root\" },\n        events: { type: \"array\", minItems: 1, items: lifecycleEventSchema },\n        to: { type: \"string\", description: \"Target participant id; defaults to main\" },\n        delivery: { type: \"string\", enum: [\"steer\", \"followUp\"] },\n        triggerTurn: { type: \"boolean\" },\n        once: { type: \"boolean\" },\n      },\n      required: [\"from\", \"events\", \"delivery\", \"triggerTurn\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"subscriptions\",\n    description: \"List durable participant lifecycle subscriptions, optionally filtered by source or target\",\n    inputSchema: {\n      type: \"object\",\n      properties: { from: { type: \"string\" }, to: { type: \"string\" } },\n      additionalProperties: false,\n    },\n    risk: \"read\",\n  },\n  {\n    name: \"unsubscribe\",\n    description: \"Remove a participant lifecycle subscription\",\n    inputSchema: idSchema,\n    risk: \"agent\",\n  },\n  {\n    name: \"models\",\n    description:\n      \"List models exposed by the selected runner. Claude models are enumerated from the installed Claude Code runtime, not hard-coded.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        runner: { type: \"string\", enum: [\"pi\", \"claude\", \"veda\"] },\n        refresh: { type: \"boolean\" },\n      },\n      additionalProperties: false,\n    },\n    risk: \"execute\",\n  },\n  {\n    name: \"switchModel\",\n    description:\n      \"Switch Main's live Pi session model in place. The model selector accepts an exact provider/id, a configured models.aliases name (alias chains try each target in order until one is authenticated), an exact model id, or a search term; inexact terms resolve to the closest match, preferring recently used models (via pi-model-sort usage, when present).\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        model: {\n          type: \"string\",\n          description: \"provider/id, alias name, or search term\",\n        },\n        provider: { type: \"string\" },\n      },\n      required: [\"model\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"stop\",\n    description: \"Stop a local or remotely owned agent or actor that advertises the stop capability\",\n    inputSchema: idSchema,\n    risk: \"agent\",\n  },\n  {\n    name: \"cleanup\",\n    description: \"Remove a completed agent's run files and optional Git worktree\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        id: { type: \"string\" },\n        deleteBranch: { type: \"boolean\" },\n      },\n      required: [\"id\"],\n      additionalProperties: false,\n    },\n    risk: \"write\",\n  },\n  {\n    name: \"create\",\n    description:\n      'Create a persistent actor with independently selected session or project storage. Use scope \"global\" to save a reusable project-independent template instead of a live actor.',\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        name: { type: \"string\" },\n        instructions: { type: \"string\" },\n        events: {\n          type: \"array\",\n          items: {\n            type: \"string\",\n            enum: [...FABRIC_ACTOR_HOST_EVENTS],\n          },\n        },\n        topics: { type: \"array\", items: { type: \"string\" } },\n        delivery: {\n          type: \"string\",\n          enum: [\"mailbox\", \"steer\", \"followUp\", \"nextTurn\"],\n        },\n        responseMode: { type: \"string\", enum: [\"text\", \"directive\"] },\n        triggerTurn: { type: \"boolean\" },\n        coalesce: { type: \"boolean\" },\n        residency: residencySchema,\n        runner: runProperties.runner,\n        kernel: runProperties.kernel,\n        model: runProperties.model,\n        thinking: runProperties.thinking,\n        tools: runProperties.tools,\n        transport: runProperties.transport,\n        timeoutMs: runProperties.timeoutMs,\n        extensions: runProperties.extensions,\n        requires: {\n          type: \"array\",\n          maxItems: 128,\n          description: \"Exact Fabric provider.action refs committed before every actor run. Object entries may be optional.\",\n          items: {\n            oneOf: [\n              { type: \"string\", minLength: 3, maxLength: 256 },\n              {\n                type: \"object\",\n                properties: {\n                  ref: { type: \"string\", minLength: 3, maxLength: 256 },\n                  optional: { type: \"boolean\" },\n                },\n                required: [\"ref\"],\n                additionalProperties: false,\n              },\n            ],\n          },\n        },\n        validWhile: {\n          type: \"object\",\n          properties: { version: { const: 1 }, source: { type: \"string\" } },\n          required: [\"version\", \"source\"],\n          additionalProperties: false,\n        },\n        scope: {\n          type: \"string\",\n          enum: [\"session\", \"project\", \"global\"],\n          description: \"session isolates the actor to the root Pi session; project shares it across sessions; global creates a non-live template.\",\n        },\n      },\n      required: [\"name\", \"instructions\"],\n      oneOf: [\n        {\n          properties: {\n            delivery: { const: \"mailbox\" },\n            triggerTurn: { const: false },\n          },\n        },\n        {\n          properties: {\n            delivery: { const: \"nextTurn\" },\n            triggerTurn: { const: false },\n          },\n          required: [\"delivery\"],\n        },\n        {\n          properties: { delivery: { enum: [\"steer\", \"followUp\"] } },\n          required: [\"delivery\", \"triggerTurn\"],\n        },\n      ],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"ask\",\n    description: \"Send a message to a persistent actor through its live owner and wait for its next response. Optional model/thinking values apply only to this activation.\",\n    inputSchema: {\n      type: \"object\",\n      properties: actorInvocationProperties,\n      required: [\"id\", \"message\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"tell\",\n    description: \"Queue a message through a persistent actor's live owner without waiting. Optional model/thinking values apply only to this activation.\",\n    inputSchema: {\n      type: \"object\",\n      properties: actorInvocationProperties,\n      required: [\"id\", \"message\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"steer\",\n    description:\n      \"Steer Main, a running one-shot agent between turns, or a persistent actor through its mailbox. The stable id alias main targets the root user-facing Pi session. Non-local targets route over the project mesh.\",\n    inputSchema: {\n      type: \"object\",\n      properties: { id: { type: \"string\" }, message: { type: \"string\" }, data: {} },\n      required: [\"id\", \"message\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"followUp\",\n    description:\n      \"Queue a follow-up for Main or a running one-shot agent, or enqueue a persistent actor mailbox message. The stable id alias main targets the root user-facing Pi session. Non-local targets route over the project mesh.\",\n    inputSchema: {\n      type: \"object\",\n      properties: { id: { type: \"string\" }, message: { type: \"string\" }, data: {} },\n      required: [\"id\", \"message\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"setSteeringMode\",\n    description:\n      \"Set how queued steer messages are delivered to a running one-shot agent: all at once after the current turn, or one per turn (default). Local agent only.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        id: { type: \"string\" },\n        mode: { type: \"string\", enum: [\"all\", \"one-at-a-time\"] },\n      },\n      required: [\"id\", \"mode\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"setFollowUpMode\",\n    description:\n      \"Set how queued follow-up messages are delivered to a one-shot agent: all when it finishes, or one per completion (default). Local agent only.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        id: { type: \"string\" },\n        mode: { type: \"string\", enum: [\"all\", \"one-at-a-time\"] },\n      },\n      required: [\"id\", \"mode\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"compact\",\n    description:\n      \"Request an advisory compaction of a running Pi-runner child agent's context at its next safe boundary (between its own turns), preserving the child's accumulated context. Rejected for Claude-runner children. The child pi core applies the compaction; Fabric only forwards the intent.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        id: { type: \"string\" },\n        instructions: {\n          type: \"string\",\n          description: \"Optional custom compaction instructions forwarded to the child pi\",\n        },\n      },\n      required: [\"id\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"actorStatus\",\n    description: \"Read one persistent actor's status\",\n    inputSchema: idSchema,\n    risk: \"read\",\n  },\n  {\n    name: \"actors\",\n    description:\n      'List persistent actors. Default scope \"project\" lists live actors in this Fabric session; scope \"global\" lists project-independent templates in the global registry.',\n    inputSchema: {\n      type: \"object\",\n      properties: { scope: { type: \"string\", enum: [\"project\", \"global\"] } },\n      additionalProperties: false,\n    },\n    risk: \"read\",\n  },\n  {\n    name: \"messages\",\n    description: \"Read a persistent actor's bounded inbox and outbox history\",\n    inputSchema: {\n      type: \"object\",\n      properties: { id: { type: \"string\" }, limit: { type: \"number\", minimum: 1 } },\n      required: [\"id\"],\n      additionalProperties: false,\n    },\n    risk: \"read\",\n  },\n  {\n    name: \"setModel\",\n    description:\n      \"Change or clear a persistent actor model binding. Session scope is the default; project scope explicitly pins the shared definition default.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        id: { type: \"string\" },\n        model: { type: \"string\" },\n        scope: actorBindingScopeSchema,\n      },\n      required: [\"id\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"setThinking\",\n    description:\n      \"Change or clear a persistent actor reasoning-effort binding. Session scope is the default; project scope explicitly pins the shared definition default.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        id: { type: \"string\" },\n        thinking: runProperties.thinking,\n        scope: actorBindingScopeSchema,\n      },\n      required: [\"id\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"setTools\",\n    description:\n      \"Replace a persistent actor's tool allowlist. Takes effect on its next queued message; an empty list disables optional tools.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        id: { type: \"string\" },\n        tools: runProperties.tools,\n        scope: { type: \"string\", enum: [\"project\", \"global\"] },\n      },\n      required: [\"id\", \"tools\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"setEvents\",\n    description: \"Replace a persistent actor's session-bound Pi and synthetic tool_error event subscriptions\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        id: { type: \"string\" },\n        events: {\n          type: \"array\",\n          items: {\n            type: \"string\",\n            enum: [...FABRIC_ACTOR_HOST_EVENTS],\n          },\n        },\n      },\n      required: [\"id\", \"events\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"setDeliveryPolicy\",\n    description:\n      \"Replace a project actor or global template delivery policy. steer/followUp require an explicit triggerTurn choice; mailbox/nextTurn require false.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        id: { type: \"string\" },\n        delivery: {\n          type: \"string\",\n          enum: [\"mailbox\", \"steer\", \"followUp\", \"nextTurn\"],\n        },\n        triggerTurn: { type: \"boolean\" },\n        scope: { type: \"string\", enum: [\"project\", \"global\"] },\n      },\n      required: [\"id\", \"delivery\", \"triggerTurn\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"clearMessages\",\n    description: \"Clear a persistent actor's recorded message history\",\n    inputSchema: idSchema,\n    risk: \"write\",\n  },\n  {\n    name: \"remove\",\n    description:\n      'Stop and remove a persistent actor. Default scope \"project\" removes a live project actor; scope \"global\" removes a project-independent template from the global registry.',\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        id: { type: \"string\" },\n        scope: { type: \"string\", enum: [\"project\", \"global\"] },\n      },\n      required: [\"id\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"setInstructions\",\n    description:\n      'Replace an actor\\'s default instruction (its persona / system-prompt body). Default scope \"project\" edits a live project actor; scope \"global\" edits a project-independent template. Takes effect on the actor\\'s next queued message.',\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        id: { type: \"string\" },\n        instructions: { type: \"string\" },\n        scope: { type: \"string\", enum: [\"project\", \"global\"] },\n      },\n      required: [\"id\", \"instructions\"],\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"import\",\n    description:\n      \"Import a project-independent template from the global registry into the current project as a fresh live actor with no inherited history (no messages, session, or run logs). Identify the template by id or name; optionally rename the imported actor with \\\"as\\\" to avoid colliding with a live actor.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        id: { type: \"string\", description: \"Template id or name (one of id/name required)\" },\n        name: { type: \"string\", description: \"Template name (one of id/name required)\" },\n        as: { type: \"string\", description: \"Optional new name for the imported live actor\" },\n      },\n      additionalProperties: false,\n    },\n    risk: \"agent\",\n  },\n  {\n    name: \"export\",\n    description:\n      \"Export a live project actor's definition to the global registry as a project-independent template, without any history (no messages, session, or run logs). Throws on a name collision unless overwrite is true.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        id: { type: \"string\" },\n        overwrite: { type: \"boolean\" },\n      },\n      required: [\"id\"],\n      additionalProperties: false,\n    },\n    risk: \"write\",\n  },\n  {\n    name: \"log\",\n    description:\n      \"Read an actor or agent run's LLM/agent log: the actor's session transcript (session.jsonl) and/or a retained run's event stream (events.jsonl: tool calls, model responses, usage). Actors retain their last runs so logs survive after success.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        id: { type: \"string\", description: \"Actor ID/name or agent run ID\" },\n        type: {\n          type: \"string\",\n          enum: [\"session\", \"run\", \"all\"],\n          description:\n            \"session = actor session transcript (default for actors); run = last retained run's events; all = both\",\n        },\n        lines: { type: \"number\", minimum: 1, description: \"Page line limit (default 200)\" },\n        before: {\n          type: \"number\",\n          minimum: 0,\n          description: \"Exclusive line cursor returned by a previous page to load older entries\",\n        },\n        runId: { type: \"string\", description: \"Specific retained run (default: actor's last run)\" },\n      },\n      required: [\"id\"],\n      additionalProperties: false,\n    },\n    risk: \"read\",\n  },\n];\n", "import type { AgentRunRequest } from \"./types.js\";\nimport { isFabricThinking } from \"../thinking.js\";\nimport { aliasThinking, type FabricModelAliases } from \"../core/model-resolution.js\";\n\nconst stringArray = (value: unknown): string[] | undefined => Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === \"string\") : undefined;\nconst checkedKernel = (value: unknown): AgentRunRequest[\"kernel\"] => {\n  if (value === undefined || value === \"inherit\" || value === \"typescript\" || value === \"python\") return value;\n  throw new Error(`Invalid Fabric agent kernel: ${String(value)}`);\n};\n\nexport const normalizeAgentRunRequest = (\n  args: Record<string, unknown>,\n  defaults: {runner: NonNullable<AgentRunRequest[\"runner\"]>; model?: string; timeoutMs: number; inheritedModel?: {provider: string; id: string}; models?: {aliases?: FabricModelAliases}},\n  options: {allowCwd?: boolean} = {},\n): AgentRunRequest => {\n  const transport =\n    args.transport === \"auto\" ||\n    args.transport === \"process\" ||\n    args.transport === \"tmux\" ||\n    args.transport === \"screen\" ||\n    args.transport === \"localterm\" ||\n    args.transport === \"herdr\"\n      ? args.transport\n      : undefined;\n  // An explicit call or actor level always wins; otherwise an alias can carry\n  // the intended effort for the model it selects (e.g. a \"cheap\" alias that is\n  // both cheaper and shallower), and the global agents.thinking default applies\n  // last, inside the manager.\n  const requestedModel =\n    typeof args.model === \"string\"\n      ? args.model\n      : typeof defaults.model === \"string\"\n        ? defaults.model\n        : undefined;\n  const thinking = isFabricThinking(args.thinking)\n    ? args.thinking\n    : aliasThinking(defaults.models?.aliases, requestedModel ?? \"\");\n  const tools = stringArray(args.tools);\n  const timeoutMs = typeof args.timeoutMs === \"number\" && Number.isFinite(args.timeoutMs) && args.timeoutMs > defaults.timeoutMs ? args.timeoutMs : undefined;\n  const runner =\n    args.runner === \"pi\" || args.runner === \"claude\" || args.runner === \"veda\"\n      ? args.runner\n      : defaults.runner;\n  const inheritedModel =\n    runner === \"pi\" && !defaults.model && defaults.inheritedModel\n      ? `${defaults.inheritedModel.provider}/${defaults.inheritedModel.id}`\n      : undefined;\n  const kernel = checkedKernel(args.kernel);\n  if (args.recursive === true && args.extensions === false) {\n    throw new Error(\"Recursive Fabric requires extensions enabled; omit recursive or extensions: false\");\n  }\n  return {\n    task: String(args.task),\n    runner,\n    ...(kernel !== undefined ? { kernel } : {}),\n    ...(typeof args.name === \"string\" ? { name: args.name } : {}),\n    ...(transport ? { transport } : {}),\n    ...(typeof args.model === \"string\"\n      ? { model: args.model }\n      : inheritedModel\n        ? { model: inheritedModel }\n        : {}),\n    ...(typeof args.persona === \"string\" && args.persona.trim()\n      ? { persona: args.persona.trim() }\n      : {}),\n    ...(thinking ? { thinking } : {}),\n    ...(tools ? { tools } : {}),\n    ...(timeoutMs !== undefined ? { timeoutMs } : {}),\n    ...(typeof args.extensions === \"boolean\"\n      ? { extensions: args.extensions }\n      : args.recursive === true ? { extensions: true } : {}),\n    ...(typeof args.recursive === \"boolean\" ? { recursive: args.recursive } : {}),\n    ...(options.allowCwd !== false && typeof args.cwd === \"string\" ? { cwd: args.cwd } : {}),\n    ...(typeof args.worktree === \"boolean\" ? { worktree: args.worktree } : {}),\n    ...(args.residency === \"session\" || args.residency === \"durable\"\n      ? { residency: args.residency }\n      : {}),\n    ...(typeof args.schema === \"object\" && args.schema !== null && !Array.isArray(args.schema)\n      ? { schema: args.schema as Record<string, unknown> }\n      : {}),\n    ...(typeof args.systemPrompt === \"string\" && args.systemPrompt.trim()\n      ? { systemPrompt: args.systemPrompt }\n      : {}),\n  };\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/chunks/{chunk-5IZFVA3H.js → chunk-623AGCNU.js}

@@ -30,7 +30,7 @@ import {
   MAX_AGENT_TIMEOUT_MS,
   MIN_AGENT_TIMEOUT_MS,
   quarantineDamagedFile
-} from "./chunk-G7UJLM33.js";
+} from "./chunk-Q2DCENFM.js";
 import {
   ownedStat,
   processAlive
@@ -6962,4 +6962,4 @@ export {
   agentParticipantRecords,
   actorParticipantRecord
 };
-//# sourceMappingURL=chunk-5IZFVA3H.js.map
+//# sourceMappingURL=chunk-623AGCNU.js.map

package/dist/chunks/{chunk-KI277YNS.js → chunk-A4VP7HDF.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-MGWQOKBV.js";
 
 // src/core/model-resolution.ts
-var PROVIDER_MODEL_RE = /^[^\s/]+\/[^\s/]+$/;
+var PROVIDER_MODEL_RE = /^[^\s/]+\/[^\s]+$/;
 var FUZZY_RESOLUTION_MARKERS = ["closest", "recent", "latest"];
 var modelKey = (model) => `${model.provider}/${model.id}`;
 var sameModel = (left, right) => right !== void 0 && left.provider.toLowerCase() === right.provider.toLowerCase() && left.id.toLowerCase() === right.id.toLowerCase();
@@ -199,6 +199,14 @@ var resolveAvailablePiModel = (selector, options) => {
       (model) => modelKey(model).toLowerCase() === query.toLowerCase()
     );
     if (exact) return exact;
+    const separator = query.indexOf("/");
+    const provider = query.slice(0, separator).toLowerCase();
+    const closest = pickClosestCandidate(
+      query.slice(separator + 1).toLowerCase(),
+      options.available.filter((model) => model.provider.toLowerCase() === provider),
+      options.lastUsed
+    )?.model;
+    if (closest) return closest;
     throw unavailablePiModelError(query);
   }
   const resolution = resolveFabricModel(query, options);
@@ -215,4 +223,4 @@ export {
   resolveFabricModel,
   resolveAvailablePiModel
 };
-//# sourceMappingURL=chunk-KI277YNS.js.map
+//# sourceMappingURL=chunk-A4VP7HDF.js.map

package/dist/chunks/chunk-A4VP7HDF.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/core/model-resolution.ts"],
+  "sourcesContent": ["import { isFabricThinking, type FabricThinking } from \"../thinking.js\";\n\nconst PROVIDER_MODEL_RE = /^[^\\s/]+\\/[^\\s]+$/;\n\n/** Minimal model view needed for resolution; satisfied by pi Model entries. */\nexport interface FabricModelCandidate {\n  provider: string;\n  id: string;\n  name?: string;\n}\n\nexport type FabricModelResolution =\n  | { kind: \"resolved\"; model: FabricModelCandidate; via?: string }\n  | { kind: \"already-active\"; model: FabricModelCandidate }\n  | { kind: \"ambiguous\"; query: string; candidates: FabricModelCandidate[] }\n  | { kind: \"not-found\"; query: string; tried?: string[] };\n\n/**\n * One configured alias: an ordered fallback chain plus an optional default\n * thinking level. The thinking level is a Fabric default for runs that select\n * the alias, below an explicit call/actor value and above the global\n * `agents.thinking` default.\n */\nexport interface FabricModelAlias {\n  targets: string[];\n  thinking?: FabricThinking;\n}\n\nexport type FabricModelAliases = Record<string, FabricModelAlias>;\n\n/** Markers reported in `via` when an inexact selector is fuzzy-resolved. */\nexport const FUZZY_RESOLUTION_MARKERS = [\"closest\", \"recent\", \"latest\"] as const;\n\nconst modelKey = (model: FabricModelCandidate): string => `${model.provider}/${model.id}`;\n\nconst sameModel = (\n  left: FabricModelCandidate,\n  right: FabricModelCandidate | undefined,\n): boolean =>\n  right !== undefined &&\n  left.provider.toLowerCase() === right.provider.toLowerCase() &&\n  left.id.toLowerCase() === right.id.toLowerCase();\n\n/**\n * Normalize raw `models.aliases` config into alias name \u2192 ordered targets.\n * String targets degrade to one-element fallback chains. Entries whose name,\n * target list, or any `provider/model` target string is malformed are\n * dropped entirely, matching the lenient fallback style of the other config\n * normalizers (no partial alias survives with a silently missing target).\n */\nexport const normalizeModelAliases = (input: unknown): FabricModelAliases => {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) return {};\n  const aliases: FabricModelAliases = {};\n  for (const [rawName, rawValue] of Object.entries(input as Record<string, unknown>)) {\n    const name = rawName.trim();\n    if (!name) continue;\n    // Object entries carry {model, thinking?}; re-normalizing them keeps a\n    // config round trip through persisted state or a resident owner idempotent.\n    const entry =\n      typeof rawValue === \"object\" && rawValue !== null && !Array.isArray(rawValue)\n        ? (rawValue as { model?: unknown; targets?: unknown; thinking?: unknown })\n        : undefined;\n    const rawTargets = entry ? entry.model ?? entry.targets : rawValue;\n    const values = typeof rawTargets === \"string\" ? [rawTargets] : rawTargets;\n    if (!Array.isArray(values) || values.length === 0) continue;\n    const targets: string[] = [];\n    let valid = true;\n    for (const candidate of values) {\n      if (typeof candidate !== \"string\") {\n        valid = false;\n        break;\n      }\n      const target = candidate.trim();\n      if (!PROVIDER_MODEL_RE.test(target)) {\n        valid = false;\n        break;\n      }\n      if (!targets.includes(target)) targets.push(target);\n    }\n    if (valid && targets.length > 0) {\n      aliases[name] = {\n        targets,\n        ...(entry && isFabricThinking(entry.thinking) ? { thinking: entry.thinking } : {}),\n      };\n    }\n  }\n  return aliases;\n};\n\n/**\n * Default thinking level configured for a selector that names an alias, or\n * undefined when the selector is not an alias or carries no level.\n */\nexport const aliasThinking = (\n  aliases: FabricModelAliases | undefined,\n  selector: string,\n): FabricThinking | undefined => {\n  if (!aliases) return undefined;\n  const query = selector.trim().toLowerCase();\n  if (!query) return undefined;\n  const key = Object.keys(aliases).find((name) => name.toLowerCase() === query);\n  return key === undefined ? undefined : aliases[key]?.thinking;\n};\n\nconst FUZZY_MIN_QUERY_LENGTH = 4;\nconst FUZZY_LEVENSHTEIN_MIN_RATIO = 0.55;\n\n/**\n * Span covered when every character of `needle` appears in `haystack` in\n * order (first to last matched index), or Infinity when it does not. A tight\n * span keeps abbreviated selectors honest: \"gmni\" spans 6 chars in\n * \"gemini-2.5-pro\" but 10 in \"gpt-5-mini\", so only the former reads as the\n * same token with letters dropped.\n */\nconst subsequenceSpan = (needle: string, haystack: string): number => {\n  let index = 0;\n  let first = -1;\n  let last = -1;\n  for (let i = 0; i < haystack.length && index < needle.length; i += 1) {\n    if (haystack[i] === needle[index]) {\n      if (first === -1) first = i;\n      last = i;\n      index += 1;\n    }\n  }\n  return index === needle.length ? last - first + 1 : Number.POSITIVE_INFINITY;\n};\n\n/** Normalized Levenshtein similarity in [0, 1]; 1 means identical. */\nconst levenshteinRatio = (left: string, right: string): number => {\n  if (left === right) return 1;\n  if (left.length === 0 || right.length === 0) return 0;\n  let previous = Array.from({ length: right.length + 1 }, (_, column) => column);\n  for (let i = 0; i < left.length; i += 1) {\n    const current: number[] = [i + 1];\n    for (let j = 0; j < right.length; j += 1) {\n      current.push(Math.min(\n        previous[j]! + 1,\n        current[j]! + 1,\n        previous[j]! + (left[i] === right[j] ? 0 : 1),\n      ));\n    }\n    previous = current;\n  }\n  return 1 - previous[right.length]! / Math.max(left.length, right.length);\n};\n\n/**\n * Closeness score for an inexact selector against one candidate. Tiered so a\n * substring hit always outranks a subsequence hit, which always outranks a\n * typo-level Levenshtein resemblance; coverage bonuses reward selectors that\n * span most of the target id name. Zero means no resemblance at all.\n */\nconst closenessScore = (query: string, model: FabricModelCandidate): number => {\n  const id = model.id.toLowerCase();\n  const name = model.name?.toLowerCase();\n  if (id.startsWith(query)) return 60 + (query.length / id.length) * 20;\n  if (id.includes(query)) return 50 + (query.length / id.length) * 15;\n  if (name?.startsWith(query) === true) return 45 + (query.length / name.length) * 15;\n  if (name?.includes(query) === true) return 40 + (query.length / name.length) * 10;\n  if (model.provider.toLowerCase().includes(query)) return 25;\n  if (\n    query.length >= 3 &&\n    query[0] === id[0] &&\n    subsequenceSpan(query, id) <= query.length + 2\n  ) {\n    return 18 + (query.length / id.length) * 6;\n  }\n  if (query.length >= FUZZY_MIN_QUERY_LENGTH) {\n    const idRatio = levenshteinRatio(query, id);\n    if (idRatio >= FUZZY_LEVENSHTEIN_MIN_RATIO) return 8 + idRatio * 10;\n    if (name !== undefined) {\n      const nameRatio = levenshteinRatio(query, name);\n      if (nameRatio >= FUZZY_LEVENSHTEIN_MIN_RATIO) return 6 + nameRatio * 8;\n    }\n  }\n  return 0;\n};\n\nexport type FabricModelUsage = Record<string, number>;\n\n/**\n * Pick the closest candidate for an inexact selector. Ranking is closeness\n * first; equal-closeness ties fall to the most recently used model (recency\n * timestamps such as pi-model-sort's extensions/pi-model-sort.json under the\n * agent dir, keyed by provider/id), then to the highest-sorting key, mirroring\n * pi's convention that the newest alias/versioned id sorts last.\n */\nconst pickClosestCandidate = (\n  query: string,\n  pool: readonly FabricModelCandidate[],\n  lastUsed: FabricModelUsage | undefined,\n): { model: FabricModelCandidate; via: \"closest\" | \"recent\" | \"latest\" } | undefined => {\n  const usage: FabricModelUsage = {};\n  for (const [key, value] of Object.entries(lastUsed ?? {})) {\n    usage[key.toLowerCase()] = value;\n  }\n  const recency = (model: FabricModelCandidate): number =>\n    usage[`${model.provider}/${model.id}`.toLowerCase()] ?? 0;\n  let best: FabricModelCandidate | undefined;\n  let bestScore = 0;\n  let tied = false;\n  for (const model of pool) {\n    const score = closenessScore(query, model);\n    if (score <= 0) continue;\n    if (best === undefined || score > bestScore) {\n      best = model;\n      bestScore = score;\n      tied = false;\n      continue;\n    }\n    if (score === bestScore) {\n      tied = true;\n      const bestRecent = recency(best);\n      const nextRecent = recency(model);\n      if (nextRecent > bestRecent || (nextRecent === bestRecent && modelKey(model) > modelKey(best))) {\n        best = model;\n      }\n    }\n  }\n  if (best === undefined) return undefined;\n  const runnersUp = pool.filter(\n    (model) => model !== best && closenessScore(query, model) === bestScore,\n  );\n  const wonOnRecency = tied\n    && runnersUp.some((model) => recency(model) !== recency(best));\n  return {\n    model: best,\n    via: !tied ? \"closest\" : wonOnRecency ? \"recent\" : \"latest\",\n  };\n};\n\n/**\n * Resolve a model selector against aliases and the available (authenticated)\n * registry. Order: alias lookup first so a configured name always wins, then\n * exact provider/id, exact id, then fuzzy selection. A lone partial match is\n * returned directly; broader candidate pools are ranked by closeness, with\n * equal-closeness ties falling to the most recently used model (when usage\n * timestamps are supplied, e.g. from pi-model-sort) and then to the\n * highest-sorting key, mirroring pi's newest-alias convention. Only a pool\n * with no resemblance at all stays not-found; `ambiguous` is retained for\n * defensive completeness but the ranker always produces a deterministic pick.\n */\nexport const resolveFabricModel = (\n  query: string,\n  options: {\n    aliases: FabricModelAliases;\n    available: readonly FabricModelCandidate[];\n    current?: FabricModelCandidate;\n    provider?: string;\n    lastUsed?: FabricModelUsage;\n  },\n): FabricModelResolution => {\n  const normalized = query.trim().toLowerCase();\n  if (!normalized) return { kind: \"not-found\", query };\n  const providerFilter = options.provider?.trim().toLowerCase();\n  const available = providerFilter\n    ? options.available.filter((model) => model.provider.toLowerCase() === providerFilter)\n    : [...options.available];\n  if (available.length === 0) return { kind: \"not-found\", query };\n\n  const aliasKey = Object.keys(options.aliases).find(\n    (key) => key.toLowerCase() === normalized,\n  );\n  const tried: string[] = [];\n  if (aliasKey !== undefined) {\n    const chain = options.aliases[aliasKey]?.targets ?? [];\n    for (const target of chain) {\n      tried.push(target);\n      const separator = target.indexOf(\"/\");\n      const provider = target.slice(0, separator);\n      const id = target.slice(separator + 1);\n      const match = available.find(\n        (model) =>\n          model.provider.toLowerCase() === provider.toLowerCase() &&\n          model.id.toLowerCase() === id.toLowerCase(),\n      );\n      if (match) {\n        return sameModel(match, options.current)\n          ? { kind: \"already-active\", model: match }\n          : { kind: \"resolved\", model: match, via: aliasKey };\n      }\n    }\n    return { kind: \"not-found\", query, tried };\n  }\n\n  const exact = available.find((model) => modelKey(model).toLowerCase() === normalized)\n    ?? available.find((model) => model.id.toLowerCase() === normalized);\n  if (exact) {\n    return sameModel(exact, options.current)\n      ? { kind: \"already-active\", model: exact }\n      : { kind: \"resolved\", model: exact };\n  }\n\n  const candidates = available.filter(\n    (model) =>\n      model.id.toLowerCase().includes(normalized) ||\n      (model.name !== undefined && model.name.toLowerCase().includes(normalized)) ||\n      model.provider.toLowerCase().includes(normalized),\n  );\n  if (candidates.length === 1) {\n    const match = candidates[0];\n    if (match === undefined) return { kind: \"not-found\", query };\n    return sameModel(match, options.current)\n      ? { kind: \"already-active\", model: match }\n      : { kind: \"resolved\", model: match };\n  }\n  const pool = candidates.length > 1 ? candidates : available;\n  const picked = pickClosestCandidate(normalized, pool, options.lastUsed);\n  if (picked) {\n    return sameModel(picked.model, options.current)\n      ? { kind: \"already-active\", model: picked.model }\n      : { kind: \"resolved\", model: picked.model, via: picked.via };\n  }\n  if (candidates.length > 1) return { kind: \"ambiguous\", query, candidates };\n  return { kind: \"not-found\", query };\n};\n\nconst unavailablePiModelError = (\n  query: string,\n  resolution?: Extract<FabricModelResolution, { kind: \"ambiguous\" | \"not-found\" }>,\n): Error => {\n  const detail = resolution?.kind === \"not-found\" && resolution.tried !== undefined\n    ? ` Alias targets tried: ${resolution.tried.join(\", \")}.`\n    : resolution?.kind === \"ambiguous\"\n      ? ` Visible matches: ${resolution.candidates.map(modelKey).join(\", \")}.`\n      : \"\";\n  return new Error(\n    `Model ${JSON.stringify(query)} is not available to this Pi session.${detail} ` +\n      'Use agents.models({ runner: \"pi\" }) to list the models visible to this session.',\n  );\n};\n\n/**\n * Resolve a Pi participant selector strictly within the execution owner's\n * visible registry. Provider-qualified selectors prefer exact IDs, then the\n * closest visible ID/name on that same provider. Aliases retain their ordered\n * exact-target policy; bare selectors retain normal Fabric fuzzy resolution.\n */\nexport const resolveAvailablePiModel = (\n  selector: string,\n  options: {\n    aliases: FabricModelAliases;\n    available: readonly FabricModelCandidate[];\n    lastUsed?: FabricModelUsage;\n  },\n): FabricModelCandidate => {\n  const query = selector.trim();\n  const alias = Object.keys(options.aliases).some(\n    (name) => name.toLowerCase() === query.toLowerCase(),\n  );\n  if (PROVIDER_MODEL_RE.test(query) && !alias) {\n    const exact = options.available.find(\n      (model) => modelKey(model).toLowerCase() === query.toLowerCase(),\n    );\n    if (exact) return exact;\n    // Recover near-miss IDs without crossing provider/auth boundaries.\n    const separator = query.indexOf(\"/\");\n    const provider = query.slice(0, separator).toLowerCase();\n    const closest = pickClosestCandidate(\n      query.slice(separator + 1).toLowerCase(),\n      options.available.filter((model) => model.provider.toLowerCase() === provider),\n      options.lastUsed,\n    )?.model;\n    if (closest) return closest;\n    throw unavailablePiModelError(query);\n  }\n\n  const resolution = resolveFabricModel(query, options);\n  if (resolution.kind === \"resolved\" || resolution.kind === \"already-active\") {\n    return resolution.model;\n  }\n  throw unavailablePiModelError(query, resolution);\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/chunks/{chunk-F5775UIO.js → chunk-KQHJQDJM.js}

@@ -9,7 +9,7 @@ import {
   agentParticipantRecords,
   loadModelUsage,
   useBudgetLedger
-} from "./chunk-5IZFVA3H.js";
+} from "./chunk-623AGCNU.js";
 import {
   RESIDENT_HOST_FORMAT,
   residentDeliveryPrefix,
@@ -24,7 +24,7 @@ import {
 import {
   normalizeModelAliases,
   resolveAvailablePiModel
-} from "./chunk-KI277YNS.js";
+} from "./chunk-A4VP7HDF.js";
 import {
   parseFabricOwnedModelGuidance,
   resolveFabricModelGuidance
@@ -689,4 +689,4 @@ if (isMain) {
 export {
   runResidentHostFromConfigPath
 };
-//# sourceMappingURL=chunk-F5775UIO.js.map
+//# sourceMappingURL=chunk-KQHJQDJM.js.map

package/dist/chunks/{chunk-7TX532EG.js → chunk-OEDHQWE2.js}

@@ -1,6 +1,6 @@
 import {
   writeJsonAtomic
-} from "./chunk-G7UJLM33.js";
+} from "./chunk-Q2DCENFM.js";
 import {
   stableJsonHash
 } from "./chunk-3YZUQESG.js";
@@ -131,4 +131,4 @@ export {
   FabricComponentConfiguration,
   watchComponentConfiguration
 };
-//# sourceMappingURL=chunk-7TX532EG.js.map
+//# sourceMappingURL=chunk-OEDHQWE2.js.map

package/dist/chunks/{chunk-G7UJLM33.js → chunk-Q2DCENFM.js}

@@ -11,7 +11,7 @@ import {
 } from "./chunk-KAD7UWT2.js";
 import {
   normalizeModelAliases
-} from "./chunk-KI277YNS.js";
+} from "./chunk-A4VP7HDF.js";
 import {
   DEFAULT_FABRIC_THINKING,
   isFabricThinking
@@ -1466,4 +1466,4 @@ export {
   loadFabricConfig,
   saveFabricConfig
 };
-//# sourceMappingURL=chunk-G7UJLM33.js.map
+//# sourceMappingURL=chunk-Q2DCENFM.js.map

package/dist/components/configuration.js

@@ -1,12 +1,12 @@
 import {
   FabricComponentConfiguration,
   watchComponentConfiguration
-} from "../chunks/chunk-7TX532EG.js";
-import "../chunks/chunk-G7UJLM33.js";
+} from "../chunks/chunk-OEDHQWE2.js";
+import "../chunks/chunk-Q2DCENFM.js";
 import "../chunks/chunk-OKOHRXGF.js";
 import "../chunks/chunk-RAO6TQFP.js";
 import "../chunks/chunk-KAD7UWT2.js";
-import "../chunks/chunk-KI277YNS.js";
+import "../chunks/chunk-A4VP7HDF.js";
 import "../chunks/chunk-MGWQOKBV.js";
 import "../chunks/chunk-X3OD47CL.js";
 import "../chunks/chunk-YU62DDKK.js";

package/dist/core/model-resolution.d.ts

@@ -68,8 +68,9 @@ export declare const resolveFabricModel: (query: string, options: {
 }) => FabricModelResolution;
 /**
  * Resolve a Pi participant selector strictly within the execution owner's
- * visible registry. Exact provider/id keys never fall back to fuzzy matching;
- * aliases and inexact selectors retain the normal Fabric resolution policy.
+ * visible registry. Provider-qualified selectors prefer exact IDs, then the
+ * closest visible ID/name on that same provider. Aliases retain their ordered
+ * exact-target policy; bare selectors retain normal Fabric fuzzy resolution.
  */
 export declare const resolveAvailablePiModel: (selector: string, options: {
     aliases: FabricModelAliases;

package/dist/core/model-resolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-resolution.d.ts","sourceRoot":"","sources":["../../src/core/model-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIvE,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,oBAAoB,EAAE,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAElE,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,0CAA2C,CAAC;AAYjF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,kBAqCtD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,kBAAkB,GAAG,SAAS,EACvC,UAAU,MAAM,KACf,cAAc,GAAG,SAMnB,CAAC;AA6EF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAqDtD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,MAAM,EACb,SAAS;IACP,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3C,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,KACA,qBAgEF,CAAC;AAiBF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,EAChB,SAAS;IACP,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3C,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,KACA,oBAkBF,CAAC"}
+{"version":3,"file":"model-resolution.d.ts","sourceRoot":"","sources":["../../src/core/model-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIvE,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,oBAAoB,EAAE,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAElE,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,0CAA2C,CAAC;AAYjF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,kBAqCtD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,kBAAkB,GAAG,SAAS,EACvC,UAAU,MAAM,KACf,cAAc,GAAG,SAMnB,CAAC;AA6EF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAqDtD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,MAAM,EACb,SAAS;IACP,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3C,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,KACA,qBAgEF,CAAC;AAiBF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,EAChB,SAAS;IACP,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3C,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,KACA,oBA2BF,CAAC"}

package/dist/fabric-runtime-state.js

@@ -12,7 +12,7 @@ import {
   componentEntries,
   validateComponentConfig,
   watchComponentConfiguration
-} from "./chunks/chunk-7TX532EG.js";
+} from "./chunks/chunk-OEDHQWE2.js";
 import {
   WorkerMemoryProvider
 } from "./chunks/chunk-EDL4JDW7.js";
@@ -67,7 +67,7 @@ import "./chunks/chunk-IGVDD2HT.js";
 import {
   AGENTS_ACTION_DESCRIPTORS,
   normalizeAgentRunRequest
-} from "./chunks/chunk-BYOGRJME.js";
+} from "./chunks/chunk-327VLBDU.js";
 import {
   actionArgNormalizer,
   uniqueDeclaredKeyForSpelling
@@ -123,7 +123,7 @@ import {
   resolveInheritedSessionPins,
   resolvePiBinary,
   withInheritedSessionPins
-} from "./chunks/chunk-5IZFVA3H.js";
+} from "./chunks/chunk-623AGCNU.js";
 import {
   executeFile,
   processIsAlive,
@@ -159,7 +159,7 @@ import {
   loadFabricConfig,
   raceShellHang,
   trackShellOperations
-} from "./chunks/chunk-G7UJLM33.js";
+} from "./chunks/chunk-Q2DCENFM.js";
 import "./chunks/chunk-OKOHRXGF.js";
 import "./chunks/chunk-RAO6TQFP.js";
 import {
@@ -184,7 +184,7 @@ import {
   FUZZY_RESOLUTION_MARKERS,
   resolveAvailablePiModel,
   resolveFabricModel
-} from "./chunks/chunk-KI277YNS.js";
+} from "./chunks/chunk-A4VP7HDF.js";
 import {
   isFabricThinking
 } from "./chunks/chunk-MGWQOKBV.js";

package/dist/index.js

@@ -212,7 +212,7 @@ import {
   loadFabricConfig,
   loadFabricConfigForScope,
   saveFabricConfig
-} from "./chunks/chunk-G7UJLM33.js";
+} from "./chunks/chunk-Q2DCENFM.js";
 import {
   defaultCodePreviewSettings
 } from "./chunks/chunk-OKOHRXGF.js";
@@ -234,7 +234,7 @@ import "./chunks/chunk-ZDNGXLEC.js";
 import {
   FABRIC_ACTOR_PI_HOST_EVENTS
 } from "./chunks/chunk-OTCASLY2.js";
-import "./chunks/chunk-KI277YNS.js";
+import "./chunks/chunk-A4VP7HDF.js";
 import "./chunks/chunk-MGWQOKBV.js";
 import "./chunks/chunk-3H7SDWZI.js";
 import "./chunks/chunk-X3OD47CL.js";

package/dist/residency/host.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
   runResidentHostFromConfigPath
-} from "../chunks/chunk-F5775UIO.js";
-import "../chunks/chunk-5IZFVA3H.js";
+} from "../chunks/chunk-KQHJQDJM.js";
+import "../chunks/chunk-623AGCNU.js";
 import "../chunks/chunk-X7G62ZGH.js";
 import "../chunks/chunk-VPPIJRNZ.js";
 import "../chunks/chunk-PM5I335G.js";
@@ -10,7 +10,7 @@ import "../chunks/chunk-JNMTTJMQ.js";
 import "../chunks/chunk-R7G4HXVD.js";
 import "../chunks/chunk-PXAICAUT.js";
 import "../chunks/chunk-CGPK5WHX.js";
-import "../chunks/chunk-G7UJLM33.js";
+import "../chunks/chunk-Q2DCENFM.js";
 import "../chunks/chunk-OKOHRXGF.js";
 import "../chunks/chunk-RAO6TQFP.js";
 import "../chunks/chunk-JJZFNBB7.js";
@@ -19,7 +19,7 @@ import "../chunks/chunk-KAD7UWT2.js";
 import "../chunks/chunk-ZDNGXLEC.js";
 import "../chunks/chunk-AYBIR4YV.js";
 import "../chunks/chunk-OTCASLY2.js";
-import "../chunks/chunk-KI277YNS.js";
+import "../chunks/chunk-A4VP7HDF.js";
 import "../chunks/chunk-MGWQOKBV.js";
 import "../chunks/chunk-3H7SDWZI.js";
 import "../chunks/chunk-X3OD47CL.js";

package/dist/residency/pi-entry.js

@@ -1,7 +1,7 @@
 import {
   runResidentHostFromConfigPath
-} from "../chunks/chunk-F5775UIO.js";
-import "../chunks/chunk-5IZFVA3H.js";
+} from "../chunks/chunk-KQHJQDJM.js";
+import "../chunks/chunk-623AGCNU.js";
 import "../chunks/chunk-X7G62ZGH.js";
 import "../chunks/chunk-VPPIJRNZ.js";
 import "../chunks/chunk-PM5I335G.js";
@@ -9,7 +9,7 @@ import "../chunks/chunk-JNMTTJMQ.js";
 import "../chunks/chunk-R7G4HXVD.js";
 import "../chunks/chunk-PXAICAUT.js";
 import "../chunks/chunk-CGPK5WHX.js";
-import "../chunks/chunk-G7UJLM33.js";
+import "../chunks/chunk-Q2DCENFM.js";
 import "../chunks/chunk-OKOHRXGF.js";
 import "../chunks/chunk-RAO6TQFP.js";
 import "../chunks/chunk-JJZFNBB7.js";
@@ -18,7 +18,7 @@ import "../chunks/chunk-KAD7UWT2.js";
 import "../chunks/chunk-ZDNGXLEC.js";
 import "../chunks/chunk-AYBIR4YV.js";
 import "../chunks/chunk-OTCASLY2.js";
-import "../chunks/chunk-KI277YNS.js";
+import "../chunks/chunk-A4VP7HDF.js";
 import "../chunks/chunk-MGWQOKBV.js";
 import "../chunks/chunk-3H7SDWZI.js";
 import "../chunks/chunk-X3OD47CL.js";

package/dist/runtime/monty-runtime.js

@@ -12,11 +12,11 @@ import {
 } from "../chunks/chunk-7TB7NXSL.js";
 import {
   MAX_EXECUTOR_TIMEOUT_MS
-} from "../chunks/chunk-G7UJLM33.js";
+} from "../chunks/chunk-Q2DCENFM.js";
 import "../chunks/chunk-OKOHRXGF.js";
 import "../chunks/chunk-RAO6TQFP.js";
 import "../chunks/chunk-KAD7UWT2.js";
-import "../chunks/chunk-KI277YNS.js";
+import "../chunks/chunk-A4VP7HDF.js";
 import "../chunks/chunk-MGWQOKBV.js";
 import "../chunks/chunk-X3OD47CL.js";
 import {

package/dist/ui/settings.js

@@ -24,11 +24,11 @@ import {
   loadFabricConfigForScope,
   maxExecutorMemoryLimitBytes,
   saveFabricConfig
-} from "../chunks/chunk-G7UJLM33.js";
+} from "../chunks/chunk-Q2DCENFM.js";
 import "../chunks/chunk-OKOHRXGF.js";
 import "../chunks/chunk-RAO6TQFP.js";
 import "../chunks/chunk-KAD7UWT2.js";
-import "../chunks/chunk-KI277YNS.js";
+import "../chunks/chunk-A4VP7HDF.js";
 import {
   THINKING_LEVELS,
   thinkingLabel

package/docs/agents.md

@@ -26,13 +26,28 @@ You can give `fabric_exec` optional `agentBudget` and `tokenBudget` limits. Conf
 
 `agents.wait({id})` waits for a spawned agent; `agents.join({id})` is an alias with identical arguments, result, progress, and notification behavior. Use `wait` as the canonical spelling. The hosted `AgentService` and `AgentServiceClient` expose both methods too. [Jev programs](jev.md) follow the same `wait`/`join` naming.
 
+### Reuse discovered model keys
+
+Use `agents.models({ runner: "pi" })` and copy the returned `key` verbatim, or use an explicitly configured `models.aliases` name. Reuse the `model` returned by a successful spawn rather than reconstructing it from an agent's display name. For example, an agent named “Sol” need not share the version number of one named “Astra”. Prior success with one key does not validate a different key.
+
+`provider/model` selectors prefer an exact visible match. A near-miss ID resolves to the closest available model on the **same provider**, using Fabric's existing similarity ranking; ties prefer recent usage, then canonical key order. For example, `openai-codex/gpt-6-sol` resolves to `openai-codex/gpt-5.6-sol` when that is the closest visible model. The returned handle's `model` and the worker's `requestedModel` contain the canonical selection. Unknown providers and names without sufficient resemblance still fail before launch. Model IDs containing `/` stay provider-scoped. Configured aliases keep their ordered, exact-target fallback chains.
+
+For independent launches, await `Promise.allSettled` and inspect every result. An uncaught `Promise.all` rejection ends the Fabric program and can abort sibling calls still in flight; it does not prove every requested model was unavailable. Already completed calls are not rolled back, so retain successful handles rather than retrying the entire batch.
+
+```ts
+const results = await Promise.allSettled(requests.map(request => agents.spawn(request)));
+return results.map(result => result.status === "fulfilled"
+  ? { ok: true, handle: result.value }
+  : { ok: false, error: String(result.reason) });
+```
+
 ### Requested models are authoritative
 
 For Pi workers, Fabric reapplies the resolved `provider/model` over RPC **after startup extensions finish**, reapplies the requested thinking level, and independently reads `get_state` before sending the task. A successful `set_model` response alone is insufficient: it can echo the requested model even when an extension switches away during `model_select`. Thinking is reported at Pi's effective, capability-clamped level.
 
 Startup waits for a correlated RPC readiness response. Startup, model admission, and task execution share the run's configured `timeoutMs`; there is no separate 15-second admission cap. RPC readiness does not guarantee a fast `set_model`: authentication checks and async `model_select` hooks can still wait on provider initialization or shared resources during concurrent launches. A slow handshake may use the remaining run budget, but it never resets or extends the overall deadline.
 
-Unavailable models, rejected/malformed RPC responses, or a remaining model mismatch fail the run without sending its task. A startup or admission stall exhausts the overall deadline with `timed_out`, also without sending the task. Queued controls wait for admission too. Fabric does not substitute an MRU model or silently fall back. Standalone `AgentManager` callers can also supply a unique exact bare model ID; ambiguous IDs must be provider-qualified.
+Selectors with no available match, rejected/malformed RPC responses, or a remaining model mismatch fail the run without sending its task. A startup or admission stall exhausts the overall deadline with `timed_out`, also without sending the task. Queued controls wait for admission too. After parent-side selector resolution, the worker must use that canonical model: it does not substitute an MRU model or fall back during admission. Standalone `AgentManager` callers can also supply a unique exact bare model ID; ambiguous IDs must be provider-qualified.
 
 `requestedModel` preserves launch intent in run records; `model` follows verified child state and actual assistant attribution. The manager and participant UI preserve that observed value; the launch label cannot overwrite it. If assistant attribution drifts after admission, Fabric terminates the child and reports both requested and observed models in the failure. This verifies Pi's local provider/model identity, not a remote provider's internal routing.
 
@@ -263,7 +278,7 @@ await agents.switchModel({ model: "cheap" });
 
 The selector resolves in order: a `models.aliases` entry (a string alias is one target; an array is a fallback chain where the first authenticated target wins), an exact `provider/id`, an exact model id, then the closest match across provider, id, and display name. Closeness ties fall to the most recently used model, read from the [pi-model-sort](https://github.com/monotykamary/pi-model-sort) extension's usage store when it is installed, and then to the highest-sorting key, mirroring pi's newest-alias convention. An optional `provider` argument narrows every stage. Selectors with no resemblance to an authenticated entry and exhausted alias chains throw; the session model stays unchanged. `agents.models()` enumerates the authenticated registry entries this resolution runs against. The result reports the active model, the previous one, and how the selector resolved: `via` is the alias name for configured aliases, or `closest`, `recent`, or `latest` for fuzzy picks. A call naming the active model returns `{ switched: false, reason: "already-active" }`. The switch applies to the next model turn and later, unlike `prewalk`, which temporarily installs an executor model at a mutation boundary and then restores the boundary model.
 
-Pi-runner `model` arguments on `agents.run`, `agents.spawn`, `agents.create`, and `agents.handoff`, plus actor defaults and activation overrides, resolve through the same selector logic (aliases, closest match, recency). The execution owner's `agents.models({ runner: "pi" })` result is authoritative: unresolved exact IDs, fuzzy selectors with no match, and exhausted aliases fail with a session-availability error. Fabric revalidates the canonical model at the worker launch boundary, including remote and durable actor execution, so stale bindings cannot start a model that is no longer visible. Catalog-fresh or custom IDs must appear in the owner's visible registry before a Pi participant can use them. Claude and Veda model values keep their runner-specific behavior.
+Pi-runner `model` arguments on `agents.run`, `agents.spawn`, `agents.create`, and `agents.handoff`, plus actor defaults and activation overrides, resolve through the same selector logic (aliases, closest match, recency). The execution owner's `agents.models({ runner: "pi" })` result is authoritative: provider-qualified near-misses are matched only on that provider, selectors with no similar visible candidate and exhausted aliases fail with a session-availability error. Fabric revalidates the canonical model at the worker launch boundary, including remote and durable actor execution, so stale bindings cannot start a model that is no longer visible. Catalog-fresh or custom IDs must appear in the owner's visible registry before a Pi participant can use them. Claude and Veda model values keep their runner-specific behavior.
 
 This is the host-level equivalent of the `pi-model-switch` extension's `switch_model` tool, with aliases moved into Fabric configuration so project and agent scopes behave like every other Fabric section.