@spoons-and-mirrors/iam 0.1.1 → 0.1.2

package/README.md

@@ -1,43 +1,21 @@
 # IAM Plugin for OpenCode
 
-Inter-agent messaging for parallel subagents.
+Lets parallel subagents talk to each other. No configuration needed — just install and it works.
 
-## The `iam` Tool
+## What It Does
 
-| Action | Parameters | Description |
-|--------|------------|-------------|
-| `announce` | `message` | Announce what you're working on |
-| `sessions` | - | List agents and what they're working on |
-| `read` | - | Read your messages (marks as read) |
-| `write` | `to`, `message` | Send a message |
-
-## Examples
-
-```
-iam(action="announce", message="Implementing user authentication")
-iam(action="sessions")
-iam(action="read")
-iam(action="write", to="agentA", message="What approach are you using?")
-```
+When you spawn multiple agents with the `task` tool, they can:
+- **Announce** what they're working on
+- **Discover** other agents and see what they're doing
+- **Message** each other to coordinate work
+- Get **notified** when new messages arrive
 
 ## How It Works
 
-- **In-memory** - fast, no file clutter, resets on restart
-- **Auto-discovery** - agents register on first iam use, see each other immediately
-- **Simple aliases** - agents get friendly names (agentA, agentB, ...) instead of session IDs
-- **Urgent alerts** - recipients get `<system-reminder>` when they have unread mail
-
-## Files
+Agents get friendly names (agentA, agentB, ...) and automatically discover each other. When an agent has unread messages, they get an urgent notification.
 
-```
-iam/
-├── index.ts      # Plugin + tool + hooks
-├── prompt.ts     # LLM-facing prompts
-├── logger.ts     # Logs to .logs/iam.log
-├── PROGRESS.md   # Development history
-└── README.md
-```
+The system lives in memory — fast, no file clutter, resets on restart.
 
-## Logs
+## Debug Logs
 
-Debug logs written to `.logs/iam.log` (clears on restart). Shows all tool calls, messages sent, sessions registered, and notifications injected.
+For troubleshooting, check `.logs/iam.log` (clears on restart). Shows all tool calls, messages, and notifications.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAiJjD,QAAA,MAAM,MAAM,EAAE,MAmKb,CAAA;AAED,eAAe,MAAM,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAkJjD,QAAA,MAAM,MAAM,EAAE,MAyKb,CAAA;AAED,eAAe,MAAM,CAAA"}

package/dist/index.js

@@ -53,10 +53,23 @@ function readResult(messages, unreadCount) {
 var WRITE_MISSING_TO = `Error: 'to' parameter is required for action="write".`;
 var WRITE_MISSING_MESSAGE = `Error: 'message' parameter is required for action="write".`;
 var ANNOUNCE_MISSING_MESSAGE = `Error: 'message' parameter is required for action="announce". Describe what you're working on.`;
-function announceResult(alias) {
-  return `Announced! Other agents will see your description when they list sessions.
-
-You are: ${alias}`;
+function announceResult(alias, parallelAgents) {
+  const lines = [`Announced! Other agents will see your description when they list sessions.`, ``, `You are: ${alias}`];
+  if (parallelAgents.length > 0) {
+    lines.push(``);
+    lines.push(`--- Parallel Agents ---`);
+    for (const agent of parallelAgents) {
+      if (agent.description) {
+        lines.push(`• ${agent.alias} is working on: ${agent.description}`);
+      } else {
+        lines.push(`• ${agent.alias} is running (hasn't announced yet)`);
+      }
+    }
+    lines.push(``);
+    lines.push(`Use action="write" to coordinate with them if needed.`);
+  }
+  return lines.join(`
+`);
 }
 function writeUnknownRecipient(to, known) {
   const list = known.length > 0 ? `Known agents: ${known.join(", ")}` : "No agents available yet.";
@@ -277,7 +290,11 @@ var plugin = async () => {
               }
               setDescription(sessionId, args.message);
               const alias = getAlias(sessionId);
-              return announceResult(alias);
+              const parallelAgents = getKnownAgents(sessionId).map((agentAlias) => ({
+                alias: agentAlias,
+                description: getDescription(agentAlias)
+              }));
+              return announceResult(alias, parallelAgents);
             }
             default:
               return unknownAction(args.action);
@@ -334,7 +351,7 @@ var plugin = async () => {
     }
   };
 };
-var inbox_default = plugin;
+var iam_default = plugin;
 export {
-  inbox_default as default
+  iam_default as default
 };

package/dist/prompt.d.ts

@@ -19,7 +19,11 @@ export declare function readResult(messages: {
 export declare const WRITE_MISSING_TO = "Error: 'to' parameter is required for action=\"write\".";
 export declare const WRITE_MISSING_MESSAGE = "Error: 'message' parameter is required for action=\"write\".";
 export declare const ANNOUNCE_MISSING_MESSAGE = "Error: 'message' parameter is required for action=\"announce\". Describe what you're working on.";
-export declare function announceResult(alias: string): string;
+export interface ParallelAgent {
+    alias: string;
+    description?: string;
+}
+export declare function announceResult(alias: string, parallelAgents: ParallelAgent[]): string;
 export declare function writeUnknownRecipient(to: string, known: string[]): string;
 export declare function writeResult(to: string, messageId: string): string;
 export declare function unknownAction(action: string): string;

package/dist/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../prompt.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB,2XAMgD,CAAC;AAE9E,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAMX,eAAO,MAAM,cAAc,0JAIS,CAAC;AAErC,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAC,EAAE,GAAG,MAAM,CAYtF;AAED,eAAO,MAAM,UAAU,mCAAmC,CAAC;AAE3D,wBAAgB,UAAU,CACxB,QAAQ,EAAE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAC,EAAE,EAC1E,WAAW,EAAE,MAAM,GAClB,MAAM,CAiBR;AAED,eAAO,MAAM,gBAAgB,4DAA0D,CAAC;AACxF,eAAO,MAAM,qBAAqB,iEAA+D,CAAC;AAClG,eAAO,MAAM,wBAAwB,qGAAmG,CAAC;AAEzI,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAMzE;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAMD,eAAO,MAAM,aAAa,mkBAezB,CAAC;AAMF,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK9D"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../prompt.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB,2XAMgD,CAAC;AAE9E,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAMX,eAAO,MAAM,cAAc,0JAIS,CAAC;AAErC,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAC,EAAE,GAAG,MAAM,CAYtF;AAED,eAAO,MAAM,UAAU,mCAAmC,CAAC;AAE3D,wBAAgB,UAAU,CACxB,QAAQ,EAAE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAC,EAAE,EAC1E,WAAW,EAAE,MAAM,GAClB,MAAM,CAiBR;AAED,eAAO,MAAM,gBAAgB,4DAA0D,CAAC;AACxF,eAAO,MAAM,qBAAqB,iEAA+D,CAAC;AAClG,eAAO,MAAM,wBAAwB,qGAAmG,CAAC;AAEzI,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,GAAG,MAAM,CAkBrF;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAMzE;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAMD,eAAO,MAAM,aAAa,mkBAezB,CAAC;AAMF,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAK9D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spoons-and-mirrors/iam",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Inter-agent messaging for OpenCode parallel subagents",
   "type": "module",
   "main": "dist/index.js",