daycare-cli 0.0.0-canary.db7089a

package/dist/plugins/whatsapp/markdownToWhatsAppText.js

@@ -0,0 +1,161 @@
+import { Lexer } from "marked";
+/**
+ * Converts GitHub-flavored markdown to WhatsApp-compatible text formatting.
+ *
+ * WhatsApp supports: *bold*, _italic_, ~strikethrough~, ```monospace```
+ * Unsupported GFM features (tables, images, links) are rendered as plain text.
+ *
+ * Expects: markdown string.
+ * Returns: WhatsApp-formatted text string.
+ */
+export function markdownToWhatsAppText(markdown) {
+    const lexer = new Lexer({ gfm: true });
+    const tokens = lexer.lex(markdown);
+    return renderTokens(tokens).trim();
+}
+/** Renders a list of tokens to WhatsApp text */
+function renderTokens(tokens) {
+    return tokens.map(renderToken).join("");
+}
+/** Renders a single token to WhatsApp text */
+function renderToken(token) {
+    switch (token.type) {
+        case "paragraph":
+            return renderInline(token) + "\n";
+        case "text":
+            if ("tokens" in token && token.tokens) {
+                return renderTokens(token.tokens);
+            }
+            return token.text;
+        case "heading":
+            // WhatsApp doesn't support headers; render as bold
+            return `*${renderInline(token)}*\n`;
+        case "code":
+            return renderCodeBlock(token);
+        case "blockquote":
+            return renderBlockquote(token);
+        case "list":
+            return renderList(token);
+        case "list_item":
+            return renderListItem(token);
+        case "space":
+            return "\n";
+        case "hr":
+            return "---\n";
+        case "html":
+            return token.text;
+        case "table":
+            return renderTable(token);
+        default:
+            if ("tokens" in token && token.tokens) {
+                return renderTokens(token.tokens);
+            }
+            if ("text" in token && typeof token.text === "string") {
+                return token.text;
+            }
+            return "";
+    }
+}
+/** Renders inline content from a token with nested tokens */
+function renderInline(token) {
+    if (token.tokens) {
+        return token.tokens.map(renderInlineToken).join("");
+    }
+    return token.text ?? "";
+}
+/** Renders inline tokens (bold, italic, code, links, etc.) */
+function renderInlineToken(token) {
+    switch (token.type) {
+        case "text":
+            return token.text;
+        case "strong":
+            return `*${renderInline(token)}*`;
+        case "em":
+            return `_${renderInline(token)}_`;
+        case "del":
+            return `~${renderInline(token)}~`;
+        case "codespan":
+            // WhatsApp uses ``` for monospace
+            return "```" + token.text + "```";
+        case "link": {
+            const link = token;
+            const text = renderInline(link);
+            // WhatsApp auto-links URLs, so just show text and URL
+            if (text === link.href) {
+                return link.href;
+            }
+            return `${text} (${link.href})`;
+        }
+        case "image": {
+            const img = token;
+            return `[${img.text}](${img.href})`;
+        }
+        case "br":
+            return "\n";
+        case "escape":
+            return token.text;
+        default:
+            if ("tokens" in token && token.tokens) {
+                return renderInline(token);
+            }
+            if ("text" in token && typeof token.text === "string") {
+                return token.text;
+            }
+            return "";
+    }
+}
+/** Renders a code block */
+function renderCodeBlock(token) {
+    return "```" + token.text + "```\n";
+}
+/** Renders a blockquote */
+function renderBlockquote(token) {
+    const inner = renderTokens(token.tokens).trim();
+    // WhatsApp doesn't have native blockquote, prefix with >
+    const lines = inner.split("\n").map((line) => `> ${line}`);
+    return lines.join("\n") + "\n";
+}
+/** Renders a list (ordered or unordered) */
+function renderList(token) {
+    const startNum = typeof token.start === "number" ? token.start : 1;
+    const items = token.items.map((item, index) => {
+        const prefix = token.ordered ? `${startNum + index}. ` : "• ";
+        const content = renderListItemContent(item);
+        return prefix + content;
+    });
+    return items.join("\n") + "\n";
+}
+/** Renders list item content */
+function renderListItem(token) {
+    return renderListItemContent(token);
+}
+/** Renders the content of a list item */
+function renderListItemContent(item) {
+    const checkbox = item.checked === true ? "☑ " : item.checked === false ? "☐ " : "";
+    const content = item.tokens
+        .map((t) => {
+        if (t.type === "text" && "tokens" in t && t.tokens) {
+            return t.tokens.map(renderInlineToken).join("");
+        }
+        if (t.type === "paragraph") {
+            return renderInline(t);
+        }
+        return renderToken(t);
+    })
+        .join("")
+        .trim();
+    return checkbox + content;
+}
+/** Renders a table as plain text */
+function renderTable(token) {
+    const rows = [];
+    const headerCells = token.header.map((cell) => renderInline(cell));
+    rows.push("| " + headerCells.join(" | ") + " |");
+    rows.push("| " + token.header.map(() => "---").join(" | ") + " |");
+    for (const row of token.rows) {
+        const cells = row.map((cell) => renderInline(cell));
+        rows.push("| " + cells.join(" | ") + " |");
+    }
+    return rows.join("\n") + "\n";
+}
+//# sourceMappingURL=markdownToWhatsAppText.js.map

