@minasoft/mina-ai-router 0.1.5 → 0.2.1

package/dist/apps/http-server/src/public/assets/index-CaPxN_Ez.css

@@ -0,0 +1 @@
+:root{--lightningcss-light:initial;--lightningcss-dark: ;color-scheme:light;--bg:#fcf9f8;--surface:#fff;--surface-low:#f6f3f2;--surface-container:#f0eded;--surface-high:#eae7e7;--ink:#1c1b1b;--muted:#404846;--muted-2:#717976;--outline:#c0c8c5;--outline-soft:#40484624;--primary:#18443b;--primary-container:#315c52;--primary-soft:#beecdf;--secondary:#006a6a;--success:#16815f;--warning:#a65f14;--danger:#ba1a1a;--terminal:#151716;--terminal-ink:#dff5ea;--radius-sm:.25rem;--radius:.375rem;--radius-lg:.5rem;--shadow-menu:0 1rem 2rem #1e2d2724;--font-ui:"Work Sans", ui-sans-serif, system-ui, sans-serif;--font-head:"Hanken Grotesk", ui-sans-serif, system-ui, sans-serif;--font-mono:"JetBrains Mono", "SFMono-Regular", ui-monospace, Menlo, Consolas, monospace}*{box-sizing:border-box}body{background:radial-gradient(circle at 14% 10%, #315c5214, transparent 26rem), radial-gradient(circle at 92% 18%, #006a6a0f, transparent 24rem), linear-gradient(180deg, #ffffff80, transparent 18rem), var(--bg);min-width:0;min-height:100vh;color:var(--ink);font-family:var(--font-ui);letter-spacing:0;margin:0;font-size:1rem;overflow:hidden}button,input,select,textarea{font:inherit}h1,h2,h3,p{margin:0}h1,h2,h3{font-family:var(--font-head)}code,pre,.mono{font-family:var(--font-mono)}.app-shell{grid-template-rows:auto minmax(0,1fr);height:100vh;min-height:100vh;display:grid}.workspace{grid-template-columns:minmax(0,1fr);min-width:0;min-height:0;display:grid;overflow:hidden}.top-command,.brand-block,.status-cluster,.command-actions,.toolbar,.actions,.meta-row,.agent-title,.request-top,.flow-head,.inspector-head,.activity-head,.modal-head,.terminal-head{align-items:center;gap:.6rem;min-width:0;display:flex}.top-command,.flow-head,.inspector-head,.activity-head,.modal-head{justify-content:space-between}.top-command{border-bottom:1px solid var(--outline-soft);-webkit-backdrop-filter:blur(14px);backdrop-filter:blur(14px);background:#fcf9f8eb;flex-wrap:wrap;min-height:3.5rem;padding:.5rem 1rem}.status-cluster,.command-actions,.actions,.toolbar{flex-wrap:wrap}.side-rail{border-right:1px solid var(--outline-soft);background:#ffffff8f;flex-direction:column;align-items:center;gap:.65rem;padding:1rem .7rem;display:flex}.canvas-panel{grid-template-rows:minmax(0,1fr);min-width:0;min-height:0;display:grid}.metrics{grid-template-columns:repeat(4,minmax(0,1fr));gap:.6rem;padding:.75rem 1rem;display:grid}.flow-card{border:1px solid var(--outline-soft);border-radius:var(--radius-lg);background:#ffffffb8;grid-template-rows:auto minmax(0,1fr);min-width:0;min-height:0;margin:1rem;display:grid;overflow:hidden}.flow-head,.inspector-head,.activity-head,.modal-head{border-bottom:1px solid var(--outline-soft);min-height:3.1rem;padding:.65rem 1rem}.map{cursor:grab;touch-action:none;min-height:21rem;padding:1rem;position:relative;overflow:hidden}.map.is-panning{cursor:grabbing}.flow-stage{transform-origin:50%;position:absolute;inset:1rem}.inspector{-webkit-backdrop-filter:blur(12px);backdrop-filter:blur(12px);background:#ffffffb8;grid-template-rows:auto minmax(0,1fr);min-width:0;min-height:0;display:grid}.floating-inspector{z-index:18;border:1px solid var(--outline-soft);border-radius:var(--radius-lg);width:min(24rem,100vw - 2rem);max-height:calc(100vh - 5.5rem);box-shadow:var(--shadow-menu);will-change:transform;transition:transform .18s,box-shadow .18s;position:fixed;top:clamp(4.5rem,8vh,6rem);bottom:1rem;right:1rem;overflow:hidden}.floating-inspector.is-collapsed{transform:translate(calc(100% - 3rem));box-shadow:0 .8rem 1.8rem #312d2b1f}.floating-inspector.is-collapsed .inspector-head,.floating-inspector.is-collapsed .inspector-body{pointer-events:none;opacity:0}.inspector-tab{z-index:2;border-radius:var(--radius-lg) 0 0 var(--radius-lg);border:1px solid var(--outline-soft);background:var(--primary-container);color:#fff;border-right:0;align-content:center;justify-items:center;gap:.35rem;width:3rem;min-height:7rem;padding:.55rem .2rem;display:grid;position:absolute;top:1rem;left:0;box-shadow:-.6rem .8rem 1.6rem #312d2b29}.inspector-tab span:not(.material-symbols-outlined){writing-mode:vertical-rl;text-orientation:mixed;font-family:var(--font-mono);font-size:.72rem;font-weight:700}.inspector-body,.modal-body{align-content:start;gap:.85rem;min-width:0;padding:.85rem 1rem;display:grid;overflow:auto}.activity{border-top:1px solid var(--outline-soft);background:#fffc;grid-template-rows:auto minmax(0,1fr);min-height:0;display:grid}.floating-activity{z-index:12;position:fixed;bottom:0;left:0;right:0;overflow:hidden;box-shadow:0 -.8rem 2rem #312d2b14}.activity-resize-handle{cursor:row-resize;touch-action:none;height:.7rem;position:absolute;top:-.35rem;left:0;right:0}.activity-resize-handle:before{content:"";background:#535c5938;border-radius:999px;width:3.5rem;height:.22rem;position:absolute;top:.22rem;left:50%;transform:translate(-50%)}.activity-body{padding:.35rem .75rem .65rem;overflow:auto}@media (width>=48rem){.detail-grid,.form-grid{grid-template-columns:1fr 1fr}}@media (width>=68.01rem){.top-command{flex-wrap:nowrap}.status-cluster{flex:auto;justify-content:center}.command-actions{flex-wrap:nowrap;flex:none}}@media (width<=68rem){body{overflow:auto}.app-shell{grid-template-rows:auto auto auto;height:auto}.top-command{flex-direction:column;align-items:flex-start}.side-rail{border-right:0;border-bottom:1px solid var(--outline-soft);flex-direction:row;overflow-x:auto}.rail-button:last-child{margin-top:0;margin-left:auto}.metrics{grid-template-columns:repeat(2,minmax(0,1fr))}.floating-inspector{width:min(23rem,100vw - 1.5rem);max-height:min(34rem,100vh - 1.5rem);top:auto;bottom:.75rem;right:.75rem}}@media (width<=47.99rem){.command-actions,.status-cluster{width:100%}.command-actions button{flex:10rem}.metrics{grid-template-columns:1fr}.flow-card{margin:.75rem}.map{cursor:default;touch-action:auto;gap:.75rem;min-height:auto;display:grid}.flow-stage{gap:.75rem;display:grid;position:static;inset:auto;transform:none!important}.links{display:none}.router-node,.agent-node{touch-action:auto;width:100%;position:static;transform:none}.router-node{order:-1}.floating-inspector{border-radius:var(--radius-lg) var(--radius-lg) 0 0;width:100vw;max-height:72vh;bottom:0;right:0}}button{border-radius:var(--radius);background:var(--primary-container);color:#fff;cursor:pointer;border:1px solid #0000;justify-content:center;align-items:center;gap:.45rem;min-height:2.75rem;padding:.62rem .85rem;display:inline-flex}.material-symbols-outlined{letter-spacing:normal;text-transform:none;white-space:nowrap;word-wrap:normal;-webkit-font-feature-settings:"liga";-webkit-font-smoothing:antialiased;direction:ltr;font-style:normal;font-weight:400;line-height:1;display:inline-block;font-family:Material Symbols Outlined!important}button.secondary{background:var(--surface);color:var(--ink);border-color:var(--outline-soft)}button.ghost{color:var(--muted);background:0 0}button.danger{color:var(--danger);background:#fff5f3;border-color:#ba1a1a40}button:disabled{cursor:wait;opacity:.55}button:focus-visible,input:focus-visible,select:focus-visible,textarea:focus-visible{outline-offset:2px;outline:2px solid #006a6a52}input,select,textarea{border:1px solid var(--outline-soft);border-radius:var(--radius);background:var(--surface-low);width:100%;min-height:2.75rem;color:var(--ink);padding:.72rem}textarea{resize:vertical;min-height:8rem}label{color:var(--muted);gap:.35rem;font-size:.875rem;display:grid}code,pre{border-radius:var(--radius-sm);background:var(--surface-container)}code{overflow-wrap:anywhere;padding:.12rem .28rem}pre{white-space:pre-wrap;overflow-wrap:anywhere;max-height:22rem;margin:0;padding:.75rem;overflow:auto}.brand-mark{border-radius:var(--radius-lg);background:var(--primary-container);color:#fff;place-items:center;width:2rem;height:2rem;display:grid}.brand-title{gap:.08rem;display:grid}.brand-title h1{font-size:1.08rem;line-height:1.15}.subtitle{color:var(--muted);font-size:.82rem;line-height:1.35}.chip{border:1px solid var(--outline-soft);border-radius:var(--radius);max-width:100%;min-height:1.85rem;color:var(--muted);font-family:var(--font-mono);white-space:nowrap;text-overflow:ellipsis;overflow-wrap:anywhere;background:#ffffffb8;flex:auto;align-items:center;gap:.4rem;padding:.35rem .55rem;font-size:.75rem;display:inline-flex;overflow:hidden}.status-cluster .chip{max-width:22rem}.status-cluster .chip:first-child,.flow-head .chip{flex:none}.chip-copy{max-width:min(34rem,100%)}.dot{background:var(--muted-2);border-radius:999px;flex:none;width:.55rem;height:.55rem}.dot.available,.dot.answered,.dot.success{background:var(--success)}.dot.waiting,.dot.busy,.dot.sent,.dot.created,.dot.stale{background:var(--warning)}.dot.failed,.dot.timeout,.dot.missing,.dot.needs-attention,.dot.danger{background:var(--danger)}.rail-button{width:2.75rem;height:2.75rem;color:var(--muted);font-family:var(--font-mono);background:0 0;border-color:#0000;place-items:center;padding:0;display:grid}.rail-button.active{color:var(--secondary);background:#006a6a1a;border-color:#006a6a2e}.rail-button:last-child{margin-top:auto}.metric{border:1px solid var(--outline-soft);border-radius:var(--radius-lg);background:#ffffffad;padding:.65rem .75rem}.metric span{color:var(--muted);font-family:var(--font-mono);align-items:center;gap:.3rem;font-size:.72rem;display:inline-flex}.metric strong{font-family:var(--font-head);margin-top:.3rem;font-size:1.25rem;line-height:1;display:block}.links{pointer-events:none;width:100%;height:100%;position:absolute;inset:0}.link-line{stroke:#4048464d;stroke-width:2px;stroke-dasharray:7 8}.link-line.answered{stroke:#16815fb8;stroke-dasharray:0}.link-line.waiting,.link-line.sent,.link-line.created{stroke:#a65f14d1;stroke-width:3px;animation:1.5s ease-in-out infinite flowPulse}.link-line.failed,.link-line.timeout{stroke:#ba1a1ac7;stroke-dasharray:4 6}.link-line.selected{stroke-width:4px}.router-node,.agent-node{border:1px solid var(--outline-soft);border-radius:var(--radius-lg);background:var(--surface);position:absolute}.router-node{z-index:3;border:2px solid #315c52c7;align-content:center;justify-items:center;gap:.55rem;width:min(14rem,64vw);min-height:9rem;padding:1rem;display:grid;top:50%;left:50%;transform:translate(-50%,-50%)}.router-icon{width:2.6rem;height:2.6rem;color:var(--primary-container);font-family:var(--font-mono);background:#315c521a;border-radius:999px;place-items:center;font-weight:800;display:grid}.legend{color:var(--muted);font-family:var(--font-mono);flex-wrap:wrap;justify-content:center;align-items:center;gap:.45rem;font-size:.72rem;display:flex}.agent-node{width:min(14rem,42vw);min-height:7.7rem;color:var(--ink);cursor:pointer;touch-action:none;-webkit-user-select:none;user-select:none;text-align:left;z-index:4;gap:.45rem;padding:.78rem;display:grid;overflow:hidden}.agent-node:hover,.agent-node.selected{border-color:#006a6a8c;box-shadow:0 .9rem 1.8rem #006a6a1a}.agent-node:active{cursor:grabbing}.agent-node.active-request{border-color:#a65f149e}.agent-node.failed-request{border-color:#ba1a1a80}.agent-title,.request-top{justify-content:space-between}.agent-id{overflow-wrap:anywhere;min-width:0;font-family:var(--font-mono);align-items:center;gap:.35rem;font-size:.82rem;font-weight:700;display:inline-flex}.node-meta,.muted{color:var(--muted)}.node-meta{overflow-wrap:anywhere;font-size:.75rem;line-height:1.35}.request-summary{-webkit-line-clamp:2;-webkit-box-orient:vertical;display:-webkit-box;overflow:hidden}.status{border:1px solid var(--outline-soft);border-radius:var(--radius);min-height:1.5rem;color:var(--muted);font-family:var(--font-mono);white-space:nowrap;background:#fff9;align-items:center;gap:.35rem;padding:.12rem .48rem;font-size:.7rem;display:inline-flex}.status.available,.status.answered{color:var(--success);background:#16815f14;border-color:#16815f4d}.status.waiting,.status.sent,.status.created,.status.busy{color:var(--warning);background:#a65f1414;border-color:#a65f1452}.status.missing,.status.needs-attention,.status.timeout,.status.failed,.status.parse_failure,.status.transport_failure,.status.unknown_failure{color:var(--danger);background:#ba1a1a14;border-color:#ba1a1a47}.status.cancelled,.status.archived,.status.unknown{color:var(--muted-2);background:#71797614}.status.fresh{color:var(--success);background:#16815f14;border-color:#16815f4d}.status.manual{color:var(--secondary);background:#006a6a14;border-color:#006a6a47}.status.stale{color:var(--warning);background:#a65f1414;border-color:#a65f1452}.status.missing{color:var(--danger);background:#ba1a1a14;border-color:#ba1a1a47}.section,.request-list,.detail-grid,.health-grid,.form-grid,.guide-steps{gap:.75rem;display:grid}.health-grid{grid-template-columns:repeat(auto-fit,minmax(8.5rem,1fr))}.section-title{color:var(--muted);font-family:var(--font-mono);letter-spacing:.04em;text-transform:uppercase;align-items:center;gap:.35rem;font-size:.68rem;font-weight:700;display:inline-flex}.kv{gap:.3rem;min-width:0;display:grid}.kv span{color:var(--muted);font-size:.78rem}.kv strong,.kv code{overflow-wrap:anywhere;min-width:0}.capability-card{border:1px solid var(--outline-soft);border-radius:var(--radius-lg);background:#ffffff85;gap:.55rem;min-width:0;padding:.72rem;display:grid}.capability-card p{overflow-wrap:anywhere;min-width:0;line-height:1.45}.capability-card-head,.capability-meta,.capability-actions{flex-wrap:wrap;align-items:center;gap:.45rem;min-width:0;display:flex}.capability-card-head{justify-content:space-between}.capability-meta{color:var(--muted);font-family:var(--font-mono);font-size:.72rem;line-height:1.4}.capability-meta span{overflow-wrap:anywhere;min-width:0}.capability-actions button{flex:10rem}.capability-status{text-transform:uppercase}.status.quality-strong,.dot.quality-strong{color:var(--success);background:#16815f1f;border-color:#16815f3d}.status.quality-thin,.dot.quality-thin{color:var(--warning);background:#a65f141f;border-color:#a65f143d}.status.quality-missing,.dot.quality-missing{color:var(--danger);background:#ba1a1a1a;border-color:#ba1a1a38}.capability-profile{border-top:1px solid var(--outline-soft);gap:.55rem;min-width:0;padding-top:.55rem;display:grid}.profile-row{gap:.28rem;min-width:0;display:grid}.profile-row>span:not(.subtitle){overflow-wrap:anywhere;min-width:0;line-height:1.4}.profile-tags{flex-wrap:wrap;gap:.35rem;min-width:0;display:flex}.profile-tag{border:1px solid var(--outline-soft);border-radius:var(--radius-sm);min-width:0;max-width:100%;color:var(--ink);font-family:var(--font-mono);overflow-wrap:anywhere;background:#ffffffad;padding:.25rem .42rem;font-size:.72rem;line-height:1.35}.capability-fresh{background:#16815f0d;border-color:#16815f42}.capability-manual{background:#006a6a0d;border-color:#006a6a3d}.capability-stale{background:#a65f140f;border-color:#a65f1447}.capability-missing{background:#ba1a1a0d;border-color:#ba1a1a3d}.request-detail{min-width:0}.request-route{flex-wrap:wrap;align-items:center;gap:.35rem;min-width:0;line-height:1.45;display:flex}.request-route code{overflow-wrap:anywhere}.diagnostic-section{border:1px solid var(--outline-soft);border-radius:var(--radius);background:#ffffff7a;gap:.55rem;min-width:0;padding:.7rem;display:grid}.diagnostic-grid{grid-template-columns:1fr;gap:.6rem;min-width:0;display:grid}.diagnostic-section pre{white-space:pre-wrap;overflow-wrap:anywhere;border:1px solid var(--outline-soft);border-radius:var(--radius);background:var(--terminal);min-width:0;max-height:15rem;color:var(--terminal-ink);font-family:var(--font-mono);margin:0;padding:.65rem;font-size:.78rem;line-height:1.45;overflow:auto}.recovery-banner{border-radius:var(--radius);color:var(--muted);background:#a65f1412;border:1px solid #a65f1447;padding:.65rem;line-height:1.45}.recovery-events{gap:.5rem;display:grid}.recovery-event{border:1px solid var(--outline-soft);border-radius:var(--radius);background:#ffffff85;gap:.3rem;min-width:0;padding:.6rem;display:grid}.recovery-event p,.recovery-event code{overflow-wrap:anywhere}@media (width>=768px){.diagnostic-grid{grid-template-columns:repeat(2,minmax(0,1fr))}}.command-box,.notice{border:1px solid var(--outline-soft);border-radius:var(--radius-lg);padding:.65rem}.command-box{background:var(--terminal);color:var(--terminal-ink);gap:.55rem;display:grid}.command-box code{color:#9af1f1;background:#0000003d;padding:.6rem;display:block}.notice{background:var(--surface-low);color:var(--muted);font-size:.86rem;line-height:1.45}.notice-recovery{gap:.55rem;display:grid}.activity-table{border-collapse:collapse;width:100%;min-width:48rem;font-family:var(--font-mono);font-size:.75rem}.activity-table th,.activity-table td{border-bottom:1px solid var(--outline-soft);text-align:left;vertical-align:top;padding:.42rem .6rem}.activity-table th{color:var(--muted);text-transform:uppercase;font-size:.68rem}.request-item{border:1px solid var(--outline-soft);border-radius:var(--radius-lg);background:var(--surface);width:100%;min-height:4.8rem;color:var(--ink);text-align:left;gap:.42rem;padding:.75rem;display:grid}.empty{text-align:center;min-height:10rem;color:var(--muted);border:1px dashed var(--outline);border-radius:var(--radius-lg);place-items:center;padding:1rem;display:grid}.context-menu{z-index:20;border:1px solid var(--outline-soft);border-radius:var(--radius-lg);width:min(18rem,100vw - 2rem);box-shadow:var(--shadow-menu);background:#fffffffa;padding:.45rem;position:fixed}.context-menu button{width:100%;color:var(--ink);text-align:left;background:0 0;border-color:#0000;justify-content:flex-start}.context-menu .danger{color:var(--danger)}.modal-backdrop{z-index:30;background:#1c1b1b57;place-items:center;padding:1rem;display:grid;position:fixed;inset:0}.modal{border:1px solid var(--outline-soft);border-radius:var(--radius-lg);background:var(--surface);grid-template-rows:auto minmax(0,1fr);width:min(48rem,100%);max-height:min(46rem,100vh - 2rem);display:grid;overflow:hidden;box-shadow:0 1.5rem 4rem #1c1b1b3d}.directory-picker,.terminal-panel{border:1px solid var(--outline-soft);border-radius:var(--radius-lg);grid-column:1/-1;gap:.6rem;padding:.75rem;display:grid}.directory-picker{background:var(--surface)}.directory-list{gap:.35rem;max-height:15rem;display:grid;overflow:auto}.directory-row{background:var(--surface-low);width:100%;min-height:2.5rem;color:var(--ink);border-color:var(--outline-soft);text-align:left;justify-content:space-between;align-items:center;gap:.75rem;display:flex}.terminal-panel{background:var(--terminal);color:var(--terminal-ink)}.terminal-actions{flex-wrap:wrap;gap:.5rem;display:flex}.terminal-panel pre{min-height:16rem;max-height:24rem;color:var(--terminal-ink);background:#080d0a;border:1px solid #d8f5df29}.terminal-panel input{color:var(--terminal-ink);background:#080d0a;border-color:#d8f5df3d}.hidden{display:none!important}@keyframes flowPulse{0%,to{opacity:.42}50%{opacity:1}}

package/dist/apps/http-server/src/public/index.html

@@ -7,8 +7,8 @@
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link href="https://fonts.googleapis.com/css2?family=Hanken+Grotesk:wght@600;700&family=JetBrains+Mono:wght@400;500;700&family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@20..48,400,0,0&family=Work+Sans:wght@400;500;600&display=swap" rel="stylesheet" />
-    <script type="module" crossorigin src="/assets/index-Be0tne90.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-CEhd8YGG.css">
+    <script type="module" crossorigin src="/assets/index-Bl059Jd0.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-CaPxN_Ez.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/apps/mcp-server/src/index.js

@@ -1,14 +1,13 @@
 #!/usr/bin/env node
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const node_path_1 = require("node:path");
 const node_url_1 = require("node:url");
 const node_fs_1 = require("node:fs");
 const src_1 = require("../../../packages/core/src");
 const src_2 = require("../../../packages/transports/src");
 const importEsm = new Function("specifier", "return import(specifier)");
-const runtimeModuleUrl = (0, node_url_1.pathToFileURL)((0, node_path_1.join)(__dirname, "../../../../node_modules/@minasoft/mcp-runtime/dist/index.js")).href;
-const statePath = process.env.MINA_ROUTER_STATE ?? (0, node_path_1.join)(process.cwd(), "data", "router-state.json");
+const runtimeModuleUrl = (0, node_url_1.pathToFileURL)(require.resolve("@minasoft/mcp-runtime")).href;
+const statePath = process.env.MINA_ROUTER_STATE ?? (0, src_1.defaultRouterStatePath)();
 const logPath = process.env.MINA_MCP_LOG;
 const context = createContext();
 let inputBuffer = Buffer.alloc(0);
@@ -102,7 +101,11 @@ async function createProvider() {
             description: "List registered Mina helper agents.",
             inputSchema: {
                 type: "object",
-                properties: {},
+                properties: {
+                    callerAgentId: { type: "string" },
+                    sourceAgent: { type: "string" },
+                    callerSessionFingerprint: { type: "string" },
+                },
                 additionalProperties: false,
             },
         },
@@ -117,11 +120,15 @@ async function createProvider() {
                     agentType: { type: "string" },
                     transport: { type: "string" },
                     sessionId: { type: "string" },
+                    sessionFingerprint: { type: "string" },
                     projectRoot: { type: "string" },
                     tmuxTarget: { type: "string" },
                     startupCommand: { type: "string" },
                     capabilitySummary: { type: "string" },
                     capabilitySources: { type: "string" },
+                    capabilitySource: { type: "string" },
+                    capabilityUpdatedAt: { type: "string" },
+                    lastCapabilityRefreshAt: { type: "string" },
                 },
                 required: ["id", "agentType", "transport", "sessionId", "projectRoot"],
                 additionalProperties: false,
@@ -135,6 +142,10 @@ async function createProvider() {
                 properties: {
                     target: { type: "string" },
                     task: { type: "string" },
+                    sourceAgent: { type: "string" },
+                    callerAgentId: { type: "string" },
+                    callerSessionFingerprint: { type: "string" },
+                    allowSelfCall: { type: "boolean" },
                     timeoutMs: { type: "number" },
                 },
                 required: ["target", "task"],
@@ -157,7 +168,7 @@ async function createProvider() {
     providerPromise = Promise.resolve({
         serverInfo: {
             name: "mina-ai-router",
-            version: "0.1.0",
+            version: (0, src_1.packageVersion)(),
         },
         tools: {
             async list() {
@@ -173,16 +184,28 @@ async function createProvider() {
 async function callTool(name, args) {
     switch (name) {
         case "list_agents": {
-            const agents = await context.router.listAgentStatuses();
+            const caller = resolveCallerAgent(args);
+            const agents = await context.router.listAgentStatuses({ callerAgentId: caller?.id });
             return jsonToolResult({ agents });
         }
         case "register_agent": {
             try {
                 const agent = agentFromArgs(args);
-                context.registry.register(agent);
+                const now = new Date().toISOString();
+                const registered = context.registry.register({
+                    ...agent,
+                    bootstrapStatus: "ready",
+                    registrationSource: "mcp",
+                    registrationStatus: "confirmed",
+                    lastRegistrationAttemptAt: now,
+                    confirmedByAgentAt: now,
+                    sessionFingerprint: agent.sessionFingerprint ?? agent.sessionId,
+                }, {
+                    capabilitySource: agent.capabilitySummary || agent.capabilitySources ? "generated" : undefined,
+                });
                 context.save();
                 const agents = await context.router.listAgentStatuses();
-                return jsonToolResult({ agent, agents });
+                return jsonToolResult({ agent: registered, agents });
             }
             catch (error) {
                 return {
@@ -195,11 +218,19 @@ async function callTool(name, args) {
             const target = typeof args.target === "string" ? args.target : "";
             const task = typeof args.task === "string" ? args.task : "";
             const timeoutMs = typeof args.timeoutMs === "number" ? args.timeoutMs : undefined;
+            const caller = resolveCallerAgent(args);
+            const allowSelfCall = args.allowSelfCall === true;
             if (!target || !task) {
                 return { kind: "invalid_params", message: "call_agent requires string target and task." };
             }
             try {
-                const response = await context.router.callAgent({ target, task, timeoutMs });
+                const response = await context.router.callAgent({
+                    sourceAgent: caller?.id,
+                    target,
+                    task,
+                    timeoutMs,
+                    allowSelfCall,
+                });
                 return jsonToolResult(response);
             }
             catch (error) {
@@ -235,6 +266,14 @@ async function callTool(name, args) {
             return { kind: "not_found", message: `Unknown tool "${name}".` };
     }
 }
+function resolveCallerAgent(args) {
+    const callerAgentId = stringValue(args.callerAgentId) ?? stringValue(args.sourceAgent);
+    if (callerAgentId) {
+        return context.registry.get(callerAgentId);
+    }
+    const fingerprint = stringValue(args.callerSessionFingerprint);
+    return fingerprint ? context.registry.findBySessionFingerprint(fingerprint) : undefined;
+}
 function agentFromArgs(args) {
     const id = requiredString(args.id, "id");
     return {
@@ -243,11 +282,15 @@ function agentFromArgs(args) {
         agentType: requiredString(args.agentType, "agentType"),
         transport: requiredString(args.transport, "transport"),
         sessionId: requiredString(args.sessionId, "sessionId"),
+        sessionFingerprint: stringValue(args.sessionFingerprint) ?? stringValue(args.sessionId),
         projectRoot: requiredString(args.projectRoot, "projectRoot"),
         tmuxTarget: stringValue(args.tmuxTarget),
         startupCommand: stringValue(args.startupCommand),
         capabilitySummary: stringValue(args.capabilitySummary),
         capabilitySources: stringValue(args.capabilitySources),
+        capabilitySource: capabilitySourceValue(args.capabilitySource),
+        capabilityUpdatedAt: stringValue(args.capabilityUpdatedAt),
+        lastCapabilityRefreshAt: stringValue(args.lastCapabilityRefreshAt),
     };
 }
 function requiredString(value, field) {
@@ -259,6 +302,9 @@ function requiredString(value, field) {
 function stringValue(value) {
     return typeof value === "string" && value.trim() ? value.trim() : undefined;
 }
+function capabilitySourceValue(value) {
+    return value === "manual" || value === "generated" ? value : undefined;
+}
 function jsonToolResult(value) {
     const text = JSON.stringify(value, null, 2);
     return {

package/dist/packages/core/src/capability-profile.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCapabilityProfile = buildCapabilityProfile;
+exports.scoreCapabilityProfile = scoreCapabilityProfile;
+function buildCapabilityProfile(input) {
+    const summary = input.capabilitySummary?.trim();
+    const profile = normalizeProfile(input.capabilityProfile);
+    const quality = scoreCapabilityProfile({ ...input, capabilityProfile: profile });
+    if (!summary && !profile) {
+        return undefined;
+    }
+    return {
+        ...profile,
+        quality: quality.quality,
+        qualityReasons: quality.reasons,
+    };
+}
+function scoreCapabilityProfile(input) {
+    const summary = input.capabilitySummary?.trim() ?? "";
+    const sources = splitList(input.capabilitySources);
+    const profile = normalizeProfile(input.capabilityProfile);
+    const canAnswer = profile?.canAnswer ?? [];
+    const evidence = profile?.evidence?.length ? profile.evidence : sources;
+    const keyAreas = profile?.keyAreas ?? [];
+    const languageCount = profile?.primaryLanguages?.length ?? 0;
+    const purpose = profile?.projectPurpose?.trim() ?? "";
+    const text = [summary, purpose, canAnswer.join(" "), keyAreas.join(" ")].join(" ").toLowerCase();
+    if (!summary && !purpose && canAnswer.length === 0 && keyAreas.length === 0 && evidence.length === 0) {
+        return { quality: "missing", reasons: ["No capability summary or structured profile is recorded."] };
+    }
+    const genericHits = genericCapabilitySignals.filter((signal) => text.includes(signal));
+    const domainHits = domainCapabilitySignals.filter((signal) => text.includes(signal));
+    const hasStructuredStrongShape = Boolean(purpose)
+        && canAnswer.length >= 2
+        && keyAreas.length >= 1
+        && evidence.length >= 2;
+    const hasSummaryStrongShape = domainHits.length >= 3
+        && evidence.length >= 2
+        && !mostlyGenericFileMention(summary);
+    if (hasStructuredStrongShape || hasSummaryStrongShape) {
+        return {
+            quality: "strong",
+            reasons: [
+                hasStructuredStrongShape
+                    ? "Structured profile includes purpose, answerable areas, key areas, and evidence."
+                    : "Capability summary includes multiple answerable domains backed by evidence.",
+            ],
+        };
+    }
+    if (genericHits.length > 0 || mostlyGenericFileMention(summary) || domainHits.length < 2 || evidence.length === 0) {
+        return {
+            quality: "thin",
+            reasons: [
+                genericHits.length > 0
+                    ? `Summary leans on generic file references: ${genericHits.slice(0, 3).join(", ")}.`
+                    : "Profile does not yet describe enough answerable domains with evidence.",
+            ],
+        };
+    }
+    if (languageCount > 0 && (canAnswer.length > 0 || keyAreas.length > 0)) {
+        return {
+            quality: "thin",
+            reasons: ["Profile has some structure but needs more answerable domains and evidence."],
+        };
+    }
+    return { quality: "thin", reasons: ["Capability profile is present but not yet strong."] };
+}
+function normalizeProfile(profile) {
+    if (!profile) {
+        return undefined;
+    }
+    const normalized = {
+        projectPurpose: stringValue(profile.projectPurpose),
+        primaryLanguages: cleanList(profile.primaryLanguages),
+        keyAreas: cleanList(profile.keyAreas),
+        canAnswer: cleanList(profile.canAnswer),
+        cannotAnswerYet: cleanList(profile.cannotAnswerYet),
+        evidence: cleanList(profile.evidence),
+    };
+    if (!normalized.projectPurpose
+        && normalized.primaryLanguages.length === 0
+        && normalized.keyAreas.length === 0
+        && normalized.canAnswer.length === 0
+        && normalized.cannotAnswerYet.length === 0
+        && normalized.evidence.length === 0) {
+        return undefined;
+    }
+    return normalized;
+}
+function cleanList(value) {
+    return Array.isArray(value)
+        ? value.map((item) => item.trim()).filter(Boolean)
+        : [];
+}
+function splitList(value) {
+    return value
+        ? value.split(/[,\n]/).map((item) => item.trim()).filter(Boolean)
+        : [];
+}
+function stringValue(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function mostlyGenericFileMention(summary) {
+    if (!summary) {
+        return false;
+    }
+    const lower = summary.toLowerCase();
+    const fileMentionCount = (lower.match(/\b(readme|claude\.md|agents\.md|src|package\.json|docs?|directories|files?)\b/g) ?? []).length;
+    return fileMentionCount >= 2 && (lower.includes("provides guidance") || lower.includes("contains") || lower.includes("there is"));
+}
+const genericCapabilitySignals = [
+    "claude.md",
+    "agents.md",
+    "readme",
+    "src directory",
+    "provides guidance",
+    "project files",
+    "files exist",
+    "directory",
+    "package.json",
+];
+const domainCapabilitySignals = [
+    "api",
+    "endpoint",
+    "router",
+    "mcp",
+    "transport",
+    "tmux",
+    "request",
+    "response",
+    "schema",
+    "database",
+    "auth",
+    "payment",
+    "frontend",
+    "backend",
+    "cli",
+    "web ui",
+    "http",
+    "react",
+    "typescript",
+    "node",
+    "test",
+    "workflow",
+];

package/dist/packages/core/src/index.js

@@ -15,10 +15,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ids"), exports);
+__exportStar(require("./capability-profile"), exports);
 __exportStar(require("./file-state"), exports);
+__exportStar(require("./mcp-preflight"), exports);
 __exportStar(require("./prompt-envelope"), exports);
 __exportStar(require("./registry"), exports);
 __exportStar(require("./request-store"), exports);
 __exportStar(require("./response-parser"), exports);
 __exportStar(require("./router"), exports);
+__exportStar(require("./runtime-paths"), exports);
 __exportStar(require("./types"), exports);
+__exportStar(require("./version"), exports);

package/dist/packages/core/src/mcp-preflight.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMcpPreflight = buildMcpPreflight;
+function buildMcpPreflight(input) {
+    const mcpName = input.mcpName?.trim() || "mina-ai-router";
+    const mcpUrl = input.mcpUrl;
+    const commands = commandsFor(input.agentType, mcpName, mcpUrl);
+    if (!commands) {
+        return result({
+            status: "unsupported",
+            mcpUrl,
+            detail: `MCP preflight does not yet support agent type "${input.agentType}".`,
+            nextAction: "Configure this client manually before asking it to self-register with Mina AI Router.",
+            canSendSelfRegistrationPrompt: false,
+        });
+    }
+    if (input.configured === true || input.configuredUrl === mcpUrl) {
+        return result({
+            status: "configured",
+            mcpUrl,
+            detail: `${input.agentType} MCP appears configured for ${mcpUrl}.`,
+            nextAction: "MCP preflight is configured; Mina may send the self-registration prompt.",
+            canSendSelfRegistrationPrompt: true,
+            ...commands,
+        });
+    }
+    if (input.configuredUrl && input.configuredUrl !== mcpUrl) {
+        return result({
+            status: "stale",
+            mcpUrl,
+            detail: `${input.agentType} MCP points at ${input.configuredUrl}, but Mina is serving ${mcpUrl}.`,
+            nextAction: `Run: ${commands.setupCommand}`,
+            canSendSelfRegistrationPrompt: false,
+            ...commands,
+        });
+    }
+    return result({
+        status: "missing",
+        mcpUrl,
+        detail: `${input.agentType} MCP setup is not confirmed for ${mcpUrl}.`,
+        nextAction: `Run: ${commands.setupCommand}`,
+        canSendSelfRegistrationPrompt: false,
+        ...commands,
+    });
+}
+function commandsFor(agentType, mcpName, mcpUrl) {
+    if (agentType === "codex") {
+        return {
+            setupCommand: `codex mcp add ${shellQuote(mcpName)} --url ${shellQuote(mcpUrl)}`,
+            verifyCommand: `codex mcp get ${shellQuote(mcpName)}`,
+            removeCommand: `codex mcp remove ${shellQuote(mcpName)}`,
+        };
+    }
+    if (agentType === "claude") {
+        return {
+            setupCommand: `claude mcp add --transport http ${shellQuote(mcpName)} ${shellQuote(mcpUrl)}`,
+            verifyCommand: `claude mcp get ${shellQuote(mcpName)}`,
+            removeCommand: `claude mcp remove ${shellQuote(mcpName)}`,
+        };
+    }
+    return null;
+}
+function result(input) {
+    return {
+        status: input.status,
+        mcpPreflightStatus: input.status,
+        mcpPreflightDetail: input.detail,
+        mcpSetupCommand: input.setupCommand,
+        mcpVerifyCommand: input.verifyCommand,
+        mcpRemoveCommand: input.removeCommand,
+        mcpUrl: input.mcpUrl,
+        nextAction: input.nextAction,
+        canSendSelfRegistrationPrompt: input.canSendSelfRegistrationPrompt,
+    };
+}
+function shellQuote(value) {
+    if (/^[A-Za-z0-9_./:=@-]+$/.test(value))
+        return value;
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}

package/dist/packages/core/src/registry.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentRegistry = void 0;
+const capability_profile_1 = require("./capability-profile");
 class AgentRegistry {
     constructor(agents = []) {
         this.agents = new Map();
@@ -8,9 +9,67 @@ class AgentRegistry {
             this.register(agent);
         }
     }
-    register(agent) {
-        this.agents.set(agent.id, agent);
-        return agent;
+    register(agent, options = {}) {
+        const fingerprint = agent.sessionFingerprint;
+        const currentById = this.agents.get(agent.id);
+        const currentByFingerprint = fingerprint ? this.findBySessionFingerprint(fingerprint) : undefined;
+        const current = currentById ?? currentByFingerprint;
+        const canonicalId = current?.id ?? agent.id;
+        const registrationWarnings = mergeRegistrationWarnings(current?.registrationWarnings, currentByFingerprint && currentByFingerprint.id !== agent.id
+            ? `Registration id "${agent.id}" matched existing session fingerprint for "${currentByFingerprint.id}"; preserved existing agent id.`
+            : undefined);
+        const next = {
+            ...agent,
+            id: canonicalId,
+            name: currentByFingerprint && currentByFingerprint.id !== agent.id
+                ? currentByFingerprint.name || currentByFingerprint.id
+                : agent.name || current?.name || canonicalId,
+            capabilitySummary: agent.capabilitySummary ?? current?.capabilitySummary,
+            capabilitySources: agent.capabilitySources ?? current?.capabilitySources,
+            capabilitySource: agent.capabilitySource ?? current?.capabilitySource,
+            capabilityUpdatedAt: agent.capabilityUpdatedAt ?? current?.capabilityUpdatedAt,
+            lastCapabilityRefreshAt: agent.lastCapabilityRefreshAt ?? current?.lastCapabilityRefreshAt,
+            capabilityProfile: (0, capability_profile_1.buildCapabilityProfile)({
+                capabilitySummary: agent.capabilitySummary ?? current?.capabilitySummary,
+                capabilitySources: agent.capabilitySources ?? current?.capabilitySources,
+                capabilityProfile: agent.capabilityProfile ?? current?.capabilityProfile,
+            }),
+            bootstrapStatus: agent.bootstrapStatus ?? current?.bootstrapStatus ?? "ready",
+            registrationSource: agent.registrationSource ?? current?.registrationSource ?? "unknown",
+            registrationStatus: agent.registrationStatus ?? current?.registrationStatus ?? "confirmed",
+            lastRegistrationAttemptAt: agent.lastRegistrationAttemptAt ?? current?.lastRegistrationAttemptAt,
+            confirmedByAgentAt: agent.confirmedByAgentAt ?? current?.confirmedByAgentAt,
+            sessionFingerprint: agent.sessionFingerprint ?? current?.sessionFingerprint ?? agent.sessionId,
+            registrationHistory: appendRegistrationHistory(current?.registrationHistory, agent, canonicalId),
+            registrationWarnings,
+            permissionProfile: agent.permissionProfile ?? current?.permissionProfile ?? "default",
+            permissionProfileStatus: agent.permissionProfileStatus ?? current?.permissionProfileStatus ?? "not-requested",
+            permissionProfileDetail: agent.permissionProfileDetail ?? current?.permissionProfileDetail,
+            mcpPreflightStatus: agent.mcpPreflightStatus ?? current?.mcpPreflightStatus,
+            mcpPreflightDetail: agent.mcpPreflightDetail ?? current?.mcpPreflightDetail,
+            mcpSetupCommand: agent.mcpSetupCommand ?? current?.mcpSetupCommand,
+            mcpVerifyCommand: agent.mcpVerifyCommand ?? current?.mcpVerifyCommand,
+            mcpRemoveCommand: agent.mcpRemoveCommand ?? current?.mcpRemoveCommand,
+            mcpUrl: agent.mcpUrl ?? current?.mcpUrl,
+            lastSeenAt: agent.lastSeenAt ?? current?.lastSeenAt,
+            lastActivityAt: agent.lastActivityAt ?? current?.lastActivityAt,
+            activeRequestId: valueOrCurrent(agent, current, "activeRequestId"),
+            leaseStatus: valueOrCurrent(agent, current, "leaseStatus"),
+            leaseStartedAt: valueOrCurrent(agent, current, "leaseStartedAt"),
+            leaseExpiresAt: valueOrCurrent(agent, current, "leaseExpiresAt"),
+            leaseReleasedAt: valueOrCurrent(agent, current, "leaseReleasedAt"),
+        };
+        if ((agent.capabilitySummary !== undefined || agent.capabilitySources !== undefined)
+            && (options.capabilitySource !== undefined || options.refreshedAt !== undefined)) {
+            const timestamp = options.refreshedAt ?? new Date().toISOString();
+            next.capabilitySource = options.capabilitySource ?? agent.capabilitySource ?? current?.capabilitySource;
+            next.capabilityUpdatedAt = timestamp;
+            if ((options.capabilitySource ?? agent.capabilitySource) === "generated") {
+                next.lastCapabilityRefreshAt = timestamp;
+            }
+        }
+        this.agents.set(canonicalId, next);
+        return next;
     }
     list() {
         return Array.from(this.agents.values()).sort((a, b) => a.id.localeCompare(b.id));
@@ -18,6 +77,9 @@ class AgentRegistry {
     get(id) {
         return this.agents.get(id);
     }
+    findBySessionFingerprint(sessionFingerprint) {
+        return this.list().find((agent) => agent.sessionFingerprint === sessionFingerprint);
+    }
     unregister(id) {
         const agent = this.require(id);
         this.agents.delete(id);
@@ -30,5 +92,68 @@ class AgentRegistry {
         }
         return agent;
     }
+    updateCapabilities(id, update) {
+        const agent = this.require(id);
+        const timestamp = update.refreshedAt ?? new Date().toISOString();
+        const next = {
+            ...agent,
+            capabilitySummary: update.summary ?? agent.capabilitySummary,
+            capabilitySources: update.sources ?? agent.capabilitySources,
+            capabilitySource: update.source,
+            capabilityUpdatedAt: timestamp,
+            lastCapabilityRefreshAt: update.source === "generated" ? timestamp : agent.lastCapabilityRefreshAt,
+            capabilityProfile: (0, capability_profile_1.buildCapabilityProfile)({
+                capabilitySummary: update.summary ?? agent.capabilitySummary,
+                capabilitySources: update.sources ?? agent.capabilitySources,
+                capabilityProfile: update.profile ?? agent.capabilityProfile,
+            }),
+        };
+        this.agents.set(id, next);
+        return next;
+    }
+    updateHealth(id, update) {
+        const agent = this.require(id);
+        const next = {
+            ...agent,
+            lastSeenAt: update.lastSeenAt ?? agent.lastSeenAt,
+            lastActivityAt: update.lastActivityAt ?? agent.lastActivityAt,
+        };
+        this.agents.set(id, next);
+        return next;
+    }
 }
 exports.AgentRegistry = AgentRegistry;
+function appendRegistrationHistory(current = [], agent, canonicalId) {
+    const at = agent.confirmedByAgentAt ?? agent.lastRegistrationAttemptAt;
+    const source = agent.registrationSource;
+    const status = agent.registrationStatus;
+    if (!at || !source || !status) {
+        return current;
+    }
+    const event = {
+        at,
+        source,
+        status,
+        agentId: canonicalId,
+        sessionFingerprint: agent.sessionFingerprint,
+    };
+    const last = current[current.length - 1];
+    if (last
+        && last.at === event.at
+        && last.source === event.source
+        && last.status === event.status
+        && last.agentId === event.agentId
+        && last.sessionFingerprint === event.sessionFingerprint) {
+        return current;
+    }
+    return [...current, event];
+}
+function mergeRegistrationWarnings(current = [], next) {
+    if (!next) {
+        return current.length ? current : undefined;
+    }
+    return current.includes(next) ? current : [...current, next];
+}
+function valueOrCurrent(agent, current, key) {
+    return Object.prototype.hasOwnProperty.call(agent, key) ? agent[key] : current?.[key];
+}