exempclaw 0.4.0

package/dist/connectors/notion/notion-connector.js

@@ -0,0 +1,222 @@
+import { z } from "zod";
+import { HttpJson } from "../http.js";
+import { ConnectorError } from "../../core/errors.js";
+import { defineTool } from "../../tools/tool.js";
+/**
+ * Notion connector over the REST API (internal-integration token). Read tools
+ * cover search and page content; write tools append to or create pages.
+ * Notion has no push channel for internal integrations, so this connector
+ * contributes no inbound events.
+ *
+ * Share the relevant pages/databases with the integration in Notion, or the
+ * API will return empty results.
+ */
+const NOTION_VERSION = "2022-06-28";
+export class NotionConnector {
+    fetchImpl;
+    id = "notion";
+    log;
+    api;
+    constructor(fetchImpl) {
+        this.fetchImpl = fetchImpl;
+    }
+    async init(ctx) {
+        this.log = ctx.log.child({ scope: "connector", connector: this.id });
+        const token = ctx.config.token;
+        if (!token) {
+            throw new ConnectorError(this.id, "missing NOTION_TOKEN (internal integration secret, ntn_… or secret_…)");
+        }
+        this.api = new HttpJson({
+            connector: this.id,
+            baseUrl: "https://api.notion.com/v1",
+            headers: { authorization: `Bearer ${token}`, "notion-version": NOTION_VERSION },
+            fetchImpl: this.fetchImpl,
+        });
+        this.log.info("notion connector ready");
+    }
+    tools() {
+        const search = defineTool({
+            name: "notion_search",
+            description: "Search Notion pages and databases the integration can access.",
+            schema: z.object({
+                query: z.string(),
+                limit: z.number().int().min(1).max(50).default(10),
+            }),
+            execute: async (input, ctx) => {
+                const res = await this.api.post("/search", {
+                    body: { query: input.query, page_size: input.limit },
+                    signal: ctx.signal,
+                });
+                if (res.results.length === 0)
+                    return { content: `No Notion results for "${input.query}".` };
+                return {
+                    content: res.results
+                        .map((r) => `${r.object} ${r.id}  "${resultTitle(r)}"  (edited ${r.last_edited_time ?? "?"})`)
+                        .join("\n"),
+                };
+            },
+        });
+        const getPage = defineTool({
+            name: "notion_get_page",
+            description: "Fetch a Notion page's title and content as plain text. Accepts a page id or URL.",
+            schema: z.object({ pageId: z.string() }),
+            execute: async (input, ctx) => {
+                const pageId = normalizePageId(input.pageId);
+                if (!pageId)
+                    return { content: `"${input.pageId}" is not a Notion page id or URL.`, isError: true };
+                const page = await this.api.get(`/pages/${pageId}`, { signal: ctx.signal });
+                const lines = [];
+                let cursor;
+                for (let i = 0; i < 3; i++) {
+                    const res = await this.api.get(`/blocks/${pageId}/children`, { query: { page_size: 100, ...(cursor ? { start_cursor: cursor } : {}) }, signal: ctx.signal });
+                    for (const block of res.results)
+                        lines.push(renderBlock(block));
+                    if (!res.has_more || !res.next_cursor)
+                        break;
+                    cursor = res.next_cursor;
+                }
+                return {
+                    content: [`# ${resultTitle(page)}`, page.url ?? "", "", ...lines.filter(Boolean)].join("\n"),
+                };
+            },
+        });
+        const appendBlock = defineTool({
+            name: "notion_append_block",
+            description: "Append markdown content to the end of a Notion page. Supports paragraphs, #/##/### headings, - bullets, 1. numbered lists, and > quotes. Acts outward; requires approval.",
+            outward: true,
+            schema: z.object({ pageId: z.string(), markdown: z.string().min(1) }),
+            execute: async (input, ctx) => {
+                const pageId = normalizePageId(input.pageId);
+                if (!pageId)
+                    return { content: `"${input.pageId}" is not a Notion page id or URL.`, isError: true };
+                const children = markdownToBlocks(input.markdown);
+                await this.api.patch(`/blocks/${pageId}/children`, { body: { children }, signal: ctx.signal });
+                return { content: `Appended ${children.length} block(s) to page ${pageId}.` };
+            },
+        });
+        const createPage = defineTool({
+            name: "notion_create_page",
+            description: "Create a new Notion page under a parent page. Acts outward; requires approval.",
+            outward: true,
+            schema: z.object({
+                parentPageId: z.string(),
+                title: z.string().min(1),
+                markdown: z.string().default(""),
+            }),
+            execute: async (input, ctx) => {
+                const parent = normalizePageId(input.parentPageId);
+                if (!parent)
+                    return { content: `"${input.parentPageId}" is not a Notion page id or URL.`, isError: true };
+                const res = await this.api.post("/pages", {
+                    body: {
+                        parent: { page_id: parent },
+                        properties: { title: { title: [{ type: "text", text: { content: input.title } }] } },
+                        ...(input.markdown ? { children: markdownToBlocks(input.markdown) } : {}),
+                    },
+                    signal: ctx.signal,
+                });
+                return { content: `Created page ${res.id}${res.url ? ` (${res.url})` : ""}.` };
+            },
+        });
+        return [search, getPage, appendBlock, createPage];
+    }
+}
+/** Accepts dashed/undashed UUIDs or a Notion URL; returns a dashed UUID. */
+export function normalizePageId(input) {
+    const match = /([0-9a-f]{8})-?([0-9a-f]{4})-?([0-9a-f]{4})-?([0-9a-f]{4})-?([0-9a-f]{12})/i.exec(input.trim());
+    if (!match)
+        return null;
+    return [match[1], match[2], match[3], match[4], match[5]].join("-").toLowerCase();
+}
+export function resultTitle(result) {
+    if (result.title?.length)
+        return joinRichText(result.title);
+    for (const prop of Object.values(result.properties ?? {})) {
+        if (prop.type === "title" && prop.title)
+            return joinRichText(prop.title);
+    }
+    return "(untitled)";
+}
+function joinRichText(rich) {
+    return rich.map((r) => r.plain_text ?? "").join("") || "(untitled)";
+}
+/** Renders one block to a plain-text line. Unknown types become markers. */
+export function renderBlock(block) {
+    const data = block[block.type];
+    const text = data?.rich_text ? joinRichTextLoose(data.rich_text) : "";
+    switch (block.type) {
+        case "paragraph":
+            return text;
+        case "heading_1":
+            return `# ${text}`;
+        case "heading_2":
+            return `## ${text}`;
+        case "heading_3":
+            return `### ${text}`;
+        case "bulleted_list_item":
+            return `- ${text}`;
+        case "numbered_list_item":
+            return `1. ${text}`;
+        case "to_do":
+            return `- [${data?.checked ? "x" : " "}] ${text}`;
+        case "quote":
+            return `> ${text}`;
+        case "code":
+            return `\`\`\`\n${text}\n\`\`\``;
+        case "callout":
+        case "toggle":
+            return text;
+        case "child_page":
+            return `[subpage: ${data?.title ?? block.id}]`;
+        case "divider":
+            return "---";
+        default:
+            return text ? text : `[${block.type}]`;
+    }
+}
+function joinRichTextLoose(rich) {
+    return rich.map((r) => r.plain_text ?? "").join("");
+}
+/** Converts simple markdown into Notion block objects. */
+export function markdownToBlocks(markdown) {
+    const blocks = [];
+    for (const rawLine of markdown.split("\n")) {
+        const line = rawLine.trimEnd();
+        if (!line.trim())
+            continue;
+        if (line.startsWith("### "))
+            blocks.push(textBlock("heading_3", line.slice(4)));
+        else if (line.startsWith("## "))
+            blocks.push(textBlock("heading_2", line.slice(3)));
+        else if (line.startsWith("# "))
+            blocks.push(textBlock("heading_1", line.slice(2)));
+        else if (line.startsWith("- ") || line.startsWith("* "))
+            blocks.push(textBlock("bulleted_list_item", line.slice(2)));
+        else if (/^\d+\.\s/.test(line))
+            blocks.push(textBlock("numbered_list_item", line.replace(/^\d+\.\s/, "")));
+        else if (line.startsWith("> "))
+            blocks.push(textBlock("quote", line.slice(2)));
+        else
+            blocks.push(textBlock("paragraph", line));
+    }
+    return blocks;
+}
+function textBlock(type, content) {
+    return {
+        object: "block",
+        type,
+        [type]: {
+            // Notion caps a single rich_text item at 2000 chars.
+            rich_text: chunkString(content, 2000).map((part) => ({ type: "text", text: { content: part } })),
+        },
+    };
+}
+function chunkString(text, size) {
+    if (text.length <= size)
+        return [text];
+    const parts = [];
+    for (let i = 0; i < text.length; i += size)
+        parts.push(text.slice(i, i + size));
+    return parts;
+}
+//# sourceMappingURL=notion-connector.js.map

