@qqbrowser/qbot-dsh 0.0.6 → 0.0.8

package/node_modules/@deepseek-ai/dsh-tool-cordis/lib/invariant.js

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

package/node_modules/@deepseek-ai/dsh-tool-cordis/package.json

@@ -0,0 +1 @@
+{"name":"@deepseek-ai/dsh-tool-cordis","version":"0.0.8","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":{"@deepseek-ai/dsh-agent":"^0.0.8","@deepseek-ai/dsh-cordis-host-runner":"^0.0.8","@deepseek-ai/dsh-scope":"^0.0.8","@deepseek-ai/dsh-llm":"^0.0.8","@deepseek-ai/dsh-session":"^0.0.8","@deepseek-ai/dsh-invariants":"^0.0.8","@deepseek-ai/dsh-system-prompt":"^0.0.8","@deepseek-ai/dsh-tools":"^0.0.8","@deepseek-ai/cordis":"^4.0.1"}}

package/node_modules/@deepseek-ai/dsh-tool-fs/lib/index.js

@@ -0,0 +1,20 @@
+var I=Object.defineProperty;var s=(e,t)=>I(e,"name",{value:t,configurable:!0});import c from"@deepseek-ai/schemastery";import{defineTool as h}from"@deepseek-ai/dsh-tools";import{FsError as p}from"@deepseek-ai/dsh-fs";import{ESCALATION_TARGETS as S,approveEscalation as j,canonicalPath as A,escalationHintMarker as B,sandboxDenialMarker as R,validateEscalationArgs as F}from"@deepseek-ai/dsh-sandbox";import{structuredPatch as N}from"diff";import{basename as q,extname as w}from"node:path";import{AttachmentError as O,AttachmentId as k}from"@deepseek-ai/dsh-attachment";import{createUserMessage as C}from"@deepseek-ai/dsh-llm";const D=2e3,U=50*1024;function G(){return{lines:[],totalLines:0,outputBytes:0,truncatedByBytes:!1}}s(G,"newAccumulator");function W(e,t){return e.length>t?`${e.substring(0,t)}... (line truncated to ${t} chars)`:e}s(W,"truncateLine");function z(e,t){return Buffer.byteLength(e,"utf8")+(t>0?1:0)}s(z,"lineByteSize");function H(e,t,i){if(e.totalLines+=1,e.truncatedByBytes||e.totalLines<i.offset||e.lines.length>=i.limit)return;const n=W(t,i.maxLineLength),r=z(n,e.lines.length);if(e.outputBytes+r>i.maxBytes){e.truncatedByBytes=!0;return}e.outputBytes+=r,e.lines.push({number:e.totalLines,text:n})}s(H,"consumeLine");function X(e){return e.endsWith("\r")?e.slice(0,-1):e}s(X,"stripCarriageReturn");function J(e,t,i){if(!e.truncatedByBytes&&t.offset>e.totalLines&&!(e.totalLines===0&&t.offset===1))throw new p(`offset ${t.offset} is out of range for "${i}" (${e.totalLines} lines)`,"FS_NOT_FOUND");return{lines:e.lines,totalLines:e.totalLines,truncatedByBytes:e.truncatedByBytes}}s(J,"finish");async function V(e,t,i){const n=G(),r=t.maxLineLength+1;let o="";function a(f){o.length>=r||(o+=f,o.length>r&&(o=o.slice(0,r)))}s(a,"appendToLineBuffer");function l(){H(n,X(o),t),o=""}s(l,"flushLine");for await(const f of e){let d=0,u;for(;(u=f.indexOf(`
+`,d))!==-1;)a(f.slice(d,u)),l(),d=u+1;a(f.slice(d))}return o.length>0&&l(),J(n,t,i)}s(V,"buildWindow");function Y(e,t){const i=t.lines.at(-1)?.number??Math.max(0,t.offset-1);let n;return t.truncatedByBytes?n=`(Output capped. Showing lines ${t.offset}-${i}. Use offset=${i+1} to continue.)`:i<t.totalLines?n=`(Showing lines ${t.offset}-${i} of ${t.totalLines}. Use offset=${i+1} to continue.)`:n=`(End of file - total ${t.totalLines} lines)`,`<path>${e}</path>
+<type>file</type>
+<content>
+${t.lines.length>0?`${t.lines.map(r=>`${r.number}: ${r.text}`).join(`
+`)}
+
+${n}`:n}
+</content>`}s(Y,"formatReadOutput");const b={ts:"ts",tsx:"tsx",mts:"ts",cts:"ts",js:"js",jsx:"jsx",mjs:"js",cjs:"js",json:"json",jsonc:"json",py:"py",rb:"rb",go:"go",rs:"rs",java:"java",c:"c",h:"c",cc:"cpp",cpp:"cpp",hpp:"cpp",cxx:"cpp",cs:"cs",kt:"kotlin",swift:"swift",php:"php",sh:"sh",bash:"sh",zsh:"sh",yaml:"yaml",yml:"yaml",toml:"toml",ini:"ini",md:"md",markdown:"md",mdx:"mdx",html:"html",htm:"html",css:"css",scss:"scss",less:"less",sql:"sql",xml:"xml",lua:"lua"};function Z(e){const t=e.slice(Math.max(e.lastIndexOf("/"),e.lastIndexOf("\\"))+1),i=t.lastIndexOf(".");if(i<=0)return;const n=t.slice(i+1).toLowerCase();return Object.hasOwn(b,n)?b[n]:void 0}s(Z,"langFromPath");function K(e){if(typeof e!="object"||e===null||Array.isArray(e))return!1;const{number:t,text:i}=e;return typeof t=="number"&&Number.isInteger(t)&&t>=1&&typeof i=="string"}s(K,"isFileTextLine");function Q(e){if(typeof e!="object"||e===null||Array.isArray(e))return;const{path:t,offset:i,lines:n,totalLines:r,lang:o}=e;if(typeof t!="string"||typeof r!="number"||typeof i!="number"||!Number.isInteger(i)||i<1||!Number.isInteger(r)||r<0||!Array.isArray(n)||!n.every(K)||o!==void 0&&typeof o!="string")return;let a=i-1;for(const{number:l}of n){if(l<=a||l>r)return;a=l}return{path:t,offset:i,lines:n,totalLines:r,...o===void 0?{}:{lang:o}}}s(Q,"readMetaFromMeta");const _=/(?:^|[\\/])\.\.(?:[\\/]|$)/;function ee(e,t){const i=e.agent?.session.header.cwd;return i===void 0||!_.test(i)&&!_.test(t)?i:A(i)}s(ee,"sessionCwd");function g(e,t,i){const n=i??ee(e,t);return{...n!==void 0?{cwd:n}:{},signal:e.signal}}s(g,"sessionResolveOptions");async function v(e,t,i){const n=await e.fs.resolve(i,g(t,i)),r=await e.fs.stat(n,t.signal);if(r===void 0)throw e.emit("fs/observed",n,{kind:"absent"},t),new p(`cannot read "${n.displayPath}": not found`,"FS_NOT_FOUND");if(r.type!=="file")throw new p(`cannot read "${n.displayPath}": not a regular file`,"FS_NOT_REGULAR_FILE");return{target:n,info:r}}s(v,"resolveRegularReadTarget");const te=2e3,ie=10*1024*1024;function E(e,t){if(!Number.isFinite(e)||!Number.isInteger(e)||e<1)throw new Error(`${t} must be a positive integer`);return e}s(E,"parsePositiveInteger");function L(e,t){if(e.file_path.trim().length===0)throw new Error("file_path must be a non-empty string");const i=e.offset===void 0?1:E(e.offset,"offset"),n=e.limit===void 0?t:E(e.limit,"limit");if(n>t)throw new Error(`limit must be less than or equal to ${t}`);return{filePath:e.file_path,offset:i,limit:n}}s(L,"parseReadArgs");function ne(e,t){e.systemPrompt.section({name:"tool:read",order:100,text:"Use the read tool — not shell commands like cat — to inspect text files. Results include line numbers. Use offset and limit to continue reading large files."}),e.tools.register(h({name:"read",description:"Read a UTF-8 text file and return line-numbered content.",parameters:{file_path:{type:"string",required:!0,description:"Path to read, resolved by the filesystem backend."},offset:{type:"number",description:"1-based first line to return. Defaults to 1."},limit:{type:"number",description:`Maximum number of lines to return. Defaults to ${t.limit}.`}},output:{schema:{type:"object",additionalProperties:!1,properties:{path:{type:"string",required:!0},offset:{type:"integer",required:!0},lines:{type:"array",required:!0,items:{type:"object",additionalProperties:!1,properties:{number:{type:"integer",required:!0},text:{type:"string",required:!0}}}},totalLines:{type:"integer",required:!0}}},render:s((i,n)=>{const r=L(i,t.limit),o=n.lines.at(-1)?.number??Math.max(0,n.offset-1),a=n.lines.length<r.limit&&o<n.totalLines;return[{type:"text",text:Y(n.path,{offset:n.offset,lines:n.lines,totalLines:n.totalLines,...a?{truncatedByBytes:!0}:{}})}]},"render"),presentationMeta:s((i,n)=>{const r=Z(n.path);return{path:n.path,offset:n.offset,lines:n.lines.map(({number:o,text:a})=>({number:o,text:a})),totalLines:n.totalLines,...r===void 0?{}:{lang:r}}},"presentationMeta")},isConcurrencySafe:s(()=>!0,"isConcurrencySafe"),async execute(i,n){const r=L(i,t.limit),{target:o,info:a}=await v(e,n,r.filePath),l=await V(a.size===void 0||a.size>=t.streamMinSize?await e.fs.streamText(o,n.signal):[await e.fs.readText(o,n.signal)],{offset:r.offset,limit:r.limit,maxLineLength:t.maxLineLength,maxBytes:t.maxBytes},o.displayPath),f={path:o.displayPath,offset:r.offset,lines:l.lines,totalLines:l.totalLines};return e.emit("fs/observed",o,{kind:"present",version:a.version},n),f},presentResult(i,n){if(n.isError)return;const r=Q(n.meta);if(r===void 0)return;const o=n.content.length===1?n.content[0]:void 0,a=o?.type==="text"?o.text:void 0;if(a===void 0)return;const l=/^<path>[^\n]*<\/path>\n<type>file<\/type>\n<content>\n([\s\S]*)\n<\/content>$/u.exec(a)?.[1];if(l!==void 0)return{card:"read",path:r.path,offset:r.offset,lines:r.lines,totalLines:r.totalLines,...r.lang===void 0?{}:{lang:r.lang},content:[{type:"text",text:l}]}},presentCall(i){const{offset:n,limit:r}=i,o=r!==void 0&&r>0?` (${n??1} - ${(n??1)+r-1})`:n!==void 0?` (from line ${n})`:"";return{card:"generic",title:`Read ${i.file_path}${o}`,kind:"read",locations:[{path:i.file_path,line:n??1}]}}}))}s(ne,"applyReadTool");function x(e,t,i){const n=N("","",t,i,void 0,void 0,{context:3}),r=[];for(const o of n.hunks){const a=[],l=[];for(const f of o.lines){if(f.startsWith("\\"))continue;const d=f.slice(1);f.startsWith("-")?a.push(d):(f.startsWith("+")||a.push(d),l.push(d))}r.push({path:e,oldText:a.length>0?a.join(`
+`):null,newText:l.join(`
+`)})}return r}s(x,"computeHunkDiffs");function re(e){if(typeof e!="object"||e===null||Array.isArray(e))return!1;const{path:t,oldText:i,newText:n}=e;return typeof t=="string"&&(i===null||typeof i=="string")&&typeof n=="string"}s(re,"isFileDiff");function $(e){if(typeof e!="object"||e===null||Array.isArray(e))return;const t=e.diffs;if(!(!Array.isArray(t)||t.length===0||!t.every(re)))return t}s($,"diffsFromMeta");const oe={FS_STALE_VERSION:"re-read the file, then retry",FS_NOT_OBSERVED:"read the file, then retry"};function T(e){if(!(e instanceof p))return e;const t=oe[e.code];return t?new p(`${e.message} — ${t}`,e.code,{cause:e}):e}s(T,"remediateFsError");function se(e){if(e.file_path.trim().length===0)throw new Error("file_path must be a non-empty string");return{filePath:e.file_path,content:e.content}}s(se,"parseWriteArgs");function ae(e,t){return`<path>${e}</path>
+<type>file</type>
+<content>
+${t.operation==="create"?"Created":"Updated"} file
+</content>`}s(ae,"formatWriteOutput");function le(e,t){e.systemPrompt.section({name:"tool:write",order:101,text:"Use the write tool to create files or completely replace file contents. Existing files are overwritten, so read an existing file first (the default fs-observation-policy requires it) and prefer edit for targeted changes."}),e.tools.register(h({name:"write",description:"Create or fully replace a UTF-8 text file.",parameters:{file_path:{type:"string",required:!0,description:"Path to write, resolved by the filesystem backend."},content:{type:"string",required:!0,description:"Full UTF-8 text content to write."},...t.escalationModes.length>0?t.schemaFields():{}},output:{schema:{type:"object",additionalProperties:!1,properties:{path:{type:"string",required:!0},operation:{type:"string",required:!0,enum:["create","update"]},before:{required:!0,oneOf:[{type:"string"},{type:"null"}]},after:{type:"string",required:!0}}},render:s((i,n)=>[{type:"text",text:ae(n.path,n)}],"render"),presentationMeta:s((i,n)=>({diffs:n.before===null?[]:x(i.file_path,n.before,n.after).map(({path:r,oldText:o,newText:a})=>({path:r,oldText:o,newText:a}))}),"presentationMeta")},async execute(i,n){const r=se(i),o=await t.resolvePolicy("write",i,n),a=await e.fs.resolve(r.filePath,g(n,r.filePath,o?.workspaceRoot)),l=await e.waterfall("fs/write-intent",a,n,()=>{});let f;try{f=await e.fs.writeText(a,r.content,l,n.signal,o)}catch(d){throw T(t.mapError(d,o))}return e.emit("fs/observed",a,{kind:"present",version:f.version},n),{path:a.displayPath,operation:f.operation,before:f.before,after:f.after}},presentCall(i){return{card:"diff",title:`Write ${i.file_path}`,diffs:[{path:i.file_path,oldText:null,newText:i.content}],locations:[{path:i.file_path}]}},presentResult(i,n){if(n.isError)return;const r=$(n.meta)??[{path:i.file_path,oldText:null,newText:i.content}];return{card:"diff",title:`Write ${i.file_path}`,diffs:r}}}))}s(le,"applyWriteTool");function fe(e){if(e.file_path.trim().length===0)throw new Error("file_path must be a non-empty string");if(e.old_string.length===0)throw new Error("old_string must be a non-empty string");if(e.old_string===e.new_string)throw new Error("old_string and new_string must differ");return{filePath:e.file_path,oldString:e.old_string,newString:e.new_string,replaceAll:e.replace_all??!1}}s(fe,"parseEditArgs");function de(e,t){return t?`The file ${e} has been updated. All occurrences were successfully replaced.`:`The file ${e} has been updated successfully.`}s(de,"formatEditOutput");function pe(e,t){e.systemPrompt.section({name:"tool:edit",order:102,text:"Use the edit tool for targeted changes to existing UTF-8 text files. It replaces literal old_string with new_string; by default old_string must appear exactly once. If old_string appears multiple times, provide a more specific old_string or set replace_all to true. Read the file first (the default fs-observation-policy requires it), unless you just created or edited it in this session."}),e.tools.register(h({name:"edit",description:"Edit an existing UTF-8 text file by replacing literal text.",parameters:{file_path:{type:"string",required:!0,description:"Path to edit, resolved by the filesystem backend."},old_string:{type:"string",required:!0,description:"Literal text to replace. Must match exactly."},new_string:{type:"string",required:!0,description:"Literal replacement text. Use an empty string to delete the match."},replace_all:{type:"boolean",description:"Replace all matches. Defaults to false; when false, old_string must appear exactly once."},...t.escalationModes.length>0?t.schemaFields():{}},output:{schema:{type:"object",additionalProperties:!1,properties:{path:{type:"string",required:!0},before:{type:"string",required:!0},after:{type:"string",required:!0}}},render:s((i,n)=>[{type:"text",text:de(n.path,i.replace_all??!1)}],"render"),presentationMeta:s((i,n)=>({diffs:x(i.file_path,n.before,n.after).map(({path:r,oldText:o,newText:a})=>({path:r,oldText:o,newText:a}))}),"presentationMeta")},async execute(i,n){const r=fe(i),o=await t.resolvePolicy("edit",i,n),a=await e.fs.resolve(r.filePath,g(n,r.filePath,o?.workspaceRoot));let l;try{const f=await e.waterfall("fs/edit-intent",a,n,()=>{});l=await e.fs.editText(a,{oldString:r.oldString,newString:r.newString,replaceAll:r.replaceAll},f,n.signal,o)}catch(f){throw T(t.mapError(f,o))}return e.emit("fs/observed",a,{kind:"present",version:l.version},n),{path:a.displayPath,before:l.before,after:l.after}},presentCall(i){return{card:"diff",title:`Edit ${i.file_path}`,diffs:[{path:i.file_path,oldText:i.old_string||null,newText:i.new_string}],locations:[{path:i.file_path}]}},presentResult(i,n){if(n.isError)return;const r=$(n.meta);if(r!==void 0)return{card:"diff",title:`Edit ${i.file_path}`,diffs:r}}}))}s(pe,"applyEditTool");const ue={".png":"image/png",".jpg":"image/jpeg",".jpeg":"image/jpeg",".webp":"image/webp",".gif":"image/gif"};function ce(e){return ue[w(e).toLowerCase()]}s(ce,"imageMediaTypeForPath");async function me(e,t,i){const n=t.agent?.session.requestHeader()?.config,r=n?.provider??t.agent?.options.provider,o=n?.model??t.agent?.options.model,a=e.get("llm");if(r===void 0||o===void 0||a===void 0)throw new Error(`cannot read "${i}" as an image: the current model route could not be resolved`);const l=await a.resolveModelInfo(r,o,t.signal);if(l.inputModalities===void 0||!l.inputModalities.includes("image"))throw new Error(`cannot read "${i}" as an image: model "${o}" does not declare image input; switch to an image-capable model to read images`)}s(me,"assertImageCapableRoute");function he(e){return{attachmentId:k(e.attachmentId),mediaType:e.mediaType,bytes:e.bytes,width:e.width,height:e.height,...e.name===void 0?{}:{name:e.name}}}s(he,"imageRefFromValue");function ye(e,t){return`<path>${e}</path>
+<type>image</type>
+<content>
+${t.mediaType} image, ${t.width}x${t.height} px, ${t.bytes} bytes
+</content>`}s(ye,"formatImageReadOutput");function P(e){return[{type:"text",text:ye(e.path,e.image)},{type:"image",attachment:he(e.image)}]}s(P,"imageReadContent");function ge(e){e.tools.register(h({name:"read_image",description:"Read a PNG/JPEG/WebP/GIF file and return the image itself. Requires the current model to accept image input.",parameters:{file_path:{type:"string",required:!0,description:"Path to the image file, resolved by the filesystem backend."}},output:{schema:{type:"object",additionalProperties:!1,properties:{path:{type:"string",required:!0},image:{type:"object",additionalProperties:!1,required:!0,properties:{attachmentId:{type:"string",required:!0},mediaType:{type:"string",enum:["image/png","image/jpeg","image/webp","image/gif"],required:!0},bytes:{type:"integer",required:!0},width:{type:"integer",required:!0},height:{type:"integer",required:!0},name:{type:"string"}}}}},render:s((t,i)=>P(i),"render")},isConcurrencySafe:s(()=>!0,"isConcurrencySafe"),async execute(t,i){if(t.file_path.trim().length===0)throw new Error("file_path must be a non-empty string");const n=ce(t.file_path);if(n===void 0)throw new Error(`cannot read "${t.file_path}": read_image only accepts PNG/JPEG/WebP/GIF paths`);const r=e.get("attachments");if(r===void 0)throw new Error(`cannot read "${t.file_path}" as an image: no attachment service is mounted`);if(!r.imageLimits.mediaTypes.includes(n))throw new Error(`cannot read "${t.file_path}": ${n} images are not accepted by this deployment`);await me(e,i,t.file_path);const{target:o,info:a}=await v(e,i,t.file_path),l=Math.min(r.imageLimits.maxImageBytes,r.imageLimits.maxMessageImageBytes),f=await e.fs.readBytes(o,i.signal,l);let d;try{d=await r.saveImage({data:f,mediaType:n,name:q(o.displayPath)})}catch(m){if(!(m instanceof O)||m.code!=="IMAGE_TYPE_MISMATCH")throw m;const M=w(o.displayPath).toLowerCase();throw new Error(`cannot read "${o.displayPath}": the ${M} extension declares ${n}, but the bytes use a different image format; rename the file to match its actual format if it is PNG/JPEG/WebP/GIF, or convert it to one of those formats`,{cause:m})}e.emit("fs/observed",o,{kind:"present",version:a.version},i);const u={path:o.displayPath,image:{attachmentId:d.attachmentId,mediaType:d.mediaType,bytes:d.bytes,width:d.width,height:d.height,...d.name===void 0?{}:{name:d.name}}};return i.parent!==void 0&&i.deferContext(C({content:P(u),source:{kind:"plugin",plugin:"tool-fs"}})),u},presentCall(t){return{card:"generic",title:`Read image ${t.file_path}`,kind:"read",locations:[{path:t.file_path}]}}}))}s(ge,"applyReadImageTool");var we=class{static{s(this,"FsSandboxController")}ctx;escalationModes;policy;constructor(e){this.ctx=e;const t=e.fs.sandboxMode;if(this.escalationModes=t===void 0?[]:S,this.policy=t===void 0?void 0:e.get("sandboxPolicy"),t!==void 0&&this.policy===void 0)throw new Error("tool-fs: the mounted filesystem confines but ctx.sandboxPolicy is missing")}schemaFields(){return{sandbox_permissions:{type:"string",enum:[...this.escalationModes],description:"The wider sandbox mode this file operation needs. Only valid as a one-shot retry of an operation the sandbox just denied; requires justification and user approval."},justification:{type:"string",description:"Required with sandbox_permissions: one sentence for the user explaining why this exact file operation needs the wider access."}}}async resolvePolicy(e,t,i){F(t.sandbox_permissions,t.justification);const n=this.policy?.resolve({...i.agent?{session:i.agent.session}:{}});if(t.sandbox_permissions===void 0||t.justification===void 0)return n;if(this.escalationModes.length===0)throw new Error("sandbox_permissions is not available in this composition (no sandboxing filesystem to escalate)");const r=n,o=await j({requestedMode:t.sandbox_permissions,justification:t.justification,effectiveMode:r.mode,subject:"operation"},{approver:this.ctx.get("approval"),agent:i.agent,callId:i.callId,toolName:e,signal:i.signal});return{...r,mode:o}}mapError(e,t){if(!(e instanceof p)||e.code!=="FS_SANDBOX_DENIED")return e;const i=t.mode;return new p(`${R(i)}
+${B("operation")}`,"FS_SANDBOX_DENIED",{cause:e})}};const be="tool-fs",_e=["tools","fs","systemPrompt"],ve=c.object({readLimit:c.number().default(te),readMaxLineLength:c.number().default(D),readMaxBytes:c.number().default(U),readStreamMinSize:c.number().default(ie)});function y(e,t){if(!Number.isInteger(t)||t<1)throw new Error(`tool-fs: ${e} must be a positive integer`)}s(y,"assertPositiveInteger");function Ee(e,t){const i=t;y("readLimit",i.readLimit),y("readMaxLineLength",i.readMaxLineLength),y("readMaxBytes",i.readMaxBytes),y("readStreamMinSize",i.readStreamMinSize),ne(e,{limit:i.readLimit,maxLineLength:i.readMaxLineLength,maxBytes:i.readMaxBytes,streamMinSize:i.readStreamMinSize}),e.inject(["attachments"],r=>{ge(r)});const n=new we(e);le(e,n),pe(e,n)}s(Ee,"apply");export{ve as Config,Ee as apply,_e as inject,be as name};

