@qqbrowser/qbot-dsh 0.0.3 → 0.0.6

package/node_modules/@qqbrowser/qbot-dsh-tool-subagent-control/lib/types/list-agents.js

@@ -0,0 +1,2 @@
+var l=Object.defineProperty;var a=(t,e)=>l(t,"name",{value:e,configurable:!0});import{defineTool as p}from"@qqbrowser/qbot-dsh-tools";import{assertNever as c}from"@qqbrowser/qbot-dsh-llm";export const name="tool-subagent-list-agents",inject=["tools","subagents","agents"];function o(t){return{scope:t.scope??"children"}}a(o,"resolveListAgentsRequest");function g(t,e){const n=t.get(e);return n===void 0?"ready":n.status==="running"?"running":"idle"}a(g,"statusOf");function u(t,e,n){const i=n===void 0?{}:{parent:n.parentId,depth:n.depth};if(e.kind==="diagnostic")return{kind:"diagnostic",id:e.id,reason:e.reason,...i};if(e.mode==="continuable")return{kind:"child",id:e.id,label:e.label,status:g(t,e.id),...i}}a(u,"project");export function apply(t){t.tools.register(p({name:"list_agents",description:"List your continuable background subagents by durable id and label. Use it to recall which ones you started, not to poll for completion — you are told when one finishes. Status comes from the live registry: running means the agent is working right now, idle means it is loaded but between turns (it may be waiting on agents it started), and ready means it exists only in storage — resumable, not terminal, and not a result waiting to be collected; a `send_message` starts a new turn on the same conversation, and a direct child remains a `send_message` candidate in every status. The snapshot is not a delivery promise — `send_message` performs the authoritative check and may still fail. Children that could not be read are reported as diagnostics instead of being silently dropped. Scope `descendants` walks the whole tree below you in stable pre-order, annotating each entry with its durable direct-parent session id and depth. You may use `send_message` only for depth-1 entries; deeper entries are candidates for `interrupt_agent` only.",parameters:{scope:{type:"string",enum:["children","descendants"],description:"children (default) lists direct children only; descendants walks the complete tree below you."}},output:{schema:{type:"array",items:{oneOf:[{type:"object",additionalProperties:!1,properties:{kind:{type:"string",required:!0,enum:["child"]},id:{type:"string",required:!0},label:{type:"string",required:!0},status:{type:"string",required:!0,enum:["running","idle","ready"]},parent:{type:"string"},depth:{type:"number"}}},{type:"object",additionalProperties:!1,properties:{kind:{type:"string",required:!0,enum:["diagnostic"]},id:{type:"string",required:!0},reason:{type:"string",required:!0,enum:["corrupt","unsupported","unavailable"]},parent:{type:"string"},depth:{type:"number"}}}]}},render:a((e,n)=>{const i=o(e);return[{type:"text",text:n.length===0?"(no subagents)":n.map(s=>{const d=i.scope==="descendants"?` parent=${String(s.parent)} depth=${String(s.depth)}`:"";return s.kind==="child"?`${s.id} [${s.status}]${d} — ${s.label}`:`${s.id} [diagnostic: ${s.reason}]${d}`}).join(`
+`)}]},"render")},async execute(e,n){const i=n.agent;if(!i)throw new Error("list_agents requires a calling agent (exec.agent was undefined)");const s=o(e);switch(s.scope){case"children":return(await t.subagents.listChildren(i.id,n.signal)).map(r=>u(t.agents,r)).filter(r=>r!==void 0);case"descendants":return(await t.subagents.listDescendants(i.id,n.signal)).map(r=>u(t.agents,r,r)).filter(r=>r!==void 0);default:return c(s.scope,"list_agents scope")}}}))}a(apply,"apply");

package/node_modules/@qqbrowser/qbot-dsh-tool-subagent-control/package.json

@@ -0,0 +1 @@
+{"name":"@qqbrowser/qbot-dsh-tool-subagent-control","version":"0.0.6","publishConfig":{"access":"public"},"type":"module","main":"lib/index.js","exports":{".":{"types":"./lib/types/index.d.ts","default":"./lib/index.js"},"./invariant":{"types":"./lib/types/invariant.d.ts","default":"./lib/invariant.js"},"./list-agents":{"types":"./lib/types/list-agents.d.ts","default":"./lib/types/list-agents.js"},"./src/*":"./src/*","./package.json":"./package.json"},"license":"MIT","peerDependencies":{"@qqbrowser/qbot-dsh-invariants":"^0.0.6","@qqbrowser/qbot-dsh-llm":"^0.0.6","@qqbrowser/qbot-dsh-session":"^0.0.6","@qqbrowser/qbot-dsh-subagent":"^0.0.6","@deepseek-ai/cordis":"^4.0.1","@qqbrowser/qbot-dsh-tools":"^0.0.6"}}

package/node_modules/@qqbrowser/qbot-dsh-tool-subagent-report/lib/index.js

@@ -0,0 +1 @@
+var d=Object.defineProperty;var a=(r,o)=>d(r,"name",{value:o,configurable:!0});import u from"@deepseek-ai/schemastery";import{defineTool as g}from"@qqbrowser/qbot-dsh-tools";const h="tool-subagent-report",y=["subagents","tools","systemPrompt"],f=117,p=u.object({reportDelivery:u.union(["quiet","wakeup"]).default("wakeup")});function c(r,o,s){const n=r.systemPrompt.section({name:"tool:report",order:f,text:'Deliver your result with the report tool before you finish: call it once with a self-contained answer. The agent that started you shares your workspace but does not automatically receive your transcript, tool output, or reasoning, so a closing remark such as "done" leaves it nothing it can use. Report earlier as well whenever a partial finding changes what that agent should do next; reporting never ends your turn.'});let l;try{l=r.tools.register(g({name:"report",description:"Report selected content to the agent that started you. Call this once before you finish, with a self-contained final result, and earlier for progress or findings that change what that agent does next. That agent shares your workspace but does not automatically receive your transcript, tool output, or reasoning, so finishing your work is not itself a result. Reporting does not end your turn or finish your work, and only your direct parent receives it. A failed call may still have arrived, so do not blindly repeat it.",parameters:{output:{type:"string",required:!0,description:"Actionable content for your parent; summarize conclusions and reference relevant shared paths."}},output:{schema:{type:"object",additionalProperties:!1,properties:{messageId:{type:"string",required:!0}}},render:a((e,t)=>[{type:"text",text:`report accepted by the agent that started you as message ${t.messageId}`}],"render")},async execute(e,t){const i=[{type:"text",text:e.output}];return{messageId:await o.subagents.reportFrom(t.agent,i,{delivery:s,signal:t.signal})}}}))}catch(e){try{n()}catch(t){throw new AggregateError([e,t],"failed to register the report tool and roll back its prompt guidance")}throw e}return()=>{const e=[];for(const t of[l,n])try{t()}catch(i){e.push(i)}if(e.length>0)throw new AggregateError(e,"failed to revoke report tool and prompt registrations")}}a(c,"installReportTool");function m(r,o={}){const{reportDelivery:s}=p(o);r.subagents.registerContinuableSetup(n=>c(n,r,s))}a(m,"apply");export{p as Config,m as apply,y as inject,c as installReportTool,h as name};

package/node_modules/@qqbrowser/qbot-dsh-tool-subagent-report/lib/invariant.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var n=(t,o)=>s(t,"name",{value:o,configurable:!0});const r="@qqbrowser/qbot-dsh-tool-subagent-report",e="tool-subagent-report-invariant",a=["invariants"],i=n(()=>{},"install"),c=n(t=>Promise.resolve(t.invariants.register(r,i)),"apply");export{c as apply,a as inject,e as name};

package/node_modules/@qqbrowser/qbot-dsh-tool-subagent-report/package.json

@@ -0,0 +1 @@
+{"name":"@qqbrowser/qbot-dsh-tool-subagent-report","version":"0.0.6","publishConfig":{"access":"public"},"type":"module","main":"lib/index.js","exports":{".":{"types":"./lib/types/index.d.ts","default":"./lib/index.js"},"./invariant":{"types":"./lib/types/invariant.d.ts","default":"./lib/invariant.js"},"./src/*":"./src/*","./package.json":"./package.json"},"license":"MIT","peerDependencies":{"@qqbrowser/qbot-dsh-invariants":"^0.0.6","@qqbrowser/qbot-dsh-subagent":"^0.0.6","@qqbrowser/qbot-dsh-llm":"^0.0.6","@qqbrowser/qbot-dsh-system-prompt":"^0.0.6","@deepseek-ai/cordis":"^4.0.1","@qqbrowser/qbot-dsh-tools":"^0.0.6"},"dependencies":{"@deepseek-ai/schemastery":"^3.18.1"}}

package/node_modules/@qqbrowser/qbot-dsh-tool-todo/lib/index.js

@@ -0,0 +1 @@
+var g=Object.defineProperty;var o=(i,a)=>g(i,"name",{value:a,configurable:!0});import l from"@deepseek-ai/schemastery";import{z as s}from"zod";import{defineTool as m}from"@qqbrowser/qbot-dsh-tools";const w="tool-todo",y=["tools"],c=["pending","in_progress","completed"],h=l.object({allowParallelInProgress:l.boolean().required()}),f="Record and update a structured task list for the current work. Send the ENTIRE list every call — it REPLACES the previous list (there are no partial updates, no per-item edits). Use it to plan multi-step work and show progress: add one todo per concrete step before you start. ",P="Mark every todo being actively worked on `in_progress` — several at once when work genuinely runs in parallel (e.g. concurrent subagents or background commands), one for sequential work; while work remains, at least one task should be `in_progress`. ",k="Keep AT MOST ONE todo `in_progress` at a time; while work remains, exactly one active task should be `in_progress`. ",E="Mark a todo `completed` the moment it is done (do not batch completions), and allow no `in_progress` item only once all work is complete. Skip the list for trivial single-step tasks. Statuses: `pending` (not started), `in_progress` (being worked on now), `completed` (finished).";function _(i){return f+(i?P:k)+E}o(_,"describe");function b(i,a){const d=[],r=new Set;let e=0;for(const t of i){const n=t.content.trim();if(n.length===0)throw new Error("invalid todo: `content` must be a non-empty string");if(r.has(n))throw new Error(`invalid todos: duplicate content ${JSON.stringify(n)}`);r.add(n),t.status==="in_progress"&&e++,d.push({content:n,status:t.status})}if(!a&&e>1)throw new Error(`invalid todos: at most one task may be in_progress (got ${e})`);return d}o(b,"toTodoList");const S=s.union([s.array(s.object({content:s.string(),status:s.union([s.literal("pending"),s.literal("in_progress"),s.literal("completed")])})),s.null()]);function I(i,a){const d=a.allowParallelInProgress;i.inject(["sessionProjections"],r=>{r.sessionProjections.register({key:"todos",schema:S,init:o(()=>null,"init"),apply:o((e,t)=>t.type==="todo/write"?t.data.todos:t.type==="turn/start"?null:e,"apply"),view:o(e=>e,"view"),stateVersion:2})}),i.tools.register(m({name:"todo_write",description:_(d),parameters:{todos:{type:"array",required:!0,description:"The COMPLETE task list, replacing any previous list.",items:{type:"object",additionalProperties:!1,properties:{content:{type:"string",required:!0,description:"What the task is — a short imperative line."},status:{type:"string",required:!0,enum:[...c],description:"pending (not started) | in_progress (now) | completed (done)."}}}}},output:{schema:{type:"object",additionalProperties:!1,properties:{todos:{type:"array",required:!0,items:{type:"object",additionalProperties:!1,properties:{content:{type:"string",required:!0},status:{type:"string",required:!0,enum:[...c]}}}},counts:{type:"object",additionalProperties:!1,required:!0,properties:{pending:{type:"integer",required:!0},inProgress:{type:"integer",required:!0},completed:{type:"integer",required:!0}}}}},render:o((r,e)=>[{type:"text",text:`Updated todo list: ${e.counts.pending} pending, ${e.counts.inProgress} in progress, ${e.counts.completed} completed.`}],"render")},execute(r,e){const t=b(r.todos,d);if(!e.agent)throw new Error("todo_write requires an owning agent session");e.agent.session.append("todo/write",{todos:t});const n=o(p=>t.filter(u=>u.status===p).length,"count");return Promise.resolve({todos:t.map(p=>({content:p.content,status:p.status})),counts:{pending:n("pending"),inProgress:n("in_progress"),completed:n("completed")}})},presentCall:o(r=>({card:"generic",title:"Update todo list",kind:"other",rawInput:r.todos}),"presentCall")}))}o(I,"apply");export{h as Config,I as apply,y as inject,w as name};

package/node_modules/@qqbrowser/qbot-dsh-tool-todo/lib/invariant.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var r=(t,o)=>c(t,"name",{value:o,configurable:!0});const d="@qqbrowser/qbot-dsh-tool-todo",f=new Set(["pending","in_progress","completed"]),p="tool-todo-invariant",m=["invariants"];function y(t,o){Array.isArray(t)||o("todo/write todos must be an array");const s=new Set;for(const n of t){(typeof n!="object"||n===null)&&o("todo/write entries must be objects");const{content:e,status:i}=n;(typeof e!="string"||e.length===0||e.trim()!==e)&&o("todo/write content must be non-empty and already trimmed"),s.has(e)&&o(`todo/write repeats content ${JSON.stringify(e)}`),s.add(e),(typeof i!="string"||!f.has(i))&&o(`todo/write carries unknown status ${JSON.stringify(i)}`)}}r(y,"validateTodos");function a(t,o){t.type==="todo/write"&&y(t.data.todos,o)}r(a,"validateEvent");const l=Object.assign((t,o)=>{for(const s of t.sessions.list())for(const n of s.events)a(n,o);t.on("internal/dispatch",(s,n,e)=>{if(n!=="session/event")return;const i=e[1];a(i,o)},{global:!0})},{inject:["sessions"]}),g=r(t=>Promise.resolve(t.invariants.register(d,l)),"apply");export{g as apply,m as inject,p as name};

package/node_modules/@qqbrowser/qbot-dsh-tool-todo/lib/types/index.js

@@ -0,0 +1 @@
+var g=Object.defineProperty;var o=(i,a)=>g(i,"name",{value:a,configurable:!0});import l from"@deepseek-ai/schemastery";import{z as s}from"zod";import{defineTool as m}from"@qqbrowser/qbot-dsh-tools";export const name="tool-todo",inject=["tools"];const c=["pending","in_progress","completed"];export const Config=l.object({allowParallelInProgress:l.boolean().required()});const w="Record and update a structured task list for the current work. Send the ENTIRE list every call — it REPLACES the previous list (there are no partial updates, no per-item edits). Use it to plan multi-step work and show progress: add one todo per concrete step before you start. ",y="Mark every todo being actively worked on `in_progress` — several at once when work genuinely runs in parallel (e.g. concurrent subagents or background commands), one for sequential work; while work remains, at least one task should be `in_progress`. ",h="Keep AT MOST ONE todo `in_progress` at a time; while work remains, exactly one active task should be `in_progress`. ",f="Mark a todo `completed` the moment it is done (do not batch completions), and allow no `in_progress` item only once all work is complete. Skip the list for trivial single-step tasks. Statuses: `pending` (not started), `in_progress` (being worked on now), `completed` (finished).";function P(i){return w+(i?y:h)+f}o(P,"describe");function k(i,a){const d=[],r=new Set;let e=0;for(const t of i){const n=t.content.trim();if(n.length===0)throw new Error("invalid todo: `content` must be a non-empty string");if(r.has(n))throw new Error(`invalid todos: duplicate content ${JSON.stringify(n)}`);r.add(n),t.status==="in_progress"&&e++,d.push({content:n,status:t.status})}if(!a&&e>1)throw new Error(`invalid todos: at most one task may be in_progress (got ${e})`);return d}o(k,"toTodoList");const E=s.union([s.array(s.object({content:s.string(),status:s.union([s.literal("pending"),s.literal("in_progress"),s.literal("completed")])})),s.null()]);export function apply(i,a){const d=a.allowParallelInProgress;i.inject(["sessionProjections"],r=>{r.sessionProjections.register({key:"todos",schema:E,init:o(()=>null,"init"),apply:o((e,t)=>t.type==="todo/write"?t.data.todos:t.type==="turn/start"?null:e,"apply"),view:o(e=>e,"view"),stateVersion:2})}),i.tools.register(m({name:"todo_write",description:P(d),parameters:{todos:{type:"array",required:!0,description:"The COMPLETE task list, replacing any previous list.",items:{type:"object",additionalProperties:!1,properties:{content:{type:"string",required:!0,description:"What the task is — a short imperative line."},status:{type:"string",required:!0,enum:[...c],description:"pending (not started) | in_progress (now) | completed (done)."}}}}},output:{schema:{type:"object",additionalProperties:!1,properties:{todos:{type:"array",required:!0,items:{type:"object",additionalProperties:!1,properties:{content:{type:"string",required:!0},status:{type:"string",required:!0,enum:[...c]}}}},counts:{type:"object",additionalProperties:!1,required:!0,properties:{pending:{type:"integer",required:!0},inProgress:{type:"integer",required:!0},completed:{type:"integer",required:!0}}}}},render:o((r,e)=>[{type:"text",text:`Updated todo list: ${e.counts.pending} pending, ${e.counts.inProgress} in progress, ${e.counts.completed} completed.`}],"render")},execute(r,e){const t=k(r.todos,d);if(!e.agent)throw new Error("todo_write requires an owning agent session");e.agent.session.append("todo/write",{todos:t});const n=o(p=>t.filter(u=>u.status===p).length,"count");return Promise.resolve({todos:t.map(p=>({content:p.content,status:p.status})),counts:{pending:n("pending"),inProgress:n("in_progress"),completed:n("completed")}})},presentCall:o(r=>({card:"generic",title:"Update todo list",kind:"other",rawInput:r.todos}),"presentCall")}))}o(apply,"apply");

package/node_modules/@qqbrowser/qbot-dsh-tool-todo/lib/types/invariant.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var r=(t,o)=>c(t,"name",{value:o,configurable:!0});const d="@qqbrowser/qbot-dsh-tool-todo",f=new Set(["pending","in_progress","completed"]);export const name="tool-todo-invariant",inject=["invariants"];function p(t,o){Array.isArray(t)||o("todo/write todos must be an array");const s=new Set;for(const n of t){(typeof n!="object"||n===null)&&o("todo/write entries must be objects");const{content:e,status:i}=n;(typeof e!="string"||e.length===0||e.trim()!==e)&&o("todo/write content must be non-empty and already trimmed"),s.has(e)&&o(`todo/write repeats content ${JSON.stringify(e)}`),s.add(e),(typeof i!="string"||!f.has(i))&&o(`todo/write carries unknown status ${JSON.stringify(i)}`)}}r(p,"validateTodos");function a(t,o){t.type==="todo/write"&&p(t.data.todos,o)}r(a,"validateEvent");const m=Object.assign((t,o)=>{for(const s of t.sessions.list())for(const n of s.events)a(n,o);t.on("internal/dispatch",(s,n,e)=>{if(n!=="session/event")return;const i=e[1];a(i,o)},{global:!0})},{inject:["sessions"]});export const apply=r(t=>Promise.resolve(t.invariants.register(d,m)),"apply");

package/node_modules/@qqbrowser/qbot-dsh-tool-todo/package.json

@@ -0,0 +1 @@
+{"name":"@qqbrowser/qbot-dsh-tool-todo","version":"0.0.6","publishConfig":{"access":"public"},"type":"module","main":"lib/index.js","exports":{".":{"types":"./lib/types/index.d.ts","default":"./lib/index.js"},"./invariant":{"types":"./lib/types/invariant.d.ts","default":"./lib/invariant.js"},"./client":{"types":"./lib/types/client.d.ts","default":"./lib/types/client.js"},"./src/*":"./src/*","./package.json":"./package.json"},"license":"MIT","dependencies":{"zod":"^4.4.3","@deepseek-ai/schemastery":"^3.18.1"},"peerDependencies":{"@qqbrowser/qbot-dsh-agent":"^0.0.6","@qqbrowser/qbot-dsh-invariants":"^0.0.6","@qqbrowser/qbot-dsh-session":"^0.0.6","@qqbrowser/qbot-dsh-session-projection":"^0.0.6","@deepseek-ai/cordis":"^4.0.1","@qqbrowser/qbot-dsh-tools":"^0.0.6"}}

package/node_modules/@qqbrowser/qbot-dsh-tool-web/lib/index.js