package/dist/connectors/notion/notion-connector.js.map

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

package/dist/connectors/slack/slack-connector.d.ts

@@ -0,0 +1,43 @@
+import { type Connector, type ConnectorContext, type InboundEvent } from "../connector.js";
+import { type FetchLike } from "../http.js";
+import { type Tool } from "../../tools/tool.js";
+export declare class SlackConnector implements Connector {
+    private readonly fetchImpl?;
+    readonly id = "slack";
+    private log;
+    private api;
+    private appToken?;
+    private selfUserId;
+    private readonly channelIds;
+    private readonly userNames;
+    constructor(fetchImpl?: FetchLike | undefined);
+    init(ctx: ConnectorContext): Promise<void>;
+    /** Calls a Web API method, unwrapping Slack's {ok, error} envelope. */
+    private call;
+    /** Resolves "#name" or a bare name to a channel id; passes ids through. */
+    private resolveChannel;
+    private userName;
+    private renderMessages;
+    tools(): Tool[];
+    /** Socket Mode loop: connect, ack envelopes, surface mentions and DMs. */
+    listen(onEvent: (event: InboundEvent) => void, signal: AbortSignal): Promise<void>;
+    /** One WebSocket session. Resolves when the socket closes or signal aborts. */
+    private runSocket;
+}
+/** Shapes of the Socket Mode frames we care about. */
+export type SocketMessage = {
+    kind: "hello";
+} | {
+    kind: "disconnect";
+    reason?: string;
+} | {
+    kind: "event";
+    envelopeId: string;
+    eventId: string;
+    event: Record<string, unknown>;
+} | {
+    kind: "other";
+};
+export declare function parseSocketMessage(raw: string): SocketMessage;
+/** Maps a Slack event payload to an InboundEvent (or null if irrelevant). */
+export declare function slackEventToInbound(eventId: string, event: Record<string, unknown>, selfUserId: string): InboundEvent | null;