package/node_modules/@deepseek-ai/dsh-tool-fs/lib/invariant.js

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

package/node_modules/@deepseek-ai/dsh-tool-fs/package.json

@@ -0,0 +1 @@
+{"name":"@deepseek-ai/dsh-tool-fs","version":"0.0.8","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","dependencies":{"diff":"^9.0.0","@deepseek-ai/schemastery":"^3.18.1"},"peerDependencies":{"@deepseek-ai/dsh-attachment":"^0.0.8","@deepseek-ai/dsh-invariants":"^0.0.8","@deepseek-ai/dsh-llm":"^0.0.8","@deepseek-ai/dsh-session":"^0.0.8","@deepseek-ai/dsh-fs":"^0.0.8","@deepseek-ai/dsh-system-prompt":"^0.0.8","@deepseek-ai/dsh-tools":"^0.0.8","@deepseek-ai/dsh-sandbox-policy":"^0.0.8","@deepseek-ai/dsh-sandbox":"^0.0.8","@deepseek-ai/dsh-user-approval":"^0.0.8","@deepseek-ai/cordis":"^4.0.1"}}

package/node_modules/@deepseek-ai/dsh-tool-fs-search/lib/index.js

@@ -0,0 +1,20 @@
+var ie=Object.defineProperty;var s=(e,t)=>ie(e,"name",{value:t,configurable:!0});import f from"@deepseek-ai/schemastery";import{MAX_TIMER_DELAY_MS as S}from"@deepseek-ai/dsh-timeout";import{isAbsolute as le,relative as ce,sep as b}from"node:path";import{defineTool as B}from"@deepseek-ai/dsh-tools";import{HarnessError as ue}from"@deepseek-ai/dsh-llm";import{ItemRetainer as de,TextRetainer as he}from"@deepseek-ai/dsh-output-retention";const O=2e7,T=3e4,G=64*1024,L=3e3,k=65536;var p=class extends ue{static{s(this,"SearchError")}code;constructor(e,t,r){super(e,t,r),this.code=t}};function pe(e,t){const r=e.trim();return r.length===0?"":t?`${r} [stderr truncated]`:r}s(pe,"stderrExcerpt");function fe(e,t,r,n){const o=pe(r,n);return/regex parse error|error parsing glob/i.test(o)?new p(`${e} pattern rejected by ripgrep: ${o}`,"SEARCH_INVALID_PATTERN"):new p(`${e} search failed (exit ${t})${o.length>0?`: ${o}`:""}`,"SEARCH_FAILED")}s(fe,"classifyRunFailure");function me(e,t,r){const n="narrow pattern, path, or include and retry";if(!t.lossy){const o=Buffer.byteLength(t.text,"utf8");if(o>r)throw new p(`${e} produced ${o} bytes of raw output, over the ${r}-byte cap; ${n}`,"SEARCH_RAW_OUTPUT_OVERFLOW");return t.text}throw new p(`${e} produced more raw output than the subprocess seam retained within the ${r}-byte cap; ${n}`,"SEARCH_RAW_OUTPUT_OVERFLOW")}s(me,"completeStdout");let j;function F(){return j??=import("@vscode/ripgrep").then(e=>e.rgPath),j}s(F,"resolveRgPath");async function M(e,t,r,n,o,a,l){if(t.signal.aborted)throw new p(`${r} was aborted before completion (tool timeout or caller cancellation)`,"SEARCH_ABORTED");const c=t.agent?.session.header.cwd??process.cwd();let i;try{i=e.subprocess.spawn({argv:[await F(),"--no-config",...n],cwd:c,stdio:{stdin:"ignore",stdout:{maxBytes:o},stderr:{maxBytes:l}},graceMs:a,signal:t.signal})}catch(m){throw t.signal.aborted?new p(`${r} was aborted before completion (tool timeout or caller cancellation)`,"SEARCH_ABORTED"):new p(`${r} could not start its search command (ripgrep launch failed)`,"SEARCH_FAILED",{cause:m})}let u;try{u=await i.done}catch(m){throw new p(`${r} could not start its search command (ripgrep launch failed)`,"SEARCH_FAILED",{cause:m})}const d=i.collected.stdout?.readFrom(0),h=i.collected.stderr?.readFrom(0);if(d===void 0||h===void 0)throw new p(`${r} search command produced no collected output streams`,"SEARCH_FAILED");if(t.signal.aborted)throw new p(`${r} was aborted before completion (tool timeout or caller cancellation)`,"SEARCH_ABORTED");if(u.signal!==null||u.exitCode===null)throw new p(`${r} search command was killed by signal ${u.signal??"(unknown)"}`,"SEARCH_FAILED");if(u.exitCode!==0&&u.exitCode!==1)throw fe(r,u.exitCode,h.text,h.lossy);return{stdout:me(r,d,o),noMatches:u.exitCode===1,workdir:c}}s(M,"runRipgrep");function w(e,t){if(!le(e))return e;const r=ce(t,e);return r.length===0?".":r===".."||r.startsWith(`..${b}`)?e:r}s(w,"toWorkdirRelative");function v(e,t){const r=new he({kind:"head",maxBytes:t});r.push(e);const n=r.finish();return n.truncated?`${n.text} (line truncated)`:n.text}s(v,"previewLine");function x(e,t,r){const n=new de({kind:"head",maxItems:t});for(const o of e)n.push({...o,line:v(o.line,r)});return n.finish()}s(x,"retainGrepMatches");async function $(e,t,r,n){const o=t.agent?.session.header.id;if(o===void 0){e.logger.warn(`tool-fs-search: no session owner for ${t.name} result; complete result not saved`);return}const a=e.get("spillStore");if(!a){e.logger.warn(`tool-fs-search: no ctx.spillStore backend loaded; complete ${t.name} result not saved`);return}const l={owner:{sessionId:o},source:{toolName:t.name,callId:t.callId,label:"result"},suggestedName:r,content:n};try{return await a.saveText(l)}catch(c){e.logger.warn(`tool-fs-search: saveText failed for ${t.name}: ${String(c)}; complete result not saved`);return}}s($,"trySaveFormattedResult");function ge(e){const t=new Map;for(const r of e){const n={lineNumber:r.lineNumber,line:r.line},o=t.get(r.path);o!==void 0?o.push(n):t.set(r.path,[n])}return Array.from(t,([r,n])=>({path:r,matches:n}))}s(ge,"groupMatchesByFile");function R(e){return Buffer.byteLength(JSON.stringify(e),"utf8")}s(R,"metaBytes");function P(e,t){if(R(e)<=t)return e;if(e.shape==="matches"){const n=[...e.files];for(;n.length>1&&R({...e,files:n,truncated:!0})>t;)n.pop();return{...e,files:n,truncated:!0}}const r=[...e.paths];for(;r.length>1&&R({...e,paths:r,truncated:!0})>t;)r.pop();return{...e,paths:r,truncated:!0}}s(P,"capMetaBytes");function ye(e,t){return P({shape:"matches",files:ge(e.items),truncated:e.truncated,total:e.seen},t)}s(ye,"grepSearchMeta");function be(e,t){return P({shape:"paths",paths:e.items,truncated:e.truncated,total:e.seen},t)}s(be,"globSearchMeta");function we(e){if(typeof e!="object"||e===null||Array.isArray(e))return!1;const{lineNumber:t,line:r}=e;return typeof t=="number"&&typeof r=="string"}s(we,"isSearchLineMatch");function Me(e){if(typeof e!="object"||e===null||Array.isArray(e))return!1;const{path:t,matches:r}=e;return typeof t=="string"&&Array.isArray(r)&&r.every(we)}s(Me,"isSearchFileMatches");function I(e){if(typeof e!="object"||e===null||Array.isArray(e))return;const t=e,{truncated:r,total:n}=t;if(!(typeof r!="boolean"||typeof n!="number")){if(t.shape==="matches"){const{files:o}=t;return!Array.isArray(o)||!o.every(Me)?void 0:{card:"search",shape:"matches",files:o,truncated:r,total:n}}if(t.shape==="paths"){const{paths:o}=t;return!Array.isArray(o)||!o.every(a=>typeof a=="string")?void 0:{card:"search",shape:"paths",paths:o,truncated:r,total:n}}}}s(I,"searchViewFromMeta");function H(e,t,r,n,o){if(!(o.kind!=="accept"||o.content!==void 0||Object.hasOwn(o,"value")||r.parent!==void 0||r.name!==t.name||n.isError||e.tools.get(r.name,r.agent)!==t))return n.value}s(H,"acceptedDirectCallValue");const ve=100,D=[".git",".svn",".hg",".bzr",".jj",".sl"];function U(e){if(e.pattern.trim().length===0)throw new Error("pattern must be a non-empty string");if(e.path!==void 0&&e.path.trim().length===0)throw new Error("path must be a non-empty string when given");return{pattern:e.pattern,...e.path!==void 0?{path:e.path}:{}}}s(U,"parseGlobArgs");function N(e){const t=["--files",`--glob=${e.pattern}`,"--sort=modified","--no-ignore","--hidden",...D.flatMap(r=>[`--glob=!**/${r}`,`--glob=!**/${r}/**`])];return e.path!==void 0&&t.push("--",e.path),t}s(N,"buildGlobCommand");function xe(e,t){if(t===".")return e.startsWith(`.${b}`)?e.slice(2):e;let r=t.length;for(;r>0&&t[r-1]===b;)r-=1;const n=t.slice(0,r);return n.length===0?W(e):e===n?"":e.startsWith(`${n}${b}`)?e.slice(n.length+1):e}s(xe,"relativeToSearchRoot");function W(e){let t=0;for(;e[t]===b;)t+=1;return e.slice(t)}s(W,"stripLeadingSeparators");function $e(e){const t=W(e),r=t.indexOf(b);return r===-1?t:t.slice(0,r)}s($e,"topLevelSegment");function A(e,t,r="."){const n=new Map;let o=[];for(const c of e){const i=$e(xe(c,r)),u=n.get(i);if(u===void 0){const d=[c];n.set(i,d),o.push({key:i,items:d,index:0,current:c})}else u.push(c)}const a=new Map;let l=0;for(;o.length>0&&l<t;){const c=[];for(const{key:i,items:u,index:d,current:h}of o){if(l>=t)break;l+=1;const m=a.get(i);m===void 0?a.set(i,[h]):m.push(h);const _=d+1,C=u[_];C!==void 0&&c.push({key:i,items:u,index:_,current:C})}o=c}return{items:[...a.values()].flat(),shown:a.size,total:n.size}}s(A,"sampleAcrossTopLevel");function q(e,t,r){const n=e.total===t?".":`, sampled across ${e.shown} of the ${e.total} top-level entries this pattern matched instead of taken in modification-time order.`+(e.shown<e.total?" Narrow path to inspect a specific subtree.":"");return X(e.items,t,r,n)}s(q,"formatGlobOutput");function X(e,t,r,n){const o=e.join(`
+`),a=r!==void 0?`Full sorted result stored at: ${r.locator}. ${r.retrievalHint}`:"The complete result could not be saved; narrow pattern or path to see more.";return`${o}
+
+(Showing ${e.length} of ${t} paths${n} ${a})`}s(X,"formatGlobPage");function V(e,t,r,n){return e.length===0?"No files found":e.length<=t.maxResults?e.join(`
+`):t.sampleOverCapGlobResults?q(A(e,t.maxResults,r),e.length,n):X(e.slice(0,t.maxResults),e.length,n,".")}s(V,"renderGlobPaths");function Re(e,t,r){return e.length<=t.maxResults?{items:e,truncated:!1}:t.sampleOverCapGlobResults?{items:A(e,t.maxResults,r).items,truncated:!0}:{items:e.slice(0,t.maxResults),truncated:!0}}s(Re,"globCardPage");function Y(e){const t=e.path!==void 0?` in ${e.path}`:"";return{card:"generic",title:`Glob ${e.pattern}${t}`,kind:"search",rawInput:e.pattern}}s(Y,"presentGlobCall");function z(e,t){if(t.isError)return;const r=I(t.meta);if(!(r===void 0||r.shape!=="paths"))return r}s(z,"presentGlobResult");function J(e,t){const r=t.sampleOverCapGlobResults?"while a larger one is sampled across top-level entries, so it spans the tree instead of one subtree.":"while a larger one keeps the modification-time-ordered head.";e.systemPrompt.section({name:"tool:glob",order:103,text:`Use the glob tool — not shell find — to discover files by path pattern. A pattern with no "/" matches basenames at any depth, so "*" matches every file in the tree rather than its top level. Results are files only, never directories, and include hidden and ignored files: a result that fits comes back in modification-time order, ${r}`});const n=t.sampleOverCapGlobResults?`a larger result instead returns ${t.maxResults} paths sampled across top-level entries`:`a larger result returns the first ${t.maxResults} paths in modification-time order`,o=B({name:"glob",description:`Find files whose paths match a glob pattern. Returns matching file paths — never directories — including hidden and ignored files (VCS metadata directories are excluded). Up to ${t.maxResults} paths come back in modification-time order; ${n}, says so, and reports where the complete sorted list was saved. This tool does not enumerate directory entries.`,parameters:{pattern:{type:"string",required:!0,description:'Glob pattern to match file paths against (e.g. "**/*.ts", "src/**/*.test.js"). A pattern with no "/" matches the basename at any depth, so "*" and "*.ts" both search the whole tree; include a separator to anchor the depth.'},path:{type:"string",description:"Directory to search in. Defaults to the session workspace; a relative path resolves against it."}},timeoutMs:t.timeoutMs,output:{schema:{type:"object",additionalProperties:!1,properties:{root:{type:"string",required:!0},paths:{type:"array",required:!0,items:{type:"string"}}}},render:s((a,l)=>[{type:"text",text:V(l.paths,t,l.root)}],"render"),presentationMeta:s((a,l)=>{const c=Re(l.paths,t,l.root);return be({items:c.items,truncated:c.truncated,seen:l.paths.length},t.maxMetaBytes)},"presentationMeta")},async execute(a,l){const c=U(a),i=await M(e,l,"glob",N(c),t.rawOutputMaxBytes,t.graceMs,t.stderrMaxBytes),u=c.path===void 0?".":w(c.path,i.workdir);if(i.noMatches)return{root:u,paths:[]};const d=[];for(const h of i.stdout.split(`
+`)){if(h.length===0)continue;const m=w(h,i.workdir);d.push(m)}return{root:u,paths:d}},presentCall:Y,presentResult:z});e.tools.register(o),e.on("tools/post-execute",async(a,l,c)=>{const i=await c(),u=H(e,o,a,l,i);if(u===void 0)return i;const d=u.paths;if(d.length<=t.maxResults)return i;const h=await $(e,a,"glob-results.txt",d.join(`
+`));return{kind:"accept",content:[{type:"text",text:V(d,t,u.root,h)}],...i.additionalContexts!==void 0?{additionalContexts:i.additionalContexts}:{}}})}s(J,"applyGlobTool");const Ae=250,K=2e3;function Ee(e){if(e.trim().length===0)throw new Error("include must be a non-empty glob when given");if(e.startsWith("!"))throw new Error('include must be a positive glob filter; negated patterns ("!…") are not supported');let t=0;for(const r of e)if(r==="{")t++;else if(r==="}")t=Math.max(0,t-1);else if(r===","&&t===0)throw new Error("include must be one glob, not a comma-separated list (use {a,b} alternation instead)")}s(Ee,"validateInclude");function Q(e){if(e.pattern.length===0)throw new Error("pattern must be a non-empty string");if(e.path!==void 0&&e.path.trim().length===0)throw new Error("path must be a non-empty string when given");return e.include!==void 0&&Ee(e.include),{pattern:e.pattern,...e.path!==void 0?{path:e.path}:{},...e.include!==void 0?{include:e.include}:{}}}s(Q,"parseGrepArgs");function Z(e){const t=["--json",`--regexp=${e.pattern}`];return e.include!==void 0&&t.push(`--glob=${e.include}`),e.path!==void 0&&t.push("--",e.path),t}s(Z,"buildGrepCommand");function y(e,t){return new p(`grep received malformed ripgrep --json output (${e})`,"SEARCH_FAILED",t!==void 0?{cause:t}:void 0)}s(y,"malformedRecord");function _e(e){let t;try{t=JSON.parse(e)}catch(l){throw y("a line is not JSON",l)}if(typeof t!="object"||t===null)throw y("a record is not an object");const r=t;if(r.type!=="match")return;if(typeof r.data!="object"||r.data===null)throw y("a match record has no data");const n=r.data,o=typeof n.path=="object"&&n.path!==null?n.path.text:void 0;if(typeof o!="string")throw y("a match record has no path text");if(typeof n.line_number!="number")throw y("a match record has no line number");if(typeof n.lines!="object"||n.lines===null)throw y("a match record has no line content");const a=n.lines;if(typeof a.text=="string")return{path:o,lineNumber:n.line_number,line:a.text.replace(/\r?\n$/,"")};if(typeof a.bytes=="string")return{path:o,lineNumber:n.line_number,line:"(line is not valid UTF-8)"};throw y("a match record has neither line text nor bytes")}s(_e,"parseRecord");function ee(e){const t=[];for(const r of e.split(`
+`)){if(r.length===0)continue;const n=_e(r);n!==void 0&&t.push(n)}return t}s(ee,"parseGrepMatches");function te(e){return e===1?"match":"matches"}s(te,"matchNoun");function E(e){const t=new Map;for(const n of e){const o=t.get(n.path);o!==void 0?o.push(n):t.set(n.path,[n])}const r=[];for(const[n,o]of t)r.push(`${n}
+${o.map(a=>`Line ${a.lineNumber}: ${a.line}`).join(`
+`)}`);return r.join(`
+
+`)}s(E,"formatGrepMatches");function re(e,t){const r=e.truncated?`Found ${e.kept} of ${e.seen} matches`:`Found ${e.seen} ${te(e.seen)}`,n=E(e.items);return e.truncated?`${r}
+
+${n}
+
+(${t!==void 0?`Full grep result stored at: ${t.locator}. ${t.retrievalHint}`:"The complete result could not be saved; narrow pattern, path, or include to see more."})`:`${r}
+
+${n}`}s(re,"formatGrepOutput");function ne(e,t){return e.seen===0?"No matches found":re(e,t)}s(ne,"formatRetainedGrep");function oe(e){const t=e.path!==void 0?` in ${e.path}`:"",r=e.include!==void 0?` (${e.include})`:"";return{card:"generic",title:`Grep ${e.pattern}${t}${r}`,kind:"search",rawInput:e.pattern}}s(oe,"presentGrepCall");function se(e,t){if(t.isError)return;const r=I(t.meta);if(!(r===void 0||r.shape!=="matches"))return r}s(se,"presentGrepResult");function ae(e,t){e.systemPrompt.section({name:"tool:grep",order:104,text:"Use the grep tool — not shell grep or rg — to search file contents. Use read on a matched file when you need surrounding context."});const r=B({name:"grep",description:`Search file contents with a ripgrep regular expression. Returns matching lines with line numbers, grouped by file. Returns the first ${t.maxMatches} matches inline; a capped result reports where the complete match list was saved. Use read on a matched file for surrounding context.`,parameters:{pattern:{type:"string",required:!0,description:"Regular expression to search for (ripgrep syntax)."},path:{type:"string",description:"File or directory to search. Defaults to the session workspace; a relative path resolves against it."},include:{type:"string",description:'One glob filter for which files to search (e.g. "*.ts", "*.{js,jsx}"). Not a list; negation is not supported.'}},timeoutMs:t.timeoutMs,output:{schema:{type:"object",additionalProperties:!1,properties:{matches:{type:"array",required:!0,items:{type:"object",additionalProperties:!1,properties:{path:{type:"string",required:!0},lineNumber:{type:"integer",required:!0},line:{type:"string",required:!0}}}}}},render:s((n,o)=>[{type:"text",text:ne(x(o.matches,t.maxMatches,t.maxLineBytes))}],"render"),presentationMeta:s((n,o)=>ye(x(o.matches,t.maxMatches,t.maxLineBytes),t.maxMetaBytes),"presentationMeta")},async execute(n,o){const a=await M(e,o,"grep",Z(Q(n)),t.rawOutputMaxBytes,t.graceMs,t.stderrMaxBytes);if(a.noMatches)return{matches:[]};const l=[];for(const c of ee(a.stdout)){const i={path:w(c.path,a.workdir),lineNumber:c.lineNumber,line:c.line};l.push(i)}return{matches:l}},presentCall:oe,presentResult:se});e.tools.register(r),e.on("tools/post-execute",async(n,o,a)=>{const l=await a(),c=H(e,r,n,o,l);if(c===void 0)return l;const i=c.matches;if(i.length<=t.maxMatches)return l;const u=i.map(h=>({...h,line:v(h.line,t.maxLineBytes)})),d=await $(e,n,"grep-results.txt",`Found ${i.length} ${te(i.length)}
+
+${E(u)}`);return{kind:"accept",content:[{type:"text",text:ne(x(i,t.maxMatches,t.maxLineBytes),d)}],...l.additionalContexts!==void 0?{additionalContexts:l.additionalContexts}:{}}})}s(ae,"applyGrepTool");const Ce="tool-fs-search",Se=["tools","systemPrompt","subprocess"],Be=f.object({sampleOverCapGlobResults:f.boolean().required(),globMaxResults:f.number().default(100),grepMaxMatches:f.number().default(250),grepMaxLineBytes:f.number().default(K),searchMetaMaxBytes:f.number().default(k),rawOutputMaxBytes:f.number().default(O),graceMs:f.number().default(L),stderrMaxBytes:f.number().default(G),timeoutMs:f.number().default(T)});function g(e,t){if(!Number.isInteger(t)||t<1)throw new Error(`tool-fs-search: ${e} must be a positive integer`)}s(g,"assertPositiveInteger");async function Oe(e,t){const r=t;if(g("globMaxResults",r.globMaxResults),g("grepMaxMatches",r.grepMaxMatches),g("grepMaxLineBytes",r.grepMaxLineBytes),g("searchMetaMaxBytes",r.searchMetaMaxBytes),g("rawOutputMaxBytes",r.rawOutputMaxBytes),g("graceMs",r.graceMs),r.graceMs>S)throw new Error(`tool-fs-search: graceMs must be no greater than ${S}`);g("stderrMaxBytes",r.stderrMaxBytes),g("timeoutMs",r.timeoutMs),J(e,{sampleOverCapGlobResults:r.sampleOverCapGlobResults,maxResults:r.globMaxResults,maxMetaBytes:r.searchMetaMaxBytes,rawOutputMaxBytes:r.rawOutputMaxBytes,graceMs:r.graceMs,stderrMaxBytes:r.stderrMaxBytes,timeoutMs:r.timeoutMs}),ae(e,{maxMatches:r.grepMaxMatches,maxLineBytes:r.grepMaxLineBytes,maxMetaBytes:r.searchMetaMaxBytes,rawOutputMaxBytes:r.rawOutputMaxBytes,graceMs:r.graceMs,stderrMaxBytes:r.stderrMaxBytes,timeoutMs:r.timeoutMs})}s(Oe,"apply");export{Be as Config,ve as GLOB_MAX_RESULTS,D as GLOB_VCS_EXCLUDES,K as GREP_MAX_LINE_BYTES,Ae as GREP_MAX_MATCHES,O as RAW_OUTPUT_MAX_BYTES,L as SEARCH_GRACE_MS,k as SEARCH_META_MAX_BYTES,G as SEARCH_STDERR_MAX_BYTES,T as SEARCH_TIMEOUT_MS,p as SearchError,Oe as apply,J as applyGlobTool,ae as applyGrepTool,N as buildGlobCommand,Z as buildGrepCommand,q as formatGlobOutput,E as formatGrepMatches,re as formatGrepOutput,Se as inject,Ce as name,U as parseGlobArgs,Q as parseGrepArgs,ee as parseGrepMatches,Y as presentGlobCall,z as presentGlobResult,oe as presentGrepCall,se as presentGrepResult,v as previewLine,F as resolveRgPath,M as runRipgrep,A as sampleAcrossTopLevel,w as toWorkdirRelative,$ as trySaveFormattedResult};