@@ -0,0 +1,11 @@
+var N=Object.defineProperty;var i=(e,t)=>N(e,"name",{value:t,configurable:!0});import l from"@deepseek-ai/schemastery";import{defineTool as g}from"@qqbrowser/qbot-dsh-tools";import I from"turndown";import{gfm as H}from"@joplin/turndown-plugin-gfm";import{assertNever as W}from"@qqbrowser/qbot-dsh-llm";const B=8;function w(e){if(e.query.trim().length===0)throw new Error("query must be a non-empty string");return{query:e.query}}i(w,"parseSearchArgs");function D(e,t){if(t!==void 0&&t.length>0)return t;try{return new URL(e).hostname}catch{return e}}i(D,"sourceLabel");function T(e){const t=[];if(e.content!==void 0&&e.content.length>0&&t.push(e.content),e.sources.length>0){const r=e.sources.map(n=>{const o=D(n.url,n.title),s=[];n.snippet!==void 0&&n.snippet.length>0&&s.push(n.snippet),n.publishedAt!==void 0&&n.publishedAt.length>0&&s.push(`(${n.publishedAt})`);const c=s.length>0?` — ${s.join(" ")}`:"";return`- [${o}](${n.url})${c}`});t.push(`Sources:
+${r.join(`
+`)}`)}else(e.content===void 0||e.content.length===0)&&t.push("No results found.");return e.truncated&&t.push(`(Showing the first ${e.sources.length} sources. Refine the query for more.)`),t.push("Cite the relevant URLs above as markdown links in your answer."),t.join(`
+
+`)}i(T,"formatSearchOutput");function v(e){return{card:"generic",title:e.query,kind:"search",rawInput:e.query}}i(v,"presentSearchCall");function A(e){return{url:e.url,...e.title!==void 0?{title:e.title}:{},...e.snippet!==void 0?{snippet:e.snippet}:{},...e.publishedAt!==void 0?{publishedAt:e.publishedAt}:{}}}i(A,"projectSource");function R(e){return{sources:e.sources.map(A),truncated:e.truncated,...e.content!==void 0?{answer:e.content}:{}}}i(R,"searchMetaFromValue");function V(e){if(typeof e!="object"||e===null||Array.isArray(e))return!1;const{url:t,title:r,snippet:n,publishedAt:o}=e;return typeof t=="string"&&(r===void 0||typeof r=="string")&&(n===void 0||typeof n=="string")&&(o===void 0||typeof o=="string")}i(V,"isWebSource");function x(e){if(typeof e!="object"||e===null||Array.isArray(e))return;const{sources:t,truncated:r,answer:n}=e;if(!(!Array.isArray(t)||!t.every(V))&&typeof r=="boolean"&&!(n!==void 0&&typeof n!="string"))return{sources:t,truncated:r,...n!==void 0?{answer:n}:{}}}i(x,"searchMetaFromResult");function M(e,t){if(t.isError)return;const r=x(t.meta);if(r!==void 0)return{card:"web",kind:"search",title:e.query,sources:r.sources,truncated:r.truncated,...r.answer!==void 0?{answer:r.answer}:{}}}i(M,"presentSearchResult");function E(e,t,r,n){e.systemPrompt.section({name:"tool:web_search",order:110,text:n?"Use the web_search tool to discover current information on the web. It returns an optional answer plus a list of source URLs. Follow up with web_fetch when you need the full content of a specific result, and cite the relevant URLs as markdown links.":"Use the web_search tool to discover current information on the web. It returns an optional answer plus a list of source URLs. Use the returned source snippets when available, and cite the relevant URLs as markdown links."}),e.tools.register(g({name:"web_search",description:"Search the web for current information. Returns an optional summary answer and a list of source URLs.",parameters:{query:{type:"string",required:!0,description:"The search query."}},output:{schema:{type:"object",additionalProperties:!1,properties:{content:{type:"string"},sources:{type:"array",required:!0,items:{type:"object",additionalProperties:!1,properties:{url:{type:"string",required:!0},title:{type:"string"},snippet:{type:"string"},publishedAt:{type:"string"}}}},truncated:{type:"boolean",required:!0}}},render:i((o,s)=>[{type:"text",text:T(s)}],"render"),presentationMeta:i((o,s)=>R(s),"presentationMeta")},timeoutMs:r,isConcurrencySafe:i(()=>!0,"isConcurrencySafe"),async execute(o,s){const c=w(o),a=await e.web.search({query:c.query,maxResults:t},s.signal);return{...a.content!==void 0?{content:a.content}:{},sources:a.sources.map(A),truncated:a.truncated}},presentCall:v,presentResult:i((o,s)=>M(o,s),"presentResult")}))}i(E,"applyWebSearchTool");const f=new I({headingStyle:"atx",codeBlockStyle:"fenced",bulletListMarker:"-"});f.use(H),f.remove(["script","style","noscript"]);function S(e,t){return`${t===0?"| ":" "}${e.trim().replace(/\n\r/g,"<br>").replace(/\n/g,"<br>").replace(/\|+/g,"\\|").padEnd(3," ")} |`}i(S,"renderTableCell");function X(e){const t=Array.from(e.cells),r=e.parentElement,n=r.parentElement;return(r.nodeName==="THEAD"||n.rows[0]===e)&&t.every(o=>o.nodeName==="TH")}i(X,"isTableHeadingRow");function z(e){const t=(e.getAttribute("align")||e.style.textAlign||"").toLowerCase();return t==="left"?":---":t==="right"?"---:":t==="center"?":---:":"---"}i(z,"tableBorder"),f.addRule("tableCellWithoutSpanExpansion",{filter:["th","td"],replacement(e,t){const r=t,n=r.parentNode;return S(e,Array.prototype.indexOf.call(n.childNodes,r))}}),f.addRule("tableRowWithoutSpanExpansion",{filter:"tr",replacement(e,t){const r=t,n=X(r)?Array.from(r.cells,(o,s)=>S(z(o),s)).join(""):"";return`
+${e}${n.length>0?`
+${n}`:""}`}});function _(e){if(e.url.trim().length===0)throw new Error("url must be a non-empty string");return{url:e.url}}i(_,"parseFetchArgs");const Z=512,G=new Set(["area","base","br","col","embed","hr","img","input","link","meta","param","source","track","wbr"]),J=new Set(["script","style","noscript"]);function K(e){return e===void 0||e===">"||e==="/"||/\s/.test(e)}i(K,"isTagBoundary");function Q(e,t,r){const n=`</${t}`;let o=e.indexOf(n,r);for(;o!==-1&&!K(e[o+n.length]);)o=e.indexOf(n,o+n.length);return o}i(Q,"findRawTextEnd");function Y(e){const t=e.toLowerCase(),r=[];let n=0,o=!1;for(;n<e.length;){const s=e.indexOf("<",n);if(o){const u=e.indexOf("-->",n);if(u!==-1&&(s===-1||u<s)){o=!1,n=u+3;continue}}if(s===-1)break;if(!o&&e.startsWith("<!--",s)){o=!0,n=s+4;continue}let c=s+1;const a=e[c]==="/";a&&(c+=1);const y=c;for(;/[a-zA-Z0-9-]/.test(e[c]??"");)c+=1;if(c===y||!/[a-zA-Z]/.test(e.charAt(y))){n=s+1;continue}const d=t.slice(y,c);let p;for(;c<e.length;){const u=e[c];if(c+=1,p!==void 0)u===p&&(p=void 0);else if(u==='"'||u==="'")p=u;else if(u===">")break}if(e[c-1]!==">")break;if(a)!o&&r.at(-1)===d&&r.pop();else{let u=c-2;for(;/\s/.test(e.charAt(u));)u-=1;if(!G.has(d)&&e[u]!=="/"){if(r.push(d),r.length>Z)return!0;if(!o&&J.has(d)){const m=Q(t,d,c);if(m===-1)break;n=m;continue}}}n=c}return!1}i(Y,"exceedsConversionDepth");function ee(e,t){const r=e.content.slice(0,t),n=r.length!==e.content.length;switch(e.kind){case"html":if(Y(r))return{text:r,sourceTruncated:n};try{return{text:f.turndown(r),sourceTruncated:n}}catch{return{text:r,sourceTruncated:n}}case"text":return{text:r,sourceTruncated:n};default:return W(e,"unhandled web fetch body kind")}}i(ee,"renderBody");const C=`
+
+(Content truncated. Fetch a more specific URL or section for the full text.)`;function k(e,t){const r=q.get(e)??new Map,n=r.get(t);if(n!==void 0)return n;const o=te(e,t);return r.set(t,o),q.set(e,r),o}i(k,"renderFetchOutput");const q=new WeakMap;function te(e,t){const r=`Fetched ${e.url} (HTTP ${e.statusCode})
+
+`,n=ee(e.body,t),o=`${r}${n.text}`,s=e.truncated||n.sourceTruncated||o.length>t,c=`${o}${s?C:""}`;return c.length<=t?{text:c,truncated:s}:t<78?{text:c.slice(0,t),truncated:s}:{text:`${o.slice(0,t-78)}${C}`,truncated:s}}i(te,"computeFetchOutput");function U(e,t){return k(e,t).text}i(U,"formatFetchOutput");function L(e){return{card:"generic",title:e.url,kind:"fetch",rawInput:e.url}}i(L,"presentFetchCall");function $(e,t){return{url:e.url,statusCode:e.statusCode,truncated:k(e,t).truncated}}i($,"fetchMetaFromValue");function F(e){if(typeof e!="object"||e===null||Array.isArray(e))return;const{url:t,statusCode:r,truncated:n}=e;if(!(typeof t!="string"||typeof r!="number"||typeof n!="boolean"))return{url:t,statusCode:r,truncated:n}}i(F,"fetchMetaFromResult");function O(e,t){if(t.isError)return;const r=F(t.meta);if(r!==void 0)return{card:"web",kind:"fetch",title:e.url,url:r.url,statusCode:r.statusCode,truncated:r.truncated}}i(O,"presentFetchResult");function j(e,t,r){e.systemPrompt.section({name:"tool:web_fetch",order:111,text:"Use the web_fetch tool to retrieve the content of a specific HTTP(S) URL (for example a result from web_search). It returns the page content decoded to text. Cite the URL as a markdown link when you use its content."}),e.tools.register(g({name:"web_fetch",description:"Fetch the content of a specific HTTP(S) URL and return it decoded to text.",parameters:{url:{type:"string",required:!0,description:"The HTTP(S) URL to fetch."}},output:{schema:{type:"object",additionalProperties:!1,properties:{url:{type:"string",required:!0},statusCode:{type:"integer",required:!0},body:{required:!0,oneOf:[{type:"object",additionalProperties:!1,properties:{kind:{type:"string",required:!0,const:"html"},content:{type:"string",required:!0}}},{type:"object",additionalProperties:!1,properties:{kind:{type:"string",required:!0,const:"text"},content:{type:"string",required:!0}}}]},truncated:{type:"boolean",required:!0}}},render:i((n,o)=>[{type:"text",text:U(o,r)}],"render"),presentationMeta:i((n,o)=>$(o,r),"presentationMeta")},timeoutMs:t,isConcurrencySafe:i(()=>!0,"isConcurrencySafe"),async execute(n,o){const s=_(n),c=await e.web.fetch({url:s.url},o.signal);return{url:c.url,statusCode:c.statusCode,body:{kind:c.body.kind,content:c.body.content},truncated:c.truncated}},presentCall:L,presentResult:i((n,o)=>O(n,o),"presentResult")}))}i(j,"applyWebFetchTool");const re="tool-web",ne=["tools","web","systemPrompt"],b=3e4,P=2e5,oe=l.object({search:l.boolean().default(!0),fetch:l.boolean().default(!0),searchMaxResults:l.number().default(8),fetchTimeoutMs:l.number().default(b),searchTimeoutMs:l.number().default(b),fetchMaxOutputChars:l.number().default(P)});function h(e,t){if(!Number.isInteger(t)||t<1)throw new Error(`tool-web: ${e} must be a positive integer`)}i(h,"assertPositiveInteger");function ie(e,t){const r=t;h("searchMaxResults",r.searchMaxResults),h("fetchTimeoutMs",r.fetchTimeoutMs),h("searchTimeoutMs",r.searchTimeoutMs),h("fetchMaxOutputChars",r.fetchMaxOutputChars),r.search&&E(e,r.searchMaxResults,r.searchTimeoutMs,r.fetch),r.fetch&&j(e,r.fetchTimeoutMs,r.fetchMaxOutputChars)}i(ie,"apply");export{oe as Config,P as DEFAULT_FETCH_MAX_OUTPUT_CHARS,b as DEFAULT_WEB_TOOL_TIMEOUT_MS,B as WEB_SEARCH_MAX_RESULTS,ie as apply,j as applyWebFetchTool,E as applyWebSearchTool,F as fetchMetaFromResult,$ as fetchMetaFromValue,U as formatFetchOutput,T as formatSearchOutput,ne as inject,re as name,_ as parseFetchArgs,w as parseSearchArgs,L as presentFetchCall,O as presentFetchResult,v as presentSearchCall,M as presentSearchResult,x as searchMetaFromResult,R as searchMetaFromValue};

package/node_modules/@qqbrowser/qbot-dsh-tool-web/lib/invariant.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var n=(t,o)=>s(t,"name",{value:o,configurable:!0});const e="@qqbrowser/qbot-dsh-tool-web",i="tool-web-invariant",r=["invariants"],a=n(()=>{},"install"),c=n(t=>Promise.resolve(t.invariants.register(e,a)),"apply");export{c as apply,r as inject,i as name};

package/node_modules/@qqbrowser/qbot-dsh-tool-web/package.json

@@ -0,0 +1 @@
+{"name":"@qqbrowser/qbot-dsh-tool-web","version":"0.0.6","publishConfig":{"access":"public"},"type":"module","main":"lib/index.js","exports":{".":{"types":"./lib/types/index.d.ts","default":"./lib/index.js"},"./invariant":{"types":"./lib/types/invariant.d.ts","default":"./lib/invariant.js"},"./src/*":"./src/*","./package.json":"./package.json"},"license":"MIT","peerDependencies":{"@qqbrowser/qbot-dsh-invariants":"^0.0.6","@qqbrowser/qbot-dsh-system-prompt":"^0.0.6","@qqbrowser/qbot-dsh-tools":"^0.0.6","@qqbrowser/qbot-dsh-web":"^0.0.6","@qqbrowser/qbot-dsh-llm":"^0.0.6","@deepseek-ai/cordis":"^4.0.1"},"dependencies":{"@joplin/turndown-plugin-gfm":"^1.0.67","turndown":"^7.2.4","@deepseek-ai/schemastery":"^3.18.1"}}

package/node_modules/@qqbrowser/qbot-dsh-tool-workflow/lib/index.js

@@ -0,0 +1,4 @@
+var f=Object.defineProperty;var s=(r,n)=>f(r,"name",{value:n,configurable:!0});import u from"@deepseek-ai/schemastery";import{defineTool as g}from"@qqbrowser/qbot-dsh-tools";const m="tool-workflow",y=["tools","workflowEngine","systemPrompt"],b=u.object({toolName:u.string().default("workflow"),maxResultChars:u.natural().min(1).default(5e4)});function v(r){try{return String(r)}catch{return"[unrenderable thrown value]"}}s(v,"renderRecordingError");function k(r){const n=new Map,a=s((t,e,o)=>{const i=t.append.bind(t);try{return i(e,o),!0}catch(p){return r.logger.warn(`tool-workflow: disabled durable record after ${e} append failed: ${v(p)}`),!1}},"append");return r.on("workflow/agent-start",(t,e)=>{const o=n.get(t.id);o!==void 0&&(a(o,"tool-workflow/agent-start",{runId:t.id,seq:e.seq,label:e.label,...e.phase===void 0?{}:{phase:e.phase},childId:e.childId})||n.delete(t.id))}),r.on("workflow/agent-end",(t,e)=>{const o=n.get(t.id);o!==void 0&&(a(o,"tool-workflow/agent-end",{runId:t.id,seq:e.seq,outcome:e.outcome})||n.delete(t.id))}),{start(t,e){a(t,"tool-workflow/run-start",{runId:e.id,name:e.meta.name})&&n.set(e.id,t)},finish(t,e){const o=n.get(t);o!==void 0&&a(o,"tool-workflow/run-end",{runId:t,stopReason:e}),n.delete(t)},abandon:s(t=>{n.delete(t)},"abandon")}}s(k,"createWorkflowRecorder");const O="Run a JavaScript workflow script that orchestrates subagents at scale. Use this for work that fans out across many independent pieces — an audit over many files, a migration, multi-angle research, adversarial verification of findings — where you write the orchestration as a script instead of delegating turn by turn.\n\nThe workflow's identity rides the `meta` parameter as JSON: required `name` (short kebab-case) and `description` strings, optional `whenToUse` string and `phases` array (`{title, detail?, provider?, model?}`). The `script` parameter is the plain JavaScript body ONLY (NOT TypeScript, and NO `export const meta` statement — meta is a parameter, not code), running with top-level await; end with `return <value>` — the value must be JSON-serializable and is this tool's result.\n\nScript-body hooks:\n- `agent(prompt, opts?): Promise<any>` — run one subagent to completion. Without `opts.schema` it resolves to the child's final text; with `opts.schema` (an object-rooted JSON Schema using ONLY type/properties/required/additionalProperties/items/enum/const/oneOf — no pattern/format/numeric bounds) it resolves to the validated object. Resolves `null` when the child fails (filter with `.filter(Boolean)`). Other opts: `label` (display), `phase` (progress group), and independent `provider`/`model` LLM target overrides (either may be provided alone). Anything else (`effort`/`isolation`/`agentType`) is rejected loudly.\n- `pipeline(items, ...stages): Promise<any[]>` — run each item through the stages independently with NO barrier between stages (prefer this for multi-stage work). Each stage receives `(prev, item, index)`. An ordinary stage throw drops that ITEM to `null` and skips its remaining stages.\n- `parallel(thunks): Promise<any[]>` — run zero-argument functions concurrently and await ALL of them (a barrier; use only when a stage genuinely needs every prior result together). A throwing thunk resolves to `null`.\n- `phase(title)` — start a progress phase; `log(message)` — narrate progress; `args` — the tool call's `args` input, verbatim.\n\nMisused hooks (bad arguments, unknown options, unsupported schemas, tripped caps) throw errors that ALWAYS kill the script — they never dissolve into a per-item `null`.\n\nConstraints: concurrency and total-agent caps apply; no filesystem, network, timers, or Node.js APIs are provided — the agents do the work, the script only coordinates them. The run executes in the foreground: this call returns when the whole script finishes.";function S(r){return{card:"generic",title:`workflow: ${r.meta.name}`,rawInput:r.script}}s(S,"presentWorkflowCall");function N(r,n){return{card:"generic"}}s(N,"presentWorkflowResult");function R(r){switch(r.stopReason){case"completed":return;case"cancelled":return`workflow run was cancelled${r.error!==void 0?` (${r.error})`:""}`;case"error":return`workflow run failed: ${r.error??"unknown error"}`;default:return`workflow run ended abnormally (${String(r.stopReason)})`}}s(R,"stopReasonError");function q(r,n,a,t){const e=JSON.stringify(a,null,2),o=e.length>t?`${e.slice(0,t)}
+… [truncated: ${e.length-t} more characters]`:e;return`workflow "${r}" completed (${n} agent${n===1?"":"s"}).
+Return value:
+${o}`}s(q,"renderResult");function $(r,n){const{toolName:a,maxResultChars:t}=n,e=k(r);r.systemPrompt.section({name:`tool:${a}`,order:115,text:`Use the ${a} tool ONLY when the user explicitly asks for a workflow or for large multi-agent orchestration: you write a JavaScript script (the tool description documents the exact format) that fans work out across many subagents with phases and structured results. For one or two delegations, prefer plain subagent calls.`}),r.tools.register(g({name:a,description:O,parameters:{script:{type:"string",required:!0,description:"The plain-JS workflow script body (top-level await allowed; NO `export const meta` statement; end with `return <json-value>`)."},meta:{type:"object",additionalProperties:!0,required:!0,description:"The workflow identity block (plain JSON — never code).",properties:{name:{type:"string",required:!0,description:"Short kebab-case workflow name."},description:{type:"string",required:!0,description:"One-line description of what the workflow does."},whenToUse:{type:"string",description:"Optional guidance on when this workflow applies."},phases:{type:"array",description:"Optional phase declarations matched by phase() calls.",items:{type:"object",additionalProperties:!0,properties:{title:{type:"string",required:!0,description:"The phase title phase() calls match by exact string."},detail:{type:"string",description:"Optional one-line description of the phase."},provider:{type:"string",description:"Optional provider override this phase is expected to use."},model:{type:"string",description:"Optional model override this phase is expected to use."}}}}}},args:{type:"object",additionalProperties:!0,description:'Optional JSON input exposed to the script as the `args` global (wrap a bare list as a field, e.g. {"files": [...]}).'}},output:{schema:{type:"object",additionalProperties:!1,properties:{runId:{type:"string",required:!0},agentsStarted:{type:"integer",required:!0},result:{type:"json",required:!0}}},render:s((o,i)=>[{type:"text",text:q(o.meta.name,i.agentsStarted,i.result,t)}],"render")},async execute(o,i){const p=i.agent;if(!p)throw new Error("workflow tool requires a calling agent (exec.agent was undefined)");const l=r.workflowEngine.start({script:o.script,meta:o.meta,...o.args!==void 0?{args:o.args}:{},parent:p,signal:i.signal}),c=i.parent===void 0;c&&e.start(p.session,l);const h=s(()=>{l.cancel("parent step aborted")},"onAbort");i.signal.addEventListener("abort",h,{once:!0});let d;try{d=await l.result;const w=R(d);if(w!==void 0)throw new Error(w);return{runId:l.id,agentsStarted:d.agentsStarted,result:d.value}}finally{i.signal.removeEventListener("abort",h);try{if(await l.dispose(),c){if(d===void 0)throw new Error("workflow run settled without a result");e.finish(l.id,d.stopReason)}}finally{c&&e.abandon(l.id)}}},presentCall:s(o=>S(o),"presentCall"),presentResult:s((o,i)=>N(o,i),"presentResult")}))}s($,"apply");export{b as Config,$ as apply,y as inject,m as name};

package/node_modules/@qqbrowser/qbot-dsh-tool-workflow/lib/invariant.js

@@ -0,0 +1 @@
+var k=Object.defineProperty;var c=(t,o)=>k(t,"name",{value:o,configurable:!0});const h="@qqbrowser/qbot-dsh-tool-workflow",y="tool-workflow-invariant",$=["invariants"];function l(t){return t.type.startsWith("tool-workflow/")}c(l,"isWorkflowRecordEvent");function d(t,o,e){return(typeof t!="string"||t.length===0)&&e(`${o} must be a non-empty string`),t}c(d,"stringId");function f(t,o){return(!Number.isSafeInteger(t)||t<1)&&o("tool-workflow member seq must be a positive safe integer"),t}c(f,"memberSeq");function g(t,o){const e=t.data;return(e===null||typeof e!="object"||Array.isArray(e))&&o(`${t.type} data must be a JSON object`),e}c(g,"recordOf");function q(t,o,e){const n=new Map(t);if(o.type==="tool-workflow/run-start")return n;const a=d(g(o,e).runId,`${o.type} runId`,e),r=t.get(a);return r!==void 0&&n.set(a,{ended:r.ended,members:new Map(r.members)}),n}c(q,"cloneTraceForEvent");function w(t,o,e,n){const a=t.get(o);return a===void 0&&n(`${e} has no matching tool-workflow/run-start for run ${o}`),a.ended&&n(`${e} appears after tool-workflow/run-end for run ${o}`),a}c(w,"openRun");function b(t,o,e){const n=g(o,e),a=d(n.runId,`${o.type} runId`,e);switch(o.type){case"tool-workflow/run-start":(typeof n.name!="string"||n.name.length===0)&&e("tool-workflow/run-start name must be a non-empty string"),t.has(a)&&e(`tool-workflow/run-start repeats run ${a}`),t.set(a,{ended:!1,members:new Map});return;case"tool-workflow/agent-start":{const r=w(t,a,o.type,e),s=f(n.seq,e);typeof n.label!="string"&&e("tool-workflow/agent-start label must be a string"),n.phase!==void 0&&typeof n.phase!="string"&&e("tool-workflow/agent-start phase must be a string when present"),d(n.childId,"tool-workflow/agent-start childId",e),r.members.has(s)&&e(`tool-workflow/agent-start repeats member seq ${s} in run ${a}`),r.members.set(s,!1);return}case"tool-workflow/agent-end":{const r=w(t,a,o.type,e),s=f(n.seq,e);n.outcome!=="completed"&&n.outcome!=="failed"&&n.outcome!=="cancelled"&&e(`tool-workflow/agent-end outcome ${String(n.outcome)} is invalid`);const i=r.members.get(s);i===void 0&&e(`tool-workflow/agent-end has no matching member seq ${s} in run ${a}`),i&&e(`tool-workflow/agent-end repeats member seq ${s} in run ${a}`),r.members.set(s,!0);return}case"tool-workflow/run-end":{const r=w(t,a,o.type,e);n.stopReason!=="completed"&&n.stopReason!=="cancelled"&&n.stopReason!=="error"&&e(`tool-workflow/run-end stopReason ${String(n.stopReason)} is invalid`);const s=[...r.members].filter(([,i])=>!i).map(([i])=>i);s.length>0&&e(`tool-workflow/run-end leaves member seq ${s.join(", ")} open in run ${a}`),r.ended=!0,r.members.clear();return}default:e(`unknown tool-workflow event type ${o.type}`)}}c(b,"applyEvent");const v=Object.assign((t,o)=>{const e=new WeakMap,n=new WeakMap,a=c(r=>{const s=new Map;for(const i of r.events.filter(l))b(s,i,o);return e.set(r,s),s},"seed");t.sessions.list().forEach(a),t.on("session/created",r=>{a(r)},{global:!0}),t.on("internal/dispatch",(r,s,i)=>{if(s!=="session/event")return;const[m,u]=i;if(!l(u))return;const p=q(e.get(m),u,o);b(p,u,o),n.set(u,{session:m,trace:p})},{global:!0}),t.on("session/event",(r,s)=>{if(!l(s))return;const i=n.get(s);if(i===void 0||i.session!==r)return o("session/event reached publication without matching workflow-record validation");n.delete(s),e.set(r,i.trace)},{global:!0})},{inject:["sessions"]}),I=c(t=>Promise.resolve(t.invariants.register(h,v)),"apply");export{I as apply,$ as inject,y as name};

package/node_modules/@qqbrowser/qbot-dsh-tool-workflow/lib/types/index.js