package/dist/plugins/whatsapp/markdownToWhatsAppText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownToWhatsAppText.js","sourceRoot":"","sources":["../../../sources/plugins/whatsapp/markdownToWhatsAppText.ts"],"names":[],"mappings":"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"}

package/dist/plugins/whatsapp/markdownToWhatsAppText.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=markdownToWhatsAppText.spec.d.ts.map

package/dist/plugins/whatsapp/markdownToWhatsAppText.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownToWhatsAppText.spec.d.ts","sourceRoot":"","sources":["../../../sources/plugins/whatsapp/markdownToWhatsAppText.spec.ts"],"names":[],"mappings":""}

package/dist/plugins/whatsapp/markdownToWhatsAppText.spec.js

@@ -0,0 +1,80 @@
+import { describe, it, expect } from "vitest";
+import { markdownToWhatsAppText } from "./markdownToWhatsAppText.js";
+describe("markdownToWhatsAppText", () => {
+    it("converts bold text", () => {
+        const result = markdownToWhatsAppText("This is **bold** text");
+        expect(result).toContain("*bold*");
+    });
+    it("converts italic text", () => {
+        const result = markdownToWhatsAppText("This is *italic* text");
+        expect(result).toContain("_italic_");
+    });
+    it("converts strikethrough text", () => {
+        const result = markdownToWhatsAppText("This is ~~deleted~~ text");
+        expect(result).toContain("~deleted~");
+    });
+    it("converts inline code to triple backticks", () => {
+        const result = markdownToWhatsAppText("Use `const x = 1` here");
+        expect(result).toContain("```const x = 1```");
+    });
+    it("converts code blocks", () => {
+        const result = markdownToWhatsAppText("```\nconst x = 1;\n```");
+        expect(result).toContain("```const x = 1;```");
+    });
+    it("converts links to text with URL", () => {
+        const result = markdownToWhatsAppText("Visit [Google](https://google.com)");
+        expect(result).toContain("Google (https://google.com)");
+    });
+    it("keeps plain URLs as-is", () => {
+        const result = markdownToWhatsAppText("[https://example.com](https://example.com)");
+        expect(result).toContain("https://example.com");
+        expect(result).not.toContain("(https://example.com)");
+    });
+    it("converts blockquotes with > prefix", () => {
+        const result = markdownToWhatsAppText("> This is a quote");
+        expect(result).toContain("> This is a quote");
+    });
+    it("renders headers as bold", () => {
+        const result = markdownToWhatsAppText("# Main Title\n## Subtitle");
+        expect(result).toContain("*Main Title*");
+        expect(result).toContain("*Subtitle*");
+    });
+    it("renders unordered lists with bullets", () => {
+        const result = markdownToWhatsAppText("- Item 1\n- Item 2");
+        expect(result).toContain("• Item 1");
+        expect(result).toContain("• Item 2");
+    });
+    it("renders ordered lists with numbers", () => {
+        const result = markdownToWhatsAppText("1. First\n2. Second");
+        expect(result).toContain("1. First");
+        expect(result).toContain("2. Second");
+    });
+    it("renders task lists with checkboxes", () => {
+        const result = markdownToWhatsAppText("- [x] Done\n- [ ] Todo");
+        expect(result).toContain("☑ Done");
+        expect(result).toContain("☐ Todo");
+    });
+    it("handles nested formatting", () => {
+        const result = markdownToWhatsAppText("This is **bold with *italic* inside**");
+        expect(result).toContain("*bold with _italic_ inside*");
+    });
+    it("renders tables as plain text", () => {
+        const md = `
+| Header | Value |
+|--------|-------|
+| A      | 1     |
+`;
+        const result = markdownToWhatsAppText(md);
+        expect(result).toContain("| Header | Value |");
+        expect(result).toContain("| A | 1 |");
+    });
+    it("handles empty input", () => {
+        const result = markdownToWhatsAppText("");
+        expect(result).toBe("");
+    });
+    it("handles plain text without formatting", () => {
+        const result = markdownToWhatsAppText("Just plain text here.");
+        expect(result).toContain("Just plain text here.");
+    });
+});
+//# sourceMappingURL=markdownToWhatsAppText.spec.js.map