package/node_modules/@deepseek-ai/dsh-tool-fs-search/lib/invariant.js

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

package/node_modules/@deepseek-ai/dsh-tool-fs-search/package.json

@@ -0,0 +1 @@
+{"name":"@deepseek-ai/dsh-tool-fs-search","version":"0.0.8","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","dependencies":{"@vscode/ripgrep":"^1.18.0","@deepseek-ai/schemastery":"^3.18.1"},"peerDependencies":{"@deepseek-ai/dsh-invariants":"^0.0.8","@deepseek-ai/dsh-llm":"^0.0.8","@deepseek-ai/dsh-session":"^0.0.8","@deepseek-ai/dsh-spill":"^0.0.8","@deepseek-ai/dsh-subprocess":"^0.0.8","@deepseek-ai/dsh-timeout":"^0.0.8","@deepseek-ai/dsh-output-retention":"^0.0.8","@deepseek-ai/dsh-system-prompt":"^0.0.8","@deepseek-ai/cordis":"^4.0.1","@deepseek-ai/dsh-tools":"^0.0.8"}}

package/node_modules/@deepseek-ai/dsh-tool-goal/lib/index.js

@@ -0,0 +1,7 @@
+var R=Object.defineProperty;var i=(e,t)=>R(e,"name",{value:t,configurable:!0});import k from"@deepseek-ai/schemastery";import{GoalId as T}from"@deepseek-ai/dsh-goal";import{HarnessError as a,boundContextSummary as j,createUserMessage as E}from"@deepseek-ai/dsh-llm";import{defineTool as b}from"@deepseek-ai/dsh-tools";function c(e,t="GOAL_TOOL_AUTHORITY_REQUIRED"){throw new a(e,t)}i(c,"reject");function L(e){const t=e.session.events;for(let n=t.length-1;n>=0;n-=1){const o=t[n];if(o?.type==="turn/end"&&c("goal tools require an open model turn","GOAL_TOOL_DRIVER_REQUIRED"),o?.type==="turn/start")return{start:o,events:t.slice(n+1)}}return c("goal tools require an open model turn","GOAL_TOOL_DRIVER_REQUIRED")}i(L,"openTurn");function f(e,t){const n=t.agent;return n===void 0?c("goal tools require a calling agent","GOAL_TOOL_AGENT_REQUIRED"):e.agents.get(n.id)!==n||n.status!=="running"||e.agents.currentInitiator()!==n?c("goal tools require the exact live calling agent inside its active driver","GOAL_TOOL_DRIVER_REQUIRED"):{agent:n,...L(n)}}i(f,"goalToolExecution");function w(e,t){return e.agents.roots().includes(t.agent)?t.events.some(n=>n.type==="user/message"&&n.data.source.kind==="user"):!1}i(w,"hasDirectHumanInput");function q(e,t){return e.events.some(n=>n.type==="user/message"&&n.data.source.kind==="goal"&&n.data.source.goalId===t.id&&n.data.source.revision===t.revision&&n.data.source.round===t.roundsStarted)}i(q,"isMatchingGoalRound");function _(e,t){w(e,t)||c("this goal operation requires a direct human turn on a top-level agent")}i(_,"requireDirectHuman");function D(e,t){if(w(e,t))return{kind:"direct-human"};const n=e.goals.get(t.agent);return n!==void 0&&q(t,n)?{kind:"goal-round",goal:n}:c("complete and blocked require a direct human turn or the current goal round")}i(D,"completionAuthority");function O(e,t){const n=`Objective: ${JSON.stringify(e)}
+`;return[{type:"text",text:t===void 0?`<goal_complete>
+`+n+`The goal is marked complete and this autonomous run is ending. Write the closing message to the user now: state the outcome, summarize what was done and how it was verified, and point to the concrete results (files, commits, or other artifacts). Report only what earlier rounds and tool results in this session actually establish; when a detail is not in the session, say so instead of inventing it. Note anything the user should review or do next. Address the user directly. Do not call any more tools in this run; further work waits for the user's next instruction.
+</goal_complete>`:`<goal_blocked>
+`+n+`Blocked: ${JSON.stringify(t)}
+The goal is marked blocked and this autonomous run is ending. Write the closing message to the user now: state what has been completed so far, describe the concrete blocking condition and what you tried, and say exactly what you need from the user to continue. Report only what earlier rounds and tool results in this session actually establish; when a detail is not in the session, say so instead of inventing it. Address the user directly. Do not call any more tools in this run; further work waits for the user's next instruction.
+</goal_blocked>`}]}i(O,"renderWrapupContext");const C="tool-goal",I=["agents","goals","tools","systemPrompt"],x=k.object({blockedAfterConsecutiveRounds:k.number().step(1).min(1).default(3)}),G=["edit","pause","resume","complete","blocked"],P='Create one persisted same-session completion goal when the current direct human request is a long-running objective that should continue across autonomous goal rounds. You may infer that intent without requiring the user to say "create a goal". Do not use this for trivial single-turn work. Execution rejects non-human and subagent authority.',U="Read the current same-session goal, including its exact id/revision, objective, phase, completed continuation rounds, round limit, blocker reason when present, and whether another continuation is armed. Call this before updating a goal.",S={oneOf:[{type:"object",additionalProperties:!1,properties:{goal:{type:"null",required:!0}}},{type:"object",additionalProperties:!1,properties:{goal:{type:"object",additionalProperties:!1,required:!0,properties:{id:{type:"string",required:!0},revision:{type:"integer",required:!0},objective:{type:"string",required:!0},phase:{type:"string",required:!0,enum:["active","paused","blocked","complete"]},roundsStarted:{type:"integer",required:!0},maxGoalRounds:{type:"integer",required:!0},blockedReason:{type:"object",additionalProperties:!1,properties:{code:{type:"string",required:!0},message:{type:"string",required:!0}}}}},activation:{type:"string",required:!0,enum:["armed","disarmed"]}}}]};function N(e){return`Use goal tools for one long-running completion objective in the current session. create_goal may infer goal intent from a direct human request in any language; do not create a goal for routine single-turn work. Call get_goal before update_goal and copy its exact goal_id and revision. After session resume or fork, an active goal is disarmed: when a human asks to continue or resume in any wording or language, use update_goal action resume to rearm it. Mark complete only when the objective is actually achieved. Mark blocked only after the same blocking condition persists for at least ${e} consecutive goal rounds, and report that concrete condition in blocked_reason; difficulty, uncertainty, or useful remaining work is not blocked.`}i(N,"guidance");function V(e){const t=e.blockedAfterConsecutiveRounds??3;if(!Number.isSafeInteger(t)||t<1)throw new TypeError("blockedAfterConsecutiveRounds must be a positive safe integer");return{blockedAfterConsecutiveRounds:t}}i(V,"resolveConfig");function s(e){return e!==void 0&&e!==""}i(s,"hasText");function g(e){return e!==void 0&&e!==0}i(g,"hasRoundCap");function $(e,t){if(e.length===0||e!==e.trim()||!Number.isSafeInteger(t)||t<1)throw new a("goal_id must be non-empty and revision must be a positive safe integer","GOAL_TOOL_INVALID_UPDATE");return{id:T(e),revision:t}}i($,"goalRef");function l(e){return e===void 0?{goal:null}:{goal:{id:e.id,revision:e.revision,objective:e.objective,phase:e.phase,roundsStarted:e.roundsStarted,maxGoalRounds:e.maxGoalRounds,...e.blockedReason===void 0?{}:{blockedReason:{code:e.blockedReason.code,message:e.blockedReason.message}}},activation:e.activation}}i(l,"goalValue");const v={schema:S,render:i((e,t)=>[{type:"text",text:JSON.stringify(t)}],"render")};function y(e,t,n){return{card:"generic",title:e,kind:t,...n===void 0?{}:{rawInput:n}}}i(y,"present");function H(e,t){const n=V(t);e.systemPrompt.section({name:"tool:goal",order:114,text:N(n.blockedAfterConsecutiveRounds)}),e.tools.register(b({name:"get_goal",description:U,parameters:{},output:v,execute(o,d){const r=f(e,d);return Promise.resolve(l(e.goals.get(r.agent)))},presentCall:i(()=>y("Read current goal","read"),"presentCall")})),e.tools.register(b({name:"create_goal",description:P,parameters:{objective:{type:"string",required:!0,description:"The concrete completion objective inferred from the direct human request."},max_goal_rounds:{type:"number",description:"Optional positive safe-integer limit on automatic continuation rounds."}},output:v,execute(o,d){const r=f(e,d);_(e,r);const u=e.goals.create(r.agent,{objective:o.objective,...o.max_goal_rounds===void 0?{}:{maxGoalRounds:o.max_goal_rounds}});return Promise.resolve(l(u))},presentCall:i(o=>y("Create goal","other",o.objective),"presentCall")})),e.tools.register(b({name:"update_goal",description:"Update the exact current goal revision. edit, pause, and resume require a direct top-level human request. During an automatic continuation of the current goal, complete and blocked are also allowed. blocked is rejected before the configured minimum round count; the model remains responsible for judging that the same condition persisted across those rounds and must explain it in blocked_reason.",parameters:{goal_id:{type:"string",required:!0,description:"Exact id returned by get_goal."},revision:{type:"number",required:!0,description:"Exact positive revision returned by get_goal."},action:{type:"string",required:!0,enum:G,description:"edit | pause | resume | complete | blocked"},objective:{type:"string",description:"Replacement objective; valid only with action edit."},max_goal_rounds:{type:"number",description:"Replacement cap; valid only with action edit."},blocked_reason:{type:"string",description:"Concrete blocking condition; required only with action blocked."}},output:v,execute(o,d){const r=f(e,d),u=$(o.goal_id,o.revision),A={...s(o.objective)?{objective:o.objective}:{},...g(o.max_goal_rounds)?{maxGoalRounds:o.max_goal_rounds}:{}};if(o.action==="edit"){if(_(e,r),s(o.blocked_reason))throw new a("blocked_reason is valid only with action blocked","GOAL_TOOL_INVALID_UPDATE");const h=e.goals.edit(r.agent,u,A);return Promise.resolve(l(h))}if(o.action==="pause"||o.action==="resume"){if(_(e,r),s(o.objective)||g(o.max_goal_rounds)||s(o.blocked_reason))throw new a("objective and max_goal_rounds are valid only with action edit; blocked_reason is valid only with action blocked","GOAL_TOOL_INVALID_UPDATE");const h=o.action==="pause"?e.goals.pause(r.agent,u):e.goals.resume(r.agent,u);return Promise.resolve(l(h))}const m=D(e,r);if(s(o.objective)||g(o.max_goal_rounds))throw new a("objective and max_goal_rounds are valid only with action edit","GOAL_TOOL_INVALID_UPDATE");if(o.action==="complete"&&s(o.blocked_reason))throw new a("blocked_reason is valid only with action blocked","GOAL_TOOL_INVALID_UPDATE");if(o.action==="blocked"&&(o.blocked_reason===void 0||o.blocked_reason.trim().length===0))throw new a("blocked_reason is required with action blocked","GOAL_TOOL_INVALID_UPDATE");if(o.action==="blocked"&&m.kind==="goal-round"&&m.goal.roundsStarted<n.blockedAfterConsecutiveRounds)throw new a(`blocked requires at least ${n.blockedAfterConsecutiveRounds} consecutive goal rounds; current round is ${m.goal.roundsStarted}`,"GOAL_TOOL_BLOCK_THRESHOLD");const p=o.action==="complete"?e.goals.complete(r.agent,u):e.goals.block(r.agent,u,{code:"model-reported",message:o.blocked_reason});return m.kind==="goal-round"&&d.deferContext(E({content:o.action==="complete"?O(p.objective):O(p.objective,o.blocked_reason),source:{kind:"plugin",plugin:"tool-goal",form:"notice",summary:j(`${o.action}: ${p.objective}`)}})),Promise.resolve(l(p))},presentCall:i(o=>y(`${o.action==="blocked"?"Mark":o.action.charAt(0).toUpperCase()+o.action.slice(1)} goal`,"other",s(o.blocked_reason)?o.blocked_reason:s(o.objective)?o.objective:g(o.max_goal_rounds)?o.max_goal_rounds:o.goal_id),"presentCall")}))}i(H,"apply");export{x as Config,H as apply,I as inject,C as name};