@@ -0,0 +1,4 @@
+var f=Object.defineProperty;var i=(t,n)=>f(t,"name",{value:n,configurable:!0});import u from"@deepseek-ai/schemastery";import{defineTool as g}from"@qqbrowser/qbot-dsh-tools";export const name="tool-workflow",inject=["tools","workflowEngine","systemPrompt"],Config=u.object({toolName:u.string().default("workflow"),maxResultChars:u.natural().min(1).default(5e4)});function m(t){try{return String(t)}catch{return"[unrenderable thrown value]"}}i(m,"renderRecordingError");function y(t){const n=new Map,a=i((r,e,o)=>{const s=r.append.bind(r);try{return s(e,o),!0}catch(p){return t.logger.warn(`tool-workflow: disabled durable record after ${e} append failed: ${m(p)}`),!1}},"append");return t.on("workflow/agent-start",(r,e)=>{const o=n.get(r.id);if(o===void 0)return;const s={runId:r.id,seq:e.seq,label:e.label,...e.phase===void 0?{}:{phase:e.phase},childId:e.childId};a(o,"tool-workflow/agent-start",s)||n.delete(r.id)}),t.on("workflow/agent-end",(r,e)=>{const o=n.get(r.id);if(o===void 0)return;const s={runId:r.id,seq:e.seq,outcome:e.outcome};a(o,"tool-workflow/agent-end",s)||n.delete(r.id)}),{start(r,e){a(r,"tool-workflow/run-start",{runId:e.id,name:e.meta.name})&&n.set(e.id,r)},finish(r,e){const o=n.get(r);o!==void 0&&a(o,"tool-workflow/run-end",{runId:r,stopReason:e}),n.delete(r)},abandon:i(r=>{n.delete(r)},"abandon")}}i(y,"createWorkflowRecorder");const b="Run a JavaScript workflow script that orchestrates subagents at scale. Use this for work that fans out across many independent pieces — an audit over many files, a migration, multi-angle research, adversarial verification of findings — where you write the orchestration as a script instead of delegating turn by turn.\n\nThe workflow's identity rides the `meta` parameter as JSON: required `name` (short kebab-case) and `description` strings, optional `whenToUse` string and `phases` array (`{title, detail?, provider?, model?}`). The `script` parameter is the plain JavaScript body ONLY (NOT TypeScript, and NO `export const meta` statement — meta is a parameter, not code), running with top-level await; end with `return <value>` — the value must be JSON-serializable and is this tool's result.\n\nScript-body hooks:\n- `agent(prompt, opts?): Promise<any>` — run one subagent to completion. Without `opts.schema` it resolves to the child's final text; with `opts.schema` (an object-rooted JSON Schema using ONLY type/properties/required/additionalProperties/items/enum/const/oneOf — no pattern/format/numeric bounds) it resolves to the validated object. Resolves `null` when the child fails (filter with `.filter(Boolean)`). Other opts: `label` (display), `phase` (progress group), and independent `provider`/`model` LLM target overrides (either may be provided alone). Anything else (`effort`/`isolation`/`agentType`) is rejected loudly.\n- `pipeline(items, ...stages): Promise<any[]>` — run each item through the stages independently with NO barrier between stages (prefer this for multi-stage work). Each stage receives `(prev, item, index)`. An ordinary stage throw drops that ITEM to `null` and skips its remaining stages.\n- `parallel(thunks): Promise<any[]>` — run zero-argument functions concurrently and await ALL of them (a barrier; use only when a stage genuinely needs every prior result together). A throwing thunk resolves to `null`.\n- `phase(title)` — start a progress phase; `log(message)` — narrate progress; `args` — the tool call's `args` input, verbatim.\n\nMisused hooks (bad arguments, unknown options, unsupported schemas, tripped caps) throw errors that ALWAYS kill the script — they never dissolve into a per-item `null`.\n\nConstraints: concurrency and total-agent caps apply; no filesystem, network, timers, or Node.js APIs are provided — the agents do the work, the script only coordinates them. The run executes in the foreground: this call returns when the whole script finishes.";function k(t){return{card:"generic",title:`workflow: ${t.meta.name}`,rawInput:t.script}}i(k,"presentWorkflowCall");function v(t,n){return{card:"generic"}}i(v,"presentWorkflowResult");function O(t){switch(t.stopReason){case"completed":return;case"cancelled":return`workflow run was cancelled${t.error!==void 0?` (${t.error})`:""}`;case"error":return`workflow run failed: ${t.error??"unknown error"}`;default:return`workflow run ended abnormally (${String(t.stopReason)})`}}i(O,"stopReasonError");function S(t,n,a,r){const e=JSON.stringify(a,null,2),o=e.length>r?`${e.slice(0,r)}
+… [truncated: ${e.length-r} more characters]`:e;return`workflow "${t}" completed (${n} agent${n===1?"":"s"}).
+Return value:
+${o}`}i(S,"renderResult");export function apply(t,n){const{toolName:a,maxResultChars:r}=n,e=y(t);t.systemPrompt.section({name:`tool:${a}`,order:115,text:`Use the ${a} tool ONLY when the user explicitly asks for a workflow or for large multi-agent orchestration: you write a JavaScript script (the tool description documents the exact format) that fans work out across many subagents with phases and structured results. For one or two delegations, prefer plain subagent calls.`}),t.tools.register(g({name:a,description:b,parameters:{script:{type:"string",required:!0,description:"The plain-JS workflow script body (top-level await allowed; NO `export const meta` statement; end with `return <json-value>`)."},meta:{type:"object",additionalProperties:!0,required:!0,description:"The workflow identity block (plain JSON — never code).",properties:{name:{type:"string",required:!0,description:"Short kebab-case workflow name."},description:{type:"string",required:!0,description:"One-line description of what the workflow does."},whenToUse:{type:"string",description:"Optional guidance on when this workflow applies."},phases:{type:"array",description:"Optional phase declarations matched by phase() calls.",items:{type:"object",additionalProperties:!0,properties:{title:{type:"string",required:!0,description:"The phase title phase() calls match by exact string."},detail:{type:"string",description:"Optional one-line description of the phase."},provider:{type:"string",description:"Optional provider override this phase is expected to use."},model:{type:"string",description:"Optional model override this phase is expected to use."}}}}}},args:{type:"object",additionalProperties:!0,description:'Optional JSON input exposed to the script as the `args` global (wrap a bare list as a field, e.g. {"files": [...]}).'}},output:{schema:{type:"object",additionalProperties:!1,properties:{runId:{type:"string",required:!0},agentsStarted:{type:"integer",required:!0},result:{type:"json",required:!0}}},render:i((o,s)=>[{type:"text",text:S(o.meta.name,s.agentsStarted,s.result,r)}],"render")},async execute(o,s){const p=s.agent;if(!p)throw new Error("workflow tool requires a calling agent (exec.agent was undefined)");const l=t.workflowEngine.start({script:o.script,meta:o.meta,...o.args!==void 0?{args:o.args}:{},parent:p,signal:s.signal}),c=s.parent===void 0;c&&e.start(p.session,l);const h=i(()=>{l.cancel("parent step aborted")},"onAbort");s.signal.addEventListener("abort",h,{once:!0});let d;try{d=await l.result;const w=O(d);if(w!==void 0)throw new Error(w);return{runId:l.id,agentsStarted:d.agentsStarted,result:d.value}}finally{s.signal.removeEventListener("abort",h);try{if(await l.dispose(),c){if(d===void 0)throw new Error("workflow run settled without a result");e.finish(l.id,d.stopReason)}}finally{c&&e.abandon(l.id)}}},presentCall:i(o=>k(o),"presentCall"),presentResult:i((o,s)=>v(o,s),"presentResult")}))}i(apply,"apply");

package/node_modules/@qqbrowser/qbot-dsh-tool-workflow/lib/types/invariant.js

@@ -0,0 +1 @@
+var k=Object.defineProperty;var u=(t,o)=>k(t,"name",{value:o,configurable:!0});const h="@qqbrowser/qbot-dsh-tool-workflow";export const name="tool-workflow-invariant",inject=["invariants"];function d(t){return t.type.startsWith("tool-workflow/")}u(d,"isWorkflowRecordEvent");function l(t,o,e){return(typeof t!="string"||t.length===0)&&e(`${o} must be a non-empty string`),t}u(l,"stringId");function p(t,o){return(!Number.isSafeInteger(t)||t<1)&&o("tool-workflow member seq must be a positive safe integer"),t}u(p,"memberSeq");function g(t,o){const e=t.data;return(e===null||typeof e!="object"||Array.isArray(e))&&o(`${t.type} data must be a JSON object`),e}u(g,"recordOf");function y(t,o,e){const n=new Map(t);if(o.type==="tool-workflow/run-start")return n;const a=g(o,e),s=l(a.runId,`${o.type} runId`,e),r=t.get(s);return r!==void 0&&n.set(s,{ended:r.ended,members:new Map(r.members)}),n}u(y,"cloneTraceForEvent");function w(t,o,e,n){const a=t.get(o);return a===void 0&&n(`${e} has no matching tool-workflow/run-start for run ${o}`),a.ended&&n(`${e} appears after tool-workflow/run-end for run ${o}`),a}u(w,"openRun");function b(t,o,e){const n=g(o,e),a=l(n.runId,`${o.type} runId`,e);switch(o.type){case"tool-workflow/run-start":{(typeof n.name!="string"||n.name.length===0)&&e("tool-workflow/run-start name must be a non-empty string"),t.has(a)&&e(`tool-workflow/run-start repeats run ${a}`),t.set(a,{ended:!1,members:new Map});return}case"tool-workflow/agent-start":{const s=w(t,a,o.type,e),r=p(n.seq,e);typeof n.label!="string"&&e("tool-workflow/agent-start label must be a string"),n.phase!==void 0&&typeof n.phase!="string"&&e("tool-workflow/agent-start phase must be a string when present"),l(n.childId,"tool-workflow/agent-start childId",e),s.members.has(r)&&e(`tool-workflow/agent-start repeats member seq ${r} in run ${a}`),s.members.set(r,!1);return}case"tool-workflow/agent-end":{const s=w(t,a,o.type,e),r=p(n.seq,e);n.outcome!=="completed"&&n.outcome!=="failed"&&n.outcome!=="cancelled"&&e(`tool-workflow/agent-end outcome ${String(n.outcome)} is invalid`);const i=s.members.get(r);i===void 0&&e(`tool-workflow/agent-end has no matching member seq ${r} in run ${a}`),i&&e(`tool-workflow/agent-end repeats member seq ${r} in run ${a}`),s.members.set(r,!0);return}case"tool-workflow/run-end":{const s=w(t,a,o.type,e);n.stopReason!=="completed"&&n.stopReason!=="cancelled"&&n.stopReason!=="error"&&e(`tool-workflow/run-end stopReason ${String(n.stopReason)} is invalid`);const r=[...s.members].filter(([,i])=>!i).map(([i])=>i);r.length>0&&e(`tool-workflow/run-end leaves member seq ${r.join(", ")} open in run ${a}`),s.ended=!0,s.members.clear();return}default:e(`unknown tool-workflow event type ${o.type}`)}}u(b,"applyEvent");const $=Object.assign((t,o)=>{const e=new WeakMap,n=new WeakMap,a=u(s=>{const r=new Map;for(const i of s.events.filter(d))b(r,i,o);return e.set(s,r),r},"seed");t.sessions.list().forEach(a),t.on("session/created",s=>{a(s)},{global:!0}),t.on("internal/dispatch",(s,r,i)=>{if(r!=="session/event")return;const[m,c]=i;if(!d(c))return;const f=y(e.get(m),c,o);b(f,c,o),n.set(c,{session:m,trace:f})},{global:!0}),t.on("session/event",(s,r)=>{if(!d(r))return;const i=n.get(r);if(i===void 0||i.session!==s)return o("session/event reached publication without matching workflow-record validation");n.delete(r),e.set(s,i.trace)},{global:!0})},{inject:["sessions"]});export const apply=u(t=>Promise.resolve(t.invariants.register(h,$)),"apply");

package/node_modules/@qqbrowser/qbot-dsh-tool-workflow/package.json

@@ -0,0 +1 @@
+{"name":"@qqbrowser/qbot-dsh-tool-workflow","version":"0.0.6","publishConfig":{"access":"public"},"type":"module","main":"lib/index.js","exports":{".":{"types":"./lib/types/index.d.ts","default":"./lib/index.js"},"./invariant":{"types":"./lib/types/invariant.d.ts","default":"./lib/invariant.js"},"./types":{"types":"./lib/types/types.d.ts","default":"./lib/types/types.js"},"./src/*":"./src/*","./package.json":"./package.json"},"license":"MIT","peerDependencies":{"@qqbrowser/qbot-dsh-agent":"^0.0.6","@qqbrowser/qbot-dsh-session":"^0.0.6","@qqbrowser/qbot-dsh-llm":"^0.0.6","@qqbrowser/qbot-dsh-tools":"^0.0.6","@qqbrowser/qbot-dsh-workflow":"^0.0.6","@qqbrowser/qbot-dsh-system-prompt":"^0.0.6","@qqbrowser/qbot-dsh-invariants":"^0.0.6","@deepseek-ai/cordis":"^4.0.1"},"dependencies":{"@deepseek-ai/schemastery":"^3.18.1"}}

package/node_modules/@qqbrowser/qbot-dsh-tools/lib/index.js

