npm - agent-office - Versions diffs - 0.4.0 → 0.4.2 - Mend

agent-office 0.4.0 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/README.md +6 -0
package/dist/cli.js +26 -0
package/dist/db/postgresql-storage.d.ts +1 -0
package/dist/db/postgresql-storage.js +15 -0
package/dist/db/sqlite-storage.d.ts +1 -0
package/dist/db/sqlite-storage.js +16 -0
package/dist/db/storage-base.d.ts +1 -0
package/dist/db/storage.d.ts +1 -0
package/dist/server/routes.js +32 -4
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -207,6 +207,12 @@ agent-office worker set-status --clear <token>
 # Send a message to one or more recipients
 agent-office worker send-message --name Alice --name Bob --body "Status update: PR is ready" <token>
+# If your message body contains $ characters, escape them to avoid shell variable expansion
+agent-office worker send-message --name Alice --body "Cost is \$50" <token>
+# > Warning: always escape $ in --body when using double quotes in bash, or use single quotes.
+# > Unescaped $ will be silently expanded by the shell before the message is sent.
 # Cron job management
 agent-office worker cron list <token>
 agent-office worker cron create --name "daily-report" --schedule "0 9 * * *" --message "Send daily status" <token>

package/dist/cli.js CHANGED Viewed

@@ -102,6 +102,23 @@ workerCmd
     .argument("<token>", "Agent token in the format <agent_code>@<server-url>")
     .requiredOption("--name <name>", "Recipient name (can be specified multiple times)", (val, prev) => [...prev, val], [])
     .requiredOption("--body <body>", "Message body")
+    .addHelpText("after", `
+Examples:
+  agent-office worker send-message --name Alice --body "PR is ready" <token>
+  agent-office worker send-message --name Alice --name Bob --body "Hello" <token>
+  # Message body containing $: escape with \\ or use single quotes
+  agent-office worker send-message --name Alice --body "Cost is \\$50" <token>
+  agent-office worker send-message --name Alice --body 'Cost is $50' <token>
+Warning:
+  The shell processes --body before the CLI receives it. Be mindful of bash
+  special characters in your message body:
+    $var, \${x}  variable expansion   → escape as \\$ or use single quotes
+    \`cmd\`, $(x) command substitution → escape backticks or use single quotes
+    !, \\\\, "    history/escape chars → escape or use single quotes
+  The safest option is always single quotes: --body 'your message here'
+  (single quotes prevent all shell interpretation)`)
     .action(async (token, options) => {
     const { sendMessage } = await import("./commands/worker.js");
     await sendMessage(token, options.name, options.body);
@@ -127,6 +144,15 @@ cronCmd
     .requiredOption("--message <message>", "Action to perform when job fires")
     .requiredOption("--respond-to <respondTo>", "Who to respond to when done")
     .option("--timezone <timezone>", "IANA timezone (e.g., 'America/New_York')")
+    .addHelpText("after", `
+Warning:
+  The shell processes --message and --respond-to before the CLI receives them.
+  Be mindful of bash special characters in these values:
+    $var, \${x}  variable expansion   → escape as \\$ or use single quotes
+    \`cmd\`, $(x) command substitution → escape backticks or use single quotes
+    !, \\\\, "    history/escape chars → escape or use single quotes
+  The safest option is always single quotes: --message 'your message here'
+  (single quotes prevent all shell interpretation)`)
     .action(async (token, options) => {
     const { createCron } = await import("./commands/worker.js");
     await createCron(token, options);

package/dist/db/postgresql-storage.d.ts CHANGED Viewed

@@ -26,6 +26,7 @@ export declare class AgentOfficePostgresqlStorage extends AgentOfficeStorageBase
     }): Promise<MessageRow[]>;
     listMessagesFromSender(name: string): Promise<MessageRow[]>;
     countUnreadBySender(recipientName: string): Promise<Map<string, number>>;
+    lastMessageAtByCoworker(humanName: string): Promise<Map<string, Date>>;
     createMessageImpl(from: string, to: string, body: string): Promise<MessageRow>;
     markMessageAsRead(id: number): Promise<MessageRow | null>;
     markMessageAsInjected(id: number): Promise<void>;

package/dist/db/postgresql-storage.js CHANGED Viewed

@@ -142,6 +142,21 @@ export class AgentOfficePostgresqlStorage extends AgentOfficeStorageBase {
         }
         return result;
     }
+    async lastMessageAtByCoworker(humanName) {
+        const rows = await this.sql `
+      SELECT
+        CASE WHEN from_name = ${humanName} THEN to_name ELSE from_name END AS coworker,
+        MAX(created_at) AS last_at
+      FROM messages
+      WHERE from_name = ${humanName} OR to_name = ${humanName}
+      GROUP BY coworker
+    `;
+        const result = new Map();
+        for (const row of rows) {
+            result.set(row.coworker, row.last_at);
+        }
+        return result;
+    }
     async createMessageImpl(from, to, body) {
         const [row] = await this.sql `
       INSERT INTO messages (from_name, to_name, body)

package/dist/db/sqlite-storage.d.ts CHANGED Viewed

@@ -27,6 +27,7 @@ export declare class AgentOfficeSqliteStorage extends AgentOfficeStorageBase {
     }): Promise<MessageRow[]>;
     listMessagesFromSender(name: string): Promise<MessageRow[]>;
     countUnreadBySender(recipientName: string): Promise<Map<string, number>>;
+    lastMessageAtByCoworker(humanName: string): Promise<Map<string, Date>>;
     createMessageImpl(from: string, to: string, body: string): Promise<MessageRow>;
     markMessageAsRead(id: number): Promise<MessageRow | null>;
     markMessageAsInjected(id: number): Promise<void>;

package/dist/db/sqlite-storage.js CHANGED Viewed

@@ -197,6 +197,22 @@ export class AgentOfficeSqliteStorage extends AgentOfficeStorageBase {
         }
         return result;
     }
+    async lastMessageAtByCoworker(humanName) {
+        const stmt = this.db.prepare(`
+      SELECT
+        CASE WHEN from_name = ? THEN to_name ELSE from_name END AS coworker,
+        MAX(created_at) AS last_at
+      FROM messages
+      WHERE from_name = ? OR to_name = ?
+      GROUP BY coworker
+    `);
+        const rows = stmt.all(humanName, humanName, humanName);
+        const result = new Map();
+        for (const row of rows) {
+            result.set(row.coworker, new Date(row.last_at + 'Z'));
+        }
+        return result;
+    }
     async createMessageImpl(from, to, body) {
         const stmt = this.db.prepare(`
       INSERT INTO messages (from_name, to_name, body)

package/dist/db/storage-base.d.ts CHANGED Viewed

@@ -28,6 +28,7 @@ export declare abstract class AgentOfficeStorageBase implements AgentOfficeStora
     }): Promise<MessageRow[]>;
     abstract listMessagesFromSender(name: string): Promise<MessageRow[]>;
     abstract countUnreadBySender(recipientName: string): Promise<Map<string, number>>;