package/node_modules/@deepseek-ai/dsh-tool-goal/lib/invariant.js

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

package/node_modules/@deepseek-ai/dsh-tool-goal/package.json

@@ -0,0 +1 @@
+{"name":"@deepseek-ai/dsh-tool-goal","version":"0.0.8","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":{"@deepseek-ai/dsh-agent":"^0.0.8","@deepseek-ai/dsh-invariants":"^0.0.8","@deepseek-ai/dsh-goal":"^0.0.8","@deepseek-ai/dsh-llm":"^0.0.8","@deepseek-ai/dsh-system-prompt":"^0.0.8","@deepseek-ai/dsh-tools":"^0.0.8","@deepseek-ai/cordis":"^4.0.1","@deepseek-ai/dsh-session":"^0.0.8"},"dependencies":{"@deepseek-ai/schemastery":"^3.18.1"}}

package/node_modules/@deepseek-ai/dsh-tool-jobs/lib/index.js

@@ -0,0 +1,10 @@
+var M=Object.defineProperty;var s=(e,o)=>M(e,"name",{value:o,configurable:!0});import j from"@deepseek-ai/schemastery";import{boundContextSummary as S,createUserMessage as A}from"@deepseek-ai/dsh-llm";import{TextRetainer as _}from"@deepseek-ai/dsh-output-retention";import{defineTool as y}from"@deepseek-ai/dsh-tools";import{JobId as B}from"@deepseek-ai/dsh-jobs";const P="tool-jobs",E=["tools","jobs","systemPrompt"],J=j.object({waitTimeoutMs:j.number().min(1).default(3e4),maxWaitTimeoutMs:j.number().min(1).default(6e5),completionDelivery:j.union(["quiet","wakeup"]).default("wakeup"),maxConsecutiveWakes:j.number().min(1).default(3)}),h={type:"object",additionalProperties:!1,properties:{id:{type:"string",required:!0},kind:{type:"string",required:!0},label:{type:"string",required:!0},status:{type:"string",required:!0,enum:["running","stopping","completed","killed","failed"]},detail:{type:"string"},startedAt:{type:"integer",required:!0},finishedAt:{type:"integer"}}};function k(e){return{id:e.id,kind:e.kind,label:e.label,status:e.status,...e.detail!==void 0?{detail:e.detail}:{},startedAt:e.startedAt,...e.finishedAt!==void 0?{finishedAt:e.finishedAt}:{}}}s(k,"publicJob");function f(e){return e.detail!==void 0?`[status: ${e.status}, ${e.detail}]`:`[status: ${e.status}]`}s(f,"statusLine");const g=new TextEncoder;function $(e,o){const i=new _({kind:"tail",maxBytes:o});return i.push(e),i.finish().text}s($,"retainTail");function C(e,o){const i=new _({kind:"head",maxBytes:o});return i.push(e),i.finish().text}s(C,"retainHead");function q(e,o,i,a){const c=`${e}${o}`;if(i===void 0||g.encode(c).byteLength<=i)return c;const u=`${e.endsWith(a.trimStart())?"":a}${o}`,l=g.encode(u).byteLength;return l>=i?$(u,i):`${$(e,i-l)}${u}`}s(q,"fitWithSuffix");function R(e){return S(`${e.kind} ${e.label} ${f(e)}`)}s(R,"completionSummary");function D(e){const o=`background job ${e.id}`,i=` (${e.kind}: ${e.label}) finished ${f(e)}`,a=`
+Done; job_output.`,c=`${o}${i}. Read its output with job_output.`,u=e.outputLimitBytes;if(u===void 0||g.encode(c).byteLength<=u)return c;const l=`
+[notice truncated]`,p=`${o}${l}${a}`,m=g.encode(p).byteLength;if(m<=u)return m===u?p:`${o}${C(i,u-m)}${l}${a}`;const n=`${o}${a}`;if(g.encode(n).byteLength<=u)return n;const t=g.encode(a).byteLength;return t>=u?$(a,u):`${C(o,u-t)}${a}`}s(D,"fitCompletionNotice");function T(e){if(e.length!==1)return;const o=e[0];if(o?.type==="text")return o.text}s(T,"rawSingleText");function z(e,o){const i=T(e);if(i!==void 0)return[{type:"text",text:q(i,"",o,`
+[result truncated]`)}]}s(z,"boundSingleText");function L(e,o){if(o.name!=="job_output"&&o.name!=="job_kill")return;const i=o.arguments?.job_id;if(!(typeof i!="string"||i.length===0))return e.jobs.list(o.agent).find(a=>a.id===i)?.outputLimitBytes}s(L,"visibleOutputLimit");function W(e){if(e.length===0)throw new Error(`invalid job_id: expected a non-empty string, got ${JSON.stringify(e)}`);return B(e)}s(W,"validateJobId");function w(e,o,i){return{card:"generic",title:e,kind:o,...i!==void 0?{rawInput:i}:{}}}s(w,"presentTaskCall");function I(e,o){const i=o.waitTimeoutMs??3e4,a=o.maxWaitTimeoutMs??6e5,c=o.completionDelivery??"wakeup",u=o.maxConsecutiveWakes??3,l=new WeakMap;if(i>a)throw new Error(`tool-jobs: waitTimeoutMs (${i}) exceeds maxWaitTimeoutMs (${a})`);if(!Number.isSafeInteger(u))throw new Error(`tool-jobs: maxConsecutiveWakes (${u}) must be a whole number of turns`);c==="wakeup"&&e.on("agent/inbox/claimed",({agent:n,message:t})=>{t.source.kind==="user"&&l.delete(n)});const p=new WeakMap;e.on("tools/pre-execute",(n,t)=>{const r=L(e,n);return r!==void 0&&p.set(n,r),t()},{prepend:!0});const m=s((n,t)=>{const r=p.get(n)??L(e,n);if(p.delete(n),r!==void 0){if(n.name==="job_output"&&!t.isError){const d=t.value,b=d.text.length>0?d.text:"(no new output)",v=b.endsWith(`
+`)?b.slice(0,-1):b,x=`
+${f(d.job)}`;if(T(t.content)===`${v}${x}`)return[{type:"text",text:q(v,x,r,`
+[output truncated]`)}]}return z(t.content,r)}},"finalizeTaskContent");e.jobs.attachController("tool-jobs"),e.systemPrompt.section({name:"tool:jobs",order:106,text:"Track every background job id you start. You are notified in-session when a job finishes — do not busy-poll or sleep on one; keep working on independent steps and do not duplicate a running job's work. Before giving a final answer, collect every still-relevant job with job_output (set wait: true only when you are genuinely blocked on it), and job_kill jobs that stopped mattering."}),e.jobs.onJobDone((n,t)=>{if(n.reported||t===void 0)return;const r=A({content:[{type:"text",text:D(n)}],source:{kind:"plugin",plugin:"tool-jobs",form:"notice",summary:R(n)}}),d=l.get(t)??0;if(c==="wakeup"&&t.status==="idle"&&d<u){l.set(t,d+1),t.followup(r);return}t.inject(r)}),e.tools.register(y({name:"job_output",description:"Read a background job. Stream jobs return only output since the previous read; final-output jobs return their result after settlement. Every response ends with `[status: ...]`. Reads are non-blocking unless `wait: true`, which waits up to the configured cap.",parameters:{job_id:{type:"string",required:!0,description:"Job id returned by the tool that started the background work."},wait:{type:"boolean",description:"Block until the job reaches a terminal status or the timeout expires. A timed-out wait returns [status: running] and leaves the job alive."},timeout_ms:{type:"number",description:"Max wait in milliseconds (only meaningful with wait: true). Defaults to the configured wait timeout; capped by the configured maximum."}},finalizeContent:m,output:{schema:{type:"object",additionalProperties:!1,properties:{text:{type:"string",required:!0},job:{...h,required:!0}}},render:s((n,t)=>{const r=t.text.length>0?t.text:"(no new output)";return[{type:"text",text:`${r}${r.endsWith(`
+`)?"":`
+`}${f(t.job)}`}]},"render")},async execute(n,t){const r=W(n.job_id);if(n.wait===!0){const b=Math.min(n.timeout_ms??i,a);await e.jobs.wait(r,b,t.agent,t.signal)}const d=e.jobs.read(r,t.agent);return{text:d.text,job:k(d.snapshot)}},presentCall:s(n=>w(`Read output from background job ${n.job_id}`,"read",n.job_id),"presentCall")})),e.tools.register(y({name:"job_list",description:"List your background jobs (running and finished) with their ids, kinds, and statuses.",parameters:{},output:{schema:{type:"array",items:h},render:s((n,t)=>[{type:"text",text:t.length===0?"(no background jobs)":t.map(r=>`${r.id} [${r.kind}] ${r.status} — ${r.label}`).join(`
+`)}],"render")},execute(n,t){const r=e.jobs.list(t.agent);return Promise.resolve(r.map(k))},presentCall:s(()=>w("List background jobs","read"),"presentCall")})),e.tools.register(y({name:"job_kill",description:"Request cancellation of a running background job by job id. Returns immediately; the job settles as killed once its work actually stops.",parameters:{job_id:{type:"string",required:!0,description:"Job id returned by the tool that started the background work."},reason:{type:"string",description:"Optional short reason, recorded in the log and forwarded to the job."}},finalizeContent:m,output:{schema:{type:"object",additionalProperties:!1,properties:{outcome:{type:"string",required:!0,enum:["cancellation-requested","already-finished"]},job:{...h,required:!0}}},render:s((n,t)=>[{type:"text",text:t.outcome==="already-finished"?`job ${t.job.id} had already finished ${f(t.job)}`:`requested cancellation of job ${t.job.id}`}],"render")},execute(n,t){const r=W(n.job_id),d=e.jobs.kill(r,t.agent,n.reason),b=k(e.jobs.get(r,t.agent));return Promise.resolve({outcome:d==="already-finished"?"already-finished":"cancellation-requested",job:b})},presentCall:s(n=>w(`Kill background job ${n.job_id}`,"execute",n.job_id),"presentCall")}))}s(I,"apply");export{J as Config,I as apply,E as inject,P as name,f as statusLine};