@@ -0,0 +1,50 @@
+var yt=Object.defineProperty;var c=(e,t)=>yt(e,"name",{value:t,configurable:!0});import{Service as gt}from"@deepseek-ai/cordis";import ae from"@deepseek-ai/schemastery";import{AnonymousEntries as Te,NamedEntries as bt,ScopedLayers as wt,scopeOf as Ne,scopeTarget as F}from"@qqbrowser/qbot-dsh-scope";import{CallId as vt,HarnessError as q,assertNever as z,deepFreeze as G}from"@qqbrowser/qbot-dsh-llm";import{isJsonValue as Re,snapshotJsonValue as N}from"@qqbrowser/qbot-dsh-session";var Q=class extends q{static{c(this,"JsonSchemaError")}violations;constructor(e){super(`unsupported JSON schema: ${e.join("; ")}`,"UNSUPPORTED_SCHEMA"),this.name="JsonSchemaError",this.violations=e}};const Ot=new Set(["type","oneOf","properties","required","additionalProperties","items","enum","const"]),kt=new Set(["description","title","default","examples"]),ce=["object","array","string","number","integer","boolean","null"];function Ae(e,t){const n=Object.getOwnPropertyDescriptor(e,"constructor")?.value;if(typeof n!="function")return!1;try{return n.name===t&&n.prototype===e&&Function.prototype.toString.call(n)===`function ${t}() { [native code] }`}catch{return!1}}c(Ae,"hasIntrinsicConstructor");function Ie(e){return Object.getPrototypeOf(e)===null&&Ae(e,"Object")}c(Ie,"isIntrinsicObjectPrototype");function Pe(e){if(typeof e!="object"||e===null||Array.isArray(e))return!1;try{const t=Object.getPrototypeOf(e);return t===null||typeof t=="object"&&Ie(t)}catch{return!1}}c(Pe,"isPlainJsonRecord");function $t(e){const t=Object.getPrototypeOf(e);if(!Array.isArray(t)||!Ae(t,"Array"))return!1;const n=Object.getPrototypeOf(t);return typeof n=="object"&&n!==null&&Ie(n)}c($t,"hasPlainArrayPrototype");function St(e){try{return Reflect.ownKeys(e).every(t=>typeof t=="string"&&Object.prototype.propertyIsEnumerable.call(e,t))}catch{return!1}}c(St,"hasOnlyEnumerableStringKeys");function _(e){return Pe(e)&&St(e)}c(_,"isJsonSchemaRecord");function L(e){if(!Array.isArray(e))return!1;try{if(!$t(e)||Reflect.ownKeys(e).length!==e.length+1)return!1;for(let t=0;t<e.length;t++)if(!Object.hasOwn(e,t))return!1;return!0}catch{return!1}}c(L,"isPlainJsonArray");function Z(e){return typeof e=="number"&&Number.isFinite(e)&&!Object.is(e,-0)}c(Z,"isJsonNumber");function De(e,t){switch(e){case"string":return typeof t=="string";case"number":return Z(t);case"integer":return Z(t)&&Number.isInteger(t);case"boolean":return typeof t=="boolean";case"null":return t===null;default:return z(e,"JsonSchemaType")}}c(De,"scalarMatches");const _e=["properties","required","additionalProperties","items","enum","const"];function Et(e,t,n,r){const s=Object.hasOwn(e,"required"),i=s?e.required:void 0;if(s)if(!L(i)||i.some(a=>typeof a!="string"))r.push(`${t}.required must be an array of strings`);else{const a=_(n)?n:{};for(const o of i)Object.hasOwn(a,o)||r.push(`${t}.required names "${o}" which is not in properties`)}Object.hasOwn(e,"additionalProperties")&&typeof e.additionalProperties!="boolean"&&r.push(`${t}.additionalProperties must be a boolean`)}c(Et,"checkObjectSchemaTail");function qe(e,t,n,r){const s=[{kind:"enter",node:e,path:t}];for(let i=s.pop();i!==void 0;i=s.pop()){if(i.kind==="leave"){r.delete(i.node);continue}if(i.kind==="one-of-tail"){for(const u of _e)Object.hasOwn(i.node,u)&&n.push(`${i.path}.${u} is not supported beside oneOf`);continue}if(i.kind==="object-tail"){Et(i.node,i.path,i.properties,n);continue}const{node:a,path:o}=i;if(!_(a)){n.push(`${o} must be a schema object`);continue}if(r.has(a)){n.push(`${o} is circular`);continue}r.add(a),s.push({kind:"leave",node:a});for(const u of Object.keys(a))if(!Ot.has(u)){if(kt.has(u)){try{Re(a[u])||n.push(`${o}.${u} annotation must be lossless JSON data`)}catch{n.push(`${o}.${u} annotation must be lossless JSON data`)}continue}n.push(`${o}.${u} is not a supported keyword (subset: type/oneOf/properties/required/additionalProperties/items/enum/const + annotations)`)}Object.hasOwn(a,"description")&&typeof a.description!="string"&&n.push(`${o}.description must be a string`),Object.hasOwn(a,"title")&&typeof a.title!="string"&&n.push(`${o}.title must be a string`);const l=Object.hasOwn(a,"type"),p=Object.hasOwn(a,"oneOf");if(l&&p){n.push(`${o} cannot declare both type and oneOf`);continue}if(!l&&!p){for(const u of _e)Object.hasOwn(a,u)&&n.push(`${o}.${u} requires type or oneOf`);continue}if(p){const u=a.oneOf;if(s.push({kind:"one-of-tail",node:a,path:o}),!L(u)||u.length<2)n.push(`${o}.oneOf must be an array of at least two schemas`);else for(let h=u.length-1;h>=0;h--)s.push({kind:"enter",node:u[h],path:`${o}.oneOf[${h}]`});continue}const d=a.type;if(typeof d!="string"||!ce.includes(d)){n.push(Array.isArray(d)?`${o}.type must be a single type string (type arrays are not supported)`:`${o}.type must be one of ${ce.join("/")}`);continue}const f=d;for(const[u,h]of Object.entries({properties:["object"],required:["object"],additionalProperties:["object"],items:["array"],enum:["string","number","integer","boolean","null"],const:["string","number","integer","boolean","null"]}))Object.hasOwn(a,u)&&!h.includes(f)&&n.push(`${o}.${u} is not supported on type "${f}"`);switch(f){case"object":{const u=Object.hasOwn(a,"properties")?a.properties:void 0;if(s.push({kind:"object-tail",node:a,path:o,properties:u}),Object.hasOwn(a,"properties"))if(!_(u))n.push(`${o}.properties must be an object of schemas`);else{const h=Object.entries(u);for(let y=h.length-1;y>=0;y--){const m=h[y];m!==void 0&&s.push({kind:"enter",node:m[1],path:`${o}.properties.${m[0]}`})}}break}case"array":Object.hasOwn(a,"items")&&s.push({kind:"enter",node:a.items,path:`${o}.items`});break;case"string":case"number":case"integer":case"boolean":case"null":{const u=Object.hasOwn(a,"enum"),h=u?a.enum:void 0,y=L(h)&&h.length>0&&h.every(C=>De(f,C));u&&!y&&n.push(`${o}.enum must be a non-empty array of ${f} values`);const m=Object.hasOwn(a,"const"),b=m?a.const:void 0,I=De(f,b);m&&(I?y&&!h.includes(b)&&n.push(`${o}.const must be one of ${o}.enum when both are declared`):n.push(`${o}.const must be a ${f} value`));break}default:z(f,"JsonSchemaType")}}}c(qe,"checkSchemaNode");function J(e){const t=[];if(qe(e,"schema",t,new Set),t.length>0)throw new Q(t)}c(J,"assertSupportedJsonSchema");function Ct(e){const t=[];if(qe(e,"schema",t,new Set),t.length===0&&(!_(e)||!Object.hasOwn(e,"type")||e.type!=="object")&&t.push('schema.type must be "object" (structured output is object-rooted)'),t.length>0)throw new Q(t)}c(Ct,"assertObjectJsonSchema");function le(e){try{return Re(e)}catch{return!1}}c(le,"safelyIsJsonValue");function v(e){return e===""?"arguments":e}c(v,"diagnosticPath");function de(e,t){return e===""?t:`${e}.${t}`}c(de,"propertyPath");function ue(e){return[`"${v(e)}" must be a lossless JSON value`]}c(ue,"losslessValueViolation");function Je(e,t){for(const n of t)e.push(n)}c(Je,"appendViolations");function Me(e,t,n){return{node:e,value:t,path:n,catches:!1,phase:"start",children:[],childIndex:0,violations:[],tailViolations:[],matches:0}}c(Me,"valueFrame");function V(e,t,n){const r=Object.hasOwn(e,"enum")?e.enum:void 0;return r!==void 0&&!r.includes(t)?[`"${v(n)}" must be one of ${JSON.stringify(r)}`]:Object.hasOwn(e,"const")&&t!==e.const?[`"${v(n)}" must be ${JSON.stringify(e.const)}`]:[]}c(V,"checkScalarValue");function jt(e,t,n){const r=[Me(e,t,n)];let s;const i=c(o=>{const l=r.at(-1);if(l===void 0){s=o;return}l.kind==="oneOf"?o.length===0&&l.matches++:Je(l.violations,o)},"receive"),a=c(o=>{r.pop(),i(o)},"finish");for(;r.length>0;){const o=r.at(-1);if(o===void 0)break;try{if(o.phase==="children"){if(o.childIndex<o.children.length){const d=o.children[o.childIndex];if(d===void 0)throw new Error("missing schema-value child frame");o.childIndex++,r.push(Me(d.node,d.value,d.path));continue}if(o.kind==="oneOf"){a(o.matches===1?[]:[`"${v(o.path)}" must match exactly one oneOf branch (matched ${o.matches})`]);continue}Je(o.violations,o.tailViolations),o.violations.length>0?a(o.violations):o.kind==="object"?a(le(o.value)?[]:[`"${v(o.path)}" must be a lossless JSON object`]):a(le(o.value)?[]:[`"${v(o.path)}" must be a dense lossless JSON array`]);continue}const l=Object.hasOwn(o.node,"type")?o.node.type:void 0;o.catches=!(l!==void 0&&!ce.includes(l));const p=Object.hasOwn(o.node,"oneOf")?o.node.oneOf:void 0;if(p!==void 0){o.kind="oneOf",o.children=Array.from(p,d=>({node:d,value:o.value,path:o.path})),o.childIndex=0,o.matches=0,o.phase="children";continue}if(l===void 0){a(le(o.value)?[]:ue(o.path));continue}switch(l){case"object":{if(!Pe(o.value)){a([`"${v(o.path)}" must be an object`]);break}const d=Object.hasOwn(o.node,"properties")?o.node.properties??{}:{},f=[],u=Object.hasOwn(o.node,"required")?o.node.required??[]:[];for(const m of u)(!Object.hasOwn(o.value,m)||o.value[m]===void 0)&&f.push(`missing required property "${de(o.path,m)}"`);const h=[];for(const[m,b]of Object.entries(d))!Object.hasOwn(o.value,m)||o.value[m]===void 0||h.push({node:b,value:o.value[m],path:de(o.path,m)});const y=[];if(Object.hasOwn(o.node,"additionalProperties")&&o.node.additionalProperties===!1)for(const m of Object.keys(o.value))Object.hasOwn(d,m)||y.push(`"${de(o.path,m)}" is not a declared property (additionalProperties: false)`);o.kind="object",o.children=h,o.childIndex=0,o.violations=f,o.tailViolations=y,o.phase="children";break}case"array":{if(!Array.isArray(o.value)){a([`"${v(o.path)}" must be an array`]);break}const d=Object.hasOwn(o.node,"items")?o.node.items:void 0,f=d===void 0?[]:o.value.flatMap((u,h)=>[{node:d,value:u,path:`${o.path}[${h}]`}]);o.kind="array",o.children=f,o.childIndex=0,o.violations=[],o.phase="children";break}case"string":a(typeof o.value=="string"?V(o.node,o.value,o.path):[`"${v(o.path)}" must be a string`]);break;case"number":a(typeof o.value!="number"?[`"${v(o.path)}" must be a number`]:Z(o.value)?V(o.node,o.value,o.path):[`"${v(o.path)}" must be a finite JSON number`]);break;case"integer":a(!Z(o.value)||!Number.isInteger(o.value)?[`"${v(o.path)}" must be an integer`]:V(o.node,o.value,o.path));break;case"boolean":a(typeof o.value=="boolean"?V(o.node,o.value,o.path):[`"${v(o.path)}" must be a boolean`]);break;case"null":a(o.value===null?V(o.node,o.value,o.path):[`"${v(o.path)}" must be null`]);break;default:a(z(l,"JsonSchemaType"))}}catch(l){let p=r.pop();for(;p!==void 0&&!p.catches;)p=r.pop();if(p===void 0)throw l;i(ue(p.path))}}return s??ue(n)}c(jt,"checkValue");function ee(e,t,n="value"){return jt(e,t,n)}c(ee,"validateJsonSchemaValue");const xt=["description","title","default","examples"];function O(e){throw new Q([e])}c(O,"authorError");function K(e,t){Object.hasOwn(e,"description")&&(t.description=e.description),Object.hasOwn(e,"title")&&(t.title=e.title),Object.hasOwn(e,"default")&&(t.default=e.default),Object.hasOwn(e,"examples")&&(t.examples=e.examples)}c(K,"copyAnnotations");function U(e,t,n){for(const r of Object.keys(e))n.includes(r)||O(`${t}.${r} is not supported by the value schema DSL`)}c(U,"assertAuthorKeys");function Tt(e,t){switch(e.kind){case"root":e.holder.value=t;break;case"property":Object.defineProperty(e.target,e.key,{value:t,enumerable:!0,configurable:!0,writable:!0});break;case"item":e.target.items=t;break;case"one-of":e.target[e.index]=t;break}}c(Tt,"assignCompiledNode");function Nt(e,t){e.kind==="root"?e.holder.value=t:e.target.properties=t.properties}c(Nt,"assignCompiledPropertyMap");function Fe(e){const t=new Set,n=[e];for(let r=n.pop();r!==void 0;r=n.pop()){if(r.kind==="leave"){t.delete(r.input);continue}if(r.kind==="property-map-tail"){r.required.length>0&&(r.compiled.required=r.required,r.destination.kind==="object"&&(r.destination.target.required=r.required));continue}if(r.kind==="property"){_(r.property)||O(`${r.path} must be a value schema object`),Object.hasOwn(r.property,"required")&&r.property.required!==!0&&O(`${r.path}.required must be true when present`),Object.hasOwn(r.property,"required")&&r.property.required===!0&&r.required.push(r.key),n.push({kind:"value",input:r.property,path:r.path,allowRequired:!0,destination:{kind:"property",target:r.properties,key:r.key}});continue}if(r.kind==="property-map"){_(r.input)||O(`${r.path} must be an object of value schemas`),t.has(r.input)&&O(`${r.path} is circular`),t.add(r.input);const p={properties:{}},d=[];Nt(r.destination,p),n.push({kind:"leave",input:r.input}),n.push({kind:"property-map-tail",compiled:p,required:d,destination:r.destination});const f=Object.entries(r.input);for(let u=f.length-1;u>=0;u--){const h=f[u];h!==void 0&&n.push({kind:"property",property:h[1],path:`${r.path}.${h[0]}`,key:h[0],properties:p.properties,required:d})}continue}const{input:s,path:i}=r;_(s)||O(`${i} must be a value schema object`),t.has(s)&&O(`${i} is circular`),t.add(s);const a=[...xt,...r.allowRequired?["required"]:[]],o={};if(Tt(r.destination,o),n.push({kind:"leave",input:s}),Object.hasOwn(s,"oneOf")){U(s,i,[...a,"oneOf","type"]),Object.hasOwn(s,"type")&&O(`${i} cannot declare both type and oneOf`),L(s.oneOf)||O(`${i}.oneOf must be an array of at least two value schemas`);const p=[];o.oneOf=p,K(s,o);for(let d=s.oneOf.length-1;d>=0;d--)n.push({kind:"value",input:s.oneOf[d],path:`${i}.oneOf[${d}]`,allowRequired:!1,destination:{kind:"one-of",target:p,index:d}});continue}const l=Object.hasOwn(s,"type")?s.type:void 0;switch(l){case"json":U(s,i,[...a,"type"]),K(s,o);break;case"object":U(s,i,[...a,"type","properties","additionalProperties"]),(!Object.hasOwn(s,"additionalProperties")||typeof s.additionalProperties!="boolean")&&O(`${i}.additionalProperties must be explicitly true or false`),o.type="object",K(s,o),o.additionalProperties=s.additionalProperties,Object.hasOwn(s,"properties")&&n.push({kind:"property-map",input:s.properties,path:`${i}.properties`,destination:{kind:"object",target:o}});break;case"array":U(s,i,[...a,"type","items"]),o.type="array",K(s,o),Object.hasOwn(s,"items")&&n.push({kind:"value",input:s.items,path:`${i}.items`,allowRequired:!1,destination:{kind:"item",target:o}});break;case"string":case"number":case"integer":case"boolean":case"null":U(s,i,[...a,"type","enum","const"]),o.type=l,K(s,o),Object.hasOwn(s,"enum")&&(L(s.enum)||O(`${i}.enum must be a non-empty array of scalar values`),o.enum=Array.from(s.enum,p=>p)),Object.hasOwn(s,"const")&&(o.const=s.const);break;default:O(`${i}.type must be string/number/integer/boolean/null/array/object/json, or use oneOf`)}}}c(Fe,"runSchemaCompiler");function Rt(e,t){const n={};return Fe({kind:"property-map",input:e,path:t,destination:{kind:"root",holder:n}}),n.value??O(`${t} did not compile`)}c(Rt,"compilePropertyMap");function At(e,t){const n={};return Fe({kind:"value",input:e,path:t,allowRequired:!1,destination:{kind:"root",holder:n}}),n.value??O(`${t} did not compile`)}c(At,"compileValueSchema");function ze(e){const t=At(e,"schema");return J(t),t}c(ze,"valueSchemaSpecToJsonSchema");function te(e){const t=Rt(e,"parameters"),n={type:"object",properties:t.properties,...t.required===void 0?{}:{required:t.required}};return J(n),n}c(te,"parameterSchemaSpecToJsonSchema");var Le=class extends q{static{c(this,"ToolArgsError")}violations;constructor(e){super(`invalid arguments: ${e.join("; ")}`,"INVALID_ARGS"),this.name="ToolArgsError",this.violations=e}};function It(e,t){return ee(te(e),t,"")}c(It,"validateArgs");function pe(e){const t=e.execute,n=e.finalizeContent,r=e.output.render,s=e.output.presentationMeta,i=e.presentCall,a=e.presentResult,o=e.isConcurrencySafe;if(e.timeoutMs!==void 0&&(!Number.isFinite(e.timeoutMs)||e.timeoutMs<=0))throw new Error(`defineTool(${e.name}): timeoutMs must be a positive finite number`);const l=te(e.parameters),p=ze(e.output.schema),d=c(u=>ee(l,u,""),"validate"),f={name:e.name,description:e.description,parameters:l,output:{schema:p,render(u,h){return r(u,h)},...s!==void 0?{presentationMeta(u,h){return s(u,h)}}:{}},...e.timeoutMs!==void 0?{timeoutMs:e.timeoutMs}:{},async execute(u,h){const y=d(u);if(y.length>0)throw new Le(y);return t(u,h)}};return n&&(f.finalizeContent=(u,h)=>n(u,h)),i&&(f.presentCall=u=>{if(!(d(u).length>0))return i(u)}),a&&(f.presentResult=(u,h)=>{if(!(d(u).length>0))return a(u,h)}),o&&(f.isConcurrencySafe=u=>d(u).length>0?!1:o(u)),f}c(pe,"defineTool");const k="run_code",ne={description:"Execute a TypeScript program against the available tools. Takes two required arguments: `code`, the BODY of an async function (erasable syntax only; top-level `await` and `return` work), and `description`, a short summary of what the program does. Call tools as `await tools.name(args)` per the declarations in the system prompt. Only what you print or return comes back — curate it.",codeDescription:"The program: the body of an async TypeScript function."},he={typescript:ne,python:{description:"Execute a Python program against the available tools. Takes two required arguments: `code`, the BODY of an async function (top-level `await` and `return` work), and `description`, a short summary of what the program does. Call tools as `await tools.name(args)` per the declarations in the system prompt. Answer with `print(...)` and/or `return <value>` — only that comes back, so curate it.",codeDescription:"The program: the body of an async Python function."}},Ve='Clear, concise description of what this program does in active voice, 5-10 words (shown in the UI). Examples: "Count TODO markers across packages"; "Read failing test and its fixture"; "Rename config key in every cordis.yml".';function Ke(e){const t=e();if(t===void 0)return ne;const n=he[t.language];if(!Object.hasOwn(he,t.language)||n===void 0){const r=Object.keys(he).map(s=>JSON.stringify(s)).join(", ");throw new Error(`dsh-tools: no run_code schema flavor registered for runtime language ${JSON.stringify(t.language)} (known: ${r})`)}return n}c(Ke,"resolveFlavor");var Ue=class extends q{static{c(this,"CodeRunFailedError")}constructor(e){super(e,"CODE_RUN_FAILED"),this.name="CodeRunFailedError"}};function Pt(e){let t;try{t=N(e)}catch(r){throw new Error(`tool arguments must be lossless JSON: ${r instanceof Error?r.message:String(r)}`)}if(t===void 0)throw new Error("tool arguments must be lossless JSON (call the tool with an arguments object, e.g. `{}`)");const n=N(t);if(n===void 0)throw new Error("tool arguments could not be detached for durable logging");return{dispatched:t,logged:n}}c(Pt,"jsonNormalizeArgs");const oe="  ",Dt=10;function _t(e){const t=[],n=[{kind:"value",value:e,depth:0,compact:!1}];for(let r=n.pop();r!==void 0;r=n.pop()){if(r.kind==="text"){t.push(r.text);continue}const s=r.value;if(s===null||typeof s=="boolean"||typeof s=="number"){t.push(String(s));continue}if(typeof s=="string"){t.push(JSON.stringify(s));continue}const i=r.compact||(r.depth+1)*2>Dt,a=r.depth+1;if(Array.isArray(s)){if(t.push("["),s.length===0){t.push("]");continue}n.push({kind:"text",text:i?"]":`
+${oe.repeat(r.depth)}]`});for(let l=s.length-1;l>=0;l--){const p=s[l];if(p===void 0)throw new Error("cannot render a sparse JSON array");n.push({kind:"value",value:p,depth:a,compact:i}),n.push({kind:"text",text:i?l===0?"":",":`${l===0?`
+`:`,
+`}${oe.repeat(a)}`})}continue}const o=Object.keys(s);if(t.push("{"),o.length===0){t.push("}");continue}n.push({kind:"text",text:i?"}":`
+${oe.repeat(r.depth)}}`});for(let l=o.length-1;l>=0;l--){const p=o[l];if(p===void 0)throw new Error("cannot render a missing JSON object key");const d=s[p];if(d===void 0)throw new Error("cannot render an undefined JSON object property");n.push({kind:"value",value:d,depth:a,compact:i}),n.push({kind:"text",text:i?`${l===0?"":","}${JSON.stringify(p)}:`:`${l===0?`
+`:`,
+`}${oe.repeat(a)}${JSON.stringify(p)}: `})}}return t.join("")}c(_t,"renderJsonValue");function qt(e){return typeof e=="string"?e:_t(e)}c(qt,"renderValue");function Jt(e,t){const{requireRuntime:n,peekRuntime:r,maxParallel:s,shapeDispatchLog:i}=t,a=pe({name:k,description:ne.description,parameters:{code:{type:"string",required:!0,description:ne.codeDescription},description:{type:"string",required:!0,description:Ve}},output:{schema:{type:"object",additionalProperties:!1,properties:{logs:{type:"array",required:!0,items:{type:"string"}},result:{type:"json"}}},render:c((o,l)=>{const p=l.result===void 0?"":qt(l.result),d=[l.logs.join(`
+`),p].filter(f=>f.length>0);return[{type:"text",text:d.length>0?d.join(`
+`):"(run_code completed with no output)"}]},"render")},async execute(o,l){if(o.description.trim().length===0)throw new Error("invalid description: expected a non-empty string");const p=n(),d=new AbortController,f=c(()=>{d.abort(l.signal.reason)},"onOuterAbort");l.signal.addEventListener("abort",f,{once:!0});let u=0;const h=[],y=new Set,m=new Set,b=[];let I=!1,C=!1,se=Promise.resolve(),H;const $e=c(()=>{const g=H;H=void 0,g?.()},"wakeup"),Se=c(()=>(C||(C=!0,se=(async()=>{try{for(;;){const g=new Promise(P=>{H=P}),j=b[0];if(j!==void 0&&j.settled){b.shift(),await j.commit(),j.mode==="exclusive"&&(I=!1);continue}const $=h[0];if($!==void 0){if(d.signal.aborted){h.shift(),$.abandon();continue}const P=$.classify();if(!I&&(P==="exclusive"?y.size===0:y.size<s)){P==="exclusive"&&(I=!0),$.mode=P,h.shift(),b.push($),await $.start();const D=$.flight.finally(()=>{y.delete(D),$e()});y.add(D);continue}}if(h.length===0&&b.length===0&&y.size===0)return;await g}}finally{C=!1,H=void 0}})()),se),"drive"),dt=c(async()=>{for(await Se();m.size>0;)await Promise.allSettled([...m])},"drainDispatches"),Ee=c(()=>d.signal.aborted,"runOver"),ut=c(g=>async j=>{if(Ee())throw new Error(`run_code run is over (${String(d.signal.reason)}); ${g} not dispatched`);const $=Pt(j),P=++u,D=vt(`${String(l.callId)}:code:${P}`),je={callId:D,rootCallId:l.rootCallId,name:g,arguments:$.dispatched,...l.agent?{agent:l.agent}:{},parent:l.token,signal:d.signal},X=e[Oe],ie=await new Promise((pt,ht)=>{let x;const ft=c(w=>{pt(w.isError?{isError:!0,message:w.error.message}:{isError:!1,value:w.value});const T=l.agent;if(T===void 0)return;const xe=(async()=>{const mt=await i({exec:l,agent:T,subCallId:D,name:g,isError:w.isError,content:w.content});T.session.append("tool/code-dispatch",{rootCallId:l.rootCallId,parentCallId:l.callId,subCallId:D,name:g,arguments:$.logged,isError:w.isError,content:mt})})().finally(()=>{m.delete(xe)});m.add(xe)},"settle");h.push({flight:Promise.resolve(),settled:!1,classify:c(()=>e.executionMode(je).kind,"classify"),abandon:c(()=>{ht(new Error(`run_code run is over (${String(d.signal.reason)}); ${g} tool call abandoned`))},"abandon"),async start(){l.agent?.session.append("tool/code-dispatch-start",{rootCallId:l.rootCallId,parentCallId:l.callId,subCallId:D,name:g,arguments:$.logged});const w=await X.prepare(je);if(w.kind==="dispatch"){this.flight=X.dispatch(w.exec).then(T=>{x={kind:T.kind,exec:w.exec,result:T.result},this.settled=!0});return}x={kind:w.kind,exec:w.exec,result:w.result},this.settled=!0},async commit(){if(x===void 0)return;const w=x.kind==="post-result"?await X.finalize(x.exec,x.result):X.finish(x.exec,x.result);for(const T of w.additionalContexts??[])l.deferContext(T);for(w.concludesTurn&&l.concludeTurn(),ft(w);m.size>s;)await Promise.race(m)}}),$e(),Se()});if(Ee())throw new Error(`run_code run is over (${String(d.signal.reason)}); ${g} result discarded`);if(ie.isError)throw new Error(ie.message);return ie.value},"binding"),Ce=Object.create(null);for(const g of e.schemas(l.agent))g.name!=="run_code"&&Object.defineProperty(Ce,g.name,{enumerable:!0,value:ut(g.name)});try{let g;try{g=await p.run({program:o.code,bindings:[{global:"tools",functions:Ce,errorClass:{name:"ToolCallError",memberNameProperty:"toolName"}}],signal:d.signal})}finally{d.abort("run_code settled"),await dt()}if(g.error){const j=g.logs.length>0?`
+Captured output:
+${g.logs.join(`
+`)}`:"";throw new Ue(`code run failed (${g.error.kind}): ${g.error.message}${j}`)}return{logs:g.logs,...g.value!==void 0?{result:g.value}:{}}}finally{l.signal.removeEventListener("abort",f)}},presentCall:c(o=>({card:"generic",title:o.description,kind:"execute",rawInput:o.code}),"presentCall")});return Object.defineProperty(a,"description",{enumerable:!0,get:c(()=>Ke(r).description,"get")}),Object.defineProperty(a,"parameters",{enumerable:!0,get:c(()=>te({code:{type:"string",required:!0,description:Ke(r).codeDescription},description:{type:"string",required:!0,description:Ve}}),"get")}),a}c(Jt,"createRunCodeTool");const Mt=/^[A-Za-z_$][A-Za-z0-9_$]*$/;function fe(e){return Mt.test(e)?e:JSON.stringify(e)}c(fe,"renderKey");function B(e){return"  ".repeat(e)}c(B,"pad$1");function Be(e,t){if(typeof e!="string"||e.length===0)return[];const n=e.replace(/\s+/g," ").trim();return[`${B(t)}/** ${n.replaceAll("*/",String.raw`*\/`)} */`]}c(Be,"docLines$1");function We(e){return JSON.stringify(e)}c(We,"renderScalar");function Ft(e,t){const n=t==="integer"?"number":t;return Object.hasOwn(e,"const")?We(e.const):Object.hasOwn(e,"enum")?e.enum.map(We).join(" | "):n}c(Ft,"renderConstrainedScalar$1");function me(e){return{parts:e,containsUnionOrIntersection:e.some(t=>typeof t=="string"?t.includes("|")||t.includes("&"):t.containsUnionOrIntersection)}}c(me,"typeDocumentFrom");function E(...e){return me(e)}c(E,"typeDocument");function zt(e){const t=[],n=[e];for(let r=n.pop();r!==void 0;r=n.pop()){if(typeof r=="string"){t.push(r);continue}for(let s=r.parts.length-1;s>=0;s--){const i=r.parts[s];i!==void 0&&n.push(i)}}return t.join("")}c(zt,"flattenTypeDocument");function Ye(e,t){return{node:e,indent:t,phase:"start",children:[],childIndex:0,childDocuments:[],entries:[]}}c(Ye,"schemaRenderFrame");function Lt(e,t){const n=[Ye(e,t)];let r;const s=c(i=>{n.pop();const a=n.at(-1);a===void 0?r=i:a.childDocuments.push(i)},"finish");for(;n.length>0;){const i=n.at(-1);if(i===void 0)break;if(i.phase==="children"){if(i.childIndex<i.children.length){const d=i.children[i.childIndex];if(d===void 0)throw new Error("missing schema render child");i.childIndex++,n.push(Ye(d.node,d.indent));continue}if(i.kind==="oneOf"){const d=[];for(let f=0;f<i.childDocuments.length;f++){f>0&&d.push(" | ");const u=i.childDocuments[f];u!==void 0&&d.push(u)}s(me(d));continue}if(i.kind==="array"){const d=i.childDocuments[0];if(d===void 0)throw new Error("missing array item type");s(d.containsUnionOrIntersection?E("(",d,")[]"):E(d,"[]"));continue}const o=new Set(i.node.required),l=["{"];for(let d=0;d<i.entries.length;d++){const f=i.entries[d],u=i.childDocuments[d];if(f===void 0||u===void 0)throw new Error("missing object property type");const[h,y]=f;for(const m of Be(y.description,i.indent+1))l.push(`
+`,m);l.push(`
+`,`${B(i.indent+1)}${fe(h)}${o.has(h)?"":"?"}: `,u,";")}l.push(`
+`,`${B(i.indent)}}`);const p=me(l);s(i.node.additionalProperties===!1?p:E(p," & Record<string, JsonValue>"));continue}const a=i.node;if(a.oneOf!==void 0){i.kind="oneOf",i.children=Array.from(a.oneOf,o=>({node:o,indent:i.indent})),i.childIndex=0,i.childDocuments=[],i.phase="children";continue}if(a.type===void 0){s(E("JsonValue"));continue}switch(a.type){case"string":case"number":case"integer":case"boolean":case"null":s(E(Ft(a,a.type)));break;case"array":a.items===void 0?s(E("JsonValue[]")):(i.kind="array",i.children=[{node:a.items,indent:i.indent}],i.childIndex=0,i.childDocuments=[],i.phase="children");break;case"object":{const o=a.additionalProperties!==!1,l=Object.entries(a.properties??{});l.length===0?s(E(o?"Record<string, JsonValue>":"Record<string, never>")):(i.kind="object",i.entries=l,i.children=l.map(([,p])=>({node:p,indent:i.indent+1})),i.childIndex=0,i.childDocuments=[],i.phase="children");break}default:s(E("unknown"))}}return r??E("unknown")}c(Lt,"renderSupportedSchema");function ye(e,t=0){try{return J(e),zt(Lt(e,t))}catch{return"unknown"}}c(ye,"jsonSchemaToTs");const Vt='## Writing code for run_code\n\n`run_code` takes two required arguments: `code` — the body of an async TypeScript function (erasable syntax only — no `enum` or namespaces; type annotations are advisory, the code runs type-stripped) — and `description`, a short summary of what the program does. Inside the program:\n\n- Call tools as `await tools.name(args)` — quoted access for exotic names: `tools["my-tool"](args)`. Every call resolves to the tool\'s typed canonical JSON value. Tool arguments must be lossless JSON.\n- A FAILED tool call rejects with `ToolCallError`, whose `toolName` identifies the failed tool and whose `message` is human-readable — `try/catch` it to handle and continue.\n- Independent read-only calls MAY overlap under `Promise.all` (safe calls run concurrently; mutating calls run alone, in submission order). Sequence dependent work with `await`.\n- Emit results with `return` and/or `console.log(...)`. ONLY what you print or return comes back to you — intermediate tool results never enter the conversation, so extract just what you need.\n\nThe available tools:';function He(e){const t=[...e].sort((s,i)=>s.name<i.name?-1:s.name>i.name?1:0),n=[],r=[];for(const s of t)n.push(...Be(s.description,1)),n.push(`${B(1)}${fe(s.name)}: ${ye(s.parameters,1)};`),r.push(`${B(1)}${fe(s.name)}: ${ye(s.output,1)};`);return`${Vt}
+
+\`\`\`ts
+type JsonValue = null | boolean | number | string | JsonValue[] | { [key: string]: JsonValue }
+
+${[`interface ToolArgsMap {${n.length>0?`
+${n.join(`
+`)}
+`:""}}`,`interface ToolOutputMap {${r.length>0?`
+${r.join(`
+`)}
+`:""}}`,"type ToolName = keyof ToolOutputMap",["declare class ToolCallError extends Error {",'  readonly name: "ToolCallError";',"  readonly toolName: ToolName;","}"].join(`
+`),["declare const tools: {","  [K in ToolName]: (args: ToolArgsMap[K]) => Promise<ToolOutputMap[K]>;","}"].join(`
+`)].join(`
+
+`)}
+\`\`\``}c(He,"renderToolsSdk");const Kt=new RegExp("^[\\p{XID_Start}_]\\p{XID_Continue}*$","u");function Xe(e){return Kt.test(e)&&e.normalize("NFKC")===e}c(Xe,"isBareIdentifier");const Ge=new Set(["False","None","True","and","as","assert","async","await","break","class","continue","def","del","elif","else","except","finally","for","from","global","if","import","in","is","lambda","nonlocal","not","or","pass","raise","return","try","while","with","yield","__debug__"]),Ut=["Any","Literal","NotRequired","Protocol","TypedDict"];function S(e){return"    ".repeat(e)}c(S,"pad");const Bt=/[\u0000-\u0008\u000e-\u001f\u007f-\u009f]/g,Wt=/[\ud800-\udfff]/gu;function ge(e){const t=e.description;if(typeof t!="string")return;const n=t.replace(/\s+/g," ").replace(Bt,r=>`\\x${r.charCodeAt(0).toString(16).padStart(2,"0")}`).replace(Wt,r=>`\\u${r.charCodeAt(0).toString(16).padStart(4,"0")}`).trim();return n.length===0?void 0:n}c(ge,"describe");function Yt(e,t){const n=ge({description:e});if(n===void 0)return[];const r=n.replaceAll("\\","\\\\").replaceAll('"','\\"');return[`${S(t)}"""${r}"""`]}c(Yt,"docLines");function be(e){const t=e.split(/[^\p{XID_Continue}]+|_+/u).filter(n=>n.length>0).map(n=>`${n.charAt(0).toUpperCase()}${n.slice(1)}`).join("").normalize("NFKC");return(new RegExp("^\\p{XID_Start}","u").test(t)?t:`Tool${t}`).normalize("NFKC")}c(be,"camelCase");const Qe=120,Ht=180;function Ze(e){if(e.length<=Qe)return e;const t=e.slice(0,Qe);return/[\uD800-\uDBFF]$/.test(t)?t.slice(0,-1):t}c(Ze,"capClassNameBase");function Xt(e,t){const n=Ze(e);let r=n;if(t.usedClassNames.has(r)){let s=t.nextClassCounter.get(n)??2;for(;t.usedClassNames.has(`${n}${s}`);)s++;r=`${n}${s}`,t.nextClassCounter.set(n,s+1)}return t.usedClassNames.add(r),r}c(Xt,"allocateClassName");function et(e,t){return Ze(`${e}${t}`.normalize("NFKC"))}c(et,"childClassName");function tt(e){return e===!0?"True":e===!1?"False":typeof e=="string"?JSON.stringify(e):typeof e=="number"&&Number.isInteger(e)&&!Number.isSafeInteger(e)?BigInt(e).toString():String(e)}c(tt,"pyScalar");function re(e,t,n){return e.const!==void 0?(n.typing.add("Literal"),`Literal[${tt(e.const)}]`):e.enum!==void 0?(n.typing.add("Literal"),`Literal[${e.enum.map(tt).join(", ")}]`):t}c(re,"renderConstrainedScalar");function we(e,t,n){const r=c((s,i,a)=>({schema:s,className:i,phase:"start",listDepth:a,children:[],childIndex:0,childTypes:[],entries:[]}),"newFrame");try{J(e);const s=[r(e,t,0)];let i;const a=c(o=>{s.pop();const l=s.at(-1);l===void 0?i=o:l.childTypes.push(o)},"finish");for(;s.length>0;){const o=s.at(-1);if(o===void 0)break;if(o.phase==="children"){if(o.childIndex<o.children.length){const h=o.children[o.childIndex];if(h===void 0)throw new Error("missing python render child");o.childIndex++,s.push(r(h.schema,h.className,h.listDepth));continue}if(o.kind==="oneOf"){let h="";for(const[y,m]of o.childTypes.entries())h=y===0?m:`${h} | ${m}`;a(h);continue}if(o.kind==="array"){a(`list[${o.childTypes[0]??"Any"}]`);continue}const p=o.node,d=o.allocated;if(p===void 0||d===void 0)throw new Error("missing typeddict frame state");const f=new Set(p.required),u=[`class ${d}(TypedDict):`];for(let h=0;h<o.entries.length;h++){const y=o.entries[h],m=o.childTypes[h];if(y===void 0||m===void 0)throw new Error("missing typeddict field type");const[b,I]=y,C=ge(I);C!==void 0&&u.push(`${S(1)}# ${C}`),f.has(b)?u.push(`${S(1)}${b}: ${m}`):(n.typing.add("NotRequired"),u.push(`${S(1)}${b}: NotRequired[${m}]`))}p.additionalProperties!==!1&&u.push(`${S(1)}# Additional keys beyond those declared are allowed.`),u.length===1&&u.push(`${S(1)}pass`),n.classes.push(u.join(`
+`)),a(d);continue}o.phase="children";const l=o.schema;if(l.oneOf!==void 0){o.kind="oneOf",o.children=l.oneOf.map((p,d)=>({schema:p,className:et(o.className,`${d+1}`),listDepth:o.listDepth}));continue}if(l.type===void 0){n.typing.add("Any"),a("Any");continue}switch(l.type){case"string":a(re(l,"str",n));break;case"number":a(re(l,"float",n));break;case"integer":a(re(l,"int",n));break;case"boolean":a(re(l,"bool",n));break;case"null":a("None");break;case"array":if(l.items===void 0){n.typing.add("Any"),a("list[Any]");break}if(o.listDepth>=Ht){n.typing.add("Any"),a("Any");break}o.kind="array",o.children=[{schema:l.items,className:o.className,listDepth:o.listDepth+1}];break;case"object":{const p=Object.entries(l.properties??{});if(t===""||!p.every(([d])=>Xe(d)&&!Ge.has(d)&&!(d.startsWith("__")&&!d.endsWith("__")))){n.typing.add("Any"),a("dict[str, Any]");break}if(p.length===0&&l.additionalProperties!==!1){n.typing.add("Any"),a("dict[str, Any]");break}o.kind="typeddict",o.node=l,o.allocated=Xt(o.className,n),n.typing.add("TypedDict"),o.entries=p,o.children=p.map(([d,f])=>({schema:f,className:et(o.allocated??"",be(d)),listDepth:1}));break}default:n.typing.add("Any"),a("Any")}}return i??"Any"}catch{return n.typing.add("Any"),"Any"}}c(we,"renderType");function Gt(e){return we(e,"",{classes:[],usedClassNames:new Set,nextClassCounter:new Map,typing:new Set})}c(Gt,"jsonSchemaToPy");const Qt='## Writing code for run_code\n\n`run_code` takes two required arguments: `code` — the body of an async Python function (top-level `await` and `return` both work) — and `description`, a short summary of what the program does. At run time exactly two of the names declared below are bound: `tools` and `ToolCallError`. Everything else is a STATIC STUB describing argument and return types — in particular the `TypedDict` classes do NOT exist at run time, so build arguments as plain `dict`/`list` JSON values: `await tools.name({"field": 1})`, never `FooArgs(field=1)`, which raises `NameError`. Inside the program:\n\n- Call tools as `await tools.name(args)` — subscript access for exotic, reserved, or underscore-leading names: `await tools["my-tool"](args)`. Every call resolves to the tool\'s typed canonical JSON value (each method\'s return type below). Tool arguments must be lossless JSON.\n- A FAILED tool call raises `ToolCallError`, whose `toolName` identifies the failed tool and whose message is human-readable — wrap in `try/except` to handle and continue.\n- Independent read-only calls MAY overlap under `asyncio.gather` (safe calls run concurrently; mutating calls run alone, in submission order). Sequence dependent work with `await`.\n- Emit the run\'s answer with `print(...)` and/or a top-level `return <value>`; the returned value must be lossless JSON. ONLY what you print and the returned value come back — intermediate tool results never enter the conversation, so extract just what you need.\n\nThe available tools:';function nt(e){const t=[...e].sort((l,p)=>l.name<p.name?-1:l.name>p.name?1:0),n={classes:[],usedClassNames:new Set,nextClassCounter:new Map,typing:new Set(["Protocol"])},r=[];let s=0;for(const l of t){const p=we(l.parameters,`${be(l.name)}Args`,n),d=we(l.output,`${be(l.name)}Output`,n);if(Xe(l.name)&&!Ge.has(l.name)&&!l.name.startsWith("_")){const f=Yt(l.description,2);r.push(f.length>0?`${S(1)}async def ${l.name}(self, args: ${p}) -> ${d}:`:`${S(1)}async def ${l.name}(self, args: ${p}) -> ${d}: ...`),r.push(...f),s+=1}else{r.push(`${S(1)}# tools[${JSON.stringify(l.name)}](args: ${p}) -> ${d}`);const f=ge(l);f!==void 0&&r.push(`${S(1)}#   ${f}`)}}const i=(s>0?r:[`${S(1)}pass`,...r]).join(`
+`),a=Ut.filter(l=>n.typing.has(l)),o=n.classes.length>0?`${n.classes.join(`
+
+`)}
+
+`:"";return`${Qt}
+
+\`\`\`python
+${`from typing import ${a.join(", ")}
+
+class ToolCallError(Exception):
+    toolName: str
+
+${o}class Tools(Protocol):
+${i}
+
+tools: Tools`}
+\`\`\``}c(nt,"renderToolsSdkPy");const Zt={type:"array",items:{type:"json"}};function en(e){const t=e.execute;return pe({...e,output:{schema:Zt,render:c((n,r)=>r,"render")},async execute(n,r){return await t(n,r)}})}c(en,"defineContentToolFixture");const tn=99,nn=`\`${k}\` is the only tool you can call directly — a tool call naming any other tool fails. Reach every tool the SDK declares below from inside the program.`,ve={typescript:He,python:nt},Oe=Symbol("@qqbrowser/qbot-dsh-tools.scheduler"),ot="ABORTED",rt="ABORTED_BEFORE_DISPATCH";var W=class extends q{static{c(this,"ToolNotFoundError")}constructor(e,t){super(t===void 0?`unknown tool "${e}"`:`unknown tool "${e}": ${t}`,"UNKNOWN_TOOL"),this.name="ToolNotFoundError"}},R=class extends q{static{c(this,"ToolOutputError")}violations;constructor(e,t){super(`tool "${e}" returned invalid output: ${t.join("; ")}`,"INVALID_TOOL_OUTPUT"),this.name="ToolOutputError",this.violations=t}};function ke(e,t,n){return new R(e,[`output.${t} failed: ${Y(n)}`])}c(ke,"projectionError");function st(e,t,n){try{const r=N(n);if(r===void 0)throw new R(e,[`output.${t} returned non-lossless JSON`]);return r}catch(r){throw r instanceof R?r:ke(e,t,r)}}c(st,"snapshotProjection");function on(e,t){try{const n=N(t);if(n===void 0)throw new R(e,["value is not lossless JSON"]);return n}catch(n){throw n instanceof R?n:new R(e,[`value snapshot failed: ${Y(n)}`])}}c(on,"snapshotToolValue");function Y(e){try{return e instanceof Error||typeof e=="object"&&e!==null&&"message"in e&&typeof e.message=="string"?e.message:String(e)}catch{return"<unprintable thrown value>"}}c(Y,"errorMessage");function rn(e){const t=e.map(n=>n.type==="text"?n.text:`[${n.type} content]`).join(`
+`);return t.length>0?t:"tool result blocked by post-execute policy"}c(rn,"failureMessageFromContent");function it(e){const t=N(e);if(t===void 0)throw new TypeError("tool result must be losslessly JSON-serializable");return G(t)}c(it,"materializePresentation");function sn(e){try{return e instanceof q?{name:e.name,code:e.code}:void 0}catch{return}}c(sn,"errorInfo");var an=class{static{c(this,"ToolLayer")}tools;restrictions=new Te;guards=new Te;mode;constructor(e){this.tools=new bt(t=>new Error(e===void 0?`tool "${t}" is already registered (for a per-agent variant, register through that agent's \`agent.ctx\` instead)`:`tool "${t}" is already registered in this scope`))}isEmpty(){return this.tools.isEmpty()&&this.restrictions.isEmpty()&&this.guards.isEmpty()&&this.mode===void 0}admits(e){for(const t of this.restrictions.values())if(t.allow!==void 0&&!t.allow.has(e)||t.deny!==void 0&&t.deny.has(e))return!1;return!0}guardReason(e){for(const t of this.guards.values()){const n=t(e);if(n!==void 0)return n}}};function cn(e){const t=e??10;if(!Number.isInteger(t)||t<1)throw new Error("maxParallelSubCalls must be a positive integer");return t}c(cn,"resolveMaxParallelSubCalls");var at=class extends gt{static{c(this,"ToolRuntime")}static inject=["systemPrompt"];static Config=ae.object({mode:ae.union(["native","code","both"]).default("native"),maxParallelSubCalls:ae.natural().min(1).default(10)});[Oe]={prepare:c(e=>this.prepareScheduledExecution(e),"prepare"),dispatch:c(e=>this.dispatchScheduledExecution(e),"dispatch"),finalize:c((e,t)=>this.finalizeScheduledExecution(e,t),"finalize"),finish:c((e,t)=>this.finishScheduledExecution(e,t),"finish")};deferredContexts=new WeakMap;concludingExecutions=new WeakSet;cancellationStates=new WeakMap;contentFinalizers=new WeakMap;layers=new wt(e=>new an(e),()=>{this.ctx.emit("tools/change")});defaultMode;maxParallelSubCalls;codeTransport;constructor(e,t={}){super(e,"tools"),this.defaultMode=t.mode??"native",this.maxParallelSubCalls=cn(t.maxParallelSubCalls),e.systemPrompt.tools(n=>this.wireSchemas(n.scope)),this.defaultMode!=="native"&&(e.systemPrompt.section(this.collapseSection()),e.systemPrompt.section(this.sdkSection()))}collapseSection(){return{name:"tools:code-only",order:tn,text:c(e=>this.modeFor(e.scope)==="code"?nn:"","text")}}sdkSection(){return{name:"tools:sdk",order:150,text:c(e=>{const t=this.modeFor(e.scope);if(t==="native")return"";const n=this.requireCodeRuntime(t),r=ve[n.language];if(r===void 0)throw new Error(`dsh-tools: no SDK renderer for ${n.language}`);return r(this.sdkSchemas(e.scope))},"text")}}modeFor(e){const t=this.layers.chainLayers(e);for(let n=t.length-1;n>=0;n-=1){const r=t[n]?.mode;if(r!==void 0)return r}return this.defaultMode}requireCodeTransport(){return this.codeTransport??=Jt(this,{requireRuntime:c(()=>this.requireCodeRuntime(this.defaultMode),"requireRuntime"),peekRuntime:c(()=>this.ctx.get("codeRuntime"),"peekRuntime"),maxParallel:this.maxParallelSubCalls,shapeDispatchLog:c(e=>this.shapeDispatchLog(e),"shapeDispatchLog")}),this.codeTransport}presentAs(e){const t=this.ctx;if(Ne(t)===void 0)throw new Error("tools.presentAs() requires a scoped context (agent.ctx): a context-global presentation is the `mode` config field on the tools row");return t.effect(function*(){yield this.layers.effect(t,n=>{if(n.mode!==void 0)throw new Error(`tools.presentAs("${e}") conflicts with "${n.mode}" already declared for this scope; one composition selects one presentation`);return n.mode=e,()=>{n.mode=void 0}},{label:"tools.presentAs()"}),e!=="native"&&(yield t.systemPrompt.section(this.collapseSection()),yield t.systemPrompt.section(this.sdkSection()))}.bind(this),"tools.presentAs()")}wireSchemas(e){const t=this.view(e),n=this.modeFor(e);if(n==="native")return{schemas:[...t.visible.values()].map(s=>this.schemaOf(s,!1)),knownNames:[...t.knownNames]};this.requireCodeRuntime(n);const r=[...t.visible.values()].map(s=>this.schemaOf(s,!1));return n==="code"?{schemas:r.filter(s=>s.name===k),knownNames:[k]}:{schemas:r,knownNames:[...t.knownNames,k]}}requireCodeRuntime(e){const t=this.ctx.get("codeRuntime");if(!t)throw new Error(`dsh-tools: mode "${e}" requires a code runtime — load a ctx.codeRuntime implementation (e.g. @qqbrowser/qbot-dsh-code-runtime-worker-thread) or set tools mode to "native"`);if(!Object.hasOwn(ve,t.language)){const n=Object.keys(ve).map(r=>JSON.stringify(r)).join(", ");throw new Error(`dsh-tools: no SDK renderer registered for runtime language ${JSON.stringify(t.language)} (known: ${n})`)}return t}register(e){const t=e.name,n=e.output;if(n===void 0||typeof n!="object"||typeof n.render!="function"||n.presentationMeta!==void 0&&typeof n.presentationMeta!="function")throw new TypeError(`tool "${t}" must declare output { schema, render, presentationMeta? }`);J(n.schema);const r=e.timeoutMs;if(r!==void 0&&(!Number.isFinite(r)||r<=0))throw new TypeError(`tool "${t}" timeoutMs must be a positive finite number`);if(t==="run_code")throw new Error(`tool name "${k}" is reserved for the Code Mode presentation transport and cannot be registered or shadowed`);return this.layers.effect(this.ctx,s=>s.tools.insert(t,e),{label:"tools.register()"})}restrict(e){const t=Ne(this.ctx);if(t===void 0)throw new Error("tools.restrict() requires a scoped context (agent.ctx): a context-global restriction would mask every agent — deny the tool for the intended agent instead");const n=e.allow,r=e.deny;if(n===void 0&&r===void 0)throw new Error("tools.restrict({}) is a no-op: pass `allow` and/or `deny` (an empty filter is almost always a materialized-empty-config bug)");const s={...n!==void 0?{allow:new Set(n)}:{},...r!==void 0?{deny:new Set(r)}:{}};if([...n??[],...r??[]].includes("run_code"))throw new Error(`tools.restrict() cannot name reserved Code Mode presentation transport "${k}"; restrict end-capability tools instead`);const i=this.view(t).restrictableNames,a=[...n??[],...r??[]].filter(o=>!i.has(o));if(a.length>0)throw new Error(`tools.restrict() names unknown global tool${a.length>1?"s":""} ${a.map(o=>`"${o}"`).join(", ")}; known global tools: ${[...i].sort().join(", ")||"(none)"}`);return this.layers.effect(this.ctx,o=>o.restrictions.append(s),{label:"tools.restrict()"})}guard(e){return this.layers.effect(this.ctx,t=>t.guards.append(e),{label:"tools.guard()",notify:!1})}guardReason(e){const t=this.layers.global.guardReason(e);if(t!==void 0)return t;if(e.agent!==void 0)for(const n of this.layers.chainLayers(e.agent)){const r=n.guardReason(e);if(r!==void 0)return r}}view(e){const t=this.layers.chainLayers(e),n=this.layers.peek(e),r=new Map(this.layers.global.tools.entries());for(const o of t)if(o!==n)for(const[l,p]of o.tools.entries())r.set(l,p);const s=new Map,i=new Set,a=new Set;for(const[o,l]of r)i.add(o),a.add(o),t.every(p=>p.admits(o))&&s.set(o,l);if(n!==void 0)for(const[o,l]of n.tools.entries())i.add(o),s.set(o,l);return this.modeFor(e)!=="native"&&s.set(k,this.requireCodeTransport()),{visible:s,knownNames:i,restrictableNames:a}}get(e,t){return this.view(t).visible.get(e)}resolveExecution(e,t,n){const r=this.get(e,t);if(r!==void 0&&!this.collapses(e,t,n))return r}schemas(e){return[...this.view(e).visible.values()].map(t=>this.schemaOf(t,!0))}sdkSchemas(e){return[...this.view(e).visible.values()].filter(t=>t.name!==k).map(t=>{const n=N(t.output.schema);if(n===void 0)throw new Error(`tool "${t.name}" output schema must be lossless JSON before SDK projection`);return{...this.schemaOf(t,!0),output:n}})}schemaOf(e,t){const{name:n,description:r,parameters:s}=e,i=t?N(s):s;if(i===void 0)throw new Error(`tool "${n}" parameters must be lossless JSON before schema projection`);return{name:n,description:r,parameters:i}}executionMode(e){const t=this.resolveExecution(e.name,e.agent,e.parent!==void 0);if(!t?.isConcurrencySafe)return{kind:"exclusive"};try{return t.isConcurrencySafe(e.arguments)===!0?{kind:"parallel"}:{kind:"exclusive"}}catch{return{kind:"exclusive"}}}async shapeDispatchLog(e){try{return await this.ctx.waterfall(F(this,e.agent),"tools/code-dispatch-log",e,()=>Promise.resolve(e.content))}catch(t){return this.ctx.logger.warn(`tools: code-dispatch-log listener failed for ${e.name}: ${Y(t)}; logging the original settled content`),e.content}}collapses(e,t,n){return!n&&this.modeFor(t)==="code"&&e!=="run_code"}async execute(e){return this.prepareExecution(e,t=>this.completeScheduledExecution(t))}async completeScheduledExecution(e){switch(e.kind){case"dispatch":{const t=await this.dispatchScheduledExecution(e.exec);return t.kind==="post-result"?await this.finalizeScheduledExecution(e.exec,t.result):this.finishScheduledExecution(e.exec,t.result)}case"post-result":return await this.finalizeScheduledExecution(e.exec,e.result);case"final-result":return this.finishScheduledExecution(e.exec,e.result);default:return z(e,"scheduled tool preparation")}}createExecution(e){const t=[],n=ln(),r=e.callId,s=e.rootCallId??r,i=e.name,a=e.agent,o=e.parent,l=e.signal,p=this.get(i,a),d=p!==void 0&&this.collapses(i,a,o!==void 0),f=this.concludingExecutions,u={token:n,callId:r,rootCallId:s,name:i,signal:l,...a!==void 0?{agent:a}:{},...o!==void 0?{parent:o}:{},deferContext(m){t.push(m)},concludeTurn(){f.add(this)}},h=p?.finalizeContent?.bind(p),y=c(()=>d&&!l.aborted?void 0:h,"finalizerFor");try{const m=N(e.arguments);if(m===void 0)throw new TypeError("tool execution arguments must be losslessly JSON-serializable");const b={...u,arguments:G(m)};return this.deferredContexts.set(b,t),this.contentFinalizers.set(b,y()),this.cancellationStates.set(b,{callerSignal:l,bodyInvoked:!1}),d?l.aborted?{kind:"final-result",exec:b,result:M()}:{kind:"final-result",exec:b,result:A(new W(i,`only \`${k}\` is callable directly — call \`${i}\` from inside a \`${k}\` program instead`))}:{kind:"ready",exec:b}}catch(m){const b={...u,arguments:void 0};return this.contentFinalizers.set(b,y()),{kind:"final-result",exec:b,result:A(m)}}}async prepareScheduledExecution(e){return this.prepareExecution(e,t=>t)}async prepareExecution(e,t){const n=this.createExecution(e);if(n.kind!=="ready")return t(n);const r=n.exec;if(this.callerCancelled(r))return t({kind:"final-result",exec:r,result:M()});try{const s=F(this,r.agent),i=await this.ctx.waterfall(s,"tools/pre-execute",r,()=>Promise.resolve({kind:"allow"})),a=i.kind==="ask"?await this.serviceAsk(r,i):{decision:i,approvalCancelled:!1},{decision:o}=a;if(this.callerCancelled(r)&&a.approvalCancelled)return await t({kind:"post-result",exec:r,result:M()});const l=o.kind==="allow"?this.guardReason(r):o.reason;return l!==void 0?await t({kind:"post-result",exec:r,result:this.materializeFinalResult({content:[{type:"text",text:`Error: ${l}`}],isError:!0,error:{message:l}})}):this.callerCancelled(r)?await t({kind:"post-result",exec:r,result:M()}):await t({kind:"dispatch",exec:r})}catch(s){return t({kind:"final-result",exec:r,result:A(s)})}}callerCancelled(e){const t=this.cancellationStates.get(e);if(t===void 0)throw new Error("tool registry scheduler invariant violated: missing cancellation state");return t.callerSignal.aborted}cancellationResult(e,t){const n=this.cancellationStates.get(e);if(n===void 0)throw new Error("tool registry scheduler invariant violated: missing cancellation state");return n.bodyInvoked?lt(t):M(t)}async dispatchToolBody(e){const t=this.cancellationStates.get(e);if(t===void 0)throw new Error("tool registry scheduler invariant violated: missing cancellation state");const n=e.signal,r=dn(t.callerSignal,n),s=r.signal;if(ct(s))return r.dispose(),M();e.signal=s;try{const i=this.resolveExecution(e.name,e.agent,e.parent!==void 0);if(!i)throw new W(e.name);t.bodyInvoked=!0;const a=await i.execute(e.arguments,e),o=this.createSuccessResult(e,i,a);return ct(s)?lt(o):o}catch(i){return A(i)}finally{r.dispose(),e.signal=n}}async dispatchScheduledExecution(e){try{const t=e,n=F(this,e.agent),r=await this.ctx.waterfall(n,"tools/execute",t,()=>this.dispatchToolBody(t)),s=this.normalizeDispatchResult(e,r),i=this.deferredContexts.get(e);if(i===void 0)throw new Error("tool registry scheduler invariant violated: unprepared execution");const a=i.length===0?s:this.markCanonical(e,{...s,additionalContexts:[...i,...s.additionalContexts??[]]});return{kind:"post-result",result:this.callerCancelled(e)&&!a.isError?this.cancellationResult(e,a):a}}catch(t){return{kind:"final-result",result:A(t)}}}async finalizeScheduledExecution(e,t){try{const n=await this.postExecute(e,t);return this.finishScheduledExecution(e,this.callerCancelled(e)&&!n.isError?this.cancellationResult(e,n):n)}catch(n){return this.finishScheduledExecution(e,A(n))}}finishScheduledExecution(e,t){let n;try{n=this.materializeFinalResult(t)}catch(s){n=this.materializeFinalResult(A(s))}let r;try{r=this.materializeFinalResult(this.applyFinalContent(e,n))}catch(s){r=this.materializeFinalResult(A(s))}return this.notifyResult(e,r),r}applyFinalContent(e,t){const n=this.contentFinalizers.get(e);if(n===void 0)return t;const r=n(e,t);return r===void 0?t:{...t,content:r}}notifyResult(e,t){Object.freeze(e);const{name:n,callId:r}=e,s=c(a=>{this.ctx.logger.warn(`tool "${n}" (${r}): tools/result observer failed: ${Y(a)}`)},"reportFailure"),i=this.ctx.events.dispatch("emit",[F(this,e.agent),"tools/result",e,t]);for(const a of i)try{const o=a(e,t);Promise.resolve(o).catch(s)}catch(o){s(o)}}async serviceAsk(e,t){const n=this.ctx.get("approval");if(n===void 0)return{decision:{kind:"deny",reason:t.reason??`tool "${e.name}" requires approval (not yet supported)`},approvalCancelled:!1};if(e.agent===void 0)return{decision:{kind:"deny",reason:`tool "${e.name}" requires approval, but the call has no agent to route it through`},approvalCancelled:!1};const r=await n.request({agent:e.agent,toolName:e.name,callId:e.callId,...t.reason!==void 0?{reason:t.reason}:{},signal:e.signal});switch(r){case"allowed-once":return{decision:{kind:"allow"},approvalCancelled:!1};case"rejected":return{decision:{kind:"deny",reason:`the user rejected tool "${e.name}"`},approvalCancelled:!1};case"cancelled":return{decision:{kind:"deny",reason:`approval for tool "${e.name}" was cancelled`},approvalCancelled:!0};case"unavailable":return{decision:{kind:"deny",reason:`tool "${e.name}" requires approval, but no approval channel is available`},approvalCancelled:!1};default:return z(r,"ApprovalOutcome")}}async postExecute(e,t){const n=await this.ctx.waterfall(F(this,e.agent),"tools/post-execute",e,t,()=>Promise.resolve({kind:"accept"})),r=n.additionalContexts??[];if(n.kind==="block"){const i=rn(n.feedback);return this.markCanonical(e,{content:n.feedback,isError:!0,error:{message:i},...r.length>0?{additionalContexts:r}:{}})}if(Object.hasOwn(n,"content")&&Object.hasOwn(n,"value"))throw new TypeError("tools/post-execute accept decision cannot replace both value and content");const s=[...t.additionalContexts??[],...r];if(Object.hasOwn(n,"value")){if(t.isError)throw new TypeError("tools/post-execute cannot replace the value of a failed result");const i=this.resolveExecution(e.name,e.agent,e.parent!==void 0);if(i===void 0)throw new W(e.name);const a=this.createSuccessResult(e,i,n.value);return this.markCanonical(e,{...a,...s.length>0?{additionalContexts:s}:{}})}return this.markCanonical(e,{...t,...n.content!==void 0?{content:n.content}:{},...s.length>0?{additionalContexts:s}:{}})}canonicalResults=new WeakMap;markCanonical(e,t){return this.canonicalResults.set(t,e.token),t}createSuccessResult(e,t,n){const r=on(t.name,n),s=ee(t.output.schema,r,"value");if(s.length>0)throw new R(t.name,s);const i=G(r);let a;try{a=t.output.render(e.arguments,i)}catch(d){throw ke(t.name,"render",d)}const o=st(t.name,"render",a);let l;if(e.parent===void 0&&t.output.presentationMeta!==void 0){let d;try{d=t.output.presentationMeta(e.arguments,i)}catch(f){throw ke(t.name,"presentationMeta",f)}l=st(t.name,"presentationMeta",d)}const p=this.concludingExecutions.has(e);return this.markCanonical(e,this.materializeFinalResult({isError:!1,value:i,content:o,...l!==void 0?{meta:l}:{},...p?{concludesTurn:!0}:{}}))}normalizeDispatchResult(e,t){if(this.canonicalResults.get(t)===e.token)return t;if(t.isError)return this.markCanonical(e,{isError:!0,error:t.error,content:t.content,...t.meta!==void 0?{meta:t.meta}:{},...t.additionalContexts!==void 0?{additionalContexts:t.additionalContexts}:{}});const n=this.resolveExecution(e.name,e.agent,e.parent!==void 0);if(n===void 0)throw new W(e.name);const r=this.createSuccessResult(e,n,t.value);return this.markCanonical(e,{...r,...t.additionalContexts!==void 0?{additionalContexts:t.additionalContexts}:{}})}materializeFinalResult(e){const t={content:e.content,...e.meta!==void 0?{meta:e.meta}:{},...e.additionalContexts!==void 0?{additionalContexts:e.additionalContexts}:{}};return e.isError?it({isError:!0,error:e.error,...t}):G({...it({isError:!1,...t,...e.concludesTurn===!0?{concludesTurn:!0}:{}}),value:e.value})}};function ln(){return Symbol("dsh.tool.execution")}c(ln,"createExecutionToken");function A(e){const t=sn(e),n=Y(e);return{content:[{type:"text",text:`Error: ${n}`}],isError:!0,error:{message:n,...t?{info:t}:{}}}}c(A,"toolErrorResult");function ct(e){return e.aborted}c(ct,"isAborted");function dn(e,t){if(e===t)return{signal:e,dispose(){}};const n=new AbortController;let r=!1;const s=c(()=>{r&&(r=!1,e.removeEventListener("abort",a),t.removeEventListener("abort",o))},"dispose"),i=c(l=>{const p=l.reason;n.abort(p),s()},"abortFrom"),a=c(()=>{i(e)},"abortFromCaller"),o=c(()=>{i(t)},"abortFromWrapper");return t.aborted?o():e.aborted?a():(r=!0,e.addEventListener("abort",a,{once:!0}),t.addEventListener("abort",o,{once:!0})),{signal:n.signal,dispose:s}}c(dn,"fuseToolSignals");function lt(e){const t=e?.additionalContexts??[];return{content:[{type:"text",text:"Error: tool call aborted"}],isError:!0,error:{message:"tool call aborted",info:{name:"AbortError",code:ot}},...t.length>0?{additionalContexts:t}:{}}}c(lt,"toolAbortedResult");function M(e){const t=e?.additionalContexts??[];return{content:[{type:"text",text:"Error: tool call aborted before dispatch"}],isError:!0,error:{message:"tool call aborted before dispatch",info:{name:"AbortError",code:rt}},...t.length>0?{additionalContexts:t}:{}}}c(M,"toolAbortedBeforeDispatchResult");export{Ue as CodeRunFailedError,Q as JsonSchemaError,k as RUN_CODE_NAME,ot as TOOL_ABORTED,rt as TOOL_ABORTED_BEFORE_DISPATCH,Oe as TOOL_RUNTIME_SCHEDULER,Le as ToolArgsError,W as ToolNotFoundError,R as ToolOutputError,at as ToolRuntime,at as default,Ct as assertObjectJsonSchema,J as assertSupportedJsonSchema,en as defineContentToolFixture,pe as defineTool,Gt as jsonSchemaToPy,ye as jsonSchemaToTs,te as parameterSchemaSpecToJsonSchema,He as renderToolsSdk,nt as renderToolsSdkPy,It as validateArgs,ee as validateJsonSchemaValue,ze as valueSchemaSpecToJsonSchema};

