exempclaw 0.4.0

package/dist/demo/claude.js

@@ -0,0 +1,230 @@
+const TRIAGE = {
+    match: /initech|overnight|inbox|email|triage|morning|webhook|ana/i,
+    turns: [
+        {
+            status: { activity: "searching", message: "combing the inbox and channels for Initech traffic" },
+            tools: [
+                { name: "email_search", input: { from: "initech", limit: 10 } },
+                { name: "slack_read_channel", input: { channel: "#initech-account", limit: 20 } },
+            ],
+        },
+        {
+            status: { activity: "reading", message: "Ana's reply about the webhook retries" },
+            tools: [{ name: "email_read_message", input: { uid: 4711 } }],
+        },
+        {
+            text: "Ana confirmed the staging fix held through their overnight soak test — zero dropped events. She's asking for the production date and the volume-pricing one-pager ahead of the September renewal. Engineering proposed Thursday for prod in #initech-account, so I'll confirm \"this week, date locked today\" without promising the exact day in writing, and route the pricing ask to Marcus. Drafting the reply now.\n",
+            status: { activity: "writing", message: "drafting a reply in the team's voice" },
+            tools: [
+                {
+                    name: "email_send",
+                    input: {
+                        to: ["ana.flores@initech.example"],
+                        subject: "Re: webhook retries dropping events",
+                        body: "Hi Ana,\n\nGreat news on the soak test — thanks for running it. The fix is slated for production this week; I'm confirming the exact date with engineering today and will follow up the moment it's locked.\n\nOn volume pricing: looping in Marcus Webb, who's preparing the one-pager with finance so you have it well before the September kickoff.\n\nBest,\nJordan (covering support for Alex)",
+                        inReplyTo: "<m-4711@initech.example>",
+                    },
+                },
+            ],
+        },
+        {
+            tools: [
+                { name: "email_mark_read", input: { uid: 4711 } },
+                {
+                    name: "remember",
+                    input: {
+                        text: "Ana (Initech) confirmed the staging webhook fix on 2026-06-12; promised prod date follow-up this week and routed the volume-pricing one-pager to Marcus before the September renewal.",
+                        source: "email",
+                        tags: ["initech", "ana", "renewal"],
+                    },
+                },
+            ],
+        },
+        { status: { activity: "celebrating", message: "Initech thread handled end to end" } },
+        {
+            text: (ctx) => ctx.denied
+                ? "Understood — I didn't send the reply since it wasn't approved. The draft is in my notes: it confirms the soak-test result, promises the prod date this week, and routes the pricing one-pager to Marcus. Say the word (or re-run with approval) and it goes out. I did mark Ana's email read and noted the renewal context in memory."
+                : "Done. One thing came in overnight that mattered: Ana confirmed the staging fix held, so I replied confirming production this week (exact date to follow — kept it out of writing per our convention) and routed her volume-pricing ask to Marcus for the September renewal. Her email is marked read and the renewal context is saved to memory. Nothing else in the inbox needed action.",
+        },
+    ],
+};
+const PRIORITIES = {
+    match: /priorit|week|today|plan|focus/i,
+    turns: [
+        {
+            status: { activity: "reading", message: "reviewing the role briefing and open commitments" },
+            tools: [{ name: "recall", input: { query: "renewal commitments deadlines process", limit: 10 } }],
+        },
+        {
+            text: "Top of the list this week:\n\n" +
+                "1. Initech — confirm the production date for the webhook fix and get Ana her volume-pricing one-pager moving (renewal kickoff is early September; Marcus owns the commercial side).\n" +
+                "2. Monday's weekly support summary — due before noon, per the standing convention.\n" +
+                "3. Keep an eye on billing disputes: anything over $500 goes to Sam, not us.\n\n" +
+                "Want me to start the triage pass? Try: \"Anything from Initech overnight?\"",
+        },
+    ],
+};
+const IDENTITY = {
+    match: /who are you|are you (an? )?(ai|bot|human|robot)|yourself|real person/i,
+    turns: [
+        {
+            text: "I'm Jordan — an AI assistant covering the Customer Support Lead role that Alex Rivera held, running on Exempclaw. I'm configured for transparent disclosure, so I'll always say so when asked (and in outward email too). Right now you're talking to the offline demo brain: a scripted stand-in, a fictional inbox, zero API calls.",
+        },
+    ],
+};
+const MEMORY = {
+    match: /remember|memory|know about/i,
+    turns: [
+        {
+            status: { activity: "searching", message: "checking durable memory" },
+            tools: [{ name: "recall", input: { query: "initech renewal process", limit: 10 } }],
+        },
+        {
+            text: "Here's the shape of what I carry between sessions: Initech is the key account (Ana Flores, prefers email), their renewal kicks off in September with a volume-pricing ask, Marcus owns the commercial side, billing disputes over $500 escalate to Sam, and the weekly summary ships Mondays. Anything I learn while working — like today's soak-test confirmation — gets written back with the memory tool. You can browse it yourself with /memory.",
+        },
+    ],
+};
+const FALLBACK = {
+    match: /.*/,
+    turns: [
+        {
+            status: { activity: "thinking", message: "getting oriented in the demo workspace" },
+            tools: [{ name: "slack_read_channel", input: { channel: "#support", limit: 10 } }],
+        },
+        {
+            text: "This is the offline demo: I'm a scripted brain attached to the real Exempclaw runtime — real tool loop, real approval gates, real memory, fictional Initech workspace, no API key. Things worth trying:\n\n" +
+                '- "Anything from Initech overnight?" — a full triage: search, read, draft, and an outward email that asks for your approval\n' +
+                '- "What are my priorities this week?"\n' +
+                '- "Are you an AI?" — the disclosure policy at work\n' +
+                "- /memory, /cost, /help — operator commands\n\n" +
+                "When you connect a real key, the same agent runs on Claude instead of this script.",
+        },
+    ],
+};
+// Order matters: specific intents (identity, memory, priorities) win before
+// the broad triage matcher, which also fires on bare "initech"/"inbox".
+const SCENARIOS = [IDENTITY, MEMORY, PRIORITIES, TRIAGE, FALLBACK];
+export class DemoClaude {
+    latencyMs;
+    streamDelayMs;
+    toolCounter = 0;
+    constructor(opts = {}) {
+        this.latencyMs = opts.latencyMs ?? 700;
+        this.streamDelayMs = opts.streamDelayMs ?? 16;
+    }
+    async turn(params) {
+        const { text: userText, assistantTurnsSince, denied } = analyzeMessages(params.messages);
+        const scenario = SCENARIOS.find((s) => s.match.test(userText)) ?? FALLBACK;
+        const turn = scenario.turns[Math.min(assistantTurnsSince, scenario.turns.length - 1)];
+        await sleep(this.latencyMs, params.signal);
+        throwIfAborted(params.signal);
+        const content = [];
+        const text = typeof turn.text === "function" ? turn.text({ denied }) : turn.text;
+        if (text) {
+            await this.streamText(text, params.onText, params.signal);
+            content.push({ type: "text", text, citations: null });
+        }
+        if (turn.status) {
+            content.push(this.toolUse("display_status", { activity: turn.status.activity, message: turn.status.message }));
+        }
+        for (const tool of turn.tools ?? []) {
+            content.push(this.toolUse(tool.name, tool.input));
+        }
+        const hasTools = content.some((b) => b.type === "tool_use");
+        return {
+            id: `msg_demo_${++this.toolCounter}`,
+            type: "message",
+            role: "assistant",
+            model: params.model ?? "claude-demo",
+            content,
+            stop_reason: hasTools ? "tool_use" : "end_turn",
+            stop_sequence: null,
+            usage: fabricateUsage(params.messages.length, assistantTurnsSince, text?.length ?? 0),
+        };
+    }
+    async summarize() {
+        await sleep(this.latencyMs / 2);
+        return "Demo summary: earlier turns covered Initech triage — Ana confirmed the staging webhook fix, a reply was drafted, and the September renewal context was recorded.";
+    }
+    toolUse(name, input) {
+        return { type: "tool_use", id: `toolu_demo_${++this.toolCounter}`, name, input };
+    }
+    async streamText(text, onText, signal) {
+        if (!onText)
+            return;
+        if (this.streamDelayMs <= 0) {
+            onText(text);
+            return;
+        }
+        for (const word of text.split(/(?<=\s)/)) {
+            throwIfAborted(signal);
+            onText(word);
+            await sleep(this.streamDelayMs, signal);
+        }
+    }
+}
+/** Finds the operator's last real message, turns since it, and denial state. */
+export function analyzeMessages(messages) {
+    let text = "";
+    let assistantTurnsSince = 0;
+    let denied = false;
+    let foundUser = false;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg.role === "assistant") {
+            if (!foundUser)
+                assistantTurnsSince++;
+            continue;
+        }
+        if (typeof msg.content === "string") {
+            text = msg.content;
+            foundUser = true;
+            break;
+        }
+        const toolResults = msg.content.filter((b) => b.type === "tool_result");
+        if (toolResults.length > 0) {
+            if (!foundUser) {
+                for (const result of toolResults) {
+                    const body = typeof result.content === "string" ? result.content : JSON.stringify(result.content ?? "");
+                    if (result.is_error && /denied/i.test(body))
+                        denied = true;
+                }
+            }
+            continue;
+        }
+        const textBlock = msg.content.find((b) => b.type === "text");
+        if (textBlock && textBlock.type === "text") {
+            text = textBlock.text;
+            foundUser = true;
+            break;
+        }
+    }
+    return { text, assistantTurnsSince, denied };
+}
+function fabricateUsage(messageCount, step, outputChars) {
+    const input = 900 + messageCount * 240;
+    return {
+        input_tokens: step === 0 ? input : Math.round(input * 0.12),
+        output_tokens: Math.max(60, Math.round(outputChars / 3.5) + 90),
+        cache_read_input_tokens: step === 0 ? 0 : Math.round(input * 0.88),
+        cache_creation_input_tokens: step === 0 ? Math.round(input * 0.6) : 120,
+    };
+}
+function sleep(ms, signal) {
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        const timer = setTimeout(done, ms);
+        function done() {
+            signal?.removeEventListener("abort", done);
+            clearTimeout(timer);
+            resolve();
+        }
+        signal?.addEventListener("abort", done, { once: true });
+    });
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw new Error("aborted");
+}
+//# sourceMappingURL=claude.js.map