package/node_modules/@deepseek-ai/dsh-tool-jobs/lib/invariant.js

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

package/node_modules/@deepseek-ai/dsh-tool-jobs/package.json

@@ -0,0 +1 @@
+{"name":"@deepseek-ai/dsh-tool-jobs","version":"0.0.8","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","dependencies":{"@deepseek-ai/schemastery":"^3.18.1"},"peerDependencies":{"@deepseek-ai/dsh-llm":"^0.0.8","@deepseek-ai/dsh-output-retention":"^0.0.8","@deepseek-ai/dsh-system-prompt":"^0.0.8","@deepseek-ai/cordis":"^4.0.1","@deepseek-ai/dsh-invariants":"^0.0.8","@deepseek-ai/dsh-agent":"^0.0.8","@deepseek-ai/dsh-tools":"^0.0.8","@deepseek-ai/dsh-jobs":"^0.0.8"}}

package/node_modules/@deepseek-ai/dsh-tool-pwsh/lib/index.js

@@ -0,0 +1,13 @@
+var E=Object.defineProperty;var i=(e,s)=>E(e,"name",{value:s,configurable:!0});import{isAbsolute as _,resolve as M}from"node:path";import g from"@deepseek-ai/schemastery";import{TOOL_ABORTED as w,defineTool as q}from"@deepseek-ai/dsh-tools";import{HarnessError as y}from"@deepseek-ai/dsh-llm";import{ESCALATION_TARGETS as O,approveEscalation as $,escalationHintMarker as v,sandboxDenialMarker as x,validateEscalationArgs as C}from"@deepseek-ai/dsh-sandbox";import{parseExitStatus as T}from"@deepseek-ai/dsh-shell";function I(e){return e.status==="killed"?{status:"killed",detail:e.signal!==null?`signal: ${e.signal}`:"killed before exit"}:{status:"completed",detail:`exit code: ${e.exitCode??0}`}}i(I,"processOutcome");function k(e){return e.truncated?`${e.text}
+[output truncated; full output: ${e.spillPath??"(unavailable)"}]`:e.text}i(k,"streamText");function R(e,s=[]){const o=k(e.stdout),a=k(e.stderr);let n=o;a.length>0&&(n.length>0&&!n.endsWith(`
+`)&&(n+=`
+`),n+=`[stderr]
+${a}`),n.length===0&&(n="(no output)");const d=[];return e.sandbox?.denied&&(d.push(x(e.sandbox.mode)),s.length>0&&d.push(v("command"))),e.timedOut&&d.push(`[timed out after ${e.timeoutMs}ms]`),e.signal!==null?d.push(`[killed by signal: ${e.signal}]`):e.exitCode!==0&&d.push(`[exit code: ${e.exitCode}]`),d.length===0?n:(n.endsWith(`
+`)||(n+=`
+`),n+d.join(`
+`))}i(R,"renderPwshResult");function S(e,s,o=[]){const a=[];if(e.lossy){const n=[e.stdoutSpillPath,e.stderrSpillPath].filter(d=>d!==void 0);a.push(`[some output was dropped from memory; full output: ${n.length>0?n.join(", "):"(unavailable)"}]`)}return s?.runnerFailed?a.push(`[sandbox: the sandbox runner itself failed under ${s.mode} mode — the command did not run; this is a sandbox problem, not a command failure]`):s?.denied&&(a.push(x(s.mode)),o.length>0&&a.push(v("command"))),a.length===0?e.delta:`${e.delta}${e.delta.length>0&&!e.delta.endsWith(`
+`)?`
+`:""}${a.join(`
+`)}`}i(S,"renderPwshProcessRead");const A="tool-pwsh",N=["tools","shell","systemPrompt","shellEnv"],D=g.object({enableRunInBackground:g.boolean().default(!0)});function F(e){if(e.command.trim().length===0)throw new Error("invalid command: expected a non-empty string");if(e.description.trim().length===0)throw new Error("invalid description: expected a non-empty string");if(e.timeoutMs!==void 0&&(!Number.isFinite(e.timeoutMs)||e.timeoutMs<=0))throw new Error(`invalid timeoutMs: expected a positive number, got ${JSON.stringify(e.timeoutMs)}`);C(e.sandbox_permissions,e.justification)}i(F,"validatePwshArgs");function L(e,s){const o="Execute a PowerShell command (`pwsh -Command`) and return its stdout/stderr. Each call runs in a fresh pwsh process: no state (cwd, variables, functions) persists between calls — pass `workdir` instead of using `cd`. Paths use native Windows form (`C:\\...`); read environment variables with `$env:NAME`. Non-zero exits are reported as `[exit code: N]`. Current harness environment facts are exposed through managed `$env:DSH_*` variables; inspect them when needed. Commands may run under a file sandbox; a blocked file operation is reported as `[sandbox: file access denied under <mode> mode]` — a policy denial, not a bug in the command; do not retry another way. Long output is truncated to its tail; the full output is saved to a file whose path is reported when available. On Windows a force-killed command settles as `[exit code: 1]` without a signal marker — treat it as an interruption, not a command failure. "+(e?"Set `run_in_background: true` for long-running commands: the call returns a job id immediately; read its output with `job_output` and stop it with `job_kill`.":"Background execution is not available; long-running commands must finish within the timeout.");return s.length===0?o:o+" Under the Windows sandbox, read-only pwsh runs in PowerShell ConstrainedLanguage mode, while workspace-write stays in FullLanguage unless host policy says otherwise. In read-only, prefer cmdlets and core types (`[string]`, `[datetime]`, `[regex]`, `[guid]`); .NET static calls (`[System.IO.*]::`, `[math]::`), `Add-Type`, COM objects, and reflection fail with \"only core types\" errors. `-f` formatting, property access, and core cmdlets work. In both confined modes, programs cannot open named pipes, so a command that captures another program's output through piped stdio (Node.js `child_process.spawn`/`exec` with the default `stdio: 'pipe'`) fails with EPERM, while `stdio: 'inherit'` and `stdio: 'ignore'` spawns work and PowerShell's own pipelines are unaffected. That EPERM is the documented boundary: do not retry the command another way — escalate the exact command once or restructure it to avoid capturing output. Attempting a command the sandbox may deny is safe and expected: run it and read the marker rather than assuming the denial. When a command is denied and a wider mode would let it succeed, escalate immediately in the same turn — the one sanctioned exception to a denial: retry the exact same command once with `sandbox_permissions` (the narrowest wider mode that suffices) plus a one-sentence `justification`. Do not detour through chat to ask permission first — the approval prompt raised by that retry is how the user consents. If the session states approval prompts are disabled, there is no exception: a denial is final — do not set `sandbox_permissions`. Never escalate speculatively: ground the request in a real denial — normally the one this command just hit; escalating up front is fine only when this session already denied the same access. A rejected escalation is final for that command — stop and explain, never work around it — but it does not forbid attempting or escalating other commands later."}i(L,"pwshDescription");function W(e,s){const o=s.agent?.session.header.cwd;return e===void 0?o:o!==void 0&&!_(e)?M(o,e):e}i(W,"resolveWorkdir");function B(e){const s=i(o=>({text:o.text,truncated:o.truncated,...o.spillPath!==void 0?{spillPath:o.spillPath}:{}}),"output");return{kind:"foreground",exitCode:e.exitCode,signal:e.signal,timedOut:e.timedOut,aborted:e.aborted,timeoutMs:e.timeoutMs,stdout:s(e.stdout),stderr:s(e.stderr),...e.sandbox!==void 0?{sandbox:{mode:e.sandbox.mode,denied:e.sandbox.denied,...e.sandbox.enforcement!==void 0?{enforcement:e.sandbox.enforcement}:{},...e.sandbox.runnerFailed!==void 0?{runnerFailed:e.sandbox.runnerFailed}:{}}}:{}}}i(B,"canonicalPwshResult");const U={kind:{type:"string",required:!0,const:"background"},jobId:{type:"string",required:!0}};function z(e,s={}){const o=s.enableRunInBackground??!0,a=e.shell.sandboxMode,n=a===void 0?[]:O,d=a===void 0?void 0:e.get("sandboxPolicy");if(a!==void 0&&d===void 0)throw new Error("tool-pwsh: the mounted bash executor confines but ctx.sandboxPolicy is missing");const j=i(t=>d?.resolve(t.agent===void 0?{}:{session:t.agent.session}),"resolveSandboxPolicy"),P=i((t,r,l,c)=>{if(n.length===0)throw new Error("sandbox_permissions is not available in this composition (no sandboxing executor to escalate)");const p=c.mode;return $({requestedMode:t,justification:r,effectiveMode:p,subject:"command"},{approver:e.get("approval"),agent:l.agent,callId:l.callId,toolName:"pwsh",signal:l.signal})},"approvePwshEscalation");e.systemPrompt.section({name:"tool:pwsh",order:105,text:"Non-zero exits are reported as `[exit code: N]` markers; investigate failures before moving on. On Windows a killed process settles as `[exit code: 1]` without a signal marker; treat a bare exit 1 after an interruption as a termination, not a command failure."}),e.tools.register(q({name:"pwsh",description:L(o,n),parameters:{command:{type:"string",required:!0,description:"The PowerShell command to execute."},description:{type:"string",required:!0,description:'Clear, concise description of what this command does in active voice, 5-10 words (shown in the UI). Examples: "ls" → "List files in current directory"; "git status" → "Show working tree status"; "Get-Process" → "List running processes".'},timeoutMs:{type:"number",description:"Timeout in milliseconds. The executor applies its configured default and cap, and kills the command on expiry."},workdir:{type:"string",description:"Working directory for this command. Defaults to the session workspace; a relative path is resolved against it."},...o?{run_in_background:{type:"boolean",description:"Run in the background and return a job id immediately (collect with job_output, stop with job_kill). No timeout applies."}}:{},...n.length>0?{sandbox_permissions:{type:"string",enum:[...n],description:"The wider sandbox mode this command needs. Only valid as a one-shot retry of a command the sandbox just denied; requires justification and user approval."},justification:{type:"string",description:"Required with sandbox_permissions: one sentence for the user explaining why this exact command needs the wider access."}}:{}},output:{schema:{oneOf:[{type:"object",additionalProperties:!1,properties:U},{type:"object",additionalProperties:!1,properties:{kind:{type:"string",required:!0,const:"foreground"},exitCode:{required:!0,oneOf:[{type:"integer"},{type:"null"}]},signal:{required:!0,oneOf:[{type:"string"},{type:"null"}]},timedOut:{type:"boolean",required:!0},aborted:{type:"boolean",required:!0},timeoutMs:{type:"number",required:!0},stdout:{type:"object",additionalProperties:!1,required:!0,properties:{text:{type:"string",required:!0},truncated:{type:"boolean",required:!0},spillPath:{type:"string"}}},stderr:{type:"object",additionalProperties:!1,required:!0,properties:{text:{type:"string",required:!0},truncated:{type:"boolean",required:!0},spillPath:{type:"string"}}},sandbox:{type:"object",additionalProperties:!1,properties:{mode:{type:"string",required:!0},denied:{type:"boolean",required:!0},enforcement:{type:"string"},runnerFailed:{type:"boolean"}}}}}]},render:i((t,r)=>[{type:"text",text:r.kind==="background"?`started background job ${r.jobId}`:R(r,n)}],"render")},async execute(t,r){F(t);const l=j(r),c=t.sandbox_permissions!==void 0&&t.justification!==void 0?await P(t.sandbox_permissions,t.justification,r,l):void 0,p=c===void 0?l:{...l,mode:c},h=W(t.workdir,r),f={command:t.command,...h!==void 0?{workdir:h}:{},...t.timeoutMs!==void 0?{timeoutMs:t.timeoutMs}:{},dshEnv:e.shellEnv.collect(r),...p!==void 0?{sandboxPolicy:p}:{}};if(t.run_in_background===!0){if(!o)throw new Error("run_in_background is disabled for this deployment (enableRunInBackground: false)");const m=e.get("jobs");if(m===void 0)throw new Error("background jobs unavailable: load @deepseek-ai/dsh-jobs and @deepseek-ai/dsh-tool-jobs");if(r.signal.aborted){const u=new y("tool call aborted",w);throw u.name="AbortError",u}return{kind:"background",jobId:m.start({kind:"pwsh",label:t.command,...r.agent?{owner:r.agent}:{},run:i(()=>{const u=e.shell.start(e.shell.resolve(f));return{cancel:i(()=>{u.kill()},"cancel"),done:u.done.then(()=>I(u)),readOutput:i(()=>S(u.readOutput(),u.sandbox,n),"readOutput")}},"run")})}}const b=await e.shell.run(e.shell.resolve({...f,signal:r.signal}));if(b.aborted){const m=new y("tool call aborted",w);throw m.name="AbortError",m}return B(b)},presentCall:i(t=>t.run_in_background===!0?{card:"generic",title:t.command,kind:"execute",rawInput:t.command,content:[{type:"text",text:t.description}]}:{card:"terminal",title:t.command,description:t.description,...t.workdir!==void 0?{cwd:t.workdir}:{}},"presentCall"),presentResult:i((t,r)=>{const l=r.content.length===1?r.content[0]:void 0;if(l===void 0||l.type!=="text")return;const c=l.text;if(typeof t=="object"&&t!==null&&t.run_in_background===!0||r.isError)return{card:"generic",content:[{type:"text",text:`\`\`\`console
+${c.replace(/\n+$/,"")}
+\`\`\``}]};const{body:p,...h}=T(c);return{card:"terminal",output:p,...h}},"presentResult")}))}i(z,"apply");export{D as Config,z as apply,N as inject,A as name};

package/node_modules/@deepseek-ai/dsh-tool-pwsh/lib/invariant.js

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

package/node_modules/@deepseek-ai/dsh-tool-pwsh/package.json

@@ -0,0 +1 @@
+{"name":"@deepseek-ai/dsh-tool-pwsh","version":"0.0.8","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":{"@deepseek-ai/dsh-agent":"^0.0.8","@deepseek-ai/dsh-shell":"^0.0.8","@deepseek-ai/dsh-sandbox":"^0.0.8","@deepseek-ai/dsh-llm":"^0.0.8","@deepseek-ai/dsh-shell-env":"^0.0.8","@deepseek-ai/dsh-jobs":"^0.0.8","@deepseek-ai/dsh-system-prompt":"^0.0.8","@deepseek-ai/dsh-sandbox-policy":"^0.0.8","@deepseek-ai/dsh-tools":"^0.0.8","@deepseek-ai/dsh-invariants":"^0.0.8","@deepseek-ai/dsh-user-approval":"^0.0.8","@deepseek-ai/cordis":"^4.0.1"},"dependencies":{"@deepseek-ai/schemastery":"^3.18.1"}}

package/node_modules/@deepseek-ai/dsh-tool-ralph/lib/index.js

