qlogicagent 2.20.6 → 2.20.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.20.6",
+  "version": "2.20.7",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -135,9 +135,11 @@
     "benchmark:multi-session-live:resume": "tsx benchmarks/multi-session-real/live-runner.ts --resume",
     "benchmark:subagent-delegation-live": "tsx benchmarks/subagent-delegation/live-runner.ts",
     "benchmark:workflow-authoring": "tsx benchmarks/workflow-authoring/runner.ts",
+    "benchmark:goal-long-horizon": "tsx benchmarks/goal-long-horizon/runner.ts",
     "check": "node scripts/run-check.mjs",
     "test:watch": "vitest",
     "benchmark:hermes-superiority": "tsx benchmarks/hermes-superiority/runner.ts",
+    "benchmark:product-blackbox": "tsx benchmarks/product-blackbox/runner.ts",
     "lint": "oxlint .",
     "check:encoding-corruption": "node scripts/check-encoding-corruption.mjs",
     "check:mechanical-rules": "node scripts/check-mechanical-rules.mjs",
@@ -173,8 +175,7 @@
     "nanoid": "^5.1.5",
     "pino": "^9.6.0",
     "pino-pretty": "^13.0.0",
-    "typescript": "^5.9.3",
-    "typescript-language-server": "5.3.0"
+    "typescript": "^5.9.3"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",

package/dist/skills/mcp/astraclaw-native-mcp-server.js