package/dist/demo/claude.js.map

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

package/dist/demo/demo-connector.d.ts

@@ -0,0 +1,19 @@
+import type { Connector, ConnectorContext } from "../connectors/connector.js";
+import { type Tool } from "../tools/tool.js";
+import { DemoWorld } from "./world.js";
+/**
+ * The demo connector: the same email/Slack tool surface as the real
+ * connectors (same names, same schemas, same outward gating), backed by the
+ * fictional DemoWorld instead of IMAP/Slack. Needs no credentials.
+ *
+ * It exists for demo mode, but it's also handy as a sandbox: point any agent
+ * (including one running on the real Claude API) at `"connectors": ["demo"]`
+ * and let it act on the fictional workspace safely.
+ */
+export declare class DemoConnector implements Connector {
+    readonly id = "demo";
+    readonly world: DemoWorld;
+    private log;
+    init(ctx: ConnectorContext): Promise<void>;
+    tools(): Tool[];
+}

package/dist/demo/demo-connector.js

@@ -0,0 +1,168 @@
+import { z } from "zod";
+import { defineTool } from "../tools/tool.js";
+import { DemoWorld } from "./world.js";
+/**
+ * The demo connector: the same email/Slack tool surface as the real
+ * connectors (same names, same schemas, same outward gating), backed by the
+ * fictional DemoWorld instead of IMAP/Slack. Needs no credentials.
+ *
+ * It exists for demo mode, but it's also handy as a sandbox: point any agent
+ * (including one running on the real Claude API) at `"connectors": ["demo"]`
+ * and let it act on the fictional workspace safely.
+ */
+export class DemoConnector {
+    id = "demo";
+    world = new DemoWorld();
+    log;
+    async init(ctx) {
+        this.log = ctx.log.child({ scope: "connector", connector: this.id });
+        this.log.debug("demo connector ready (fictional workspace, no credentials)");
+    }
+    tools() {
+        const world = this.world;
+        const listInbox = defineTool({
+            name: "email_list_inbox",
+            description: "List recent inbox messages (newest first) with their uid, sender, subject, and read state.",
+            schema: z.object({
+                limit: z.number().int().min(1).max(50).default(10),
+                unreadOnly: z.boolean().default(false),
+            }),
+            execute: async (input) => {
+                const rows = world.emails
+                    .filter((e) => (input.unreadOnly ? !e.seen : true))
+                    .slice(-input.limit)
+                    .reverse()
+                    .map((e) => `uid=${e.uid}${e.seen ? "" : " [unread]"} ${e.date} from ${e.from} — ${e.subject} messageId=${e.messageId}`);
+                return { content: rows.length ? rows.join("\n") : "Inbox is empty." };
+            },
+        });
+        const readMessage = defineTool({
+            name: "email_read_message",
+            description: "Read one email in full by its uid (from email_list_inbox or email_search).",
+            schema: z.object({ uid: z.number().int().min(1) }),
+            execute: async (input) => {
+                const mail = world.findEmail(input.uid);
+                if (!mail)
+                    return { content: `No message with uid ${input.uid}.`, isError: true };
+                return {
+                    content: [
+                        `uid=${mail.uid}`,
+                        `From: ${mail.from}`,
+                        `To: ${mail.to}`,
+                        `Date: ${mail.date}`,
+                        `Subject: ${mail.subject}`,
+                        `messageId: ${mail.messageId}`,
+                        "",
+                        mail.body,
+                    ].join("\n"),
+                };
+            },
+        });
+        const searchMail = defineTool({
+            name: "email_search",
+            description: "Search the inbox by sender, subject, body text, and/or age. Returns matching messages, newest first.",
+            schema: z.object({
+                from: z.string().optional(),
+                subject: z.string().optional(),
+                text: z.string().optional(),
+                sinceDays: z.number().int().min(1).max(365).optional(),
+                limit: z.number().int().min(1).max(50).default(10),
+            }),
+            execute: async (input) => {
+                const hits = world.searchEmails(input).slice(-input.limit).reverse();
+                if (hits.length === 0)
+                    return { content: "No matching messages." };
+                return {
+                    content: hits
+                        .map((e) => `uid=${e.uid}${e.seen ? "" : " [unread]"} ${e.date} from ${e.from} — ${e.subject} messageId=${e.messageId}`)
+                        .join("\n"),
+                };
+            },
+        });
+        const markRead = defineTool({
+            name: "email_mark_read",
+            description: "Mark a message as read (seen) by uid once you've handled it.",
+            schema: z.object({ uid: z.number().int().min(1) }),
+            execute: async (input) => {
+                const mail = world.findEmail(input.uid);
+                if (!mail)
+                    return { content: `No message with uid ${input.uid}.`, isError: true };
+                mail.seen = true;
+                return { content: `Marked uid ${input.uid} as read.` };
+            },
+        });
+        const sendEmail = defineTool({
+            name: "email_send",
+            description: "Send an email. To reply within a thread, pass the original message's messageId as inReplyTo. Acts outward; requires approval.",
+            outward: true,
+            schema: z.object({
+                to: z.array(z.string().email()).min(1),
+                cc: z.array(z.string().email()).default([]),
+                subject: z.string().min(1),
+                body: z.string().min(1),
+                inReplyTo: z.string().optional(),
+            }),
+            execute: async (input) => {
+                world.sendEmail({ to: input.to, subject: input.subject, body: input.body, inReplyTo: input.inReplyTo });
+                return { content: `Sent "${input.subject}" to ${input.to.join(", ")} (id <demo-sent-${world.sentEmails.length}@acme.example>).` };
+            },
+        });
+        const listChannels = defineTool({
+            name: "slack_list_channels",
+            description: "List Slack channels the agent can see (id and name).",
+            schema: z.object({ limit: z.number().int().min(1).max(200).default(50) }),
+            execute: async () => ({
+                content: world.channels.map((c) => `${c.id}  #${c.name} (member)`).join("\n"),
+            }),
+        });
+        const readChannel = defineTool({
+            name: "slack_read_channel",
+            description: "Read recent messages from a Slack channel (newest last). Accepts a channel id or #name.",
+            schema: z.object({ channel: z.string(), limit: z.number().int().min(1).max(100).default(20) }),
+            execute: async (input) => {
+                const channel = world.findChannel(input.channel);
+                if (!channel)
+                    return { content: `channel not found: ${input.channel}`, isError: true };
+                const rows = channel.messages.slice(-input.limit).map((m) => `[ts=${m.ts}] ${m.user}: ${m.text}`);
+                return { content: `channel=${channel.id}\n${rows.join("\n")}` };
+            },
+        });
+        const readThread = defineTool({
+            name: "slack_read_thread",
+            description: "Read a Slack thread by its channel and root thread_ts (newest last).",
+            schema: z.object({
+                channel: z.string(),
+                threadTs: z.string(),
+                limit: z.number().int().min(1).max(100).default(50),
+            }),
+            execute: async (input) => {
+                const channel = world.findChannel(input.channel);
+                if (!channel)
+                    return { content: `channel not found: ${input.channel}`, isError: true };
+                const rows = channel.messages
+                    .filter((m) => m.ts === input.threadTs || m.threadTs === input.threadTs)
+                    .map((m) => `[ts=${m.ts}] ${m.user}: ${m.text}`);
+                return { content: rows.length ? rows.join("\n") : "(empty thread)" };
+            },
+        });
+        const postMessage = defineTool({
+            name: "slack_post_message",
+            description: "Post a message to a Slack channel, or reply in a thread by passing threadTs. Acts outward; requires approval.",
+            outward: true,
+            schema: z.object({
+                channel: z.string(),
+                text: z.string().min(1),
+                threadTs: z.string().optional(),
+            }),
+            execute: async (input) => {
+                const channel = world.findChannel(input.channel);
+                if (!channel)
+                    return { content: `channel not found: ${input.channel}`, isError: true };
+                const ts = world.postMessage(channel, input.text, input.threadTs);
+                return { content: `Posted to ${channel.id} at ts=${ts}.` };
+            },
+        });
+        return [listInbox, readMessage, searchMail, markRead, sendEmail, listChannels, readChannel, readThread, postMessage];
+    }
+}
+//# sourceMappingURL=demo-connector.js.map