+    abstract lastMessageAtByCoworker(humanName: string): Promise<Map<string, Date>>;
     abstract markMessageAsRead(id: number): Promise<MessageRow | null>;
     abstract markMessageAsInjected(id: number): Promise<void>;
     abstract markMessagesAsNotified(ids: number[]): Promise<void>;

package/dist/db/storage.d.ts CHANGED Viewed

@@ -37,6 +37,7 @@ export interface AgentOfficeStorage {
     }): Promise<MessageRow[]>;
     listMessagesFromSender(name: string): Promise<MessageRow[]>;
     countUnreadBySender(recipientName: string): Promise<Map<string, number>>;
+    lastMessageAtByCoworker(humanName: string): Promise<Map<string, Date>>;
     createMessage(from: string, to: string, body: string): Promise<MessageRow>;
     markMessageAsRead(id: number): Promise<MessageRow | null>;
     markMessageAsInjected(id: number): Promise<void>;

package/dist/server/routes.js CHANGED Viewed

@@ -69,6 +69,17 @@ export function generateSystemPrompt(name, status, humanName, humanDescription,
         `     --body "Your message here" \\`,
         `     ${token}`,
         ``,
+        ` If your message contains $ characters, escape them to avoid shell`,
+        ` variable expansion (bash expands unescaped $ before the CLI sees it):`,
+        `   agent-office worker send-message \\`,
+        `     --name alice \\`,
+        `     --body "The total cost is \\$42" \\`,
+        `     ${token}`,
+        ``,
+        ` ⚠ Always escape $ in --body when using double quotes in bash,`,
+        `   or switch to single quotes. Unescaped $ will be silently`,
+        `   expanded by the shell and your message will be garbled.`,
+        ``,
         ` Manage scheduled tasks (optional)`,
         `   agent-office worker cron \\`,
         `     ${token}`,
@@ -190,17 +201,34 @@ export function createRouter(storage, agenticCodingServer, serverUrl, scheduler)
         try {
             const sessions = await storage.listSessions();
             const humanName = await storage.getConfig('human_name') ?? "Human";
-            const unreadCounts = await storage.countUnreadBySender(humanName);
+            const [unreadCounts, lastMessageAt] = await Promise.all([
+                storage.countUnreadBySender(humanName),
+                storage.lastMessageAtByCoworker(humanName),
+            ]);
             const coworkers = [
-                { name: humanName, status: null, isHuman: true, unreadMessages: 0 },
+                { name: humanName, status: null, isHuman: true, unreadMessages: 0, lastMessageAt: null },
                 ...sessions.map(s => ({
                     name: s.name,
                     status: s.status,
                     isHuman: false,
-                    unreadMessages: unreadCounts.get(s.name) ?? 0
+                    unreadMessages: unreadCounts.get(s.name) ?? 0,
+                    lastMessageAt: lastMessageAt.get(s.name)?.toISOString() ?? null,
                 }))
             ];
-            res.json(coworkers);
+            // Sort non-human coworkers by most recent message (most recent first),
+            // coworkers with no messages appear last (sorted by name as tiebreaker)
+            const [human, ...agents] = coworkers;
+            agents.sort((a, b) => {
+                if (a.lastMessageAt && b.lastMessageAt) {
+                    return new Date(b.lastMessageAt).getTime() - new Date(a.lastMessageAt).getTime();
+                }
+                if (a.lastMessageAt)
+                    return -1;
+                if (b.lastMessageAt)
+                    return 1;
+                return a.name.localeCompare(b.name);
+            });
+            res.json([human, ...agents]);
         }
         catch (err) {
             console.error("GET /coworkers error:", err);

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "agent-office",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "An office for your AI agents",
   "type": "module",
   "license": "MIT",