@@ -0,0 +1,98 @@
+var k=Object.defineProperty;var n=(r,t)=>k(r,"name",{value:t,configurable:!0});import i from"@deepseek-ai/schemastery";import{defineTool as v}from"@deepseek-ai/dsh-tools";const E="tool-ralph",S=["tools","workflowEngine","subagents","systemPrompt"],x=i.object({subagentProvider:i.string().default("spawn"),maxRounds:i.number().step(1).min(1).max(Number.MAX_SAFE_INTEGER).default(256),maxHandoffChars:i.number().step(1).min(1).max(Number.MAX_SAFE_INTEGER).default(16384),maxResultChars:i.number().step(1).min(1).max(Number.MAX_SAFE_INTEGER).default(16384)}),j={name:"ralph-loop",description:"Iterate toward one objective with a fresh child and bounded structured handoff per round.",phases:[{title:"Fresh-agent rounds",detail:"One clean child context per Ralph round."}]},T=String.raw`
+const reportSchema = {
+  type: 'object',
+  properties: {
+    status: { type: 'string', enum: ['continue', 'complete', 'blocked'] },
+    summary: { type: 'string' },
+    evidence: { type: 'array', items: { type: 'string' } },
+    nextSteps: { type: 'array', items: { type: 'string' } },
+    blocker: { type: 'string' },
+  },
+  required: ['status', 'summary', 'evidence', 'nextSteps', 'blocker'],
+  additionalProperties: false,
+}
+
+function normalizedText(value) {
+  return typeof value === 'string' && value.length > 0 && value === value.trim()
+}
+
+function normalizedList(value) {
+  return Array.isArray(value) && value.every(normalizedText)
+}
+
+function validateReport(report) {
+  if (report === null || typeof report !== 'object' || Array.isArray(report)) {
+    throw new Error('Ralph child returned no structured round report')
+  }
+  if (!normalizedText(report.summary)) {
+    throw new Error('Ralph round report summary must be non-empty and normalized')
+  }
+  if (!normalizedList(report.evidence) || !normalizedList(report.nextSteps)) {
+    throw new Error('Ralph round report evidence and nextSteps must contain only non-empty normalized strings')
+  }
+  if (typeof report.blocker !== 'string' || report.blocker !== report.blocker.trim()) {
+    throw new Error('Ralph round report blocker must be a normalized string')
+  }
+  switch (report.status) {
+    case 'continue':
+      if (report.nextSteps.length === 0 || report.blocker !== '') {
+        throw new Error('a continuing Ralph report needs nextSteps and an empty blocker')
+      }
+      break
+    case 'complete':
+      if (report.evidence.length === 0 || report.nextSteps.length !== 0 || report.blocker !== '') {
+        throw new Error('a complete Ralph report needs evidence, no nextSteps, and an empty blocker')
+      }
+      break
+    case 'blocked':
+      if (!normalizedText(report.blocker)) {
+        throw new Error('a blocked Ralph report needs a concrete blocker')
+      }
+      break
+    default:
+      throw new Error('Ralph round report status is invalid')
+  }
+  const serialized = JSON.stringify(report)
+  if (serialized.length > args.maxHandoffChars) {
+    throw new Error('Ralph round report exceeds maxHandoffChars (' + serialized.length + ' > ' + args.maxHandoffChars + ')')
+  }
+  return report
+}
+
+let previous
+phase('Fresh-agent rounds')
+for (let round = 1; round <= args.maxRounds; round += 1) {
+  const prior = previous === undefined ? '(none — this is the first round)' : JSON.stringify(previous)
+  const prompt = [
+    'You are one fresh worker in a foreground Ralph loop. You receive no parent conversation and no prior child session. Do not call the ralph tool: this round already is its worker.',
+    'Immutable objective:\n' + args.objective,
+    'Ralph round: ' + round + ' of ' + args.maxRounds + '.',
+    'The shared workspace and its current working tree are the long-term memory and source of truth. Inspect them before acting, preserve existing work, perform concrete in-scope work, and verify what you change. Treat the previous report only as a bounded handoff; confirm it against the workspace.',
+    'Previous structured handoff:\n' + prior,
+    'Return one report with exact normalized strings. Use status continue with at least one nextSteps entry while useful work remains; complete only with concrete evidence and no nextSteps; blocked only when no meaningful progress is possible without human input or an external-state change. blocker must be empty unless blocked.',
+  ].join('\n\n')
+  const rawReport = await agent(prompt, {
+    label: 'Ralph round ' + round,
+    phase: 'Fresh-agent rounds',
+    schema: reportSchema,
+  })
+  if (rawReport === null) {
+    return { status: 'round-failed', roundsStarted: round, lastReport: previous ?? null }
+  }
+  const report = validateReport(rawReport)
+  if (report.status === 'complete') return { status: 'complete', roundsStarted: round, report }
+  if (report.status === 'blocked') return { status: 'blocked', roundsStarted: round, report }
+  previous = report
+}
+return { status: 'budget-limited', roundsStarted: args.maxRounds, report: previous }
+`,$="Run a foreground fresh-agent Ralph loop toward one immutable objective. Use only when the direct human explicitly asks for Ralph or fresh-agent iteration. Each round opens a new child with no parent conversation or prior child session; the shared workspace is long-term memory, and only a bounded structured report crosses rounds. The call returns when a worker reports completion or a concrete blocker, or at the round limit. Ordinary long-running same-session work belongs to goal tools.";function N(r){const t=r.subagentProvider??"spawn",e=r.maxRounds??256,o=r.maxHandoffChars??16384,a=r.maxResultChars??16384;if(t.length===0||t!==t.trim())throw new TypeError("subagentProvider must be a non-empty normalized string");if(!Number.isSafeInteger(e)||e<1)throw new TypeError("maxRounds must be a positive safe integer");if(!Number.isSafeInteger(o)||o<1)throw new TypeError("maxHandoffChars must be a positive safe integer");if(!Number.isSafeInteger(a)||a<1)throw new TypeError("maxResultChars must be a positive safe integer");return{subagentProvider:t,maxRounds:e,maxHandoffChars:o,maxResultChars:a}}n(N,"resolveConfig");function P(r,t){const e=r??t;if(!Number.isSafeInteger(e)||e<1)throw new TypeError("Ralph maxRounds must be a positive safe integer");if(e>t)throw new TypeError(`Ralph maxRounds ${e} exceeds the deployment ceiling ${t}`);return e}n(P,"resolveMaxRounds");function A(r,t){const e=r.subagents.getProvider(t);if(e===void 0)throw new Error(`Ralph subagent provider "${t}" is not registered`);if(!e.capabilities.outputSchema)throw new Error(`Ralph subagent provider "${t}" does not support structured output`);if(e.inheritsParentContext)throw new Error(`Ralph subagent provider "${t}" inherits parent context; Ralph requires a fresh provider`);return e}n(A,"requireFreshProvider");function b(r){return typeof r=="object"&&r!==null&&!Array.isArray(r)}n(b,"isRecord");function c(r){return typeof r=="string"&&r.length>0&&r===r.trim()}n(c,"normalizedText");function g(r){return Array.isArray(r)&&r.every(c)}n(g,"normalizedList");function d(r,t,e){if(!b(r)||Object.keys(r).sort().join(",")!=="blocker,evidence,nextSteps,status,summary"||r.status!==t||!c(r.summary)||!g(r.evidence)||!g(r.nextSteps)||typeof r.blocker!="string"||r.blocker!==r.blocker.trim())throw new Error("Ralph workflow returned a malformed round report");const o={status:t,summary:r.summary,evidence:r.evidence,nextSteps:r.nextSteps,blocker:r.blocker};if(t==="continue"&&(o.nextSteps.length===0||o.blocker!==""))throw new Error("Ralph workflow returned an invalid continuing report");if(t==="complete"&&(o.evidence.length===0||o.nextSteps.length!==0||o.blocker!==""))throw new Error("Ralph workflow returned an invalid completion report");if(t==="blocked"&&!c(o.blocker))throw new Error("Ralph workflow returned an invalid blocked report");const a=JSON.stringify(o).length;if(a>e)throw new Error(`Ralph workflow returned an oversized handoff (${a} > ${e})`);return o}n(d,"readReport");function O(r,t,e){if(!b(r)||typeof r.roundsStarted!="number"||!Number.isSafeInteger(r.roundsStarted)||r.roundsStarted<1||r.roundsStarted>t)throw new Error("Ralph workflow returned a malformed terminal result");const o=r.roundsStarted;switch(r.status){case"complete":if(Object.keys(r).sort().join(",")!=="report,roundsStarted,status")throw new Error("Ralph workflow returned a malformed terminal result");return{status:"complete",roundsStarted:o,report:d(r.report,"complete",e)};case"blocked":if(Object.keys(r).sort().join(",")!=="report,roundsStarted,status")throw new Error("Ralph workflow returned a malformed terminal result");return{status:"blocked",roundsStarted:o,report:d(r.report,"blocked",e)};case"budget-limited":if(Object.keys(r).sort().join(",")!=="report,roundsStarted,status")throw new Error("Ralph workflow returned a malformed terminal result");if(o!==t)throw new Error("Ralph workflow returned budget-limited before the round limit");return{status:"budget-limited",roundsStarted:o,report:d(r.report,"continue",e)};case"round-failed":if(Object.keys(r).sort().join(",")!=="lastReport,roundsStarted,status")throw new Error("Ralph workflow returned a malformed terminal result");if(o===1){if(r.lastReport!==null)throw new Error("Ralph workflow returned an invalid first-round failure");return{status:"round-failed",roundsStarted:o}}if(r.lastReport===null)throw new Error("Ralph workflow returned a round failure without its last handoff");return{status:"round-failed",roundsStarted:o,lastReport:d(r.lastReport,"continue",e)};default:throw new Error("Ralph workflow returned an unknown terminal status")}}n(O,"readRunResult");function I(r){switch(r.stopReason){case"completed":return;case"cancelled":return`Ralph workflow was cancelled${r.error===void 0?"":` (${r.error})`}`;case"error":return`Ralph workflow failed: ${r.error??"unknown error"}`;default:return`Ralph workflow ended abnormally (${String(r.stopReason)})`}}n(I,"stopReasonError");const R=`
+… [truncated]`;function y(r,t){return r.length<=t?r:t<=14?R.slice(0,t):`${r.slice(0,t-14)}${R}`}n(y,"boundResult");function z(r,t){const e=`${r.roundsStarted} round${r.roundsStarted===1?"":"s"}`;let o;switch(r.status){case"complete":o=`Ralph worker reported completion after ${e}.
+Final report:
+${JSON.stringify(r.report,null,2)}`;break;case"blocked":o=`Ralph worker reported a blocker after ${e}.
+Final report:
+${JSON.stringify(r.report,null,2)}`;break;case"budget-limited":o=`Ralph reached its ${e} limit; the worker reported work remaining.
+Final report:
+${JSON.stringify(r.report,null,2)}`;break}return y(o,t)}n(z,"renderResult");const C={runId:{type:"string",required:!0},agentsStarted:{type:"integer",required:!0},result:{type:"json",required:!0}};function _(r,t){const e=`Ralph round ${r.roundsStarted} child failed before producing a structured report.`;return y(r.lastReport===void 0?`${e}
+No previous handoff was available.`:`${e}
+Last successful handoff:
+${JSON.stringify(r.lastReport,null,2)}`,t)}n(_,"renderRoundFailure");function F(r){return{card:"generic",title:"ralph",rawInput:r.objective}}n(F,"presentCall");function L(r,t){return{card:"generic"}}n(L,"presentResult");function H(r,t){const e=N(t);r.systemPrompt.section({name:"tool:ralph",order:116,text:"Use the ralph tool ONLY when the direct human explicitly asks for a Ralph loop or fresh-agent iterative execution. Each Ralph round starts a fresh child with no conversation seed and uses the shared workspace as durable memory. Completion and blockers are worker reports, not independent evaluation. Use same-session goal tools for ordinary long-running objectives, and plain subagents or workflows for bounded delegation and fan-out."}),r.tools.register(v({name:"ralph",description:$,parameters:{objective:{type:"string",required:!0,description:"The immutable completion objective for every fresh Ralph round."},maxRounds:{type:"number",description:"Optional positive safe-integer round cap, bounded by the deployment ceiling."}},output:{schema:{type:"object",additionalProperties:!1,properties:C},render:n((o,a)=>[{type:"text",text:z(a.result,e.maxResultChars)}],"render")},async execute(o,a){const h=a.agent;if(h===void 0)throw new Error("Ralph tool requires a calling agent (exec.agent was undefined)");const f=o.objective.trim();if(f.length===0)throw new Error("Ralph objective must be a non-empty string");const l=P(o.maxRounds,e.maxRounds);A(r,e.subagentProvider);const s=r.workflowEngine.start({script:T,meta:j,args:{objective:f,maxRounds:l,maxHandoffChars:e.maxHandoffChars},subagentProvider:e.subagentProvider,maxTotalAgents:l,parent:h,signal:a.signal}),m=n(()=>{s.cancel("parent step aborted")},"onAbort");a.signal.addEventListener("abort",m,{once:!0}),a.signal.aborted&&s.cancel("parent step aborted");try{const u=await s.result,w=I(u);if(w!==void 0)throw new Error(w);const p=O(u.value,l,e.maxHandoffChars);if(p.status==="round-failed")throw new Error(_(p,e.maxResultChars));return{runId:s.id,agentsStarted:u.agentsStarted,result:p}}finally{a.signal.removeEventListener("abort",m),await s.dispose()}},presentCall:F,presentResult:L}))}n(H,"apply");export{x as Config,H as apply,S as inject,E as name};

package/node_modules/@deepseek-ai/dsh-tool-ralph/lib/invariant.js

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

package/node_modules/@deepseek-ai/dsh-tool-ralph/package.json

@@ -0,0 +1 @@
+{"name":"@deepseek-ai/dsh-tool-ralph","version":"0.0.8","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":{"@deepseek-ai/dsh-agent":"^0.0.8","@deepseek-ai/dsh-invariants":"^0.0.8","@deepseek-ai/dsh-llm":"^0.0.8","@deepseek-ai/dsh-system-prompt":"^0.0.8","@deepseek-ai/dsh-subagent":"^0.0.8","@deepseek-ai/dsh-workflow":"^0.0.8","@deepseek-ai/dsh-tools":"^0.0.8","@deepseek-ai/cordis":"^4.0.1"},"dependencies":{"@deepseek-ai/schemastery":"^3.18.1"}}

package/node_modules/@deepseek-ai/dsh-tool-skill/lib/index.js