package/dist/demo/demo-connector.js.map

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

package/dist/demo/world.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The fictional workspace behind demo mode: a small, consistent Initech
+ * support universe. The demo connector's tools read and write this world, so
+ * the experience (uids, messageIds, thread replies) looks exactly like the
+ * real connectors — but nothing leaves the process.
+ */
+export interface DemoEmail {
+    uid: number;
+    from: string;
+    to: string;
+    subject: string;
+    date: string;
+    messageId: string;
+    body: string;
+    seen: boolean;
+}
+export interface DemoSlackMessage {
+    user: string;
+    text: string;
+    ts: string;
+    threadTs?: string;
+}
+export interface DemoSlackChannel {
+    id: string;
+    name: string;
+    messages: DemoSlackMessage[];
+}
+export interface SentEmail {
+    to: string[];
+    subject: string;
+    body: string;
+    inReplyTo?: string;
+    at: string;
+}
+export declare class DemoWorld {
+    readonly emails: DemoEmail[];
+    readonly channels: DemoSlackChannel[];
+    readonly sentEmails: SentEmail[];
+    readonly postedMessages: Array<{
+        channel: string;
+        text: string;
+        threadTs?: string;
+        ts: string;
+    }>;
+    private nextTs;
+    findEmail(uid: number): DemoEmail | undefined;
+    searchEmails(query: {
+        from?: string;
+        subject?: string;
+        text?: string;
+    }): DemoEmail[];
+    findChannel(ref: string): DemoSlackChannel | undefined;
+    sendEmail(mail: Omit<SentEmail, "at">): SentEmail;
+    postMessage(channel: DemoSlackChannel, text: string, threadTs?: string): string;
+}
+/** Memories seeded into a fresh demo agent, consistent with the world above. */
+export declare const DEMO_SEED_MEMORIES: Array<{
+    text: string;
+    tags: string[];
+}>;

