@holon-run/agentinbox 0.2.0 → 0.3.0

package/dist/src/cli.js

@@ -180,6 +180,7 @@ async function main() {
             backend: detected.backend,
             runtimeKind: detected.runtimeKind,
             runtimeSessionId: detected.runtimeSessionId ?? undefined,
+            runtimePid: detected.runtimePid ?? undefined,
             tmuxPaneId: detected.tmuxPaneId ?? undefined,
             tty: detected.tty ?? undefined,
             termProgram: detected.termProgram ?? undefined,
@@ -344,6 +345,62 @@ async function main() {
         });
         return;
     }
+    if (command === "timer" && normalized[1] === "add") {
+        const args = normalized.slice(2);
+        const allowedFlags = ["--agent-id", "--at", "--every", "--cron", "--timezone", "--message", "--sender"];
+        if (positionalArgs(args, ["--agent-id", "--at", "--every", "--cron", "--timezone", "--message", "--sender"]).length > 0 || unexpectedFlags(args, allowedFlags).length > 0) {
+            throw new Error("usage: agentinbox timer add --agent-id ID (--at ISO8601 | --every DURATION | --cron EXPR) --message TEXT [--timezone TZ] [--sender SENDER]");
+        }
+        const agentId = takeFlagValue(normalized, "--agent-id");
+        const message = takeFlagValue(normalized, "--message");
+        const at = takeFlagValue(normalized, "--at");
+        const every = takeFlagValue(normalized, "--every");
+        const cron = takeFlagValue(normalized, "--cron");
+        if (!agentId || !message || [at, every, cron].filter(Boolean).length !== 1) {
+            throw new Error("usage: agentinbox timer add --agent-id ID (--at ISO8601 | --every DURATION | --cron EXPR) --message TEXT [--timezone TZ] [--sender SENDER]");
+        }
+        await printRemote(client, "/timers", {
+            agentId,
+            at: at ?? undefined,
+            every: every ? parseDurationMs(every) : undefined,
+            cron: cron ?? undefined,
+            timezone: takeFlagValue(normalized, "--timezone") ?? undefined,
+            message,
+            sender: takeFlagValue(normalized, "--sender") ?? undefined,
+        });
+        return;
+    }
+    if (command === "timer" && normalized[1] === "list") {
+        const query = buildQuery({
+            agent_id: takeFlagValue(normalized, "--agent-id"),
+        });
+        await printRemote(client, `/timers${query}`, undefined, "GET");
+        return;
+    }
+    if (command === "timer" && normalized[1] === "pause") {
+        const scheduleId = normalized[2];
+        if (!scheduleId) {
+            throw new Error("usage: agentinbox timer pause <scheduleId>");
+        }
+        await printRemote(client, `/timers/${encodeURIComponent(scheduleId)}/pause`, {});
+        return;
+    }
+    if (command === "timer" && normalized[1] === "resume") {
+        const scheduleId = normalized[2];
+        if (!scheduleId) {
+            throw new Error("usage: agentinbox timer resume <scheduleId>");
+        }
+        await printRemote(client, `/timers/${encodeURIComponent(scheduleId)}/resume`, {});
+        return;
+    }
+    if (command === "timer" && normalized[1] === "remove") {
+        const scheduleId = normalized[2];
+        if (!scheduleId) {
+            throw new Error("usage: agentinbox timer remove <scheduleId>");
+        }
+        await printRemote(client, `/timers/${encodeURIComponent(scheduleId)}`, undefined, "DELETE");
+        return;
+    }
     if (command === "inbox" && normalized[1] === "list") {
         await printRemote(client, "/agents", undefined, "GET");
         return;
@@ -374,6 +431,23 @@ async function main() {
         console.log((0, util_1.jsonResponse)(withCommandMetadata(response.data, selection)));
         return;
     }
+    if (command === "inbox" && normalized[1] === "send") {
+        const args = normalized.slice(2);
+        const allowedFlags = ["--agent-id", "--message", "--sender"];
+        if (positionalArgs(args, ["--agent-id", "--message", "--sender"]).length > 0 || unexpectedFlags(args, allowedFlags).length > 0) {
+            throw new Error("usage: agentinbox inbox send --agent-id ID --message TEXT [--sender SENDER]");
+        }
+        const agentId = takeFlagValue(normalized, "--agent-id");
+        const message = takeFlagValue(normalized, "--message");
+        if (!agentId || !message) {
+            throw new Error("usage: agentinbox inbox send --agent-id ID --message TEXT [--sender SENDER]");
+        }
+        await printRemote(client, `/agents/${encodeURIComponent(agentId)}/inbox/items`, {
+            message,
+            sender: takeFlagValue(normalized, "--sender") ?? undefined,
+        });
+        return;
+    }
     if (command === "inbox" && normalized[1] === "watch") {
         const args = normalized.slice(2);
         if (positionalArgs(args, ["--agent-id", "--after-item", "--heartbeat-ms"]).length > 0) {
@@ -592,6 +666,7 @@ async function selectAgentForCommand(client, options) {
         backend: contextForCurrent.backend,
         runtimeKind: contextForCurrent.runtimeKind,
         runtimeSessionId: contextForCurrent.runtimeSessionId ?? undefined,
+        runtimePid: contextForCurrent.runtimePid ?? undefined,
         tmuxPaneId: contextForCurrent.tmuxPaneId ?? undefined,
         tty: contextForCurrent.tty ?? undefined,
         termProgram: contextForCurrent.termProgram ?? undefined,
@@ -648,6 +723,30 @@ function parseOptionalNumber(value) {
     }
     return parsed;
 }
+function parseDurationMs(value) {
+    if (/^\d+$/.test(value)) {
+        return Number(value);
+    }
+    const match = /^(\d+)(ms|s|m|h|d)$/.exec(value);
+    if (!match) {
+        throw new Error(`invalid duration: ${value}`);
+    }
+    const amount = Number(match[1]);
+    switch (match[2]) {
+        case "ms":
+            return amount;
+        case "s":
+            return amount * 1_000;
+        case "m":
+            return amount * 60_000;
+        case "h":
+            return amount * 60 * 60_000;
+        case "d":
+            return amount * 24 * 60 * 60_000;
+        default:
+            throw new Error(`invalid duration: ${value}`);
+    }
+}
 function normalizeHelpArgs(args) {
     if (args[0] !== "help") {
         return args;
@@ -762,6 +861,7 @@ Commands:
   daemon
   source
   agent
+  timer
   subscription
   inbox
   gc
@@ -808,6 +908,15 @@ Usage:
   agentinbox agent target add webhook <agentId> --url URL [--activation-mode MODE] [--notify-lease-ms N]
   agentinbox agent target list <agentId>
   agentinbox agent target remove <agentId> <targetId>
+`,
+        timer: `agentinbox timer
+
+Usage:
+  agentinbox timer add --agent-id ID (--at ISO8601 | --every DURATION | --cron EXPR) --message TEXT [--timezone TZ] [--sender SENDER]
+  agentinbox timer list [--agent-id ID]
+  agentinbox timer pause <scheduleId>
+  agentinbox timer resume <scheduleId>
+  agentinbox timer remove <scheduleId>
 `,
         subscription: `agentinbox subscription
 
@@ -826,6 +935,7 @@ Usage:
   agentinbox inbox list
   agentinbox inbox show <agentId>
   agentinbox inbox read [--agent-id ID] [--after-item ID] [--include-acked]
+  agentinbox inbox send --agent-id ID --message TEXT [--sender SENDER]
   agentinbox inbox watch [--agent-id ID] [--after-item ID] [--include-acked] [--heartbeat-ms N]
   agentinbox inbox ack [--agent-id ID] (--through <itemId> | --item <itemId> | --all)
   agentinbox inbox compact <agentId>

package/dist/src/current_agent.js

@@ -16,6 +16,7 @@ function summarizeActivationTarget(target) {
             itermSessionId: target.itermSessionId ?? null,
             runtimeKind: target.runtimeKind ?? null,
             runtimeSessionId: target.runtimeSessionId ?? null,
+            runtimePid: target.runtimePid ?? null,
         };
     }
     return {

package/dist/src/http.js

@@ -419,6 +419,7 @@ function buildFastifyServer(service) {
                     backend: { type: "string", minLength: 1 },
                     runtimeKind: { type: "string" },
                     runtimeSessionId: { type: "string" },
+                    runtimePid: { type: "integer", minimum: 1 },
                     tmuxPaneId: { type: "string" },
                     tty: { type: "string" },
                     termProgram: { type: "string" },
@@ -439,6 +440,7 @@ function buildFastifyServer(service) {
             backend: String(body.backend),
             runtimeKind: optionalString(body.runtimeKind),
             runtimeSessionId: optionalString(body.runtimeSessionId),
+            runtimePid: typeof body.runtimePid === "number" ? body.runtimePid : null,
             mode: "agent_prompt",
             tmuxPaneId: optionalString(body.tmuxPaneId),
             tty: optionalString(body.tty),
@@ -563,6 +565,123 @@ function buildFastifyServer(service) {
         const params = request.params;
         return service.removeActivationTarget(decodeURIComponent(params.agentId), decodeURIComponent(params.targetId));
     });
+    app.get("/timers", {
+        schema: {
+            tags: ["timers"],
+            querystring: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    agent_id: { type: "string" },
+                },
+            },
+            response: {
+                200: {
+                    type: "object",
+                    required: ["timers"],
+                    properties: {
+                        timers: { type: "array", items: jsonObjectSchema },
+                    },
+                },
+            },
+        },
+    }, async (request) => {
+        const query = request.query;
+        return { timers: service.listTimers(query.agent_id) };
+    });
+    app.post("/timers", {
+        schema: {
+            tags: ["timers"],
+            body: {
+                type: "object",
+                additionalProperties: false,
+                required: ["agentId", "message"],
+                properties: {
+                    agentId: { type: "string", minLength: 1 },
+                    at: { type: "string", minLength: 1 },
+                    every: { type: "integer", minimum: 60000 },
+                    cron: { type: "string", minLength: 1 },
+                    timezone: { type: "string", minLength: 1 },
+                    message: { type: "string", minLength: 1 },
+                    sender: { type: "string", minLength: 1 },
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+                400: errorResponseSchema,
+            },
+        },
+    }, async (request) => {
+        const body = request.body;
+        return service.registerTimer({
+            agentId: String(body.agentId),
+            at: optionalString(body.at) ?? null,
+            every: typeof body.every === "number" ? body.every : null,
+            cron: optionalString(body.cron) ?? null,
+            timezone: optionalString(body.timezone) ?? null,
+            message: String(body.message),
+            sender: optionalString(body.sender) ?? null,
+        });
+    });
+    app.post("/timers/:scheduleId/pause", {
+        schema: {
+            tags: ["timers"],
+            params: {
+                type: "object",
+                required: ["scheduleId"],
+                properties: {
+                    scheduleId: { type: "string", minLength: 1 },
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+                400: errorResponseSchema,
+                404: errorResponseSchema,
+            },
+        },
+    }, async (request) => {
+        const params = request.params;
+        return service.pauseTimer(decodeURIComponent(params.scheduleId));
+    });
+    app.post("/timers/:scheduleId/resume", {
+        schema: {
+            tags: ["timers"],
+            params: {
+                type: "object",
+                required: ["scheduleId"],
+                properties: {
+                    scheduleId: { type: "string", minLength: 1 },
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+                400: errorResponseSchema,
+                404: errorResponseSchema,
+            },
+        },
+    }, async (request) => {
+        const params = request.params;
+        return service.resumeTimer(decodeURIComponent(params.scheduleId));
+    });
+    app.delete("/timers/:scheduleId", {
+        schema: {
+            tags: ["timers"],
+            params: {
+                type: "object",
+                required: ["scheduleId"],
+                properties: {
+                    scheduleId: { type: "string", minLength: 1 },
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+                404: errorResponseSchema,
+            },
+        },
+    }, async (request) => {
+        const params = request.params;
+        return service.removeTimer(decodeURIComponent(params.scheduleId));
+    });
     app.get("/subscriptions", {
         schema: {
             tags: ["subscriptions"],
@@ -812,6 +931,39 @@ function buildFastifyServer(service) {
             }),
         };
     });
+    app.post("/agents/:agentId/inbox/items", {
+        schema: {
+            tags: ["inbox"],
+            params: {
+                type: "object",
+                required: ["agentId"],
+                properties: {
+                    agentId: { type: "string", minLength: 1 },
+                },
+            },
+            body: {
+                type: "object",
+                additionalProperties: false,
+                required: ["message"],
+                properties: {
+                    message: { type: "string", minLength: 1 },
+                    sender: { type: "string", minLength: 1 },
+                },
+            },
+            response: {
+                200: jsonObjectSchema,
+                400: errorResponseSchema,
+                404: errorResponseSchema,
+            },
+        },
+    }, async (request) => {
+        const params = request.params;
+        const body = request.body;
+        return service.addDirectInboxTextMessage(decodeURIComponent(params.agentId), {
+            message: body.message,
+            sender: body.sender ?? null,
+        });
+    });
     app.get("/agents/:agentId/inbox/watch", {
         schema: {
             tags: ["inbox"],
@@ -1060,7 +1212,11 @@ function normalizeValidationMessage(message) {
     return message;
 }
 function isBadRequestError(message) {
-    return (message.startsWith("manual append is not supported") ||
+    return (message.startsWith("direct inbox ") ||
+        message.startsWith("timers require ") ||
+        message.startsWith("timer ") ||
+        message.startsWith("invalid timezone: ") ||
+        message.startsWith("manual append is not supported") ||
         message.startsWith("sources/events requires") ||
         message.startsWith("source remove requires") ||
         message.startsWith("deliveryHandle requires") ||