package/node_modules/@qqbrowser/qbot-dsh-tools/lib/invariant.js

@@ -0,0 +1 @@
+var b=Object.defineProperty;var p=(r,n)=>b(r,"name",{value:n,configurable:!0});const x="@qqbrowser/qbot-dsh-tools",I="tools-invariant",C=["invariants"];function m(r,n,l){Object.isFrozen(r)||l("tools/result execution must be frozen before publication"),(!Object.isFrozen(n)||!Object.isFrozen(n.content))&&l("tools/result outcome and content must be frozen before publication"),(r.name.length===0||String(r.callId).length===0)&&l("tools/result execution must carry non-empty name and callId")}p(m,"validateResult");const w=Object.assign((r,n)=>{const l=new WeakMap,d=new WeakMap,i=new WeakMap,f=p((e,t)=>{if(t.type!=="tool/code-dispatch-start"&&t.type!=="tool/code-dispatch")return;const o=String(t.data.rootCallId),a=String(t.data.parentCallId),u=String(t.data.subCallId);if(o.length===0||a.length===0||u.length===0){n(`${t.type} must carry non-empty rootCallId, parentCallId, and subCallId`);return}const s=i.get(e),c=s?.get(u);c!==void 0&&c!==o&&n(`${t.type} changed rootCallId for subCallId ${u}`),a!==o&&s?.get(a)!==o&&n(`${t.type} parentCallId ${a} does not belong to rootCallId ${o}`)},"validateDispatch"),g=p((e,t)=>{t.type!=="tool/code-dispatch-start"&&t.type!=="tool/code-dispatch"||i.get(e).set(String(t.data.subCallId),String(t.data.rootCallId))},"commitDispatch"),y=p(e=>{let t=null;i.set(e,new Map);for(const o of e.events)f(e,o),g(e,o),o.type==="turn/start"?t=o.data.turn:o.type==="turn/end"?t=null:(o.type==="tool/code-dispatch-start"||o.type==="tool/code-dispatch")&&t===null&&n(`${o.type} appended outside any open turn`);return d.set(e,t),t},"seed"),h=p(e=>d.get(e)??y(e),"openTurnFor");for(const e of r.sessions.list())y(e);r.on("session/created",e=>{y(e)},{global:!0}),r.on("session/event",(e,t)=>{f(e,t),g(e,t),t.type==="turn/start"?d.set(e,t.data.turn):t.type==="turn/end"&&d.set(e,null)},{global:!0}),r.on("internal/dispatch",(e,t,o)=>{if(t==="session/event"){const[s,c]=o;f(s,c),(c.type==="tool/code-dispatch-start"||c.type==="tool/code-dispatch")&&h(s)===null&&n(`${c.type} appended outside any open turn`);return}if(t==="tools/pre-execute"){const s=o[0];l.has(s)&&n("tools/pre-execute repeated for one execution"),l.set(s,"pre");return}if(t==="tools/execute"){const s=o[0];l.get(s)!=="pre"&&n("tools/execute must follow tools/pre-execute"),l.set(s,"execute");return}if(t==="tools/post-execute"){const s=o[0],c=l.get(s);c!=="pre"&&c!=="execute"&&n("tools/post-execute must follow tools/pre-execute or tools/execute"),l.set(s,"post");return}if(t!=="tools/result")return;const[a,u]=o;m(a,u,n),l.delete(a)},{global:!0})},{inject:["sessions"]}),$=p(r=>Promise.resolve(r.invariants.register(x,w)),"apply");export{$ as apply,C as inject,I as name};