package/dist/demo/world.js

@@ -0,0 +1,117 @@
+/**
+ * The fictional workspace behind demo mode: a small, consistent Initech
+ * support universe. The demo connector's tools read and write this world, so
+ * the experience (uids, messageIds, thread replies) looks exactly like the
+ * real connectors — but nothing leaves the process.
+ */
+export class DemoWorld {
+    emails = [
+        {
+            uid: 4709,
+            from: "Marcus Webb <marcus@acme.example>",
+            to: "support@acme.example",
+            subject: "FYI — Initech renewal kickoff in September",
+            date: "2026-06-10T15:20:00Z",
+            messageId: "<m-4709@acme.example>",
+            body: "Heads up: Initech's finance team starts the renewal conversation in early September. " +
+                "Ana hinted they'll push for volume pricing. Let's have the one-pager ready before then.\n\n— Marcus",
+            seen: true,
+        },
+        {
+            uid: 4710,
+            from: "StatusBot <alerts@acme.example>",
+            to: "support@acme.example",
+            subject: "[resolved] elevated webhook retry latency",
+            date: "2026-06-11T22:41:00Z",
+            messageId: "<m-4710@acme.example>",
+            body: "The staging fix for webhook retry drops deployed cleanly at 22:30 UTC. Error rate back to baseline.",
+            seen: true,
+        },
+        {
+            uid: 4711,
+            from: "Ana Flores <ana.flores@initech.example>",
+            to: "support@acme.example",
+            subject: "Re: webhook retries dropping events",
+            date: "2026-06-12T06:55:00Z",
+            messageId: "<m-4711@initech.example>",
+            body: "Morning — we ran our soak test against staging overnight and the dropped-event rate is zero. " +
+                "Looks like your fix holds. Two asks:\n\n" +
+                "1. When does it land in production? Our finance close runs on these webhooks.\n" +
+                "2. Could you send the volume-pricing one-pager before our renewal kickoff in September?\n\nThanks,\nAna",
+            seen: false,
+        },
+    ];
+    channels = [
+        {
+            id: "C0DEMO1",
+            name: "support",
+            messages: [
+                { user: "priya", text: "Quiet night — two password resets, both self-served.", ts: "1765531200.000100" },
+                {
+                    user: "marcus",
+                    text: "If Ana confirms the staging fix, let's get the prod date locked today.",
+                    ts: "1765537200.000200",
+                },
+            ],
+        },
+        {
+            id: "C0DEMO2",
+            name: "initech-account",
+            messages: [
+                {
+                    user: "marcus",
+                    text: "Renewal kickoff is September. Volume pricing one-pager is the ask — drafting with finance.",
+                    ts: "1765520000.000300",
+                },
+                {
+                    user: "engineering-bot",
+                    text: "webhook-retry fix: staging soak PASSED (0 drops / 48h). Prod rollout proposed for Thursday.",
+                    ts: "1765540000.000400",
+                },
+            ],
+        },
+    ];
+    sentEmails = [];
+    postedMessages = [];
+    nextTs = 1765550000;
+    findEmail(uid) {
+        return this.emails.find((e) => e.uid === uid);
+    }
+    searchEmails(query) {
+        const norm = (s) => s.toLowerCase();
+        return this.emails.filter((e) => {
+            if (query.from && !norm(e.from).includes(norm(query.from)))
+                return false;
+            if (query.subject && !norm(e.subject).includes(norm(query.subject)))
+                return false;
+            if (query.text && !norm(e.body).includes(norm(query.text)))
+                return false;
+            return true;
+        });
+    }
+    findChannel(ref) {
+        const name = ref.replace(/^#/, "").toLowerCase();
+        return this.channels.find((c) => c.id === ref || c.name === name);
+    }
+    sendEmail(mail) {
+        const sent = { ...mail, at: new Date().toISOString() };
+        this.sentEmails.push(sent);
+        return sent;
+    }
+    postMessage(channel, text, threadTs) {
+        const ts = `${this.nextTs++}.000000`;
+        channel.messages.push({ user: "jordan (you)", text, ts, ...(threadTs ? { threadTs } : {}) });
+        this.postedMessages.push({ channel: channel.id, text, ts, ...(threadTs ? { threadTs } : {}) });
+        return ts;
+    }
+}
+/** Memories seeded into a fresh demo agent, consistent with the world above. */
+export const DEMO_SEED_MEMORIES = [
+    { text: "Initech is our largest account; Ana Flores is the main contact and prefers email.", tags: ["initech", "ana"] },
+    { text: "Initech's renewal conversation starts early September; they want a volume-pricing one-pager first.", tags: ["initech", "renewal", "deadline"] },
+    { text: "Marcus Webb is the account executive for Initech — loop him in on anything commercial (#initech-account).", tags: ["marcus", "initech"] },
+    { text: "Billing disputes over $500 are escalated to Sam in Billing; never promise refunds directly.", tags: ["process", "billing"] },
+    { text: "The weekly support summary goes out Mondays before noon.", tags: ["process", "recurring"] },
+    { text: "Never commit to engineering timelines in writing; say you'll check with the team and come back.", tags: ["process", "convention"] },
+];
+//# sourceMappingURL=world.js.map

package/dist/demo/world.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};