@agentrq/agentrq-ws 0.7.7 → 0.8.0

package/README.md

@@ -20,7 +20,7 @@ npx -y @agentrq/agentrq-ws@latest workspace
 
 An agent talks to its workspace over MCP, which is the right shape for an agent
 and the wrong shape for a person: every call is a JSON envelope, and every
-answer is tokens the agent pays for. The same eleven tools are underneath this
+answer is tokens the agent pays for. The same fifteen tools are underneath this
 CLI, but a command is a line of shell and the answer is plain text.
 
 It is also the difference between reading an attachment and *handling* one — see
@@ -52,6 +52,10 @@ Node 20.6 or newer.
 | `memory load [name]` | Read a workspace memory (defaults to the index) |
 | `memory save [name] --content …` | Replace a workspace memory |
 | `memory delete [name]` | Delete a workspace memory |
+| `skill search [q]` | Find the skills this workspace can use, by name or description; `--limit`/`--offset` page |
+| `skill load <uri>` | Read a skill file (`skill://<name>` reads its `SKILL.md`) |
+| `skill save <uri> --content …` | Replace a file of one of this workspace's skills |
+| `skill delete <uri>` | Delete a skill (`skill://<name>`) or one of its files |
 | `event publish <name>` | Publish a named event |
 | `ask <taskId> <message>` | Ask the human a question and wait |
 | `tools` | List the tools this workspace server offers |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentrq/agentrq-ws",
-  "version": "0.7.7",
+  "version": "0.8.0",
   "description": "AgentRQ workspace client \u2014 drive an AgentRQ workspace from the command line, using the workspace's own .mcp.json",
   "keywords": [
     "agentrq",

package/src/commands.js

@@ -265,6 +265,56 @@ export const COMMANDS = [
       return ctx.client.callTool('deleteMemory', { name: ctx.positionals[0] })
     },
   },
+  {
+    path: ['skill', 'search'],
+    summary: 'Find the skills this workspace can use, by name or description',
+    usage: 'agentrq-ws skill search [q] [--limit N] [--offset N]',
+    options: {
+      limit: { type: 'string', description: 'How many to return (at most 100; default all)' },
+      offset: { type: 'string', description: 'How many matches to skip' },
+    },
+    async run(ctx) {
+      const args = {}
+      if (ctx.positionals.length) args.q = ctx.positionals.join(' ')
+      for (const key of ['limit', 'offset']) {
+        if (ctx.values[key] === undefined) continue
+        const n = Number(ctx.values[key])
+        if (!Number.isInteger(n) || n < 0) throw new UserError(`--${key} must be a whole number, 0 or more`)
+        args[key] = n
+      }
+      return ctx.client.callTool('searchSkills', args)
+    },
+  },
+  {
+    path: ['skill', 'load'],
+    summary: 'Read a skill file (skill://<name> reads its SKILL.md)',
+    usage: 'agentrq-ws skill load <uri>',
+    async run(ctx) {
+      return ctx.client.callTool('loadSkill', { uri: requirePositional(ctx.positionals, 0, 'uri') })
+    },
+  },
+  {
+    path: ['skill', 'save'],
+    summary: 'Replace a file of one of this workspace\'s skills',
+    usage: 'agentrq-ws skill save <uri> --content TEXT|@file|-',
+    options: {
+      content: { type: 'string', short: 'C', description: 'The full new content (@file or - for stdin)' },
+    },
+    async run(ctx) {
+      const uri = requirePositional(ctx.positionals, 0, 'uri')
+      if (ctx.values.content === undefined) throw new UserError('--content is required (use @file or - to read from stdin)')
+      const content = await resolveText(ctx.values.content, { stdin: ctx.stdin, what: 'the skill file' })
+      return ctx.client.callTool('saveSkill', { uri, content })
+    },
+  },
+  {
+    path: ['skill', 'delete'],
+    summary: 'Delete a skill (skill://<name>) or one of its files',
+    usage: 'agentrq-ws skill delete <uri>',
+    async run(ctx) {
+      return ctx.client.callTool('deleteSkill', { uri: requirePositional(ctx.positionals, 0, 'uri') })
+    },
+  },
   {
     path: ['event', 'publish'],
     summary: 'Publish a named event',