@@ -0,0 +1,4 @@
+var I=Object.defineProperty;var l=(e,t)=>I(e,"name",{value:t,configurable:!0});import{createHash as j}from"node:crypto";import b from"@deepseek-ai/schemastery";import{defineTool as q}from"@deepseek-ai/dsh-tools";import{createUserMessage as g}from"@deepseek-ai/dsh-llm";import{escapeText as T,isModelInvocable as y,isSkillName as _,isUserInvocable as $,renderSkillContent as w}from"@deepseek-ai/dsh-skill";const C="tool-skill",L=["agents","tools","skills"],A=500;function D(e,t){return e.map(i=>({name:i.name,description:B(i.description,t)}))}l(D,"catalogSourceEntries");const M=b.object({catalogDescriptionMaxLength:b.number().default(A)});function S(e,t={}){const i=t.catalogDescriptionMaxLength??A;F("catalogDescriptionMaxLength",i,3);const a=q({name:"skill",description:"Load the full instructions for an available skill. Call this with the exact skill name from the session skill catalog before acting on a task that names or clearly matches that skill.",parameters:{name:{type:"string",required:!0,description:"The exact skill name from the available skills list."}},output:{schema:{type:"object",additionalProperties:!1,properties:{name:{type:"string",required:!0},provider:{type:"string",required:!0},resourceBase:{oneOf:[{type:"object",additionalProperties:!1,properties:{kind:{type:"string",required:!0,const:"directory"},path:{type:"string",required:!0}}},{type:"object",additionalProperties:!1,properties:{kind:{type:"string",required:!0,const:"url"},url:{type:"string",required:!0}}},{type:"object",additionalProperties:!1,properties:{kind:{type:"string",required:!0,const:"opaque"},description:{type:"string",required:!0}}}]},content:{type:"string",required:!0}}},render:l((s,n)=>[{type:"text",text:w(n)}],"render")},async execute(s,n){if(!_(s.name))throw new Error(`invalid skill name "${s.name}"`);const d={cwd:n.agent?.session.header.cwd,signal:n.signal,scope:n.agent},o=(await e.skills.list(d)).find(u=>u.name===s.name);if(!o)throw new Error(`skill "${s.name}" is unknown or no longer available`);if(!y(o))throw new Error(`skill "${s.name}" is not available for model invocation`);const r=await e.skills.get(s.name,d);if(!r)throw new Error(`skill "${s.name}" is unknown or no longer available`);if(!y(r))throw new Error(`skill "${s.name}" is not available for model invocation`);return{name:r.name,provider:r.provider,...r.resourceBase!==void 0?{resourceBase:{...r.resourceBase}}:{},content:r.content}},presentCall(s){return{card:"generic",title:`Load skill ${s.name}`,kind:"read",rawInput:s.name}}});e.tools.register(a),e.on("agent/pre-step",async({agent:s,messages:n,signal:d},o)=>{const r=await o();if(r.kind==="reject")return r;const u=G(n);if(u.length===0)return r;d.throwIfAborted();const k={cwd:s.session.header.cwd,signal:d,scope:s},p=[];for(const f of u){const c=await e.skills.get(f,k);if(d.throwIfAborted(),c===void 0||!$(c))continue;const h={kind:"skill-invocation",name:f,form:"instructions"};p.push(g({content:[{type:"text",text:w(c)}],source:h}))}return p.length===0?r:{kind:"enter",messages:[...r.messages,...p]}}),e.on("agent/pre-step",async({agent:s,signal:n},d)=>{const o=await d();if(o.kind==="reject")return o;n.throwIfAborted();const r=e.tools.get(a.name,s)===a?await e.skills.snapshot({cwd:s.session.header.cwd,signal:n,scope:s}):{skills:[],complete:!0};if(n.throwIfAborted(),!r.complete)return o;const u=r.skills.filter(y),k=D(u,i),p=v(k),f=U(s),c=z(o.messages);if(f.visibleDigest===p)return c===void 0?o:{kind:"enter",messages:o.messages.filter(m=>m.id!==c.message.id)};if(c!==void 0&&v(c.entries)===p)return o;if(!f.published&&u.length===0)return c===void 0?o:{kind:"enter",messages:o.messages.filter(m=>m.id!==c.message.id)};const h=f.published?P(k):N(k);return{kind:"enter",messages:c===void 0?[...o.messages,h]:o.messages.map(m=>m.id===c.message.id?h:m)}})}l(S,"apply");function N(e){return g({content:[{type:"text",text:["<system-reminder>","A skill is a reusable set of task-specific instructions. The following skills are available in this session:","","<available_skills>",...E(e),"</available_skills>","","If the user names a skill, or the task clearly matches a skill's description, call the `skill` tool with the exact skill name before taking task actions. Load all applicable skills, then follow their full instructions. This catalog contains summaries only; do not infer or follow a skill's instructions until it has been loaded.","A user may also invoke a skill directly; its <skill_content> block then appears in this conversation. Follow it, and do not call the `skill` tool again for that skill.","</system-reminder>"].join(`
+`)}],source:{kind:"skill-catalog",form:"catalog",entries:e}})}l(N,"renderCatalogMessage");function P(e){const t=e.length===0?["No skills are currently available through the `skill` tool. Do not use names from earlier skill catalogs.","A user may still invoke a skill directly; its <skill_content> block then appears in this conversation. Follow it, and do not call the `skill` tool for it."]:["Use only names in this replacement catalog. If the user names a listed skill, or the task clearly matches its description, call the `skill` tool with the exact name before acting.","A user may also invoke a skill directly; its <skill_content> block then appears in this conversation. Follow it, and do not call the `skill` tool again for that skill."];return g({content:[{type:"text",text:["<system-reminder>","The available skill catalog changed. This complete catalog replaces every earlier available-skills list in this session:","","<available_skills>",...E(e),"</available_skills>","",...t,"</system-reminder>"].join(`
+`)}],source:{kind:"skill-catalog",form:"catalog",update:!0,entries:e}})}l(P,"renderCatalogUpdate");function E(e){return e.map(t=>`- \`${t.name}\`: ${T(t.description)}`)}l(E,"renderCatalogEntries");function v(e){const t=e.map(i=>JSON.stringify([i.name,i.description])).join(`
+`);return j("sha256").update(t).digest("hex")}l(v,"digestCatalogEntries");function x(e){const t=e.entries;if(!Array.isArray(t))return;const i=[];for(const a of t){if(typeof a!="object"||a===null)return;const{name:s,description:n}=a;if(typeof s!="string"||s===""||typeof n!="string")return;i.push({name:s,description:n})}return i}l(x,"readCatalogEntries");function U(e){const t=new Set(e.session.surface.nodes),i=e.session.events;let a=!1;for(let s=i.length-1;s>=0;s-=1){const n=i[s];if(n.type!=="user/message"||n.data.source.kind!=="skill-catalog")continue;const d=x(n.data.source);if(d===void 0)continue;const o=v(d);if(a=!0,t.has(n.seq))return{visibleDigest:o,published:a}}return{published:a}}l(U,"catalogHistory");function z(e){for(const t of e){if(t.source.kind!=="skill-catalog")continue;const i=x(t.source);if(i!==void 0)return{message:t,entries:i}}}l(z,"catalogMessage");function B(e,t){const i=e.replaceAll(/\s+/g," ").trim();return i.length<=t?i:`${i.slice(0,t-3)}...`}l(B,"catalogDescription");function F(e,t,i=1){if(!Number.isInteger(t)||t<i)throw new Error(`tool-skill: ${e} must be an integer greater than or equal to ${i}`)}l(F,"assertPositiveInteger");const O=/(^|\s)\/([a-z0-9]+(?:-[a-z0-9]+)*)(?=\s|$)/g;function G(e){const t=[];for(const i of e)if(i.source.kind==="user"){for(const a of i.content)if(a.type==="text")for(const s of a.text.matchAll(O)){const n=s[2];n!==void 0&&!t.includes(n)&&t.push(n)}}return t}l(G,"invokedSkillNames");export{M as Config,S as apply,L as inject,C as name};

package/node_modules/@deepseek-ai/dsh-tool-skill/lib/invariant.js

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

package/node_modules/@deepseek-ai/dsh-tool-skill/package.json

@@ -0,0 +1 @@
+{"name":"@deepseek-ai/dsh-tool-skill","version":"0.0.8","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":{"@deepseek-ai/dsh-invariants":"^0.0.8","@deepseek-ai/dsh-llm":"^0.0.8","@deepseek-ai/dsh-skill":"^0.0.8","@deepseek-ai/dsh-agent":"^0.0.8","@deepseek-ai/dsh-tools":"^0.0.8","@deepseek-ai/cordis":"^4.0.1"},"dependencies":{"@deepseek-ai/schemastery":"^3.18.1"}}

package/node_modules/@deepseek-ai/dsh-tool-str-replace-editor/lib/index.js

@@ -0,0 +1,13 @@
+var I=Object.defineProperty;var d=(e,t)=>I(e,"name",{value:t,configurable:!0});import{isAbsolute as P}from"node:path";import _ from"@deepseek-ai/schemastery";import{FsError as u}from"@deepseek-ai/dsh-fs";import{sandboxDenialMarker as F}from"@deepseek-ai/dsh-sandbox";import{defineTool as O}from"@deepseek-ai/dsh-tools";const N="<response clipped><NOTE>To save on context only part of this file has been shown to you. You should retry this tool after you have searched inside the file with `grep -n` in order to find the line numbers of what you are looking for.</NOTE>",$="\nCustom editing tool for viewing, creating and editing files\n* State is persistent across command calls and discussions with the user\n* If `path` is a file, `view` displays the result of applying `cat -n`. If `path` is a directory, `view` lists non-hidden files and directories up to 2 levels deep\n* The `create` command cannot be used if the specified `path` already exists as a file\n* If a `command` generates a long output, it will be truncated and marked with `<response clipped>`\n\nNotes for using the `str_replace` command:\n* The `old_str` parameter should match EXACTLY one or more consecutive lines from the original file. Be mindful of whitespaces!\n* If the `old_str` parameter is not unique in the file, the replacement will not be performed. Make sure to include enough context in `old_str` to make it unique\n* The `new_str` parameter should contain the edited lines that should replace the `old_str`\n".trim();function E(e,t){return e.length<=t?e:e.slice(0,t)+N}d(E,"maybeTruncate");function S(e,t){return e<t?-1:e>t?1:0}d(S,"codepointCompare");function k(e,t){const r=[];let i=0;for(;;){const n=e.indexOf(t,i);if(n<0)return r;r.push(n),i=n+t.length}}d(k,"matchOffsets");function A(e,t){let r=1,i=0;return t.map(n=>{for(;i<n;)e[i]===`
+`&&(r+=1),i+=1;return r})}d(A,"lineNumbersAt");var D=class{static{d(this,"MutationPolicy")}policy;constructor(e){if(this.policy=e.fs.sandboxMode===void 0?void 0:e.get("sandboxPolicy"),e.fs.sandboxMode!==void 0&&this.policy===void 0)throw new Error("tool-str-replace-editor: the mounted filesystem confines but ctx.sandboxPolicy is missing")}resolve(e){return this.policy?.resolve({...e.agent===void 0?{}:{session:e.agent.session}})}mapError(e,t){if(!(e instanceof u)||e.code!=="FS_SANDBOX_DENIED")return e;const r=t.mode;return new u(F(r),"FS_SANDBOX_DENIED",{cause:e})}};async function v(e,t,r){if(t.trim().length===0)throw new Error("path must be a non-empty string");if(!P(t))throw new Error(`The path ${t} is not an absolute path, it should start with \`/\`. Maybe you meant /${t}?`);return e.fs.resolve(t,{signal:r})}d(v,"resolveTarget");async function g(e,t,r,i){const n=await e.fs.stat(t,i.signal);if(n===void 0)throw e.emit("fs/observed",t,{kind:"absent"},i),new u(`The path ${t.displayPath} does not exist. Please provide a valid path.`,"FS_NOT_FOUND");if(n.type==="directory"&&r!=="view")throw new u(`The path ${t.displayPath} is a directory and only the \`view\` command can be used on directories`,"FS_NOT_REGULAR_FILE");return n}d(g,"statExisting");function b(e,t,r,i=!0){if(e===void 0)throw new Error(`Parameter \`${t}\` is required for command: ${r}`);if(!i&&e.length===0)throw new Error(`Parameter \`${t}\` is empty for command: ${r}`);return e}d(b,"requiredForCommand");function q(e,t,r,i){const n=t.split(`
+`);let s=n,a=1,o,l=`Here's the content of ${e} with line numbers (which has a total of ${n.length} lines)`;if(i!==void 0){const[f,c]=i;if(i.length!==2||f===void 0||c===void 0||!i.every(Number.isInteger))throw new Error("Invalid `view_range`. It should be a list of two integers.");if(a=f,o=c,a<1||a>n.length)throw new Error(`Invalid \`view_range\`: [${i.join(", ")}]. Its first element \`${a}\` should be within the range of lines of the file: [1, ${n.length}]`);if(o>n.length)throw new Error(`Invalid \`view_range\`: [${i.join(", ")}]. Its second element \`${o}\` should be smaller than the number of lines in the file: \`${n.length}\``);if(o!==-1&&o<a)throw new Error(`Invalid \`view_range\`: [${i.join(", ")}]. Its second element \`${o}\` should be larger or equal than its first \`${a}\``);s=o===-1?n.slice(a-1):n.slice(a-1,o),l+=` with view_range=[${a}, ${o}]`}const h=s.map((f,c)=>`${String(a+c).padStart(6," ")}  ${f}`).join(`
+`);return E(`${l}:
+${h}
+`,r)}d(q,"formatFileView");async function C(e,t,r,i){async function n(o,l){const h=await e.fs.listDir(o,i.signal),f=[];for(const c of h.filter(p=>!p.name.startsWith(".")&&p.name!=="node_modules"&&p.name!=="__pycache__")){const p=c.type==="directory"?"d":c.type==="file"?"f":"?";f.push(`${p}	${c.target.displayPath}`),c.type==="directory"&&l<2&&f.push(...await n(c.target,l+1))}return f}d(n,"visit");const s=[`d	${t.displayPath}`,...await n(t,1)];s.sort((o,l)=>S(o.slice(o.indexOf("	")+1),l.slice(l.indexOf("	")+1)));const a=E(s.join(`
+`)+`
+`,r);return`Here're the files and directories up to 2 levels deep in ${t.displayPath}, excluding hidden items, node_modules, and Python cache directories:
+${a}
+`}d(C,"listDirectory");async function M(e,t,r,i,n){const s=await v(e,t,n.signal),a=await g(e,s,"view",n);if(a.type==="directory"){if(r!==void 0)throw new Error("The `view_range` parameter is not allowed when `path` points to a directory.");return C(e,s,i,n)}if(a.type!=="file")throw new u(`cannot view "${s.displayPath}": not a regular file or directory`,"FS_NOT_REGULAR_FILE");const o=await e.fs.readText(s,n.signal);return e.emit("fs/observed",s,{kind:"present",version:a.version},n),q(s.displayPath,o,i,r)}d(M,"viewPath");async function U(e,t,r,i,n){const s=b(i,"file_text","create"),a=t.resolve(n),o=await v(e,r,n.signal);if(await e.fs.stat(o,n.signal)!==void 0)throw new Error(`File already exists at: ${o.displayPath}. Cannot overwrite files using command \`create\`.`);const l=await e.waterfall("fs/write-intent",o,n,()=>({kind:"createIfAbsent"}));let h;try{h=await e.fs.writeText(o,s,l,n.signal,a)}catch(f){throw t.mapError(f,a)}return e.emit("fs/observed",o,{kind:"present",version:h.version},n),`New file created successfully at: ${o.displayPath}`}d(U,"createFile");async function j(e,t,r,i,n,s){const a=t.resolve(s),o=await v(e,r,s.signal),l=await e.waterfall("fs/edit-intent",o,s,()=>{}),h=b(i,"old_str","str_replace",!1),f=n??"",c=await g(e,o,"str_replace",s);if(c.type!=="file")throw new u(`cannot edit "${o.displayPath}": not a regular file`,"FS_NOT_REGULAR_FILE");const p=await e.fs.readText(o,s.signal),w=k(p,h),m=w[0];if(m===void 0)throw new u(`No replacement was performed, old_str \`${h}\` did not appear verbatim in ${o.displayPath}.`,"FS_EDIT_NOT_FOUND");if(w.length>1)throw new u(`No replacement was performed. Multiple occurrences of old_str \`${h}\` in lines [${A(p,w).join(", ")}]. Please ensure it is unique`,"FS_AMBIGUOUS_EDIT");let y;try{y=await e.fs.writeText(o,p.slice(0,m)+f+p.slice(m+h.length),l===void 0?{kind:"replaceIfVersion",version:c.version}:{kind:"replaceIfVersion",version:l.version},s.signal,a)}catch(T){throw t.mapError(T,a)}return e.emit("fs/observed",o,{kind:"present",version:y.version},s),`The file ${o.displayPath} has been edited successfully.`}d(j,"replaceInFile");async function L(e,t,r,i,n,s){if(i===void 0)throw new Error("Parameter `insert_line` is required for command: insert");const a=b(n,"new_str","insert"),o=t.resolve(s),l=await v(e,r,s.signal),h=await e.waterfall("fs/edit-intent",l,s,()=>{}),f=await g(e,l,"insert",s);if(f.type!=="file")throw new u(`cannot insert into "${l.displayPath}": not a regular file`,"FS_NOT_REGULAR_FILE");const c=(await e.fs.readText(l,s.signal)).split(`
+`);if(!Number.isInteger(i)||i<0||i>c.length)throw new Error(`Invalid \`insert_line\` parameter: ${i}. It should be within the range of lines of the file: [0, ${c.length}]`);const p=[...c.slice(0,i),...a.split(`
+`),...c.slice(i)].join(`
+`),w=h===void 0?{kind:"replaceIfVersion",version:f.version}:{kind:"replaceIfVersion",version:h.version};let m;try{m=await e.fs.writeText(l,p,w,s.signal,o)}catch(y){throw t.mapError(y,o)}return e.emit("fs/observed",l,{kind:"present",version:m.version},s),`The file ${l.displayPath} has been edited successfully.`}d(L,"insertInFile");function R(e){switch(e.command){case"view":return{card:"generic",title:`view ${e.path}`,kind:"read",locations:[{path:e.path}]};case"create":return{card:"diff",title:`create ${e.path}`,diffs:[{path:e.path,oldText:null,newText:e.file_text??""}],locations:[{path:e.path}]};case"str_replace":return{card:"diff",title:`str_replace ${e.path}`,diffs:[{path:e.path,oldText:e.old_str??null,newText:e.new_str??""}],locations:[{path:e.path}]};case"insert":return{card:"generic",title:`insert ${e.path}`,kind:"edit",locations:[{path:e.path,...e.insert_line===void 0?{}:{line:Math.max(1,e.insert_line+1)}}]}}}d(R,"presentEditorCall");function V(e,t){const r=new D(e);e.tools.register(O({name:"str_replace_editor",description:t.description,parameters:{command:{type:"string",required:!0,enum:["view","create","str_replace","insert"],description:"The commands to run. Allowed options are: `view`, `create`, `str_replace`, `insert`."},path:{type:"string",required:!0,description:"Absolute path to file or directory, e.g. `/repo/file.py` or `/repo`."},file_text:{type:"string",description:"Required parameter of `create` command, with the content of the file to be created."},insert_line:{type:"integer",description:"Required parameter of `insert` command. The `new_str` will be inserted AFTER the line `insert_line` of `path`."},new_str:{type:"string",description:"Optional parameter of `str_replace` command containing the new string (if not given, no string will be added). Required parameter of `insert` command containing the string to insert."},old_str:{type:"string",description:"Required parameter of `str_replace` command containing the string in `path` to replace."},view_range:{type:"array",items:{type:"integer"},description:"Optional parameter of `view` command when `path` points to a file. If none is given, the full file is shown. If provided, the file will be shown in the indicated line number range, e.g. [11, 12] will show lines 11 and 12. Indexing at 1 to start. Setting `[start_line, -1]` shows all lines from `start_line` to the end of the file."}},output:{schema:{type:"string"},render:d((i,n)=>[{type:"text",text:n}],"render")},async execute(i,n){switch(i.command){case"view":return M(e,i.path,i.view_range,t.maxOutputChars,n);case"create":return U(e,r,i.path,i.file_text,n);case"str_replace":return j(e,r,i.path,i.old_str,i.new_str,n);case"insert":return L(e,r,i.path,i.insert_line,i.new_str,n)}},presentCall:R}))}d(V,"registerStrReplaceEditor");const G="tool-str-replace-editor",B=["tools","fs"],X=_.object({maxOutputChars:_.number().default(16e3),description:_.string().default($)});function H(e,t){const r={maxOutputChars:t.maxOutputChars??16e3,description:t.description??$};if(!Number.isSafeInteger(r.maxOutputChars)||r.maxOutputChars<=0)throw new Error("tool-str-replace-editor: maxOutputChars must be a positive safe integer");if(r.description.trim().length===0)throw new Error("tool-str-replace-editor: description must be non-empty");V(e,r)}d(H,"apply");export{X as Config,H as apply,B as inject,G as name};

