@agensis/agensis-agent 0.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agensis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# @agensis/agensis-agent
+
+Run a local [agensis](https://agensis.io) workspace agent daemon from your machine.
+
+It connects to an agensis workspace over WebSocket, receives `@mention` jobs,
+runs your configured coding CLI in the local folder, and posts results back to
+the workspace. The installed command is `agensis`.
+
+## Install
+
+```sh
+npm install -g @agensis/agensis-agent
+```
+
+Or run without installing:
+
+```sh
+npx @agensis/agensis-agent agensis --help
+```
+
+## Connect an agent
+
+In agensis, open the agent profile, choose **Connect**, and copy the generated
+command. It looks like:
+
+```sh
+agensis connect \
+  --url https://agensis.io \
+  --token aga_... \
+  --workspace <workspace-id> \
+  --agent <agent-id> \
+  --handle general \
+  --name general \
+  --model claude-haiku-4-5 \
+  --permission-mode default
+```
+
+Run it from the folder where the coding CLI should execute:
+
+```sh
+cd /path/to/repo
+agensis connect --url ... --token ... --workspace ... --agent ...
+```
+
+The command stays connected, sends heartbeats, accepts queued jobs, and exits on
+Ctrl+C.
+
+## Options
+
+Required:
+
+- `--url <url>` — agensis app/backend URL, e.g. `https://agensis.io` or `http://localhost:5173`
+- `--token <token>` — agent connection token from agensis
+- `--workspace <id>` — workspace id
+- `--agent <id>` — workspace agent id
+
+Optional:
+
+- `--handle <name>` — mention handle used in channels
+- `--name <name>` — display name
+- `--cwd <path>` — folder where the coding CLI runs
+- `--coding-cmd <command>` — command used for jobs (default `claude -p`)
+- `--model <id>` — default model passed to supported coding CLIs
+- `--permission-mode <mode>` — `default`, `accept_edits`, or `yolo`
+- `--yolo` / `--no-sandbox` — alias for `--permission-mode yolo`
+- `--timeout-ms <ms>` — kill a job after this time (default `1800000`)
+- `--heartbeat-ms <ms>` — heartbeat interval (default `15000`)
+- `--once` — run one queued job then exit
+- `--version` — print the CLI version
+- `--help` — show help
+
+Environment fallbacks: `AGENSIS_URL`, `AGENSIS_TOKEN`,
+`AGENSIS_WORKSPACE` / `AGENSIS_WORKSPACE_ID`, `AGENSIS_AGENT` / `AGENSIS_AGENT_ID`,
+`AGENSIS_HANDLE`, `AGENSIS_NAME`, `AGENSIS_CWD`, `AGENSIS_CODING_CMD` / `CODING_CMD`,
+`AGENSIS_MODEL` / `CLAUDE_MODEL`, `AGENSIS_PERMISSION_MODE`, `AGENSIS_TIMEOUT_MS`,
+`AGENSIS_HEARTBEAT_MS`, `AGENSIS_ONCE=1`.
+
+## Security
+
+The daemon runs on your machine and executes the configured coding command in
+the working directory you start it in. Your local credentials and filesystem
+stay local; agensis sends the job payload and receives the result. Treat it like
+any local coding agent with access to that folder.
+
+Keep `aga_...` tokens out of shared logs and shell history. Generate a fresh
+token from agensis if one is exposed.
+
+## Requirements
+
+- Node.js >= 18
+
+## License
+
+[MIT](./LICENSE)

package/bin/agensis.mjs

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import I from"node:process";import U from"node:os";import l from"node:process";import F from"ws";import{spawn as K}from"node:child_process";function G(n){let e=Math.max(0,Math.round(n/1e3)),t=Math.floor(e/60),r=e%60;return t>0?`${t}m ${r}s`:`${r}s`}var H=50*1024*1024;function O(n){let{cmd:e,args:t=[],cwd:r,timeoutMs:o=0,label:s="working",heartbeatMs:c=15e3,now:u=Date.now,log:a=console,signal:f,onData:m}=n||{};return new Promise(h=>{if(f?.aborted){h({status:null,stdout:"",stderr:"",aborted:!0,error:new Error("cancelled")});return}let d;try{d=K(e,t,{cwd:r,detached:!0})}catch(g){h({status:null,stdout:"",stderr:"",error:g});return}let p="",i="";d.stdout?.setEncoding("utf8"),d.stderr?.setEncoding("utf8");let S=(g,b)=>g.length>=H?g:g+b;d.stdout?.on("data",g=>{if(p=S(p,g),m)try{m(g)}catch{}}),d.stderr?.on("data",g=>i=S(i,g));let w=u(),k=c>0?setInterval(()=>{a.log(`  \u2026 still ${s} (${G(u()-w)}) \u2014 Ctrl+C to cancel`)},c):null;k?.unref&&k.unref();let A=g=>{if(d.pid!=null)try{process.kill(-d.pid,g)}catch{try{d.kill(g)}catch{}}},x=!1,v=o>0?setTimeout(()=>{x=!0,A("SIGKILL")},o):null;v?.unref&&v.unref();let $=!1,M=null,T=()=>{$=!0,A("SIGTERM"),M=setTimeout(()=>A("SIGKILL"),3e3),M?.unref&&M.unref()};f&&f.addEventListener("abort",T,{once:!0});let D=(g,b)=>{k&&clearInterval(k),v&&clearTimeout(v),M&&clearTimeout(M),f&&f.removeEventListener("abort",T),h({status:g,stdout:p,stderr:i,aborted:$,error:b||($?new Error("cancelled"):x?new Error(`timed out after ${G(o)}`):null)})};d.on("error",g=>D(null,g)),d.on("close",g=>D(g,null))})}function R(n={}){let{runJob:e,concurrency:t=1}=n,r=[],o=null,s=!1,c=[];function u(i){return i==null?!1:o&&!o.cancelled&&o.job.key===i?!0:r.some(S=>S.key===i)}async function a(){if(s)return;for(s=!0;r.length;){let S=r.shift(),w=new AbortController;o={job:S,controller:w};try{await e(S,{signal:w.signal})}catch{}o=null}s=!1;let i=c;c=[];for(let S of i)S()}function f(i){if(i&&i.key!=null&&u(i.key))return{accepted:!1,deduped:!0,position:0,startedImmediately:!1};let S=!o&&r.length===0;r.push(i);let w=r.length+(o?1:0);return a(),{accepted:!0,deduped:!1,position:w,startedImmediately:S}}function m(i){return o?(o.cancelled=!0,o.controller.abort(i||"cancelled"),!0):!1}function h(){return r.length}function d(){return o?1:0}function p(){return!o&&r.length===0?Promise.resolve():new Promise(i=>c.push(i))}return{enqueue:f,cancelActive:m,has:u,size:h,active:d,idle:p}}var j=30*60*1e3,V=15*1e3,Q="claude-opus-4-8",N="0.0.5";async function W(n={}){let e=Y(n),t=!1,r=null,o=null,s=null,c=0,u=null,a=null,f="",m=()=>{t=!0,o&&clearTimeout(o),s&&clearInterval(s);try{r?.close()}catch{}u&&u()};a=R({runJob:async(d,p)=>{await ee(e,d,p),e.once&&m()}}),l.once("SIGINT",m),l.once("SIGTERM",m);let h=()=>{if(t)return;let d=X(e.url,e.token,e);f="",E(`Connecting to ${d.replace(e.token,"redacted")}`),r=new F(d),r.on("open",()=>{E(`Connected. Registering @${e.handle||"agent"} from ${e.cwd}`),_(r,{action:"agent_register",workspaceId:e.workspace,agentId:e.agent,handle:e.handle,name:e.name,host:U.hostname(),cwd:e.cwd,metadata:{codingCmd:e.codingCmd,model:e.model,permissionMode:e.permissionMode,permissionFlags:C(e.permissionMode),once:e.once,runtime:"agensis",version:N}}),s=setInterval(()=>{_(r,{action:"agent_heartbeat",metadata:{busy:a.active()>0,queueSize:a.size(),cwd:e.cwd,model:e.model,permissionMode:e.permissionMode,permissionFlags:C(e.permissionMode)}})},e.heartbeatMs),s.unref&&s.unref()}),r.on("message",p=>{let i=ae(p);if(i){if(i.type==="agent_registered"){P(e,i.agent),E(`Registered as ${i.connection?.name||e.name} on ${i.connection?.host||U.hostname()}`);return}if(i.type==="agent_config"){P(e,i.agent),E(`Updated config for @${e.handle||"agent"}: model=${e.model}, permission=${e.permissionMode}`);return}if(i.type==="error"){E(`Server rejected request: ${i.message||"unknown error"}`);return}if(i.type==="agent_job"&&i.job?.id){let S=a.enqueue({...i.job,key:i.job.id,ws:r});S.accepted&&(c+=1,E(`Queued job ${i.job.id} at position ${S.position}`),e.once&&a.idle().then(()=>m()))}}}),r.on("close",(p,i)=>{if(E(`Socket closed (${p||"no-code"}${i?`: ${i}`:""})`),s&&(clearInterval(s),s=null),f==="ECONNREFUSED"&&Z(e.url)){E("Local agent backend is not running on 127.0.0.1:3142."),E("Start it in another terminal with: npm run backend"),E("Then rerun this connect command."),m();return}e.once&&c>0&&a.active()===0&&a.size()===0&&m(),!(t||e.once)&&(o=setTimeout(h,2e3),o.unref&&o.unref())}),r.on("error",p=>{f=p?.code||"",E(`Socket error: ${p?.message||p}`)})};h(),await new Promise(d=>{let p=setInterval(async()=>{e.once&&c>0&&a.active()===0&&a.size()===0&&m(),t&&m()},500);u=()=>{clearInterval(p),d()}}),u=null,l.off("SIGINT",m),l.off("SIGTERM",m)}function Y(n){let e={url:String(n.url||n.baseUrl||l.env.AGENSIS_URL||"").trim(),token:String(n.token||l.env.AGENSIS_TOKEN||"").trim(),workspace:String(n.workspace||n.workspaceId||l.env.AGENSIS_WORKSPACE||l.env.AGENSIS_WORKSPACE_ID||"").trim(),agent:String(n.agent||n.agentId||l.env.AGENSIS_AGENT||l.env.AGENSIS_AGENT_ID||"").trim(),handle:J(n.handle||l.env.AGENSIS_HANDLE||n.name||l.env.AGENSIS_NAME||"agent"),name:String(n.name||l.env.AGENSIS_NAME||n.handle||l.env.AGENSIS_HANDLE||"agensis Agent").trim(),cwd:String(n.cwd||l.env.AGENSIS_CWD||l.cwd()).trim(),codingCmd:String(n.codingCmd||l.env.AGENSIS_CODING_CMD||l.env.CODING_CMD||"claude -p").trim(),model:L(n.model||l.env.AGENSIS_MODEL||l.env.CLAUDE_MODEL||""),permissionMode:y(n.permissionMode||n.permission_mode||n.permission||l.env.AGENSIS_PERMISSION_MODE||"default"),timeoutMs:Number(n.timeoutMs||l.env.AGENSIS_TIMEOUT_MS||j),heartbeatMs:Number(n.heartbeatMs||l.env.AGENSIS_HEARTBEAT_MS||V),once:!!(n.once||l.env.AGENSIS_ONCE==="1"),exitOnOnce:!!n.exitOnOnce},t=[];if(e.url||t.push("--url"),e.token||t.push("--token"),e.workspace||t.push("--workspace"),e.agent||t.push("--agent"),t.length)throw new Error(`Missing required option(s): ${t.join(", ")}`);return e}function X(n,e,t={}){let r=z(n);return r.protocol=r.protocol==="https:"?"wss:":"ws:",r.pathname="/backend/ws",r.search="",r.searchParams.set("agentToken",e),t.workspace&&r.searchParams.set("workspaceId",t.workspace),t.agent&&r.searchParams.set("agentId",t.agent),r.toString()}function z(n){let e=new URL(n);return(e.hostname==="localhost"||e.hostname==="127.0.0.1"||e.hostname==="0.0.0.0")&&e.port==="8888"&&(e.protocol="http:",e.hostname="127.0.0.1",e.port="3142"),e}function Z(n){try{let e=z(n);return(e.hostname==="localhost"||e.hostname==="127.0.0.1"||e.hostname==="0.0.0.0")&&e.port==="3142"}catch{return!1}}async function ee(n,e,{signal:t}){let r=Date.now();E(`Starting job ${e.id}`);let o=te(n,e),s=ne(n,e),c="",u="",a=0,f=(w="")=>{_(e.ws,{action:"agent_job_delta",jobId:e.id,content:w,elapsedMs:Date.now()-r,model:o.model,permissionMode:o.permissionMode,permissionFlags:o.permissionFlags})};f("");let m=setInterval(()=>f(c),1e3);m.unref&&m.unref();let h=await O({cmd:o.cmd,args:[...o.args,s],cwd:n.cwd,timeoutMs:n.timeoutMs,heartbeatMs:n.heartbeatMs,label:"agent job",signal:t,onData:w=>{c+=String(w||""),u=le(`${u}
+${w}`);let k=Date.now();k-a>500&&(a=k,f(c))}});clearInterval(m);let d=String(h.stdout||"").trim(),p=String(h.stderr||"").trim(),i=h.error?h.error.message:h.status===0?"":p||`Command exited with status ${h.status}`,S=d||(i?"":p)||u||"";_(e.ws,{action:"agent_job_result",jobId:e.id,response:S,error:i,elapsedMs:Date.now()-r,model:o.model,permissionMode:o.permissionMode,permissionFlags:o.permissionFlags}),E(`Finished job ${e.id} in ${Math.round((Date.now()-r)/1e3)}s`),n.once&&(E("One-shot job complete; exiting."),setTimeout(()=>l.exit(0),150))}function ne(n,e){let t=e.agent||{},r=Array.isArray(t.skills)?t.skills.join(", "):String(t.skills||""),o=Array.isArray(t.tools)?t.tools.join(", "):String(t.tools||""),s=q(n,e),c=B(n,e);return["You are running as a local agensis workspace agent daemon.",`Workspace: ${e.workspaceId||n.workspace}`,`Channel session: ${e.sessionId||""}`,`Agent: ${t.name||n.name} (@${t.handle||n.handle})`,`Requested model: ${s}`,`Permission mode: ${c}`,t.description?`Description:
+${t.description}`:"",t.soul?`Soul:
+${t.soul}`:"",t.system_prompt?`System instructions:
+${t.system_prompt}`:"",t.instructions?`Additional instructions:
+${t.instructions}`:"",o?`Enabled tools:
+${o}`:"",r?`Enabled skills:
+${r}`:"","Respond with a clear channel-ready result. If you changed files, summarize the files and verification. If you cannot complete it, say exactly why.","User message:",String(e.prompt||"")].filter(Boolean).join(`
+
+`)}function te(n,e){let{cmd:t,args:r}=ie(n.codingCmd),o=q(n,e),s=B(n,e),c=oe(r),u=C(s);if(re(t)){let a=[...c];return o&&a.push("--model",o),s==="accept_edits"&&a.push("--permission-mode","acceptEdits"),s==="yolo"&&a.push("--dangerously-skip-permissions"),{cmd:t,args:a,model:o,permissionMode:s,permissionFlags:u}}if(se(t)){let a=[...c];return o&&a.push("--model",o),s==="yolo"&&a.push("--sandbox","danger-full-access","--ask-for-approval","never"),{cmd:t,args:a,model:o,permissionMode:s,permissionFlags:u}}return{cmd:t,args:r,model:o,permissionMode:s,permissionFlags:u}}function q(n,e){return L(e?.agent?.model||e?.model||n.model)}function L(n){let e=String(n||"").trim();return!e||e==="auto"||e==="claude-fable-5"?Q:e}function B(n,e){return y(e?.agent?.permissionMode||e?.agent?.permission_mode||e?.permissionMode||e?.permission_mode||n.permissionMode)}function y(n){let e=String(n||"").trim().toLowerCase().replace(/[-\s]+/g,"_");return["yolo","no_sandbox","danger","danger_full_access","dangerously_skip_permissions"].includes(e)?"yolo":["accept_edits","acceptedits","auto_approve","auto_approve_edits"].includes(e)?"accept_edits":"default"}function C(n){return y(n)==="yolo"?["--no-sandbox","--yolo"]:[]}function P(n,e){if(!e||typeof e!="object")return;e.name&&(n.name=String(e.name).trim()||n.name),(e.handle||e.name)&&(n.handle=J(e.handle||e.name||n.handle)),e.model&&(n.model=L(e.model));let t=e.permissionMode||e.permission_mode;t&&(n.permissionMode=y(t))}function oe(n){let e=new Set(["--model","-m","--permission-mode","--sandbox","--ask-for-approval","--approval-policy"]),t=new Set(["--dangerously-skip-permissions","--no-sandbox","--yolo","--accept-edits"]),r=[];for(let o=0;o<n.length;o+=1){let s=n[o],[c]=String(s).split("=",1);if(!t.has(s)){if(e.has(c)){String(s).includes("=")||(o+=1);continue}r.push(s)}}return r}function re(n){return/(^|\/)claude(?:$|\.)/.test(String(n||""))}function se(n){return/(^|\/)codex(?:$|\.)/.test(String(n||""))}function ie(n){let e=[],t="",r="",o=!1;for(let s of n){if(o){t+=s,o=!1;continue}if(s==="\\"){o=!0;continue}if(r){s===r?r="":t+=s;continue}if(s==='"'||s==="'"){r=s;continue}if(/\s/.test(s)){t&&(e.push(t),t="");continue}t+=s}if(t&&e.push(t),!e.length)throw new Error("coding command is empty");return{cmd:e[0],args:e.slice(1)}}function ae(n){try{return JSON.parse(String(n))}catch{return null}}function _(n,e){return!n||n.readyState!==F.OPEN?!1:(n.send(JSON.stringify(e)),!0)}function le(n){return String(n||"").split(/\r?\n/).map(e=>e.trim()).filter(Boolean).slice(-1)[0]||""}function J(n){return String(n||"").trim().toLowerCase().replace(/^@+/,"").replace(/[^a-z0-9_.-]+/g,"-").replace(/^-+|-+$/g,"").slice(0,64)}function E(n){l.stderr.write(`[agensis] ${n}
+`)}function ce(n){let e={command:"connect"},t=[...n],r=t[0];r&&!r.startsWith("-")&&(e.command=t.shift());for(let o=0;o<t.length;o+=1){let s=t[o];if(!s.startsWith("--"))throw new Error(`Unexpected argument: ${s}`);let[c,u]=s.slice(2).split(/=(.*)/s,2),a=c.replace(/-([a-z])/g,(m,h)=>h.toUpperCase());if(a==="help"){e.help=!0;continue}if(a==="version"){e.version=!0;continue}if(a==="once"){e.once=!0;continue}if(a==="yolo"||a==="noSandbox"){e.permissionMode="yolo";continue}if(a==="acceptEdits"){e.permissionMode="accept_edits";continue}let f=u!==void 0?u:t[++o];if(f==null||f.startsWith("--"))throw new Error(`Missing value for --${c}`);e[a]=f}return e}function ue(){return`agensis agent daemon
+
+Usage:
+  agensis --url <workspace-url> --token <token> --workspace <id> --agent <id> [options]
+  agensis connect --url <workspace-url> --token <token> --workspace <id> --agent <id> [options]
+
+Required:
+  --url <url>             agensis app/backend URL, for example https://agensis.io or http://localhost:5173
+  --token <token>         Agent connection token from agensis
+  --workspace <id>        Workspace id
+  --agent <id>            Workspace agent id
+
+Options:
+  --handle <name>         Mention handle used in channels
+  --name <name>           Display name
+  --cwd <path>            Folder where the coding CLI runs
+  --coding-cmd <command>  Command used for jobs, default: claude -p
+  --model <id>            Default model to pass to supported coding CLIs
+  --permission-mode <m>   default, accept_edits, or yolo
+  --yolo                  Alias for --permission-mode yolo
+  --no-sandbox            Alias for --permission-mode yolo
+  --timeout-ms <ms>       Kill a job after this time, default: 1800000
+  --heartbeat-ms <ms>     Local terminal heartbeat interval, default: 15000
+  --once                  Run one queued job then exit
+  --version               Print the CLI version
+  --help                  Show this help
+`}async function de(){let n=ce(I.argv.slice(2));if(n.help){I.stdout.write(ue());return}if(n.version){I.stdout.write(`${N}
+`);return}if(n.command!=="connect")throw new Error(`Unknown command "${n.command}". Use "agensis --url ..." or "agensis connect --url ...".`);n.exitOnOnce=!0,await W(n),n.once&&I.exit(0)}de().catch(n=>{I.stderr.write(`${n?.message||n}
+`),I.exitCode=1});

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@agensis/agensis-agent",
+  "version": "0.0.5",
+  "description": "Run a local agensis workspace agent daemon. Connects to a workspace, receives @mention jobs, runs a configured coding CLI in the local folder, and posts results back to agensis. Ships as a single minified bundle.",
+  "homepage": "https://agensis.io",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jasonkneen/agensis.git",
+    "directory": "agent/agensis-agent"
+  },
+  "bugs": {
+    "url": "https://github.com/jasonkneen/agensis/issues"
+  },
+  "type": "module",
+  "bin": {
+    "agensis": "bin/agensis.mjs",
+    "agensis-agent": "bin/agensis.mjs"
+  },
+  "files": [
+    "bin/agensis.mjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "agensis",
+    "workspace",
+    "agent",
+    "daemon",
+    "claude-code",
+    "codex",
+    "cursor",
+    "coding-agent"
+  ],
+  "dependencies": {
+    "ws": "^8.20.0"
+  },
+  "devDependencies": {
+    "esbuild": "^0.21.5"
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "prepack": "node build.mjs",
+    "pack:dry-run": "npm pack --dry-run"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT"
+}