package/dist/connectors/slack/slack-connector.js

@@ -0,0 +1,291 @@
+import { z } from "zod";
+import { sleep } from "../connector.js";
+import { HttpJson } from "../http.js";
+import { ConnectorError } from "../../core/errors.js";
+import { defineTool } from "../../tools/tool.js";
+export class SlackConnector {
+    fetchImpl;
+    id = "slack";
+    log;
+    api;
+    appToken;
+    selfUserId = "";
+    channelIds = new Map();
+    userNames = new Map();
+    constructor(fetchImpl) {
+        this.fetchImpl = fetchImpl;
+    }
+    async init(ctx) {
+        this.log = ctx.log.child({ scope: "connector", connector: this.id });
+        const botToken = ctx.config.botToken;
+        if (!botToken) {
+            throw new ConnectorError(this.id, "missing SLACK_BOT_TOKEN (bot token, xoxb-…)");
+        }
+        this.appToken = ctx.config.appToken;
+        this.api = new HttpJson({
+            connector: this.id,
+            baseUrl: "https://slack.com/api",
+            headers: { authorization: `Bearer ${botToken}` },
+            fetchImpl: this.fetchImpl,
+        });
+        const auth = await this.call("auth.test", {});
+        this.selfUserId = auth.user_id;
+        this.log.info("slack connected", { team: auth.team, botUser: auth.user });
+    }
+    /** Calls a Web API method, unwrapping Slack's {ok, error} envelope. */
+    async call(method, args, signal) {
+        // Write methods accept JSON; read methods take query params. Slack allows
+        // GET with query for all the read methods used here.
+        const isWrite = method.startsWith("chat.") || method === "auth.test";
+        const response = isWrite
+            ? await this.api.post(`/${method}`, { body: args, signal })
+            : await this.api.get(`/${method}`, {
+                query: args,
+                signal,
+            });
+        if (!response.ok) {
+            throw new ConnectorError(this.id, `${method} failed: ${response.error ?? "unknown_error"}`, {
+                retryable: response.error === "ratelimited",
+            });
+        }
+        return response;
+    }
+    /** Resolves "#name" or a bare name to a channel id; passes ids through. */
+    async resolveChannel(channel, signal) {
+        const trimmed = channel.trim();
+        if (/^[CGD][A-Z0-9]{6,}$/.test(trimmed))
+            return trimmed;
+        const name = trimmed.replace(/^#/, "").toLowerCase();
+        const cached = this.channelIds.get(name);
+        if (cached)
+            return cached;
+        let cursor;
+        for (let page = 0; page < 5; page++) {
+            const res = await this.call("conversations.list", { types: "public_channel,private_channel", limit: 200, exclude_archived: true, cursor }, signal);
+            for (const ch of res.channels) {
+                if (ch.name)
+                    this.channelIds.set(ch.name.toLowerCase(), ch.id);
+            }
+            const hit = this.channelIds.get(name);
+            if (hit)
+                return hit;
+            cursor = res.response_metadata?.next_cursor || undefined;
+            if (!cursor)
+                break;
+        }
+        throw new ConnectorError(this.id, `channel not found: ${channel}`);
+    }
+    async userName(userId, signal) {
+        const cached = this.userNames.get(userId);
+        if (cached)
+            return cached;
+        try {
+            const res = await this.call("users.info", { user: userId }, signal);
+            const name = res.user.profile?.display_name || res.user.profile?.real_name || res.user.name;
+            this.userNames.set(userId, name);
+            return name;
+        }
+        catch {
+            return userId; // name resolution is best-effort
+        }
+    }
+    async renderMessages(messages, signal) {
+        const lines = [];
+        for (const msg of messages) {
+            const who = msg.bot_id ? `bot:${msg.bot_id}` : msg.user ? await this.userName(msg.user, signal) : "unknown";
+            const threadMark = msg.reply_count ? ` [thread with ${msg.reply_count} replies, thread_ts=${msg.ts}]` : "";
+            lines.push(`[ts=${msg.ts}] ${who}: ${msg.text ?? ""}${threadMark}`);
+        }
+        return lines.join("\n");
+    }
+    tools() {
+        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 (input, ctx) => {
+                const res = await this.call("conversations.list", { types: "public_channel,private_channel", limit: input.limit, exclude_archived: true }, ctx.signal);
+                if (res.channels.length === 0)
+                    return { content: "No channels visible." };
+                return {
+                    content: res.channels
+                        .map((c) => `${c.id}  #${c.name ?? "?"}${c.is_member ? " (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, ctx) => {
+                const channel = await this.resolveChannel(input.channel, ctx.signal);
+                const res = await this.call("conversations.history", { channel, limit: input.limit }, ctx.signal);
+                if (res.messages.length === 0)
+                    return { content: "No messages." };
+                const rendered = await this.renderMessages(res.messages.slice().reverse(), ctx.signal);
+                return { content: `channel=${channel}\n${rendered}` };
+            },
+        });
+        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().describe("The thread_ts of the root message."),
+                limit: z.number().int().min(1).max(100).default(50),
+            }),
+            execute: async (input, ctx) => {
+                const channel = await this.resolveChannel(input.channel, ctx.signal);
+                const res = await this.call("conversations.replies", { channel, ts: input.threadTs, limit: input.limit }, ctx.signal);
+                const rendered = await this.renderMessages(res.messages, ctx.signal);
+                return { content: `channel=${channel} thread_ts=${input.threadTs}\n${rendered}` };
+            },
+        });
+        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().describe("Channel id or #name."),
+                text: z.string().min(1),
+                threadTs: z.string().optional().describe("thread_ts of the root message to reply under."),
+            }),
+            execute: async (input, ctx) => {
+                const channel = await this.resolveChannel(input.channel, ctx.signal);
+                const res = await this.call("chat.postMessage", {
+                    channel,
+                    text: input.text,
+                    ...(input.threadTs ? { thread_ts: input.threadTs } : {}),
+                }, ctx.signal);
+                return { content: `Posted to ${res.channel} at ts=${res.ts}.` };
+            },
+        });
+        return [listChannels, readChannel, readThread, postMessage];
+    }
+    /** Socket Mode loop: connect, ack envelopes, surface mentions and DMs. */
+    async listen(onEvent, signal) {
+        if (!this.appToken) {
+            this.log.warn("SLACK_APP_TOKEN not set — slack inbound events disabled (tools still work)");
+            return;
+        }
+        const appApi = new HttpJson({
+            connector: this.id,
+            baseUrl: "https://slack.com/api",
+            headers: { authorization: `Bearer ${this.appToken}` },
+            fetchImpl: this.fetchImpl,
+        });
+        let backoffMs = 1000;
+        while (!signal.aborted) {
+            try {
+                const open = await appApi.post("/apps.connections.open", {
+                    signal,
+                });
+                if (!open.ok || !open.url) {
+                    throw new ConnectorError(this.id, `apps.connections.open failed: ${open.error ?? "unknown_error"}`);
+                }
+                this.log.info("slack socket connecting");
+                await this.runSocket(open.url, onEvent, signal);
+                backoffMs = 1000; // clean cycle — reset backoff
+            }
+            catch (err) {
+                if (signal.aborted)
+                    break;
+                this.log.warn("slack socket error; reconnecting", { error: err.message });
+                await sleep(backoffMs, signal);
+                backoffMs = Math.min(backoffMs * 2, 30_000);
+            }
+        }
+    }
+    /** One WebSocket session. Resolves when the socket closes or signal aborts. */
+    runSocket(url, onEvent, signal) {
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(url);
+            const close = () => ws.close();
+            signal.addEventListener("abort", close, { once: true });
+            const finish = (err) => {
+                signal.removeEventListener("abort", close);
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            };
+            ws.addEventListener("error", () => finish(new Error("websocket error")));
+            ws.addEventListener("close", () => finish());
+            ws.addEventListener("message", (msg) => {
+                const parsed = parseSocketMessage(String(msg.data));
+                if (parsed.kind === "disconnect") {
+                    this.log.debug("slack socket disconnect requested", { reason: parsed.reason });
+                    ws.close();
+                    return;
+                }
+                if (parsed.kind !== "event")
+                    return;
+                // Ack immediately — Slack retries unacked envelopes.
+                ws.send(JSON.stringify({ envelope_id: parsed.envelopeId }));
+                const event = slackEventToInbound(parsed.eventId, parsed.event, this.selfUserId);
+                if (event)
+                    onEvent(event);
+            });
+        });
+    }
+}
+export function parseSocketMessage(raw) {
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch {
+        return { kind: "other" };
+    }
+    if (data.type === "hello")
+        return { kind: "hello" };
+    if (data.type === "disconnect")
+        return { kind: "disconnect", reason: String(data.reason ?? "") };
+    if (data.type === "events_api" && typeof data.envelope_id === "string") {
+        const payload = (data.payload ?? {});
+        const event = (payload.event ?? {});
+        return {
+            kind: "event",
+            envelopeId: data.envelope_id,
+            eventId: String(payload.event_id ?? data.envelope_id),
+            event,
+        };
+    }
+    return { kind: "other" };
+}
+/** Maps a Slack event payload to an InboundEvent (or null if irrelevant). */
+export function slackEventToInbound(eventId, event, selfUserId) {
+    const type = String(event.type ?? "");
+    const user = typeof event.user === "string" ? event.user : "";
+    if (event.bot_id || user === selfUserId || !user)
+        return null;
+    if (event.subtype)
+        return null; // edits, joins, etc.
+    const channel = String(event.channel ?? "");
+    const ts = String(event.ts ?? event.event_ts ?? "");
+    const threadTs = typeof event.thread_ts === "string" ? event.thread_ts : ts;
+    const text = String(event.text ?? "");
+    const isMention = type === "app_mention";
+    const isDm = type === "message" && event.channel_type === "im";
+    if (!isMention && !isDm)
+        return null;
+    return {
+        connector: "slack",
+        type: isMention ? "slack.mention" : "slack.dm",
+        eventId,
+        threadId: `${channel}:${threadTs}`,
+        summary: [
+            `${isMention ? "Mention" : "Direct message"} from user ${user} in channel ${channel} (ts=${ts}, thread_ts=${threadTs}).`,
+            `Reply with slack_post_message using channel="${channel}" and threadTs="${threadTs}".`,
+            "",
+            text,
+        ].join("\n"),
+        payload: event,
+        receivedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=slack-connector.js.map

package/dist/connectors/slack/slack-connector.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Typed error hierarchy. Every thrown error in Exempclaw should be (or extend)
+ * an ExempclawError so the runtime can distinguish recoverable failures
+ * (rate limits, connector outages) from programming errors.
+ */
+export declare class ExempclawError extends Error {
+    /** Whether retrying the same operation could plausibly succeed. */
+    readonly retryable: boolean;
+    constructor(message: string, options?: {
+        retryable?: boolean;
+        cause?: unknown;
+    });
+}
+/** A required config value was missing or malformed. */
+export declare class ConfigError extends ExempclawError {
+}
+/** A connector (email, Slack, …) failed to reach its upstream service. */
+export declare class ConnectorError extends ExempclawError {
+    readonly connector: string;
+    constructor(connector: string, message: string, options?: {
+        retryable?: boolean;
+        cause?: unknown;
+    });
+}
+/** A tool threw while executing. Carried back into the agent loop as a tool_result error. */
+export declare class ToolExecutionError extends ExempclawError {
+    readonly tool: string;
+    constructor(tool: string, message: string, options?: {
+        retryable?: boolean;
+        cause?: unknown;
+    });
+}
+/** A human (or policy) denied an outward action. Not an error condition the model can retry. */
+export declare class ActionDeniedError extends ExempclawError {
+    constructor(message: string);
+}