@@ -1,12 +0,0 @@
-#!/usr/bin/env node
-import{createInterface as Ze}from"node:readline";import{existsSync as Xe,readFileSync as et}from"node:fs";import{readFileSync as Se}from"node:fs";import{randomUUID as Te}from"node:crypto";import{readdirSync as Mt,readFileSync as Rt,statSync as se,writeFileSync as Et}from"node:fs";import{readdir as ie,readFile as ae,stat as le,writeFile as ce}from"node:fs/promises";import{join as d}from"node:path";import{homedir as X}from"node:os";import{join as u}from"node:path";import{existsSync as yt}from"node:fs";import{createHash as ct}from"node:crypto";import{resolve as dt}from"node:path";var P=".qlogicagent";function p(){return process.env.QLOGICAGENT_HOME||u(X(),P)}function v(){return u(p(),"skills")}function C(){return u(p(),"mcp.json")}function ee(t){if(!t)throw new Error("getProjectAgentDir: cwd is required (must not fall back to process.cwd())");return u(t,P)}function x(t){return u(ee(t),"skills-disabled.json")}import{readFileSync as te,writeFileSync as Tt,mkdirSync as wt,renameSync as kt}from"node:fs";import{dirname as Pt,join as re}from"node:path";function f(){return{version:1,disabled:[]}}function oe(t){let e;try{e=te(t,"utf8")}catch(n){return n.code==="ENOENT"?{list:f(),corrupt:!1}:(console.error(`[project-skill-manifest] Cannot read skill mute list at ${t} (${n instanceof Error?n.message:String(n)}); treating it as empty for reads \u2014 muted skills may reactivate.`),{list:f(),corrupt:!0})}let r;try{r=JSON.parse(e)}catch(n){return console.error(`[project-skill-manifest] Skill mute list at ${t} is corrupted (${n instanceof Error?n.message:String(n)}); treating it as empty for reads \u2014 muted skills may reactivate.`),{list:f(),corrupt:!0}}return!r||typeof r!="object"||!Array.isArray(r.disabled)?(console.error(`[project-skill-manifest] Skill mute list at ${t} has an unexpected shape; treating it as empty for reads \u2014 muted skills may reactivate.`),{list:f(),corrupt:!0}):{list:{version:1,disabled:[...new Set(r.disabled.filter(n=>typeof n=="string"&&n.trim().length>0))]},corrupt:!1}}function A(t){return oe(t).list}function ne(){return re(p(),"skills-disabled.json")}function M(){return new Set(A(ne()).disabled)}function R(t){return new Set(A(x(t)).disabled)}var ue=["auto-skill-","test-skill-"],de=".skills_prompt_snapshot.json";function me(t){return ue.some(e=>t.startsWith(e))}function pe(t){let e=t.replace(/\r\n/g,`
-`),r=e.match(/^---\n[\s\S]*?^version:\s*(\S+)/m),o=e.match(/^---\n[\s\S]*?^category:\s*(.+)/m),n=e.match(/^---\n[\s\S]*?^author:\s*(.+)/m),i=e.match(/^---\n[\s\S]*?^requires:\s*(.+)/m),s=e.match(/^---\n[\s\S]*?^environments:\s*(.+)/m),a=e.match(/^---\n([\s\S]*?)\n---/)?.[1]??"";return{version:r?.[1],description:fe(a),category:o?.[1]?.trim()||void 0,author:n?.[1]?.trim()||void 0,requiredTools:D(i?.[1]),environments:D(s?.[1])}}function fe(t){let e=t.split(`
-`),r=e.findIndex(s=>/^description:/.test(s));if(r===-1)return;let o=e[r].replace(/^description:[ \t]*/,"").trim(),n=/^[>|][+-]?$/.test(o),i=[];!n&&o&&i.push(o);for(let s=r+1;s<e.length;s++){let a=e[s];if(!/^[ \t]/.test(a))break;let l=a.trim();l&&i.push(l)}if(i.length!==0)return i.join(" ").replace(/^["']|["']$/g,"").trim()||void 0}var E=new Map,b=new Map;function ge(t,e,r,o){let n=e.has(t.name),i=r.has(t.name),s=!ve(t.meta,o);return{name:t.name,filePath:t.filePath,baseDir:t.baseDir,globallyDisabled:n,projectDisabled:i,active:!n&&!i&&!s,systemGenerated:t.systemGenerated,description:t.meta.description,version:t.meta.version,category:t.meta.category,author:t.meta.author,requiredTools:t.meta.requiredTools,environments:t.meta.environments}}async function he(t){let e;try{e=await ie(t,{withFileTypes:!0})}catch{e=[]}let r=[];for(let s of e){if(!s.isDirectory()||s.name.startsWith("."))continue;let a=d(t,s.name),l=d(a,"SKILL.md");try{let y=await le(l);if(!y.isFile())continue;r.push({name:s.name,filePath:l,baseDir:a,mtimeMs:y.mtimeMs,size:y.size})}catch{continue}}r.sort((s,a)=>s.name.localeCompare(a.name));let o=r.map(s=>`${s.name}:${s.mtimeMs}:${s.size}`).join("|"),n=E.get(t);if(n&&n.fingerprint===o)return n.raw;let i=[];for(let s of r){let a;try{a=await ae(s.filePath,"utf8")}catch{continue}i.push({name:s.name,filePath:s.filePath,baseDir:s.baseDir,systemGenerated:me(s.name),mtimeMs:s.mtimeMs,size:s.size,meta:pe(a)})}return E.set(t,{fingerprint:o,raw:i}),be(t,i),i}async function ye(t,e){let r=v(),o=M(),n=t?R(t):new Set,i=b.get(r);return i||(i=he(r).finally(()=>b.delete(r)),b.set(r,i)),(await i).map(a=>ge(a,o,n,e))}async function I(t,e){return(await ye(t,e)).filter(r=>r.active)}function j(t){let e=v(),r=d(e,t),o=d(r,"SKILL.md");try{if(se(o).isFile())return{baseDir:r,filePath:o}}catch{}return null}function D(t){if(!t)return;let e=t.replace(/^\[|\]$/g,"").split(/[,\s]+/).map(r=>r.replace(/^["']|["']$/g,"").trim()).filter(Boolean);return e.length>0?e:void 0}function ve(t,e){if(t.environments&&e?.currentEnvironment&&!t.environments.includes(e.currentEnvironment))return!1;if(t.requiredTools){if(!e?.availableToolNames)return!1;let r=new Set(e.availableToolNames);return t.requiredTools.every(o=>r.has(o))}return!0}async function be(t,e){try{let o={version:1,entries:e.map(n=>({name:n.name,size:n.size,mtimeMs:n.mtimeMs,description:n.meta.description,version:n.meta.version,requiredTools:n.meta.requiredTools,environments:n.meta.environments}))};await ce(d(t,de),JSON.stringify(o,null,2),"utf8")}catch{}}var L="astraclaw_capabilities";async function O(t){if(t.tool==="skills_list")return{handled:!0,result:{skills:(await I(t.projectRoot,{availableToolNames:t.availableToolNames,currentEnvironment:t.currentEnvironment??process.platform})).map(we)}};if(t.tool==="skill_view"){let e=typeof t.args.name=="string"?t.args.name.trim():"";if(!e)throw new Error("skill_view requires a skill name");let r=j(e);if(!r)throw new Error(`Skill not found: ${e}`);return{handled:!0,result:{name:e,content:Se(r.filePath,"utf8")}}}if(t.tool==="mcp_connectors_list"){let e=t.mcpServerFailures??[],r=e.length>0?{failedServers:e,note:`${e.length} configured MCP server(s) are unavailable this session; their tools are missing from this list.`}:{};if(!t.toolCatalog)return{handled:!0,result:{tools:[],note:"AstraClaw MCP connector catalog is not attached to this capability server instance.",...e.length>0?{failedServers:e}:{}}};let o=t.toolCatalog.getToolManifest().filter(n=>n.function.name.startsWith("mcp__")).map(n=>({toolName:n.function.name,server:_e(n.function.name),name:Pe(n.function.name),description:n.function.description,inputSchema:n.function.parameters}));return{handled:!0,result:{tools:o,count:o.length,...r}}}if(t.tool==="mcp_tool_call"){if(!t.toolCatalog)throw new Error("AstraClaw MCP connector catalog is not attached");let e=typeof t.args.toolName=="string"?t.args.toolName.trim():"";if(!e.startsWith("mcp__"))throw new Error("mcp_tool_call requires a connector toolName returned by mcp_connectors_list");let r=t.toolCatalog.findTool(e);if(!r?.execute)throw new Error(`MCP connector tool not found or not executable: ${e}`);let o=ke(t.args.args),n=`astraclaw_mcp_${Te().slice(0,8)}`,i=await r.execute(n,o);return{handled:!0,result:{toolName:e,content:i.content,details:i.details,imageUrls:i.imageUrls}}}return{handled:!1}}function we(t){return{name:t.name,description:t.description,version:t.version,category:t.category,requiredTools:t.requiredTools,environments:t.environments}}function ke(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)?t:{}}function _e(t){let e=t.split("__");return e.length>=3?e[1]??"":""}function Pe(t){let e=t.split("__");return e.length>=3?e.slice(2).join("__"):t}import m from"node:path";import{fileURLToPath as Re}from"node:url";import{createRuntime as Ee}from"mcporter";var $=new Set(["gateway","agents_list","session_status","sessions_send","sessions_list","sessions_history","sessions_spawn","cron","config","workflow","subagent_decision"]),Ce=new Set([...$,"agent"]);function N(t){return t?.riskLevel?t.riskLevel:t?.isDangerous?"system":t?.isReadOnly?"read":t?.isEgress?"external_egress":"write"}var S=class{toolPool=new Map;setTools(e){this.toolPool.clear();for(let r of e)this.toolPool.set(r.name,r)}addTool(e){this.toolPool.set(e.name,e)}addTools(e){for(let r of e)this.addTool(r)}removeTool(e){return this.toolPool.delete(e)}findTool(e){return this.toolPool.get(e)}hasTool(e){return this.toolPool.has(e)}getToolNames(){return Array.from(this.toolPool.keys())}getToolCount(){return this.toolPool.size}async executeTool(e,r,o,n){let i=this.toolPool.get(e);if(!i)throw new Error(`Tool not found: ${e}`);return i.execute(r,o,n)}getTools(){return Array.from(this.toolPool.values()).filter(e=>e.isEnabled?.()!==!1)}getToolManifest(){let e=[];for(let r of this.toolPool.values()){if(r.isEnabled?.()===!1)continue;let o=N(r);e.push({type:"function",function:{name:r.name,description:r.description,parameters:r.parameters},meta:{category:r.category??"other",displayName:r.displayName??{key:`capability.tool.${r.name}.name`,fallback:r.label},displayDescription:r.displayDescription??{key:`capability.tool.${r.name}.description`,fallback:""},parallelSafe:r.isConcurrencySafe??!1,riskLevel:o,isReadOnly:o==="read",isDangerous:o==="system",isDelete:r.isDelete??!1,isEgress:r.isEgress??o==="external_egress",egressCarriesData:r.egressCarriesData??!1,...r.executionTimeoutMs!==void 0?{executionTimeoutMs:r.executionTimeoutMs}:{}}})}return e}},F=new S;function U(t){F.addTools(t)}function q(t){return F.removeTool(t)}var xe=new Set(["describe","fetch","find","get","inspect","list","query","read","search","stat"]),Ae=new Set(["append","copy","create","delete","edit","move","patch","remove","rename","set","update","upload","write"]);function G(t){let e=t.annotations,r=Me(t.name),o=r.some(l=>Ae.has(l)),n=r.some(l=>xe.has(l)),i=e?.destructiveHint===!0||o,s=e?.readOnlyHint===!0||!i&&n,a=s||e?.idempotentHint===!0&&!i;return{isReadOnly:s,isConcurrencySafe:a,isDestructive:i}}function Me(t){return t.replace(/([a-z0-9])([A-Z])/g,"$1_$2").toLowerCase().split(/[^a-z0-9]+/).filter(Boolean)}var w=12e4,z=1e3,W=9e5;function De(t){if(t===void 0)return w;if(!Number.isInteger(t)||t<z||t>W)throw new RangeError(`MCP callTimeoutMs must be an integer between ${z} and ${W}`);return t}var g=3,Ie=1e3;async function je(t,e){let r=e.sleep??(i=>new Promise(s=>setTimeout(s,i))),o=Math.max(1,e.attempts),n;for(let i=1;i<=o;i++)try{return await t()}catch(s){n=s,i<o&&(e.onRetry?.(i,s),await r(e.baseDelayMs*i))}throw n}var h=class{runtime=null;definitions=[];toolsByServer=new Map;injectedNames=new Set;log;workspaceRoot;toolCatalog;serverToolFilters=new Map;serverOAuth=new Map;serverCallTimeouts=new Map;failedServers=new Map;constructor(e){this.log=e.log??{info:()=>{},warn:()=>{}},this.workspaceRoot=e.workspaceRoot?m.resolve(e.workspaceRoot):void 0,this.toolCatalog=e.toolCatalog,this.definitions=e.servers.filter(r=>!r.disabled).filter(r=>{let o=Ve(r);for(let n of o)this.log.warn(`[mcp] rejected server "${r.name}": ${n.message}`);return r.tools&&this.serverToolFilters.set(r.name,r.tools),r.oauth===!0&&this.serverOAuth.set(r.name,!0),this.serverCallTimeouts.set(r.name,De(r.callTimeoutMs)),o.length===0}).map(r=>this.toServerDefinition(r)).filter(r=>r!==null)}markServerFailed(e,r,o){this.failedServers.set(e,{name:e,phase:r,error:o}),console.error(`[mcp] server "${e}" unavailable this session (${r}): ${o}`)}toServerDefinition(e){if((e.type??(e.url?"http":"stdio"))==="http"){if(!e.url)return this.log.warn(`[mcp] server "${e.name}" is type "http" but has no url, skipping`),this.markServerFailed(e.name,"config",'type "http" but no url'),null;let o;try{o=new URL(e.url)}catch{return this.log.warn(`[mcp] server "${e.name}" has an invalid url "${e.url}", skipping`),this.markServerFailed(e.name,"config",`invalid url "${e.url}"`),null}return{name:e.name,command:{kind:"http",url:o,headers:e.headers}}}return e.command?{name:e.name,command:{kind:"stdio",command:e.command,args:e.args??[],cwd:e.cwd??this.workspaceRoot??process.cwd()},env:e.env}:(this.log.warn(`[mcp] server "${e.name}" is type "stdio" but has no command, skipping`),this.markServerFailed(e.name,"config",'type "stdio" but no command'),null)}async connectAll(){this.definitions.length!==0&&(this.runtime=await Ee({servers:this.definitions,clientInfo:{name:"qlogicagent",version:"1.0.0"},logger:{info:e=>this.log.info(`[mcp] ${e}`),warn:e=>this.log.warn(`[mcp] ${e}`),error:(e,r)=>this.log.warn(`[mcp] ${e}${r?` (${r instanceof Error?r.message:String(r)})`:""}`),debug:()=>{}}}),await Promise.allSettled(this.definitions.map(async e=>{try{let r=await je(()=>this.runtime.listTools(e.name,{includeSchema:!0,disableOAuth:this.serverOAuth.get(e.name)!==!0}),{attempts:g,baseDelayMs:Ie,onRetry:(n,i)=>this.log.warn(`[mcp] connect attempt ${n}/${g} for ${e.name} failed, retrying: ${i instanceof Error?i.message:i}`)}),o=J(r,this.serverToolFilters.get(e.name));this.toolsByServer.set(e.name,o),this.failedServers.delete(e.name),this.log.info(`[mcp] connected to ${e.name} (${o.length}/${r.length} tools)`)}catch(r){this.log.warn(`[mcp] failed to connect to ${e.name} after ${g} attempts: ${r instanceof Error?r.message:r}`),this.markServerFailed(e.name,"connect",`${r instanceof Error?r.message:String(r)} (after ${g} attempts)`)}})))}injectTools(){for(let[e,r]of this.toolsByServer){let o=this.injectPortableTools(e,r);this.log.info(`[mcp] injected ${o.length} tools from ${e}`)}}async refreshServerTools(e){if(!this.runtime)throw new Error("MCP runtime is not connected");let r=await this.runtime.listTools(e,{includeSchema:!0,disableOAuth:this.serverOAuth.get(e)!==!0}),o=J(r,this.serverToolFilters.get(e));return this.toolsByServer.set(e,o),this.failedServers.delete(e),this.retractServerTools(e),this.injectPortableTools(e,o),o.length}getConnectedServers(){return Array.from(this.toolsByServer.keys())}getFailedServers(){return Array.from(this.failedServers.values())}getToolCount(){let e=0;for(let r of this.toolsByServer.values())e+=r.length;return e}async disconnectAll(){for(let r of this.injectedNames)this.removeRegisteredTool(r);this.injectedNames.clear(),this.toolsByServer.clear(),this.failedServers.clear();let e=this.runtime;if(this.runtime=null,e)try{await e.close()}catch{}}toPortableTool(e,r){let o=G({name:r.name,description:r.description});return{name:`mcp__${B(e)}__${r.name}`,label:`[${e}] ${r.name}`,category:"mcp",description:r.description??`MCP tool from ${e}`,parameters:r.inputSchema??{type:"object",properties:{}},isConcurrencySafe:o.isConcurrencySafe,isReadOnly:o.isReadOnly,isDestructive:o.isDestructive,searchHint:`mcp ${e} ${r.name.replace(/[_-]+/g," ")}`,executionTimeoutMs:this.serverCallTimeouts.get(e)??w,execute:async(n,i)=>{let s=this.runtime;if(!s)return{content:[{type:"text",text:`MCP server "${e}" is not connected.`}],details:{error:"mcp_not_connected"}};try{let a=await s.callTool(e,r.name,{args:i,timeoutMs:this.serverCallTimeouts.get(e)??w});return Le(a)}catch(a){let l=a instanceof Error?a.message:String(a);return{content:[{type:"text",text:`MCP tool error: ${l}`}],details:{error:l}}}}}}wrapToolsForWorkspaceBoundary(e){return this.workspaceRoot?e.map(r=>{if(!r.execute)return r;let o=r.execute;return{...r,execute:async(n,i,s)=>{let a=$e(r.name,i,this.workspaceRoot);return a?{content:[{type:"text",text:a}],details:{type:"mcp",error:"workspace_boundary"}}:o(n,i,s)}}}):e}injectPortableTools(e,r){let o=this.wrapToolsForWorkspaceBoundary(r.map(n=>this.toPortableTool(e,n)));this.registerTools(o);for(let n of o)this.injectedNames.add(n.name);return o}retractServerTools(e){let r=`mcp__${B(e)}__`;for(let o of[...this.injectedNames])o.startsWith(r)&&(this.removeRegisteredTool(o),this.injectedNames.delete(o))}registerTools(e){this.toolCatalog?this.toolCatalog.addTools(e):U(e)}removeRegisteredTool(e){return this.toolCatalog?.removeTool(e)??q(e)}};function Le(t){let e=t&&typeof t=="object"?t:{},o=(Array.isArray(e.content)?e.content:[]).filter(a=>!!a&&typeof a=="object"),n=o.filter(a=>a.type==="text"&&typeof a.text=="string").map(a=>a.text),i=o.filter(a=>!(a.type==="text"&&typeof a.text=="string")).map(a=>typeof a.type=="string"&&a.type?a.type:"unknown"),s=n.join(`
-`);if(i.length>0){let a=[...new Set(i)].join(", ");s=s?`${s}
-
-[${i.length} non-text blocks omitted: ${a}]`:`[output contains only non-text blocks: ${a}]`}return{content:[{type:"text",text:s||"(no text output)"}],...e.isError?{details:{error:"mcp_tool_error"}}:{}}}function B(t){return t.replace(/[^a-zA-Z0-9_]/g,"_").toLowerCase()}var Oe=/(?:^|_)(path|paths|file|files|filename|filenames|dir|dirs|directory|directories|folder|folders|cwd|root|uri)(?:$|_)/i;function $e(t,e,r){if(!r)return null;for(let o of k(e)){let n=Ue(o.value,r);if(n&&!qe(n.candidate,n.root,n.pathApi))return`Blocked: MCP tool "${t}" path "${o.value}" is outside the workspace boundary "${n.root}"`}return null}function k(t,e="",r=0){if(r>8)return[];if(typeof t=="string")return Ne(e,t)?[{key:e,value:t}]:[];if(Array.isArray(t))return t.flatMap(n=>k(n,e,r+1));if(!t||typeof t!="object")return[];let o=[];for(let[n,i]of Object.entries(t))o.push(...k(i,n,r+1));return o}function Ne(t,e){if(!Oe.test(t))return!1;let r=e.trim();return!r||/^https?:\/\//i.test(r)?!1:Fe(r)}function Fe(t){return m.isAbsolute(t)||/^[A-Za-z]:[\\/]/.test(t)||/^\\\\/.test(t)||/^file:\/\//i.test(t)||t.includes("../")||t.includes("..\\")||t.startsWith(".\\")||t.startsWith("./")||t.includes("/")||t.includes("\\")}function Ue(t,e){let r=t.trim();if(/^file:\/\//i.test(r))try{r=Re(r)}catch{return null}let o=H(r)||H(e)?m.win32:m,n=o.resolve(e);return{candidate:o.isAbsolute(r)?o.resolve(r):o.resolve(n,r),root:n,pathApi:o}}function qe(t,e,r){let o=r.relative(e,t);return o===""||!o.startsWith("..")&&!r.isAbsolute(o)}function H(t){return/^[A-Za-z]:[\\/]/.test(t)||/^\\\\/.test(t)}function Q(t){if(!t||typeof t!="object")return[];let e=t,r=[],o=e.mcpServers??e.servers??e;for(let[n,i]of Object.entries(o)){if(!i||typeof i!="object")continue;let s=i;if(typeof s.url=="string"){r.push({name:n,type:"http",url:s.url,headers:s.headers&&typeof s.headers=="object"?s.headers:void 0,disabled:s.disabled===!0,oauth:s.oauth===!0,tools:V(s.tools),callTimeoutMs:typeof s.callTimeoutMs=="number"?s.callTimeoutMs:void 0});continue}typeof s.command=="string"&&r.push({name:n,type:"stdio",command:s.command,args:Array.isArray(s.args)?s.args:void 0,env:s.env&&typeof s.env=="object"?s.env:void 0,cwd:typeof s.cwd=="string"?s.cwd:void 0,disabled:s.disabled===!0,oauth:s.oauth===!0,tools:V(s.tools),callTimeoutMs:typeof s.callTimeoutMs=="number"?s.callTimeoutMs:void 0})}return r}function J(t,e){let r=new Set(e?.include??[]),o=new Set(e?.exclude??[]);return t.filter(n=>r.size>0&&!r.has(n.name)?!1:!o.has(n.name))}function V(t){if(!t||typeof t!="object")return;let e=t,r=K(e.include),o=K(e.exclude);if(!(!r&&!o))return{...r?{include:r}:{},...o?{exclude:o}:{}}}function K(t){if(!Array.isArray(t))return;let e=t.filter(r=>typeof r=="string"&&r.trim().length>0);return e.length>0?e:void 0}var Ge=new Set(["bash","sh","zsh","fish","cmd","cmd.exe","powershell","powershell.exe","pwsh","pwsh.exe"]),ze=new Set(["-c","/c","-command","-encodedcommand","-e"]),We=["curl","wget","invokewebrequest","invoke-restmethod","iwr","irm","nc","netcat"],Be=["env","processenv","apikey","api_key","token","secret","credential","credentials","awsaccesskey","awssecret"],He=["authorizedkeys","sshknownhosts","crontab","launchctl","schtasks","startup","runkey","runonce","bashrc","profile"],Je=/\bssh-(?:rsa|ed25519|ecdsa-[^\s]+)\s+[A-Za-z0-9+/=]{40,}/i;function Ve(t){let e=[],r=[t.command??"",...t.args??[],...Object.keys(t.env??{}),...Object.values(t.env??{})].join(`
-`);if(Je.test(r)&&e.push({code:"ioc_public_key",message:"configuration contains an inline SSH public key IOC"}),(t.type??(t.url?"http":"stdio"))!=="stdio"||!Ke(t.command))return e;let o=Qe(t.args??[]);if(!o)return e;let n=Ye(o);return T(n,He)&&e.push({code:"persistence",message:"stdio shell command attempts a persistence write"}),T(n,We)&&T(n,Be)&&e.push({code:"dangerous_egress",message:"stdio shell command combines network egress with likely secret access"}),e}function Ke(t){if(!t)return!1;let e=m.basename(t).toLowerCase();return Ge.has(e)}function Qe(t){for(let e=0;e<t.length;e++){let r=t[e]?.toLowerCase();if(r&&ze.has(r))return t.slice(e+1).join(" ")}return""}function Ye(t){return t.toLowerCase().replace(/[^a-z0-9]+/g,"")}function T(t,e){return e.some(r=>t.includes(r))}var tt=[{name:"skills_list",description:"List AstraClaw skills active for the current workspace.",inputSchema:{type:"object",properties:{},additionalProperties:!1}},{name:"skill_view",description:"Read the full SKILL.md instructions for one AstraClaw skill.",inputSchema:{type:"object",properties:{name:{type:"string",description:"Skill name from skills_list."}},required:["name"],additionalProperties:!1}},{name:"mcp_connectors_list",description:"List MCP connector tools installed in AstraClaw's Plugins page and shared with this external agent.",inputSchema:{type:"object",properties:{},additionalProperties:!1}},{name:"mcp_tool_call",description:"Call one AstraClaw shared MCP connector tool by toolName from mcp_connectors_list.",inputSchema:{type:"object",properties:{toolName:{type:"string",description:"Connector tool name, for example mcp__filesystem__read_text_file."},args:{type:"object",description:"Arguments for the connector tool."}},required:["toolName"],additionalProperties:!1}}],_=class{tools=new Map;findTool(e){return this.tools.get(e)}getToolManifest(){return Array.from(this.tools.values()).map(e=>({type:"function",function:{name:e.name,description:e.description,parameters:e.parameters}}))}getToolNames(){return Array.from(this.tools.keys())}setTools(e){this.tools.clear(),this.addTools(e)}addTool(e){this.tools.set(e.name,e)}addTools(e){for(let r of e)this.addTool(r)}removeTool(e){return this.tools.delete(e)}},c=null,rt=Ze({input:process.stdin,crlfDelay:Number.POSITIVE_INFINITY});rt.on("line",t=>{ot(t)});async function ot(t){let e=t.trim();if(!e)return;let r;try{r=JSON.parse(e)}catch{return}if(r.id===void 0||r.id===null)return r.method==="notifications/initialized",void 0;try{let o=await nt(r);Z({jsonrpc:"2.0",id:r.id,result:o})}catch(o){Z({jsonrpc:"2.0",id:r.id,error:{code:-32603,message:o instanceof Error?o.message:String(o)}})}}async function nt(t){switch(t.method){case"initialize":return{protocolVersion:"2024-11-05",capabilities:{tools:{}},serverInfo:{name:L,version:"1.0.0"}};case"tools/list":return{tools:tt};case"tools/call":{let e=Y(t.params),r=typeof e.name=="string"?e.name:"",o=Y(e.arguments),n=st(),i=r==="mcp_connectors_list"||r==="mcp_tool_call"?await it(n):void 0,s=await O({tool:r,args:o,projectRoot:n,toolCatalog:i,mcpServerFailures:i?c?.manager?.getFailedServers():void 0});if(!s.handled)throw new Error(`Unknown tool: ${r}`);return{content:[{type:"text",text:JSON.stringify(s.result)}]}}default:throw new Error(`Unknown method: ${t.method}`)}}function st(){return process.env.ASTRACLAW_PROJECT_ROOT||process.env.QLOGICAGENT_PROJECT_ROOT||process.cwd()}async function it(t){if(c?.projectRoot===t)return await c.ready,c.catalog;c?.manager?.disconnectAll().catch(()=>{});let e=new _,r=new h({servers:at(),workspaceRoot:t,toolCatalog:e,log:{info:n=>process.stderr.write(`${n}
-`),warn:n=>process.stderr.write(`${n}
-`)}}),o=r.connectAll().then(()=>r.injectTools());return c={projectRoot:t,catalog:e,manager:r,ready:o},await o,e}function at(){let t=process.env.ASTRACLAW_MCP_CONFIG_PATH||C();if(!Xe(t))return[];try{let e=et(t,"utf8").replace(/^\uFEFF/,"");return Q(JSON.parse(e))}catch(e){return process.stderr.write(`[astraclaw-native-mcp] failed to read MCP config: ${e instanceof Error?e.message:String(e)}
-`),[]}}function Y(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)?t:{}}function Z(t){process.stdout.write(`${JSON.stringify(t)}
-`)}

package/dist/types/cli/core-tools/checkpoint-tool-bootstrap.d.ts

@@ -1,9 +0,0 @@
-import type { ToolCatalog } from "../../runtime/ports/index.js";
-export interface CheckpointToolRegistrationDeps {
-    config: Record<string, unknown>;
-    toolCatalog: ToolCatalog;
-    host: {
-        readonly currentSessionId: string;
-    };
-}
-export declare function registerCheckpointTool({ config, host, toolCatalog }: CheckpointToolRegistrationDeps): void;

package/dist/types/cli/core-tools/checkpoint-tool-service.d.ts

@@ -1,7 +0,0 @@
-import type { CheckpointBackend } from "../../runtime/ports/index.js";
-export interface CheckpointToolServiceOptions {
-    config: Record<string, unknown>;
-    sessionId: string;
-    cwd?: string;
-}
-export declare function createCheckpointToolService(options: CheckpointToolServiceOptions): CheckpointBackend;

package/dist/types/cli/core-tools/config-tool-bootstrap.d.ts

@@ -1,7 +0,0 @@
-import type { ToolCatalog } from "../../runtime/ports/index.js";
-import type { HostProfileClient } from "../../transport/host-profile-client.js";
-export interface ConfigToolRegistrationDeps {
-    toolCatalog: ToolCatalog;
-    resolveHostProfileClient?: () => HostProfileClient | undefined;
-}
-export declare function registerConfigTool({ toolCatalog, resolveHostProfileClient }: ConfigToolRegistrationDeps): void;

package/dist/types/cli/core-tools/config-tool-service.d.ts

@@ -1,13 +0,0 @@
-/**
- * Config tool service — a thin compute-side proxy over the gateway-owned tunable store.
- *
- * Defaults/coercion/validation come from the public qlogicagent/tunables contract. Persistent
- * overrides are read and mutated only through HostProfileClient's private X7 profile service.
- * The agent never reads or writes settings.json and has no local fallback.
- */
-import type { ConfigToolDeps } from "../../skills/tools/config-tool.js";
-import type { HostProfileClient } from "../../transport/host-profile-client.js";
-export interface ConfigToolServiceOptions {
-    resolveHostProfileClient?: () => HostProfileClient | undefined;
-}
-export declare function createConfigToolService(options?: ConfigToolServiceOptions): ConfigToolDeps;

package/dist/types/cli/core-tools/monitor-tool-bootstrap.d.ts

@@ -1,7 +0,0 @@
-import type { ToolCatalog } from "../../runtime/ports/index.js";
-import type { AgentLogger } from "../../agent/types.js";
-export interface MonitorToolRegistrationDeps {
-    log: AgentLogger;
-    toolCatalog: ToolCatalog;
-}
-export declare function registerMonitorTool({ log, toolCatalog }: MonitorToolRegistrationDeps): void;

package/dist/types/cli/core-tools/monitor-tool-service.d.ts

@@ -1,6 +0,0 @@
-import type { AgentLogger } from "../../agent/types.js";
-import type { MonitorToolDeps } from "../../skills/tools/monitor-tool.js";
-export interface MonitorToolService extends MonitorToolDeps {
-    dispose(): void;
-}
-export declare function createMonitorToolService(log: AgentLogger): MonitorToolService;

package/dist/types/cli/dev-tool-bootstrap.d.ts

@@ -1,9 +0,0 @@
-import type { ToolCatalog } from "../runtime/ports/index.js";
-export interface DevToolBootstrapDeps {
-    config: Record<string, unknown>;
-    /** Immutable project root resolved for the canonical session/turn. */
-    workdir: string;
-    toolCatalog: ToolCatalog;
-}
-export declare const devToolRegistrationModule: import("../runtime/ports/tool-contracts.js").ToolRegistrationModule<DevToolBootstrapDeps>;
-export declare function configureDevToolBootstrap(deps: DevToolBootstrapDeps): void;

package/dist/types/cli/dev-tools/dev-tool-bootstrap-service.d.ts

@@ -1,7 +0,0 @@
-import type { ToolCatalog } from "../../runtime/ports/index.js";
-export interface DevToolBootstrapServiceDeps {
-    workdir: string;
-    config?: Record<string, unknown>;
-    toolCatalog: ToolCatalog;
-}
-export declare function registerDevTools(deps: DevToolBootstrapServiceDeps): void;

package/dist/types/cli/dev-tools/dev-tool-registry.d.ts

@@ -1,8 +0,0 @@
-import { createLspTool } from "../../skills/tools/lsp-tool.js";
-import { createRepoMapTool } from "../../skills/tools/repo-map-tool.js";
-export interface DevToolRegistryOptions {
-    workdir: string;
-    config?: Record<string, unknown>;
-}
-export type DevTool = ReturnType<typeof createRepoMapTool> | ReturnType<typeof createLspTool>;
-export declare function buildDevTools(options: DevToolRegistryOptions): DevTool[];

package/dist/types/cli/dev-tools/incremental-repo-map.d.ts

@@ -1,81 +0,0 @@
-import type { RepoMapQuery, RepoMapResult } from "../../skills/tools/repo-map-tool.js";
-export type RepoMapChangeType = "created" | "modified" | "deleted";
-export interface RepoMapWatcher {
-    on(event: "error", listener: (error: Error) => void): RepoMapWatcher;
-    close(): void;
-}
-export type RepoMapWatchFactory = (root: string, options: {
-    recursive: true;
-    persistent: false;
-}, listener: (eventType: "rename" | "change", filename: string | Buffer | null) => void) => RepoMapWatcher;
-export interface IncrementalRepoMapOptions {
-    workspaceRoot: string;
-    maxFileBytes?: number;
-    maxIndexedFiles?: number;
-    maxTotalBytes?: number;
-    maxScanMs?: number;
-    maxDepth?: number;
-    idleTimeoutMs?: number;
-    now?: () => number;
-    watch?: boolean;
-    watchFactory?: RepoMapWatchFactory;
-}
-export declare class IncrementalRepoMap {
-    private readonly workspaceRoot;
-    private readonly maxFileBytes;
-    private readonly maxIndexedFiles;
-    private readonly maxTotalBytes;
-    private readonly maxScanMs;
-    private readonly maxDepth;
-    private readonly idleTimeoutMs;
-    private readonly now;
-    private readonly watchEnabled;
-    private readonly watchFactory;
-    private readonly abortController;
-    private workspaceRealPathPromise?;
-    private readonly pending;
-    private files;
-    private watcher?;
-    private watcherReliable;
-    private watcherWarning?;
-    private nextWatchRetryAt;
-    private forceFullRequested;
-    private initialized;
-    private generation;
-    private indexPartial;
-    private indexWarning?;
-    private disposed;
-    private refreshPromise?;
-    private activeQueries;
-    private idleTimer?;
-    constructor(options: IncrementalRepoMapOptions);
-    markChanged(filePath: string, changeType?: RepoMapChangeType): void;
-    getMap(query?: RepoMapQuery): Promise<RepoMapResult>;
-    releaseIdleResources(): void;
-    dispose(): void;
-    private beginQuery;
-    private finishQuery;
-    private scheduleIdleRelease;
-    private clearIdleTimer;
-    private tryStartWatcher;
-    private invalidateWatcher;
-    private maybeRebuildWatcher;
-    private refresh;
-    private runRefresh;
-    private applyIncrementalWithFallback;
-    private applyIncremental;
-    private buildFullIndex;
-    private scanDirectory;
-    private loadPath;
-    private createScanBudget;
-    private checkScanTime;
-    private reserveIndexedFile;
-    private stopScan;
-    private commitFullIndex;
-    private canonicalPathInsideWorkspace;
-    private getWorkspaceRealPath;
-    private throwIfAborted;
-    private takePending;
-    private restorePending;
-    private toRelativePath;
-}

package/dist/types/cli/dev-tools/lsp-supervisor.d.ts

@@ -1,59 +0,0 @@
-import { type ChildProcessWithoutNullStreams } from "node:child_process";
-import type { LspOperation, LspResult } from "../../skills/tools/lsp-tool.js";
-export interface LspServerDefinition {
-    id: string;
-    command: string;
-    args?: readonly string[];
-    extensions: readonly string[];
-    languageId: string | ((filePath: string) => string);
-    env?: NodeJS.ProcessEnv;
-}
-export interface LspSpawnOptions {
-    cwd: string;
-    env: NodeJS.ProcessEnv;
-    stdio: ["pipe", "pipe", "pipe"];
-    shell: false;
-    windowsHide: true;
-}
-export type LspSpawnFactory = (command: string, args: readonly string[], options: LspSpawnOptions) => ChildProcessWithoutNullStreams;
-export interface LspSupervisorOptions {
-    serverDefinitions: readonly LspServerDefinition[];
-    spawn?: LspSpawnFactory;
-    requestTimeoutMs?: number;
-    shutdownTimeoutMs?: number;
-    idleTimeoutMs?: number;
-    stderrTailBytes?: number;
-    diagnosticSettleMs?: number;
-}
-export interface LspSupervisorOperationParams {
-    workspaceRoot: string;
-    operation: LspOperation;
-    filePath: string;
-    line?: number;
-    character?: number;
-    newName?: string;
-    includeContext?: boolean;
-}
-export interface LspSupervisor {
-    executeOperation(params: LspSupervisorOperationParams, signal?: AbortSignal): Promise<LspResult>;
-    supportedLanguages(): string[];
-    dispose(): Promise<void>;
-}
-export type LspSupervisorErrorCode = "LSP_SERVER_NOT_CONFIGURED" | "LSP_PATH_OUTSIDE_WORKSPACE" | "LSP_DIAGNOSTICS_UNAVAILABLE" | "LSP_FILE_TOO_LARGE" | "LSP_SUPERVISOR_DISPOSED" | "LSP_PROCESS_ERROR" | "LSP_PROCESS_EXIT" | "LSP_PROTOCOL_ERROR" | "LSP_REQUEST_ABORTED" | "LSP_REQUEST_TIMEOUT" | "LSP_RESPONSE_ERROR";
-export interface LspErrorDiagnostics {
-    serverId?: string;
-    command?: string;
-    pid?: number;
-    exitCode?: number | null;
-    signal?: NodeJS.Signals | null;
-    stderrTail?: string;
-    method?: string;
-    data?: unknown;
-}
-export declare class LspSupervisorError extends Error {
-    readonly code: LspSupervisorErrorCode;
-    readonly diagnostics: LspErrorDiagnostics;
-    constructor(code: LspSupervisorErrorCode, message: string, diagnostics?: LspErrorDiagnostics);
-}
-export declare function buildDefaultLspServerDefinitions(): LspServerDefinition[];
-export declare function createLspSupervisor(options: LspSupervisorOptions): LspSupervisor;

package/dist/types/cli/dev-tools/lsp-tool-service.d.ts

@@ -1,7 +0,0 @@
-import type { LspToolDeps } from "../../skills/tools/lsp-tool.js";
-import type { LspSupervisor } from "./lsp-supervisor.js";
-export interface LspToolServiceOptions {
-    workdir: string;
-    supervisor?: LspSupervisor;
-}
-export declare function createLspToolDeps(options: LspToolServiceOptions): LspToolDeps;

package/dist/types/cli/handlers/media-handler.d.ts

@@ -1,19 +0,0 @@
-/**
- * Media handlers — extracted from StdioServer.
- * Handles: media.listModels, media.cancel, media.status, media.stt
- */
-import { type MediaClient } from "../provider-core-facade.js";
-import { type AgentRpcError, type AgentRpcRequest } from "../../protocol/wire/index.js";
-export interface MediaHandlerHost {
-    mediaClient?: Pick<MediaClient, "getTransport" | "listMediaModels"> | null;
-    sendResponse(id: string | number, result?: unknown, error?: AgentRpcError): void;
-}
-export declare function handleMediaListModels(this: MediaHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleMediaCancel(this: MediaHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleMediaStatus(this: MediaHandlerHost, msg: AgentRpcRequest): Promise<void>;
-/**
- * `media.stt` — Speech-to-text transcription.
- * Accepts base64-encoded audio, calls the designated STT provider (zhipu GLM-ASR-2512).
- * This is a non-session utility: no turn/session is created.
- */
-export declare function handleMediaStt(this: MediaHandlerHost, msg: AgentRpcRequest): Promise<void>;

package/dist/types/cli/handlers/skills-handler.d.ts

@@ -1,37 +0,0 @@
-/**
- * Skills management handlers — extracted from StdioServer.
- * Handles: skills.list, skills.activate, skills.deactivate, skills.delete,
- *          skills.promote, skills.stats, skills.pin, skills.unpin,
- *          skills.curator, skills.lifecycle
- */
-import { type AgentRpcError, type AgentRpcRequest } from "../../protocol/wire/index.js";
-import type { HostCapabilityClient } from "../../transport/host-capability-client.js";
-export interface SkillsHandlerHost {
-    projectLocator?: {
-        resolveProjectRoot(projectId: string): string | undefined;
-    };
-    getActiveProjectRoot(): string;
-    getHostCapabilityClient(): HostCapabilityClient | undefined;
-    sendNotification(method: string, params: Record<string, unknown>): void;
-    sendResponse(id: string | number, result?: unknown, error?: AgentRpcError): void;
-}
-export declare function extractSkillMeta(skillMdPath: string): {
-    version?: string;
-    description?: string;
-};
-export declare function handleSkillsList(this: SkillsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSkillsActivate(this: SkillsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSkillsDeactivate(this: SkillsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSkillsDelete(this: SkillsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSkillsPromote(this: SkillsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-/**
- * Per-project opt-out: mute (or un-mute) a globally-installed skill in ONE project so the agent
- * doesn't see it there — cuts context and mis-triggering without uninstalling the skill. The file
- * stays in the global store and stays active in every other project. This is the "本项目技能" toggle.
- */
-export declare function handleSkillsSetProjectDisabled(this: SkillsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSkillsStats(this: SkillsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSkillsPin(this: SkillsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSkillsUnpin(this: SkillsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSkillsCurator(this: SkillsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSkillsLifecycle(this: SkillsHandlerHost, msg: AgentRpcRequest): Promise<void>;

package/dist/types/cli/industrial-runtime-store.d.ts

@@ -1,16 +0,0 @@
-interface ActiveRuntimeEntry {
-    version: string;
-    entrypoint: string;
-}
-export interface ValidatedActiveIndustrialRuntime extends ActiveRuntimeEntry {
-    absoluteEntrypoint: string;
-}
-export interface IndustrialRuntimeStoreOptions {
-    rootDir?: string;
-}
-/** Read-only projection of the Runtime-owned industrial runtime store. */
-export declare function industrialRuntimeRoot(): string;
-export declare function runtimeEntrypoint(runtimeId: string, options?: IndustrialRuntimeStoreOptions): Promise<string | undefined>;
-export declare function activeIndustrialRuntime(runtimeId: string, options?: IndustrialRuntimeStoreOptions): Promise<ValidatedActiveIndustrialRuntime | undefined>;
-export declare function runtimePathEntries(options?: IndustrialRuntimeStoreOptions): Promise<string[]>;
-export {};

package/dist/types/cli/media-capability-schema.d.ts

@@ -1,49 +0,0 @@
-import type { MediaCapability, MediaRequest } from "./provider-core-facade.js";
-export type MediaMode = "text2image" | "img2img" | "inpainting" | "outpainting" | "text2video" | "img2video" | "first_last_frame" | "video2video" | "multimodal_reference" | "edit" | "merge" | "upscale" | "extend" | "text2music" | "cover" | "realtime" | "text2speech" | "voice_clone" | "text2_3d" | "img2_3d" | "speech2text";
-export interface MediaCapabilityLimits {
-    sizes?: string[];
-    resolutions?: string[];
-    aspectRatios?: string[];
-    fps?: number[];
-    durationSeconds?: {
-        min?: number;
-        max?: number;
-    };
-    maxReferenceImages?: number;
-    maxReferenceVideos?: number;
-    maxReferenceAudios?: number;
-    maxSourceVideos?: number;
-    maxOutputs?: number;
-    voices?: string[];
-    maxCharacters?: number;
-    formats?: string[];
-    outputFormats?: string[];
-}
-export interface MediaCapabilityFeatures {
-    transparentBackground?: boolean;
-    generateAudio?: boolean;
-    returnLastFrame?: boolean;
-    serviceTiers?: string[];
-    videoTools?: string[];
-}
-export interface NormalizedMediaCapabilitySchema {
-    mediaType: MediaCapability;
-    modes: MediaMode[];
-    declaredModes: MediaMode[];
-    limits: MediaCapabilityLimits;
-    features: MediaCapabilityFeatures;
-    source: "declared" | "fallback";
-    raw?: Record<string, unknown>;
-}
-export type MediaCapabilityDecision = {
-    allowed: true;
-    mode: MediaMode;
-    reason?: undefined;
-} | {
-    allowed: false;
-    mode: MediaMode;
-    reason: string;
-};
-export declare function normalizeMediaCapabilitySchema(mediaType: MediaCapability, rawCapabilities: unknown): NormalizedMediaCapabilitySchema;
-export declare function resolveMediaCapabilityDecision(request: MediaRequest, schema: NormalizedMediaCapabilitySchema): MediaCapabilityDecision;
-export declare function buildMediaToolParameterSchema(toolName: string, baseSchema: Record<string, unknown>, capability: NormalizedMediaCapabilitySchema): Record<string, unknown>;

package/dist/types/cli/media-file-api-service.d.ts

@@ -1,73 +0,0 @@
-import { type MediaCapability, type VolcengineFileTransport } from "./provider-core-facade.js";
-export interface MediaFileApiProvider {
-    id: string;
-    type: "volcengine" | "gemini";
-}
-export interface MediaFileServiceContext {
-    mediaClient: {
-        getTransport(providerId: string): unknown;
-    } | undefined;
-    mediaProviders: Partial<Record<MediaCapability, {
-        provider: string;
-        model: string;
-    }>>;
-    mediaApiKeys: Record<string, string>;
-}
-export interface MediaFileUploadInput {
-    buffer: Buffer;
-    filename: string;
-    mimeType: string;
-    bytes: number;
-    purpose?: string;
-}
-export interface MediaFileUploadResult {
-    fileId: string;
-    url?: string;
-    filename: string;
-    bytes: number;
-    provider: string;
-}
-export interface MediaFileInfo {
-    id: string;
-    filename: string;
-    bytes: number;
-    status: string;
-    createdAt?: string;
-    url?: string;
-}
-interface GeminiFileInfo {
-    name: string;
-    uri?: string;
-    state?: string;
-    displayName?: string;
-    sizeBytes?: string | number;
-    createTime?: string;
-}
-interface GeminiFileApiClient {
-    uploadFile(buffer: Buffer, apiKey: string, options: {
-        mimeType: string;
-        displayName: string;
-    }): Promise<GeminiFileInfo>;
-    waitForProcessing(fileName: string, apiKey: string): Promise<GeminiFileInfo>;
-    getFile(fileId: string, apiKey: string): Promise<GeminiFileInfo>;
-    listFiles(apiKey: string, options: {
-        pageSize: number;
-    }): Promise<{
-        files: GeminiFileInfo[];
-    }>;
-    deleteFile(fileId: string, apiKey: string): Promise<void>;
-}
-export interface MediaFileApiServiceDeps {
-    createGeminiFileApi?: () => GeminiFileApiClient;
-    isVolcengineFileTransport?: (transport: unknown) => transport is VolcengineFileTransport;
-}
-export interface MediaFileApiService {
-    resolveProvider(context: MediaFileServiceContext): MediaFileApiProvider | undefined;
-    uploadFile(context: MediaFileServiceContext, input: MediaFileUploadInput): Promise<MediaFileUploadResult>;
-    queryFile(context: MediaFileServiceContext, fileId: string): Promise<MediaFileInfo>;
-    listFiles(context: MediaFileServiceContext, limit: number): Promise<MediaFileInfo[]>;
-    deleteFile(context: MediaFileServiceContext, fileId: string): Promise<void>;
-}
-export declare function createMediaFileApiService(deps?: MediaFileApiServiceDeps): MediaFileApiService;
-export declare const defaultMediaFileApiService: MediaFileApiService;
-export {};

package/dist/types/cli/media-file-tool-service.d.ts

@@ -1,13 +0,0 @@
-import type { FileDeleteToolDeps, FileQueryToolDeps, FileUploadToolDeps } from "../skills/tools/file-management-tool.js";
-import { type MediaFileApiService, type MediaFileServiceContext } from "./media-file-api-service.js";
-export interface MediaFileToolServiceOptions {
-    getContext(): MediaFileServiceContext;
-    resolvePath(filePath: string): string;
-    mediaFileApiService?: MediaFileApiService;
-    maxUploadBytes?: number;
-}
-export interface MediaFileToolService extends FileUploadToolDeps, FileQueryToolDeps, FileDeleteToolDeps {
-    isAvailable(): boolean;
-}
-export declare function createMediaFileToolService(options: MediaFileToolServiceOptions): MediaFileToolService;
-export declare function isMediaFileApiAvailable(context: MediaFileServiceContext, apiService?: MediaFileApiService): boolean;

package/dist/types/cli/media-inline.d.ts

@@ -1,31 +0,0 @@
-/**
- * Resolve a media reference into a form a REMOTE model can consume, by rewriting a LOCAL file path to
- * the gateway's `/api/media/local?src=file://…` proxy URL.
- *
- * Why the proxy URL (not a raw path, not base64, not the provider file-API upload):
- *  - A tool result (e.g. the `read` tool reading a workspace image) carries a RAW local path
- *    (`C:\…\assets\images\x.jpg`) a remote model cannot fetch → the understanding model returns empty.
- *  - A base64 `data:` URL blows past the LLM gateway's request-size limit → HTTP 413.
- *  - The provider file-API upload (media-file-api-service) needs a Files-API provider that isn't always
- *    configured → "no provider".
- *  - The `127.0.0.1/api/media/local` proxy URL is exactly what user-attachments use: provider-core's
- *    FileUploadAdapter (given QLOGICAGENT_HUB_URL) relays it to hub OSS → a small public URL. Proven path.
- *
- * Remote (`http`/`https`/`data`/`blob`) URLs, non-media extensions, and missing files pass through
- * unchanged. Never throws.
- */
-export declare function resolveLocalMediaForModel(url: string): string;
-/**
- * Resolve an IMAGE reference for an understanding call, preferring a self-contained base64 `data:` URL
- * for a small LOCAL image over the upload path. A local image inlined as base64 is delivered inside the
- * request (the model provider fetches nothing), so it sidesteps the whole local→upload→OSS→signed-URL
- * chain that a text main model's image understanding otherwise depends on (an unsigned private-OSS URL
- * the provider 403s on is the classic silent-empty fault). Behavior:
- *  - `data:` URL → returned as-is (already inline).
- *  - public `http(s)`/`blob:` URL → returned as-is (the provider fetches it server-side).
- *  - LOCAL image (raw path / `file://` / the 127.0.0.1 media-proxy URL) within the inline ceiling →
- *    read + base64 `data:` URL.
- *  - LOCAL image over the ceiling (or unreadable) → fall back to resolveLocalMediaForModel (proxy/upload).
- * Only images inline as base64 — video is far too large, so it always takes the URL path. Never throws.
- */
-export declare function resolveImageForUnderstanding(url: string): string;

package/dist/types/cli/media-runtime-facade.d.ts

@@ -1,51 +0,0 @@
-import { type MediaCapability, type MediaClient, type MediaRequest, type MediaResult, type ProviderToolAPI } from "./provider-core-facade.js";
-import type { MediaFileServiceContext } from "./media-file-api-service.js";
-export interface MediaUsageCallbackEvent {
-    mediaType: string;
-    provider: string;
-    model: string;
-    billingUnit: string;
-    billingQuantity: number;
-}
-export interface MediaCapabilityCheckEvent {
-    mediaType: string;
-    provider: string;
-    model: string;
-    mode: string;
-    allowed: boolean;
-    reason?: string;
-    capabilities: {
-        modes: string[];
-        source: string;
-        limits: Record<string, unknown>;
-        features: Record<string, unknown>;
-    };
-}
-export declare function setProviderToolAPI(api: ProviderToolAPI | undefined): void;
-export declare function getProviderToolAPI(): ProviderToolAPI | undefined;
-export declare function setMediaClientConfig(client: MediaClient | undefined, apiKeys?: Record<string, string>, onMediaUsage?: (event: MediaUsageCallbackEvent) => void, providers?: Partial<Record<MediaCapability, {
-    provider: string;
-    model: string;
-}>>, onMediaProgress?: (taskId: string, mediaType: string, percent: number, status: string, provider?: string) => void, onMediaCapabilityCheck?: (event: MediaCapabilityCheckEvent) => void): void;
-export declare function getMediaRuntimeContext(): MediaFileServiceContext;
-export declare function runWithMediaOutputDir<T>(outputDir: string | undefined, fn: () => Promise<T>): Promise<T>;
-export declare function generateMedia(request: MediaRequest): Promise<MediaResult>;
-/**
- * Ensure an image size satisfies the resolved model's minimum resolution.
- * Only applies to models with a known minimum (Volcengine Seedream); everything
- * else is returned unchanged so providers that require small sizes (e.g. OpenAI
- * 1024×1024) keep working. Sub-minimum "WxH" sizes are scaled up preserving
- * aspect ratio; anything unparseable falls back to the always-valid named "2K".
- */
-export declare function normalizeImageSize(size: string | undefined, providerId: string | undefined, modelId: string | undefined): string | undefined;
-export declare function isMediaAvailable(mediaType: string): boolean;
-export declare function isMediaOperationAvailable(mediaType: string, operation: string): boolean;
-export declare function isMediaOperationDeclaredAvailable(mediaType: string, operation: string): boolean;
-export declare function generateMusicLyrics(prompt: string): Promise<string>;
-export declare function cancelMediaTask(params: {
-    taskId: string;
-    provider?: string;
-}): Promise<{
-    ok: boolean;
-    message: string;
-}>;