palmier 0.1.5 → 0.1.7

package/README.md

@@ -63,7 +63,10 @@ cat ~/.config/palmier/agent.json
 ## How It Works
 
 - The agent runs as a **systemd user service**, staying alive in the background.
-- Incoming tasks from the platform are stored as `TASK.md` files in a local `tasks/` directory.
+- The persistent process (`palmier serve`) is a NATS RPC handler. It derives the RPC method from the NATS subject (e.g., `...rpc.task.create` → `task.create`) and treats the message body as request parameters.
+- **Task IDs** are generated by the agent as UUIDs.
+- All RPC responses (`task.list`, `task.create`, `task.update`) return **flat task objects** — frontmatter fields at the top level, not nested under a `frontmatter` key.
+- Incoming tasks are stored as `TASK.md` files in a local `tasks/` directory.
 - Task execution spawns **Claude Code in a PTY**, giving the AI full CLI access within the project.
 - **Hooks** intercept Claude Code permission, confirmation, and input prompts, resolving them remotely via NATS KV so tasks can run unattended.
 

package/dist/commands/serve.js

@@ -1,3 +1,4 @@
+import { randomUUID } from "crypto";
 import { execSync } from "child_process";
 import * as fs from "fs";
 import { StringCodec } from "nats";
@@ -75,25 +76,27 @@ export async function serveCommand() {
             msg.respond(sc.encode(JSON.stringify(response)));
         }
     }
+    function flattenTask(task, status) {
+        return { ...task.frontmatter, body: task.body, ...(status != null ? { status } : {}) };
+    }
     async function handleRpc(request) {
         switch (request.method) {
             case "task.list": {
                 const tasks = listTasks(config.projectRoot);
-                const tasksWithStatus = tasks.map((task) => ({
-                    ...task,
-                    status: getTaskStatus(task.frontmatter.id),
-                }));
-                return { tasks: tasksWithStatus };
+                return {
+                    tasks: tasks.map((task) => flattenTask(task, getTaskStatus(task.frontmatter.id))),
+                };
             }
             case "task.create": {
                 const params = request.params;
-                const taskDir = getTaskDir(config.projectRoot, params.id);
+                const id = randomUUID();
+                const taskDir = getTaskDir(config.projectRoot, id);
                 const task = {
                     frontmatter: {
-                        id: params.id,
+                        id,
                         name: params.name,
                         user_prompt: params.user_prompt,
-                        triggers: params.triggers || [],
+                        triggers: params.triggers ?? [],
                         requires_confirmation: params.requires_confirmation ?? true,
                         suppress_permissions: params.suppress_permissions ?? false,
                         enabled: params.enabled ?? true,
@@ -102,7 +105,7 @@ export async function serveCommand() {
                 };
                 writeTaskFile(taskDir, task);
                 installTaskTimer(config, task);
-                return { ok: true, task_id: params.id };
+                return flattenTask(task);
             }
             case "task.update": {
                 const params = request.params;
@@ -127,7 +130,7 @@ export async function serveCommand() {
                 // Reinstall timer with updated config
                 removeTaskTimer(params.id);
                 installTaskTimer(config, existing);
-                return { ok: true, task_id: params.id };
+                return flattenTask(existing, getTaskStatus(params.id));
             }
             case "task.delete": {
                 const params = request.params;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palmier",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Palmier agent CLI - provisions, executes tasks, and serves NATS RPC",
   "license": "ISC",
   "author": "Hongxu Cai",

package/src/commands/serve.ts

@@ -1,3 +1,4 @@
+import { randomUUID } from "crypto";
 import { execSync } from "child_process";
 import * as fs from "fs";
 import { StringCodec } from "nats";
@@ -5,7 +6,7 @@ import { loadConfig } from "../config.js";
 import { connectNats } from "../nats-client.js";
 import { listTasks, parseTaskFile, writeTaskFile, getTaskDir } from "../task.js";
 import { installTaskTimer, removeTaskTimer, getTaskStatus } from "../systemd.js";
-import type { RpcMessage, TaskWithStatus } from "../types.js";
+import type { ParsedTask, RpcMessage } from "../types.js";
 
 /**
  * Start the persistent NATS RPC handler.
@@ -86,36 +87,40 @@ export async function serveCommand(): Promise<void> {
     }
   }
 
+  function flattenTask(task: ParsedTask, status?: unknown) {
+    return { ...task.frontmatter, body: task.body, ...(status != null ? { status } : {}) };
+  }
+
   async function handleRpc(request: RpcMessage): Promise<unknown> {
     switch (request.method) {
       case "task.list": {
         const tasks = listTasks(config.projectRoot);
-        const tasksWithStatus: TaskWithStatus[] = tasks.map((task) => ({
-          ...task,
-          status: getTaskStatus(task.frontmatter.id),
-        }));
-        return { tasks: tasksWithStatus };
+        return {
+          tasks: tasks.map((task) =>
+            flattenTask(task, getTaskStatus(task.frontmatter.id))
+          ),
+        };
       }
 
       case "task.create": {
         const params = request.params as {
-          id: string;
           name: string;
           user_prompt: string;
-          triggers: Array<{ type: "cron" | "once"; value: string }>;
-          requires_confirmation: boolean;
-          suppress_permissions: boolean;
-          enabled: boolean;
-          body: string;
+          triggers?: Array<{ type: "cron" | "once"; value: string }>;
+          requires_confirmation?: boolean;
+          suppress_permissions?: boolean;
+          enabled?: boolean;
+          body?: string;
         };
 
-        const taskDir = getTaskDir(config.projectRoot, params.id);
+        const id = randomUUID();
+        const taskDir = getTaskDir(config.projectRoot, id);
         const task = {
           frontmatter: {
-            id: params.id,
+            id,
             name: params.name,
             user_prompt: params.user_prompt,
-            triggers: params.triggers || [],
+            triggers: params.triggers ?? [],
             requires_confirmation: params.requires_confirmation ?? true,
             suppress_permissions: params.suppress_permissions ?? false,
             enabled: params.enabled ?? true,
@@ -126,7 +131,7 @@ export async function serveCommand(): Promise<void> {
         writeTaskFile(taskDir, task);
         installTaskTimer(config, task);
 
-        return { ok: true, task_id: params.id };
+        return flattenTask(task);
       }
 
       case "task.update": {
@@ -161,7 +166,7 @@ export async function serveCommand(): Promise<void> {
         removeTaskTimer(params.id);
         installTaskTimer(config, existing);
 
-        return { ok: true, task_id: params.id };
+        return flattenTask(existing, getTaskStatus(params.id));
       }
 
       case "task.delete": {