package/node_modules/@qqbrowser/qbot-dsh-tools/lib/types/code-mode.js

@@ -0,0 +1,12 @@
+var W=Object.defineProperty;var r=(a,n)=>W(a,"name",{value:n,configurable:!0});import{CallId as X,HarnessError as G}from"@qqbrowser/qbot-dsh-llm";import{snapshotJsonValue as z}from"@qqbrowser/qbot-dsh-session";import{defineTool as Z,parameterSchemaSpecToJsonSchema as ee}from"./schema.js";import{TOOL_RUNTIME_SCHEDULER as te}from"./index.js";export const RUN_CODE_NAME="run_code",SDK_SECTION_ORDER=150;const I={description:"Execute a TypeScript program against the available tools. Takes two required arguments: `code`, the BODY of an async function (erasable syntax only; top-level `await` and `return` work), and `description`, a short summary of what the program does. Call tools as `await tools.name(args)` per the declarations in the system prompt. Only what you print or return comes back — curate it.",codeDescription:"The program: the body of an async TypeScript function."},ne={description:"Execute a Python program against the available tools. Takes two required arguments: `code`, the BODY of an async function (top-level `await` and `return` work), and `description`, a short summary of what the program does. Call tools as `await tools.name(args)` per the declarations in the system prompt. Answer with `print(...)` and/or `return <value>` — only that comes back, so curate it.",codeDescription:"The program: the body of an async Python function."},P={typescript:I,python:ne},F='Clear, concise description of what this program does in active voice, 5-10 words (shown in the UI). Examples: "Count TODO markers across packages"; "Read failing test and its fixture"; "Rename config key in every cordis.yml".';function U(a){const n=a();if(n===void 0)return I;const l=P[n.language];if(!Object.hasOwn(P,n.language)||l===void 0){const o=Object.keys(P).map(s=>JSON.stringify(s)).join(", ");throw new Error(`dsh-tools: no run_code schema flavor registered for runtime language ${JSON.stringify(n.language)} (known: ${o})`)}return l}r(U,"resolveFlavor");export class CodeRunFailedError extends G{static{r(this,"CodeRunFailedError")}constructor(n){super(n,"CODE_RUN_FAILED"),this.name="CodeRunFailedError"}}function re(a){let n;try{n=z(a)}catch(o){throw new Error(`tool arguments must be lossless JSON: ${o instanceof Error?o.message:String(o)}`)}if(n===void 0)throw new Error("tool arguments must be lossless JSON (call the tool with an arguments object, e.g. `{}`)");const l=z(n);if(l===void 0)throw new Error("tool arguments could not be detached for durable logging");return{dispatched:n,logged:l}}r(re,"jsonNormalizeArgs");const C="  ",oe=10;function se(a){const n=[],l=[{kind:"value",value:a,depth:0,compact:!1}];for(let o=l.pop();o!==void 0;o=l.pop()){if(o.kind==="text"){n.push(o.text);continue}const s=o.value;if(s===null||typeof s=="boolean"||typeof s=="number"){n.push(String(s));continue}if(typeof s=="string"){n.push(JSON.stringify(s));continue}const f=o.compact||(o.depth+1)*C.length>oe,g=o.depth+1;if(Array.isArray(s)){if(n.push("["),s.length===0){n.push("]");continue}l.push({kind:"text",text:f?"]":`
+${C.repeat(o.depth)}]`});for(let e=s.length-1;e>=0;e--){const d=s[e];if(d===void 0)throw new Error("cannot render a sparse JSON array");l.push({kind:"value",value:d,depth:g,compact:f}),l.push({kind:"text",text:f?e===0?"":",":`${e===0?`
+`:`,
+`}${C.repeat(g)}`})}continue}const p=Object.keys(s);if(n.push("{"),p.length===0){n.push("}");continue}l.push({kind:"text",text:f?"}":`
+${C.repeat(o.depth)}}`});for(let e=p.length-1;e>=0;e--){const d=p[e];if(d===void 0)throw new Error("cannot render a missing JSON object key");const c=s[d];if(c===void 0)throw new Error("cannot render an undefined JSON object property");l.push({kind:"value",value:c,depth:g,compact:f}),l.push({kind:"text",text:f?`${e===0?"":","}${JSON.stringify(d)}:`:`${e===0?`
+`:`,
+`}${C.repeat(g)}${JSON.stringify(d)}: `})}}return n.join("")}r(se,"renderJsonValue");function ie(a){return typeof a=="string"?a:se(a)}r(ie,"renderValue");export function createRunCodeTool(a,n){const{requireRuntime:l,peekRuntime:o,maxParallel:s,shapeDispatchLog:f}=n,g=Z({name:RUN_CODE_NAME,description:I.description,parameters:{code:{type:"string",required:!0,description:I.codeDescription},description:{type:"string",required:!0,description:F}},output:{schema:{type:"object",additionalProperties:!1,properties:{logs:{type:"array",required:!0,items:{type:"string"}},result:{type:"json"}}},render:r((p,e)=>{const d=e.result===void 0?"":ie(e.result),c=[e.logs.join(`
+`),d].filter(S=>S.length>0);return[{type:"text",text:c.length>0?c.join(`
+`):"(run_code completed with no output)"}]},"render")},async execute(p,e){if(p.description.trim().length===0)throw new Error("invalid description: expected a non-empty string");const d=l(),c=new AbortController,S=r(()=>{c.abort(e.signal.reason)},"onOuterAbort");e.signal.addEventListener("abort",S,{once:!0});let V=0;const b=[],k=new Set,E=new Set,N=[];let R=!1,T=!1,$=Promise.resolve(),_;const j=r(()=>{const t=_;_=void 0,t?.()},"wakeup"),A=r(()=>(T||(T=!0,$=(async()=>{try{for(;;){const t=new Promise(w=>{_=w}),h=N[0];if(h!==void 0&&h.settled){N.shift(),await h.commit(),h.mode==="exclusive"&&(R=!1);continue}const u=b[0];if(u!==void 0){if(c.signal.aborted){b.shift(),u.abandon();continue}const w=u.classify();if(!R&&(w==="exclusive"?k.size===0:k.size<s)){w==="exclusive"&&(R=!0),u.mode=w,b.shift(),N.push(u),await u.start();const v=u.flight.finally(()=>{k.delete(v),j()});k.add(v);continue}}if(b.length===0&&N.length===0&&k.size===0)return;await t}}finally{T=!1,_=void 0}})()),$),"drive"),H=r(async()=>{for(await A();E.size>0;)await Promise.allSettled([...E])},"drainDispatches"),J=r(()=>c.signal.aborted,"runOver"),M=r(t=>async h=>{if(J())throw new Error(`run_code run is over (${String(c.signal.reason)}); ${t} not dispatched`);const u=re(h),w=++V,O=X(`${String(e.callId)}:code:${w}`),v={callId:O,rootCallId:e.rootCallId,name:t,arguments:u.dispatched,...e.agent?{agent:e.agent}:{},parent:e.token,signal:c.signal},x=a[te],D=await new Promise((Y,B)=>{let m;const Q=r(i=>{Y(i.isError?{isError:!0,message:i.error.message}:{isError:!1,value:i.value});const y=e.agent;if(y===void 0)return;const q=(async()=>{const K=await f({exec:e,agent:y,subCallId:O,name:t,isError:i.isError,content:i.content});y.session.append("tool/code-dispatch",{rootCallId:e.rootCallId,parentCallId:e.callId,subCallId:O,name:t,arguments:u.logged,isError:i.isError,content:K})})().finally(()=>{E.delete(q)});E.add(q)},"settle");b.push({flight:Promise.resolve(),settled:!1,classify:r(()=>a.executionMode(v).kind,"classify"),abandon:r(()=>{B(new Error(`run_code run is over (${String(c.signal.reason)}); ${t} tool call abandoned`))},"abandon"),async start(){e.agent?.session.append("tool/code-dispatch-start",{rootCallId:e.rootCallId,parentCallId:e.callId,subCallId:O,name:t,arguments:u.logged});const i=await x.prepare(v);if(i.kind==="dispatch"){this.flight=x.dispatch(i.exec).then(y=>{m={kind:y.kind,exec:i.exec,result:y.result},this.settled=!0});return}m={kind:i.kind,exec:i.exec,result:i.result},this.settled=!0},async commit(){if(m===void 0)return;const i=m.kind==="post-result"?await x.finalize(m.exec,m.result):x.finish(m.exec,m.result);for(const y of i.additionalContexts??[])e.deferContext(y);for(i.concludesTurn&&e.concludeTurn(),Q(i);E.size>s;)await Promise.race(E)}}),j(),A()});if(J())throw new Error(`run_code run is over (${String(c.signal.reason)}); ${t} result discarded`);if(D.isError)throw new Error(D.message);return D.value},"binding"),L=Object.create(null);for(const t of a.schemas(e.agent))t.name!==RUN_CODE_NAME&&Object.defineProperty(L,t.name,{enumerable:!0,value:M(t.name)});try{let t;try{t=await d.run({program:p.code,bindings:[{global:"tools",functions:L,errorClass:{name:"ToolCallError",memberNameProperty:"toolName"}}],signal:c.signal})}finally{c.abort("run_code settled"),await H()}if(t.error){const h=t.logs.length>0?`
+Captured output:
+${t.logs.join(`
+`)}`:"";throw new CodeRunFailedError(`code run failed (${t.error.kind}): ${t.error.message}${h}`)}return{logs:t.logs,...t.value!==void 0?{result:t.value}:{}}}finally{e.signal.removeEventListener("abort",S)}},presentCall:r(p=>({card:"generic",title:p.description,kind:"execute",rawInput:p.code}),"presentCall")});return Object.defineProperty(g,"description",{enumerable:!0,get:r(()=>U(o).description,"get")}),Object.defineProperty(g,"parameters",{enumerable:!0,get:r(()=>ee({code:{type:"string",required:!0,description:U(o).codeDescription},description:{type:"string",required:!0,description:F}}),"get")}),g}r(createRunCodeTool,"createRunCodeTool");

package/node_modules/@qqbrowser/qbot-dsh-tools/lib/types/index.js