package/node_modules/@deepseek-ai/dsh-tool-str-replace-editor/lib/invariant.js

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

package/node_modules/@deepseek-ai/dsh-tool-str-replace-editor/package.json

@@ -0,0 +1 @@
+{"name":"@deepseek-ai/dsh-tool-str-replace-editor","version":"0.0.8","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"},"./package.json":"./package.json"},"license":"MIT","peerDependencies":{"@deepseek-ai/dsh-fs":"^0.0.8","@deepseek-ai/dsh-invariants":"^0.0.8","@deepseek-ai/dsh-sandbox":"^0.0.8","@deepseek-ai/dsh-sandbox-policy":"^0.0.8","@deepseek-ai/dsh-tools":"^0.0.8","@deepseek-ai/cordis":"^4.0.1"},"dependencies":{"@deepseek-ai/schemastery":"^3.18.1"}}

package/node_modules/@deepseek-ai/dsh-tool-subagent/lib/index.js

@@ -0,0 +1,3 @@
+var w=Object.defineProperty;var o=(t,e)=>w(t,"name",{value:e,configurable:!0});import n from"@deepseek-ai/schemastery";import{defineTool as v}from"@deepseek-ai/dsh-tools";import{assertSubagentMaxDepth as j,settleRun as x}from"@deepseek-ai/dsh-subagent";const _="tool-subagent",E=["tools","subagents","systemPrompt"],I=116.5,D=n.object({provider:n.string().required(),toolName:n.string().default("subagent"),enableRunInBackground:n.boolean().default(!0),backgroundMode:n.union(["one-shot","continuable"]).default("one-shot"),agentOptions:n.object({provider:n.string(),model:n.string(),maxTokens:n.number().step(1).min(1).max(Number.MAX_SAFE_INTEGER)}).default(void 0),persona:n.string(),toolFilter:n.object({allow:n.array(n.string()).default(void 0),deny:n.array(n.string()).default(void 0)}).default(void 0),maxDepth:n.union([n.natural().max(Number.MAX_SAFE_INTEGER),n.const("provider-managed")]).default(3)});function S(t){return t.filter(e=>typeof e=="object"&&e!==null&&!Array.isArray(e)&&e.type==="text"&&typeof e.text=="string").map(e=>e.text).join("")}o(S,"outputValueText");async function T(t,e){try{return await x(await t)}catch(r){return e.aborted?{status:"killed"}:{status:"failed",detail:String(r)}}}o(T,"settleStart");function R(t){switch(t.stopReason){case"completed":return;case"aborted":return"subagent run was cancelled";case"error":return"subagent run failed";case"max-tokens":return"subagent run hit its token limit before finishing";case"refusal":return"subagent declined the task";default:return`subagent run ended abnormally (${String(t.stopReason)})`}}o(R,"stopReasonError");function $(t,e){const r=e.filter(a=>a.type==="text").map(a=>a.text).join("");return r.length===0?t:`${t}
+Partial output before the run ended:
+${r}`}o($,"withPartialText");async function P(t){const[e]=await Promise.allSettled([t.result.then(a=>{const u=R(a);if(u!==void 0)throw new Error($(u,a.output));return{kind:"foreground",runId:t.id,output:a.output}})]),[r]=await Promise.allSettled([Promise.resolve().then(()=>t.dispose())]);if(e.status==="rejected")throw r.status==="rejected"?new AggregateError([e.reason,r.reason],`subagent run failed: ${String(e.reason)}; dispose failed: ${String(r.reason)}`):e.reason;if(r.status==="rejected")throw r.reason;return e.value}o(P,"settleForegroundRun");function q(t){return t?{description:"Delegate a task to a subagent that inherits this conversation: a child agent seeded with all completed turns so far (it does not see the current in-flight turn). Use this when the subtask builds on this conversation's context — a follow-up analysis, a review, a continuation — without consuming this conversation's context for the work itself. You receive its result, not its intermediate steps.",promptDescription:"The task for the subagent. It already sees this conversation's completed turns, so build on them freely and state only what is new."}:{description:"Delegate a self-contained task to a subagent (a separate agent that works in its own context) to offload focused, independent work — research, a scoped implementation, an analysis — so it does not consume this conversation's context. The subagent returns its result, not its intermediate steps. Give it a complete, standalone prompt: it does not see this conversation.",promptDescription:"The complete, self-contained task for the subagent. It does not share this conversation's context, so include everything it needs."}}o(q,"providerWording");function F(t,e){if(!e.backgroundEnabled){if(t.run_in_background===!0)throw new Error("run_in_background is disabled for this tool instance (enableRunInBackground: false)");return{runInBackground:!1}}return{runInBackground:t.run_in_background??e.continuable}}o(F,"resolveDelegationRun");function A(t,e){if(e.maxDepth!=="provider-managed"&&j(e.maxDepth),e.toolFilter!==void 0&&e.toolFilter.allow===void 0&&e.toolFilter.deny===void 0)throw new Error("tool-subagent: `toolFilter` is configured but names neither `allow` nor `deny` — remove the key or fill the filter");const r=e.enableRunInBackground!==!1,a=(e.backgroundMode??"one-shot")==="continuable",u=e.toolName??"subagent";let d;const g=o(s=>{if(typeof e.maxDepth=="number"&&!s.capabilities.depthLimit)throw new Error(`tool-subagent: provider "${s.name}" cannot enforce maxDepth (no depthLimit capability) — set maxDepth: 'provider-managed' to leave the recursion budget to the provider`);const m=q(s.inheritsParentContext);if(a&&s.prepareContinuable===void 0)throw new Error(`tool-subagent: provider "${s.name}" does not support \`backgroundMode: continuable\``);d=t.tools.register(v({name:u,description:m.description+(r?a?" This tool runs in the background by default, immediately returns a durable subagent id, and keeps the child conversation available for later turns. When that run settles, the runtime sends the parent a notice containing its outcome and any final assistant message; `send_message` starts a later turn in the same child conversation. Set `run_in_background: false` only when your next action depends on receiving the result.":" This call waits for the result by default. Set `run_in_background: true` to return a job id; collect with `job_output` and stop with `job_kill`.":" This call waits for the subagent and returns its result."),parameters:{description:{type:"string",required:!0,description:"A short (3-5 word) description of the delegated task, for display."},prompt:{type:"string",required:!0,description:m.promptDescription},...r?{run_in_background:{type:"boolean",description:a?"Whether to run in the background and return a durable subagent id immediately. Defaults to true. Set false to wait for the result when your next action depends on it.":"Whether to run as a background job and return its id. Defaults to false; collect with job_output or stop with job_kill."}}:{}},output:{schema:{oneOf:[{type:"object",additionalProperties:!1,properties:{kind:{type:"string",required:!0,const:"background"},jobId:{type:"string",required:!0}}},{type:"object",additionalProperties:!1,properties:{kind:{type:"string",required:!0,const:"continuable"},subagentId:{type:"string",required:!0}}},{type:"object",additionalProperties:!1,properties:{kind:{type:"string",required:!0,const:"foreground"},runId:{type:"string",required:!0},output:{type:"array",required:!0,items:{type:"json"}}}}]},render:o((l,i)=>[{type:"text",text:i.kind==="background"?`started background subagent task ${i.jobId}`:i.kind==="continuable"?`started subagent ${i.subagentId}`:S(i.output)}],"render")},isConcurrencySafe:o(()=>!0,"isConcurrencySafe"),async execute(l,i){const p=i.agent;if(!p)throw new Error("subagent tool requires a calling agent (exec.agent was undefined)");const f=typeof e.maxDepth=="number"?e.maxDepth:void 0,c={label:l.description,prompt:[{type:"text",text:l.prompt}],parent:p,...e.agentOptions!==void 0?{agentOptions:e.agentOptions}:{},...e.persona!==void 0?{persona:e.persona}:{},...e.toolFilter!==void 0?{toolFilter:e.toolFilter}:{},...f!==void 0?{maxDepth:f}:{}};if(F(l,{backgroundEnabled:r,continuable:a}).runInBackground){if(a)return{kind:"continuable",subagentId:(await t.subagents.startContinuable({provider:e.provider,label:l.description,request:c,signal:i.signal})).childId};const y=t.get("jobs");if(y===void 0)throw new Error("background jobs unavailable: load @deepseek-ai/dsh-jobs and @deepseek-ai/dsh-tool-jobs");return{kind:"background",jobId:y.start({kind:"subagent",label:l.description,owner:p,run:o(()=>{const b=new AbortController;return{cancel:o(k=>{b.abort(k??"background subagent task killed")},"cancel"),done:T(t.subagents.start(e.provider,{...c,signal:b.signal}),b.signal)}},"run")})}}return P(await t.subagents.start(e.provider,{...c,signal:i.signal}))}}))},"mount");t.on("subagent/provider-added",s=>{s.name===e.provider&&d===void 0&&g(s)}),t.on("subagent/provider-removed",s=>{s!==e.provider||d===void 0||(d(),d=void 0)});const h=t.subagents.getProvider(e.provider);h!==void 0?g(h):t.logger.info(`subagent provider "${e.provider}" not registered yet; the "${e.toolName??"subagent"}" tool will register when it appears`),r&&a&&t.systemPrompt.section({name:`tool:${u}`,order:I,text:o(s=>d===void 0||t.tools.get(u,s.scope)===void 0?"":`Use ${u} in the background by default. Start independent delegations together in one assistant message and continue useful work while they run. Set \`run_in_background: false\` only when your next action depends on that subagent's result. When a background run settles, the runtime sends you a notice containing its outcome and any final assistant message.`,"text")})}o(A,"apply");export{D as Config,A as apply,E as inject,_ as name};

package/node_modules/@deepseek-ai/dsh-tool-subagent/lib/invariant.js

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

package/node_modules/@deepseek-ai/dsh-tool-subagent/package.json

@@ -0,0 +1 @@
+{"name":"@deepseek-ai/dsh-tool-subagent","version":"0.0.8","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":{"@deepseek-ai/dsh-agent":"^0.0.8","@deepseek-ai/dsh-llm":"^0.0.8","@deepseek-ai/dsh-invariants":"^0.0.8","@deepseek-ai/dsh-tools":"^0.0.8","@deepseek-ai/dsh-subagent":"^0.0.8","@deepseek-ai/dsh-jobs":"^0.0.8","@deepseek-ai/dsh-system-prompt":"^0.0.8","@deepseek-ai/cordis":"^4.0.1"},"dependencies":{"@deepseek-ai/schemastery":"^3.18.1"}}

package/node_modules/@deepseek-ai/dsh-tool-subagent-control/lib/index.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var s=(t,e)=>u(t,"name",{value:e,configurable:!0});import{defineTool as a}from"@deepseek-ai/dsh-tools";import{SessionId as i}from"@deepseek-ai/dsh-session";const d="tool-subagent-control",g=["tools","subagents"];function l(t){t.tools.register(a({name:"send_message",description:"Send a message to a background subagent by its subagent id, continuing the same conversation. It becomes the subagent's next turn: if it is still working, the message waits until its current turn finishes, so it cannot redirect work already underway. This call returns no answer from the subagent — only confirmation that the message was delivered — so use it to give it more work. A failure means the message was NOT delivered.",parameters:{subagent_id:{type:"string",required:!0,description:"The subagent id returned when the background subagent was started."},message:{type:"string",required:!0,description:"The message to deliver to the subagent."}},output:{schema:{type:"object",additionalProperties:!1,properties:{messageId:{type:"string",required:!0}}},render:s((e,n)=>[{type:"text",text:`message queued as the next turn for subagent ${e.subagent_id}`}],"render")},async execute(e,n){const r=n.agent;if(!r)throw new Error("send_message requires a calling agent (exec.agent was undefined)");const o=[{type:"text",text:e.message}];return{messageId:await t.subagents.followup(r,i(e.subagent_id),o,{source:{kind:"coordinator",form:"relay",senderSessionId:r.id},signal:n.signal})}}})),t.tools.register(a({name:"interrupt_agent",description:"Request cancellation of a background agent's current turn by its agent id. The target may be your direct child or a deeper agent created under you. Only the current turn stops: messages already queued for the agent stay parked until a later send_message, agents it started keep running, and the agent itself stays available for follow-ups. This call returns as soon as the stop request is accepted, so the target may keep running briefly; interrupting an agent that already finished is an accepted no-op.",parameters:{agent_id:{type:"string",required:!0,description:"The agent id of the running agent to interrupt."}},output:{schema:{type:"object",additionalProperties:!1,properties:{accepted:{type:"boolean",required:!0}}},render:s((e,n)=>[{type:"text",text:`interrupt requested for agent ${e.agent_id}`}],"render")},execute(e,n){const r=n.agent;if(!r)throw new Error("interrupt_agent requires a calling agent (exec.agent was undefined)");return t.subagents.interrupt(i(e.agent_id),{kind:"ancestor",agent:r}),Promise.resolve({accepted:!0})}}))}s(l,"apply");export{l as apply,g as inject,d as name};

package/node_modules/@deepseek-ai/dsh-tool-subagent-control/lib/invariant.js

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

package/node_modules/@deepseek-ai/dsh-tool-subagent-control/lib/types/index.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var s=(t,e)=>u(t,"name",{value:e,configurable:!0});import{defineTool as a}from"@deepseek-ai/dsh-tools";import{SessionId as i}from"@deepseek-ai/dsh-session";export const name="tool-subagent-control",inject=["tools","subagents"];export function apply(t){t.tools.register(a({name:"send_message",description:"Send a message to a background subagent by its subagent id, continuing the same conversation. It becomes the subagent's next turn: if it is still working, the message waits until its current turn finishes, so it cannot redirect work already underway. This call returns no answer from the subagent — only confirmation that the message was delivered — so use it to give it more work. A failure means the message was NOT delivered.",parameters:{subagent_id:{type:"string",required:!0,description:"The subagent id returned when the background subagent was started."},message:{type:"string",required:!0,description:"The message to deliver to the subagent."}},output:{schema:{type:"object",additionalProperties:!1,properties:{messageId:{type:"string",required:!0}}},render:s((e,n)=>[{type:"text",text:`message queued as the next turn for subagent ${e.subagent_id}`}],"render")},async execute(e,n){const r=n.agent;if(!r)throw new Error("send_message requires a calling agent (exec.agent was undefined)");const o=[{type:"text",text:e.message}];return{messageId:await t.subagents.followup(r,i(e.subagent_id),o,{source:{kind:"coordinator",form:"relay",senderSessionId:r.id},signal:n.signal})}}})),t.tools.register(a({name:"interrupt_agent",description:"Request cancellation of a background agent's current turn by its agent id. The target may be your direct child or a deeper agent created under you. Only the current turn stops: messages already queued for the agent stay parked until a later send_message, agents it started keep running, and the agent itself stays available for follow-ups. This call returns as soon as the stop request is accepted, so the target may keep running briefly; interrupting an agent that already finished is an accepted no-op.",parameters:{agent_id:{type:"string",required:!0,description:"The agent id of the running agent to interrupt."}},output:{schema:{type:"object",additionalProperties:!1,properties:{accepted:{type:"boolean",required:!0}}},render:s((e,n)=>[{type:"text",text:`interrupt requested for agent ${e.agent_id}`}],"render")},execute(e,n){const r=n.agent;if(!r)throw new Error("interrupt_agent requires a calling agent (exec.agent was undefined)");return t.subagents.interrupt(i(e.agent_id),{kind:"ancestor",agent:r}),Promise.resolve({accepted:!0})}}))}s(apply,"apply");

package/node_modules/@deepseek-ai/dsh-tool-subagent-control/lib/types/invariant.js

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