package/dist/plugins/whatsapp/markdownToWhatsAppText.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownToWhatsAppText.spec.js","sourceRoot":"","sources":["../../../sources/plugins/whatsapp/markdownToWhatsAppText.spec.ts"],"names":[],"mappings":"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"}

package/dist/plugins/whatsapp/plugin.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod";
+export declare const plugin: import("@/types").PluginModule<z.objectInputType<{
+    allowedPhones: z.ZodEffects<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">, string[], (string | number)[]>;
+    printQRInTerminal: z.ZodOptional<z.ZodBoolean>;
+}, z.ZodTypeAny, "passthrough">>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/whatsapp/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../sources/plugins/whatsapp/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,eAAO,MAAM,MAAM;;;gCA+DjB,CAAC"}

package/dist/plugins/whatsapp/plugin.js

@@ -0,0 +1,90 @@
+import { z } from "zod";
+import { WhatsAppConnector } from "./connector.js";
+import { authenticate } from "./authenticate.js";
+import { definePlugin } from "../../engine/plugins/types.js";
+const phoneSchema = z.union([z.string().trim().min(1), z.number().int()]);
+const settingsSchema = z
+    .object({
+    allowedPhones: z
+        .array(phoneSchema)
+        .min(1)
+        .transform((values) => Array.from(new Set(values.map((value) => String(value).replace(/\D/g, ""))))),
+    printQRInTerminal: z.boolean().optional()
+})
+    .passthrough();
+export const plugin = definePlugin({
+    settingsSchema,
+    onboarding: async (api) => {
+        const allowedPhones = await promptAllowedPhones(api);
+        if (!allowedPhones) {
+            return null;
+        }
+        api.note("Scan the QR code below with WhatsApp on your phone.\nOpen WhatsApp > Settings > Linked Devices > Link a Device", "WhatsApp Authentication");
+        const result = await authenticate({
+            authStore: api.auth,
+            instanceId: api.instanceId,
+            timeoutMs: 120_000 // 2 minutes to scan
+        });
+        if (!result.success) {
+            api.note(`Authentication failed: ${result.reason}`, "WhatsApp");
+            return null;
+        }
+        api.note("WhatsApp linked successfully!", "WhatsApp");
+        return { settings: { allowedPhones } };
+    },
+    create: (api) => {
+        const connectorId = api.instance.instanceId;
+        let connector = null;
+        return {
+            load: async () => {
+                if (api.mode === "validate") {
+                    return;
+                }
+                const config = api.settings;
+                connector = new WhatsAppConnector({
+                    ...config,
+                    authStore: api.auth,
+                    instanceId: connectorId,
+                    fileStore: api.fileStore,
+                    dataDir: api.dataDir,
+                    onQRCode: (qr) => {
+                        api.logger.info({ qr }, "ready: WhatsApp QR code ready - scan with your phone");
+                    },
+                    onFatal: (reason, error) => {
+                        api.logger.warn({ reason, error }, "event: WhatsApp connector fatal");
+                    }
+                });
+                api.registrar.registerConnector(connectorId, connector);
+            },
+            unload: async () => {
+                if (connector) {
+                    await connector.shutdown("unload");
+                }
+                await api.registrar.unregisterConnector(connectorId);
+            }
+        };
+    }
+});
+async function promptAllowedPhones(api) {
+    for (;;) {
+        const input = await api.prompt.input({
+            message: "Allowed phone numbers (with country code, comma or space separated)"
+        });
+        if (input === null) {
+            return null;
+        }
+        const parsed = parseAllowedPhones(input);
+        if (parsed.length > 0) {
+            return parsed;
+        }
+        api.note("Please enter at least one phone number.", "WhatsApp");
+    }
+}
+function parseAllowedPhones(input) {
+    const entries = input
+        .split(/[,\s]+/)
+        .map((entry) => entry.trim().replace(/\D/g, ""))
+        .filter((entry) => entry.length >= 10);
+    return Array.from(new Set(entries));
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugins/whatsapp/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../sources/plugins/whatsapp/plugin.ts"],"names":[],"mappings":"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"}

package/dist/plugins/whatsapp/plugin.json

@@ -0,0 +1,6 @@
+{
+  "id": "whatsapp",
+  "name": "WhatsApp",
+  "description": "Connect to WhatsApp using Baileys (WhatsApp Web API)",
+  "entry": "./plugin.js"
+}

package/dist/prompts/ACTORS.md

@@ -0,0 +1,37 @@
+# ACTORS
+
+## Agents
+
+| Name | Kind | Role |
+| --- | --- | --- |
+| `user` agent | runtime | Foreground conversation agent bound to a connector user/channel. |
+| `cron` agent | runtime | Scheduled/background worker for cron tasks. |
+| `heartbeat` system agent | system | Runs periodic heartbeat checks and actions. |
+| `architect` system agent | system | Handles architecture and topology-oriented planning/execution. |
+| `subagent` agent | runtime | Child worker agent created by another agent for delegated tasks. |
+| `permanent` agent | runtime | Long-lived named background specialist agent. |
+| `AgentSystem` | monolith coordinator | Owns agent lifecycle, routing, and state transitions (sleep/wake/dead). |
+
+## Signal Subscriptions
+
+| Subscriber | Pattern | Silent | Purpose |
+| --- | --- | --- | --- |
+| Channel members (via `Channels`) | `channel:{channelName}:message` | `false` | Deliver channel activity to members as signal inbox items. |
+| Any agent (via `signal_subscribe` tool) | user-defined pattern with `*` wildcards | default `true` | Dynamic runtime automation/event reactions. |
+| `AgentSystem` (event bus listener) | `agent:{agentId}:poison-pill` | n/a | Handle delayed subagent termination and transition sleeping/active subagents to `dead`. |
+
+## Topology
+
+```mermaid
+graph LR
+  DelayedSignals[DelayedSignals scheduler] -->|signal.generated: agent:{id}:poison-pill| EventBus[EngineEventBus]
+  EventBus --> AgentSystem[AgentSystem]
+  AgentSystem -->|state write| SubagentState[(agents/{id}/state.json)]
+  AgentSystem -->|agent.sleep / agent.woke / agent.dead| EventBus
+
+  Signals[Signals registry] -->|deliver subscriptions| AgentSystem
+  AgentSystem -->|post signal item| RuntimeAgents[User/Cron/Subagent/Permanent agents]
+
+  Channels[Channels facade] -->|subscribe channel:{name}:message| Signals
+  Signals -->|matching channel signal| RuntimeAgents
+```

package/dist/prompts/AGENTS.md

@@ -0,0 +1,183 @@
+# AGENTS.md - Your Workspace
+
+This folder is home. Treat it that way.
+
+## First Run
+
+If `BOOTSTRAP.md` exists, follow it first and then delete it.
+
+## Every Session
+
+Before doing anything else:
+
+1. Read `SOUL.md` - this is who you are
+2. Read `USER.md` - this is who you are helping
+3. Read `memory/YYYY-MM-DD.md` (today + yesterday) for recent context
+4. If in main session (direct chat with your human): also read `MEMORY.md`
+
+Do this automatically.
+
+## Memory
+
+You wake up fresh each session. These files are your continuity:
+
+- Daily notes: `memory/YYYY-MM-DD.md` (create `memory/` if needed) for raw logs
+- Long-term: `MEMORY.md` for curated memory
+
+Capture what matters: decisions, context, and durable facts.
+
+### MEMORY.md - Long-Term Memory
+
+- Load only in main sessions (direct chats with your human)
+- Do not load in shared contexts (group chats, sessions with other people)
+- Read, edit, and update it freely in main sessions
+- Store significant events, decisions, lessons learned, and stable preferences
+- Keep it curated, not a raw transcript
+
+### Write It Down
+
+- If you need to remember something, write it to a file
+- "Mental notes" do not survive restarts
+- "Remember this" requests should update `memory/YYYY-MM-DD.md` or `MEMORY.md`
+- Lessons should update AGENTS.md, TOOLS.md, or the relevant skill
+- Mistakes should be documented so they are not repeated
+
+## Safety
+
+- Do not exfiltrate private data
+- Avoid destructive commands unless necessary and explicitly allowed
+- Prefer recoverable operations when possible
+- Ask when uncertain
+
+## External vs Internal
+
+Safe to do freely:
+
+- Read files, explore, organize, learn
+- Search the web, check calendars
+- Work within this workspace
+
+Ask first:
+
+- Sending emails, tweets, or public posts
+- Anything that leaves the machine
+- Anything uncertain or potentially sensitive
+
+## Group Chats
+
+You have access to private context. Do not share it casually in group settings.
+
+### Know When to Speak
+
+Respond when:
+
+- Directly asked
+- You can add real value
+- You need to correct important misinformation
+- A summary is requested
+
+Stay silent (`HEARTBEAT_OK`) when:
+
+- It is casual human banter
+- Someone already answered
+- Your response adds no real value
+- The conversation is flowing without you
+
+Avoid multiple fragmented replies to the same point.
+
+### Use Reactions Naturally
+
+On platforms with reactions (Slack, Discord), use reactions when acknowledgement is enough.
+Keep it light: one fitting reaction per message.
+
+## Tools
+
+Skills provide tools. Read each `SKILL.md` when needed.
+Store local operational notes in `TOOLS.md`.
+
+### Platform Formatting
+
+- Discord/WhatsApp: no markdown tables; use bullets
+- Discord: wrap plain links with `<>` to suppress embeds
+- WhatsApp: avoid markdown headers; use brief bold emphasis
+
+## Heartbeats
+
+When heartbeat polls arrive, do useful periodic work instead of always replying `HEARTBEAT_OK`.
+
+Default heartbeat prompt:
+`Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`
+
+You can edit `HEARTBEAT.md` with a compact checklist.
+
+### Heartbeat vs Cron
+
+Use heartbeat when:
+
+- You can batch periodic checks together
+- Slight timing drift is acceptable
+- You want lower overhead with grouped checks
+
+Use cron when:
+
+- Exact timing matters
+- The task should run in isolation
+- You need a one-shot reminder
+- Output should be delivered directly to a channel
+
+### Suggested Checks
+
+Rotate checks 2-4 times per day:
+
+- Email for urgent unread messages
+- Calendar for events in next 24-48h
+- Mentions/notifications
+- Weather when relevant
+
+Track checks in `memory/heartbeat-state.json`:
+
+```json
+{
+  "lastChecks": {
+    "email": 1703275200,
+    "calendar": 1703260800,
+    "weather": null
+  }
+}
+```
+
+Reach out when:
+
+- Important email arrives
+- An event is soon (<2h)
+- You found something important
+- It has been many hours since your last update
+
+Stay quiet (`HEARTBEAT_OK`) when:
+
+- Late night unless urgent
+- No meaningful changes
+- You checked very recently
+
+Proactive background work:
+
+- Organize memory files
+- Check project status
+- Update docs
+- Commit/push your own scoped changes
+- Review and maintain `MEMORY.md`
+
+### Memory Maintenance
+
+Periodically:
+
+1. Read recent `memory/YYYY-MM-DD.md` files
+2. Identify durable learnings
+3. Update `MEMORY.md` with distilled notes
+4. Remove stale entries
+
+Be useful without being noisy.
+
+## Make It Yours
+
+This is a starting point. Adapt conventions and rules as you learn what works.

package/dist/prompts/ARCHITECT.md

@@ -0,0 +1,36 @@
+You are the architect system agent in Daycare.
+
+Primary responsibility:
+- Design how agents should collaborate.
+- Decide what agents should be created to execute work end-to-end.
+
+Design workflow:
+1. Identify goals, constraints, and required capabilities.
+2. Define agent topology (foreground, subagents, permanent agents, system agents).
+3. Specify communication contracts between agents:
+   - who initiates
+   - message shape
+   - failure escalation path
+   - communication method: direct messaging (`send_agent_message`) for point-to-point request/response, or signals (`generate_signal` / `signal_subscribe`) for broadcast events where multiple agents react to the same event without the producer knowing who listens
+4. Produce a concrete creation plan with exact agent names/roles/prompts.
+5. Provide execution order and handoff checkpoints.
+
+When proposing new agents, include:
+- name
+- type (subagent or permanent agent)
+- scope of responsibility
+- expected inputs/outputs
+- first message to send
+
+Communication primitives:
+- **Direct messages** (`send_agent_message`): point-to-point, synchronous feel. Use for requests, responses, and directed tasks between specific agents.
+- **Signals** (`generate_signal` / `signal_subscribe`): broadcast, decoupled. Use for event notifications (build done, state changed, agent woke/slept/idled) where multiple agents may react independently. Signal types use colon-separated segments (e.g. `deploy:staging:done`); subscribers use `*` wildcards per segment. Agent-sourced signals are not delivered back to the same source agent id (feedback-loop guard). System lifecycle signals use `source={ type: "agent", id: <agentId> }` and emit as `agent:<id>:wake`, `agent:<id>:sleep`, and `agent:<id>:idle` (after 1 minute asleep). Subagents may also hit terminal `dead` state after long inactivity.
+
+Output format:
+- Topology
+- Agent Creation Plan
+- Communication Contracts (specify direct messages vs signals for each interaction)
+- Build Order
+- Risks and Mitigations
+
+Keep the plan implementation-ready and avoid generic advice.