@@ -0,0 +1,2 @@
+var j=Object.defineProperty;var l=(r,e)=>j(r,"name",{value:e,configurable:!0});import{Service as L}from"@deepseek-ai/cordis";import C from"@deepseek-ai/schemastery";import{AnonymousEntries as $,NamedEntries as _,ScopedLayers as I,scopeOf as N,scopeTarget as E}from"@qqbrowser/qbot-dsh-scope";import{assertNever as F,deepFreeze as b,HarnessError as k}from"@qqbrowser/qbot-dsh-llm";import{snapshotJsonValue as w}from"@qqbrowser/qbot-dsh-session";import{assertSupportedJsonSchema as q,validateJsonSchemaValue as J}from"./json-schema.js";import{createRunCodeTool as B,RUN_CODE_NAME as u,SDK_SECTION_ORDER as U}from"./code-mode.js";import{renderToolsSdk as W}from"./ts-types.js";import{renderToolsSdkPy as K}from"./py-types.js";const V=99,H=`\`${u}\` is the only tool you can call directly — a tool call naming any other tool fails. Reach every tool the SDK declares below from inside the program.`,x={typescript:W,python:K};export{defineTool,valueSchemaSpecToJsonSchema,parameterSchemaSpecToJsonSchema,validateArgs,ToolArgsError}from"./schema.js";export{assertSupportedJsonSchema,assertObjectJsonSchema,validateJsonSchemaValue,JsonSchemaError}from"./json-schema.js";export{CodeRunFailedError,RUN_CODE_NAME}from"./code-mode.js";export{jsonSchemaToTs,renderToolsSdk}from"./ts-types.js";export{jsonSchemaToPy,renderToolsSdkPy}from"./py-types.js";export{defineContentToolFixture}from"./testing.js";export const TOOL_RUNTIME_SCHEDULER=Symbol("@qqbrowser/qbot-dsh-tools.scheduler"),TOOL_ABORTED="ABORTED",TOOL_ABORTED_BEFORE_DISPATCH="ABORTED_BEFORE_DISPATCH";export class ToolNotFoundError extends k{static{l(this,"ToolNotFoundError")}constructor(e,t){super(t===void 0?`unknown tool "${e}"`:`unknown tool "${e}": ${t}`,"UNKNOWN_TOOL"),this.name="ToolNotFoundError"}}export class ToolOutputError extends k{static{l(this,"ToolOutputError")}violations;constructor(e,t){super(`tool "${e}" returned invalid output: ${t.join("; ")}`,"INVALID_TOOL_OUTPUT"),this.name="ToolOutputError",this.violations=t}}function R(r,e,t){return new ToolOutputError(r,[`output.${e} failed: ${v(t)}`])}l(R,"projectionError");function z(r,e,t){try{const n=w(t);if(n===void 0)throw new ToolOutputError(r,[`output.${e} returned non-lossless JSON`]);return n}catch(n){throw n instanceof ToolOutputError?n:R(r,e,n)}}l(z,"snapshotProjection");function Y(r,e){try{const t=w(e);if(t===void 0)throw new ToolOutputError(r,["value is not lossless JSON"]);return t}catch(t){throw t instanceof ToolOutputError?t:new ToolOutputError(r,[`value snapshot failed: ${v(t)}`])}}l(Y,"snapshotToolValue");function v(r){try{return r instanceof Error||typeof r=="object"&&r!==null&&"message"in r&&typeof r.message=="string"?r.message:String(r)}catch{return"<unprintable thrown value>"}}l(v,"errorMessage");function G(r){const e=r.map(t=>t.type==="text"?t.text:`[${t.type} content]`).join(`
+`);return e.length>0?e:"tool result blocked by post-execute policy"}l(G,"failureMessageFromContent");function M(r){const e=w(r);if(e===void 0)throw new TypeError("tool result must be losslessly JSON-serializable");return b(e)}l(M,"materializePresentation");function Q(r){try{return r instanceof k?{name:r.name,code:r.code}:void 0}catch{return}}l(Q,"errorInfo");class X{static{l(this,"ToolLayer")}tools;restrictions=new $;guards=new $;mode;constructor(e){this.tools=new _(t=>new Error(e===void 0?`tool "${t}" is already registered (for a per-agent variant, register through that agent's \`agent.ctx\` instead)`:`tool "${t}" is already registered in this scope`))}isEmpty(){return this.tools.isEmpty()&&this.restrictions.isEmpty()&&this.guards.isEmpty()&&this.mode===void 0}admits(e){for(const t of this.restrictions.values())if(t.allow!==void 0&&!t.allow.has(e)||t.deny!==void 0&&t.deny.has(e))return!1;return!0}guardReason(e){for(const t of this.guards.values()){const n=t(e);if(n!==void 0)return n}}}function Z(r){const e=r??10;if(!Number.isInteger(e)||e<1)throw new Error("maxParallelSubCalls must be a positive integer");return e}l(Z,"resolveMaxParallelSubCalls");export class ToolRuntime extends L{static{l(this,"ToolRuntime")}static inject=["systemPrompt"];static Config=C.object({mode:C.union(["native","code","both"]).default("native"),maxParallelSubCalls:C.natural().min(1).default(10)});[TOOL_RUNTIME_SCHEDULER]={prepare:l(e=>this.prepareScheduledExecution(e),"prepare"),dispatch:l(e=>this.dispatchScheduledExecution(e),"dispatch"),finalize:l((e,t)=>this.finalizeScheduledExecution(e,t),"finalize"),finish:l((e,t)=>this.finishScheduledExecution(e,t),"finish")};deferredContexts=new WeakMap;concludingExecutions=new WeakSet;cancellationStates=new WeakMap;contentFinalizers=new WeakMap;layers=new I(e=>new X(e),()=>{this.ctx.emit("tools/change")});defaultMode;maxParallelSubCalls;codeTransport;constructor(e,t={}){super(e,"tools"),this.defaultMode=t.mode??"native",this.maxParallelSubCalls=Z(t.maxParallelSubCalls),e.systemPrompt.tools(n=>this.wireSchemas(n.scope)),this.defaultMode!=="native"&&(e.systemPrompt.section(this.collapseSection()),e.systemPrompt.section(this.sdkSection()))}collapseSection(){return{name:"tools:code-only",order:V,text:l(e=>this.modeFor(e.scope)==="code"?H:"","text")}}sdkSection(){return{name:"tools:sdk",order:U,text:l(e=>{const t=this.modeFor(e.scope);if(t==="native")return"";const n=this.requireCodeRuntime(t),o=x[n.language];if(o===void 0)throw new Error(`dsh-tools: no SDK renderer for ${n.language}`);return o(this.sdkSchemas(e.scope))},"text")}}modeFor(e){const t=this.layers.chainLayers(e);for(let n=t.length-1;n>=0;n-=1){const o=t[n]?.mode;if(o!==void 0)return o}return this.defaultMode}requireCodeTransport(){return this.codeTransport??=B(this,{requireRuntime:l(()=>this.requireCodeRuntime(this.defaultMode),"requireRuntime"),peekRuntime:l(()=>this.ctx.get("codeRuntime"),"peekRuntime"),maxParallel:this.maxParallelSubCalls,shapeDispatchLog:l(e=>this.shapeDispatchLog(e),"shapeDispatchLog")}),this.codeTransport}presentAs(e){const t=this.ctx;if(N(t)===void 0)throw new Error("tools.presentAs() requires a scoped context (agent.ctx): a context-global presentation is the `mode` config field on the tools row");return t.effect(function*(){yield this.layers.effect(t,o=>{if(o.mode!==void 0)throw new Error(`tools.presentAs("${e}") conflicts with "${o.mode}" already declared for this scope; one composition selects one presentation`);return o.mode=e,()=>{o.mode=void 0}},{label:"tools.presentAs()"}),e!=="native"&&(yield t.systemPrompt.section(this.collapseSection()),yield t.systemPrompt.section(this.sdkSection()))}.bind(this),"tools.presentAs()")}wireSchemas(e){const t=this.view(e),n=this.modeFor(e);if(n==="native")return{schemas:[...t.visible.values()].map(i=>this.schemaOf(i,!1)),knownNames:[...t.knownNames]};this.requireCodeRuntime(n);const o=[...t.visible.values()].map(s=>this.schemaOf(s,!1));return n==="code"?{schemas:o.filter(s=>s.name===u),knownNames:[u]}:{schemas:o,knownNames:[...t.knownNames,u]}}requireCodeRuntime(e){const t=this.ctx.get("codeRuntime");if(!t)throw new Error(`dsh-tools: mode "${e}" requires a code runtime — load a ctx.codeRuntime implementation (e.g. @qqbrowser/qbot-dsh-code-runtime-worker-thread) or set tools mode to "native"`);if(!Object.hasOwn(x,t.language)){const n=Object.keys(x).map(o=>JSON.stringify(o)).join(", ");throw new Error(`dsh-tools: no SDK renderer registered for runtime language ${JSON.stringify(t.language)} (known: ${n})`)}return t}register(e){const t=e.name,n=e.output;if(n===void 0||typeof n!="object"||typeof n.render!="function"||n.presentationMeta!==void 0&&typeof n.presentationMeta!="function")throw new TypeError(`tool "${t}" must declare output { schema, render, presentationMeta? }`);q(n.schema);const o=e.timeoutMs;if(o!==void 0&&(!Number.isFinite(o)||o<=0))throw new TypeError(`tool "${t}" timeoutMs must be a positive finite number`);if(t===u)throw new Error(`tool name "${u}" is reserved for the Code Mode presentation transport and cannot be registered or shadowed`);return this.layers.effect(this.ctx,s=>s.tools.insert(t,e),{label:"tools.register()"})}restrict(e){const t=N(this.ctx);if(t===void 0)throw new Error("tools.restrict() requires a scoped context (agent.ctx): a context-global restriction would mask every agent — deny the tool for the intended agent instead");const n=e.allow,o=e.deny;if(n===void 0&&o===void 0)throw new Error("tools.restrict({}) is a no-op: pass `allow` and/or `deny` (an empty filter is almost always a materialized-empty-config bug)");const s={...n!==void 0?{allow:new Set(n)}:{},...o!==void 0?{deny:new Set(o)}:{}};if([...n??[],...o??[]].includes(u))throw new Error(`tools.restrict() cannot name reserved Code Mode presentation transport "${u}"; restrict end-capability tools instead`);const i=this.view(t).restrictableNames,c=[...n??[],...o??[]].filter(a=>!i.has(a));if(c.length>0)throw new Error(`tools.restrict() names unknown global tool${c.length>1?"s":""} ${c.map(a=>`"${a}"`).join(", ")}; known global tools: ${[...i].sort().join(", ")||"(none)"}`);return this.layers.effect(this.ctx,a=>a.restrictions.append(s),{label:"tools.restrict()"})}guard(e){return this.layers.effect(this.ctx,t=>t.guards.append(e),{label:"tools.guard()",notify:!1})}guardReason(e){const t=this.layers.global.guardReason(e);if(t!==void 0)return t;if(e.agent!==void 0)for(const n of this.layers.chainLayers(e.agent)){const o=n.guardReason(e);if(o!==void 0)return o}}view(e){const t=this.layers.chainLayers(e),n=this.layers.peek(e),o=new Map(this.layers.global.tools.entries());for(const a of t)if(a!==n)for(const[d,h]of a.tools.entries())o.set(d,h);const s=new Map,i=new Set,c=new Set;for(const[a,d]of o)i.add(a),c.add(a),t.every(h=>h.admits(a))&&s.set(a,d);if(n!==void 0)for(const[a,d]of n.tools.entries())i.add(a),s.set(a,d);return this.modeFor(e)!=="native"&&s.set(u,this.requireCodeTransport()),{visible:s,knownNames:i,restrictableNames:c}}get(e,t){return this.view(t).visible.get(e)}resolveExecution(e,t,n){const o=this.get(e,t);if(o!==void 0&&!this.collapses(e,t,n))return o}schemas(e){return[...this.view(e).visible.values()].map(t=>this.schemaOf(t,!0))}sdkSchemas(e){return[...this.view(e).visible.values()].filter(t=>t.name!==u).map(t=>{const n=w(t.output.schema);if(n===void 0)throw new Error(`tool "${t.name}" output schema must be lossless JSON before SDK projection`);return{...this.schemaOf(t,!0),output:n}})}schemaOf(e,t){const{name:n,description:o,parameters:s}=e,i=t?w(s):s;if(i===void 0)throw new Error(`tool "${n}" parameters must be lossless JSON before schema projection`);return{name:n,description:o,parameters:i}}executionMode(e){const t=this.resolveExecution(e.name,e.agent,e.parent!==void 0);if(!t?.isConcurrencySafe)return{kind:"exclusive"};try{return t.isConcurrencySafe(e.arguments)===!0?{kind:"parallel"}:{kind:"exclusive"}}catch{return{kind:"exclusive"}}}async shapeDispatchLog(e){try{return await this.ctx.waterfall(E(this,e.agent),"tools/code-dispatch-log",e,()=>Promise.resolve(e.content))}catch(t){return this.ctx.logger.warn(`tools: code-dispatch-log listener failed for ${e.name}: ${v(t)}; logging the original settled content`),e.content}}collapses(e,t,n){return!n&&this.modeFor(t)==="code"&&e!==u}async execute(e){return this.prepareExecution(e,t=>this.completeScheduledExecution(t))}async completeScheduledExecution(e){switch(e.kind){case"dispatch":{const t=await this.dispatchScheduledExecution(e.exec);return t.kind==="post-result"?await this.finalizeScheduledExecution(e.exec,t.result):this.finishScheduledExecution(e.exec,t.result)}case"post-result":return await this.finalizeScheduledExecution(e.exec,e.result);case"final-result":return this.finishScheduledExecution(e.exec,e.result);default:return F(e,"scheduled tool preparation")}}createExecution(e){const t=[],n=ee(),o=e.callId,s=e.rootCallId??o,i=e.name,c=e.agent,a=e.parent,d=e.signal,h=this.get(i,c),p=h!==void 0&&this.collapses(i,c,a!==void 0),S=this.concludingExecutions,T={token:n,callId:o,rootCallId:s,name:i,signal:d,...c!==void 0?{agent:c}:{},...a!==void 0?{parent:a}:{},deferContext(g){t.push(g)},concludeTurn(){S.add(this)}},D=h?.finalizeContent?.bind(h),O=l(()=>p&&!d.aborted?void 0:D,"finalizerFor");try{const g=w(e.arguments);if(g===void 0)throw new TypeError("tool execution arguments must be losslessly JSON-serializable");const f={...T,arguments:b(g)};return this.deferredContexts.set(f,t),this.contentFinalizers.set(f,O()),this.cancellationStates.set(f,{callerSignal:d,bodyInvoked:!1}),p?d.aborted?{kind:"final-result",exec:f,result:y()}:{kind:"final-result",exec:f,result:m(new ToolNotFoundError(i,`only \`${u}\` is callable directly — call \`${i}\` from inside a \`${u}\` program instead`))}:{kind:"ready",exec:f}}catch(g){const f={...T,arguments:void 0};return this.contentFinalizers.set(f,O()),{kind:"final-result",exec:f,result:m(g)}}}async prepareScheduledExecution(e){return this.prepareExecution(e,t=>t)}async prepareExecution(e,t){const n=this.createExecution(e);if(n.kind!=="ready")return t(n);const o=n.exec;if(this.callerCancelled(o))return t({kind:"final-result",exec:o,result:y()});try{const s=E(this,o.agent),i=await this.ctx.waterfall(s,"tools/pre-execute",o,()=>Promise.resolve({kind:"allow"})),c=i.kind==="ask"?await this.serviceAsk(o,i):{decision:i,approvalCancelled:!1},{decision:a}=c;if(this.callerCancelled(o)&&c.approvalCancelled)return await t({kind:"post-result",exec:o,result:y()});const d=a.kind==="allow"?this.guardReason(o):a.reason;return d!==void 0?await t({kind:"post-result",exec:o,result:this.materializeFinalResult({content:[{type:"text",text:`Error: ${d}`}],isError:!0,error:{message:d}})}):this.callerCancelled(o)?await t({kind:"post-result",exec:o,result:y()}):await t({kind:"dispatch",exec:o})}catch(s){return t({kind:"final-result",exec:o,result:m(s)})}}callerCancelled(e){const t=this.cancellationStates.get(e);if(t===void 0)throw new Error("tool registry scheduler invariant violated: missing cancellation state");return t.callerSignal.aborted}cancellationResult(e,t){const n=this.cancellationStates.get(e);if(n===void 0)throw new Error("tool registry scheduler invariant violated: missing cancellation state");return n.bodyInvoked?A(t):y(t)}async dispatchToolBody(e){const t=this.cancellationStates.get(e);if(t===void 0)throw new Error("tool registry scheduler invariant violated: missing cancellation state");const n=e.signal,o=te(t.callerSignal,n),s=o.signal;if(P(s))return o.dispose(),y();e.signal=s;try{const i=this.resolveExecution(e.name,e.agent,e.parent!==void 0);if(!i)throw new ToolNotFoundError(e.name);t.bodyInvoked=!0;const c=await i.execute(e.arguments,e),a=this.createSuccessResult(e,i,c);return P(s)?A(a):a}catch(i){return m(i)}finally{o.dispose(),e.signal=n}}async dispatchScheduledExecution(e){try{const t=e,n=E(this,e.agent),o=await this.ctx.waterfall(n,"tools/execute",t,()=>this.dispatchToolBody(t)),s=this.normalizeDispatchResult(e,o),i=this.deferredContexts.get(e);if(i===void 0)throw new Error("tool registry scheduler invariant violated: unprepared execution");const c=i.length===0?s:this.markCanonical(e,{...s,additionalContexts:[...i,...s.additionalContexts??[]]});return{kind:"post-result",result:this.callerCancelled(e)&&!c.isError?this.cancellationResult(e,c):c}}catch(t){return{kind:"final-result",result:m(t)}}}async finalizeScheduledExecution(e,t){try{const n=await this.postExecute(e,t);return this.finishScheduledExecution(e,this.callerCancelled(e)&&!n.isError?this.cancellationResult(e,n):n)}catch(n){return this.finishScheduledExecution(e,m(n))}}finishScheduledExecution(e,t){let n;try{n=this.materializeFinalResult(t)}catch(s){n=this.materializeFinalResult(m(s))}let o;try{o=this.materializeFinalResult(this.applyFinalContent(e,n))}catch(s){o=this.materializeFinalResult(m(s))}return this.notifyResult(e,o),o}applyFinalContent(e,t){const n=this.contentFinalizers.get(e);if(n===void 0)return t;const o=n(e,t);return o===void 0?t:{...t,content:o}}notifyResult(e,t){Object.freeze(e);const{name:n,callId:o}=e,s=l(c=>{this.ctx.logger.warn(`tool "${n}" (${o}): tools/result observer failed: ${v(c)}`)},"reportFailure"),i=this.ctx.events.dispatch("emit",[E(this,e.agent),"tools/result",e,t]);for(const c of i)try{const a=c(e,t);Promise.resolve(a).catch(s)}catch(a){s(a)}}async serviceAsk(e,t){const n=this.ctx.get("approval");if(n===void 0)return{decision:{kind:"deny",reason:t.reason??`tool "${e.name}" requires approval (not yet supported)`},approvalCancelled:!1};if(e.agent===void 0)return{decision:{kind:"deny",reason:`tool "${e.name}" requires approval, but the call has no agent to route it through`},approvalCancelled:!1};const o=await n.request({agent:e.agent,toolName:e.name,callId:e.callId,...t.reason!==void 0?{reason:t.reason}:{},signal:e.signal});switch(o){case"allowed-once":return{decision:{kind:"allow"},approvalCancelled:!1};case"rejected":return{decision:{kind:"deny",reason:`the user rejected tool "${e.name}"`},approvalCancelled:!1};case"cancelled":return{decision:{kind:"deny",reason:`approval for tool "${e.name}" was cancelled`},approvalCancelled:!0};case"unavailable":return{decision:{kind:"deny",reason:`tool "${e.name}" requires approval, but no approval channel is available`},approvalCancelled:!1};default:return F(o,"ApprovalOutcome")}}async postExecute(e,t){const n=await this.ctx.waterfall(E(this,e.agent),"tools/post-execute",e,t,()=>Promise.resolve({kind:"accept"})),o=n.additionalContexts??[];if(n.kind==="block"){const i=G(n.feedback);return this.markCanonical(e,{content:n.feedback,isError:!0,error:{message:i},...o.length>0?{additionalContexts:o}:{}})}if(Object.hasOwn(n,"content")&&Object.hasOwn(n,"value"))throw new TypeError("tools/post-execute accept decision cannot replace both value and content");const s=[...t.additionalContexts??[],...o];if(Object.hasOwn(n,"value")){if(t.isError)throw new TypeError("tools/post-execute cannot replace the value of a failed result");const i=this.resolveExecution(e.name,e.agent,e.parent!==void 0);if(i===void 0)throw new ToolNotFoundError(e.name);const c=this.createSuccessResult(e,i,n.value);return this.markCanonical(e,{...c,...s.length>0?{additionalContexts:s}:{}})}return this.markCanonical(e,{...t,...n.content!==void 0?{content:n.content}:{},...s.length>0?{additionalContexts:s}:{}})}canonicalResults=new WeakMap;markCanonical(e,t){return this.canonicalResults.set(t,e.token),t}createSuccessResult(e,t,n){const o=Y(t.name,n),s=J(t.output.schema,o,"value");if(s.length>0)throw new ToolOutputError(t.name,s);const i=b(o);let c;try{c=t.output.render(e.arguments,i)}catch(p){throw R(t.name,"render",p)}const a=z(t.name,"render",c);let d;if(e.parent===void 0&&t.output.presentationMeta!==void 0){let p;try{p=t.output.presentationMeta(e.arguments,i)}catch(S){throw R(t.name,"presentationMeta",S)}d=z(t.name,"presentationMeta",p)}const h=this.concludingExecutions.has(e);return this.markCanonical(e,this.materializeFinalResult({isError:!1,value:i,content:a,...d!==void 0?{meta:d}:{},...h?{concludesTurn:!0}:{}}))}normalizeDispatchResult(e,t){if(this.canonicalResults.get(t)===e.token)return t;if(t.isError)return this.markCanonical(e,{isError:!0,error:t.error,content:t.content,...t.meta!==void 0?{meta:t.meta}:{},...t.additionalContexts!==void 0?{additionalContexts:t.additionalContexts}:{}});const n=this.resolveExecution(e.name,e.agent,e.parent!==void 0);if(n===void 0)throw new ToolNotFoundError(e.name);const o=this.createSuccessResult(e,n,t.value);return this.markCanonical(e,{...o,...t.additionalContexts!==void 0?{additionalContexts:t.additionalContexts}:{}})}materializeFinalResult(e){const t={content:e.content,...e.meta!==void 0?{meta:e.meta}:{},...e.additionalContexts!==void 0?{additionalContexts:e.additionalContexts}:{}};if(e.isError)return M({isError:!0,error:e.error,...t});const n=M({isError:!1,...t,...e.concludesTurn===!0?{concludesTurn:!0}:{}});return b({...n,value:e.value})}}function ee(){return Symbol("dsh.tool.execution")}l(ee,"createExecutionToken");function m(r){const e=Q(r),t=v(r);return{content:[{type:"text",text:`Error: ${t}`}],isError:!0,error:{message:t,...e?{info:e}:{}}}}l(m,"toolErrorResult");function P(r){return r.aborted}l(P,"isAborted");function te(r,e){if(r===e)return{signal:r,dispose(){}};const t=new AbortController;let n=!1;const o=l(()=>{n&&(n=!1,r.removeEventListener("abort",i),e.removeEventListener("abort",c))},"dispose"),s=l(a=>{const d=a.reason;t.abort(d),o()},"abortFrom"),i=l(()=>{s(r)},"abortFromCaller"),c=l(()=>{s(e)},"abortFromWrapper");return e.aborted?c():r.aborted?i():(n=!0,r.addEventListener("abort",i,{once:!0}),e.addEventListener("abort",c,{once:!0})),{signal:t.signal,dispose:o}}l(te,"fuseToolSignals");function A(r){const e=r?.additionalContexts??[];return{content:[{type:"text",text:"Error: tool call aborted"}],isError:!0,error:{message:"tool call aborted",info:{name:"AbortError",code:TOOL_ABORTED}},...e.length>0?{additionalContexts:e}:{}}}l(A,"toolAbortedResult");function y(r){const e=r?.additionalContexts??[];return{content:[{type:"text",text:"Error: tool call aborted before dispatch"}],isError:!0,error:{message:"tool call aborted before dispatch",info:{name:"AbortError",code:TOOL_ABORTED_BEFORE_DISPATCH}},...e.length>0?{additionalContexts:e}:{}}}l(y,"toolAbortedBeforeDispatchResult");export default ToolRuntime;

package/node_modules/@qqbrowser/qbot-dsh-tools/lib/types/invariant.js

@@ -0,0 +1 @@
+var b=Object.defineProperty;var p=(r,n)=>b(r,"name",{value:n,configurable:!0});const x="@qqbrowser/qbot-dsh-tools";export const name="tools-invariant",inject=["invariants"];function I(r,n,l){Object.isFrozen(r)||l("tools/result execution must be frozen before publication"),(!Object.isFrozen(n)||!Object.isFrozen(n.content))&&l("tools/result outcome and content must be frozen before publication"),(r.name.length===0||String(r.callId).length===0)&&l("tools/result execution must carry non-empty name and callId")}p(I,"validateResult");const C=Object.assign((r,n)=>{const l=new WeakMap,d=new WeakMap,i=new WeakMap,f=p((e,t)=>{if(t.type!=="tool/code-dispatch-start"&&t.type!=="tool/code-dispatch")return;const o=String(t.data.rootCallId),a=String(t.data.parentCallId),u=String(t.data.subCallId);if(o.length===0||a.length===0||u.length===0){n(`${t.type} must carry non-empty rootCallId, parentCallId, and subCallId`);return}const s=i.get(e),c=s?.get(u);c!==void 0&&c!==o&&n(`${t.type} changed rootCallId for subCallId ${u}`),a!==o&&s?.get(a)!==o&&n(`${t.type} parentCallId ${a} does not belong to rootCallId ${o}`)},"validateDispatch"),g=p((e,t)=>{if(t.type!=="tool/code-dispatch-start"&&t.type!=="tool/code-dispatch")return;i.get(e).set(String(t.data.subCallId),String(t.data.rootCallId))},"commitDispatch"),y=p(e=>{let t=null;i.set(e,new Map);for(const o of e.events)f(e,o),g(e,o),o.type==="turn/start"?t=o.data.turn:o.type==="turn/end"?t=null:(o.type==="tool/code-dispatch-start"||o.type==="tool/code-dispatch")&&t===null&&n(`${o.type} appended outside any open turn`);return d.set(e,t),t},"seed"),h=p(e=>d.get(e)??y(e),"openTurnFor");for(const e of r.sessions.list())y(e);r.on("session/created",e=>{y(e)},{global:!0}),r.on("session/event",(e,t)=>{f(e,t),g(e,t),t.type==="turn/start"?d.set(e,t.data.turn):t.type==="turn/end"&&d.set(e,null)},{global:!0}),r.on("internal/dispatch",(e,t,o)=>{if(t==="session/event"){const[s,c]=o;f(s,c),(c.type==="tool/code-dispatch-start"||c.type==="tool/code-dispatch")&&h(s)===null&&n(`${c.type} appended outside any open turn`);return}if(t==="tools/pre-execute"){const s=o[0];l.has(s)&&n("tools/pre-execute repeated for one execution"),l.set(s,"pre");return}if(t==="tools/execute"){const s=o[0];l.get(s)!=="pre"&&n("tools/execute must follow tools/pre-execute"),l.set(s,"execute");return}if(t==="tools/post-execute"){const s=o[0],c=l.get(s);c!=="pre"&&c!=="execute"&&n("tools/post-execute must follow tools/pre-execute or tools/execute"),l.set(s,"post");return}if(t!=="tools/result")return;const[a,u]=o;I(a,u,n),l.delete(a)},{global:!0})},{inject:["sessions"]});export const apply=p(r=>Promise.resolve(r.invariants.register(x,C)),"apply");

