paperclip-plugin-mattermost 0.14.0 → 0.15.0

package/README.md

@@ -17,6 +17,7 @@ Your [Paperclip](https://github.com/paperclipai/paperclip) agents as Mattermost
 - **Agents work with agents.** An agent mentioning another agent starts it, and it answers in the thread. After a set number of agent-to-agent messages in a thread (10 by default, set in settings), they pause until a person replies.
 - **Work channels.** For an investigation, incident or project, an agent opens a private channel (`inc-checkout-5xx`), pulls in the people and agents it needs, and ties it to a Paperclip task. Task comments and status changes show up in the channel. When the task is done or cancelled, the channel is archived and the outcome is posted back where the work was asked for.
 - **Ask first.** Some actions wait for an approver to click Approve: `@channel`, `@all` and `@here`, public channels, and adding people to a channel the agent didn't create. Agents can't change or archive channels they didn't create, remove anyone, or touch team and server settings.
+- **Agent computer requests.** With the Agent computer plugin installed, an agent that needs a person in its browser (a login, 2FA, a password) posts in the thread it is working in, or the approvals channel, with a link to take over.
 - **One install, many companies.** Each Paperclip company connects its own Mattermost, with its own settings, bots and state.
 
 ## Requirements
@@ -82,7 +83,7 @@ PAPERCLIP_REF=<commit> node build.mjs   # build for another Paperclip version
 Bump `version` in `package.json` and `src/manifest.ts`, commit, then tag and push:
 
 ```bash
-git tag -a v0.14.0 -m v0.14.0 && git push origin main v0.14.0
+git tag -a v0.15.0 -m v0.15.0 && git push origin main v0.15.0
 ```
 
 GitHub Actions builds, tests and publishes to npm through npm trusted publishing, so no npm token is involved.

package/dist/manifest.js

@@ -74,7 +74,7 @@ var route = (routeKey, method, path) => ({ routeKey, method, path, auth: "agent"
 var manifest = {
   id: "mattermost-bridge",
   apiVersion: 1,
-  version: "0.14.0",
+  version: "0.15.0",
   displayName: "Mattermost",
   description: "Every agent becomes its own Mattermost bot. DM an agent or mention it in a channel and it answers in the thread, showing its steps as it works; follow-ups continue the conversation. Paperclip approvals arrive with Approve / Reject buttons.",
   author: "Haseeb Azhar",

package/dist/worker.js

@@ -46211,7 +46211,7 @@ var route = (routeKey, method, path3) => ({ routeKey, method, path: path3, auth:
 var manifest = {
   id: "mattermost-bridge",
   apiVersion: 1,
-  version: "0.14.0",
+  version: "0.15.0",
   displayName: "Mattermost",
   description: "Every agent becomes its own Mattermost bot. DM an agent or mention it in a channel and it answers in the thread, showing its steps as it works; follow-ups continue the conversation. Paperclip approvals arrive with Approve / Reject buttons.",
   author: "Haseeb Azhar",
@@ -46366,6 +46366,8 @@ var Tenant = class {
   work = null;
   key = "";
   approvers = /* @__PURE__ */ new Map();
+  paperclipUrl = "";
+  approvalsChannel = "";
   timers = [];
   agents() {
     const companyId = this.companyId;
@@ -46555,7 +46557,7 @@ var Tenant = class {
       task: async (issueId) => await ctx.issues.get(issueId, companyId),
       comments: async (issueId) => (await ctx.issues.listComments(issueId, companyId)).map((c) => ({ id: c.id, body: c.body, authorAgentId: c.authorAgentId }))
     });
-    Object.assign(this, { manager, bots: roster, bridge, approvals, cards, actions, work, key, approvers });
+    Object.assign(this, { manager, bots: roster, bridge, approvals, cards, actions, work, key, approvers, paperclipUrl, approvalsChannel });
     this.status = `connecting to ${url2} as @${manager.botUsername}`;
     detached(() => {
       manager.connect(onPosted);
@@ -46602,6 +46604,17 @@ var Tenant = class {
     if (!this.actions) return { status: 503, body: { error: `Mattermost is not connected for this company (${this.status})` } };
     return this.actions.handle(agentId, routeKey, params, input2);
   }
+  /** The Agent computer plugin: an agent wants a person in its browser. Posted where the agent is working. */
+  async computerNeedsPerson(p) {
+    if (!this.manager || !this.bots || !this.bridge || !p.agentId) return;
+    const poster = this.poster(this.manager, this.bots);
+    const where = this.bridge.activeThread(p.agentId) ?? (this.approvalsChannel ? await poster.channel(this.approvalsChannel).then((id) => id ? { channelId: id, rootId: "" } : null) : null);
+    if (!where) return;
+    const link = this.paperclipUrl && p.path ? `${this.paperclipUrl}${p.path}` : null;
+    const on = p.url ? ` on ${p.url}` : "";
+    const message2 = p.kind === "password" ? `:key: I ${p.reason ?? "need a password"}${on}. ${link ? `[Enter it here](${link})` : "Enter it from Computers in Paperclip"}: it goes straight into the page, and I never see it.` : `:raising_hand: I need a person in my browser${on}: ${p.reason ?? "I am stuck"}. ${link ? `[Take over](${link})` : "Take over from Computers in Paperclip"}, then hand it back.`;
+    await poster.post(p.agentId, where, message2, { ...FROM_PAPERCLIP });
+  }
   async notify(req, notice) {
     if (notice && req.user_id && req.channel_id) {
       await this.manager?.request("POST", "/posts/ephemeral", { user_id: req.user_id, post: { channel_id: req.channel_id, message: notice } }).catch(() => {
@@ -46742,6 +46755,9 @@ var plugin = definePlugin({
     ctx.events.on("issue.updated", (e) => quietly("could not follow a task update", async () => {
       if (e.entityId) await tenants.get(e.companyId)?.work?.updated(e.entityId);
     }));
+    ctx.events.on("plugin.agent-computer.needs-person", (e) => quietly("could not post a computer help request", async () => {
+      await tenants.get(e.companyId)?.computerNeedsPerson(e.payload ?? {});
+    }));
     ctx.events.on("approval.decided", (e) => quietly("could not update approval", async () => {
       if (e.entityId) await tenants.get(e.companyId)?.approvals?.decided(e.entityId);
     }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paperclip-plugin-mattermost",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Paperclip agents in Mattermost: a bot per agent, live progress, files, approval and decision buttons, and per-person access, for each Paperclip company.",
   "type": "module",
   "license": "MIT",