package/node_modules/@qqbrowser/qbot-dsh-tools/lib/types/json-schema.js

@@ -0,0 +1 @@
+var _=Object.defineProperty;var i=(t,n)=>_(t,"name",{value:n,configurable:!0});import{assertNever as g,HarnessError as C}from"@qqbrowser/qbot-dsh-llm";import{isJsonValue as N}from"@qqbrowser/qbot-dsh-session";export class JsonSchemaError extends C{static{i(this,"JsonSchemaError")}violations;constructor(n){super(`unsupported JSON schema: ${n.join("; ")}`,"UNSUPPORTED_SCHEMA"),this.name="JsonSchemaError",this.violations=n}}const K=new Set(["type","oneOf","properties","required","additionalProperties","items","enum","const"]),D=new Set(["description","title","default","examples"]),w=["object","array","string","number","integer","boolean","null"];function x(t,n){const a=Object.getOwnPropertyDescriptor(t,"constructor")?.value;if(typeof a!="function")return!1;try{return a.name===n&&a.prototype===t&&Function.prototype.toString.call(a)===`function ${n}() { [native code] }`}catch{return!1}}i(x,"hasIntrinsicConstructor");function A(t){return Object.getPrototypeOf(t)===null&&x(t,"Object")}i(A,"isIntrinsicObjectPrototype");export function isPlainJsonRecord(t){if(typeof t!="object"||t===null||Array.isArray(t))return!1;try{const n=Object.getPrototypeOf(t);return n===null||typeof n=="object"&&A(n)}catch{return!1}}i(isPlainJsonRecord,"isPlainJsonRecord");function F(t){const n=Object.getPrototypeOf(t);if(!Array.isArray(n)||!x(n,"Array"))return!1;const o=Object.getPrototypeOf(n);return typeof o=="object"&&o!==null&&A(o)}i(F,"hasPlainArrayPrototype");function M(t){try{return Reflect.ownKeys(t).every(n=>typeof n=="string"&&Object.prototype.propertyIsEnumerable.call(t,n))}catch{return!1}}i(M,"hasOnlyEnumerableStringKeys");export function isJsonSchemaRecord(t){return isPlainJsonRecord(t)&&M(t)}i(isJsonSchemaRecord,"isJsonSchemaRecord");export function isPlainJsonArray(t){if(!Array.isArray(t))return!1;try{if(!F(t)||Reflect.ownKeys(t).length!==t.length+1)return!1;for(let n=0;n<t.length;n++)if(!Object.hasOwn(t,n))return!1;return!0}catch{return!1}}i(isPlainJsonArray,"isPlainJsonArray");function $(t){return typeof t=="number"&&Number.isFinite(t)&&!Object.is(t,-0)}i($,"isJsonNumber");function v(t,n){switch(t){case"string":return typeof n=="string";case"number":return $(n);case"integer":return $(n)&&Number.isInteger(n);case"boolean":return typeof n=="boolean";case"null":return n===null;default:return g(t,"JsonSchemaType")}}i(v,"scalarMatches");const I=["properties","required","additionalProperties","items","enum","const"];function Y(t,n,o,a){const d=Object.hasOwn(t,"required"),c=d?t.required:void 0;if(d)if(!isPlainJsonArray(c)||c.some(s=>typeof s!="string"))a.push(`${n}.required must be an array of strings`);else{const s=isJsonSchemaRecord(o)?o:{};for(const e of c)Object.hasOwn(s,e)||a.push(`${n}.required names "${e}" which is not in properties`)}Object.hasOwn(t,"additionalProperties")&&typeof t.additionalProperties!="boolean"&&a.push(`${n}.additionalProperties must be a boolean`)}i(Y,"checkObjectSchemaTail");function q(t,n,o,a){const d=[{kind:"enter",node:t,path:n}];for(let c=d.pop();c!==void 0;c=d.pop()){if(c.kind==="leave"){a.delete(c.node);continue}if(c.kind==="one-of-tail"){for(const r of I)Object.hasOwn(c.node,r)&&o.push(`${c.path}.${r} is not supported beside oneOf`);continue}if(c.kind==="object-tail"){Y(c.node,c.path,c.properties,o);continue}const{node:s,path:e}=c;if(!isJsonSchemaRecord(s)){o.push(`${e} must be a schema object`);continue}if(a.has(s)){o.push(`${e} is circular`);continue}a.add(s),d.push({kind:"leave",node:s});for(const r of Object.keys(s))if(!K.has(r)){if(D.has(r)){try{N(s[r])||o.push(`${e}.${r} annotation must be lossless JSON data`)}catch{o.push(`${e}.${r} annotation must be lossless JSON data`)}continue}o.push(`${e}.${r} is not a supported keyword (subset: type/oneOf/properties/required/additionalProperties/items/enum/const + annotations)`)}Object.hasOwn(s,"description")&&typeof s.description!="string"&&o.push(`${e}.description must be a string`),Object.hasOwn(s,"title")&&typeof s.title!="string"&&o.push(`${e}.title must be a string`);const l=Object.hasOwn(s,"type"),O=Object.hasOwn(s,"oneOf");if(l&&O){o.push(`${e} cannot declare both type and oneOf`);continue}if(!l&&!O){for(const r of I)Object.hasOwn(s,r)&&o.push(`${e}.${r} requires type or oneOf`);continue}if(O){const r=s.oneOf;if(d.push({kind:"one-of-tail",node:s,path:e}),!isPlainJsonArray(r)||r.length<2)o.push(`${e}.oneOf must be an array of at least two schemas`);else for(let f=r.length-1;f>=0;f--)d.push({kind:"enter",node:r[f],path:`${e}.oneOf[${f}]`});continue}const p=s.type;if(typeof p!="string"||!w.includes(p)){o.push(Array.isArray(p)?`${e}.type must be a single type string (type arrays are not supported)`:`${e}.type must be one of ${w.join("/")}`);continue}const b=p,y={properties:["object"],required:["object"],additionalProperties:["object"],items:["array"],enum:["string","number","integer","boolean","null"],const:["string","number","integer","boolean","null"]};for(const[r,f]of Object.entries(y))Object.hasOwn(s,r)&&!f.includes(b)&&o.push(`${e}.${r} is not supported on type "${b}"`);switch(b){case"object":{const r=Object.hasOwn(s,"properties")?s.properties:void 0;if(d.push({kind:"object-tail",node:s,path:e,properties:r}),Object.hasOwn(s,"properties"))if(!isJsonSchemaRecord(r))o.push(`${e}.properties must be an object of schemas`);else{const f=Object.entries(r);for(let u=f.length-1;u>=0;u--){const m=f[u];m!==void 0&&d.push({kind:"enter",node:m[1],path:`${e}.properties.${m[0]}`})}}break}case"array":{Object.hasOwn(s,"items")&&d.push({kind:"enter",node:s.items,path:`${e}.items`});break}case"string":case"number":case"integer":case"boolean":case"null":{const r=Object.hasOwn(s,"enum"),f=r?s.enum:void 0,u=isPlainJsonArray(f)&&f.length>0&&f.every(R=>v(b,R));r&&!u&&o.push(`${e}.enum must be a non-empty array of ${b} values`);const m=Object.hasOwn(s,"const"),J=m?s.const:void 0,T=v(b,J);m&&(T?u&&!f.includes(J)&&o.push(`${e}.const must be one of ${e}.enum when both are declared`):o.push(`${e}.const must be a ${b} value`));break}default:g(b,"JsonSchemaType")}}}i(q,"checkSchemaNode");export function assertSupportedJsonSchema(t){const n=[];if(q(t,"schema",n,new Set),n.length>0)throw new JsonSchemaError(n)}i(assertSupportedJsonSchema,"assertSupportedJsonSchema");export function assertObjectJsonSchema(t){const n=[];if(q(t,"schema",n,new Set),n.length===0&&(!isJsonSchemaRecord(t)||!Object.hasOwn(t,"type")||t.type!=="object")&&n.push('schema.type must be "object" (structured output is object-rooted)'),n.length>0)throw new JsonSchemaError(n)}i(assertObjectJsonSchema,"assertObjectJsonSchema");function k(t){try{return N(t)}catch{return!1}}i(k,"safelyIsJsonValue");function h(t){return t===""?"arguments":t}i(h,"diagnosticPath");function S(t,n){return t===""?n:`${t}.${n}`}i(S,"propertyPath");function P(t){return[`"${h(t)}" must be a lossless JSON value`]}i(P,"losslessValueViolation");function E(t,n){for(const o of n)t.push(o)}i(E,"appendViolations");function V(t,n,o){return{node:t,value:n,path:o,catches:!1,phase:"start",children:[],childIndex:0,violations:[],tailViolations:[],matches:0}}i(V,"valueFrame");function j(t,n,o){const a=Object.hasOwn(t,"enum")?t.enum:void 0;return a!==void 0&&!a.includes(n)?[`"${h(o)}" must be one of ${JSON.stringify(a)}`]:Object.hasOwn(t,"const")&&n!==t.const?[`"${h(o)}" must be ${JSON.stringify(t.const)}`]:[]}i(j,"checkScalarValue");function H(t,n,o){const a=[V(t,n,o)];let d;const c=i(e=>{const l=a.at(-1);if(l===void 0){d=e;return}l.kind==="oneOf"?e.length===0&&l.matches++:E(l.violations,e)},"receive"),s=i(e=>{a.pop(),c(e)},"finish");for(;a.length>0;){const e=a.at(-1);if(e===void 0)break;try{if(e.phase==="children"){if(e.childIndex<e.children.length){const p=e.children[e.childIndex];if(p===void 0)throw new Error("missing schema-value child frame");e.childIndex++,a.push(V(p.node,p.value,p.path));continue}if(e.kind==="oneOf"){s(e.matches===1?[]:[`"${h(e.path)}" must match exactly one oneOf branch (matched ${e.matches})`]);continue}E(e.violations,e.tailViolations),e.violations.length>0?s(e.violations):e.kind==="object"?s(k(e.value)?[]:[`"${h(e.path)}" must be a lossless JSON object`]):s(k(e.value)?[]:[`"${h(e.path)}" must be a dense lossless JSON array`]);continue}const l=Object.hasOwn(e.node,"type")?e.node.type:void 0;e.catches=!(l!==void 0&&!w.includes(l));const O=Object.hasOwn(e.node,"oneOf")?e.node.oneOf:void 0;if(O!==void 0){e.kind="oneOf",e.children=Array.from(O,p=>({node:p,value:e.value,path:e.path})),e.childIndex=0,e.matches=0,e.phase="children";continue}if(l===void 0){s(k(e.value)?[]:P(e.path));continue}switch(l){case"object":{if(!isPlainJsonRecord(e.value)){s([`"${h(e.path)}" must be an object`]);break}const p=Object.hasOwn(e.node,"properties")?e.node.properties??{}:{},b=[],y=Object.hasOwn(e.node,"required")?e.node.required??[]:[];for(const u of y)(!Object.hasOwn(e.value,u)||e.value[u]===void 0)&&b.push(`missing required property "${S(e.path,u)}"`);const r=[];for(const[u,m]of Object.entries(p))!Object.hasOwn(e.value,u)||e.value[u]===void 0||r.push({node:m,value:e.value[u],path:S(e.path,u)});const f=[];if(Object.hasOwn(e.node,"additionalProperties")&&e.node.additionalProperties===!1)for(const u of Object.keys(e.value))Object.hasOwn(p,u)||f.push(`"${S(e.path,u)}" is not a declared property (additionalProperties: false)`);e.kind="object",e.children=r,e.childIndex=0,e.violations=b,e.tailViolations=f,e.phase="children";break}case"array":{if(!Array.isArray(e.value)){s([`"${h(e.path)}" must be an array`]);break}const p=Object.hasOwn(e.node,"items")?e.node.items:void 0,b=p===void 0?[]:e.value.flatMap((y,r)=>[{node:p,value:y,path:`${e.path}[${r}]`}]);e.kind="array",e.children=b,e.childIndex=0,e.violations=[],e.phase="children";break}case"string":s(typeof e.value=="string"?j(e.node,e.value,e.path):[`"${h(e.path)}" must be a string`]);break;case"number":s(typeof e.value!="number"?[`"${h(e.path)}" must be a number`]:$(e.value)?j(e.node,e.value,e.path):[`"${h(e.path)}" must be a finite JSON number`]);break;case"integer":s(!$(e.value)||!Number.isInteger(e.value)?[`"${h(e.path)}" must be an integer`]:j(e.node,e.value,e.path));break;case"boolean":s(typeof e.value=="boolean"?j(e.node,e.value,e.path):[`"${h(e.path)}" must be a boolean`]);break;case"null":s(e.value===null?j(e.node,e.value,e.path):[`"${h(e.path)}" must be null`]);break;default:s(g(l,"JsonSchemaType"))}}catch(l){let O=a.pop();for(;O!==void 0&&!O.catches;)O=a.pop();if(O===void 0)throw l;c(P(O.path))}}return d??P(o)}i(H,"checkValue");export function validateJsonSchemaValue(t,n,o="value"){return H(t,n,o)}i(validateJsonSchemaValue,"validateJsonSchemaValue");

package/node_modules/@qqbrowser/qbot-dsh-tools/lib/types/schema.js

@@ -0,0 +1 @@
+var q=Object.defineProperty;var u=(e,r)=>q(e,"name",{value:r,configurable:!0});import{HarnessError as S}from"@qqbrowser/qbot-dsh-llm";import{assertSupportedJsonSchema as w,isJsonSchemaRecord as O,isPlainJsonArray as j,JsonSchemaError as g,validateJsonSchemaValue as v}from"./json-schema.js";const x=["description","title","default","examples"];function c(e){throw new g([e])}u(c,"authorError");function y(e,r){Object.hasOwn(e,"description")&&(r.description=e.description),Object.hasOwn(e,"title")&&(r.title=e.title),Object.hasOwn(e,"default")&&(r.default=e.default),Object.hasOwn(e,"examples")&&(r.examples=e.examples)}u(y,"copyAnnotations");function b(e,r,i){for(const t of Object.keys(e))i.includes(t)||c(`${r}.${t} is not supported by the value schema DSL`)}u(b,"assertAuthorKeys");function P(e,r){switch(e.kind){case"root":e.holder.value=r;break;case"property":Object.defineProperty(e.target,e.key,{value:r,enumerable:!0,configurable:!0,writable:!0});break;case"item":e.target.items=r;break;case"one-of":e.target[e.index]=r;break}}u(P,"assignCompiledNode");function C(e,r){e.kind==="root"?e.holder.value=r:e.target.properties=r.properties}u(C,"assignCompiledPropertyMap");function $(e){const r=new Set,i=[e];for(let t=i.pop();t!==void 0;t=i.pop()){if(t.kind==="leave"){r.delete(t.input);continue}if(t.kind==="property-map-tail"){t.required.length>0&&(t.compiled.required=t.required,t.destination.kind==="object"&&(t.destination.target.required=t.required));continue}if(t.kind==="property"){O(t.property)||c(`${t.path} must be a value schema object`),Object.hasOwn(t.property,"required")&&t.property.required!==!0&&c(`${t.path}.required must be true when present`),Object.hasOwn(t.property,"required")&&t.property.required===!0&&t.required.push(t.key),i.push({kind:"value",input:t.property,path:t.path,allowRequired:!0,destination:{kind:"property",target:t.properties,key:t.key}});continue}if(t.kind==="property-map"){O(t.input)||c(`${t.path} must be an object of value schemas`),r.has(t.input)&&c(`${t.path} is circular`),r.add(t.input);const l={properties:{}},d=[];C(t.destination,l),i.push({kind:"leave",input:t.input}),i.push({kind:"property-map-tail",compiled:l,required:d,destination:t.destination});const m=Object.entries(t.input);for(let a=m.length-1;a>=0;a--){const p=m[a];p!==void 0&&i.push({kind:"property",property:p[1],path:`${t.path}.${p[0]}`,key:p[0],properties:l.properties,required:d})}continue}const{input:n,path:o}=t;O(n)||c(`${o} must be a value schema object`),r.has(n)&&c(`${o} is circular`),r.add(n);const f=[...x,...t.allowRequired?["required"]:[]],s={};if(P(t.destination,s),i.push({kind:"leave",input:n}),Object.hasOwn(n,"oneOf")){b(n,o,[...f,"oneOf","type"]),Object.hasOwn(n,"type")&&c(`${o} cannot declare both type and oneOf`),j(n.oneOf)||c(`${o}.oneOf must be an array of at least two value schemas`);const l=[];s.oneOf=l,y(n,s);for(let d=n.oneOf.length-1;d>=0;d--)i.push({kind:"value",input:n.oneOf[d],path:`${o}.oneOf[${d}]`,allowRequired:!1,destination:{kind:"one-of",target:l,index:d}});continue}const h=Object.hasOwn(n,"type")?n.type:void 0;switch(h){case"json":b(n,o,[...f,"type"]),y(n,s);break;case"object":b(n,o,[...f,"type","properties","additionalProperties"]),(!Object.hasOwn(n,"additionalProperties")||typeof n.additionalProperties!="boolean")&&c(`${o}.additionalProperties must be explicitly true or false`),s.type="object",y(n,s),s.additionalProperties=n.additionalProperties,Object.hasOwn(n,"properties")&&i.push({kind:"property-map",input:n.properties,path:`${o}.properties`,destination:{kind:"object",target:s}});break;case"array":b(n,o,[...f,"type","items"]),s.type="array",y(n,s),Object.hasOwn(n,"items")&&i.push({kind:"value",input:n.items,path:`${o}.items`,allowRequired:!1,destination:{kind:"item",target:s}});break;case"string":case"number":case"integer":case"boolean":case"null":b(n,o,[...f,"type","enum","const"]),s.type=h,y(n,s),Object.hasOwn(n,"enum")&&(j(n.enum)||c(`${o}.enum must be a non-empty array of scalar values`),s.enum=Array.from(n.enum,l=>l)),Object.hasOwn(n,"const")&&(s.const=n.const);break;default:c(`${o}.type must be string/number/integer/boolean/null/array/object/json, or use oneOf`)}}}u($,"runSchemaCompiler");function M(e,r){const i={};return $({kind:"property-map",input:e,path:r,destination:{kind:"root",holder:i}}),i.value??c(`${r} did not compile`)}u(M,"compilePropertyMap");function A(e,r){const i={};return $({kind:"value",input:e,path:r,allowRequired:!1,destination:{kind:"root",holder:i}}),i.value??c(`${r} did not compile`)}u(A,"compileValueSchema");export function valueSchemaSpecToJsonSchema(e){const r=A(e,"schema");return w(r),r}u(valueSchemaSpecToJsonSchema,"valueSchemaSpecToJsonSchema");export function parameterSchemaSpecToJsonSchema(e){const r=M(e,"parameters"),i={type:"object",properties:r.properties,...r.required===void 0?{}:{required:r.required}};return w(i),i}u(parameterSchemaSpecToJsonSchema,"parameterSchemaSpecToJsonSchema");export class ToolArgsError extends S{static{u(this,"ToolArgsError")}violations;constructor(r){super(`invalid arguments: ${r.join("; ")}`,"INVALID_ARGS"),this.name="ToolArgsError",this.violations=r}}export function validateArgs(e,r){return v(parameterSchemaSpecToJsonSchema(e),r,"")}u(validateArgs,"validateArgs");export function defineTool(e){const r=e.execute,i=e.finalizeContent,t=e.output.render,n=e.output.presentationMeta,o=e.presentCall,f=e.presentResult,s=e.isConcurrencySafe;if(e.timeoutMs!==void 0&&(!Number.isFinite(e.timeoutMs)||e.timeoutMs<=0))throw new Error(`defineTool(${e.name}): timeoutMs must be a positive finite number`);const h=parameterSchemaSpecToJsonSchema(e.parameters),l=valueSchemaSpecToJsonSchema(e.output.schema),d=u(a=>v(h,a,""),"validate"),m={name:e.name,description:e.description,parameters:h,output:{schema:l,render(a,p){return t(a,p)},...n!==void 0?{presentationMeta(a,p){return n(a,p)}}:{}},...e.timeoutMs!==void 0?{timeoutMs:e.timeoutMs}:{},async execute(a,p){const k=d(a);if(k.length>0)throw new ToolArgsError(k);return r(a,p)}};return i&&(m.finalizeContent=(a,p)=>i(a,p)),o&&(m.presentCall=a=>{if(!(d(a).length>0))return o(a)}),f&&(m.presentResult=(a,p)=>{if(!(d(a).length>0))return f(a,p)}),s&&(m.isConcurrencySafe=a=>d(a).length>0?!1:s(a)),m}u(defineTool,"defineTool");

package/node_modules/@qqbrowser/qbot-dsh-tools/package.json

@@ -0,0 +1 @@
+{"name":"@qqbrowser/qbot-dsh-tools","version":"0.0.6","publishConfig":{"access":"public"},"type":"module","main":"lib/index.js","exports":{".":{"types":"./lib/types/index.d.ts","default":"./lib/index.js"},"./invariant":{"types":"./lib/types/invariant.d.ts","default":"./lib/invariant.js"},"./types":{"types":"./lib/types/types.d.ts","default":"./lib/types/types.js"},"./presentation":{"types":"./lib/types/presentation.d.ts","default":"./lib/types/presentation.js"},"./src/*":"./src/*","./package.json":"./package.json"},"license":"MIT","peerDependencies":{"@qqbrowser/qbot-dsh-agent":"^0.0.6","@qqbrowser/qbot-dsh-code-runtime":"^0.0.6","@qqbrowser/qbot-dsh-llm":"^0.0.6","@qqbrowser/qbot-dsh-scope":"^0.0.6","@qqbrowser/qbot-dsh-invariants":"^0.0.6","@qqbrowser/qbot-dsh-user-approval":"^0.0.6","@qqbrowser/qbot-dsh-session":"^0.0.6","@deepseek-ai/cordis":"^4.0.1","@qqbrowser/qbot-dsh-system-prompt":"^0.0.6"},"dependencies":{"@deepseek-ai/schemastery":"^3.18.1"}}

package/node_modules/@qqbrowser/qbot-dsh-typert-loader/lib/invariant.js

@@ -0,0 +1 @@
+var e=Object.defineProperty;var n=(t,r)=>e(t,"name",{value:r,configurable:!0});const s="@qqbrowser/qbot-dsh-typert-loader",o="typert-loader-invariant",a=["invariants"],i=n(()=>{},"install"),c=n(t=>Promise.resolve(t.invariants.register(s,i)),"apply");export{c as apply,a as inject,o as name};