managed-deepagents 0.9.6-dev.13 → 0.9.6-dev.15

package/dist/channels/delivery.js

@@ -0,0 +1,196 @@
+/**
+ * The run's one delivery step: when the run ends, its answer goes to the
+ * thread's origin, and a paused Trigger run reports what it waits on.
+ *
+ * The run does it, not the process that received the event, so a restart of
+ * that process loses nothing, and a run LangSmith Studio resumes answers the
+ * conversation the paused run came from.
+ */
+import { randomUUID } from "node:crypto";
+import { v5 as uuidv5 } from "uuid";
+import { z } from "zod";
+import { triggerTargetSchema } from "../runtime/thread-record.js";
+import { logger } from "../runtime/log.js";
+import { QUIET_REPLY, extractReplyContent, extractReplyText, } from "./assistant-text.js";
+import { channelAutoRepliesForName, messagingTransportForName, pausedNoticeForName, } from "./messaging-registry.js";
+import { createTriggerClient } from "./trigger/client.js";
+import { resolveTracerSessionId } from "./trigger/tracing-project.js";
+import { createTriggerTransport } from "./trigger/transport.js";
+/**
+ * Deliver a finished top-level run's result to its thread's origin. A thread
+ * without an origin gets nothing.
+ *
+ * Failures follow what each channel did before: a Trigger post and any
+ * scheduled delivery fail the run; a direct channel's post is logged and the
+ * run still succeeds.
+ */
+export async function deliverRunResult(graph, run, 
+/** The Agent Server run and its assistant, for notices and their links. */
+{ runId, assistantId } = {}) {
+    const { thread, origin } = run;
+    if (!thread || !origin)
+        return;
+    const config = { configurable: { thread_id: thread.id } };
+    const state = await graph.getState(config);
+    const interrupts = pendingInterrupts(state);
+    if (interrupts.length) {
+        if (origin.transport === "trigger_server")
+            await reportInterrupted(origin, thread.id, runId, interrupts);
+        else
+            await noticePaused(origin, thread.id, assistantId);
+        return;
+    }
+    // A static breakpoint stopped the run before it finished: no answer yet.
+    if (state.next.length > 0)
+        return;
+    // A channel declared with `reply: "none"` leaves replying to the agent.
+    if (!channelAutoRepliesForName(origin.name))
+        return;
+    const values = { messages: messagesOf(state.values) };
+    const boundary = await replyBoundary(graph, config, values.messages);
+    if (extractReplyText(values, boundary).trim() === QUIET_REPLY)
+        return;
+    const content = origin.transport === "trigger_server"
+        ? extractReplyText(values, boundary) || null
+        : extractReplyContent(values, boundary);
+    if (content === null)
+        return;
+    const scheduled = origin.event?.type === "schedule";
+    try {
+        await post(origin, content, runId);
+    }
+    catch (error) {
+        if (scheduled || origin.transport === "trigger_server")
+            throw error;
+        // The answer stays in the thread; the run itself succeeded.
+        logger.error(`channel reply failed (${logger.safeErrorLabel(error)})`);
+    }
+}
+async function post(origin, content, runId) {
+    const newThread = origin.event?.type === "schedule" ? origin.event.new_thread : undefined;
+    const message = { type: "content", content };
+    if (origin.transport === "trigger_server") {
+        const client = createTriggerClient();
+        if (!client)
+            throw new Error("channel delivery is not configured");
+        // A retried run posts its answer once.
+        await createTriggerTransport(client, {
+            actionId: runId ? replyActionId(runId) : randomUUID(),
+        }).post({ message, target: origin.target, newThread });
+        return;
+    }
+    const transport = messagingTransportForName(origin.name);
+    if (!transport)
+        throw new Error(`channel delivery is unavailable: no channel ${JSON.stringify(logger.logIdentifier(origin.name))}`);
+    await transport.post({
+        message,
+        target: origin.target,
+        ...(newThread !== undefined && { newThread }),
+    });
+}
+/** The Trigger post id for a run's answer, stable across retries. */
+export function replyActionId(runId) {
+    return uuidv5(`mda-reply:${runId}`, uuidv5.URL);
+}
+/**
+ * Where the run's messages start: after the last message of the latest
+ * checkpoint the run's input made. A resume makes none, so it counts from the
+ * paused run's input. Without one, the reply falls back to the answers since
+ * the last user message.
+ */
+async function replyBoundary(graph, config, messages) {
+    let input;
+    for await (const snapshot of graph.getStateHistory(config, {
+        filter: { source: "input" },
+        limit: 1,
+    })) {
+        input = snapshot;
+        break;
+    }
+    // A checkpointer may ignore the filter.
+    if (input?.metadata?.source !== "input")
+        return {};
+    const before = messagesOf(input.values);
+    const afterId = Array.isArray(before) ? messageId(before.at(-1)) : undefined;
+    const final = Array.isArray(messages) ? messages : [];
+    return afterId !== undefined &&
+        final.some((message) => messageId(message) === afterId)
+        ? { afterId }
+        : {};
+}
+/** The `messages` of graph state values, when they are an object. */
+function messagesOf(values) {
+    return isObject(values) ? values.messages : undefined;
+}
+function messageId(message) {
+    const id = isObject(message) ? message.id : undefined;
+    return typeof id === "string" && id ? id : undefined;
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null;
+}
+/** An interrupt Trigger can resume: a non-blank id, with its value. */
+const interruptSchema = z.object({
+    id: z.string().refine((id) => id.trim().length > 0),
+    value: z.unknown(),
+    response_schema: z.unknown().optional(),
+});
+/** The interrupts the run stopped on, as Trigger forwards them. */
+function pendingInterrupts(state) {
+    return state.tasks.flatMap((task) => (task.interrupts ?? []).flatMap((entry) => {
+        const parsed = interruptSchema.safeParse(entry);
+        if (!parsed.success)
+            return [];
+        const { id, value, response_schema: schema } = parsed.data;
+        return [
+            { id, value, ...(isObject(schema) && { response_schema: schema }) },
+        ];
+    }));
+}
+/**
+ * Tell a direct channel's conversation the run waits on a decision, with a
+ * Studio link to this thread, when the channel has such a notice. Best
+ * effort: it never fails the run.
+ */
+async function noticePaused(origin, threadId, assistantId) {
+    const notice = pausedNoticeForName(origin.name);
+    if (!notice)
+        return;
+    try {
+        await notice(origin.target, { threadId, ...(assistantId && { assistantId }) }, "interrupted");
+    }
+    catch (error) {
+        logger.error(`channel paused notice failed (${logger.safeErrorLabel(error)})`);
+    }
+}
+/** Tell Trigger the run waits on a decision. Best effort: it never fails the run. */
+async function reportInterrupted(origin, threadId, runId, interrupts) {
+    const target = triggerTargetSchema.safeParse(origin.target);
+    try {
+        if (!target.success) {
+            logger.warn("channel interrupt was not reported: invalid Trigger target");
+            return;
+        }
+        const client = createTriggerClient();
+        if (!client || !runId) {
+            logger.warn("channel interrupt was not reported: no run or transport");
+            return;
+        }
+        const tracerSessionId = await resolveTracerSessionId();
+        await client.postRuntimeEvent(target.data.channel_id, {
+            id: randomUUID(),
+            type: "run.interrupted",
+            delivery_id: origin.deliveryId,
+            source_thread_key: origin.sourceThreadKey,
+            address: target.data.address,
+            run_thread_id: threadId,
+            run_id: runId,
+            interrupts,
+            ...(tracerSessionId ? { tracer_session_id: tracerSessionId } : {}),
+        });
+    }
+    catch (error) {
+        logger.warn(`channel interrupt was not reported (${logger.safeErrorLabel(error)})`);
+    }
+}
+//# sourceMappingURL=delivery.js.map

package/dist/channels/delivery.js.map

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

package/dist/channels/github/connections.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Reserved agent connection for the deployment's GitHub App: reading it
+ * returns an installation token for the App `mda deploy` set up.
+ */
+export declare const GITHUB_TOKEN_SLUG = "mda/github-token";
+/**
+ * The deployment's GitHub App connection, or one of the App values stored
+ * beside it (`webhook-secret`, `bot-id`) when `suffix` is given.
+ */
+export declare function githubAppConnectionSlug(deploymentId: string, suffix?: string): string;
+//# sourceMappingURL=connections.d.ts.map

package/dist/channels/github/connections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../../src/channels/github/connections.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAER"}

package/dist/channels/github/connections.js

@@ -0,0 +1,14 @@
+import { appConnectionSlug } from "../http/provider.js";
+/**
+ * Reserved agent connection for the deployment's GitHub App: reading it
+ * returns an installation token for the App `mda deploy` set up.
+ */
+export const GITHUB_TOKEN_SLUG = "mda/github-token";
+/**
+ * The deployment's GitHub App connection, or one of the App values stored
+ * beside it (`webhook-secret`, `bot-id`) when `suffix` is given.
+ */
+export function githubAppConnectionSlug(deploymentId, suffix) {
+    return appConnectionSlug("github", deploymentId, suffix);
+}
+//# sourceMappingURL=connections.js.map

package/dist/channels/github/connections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections.js","sourceRoot":"","sources":["../../../src/channels/github/connections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAEpD;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,YAAoB,EACpB,MAAe;IAEf,OAAO,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC"}

package/dist/channels/github/index.d.ts

@@ -0,0 +1,8 @@
+import { type HttpChannel } from "../http/index.js";
+import type { GitHubChannelOptions } from "./types.js";
+export type { GitHubAppOptions, GitHubChannelOptions, GitHubChannelThread, GitHubEvent, GitHubEventCallback, GitHubEventResult, PayloadFor, SupportedEventKey, } from "./types.js";
+/** Adapt verified GitHub events into HTTP channel messages or skips. */
+export declare function githubChannel(options?: GitHubChannelOptions): HttpChannel;
+/** Forget values read from Agent Auth; for tests. */
+export declare function resetGitHubAppValues(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/channels/github/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/channels/github/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,WAAW,EAKjB,MAAM,kBAAkB,CAAC;AAiC1B,OAAO,KAAK,EAEV,oBAAoB,EAIrB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAWpB,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,WAAW,CA0D7E;AAmDD,qDAAqD;AACrD,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/channels/github/index.js

@@ -0,0 +1,274 @@
+import { channelThreadId, httpChannel, } from "../http/index.js";
+import { channelName, checkEventKeys, definedFields, eventSnapshot, handledEventKeys, readDeploymentSecret, resetDeploymentSecrets, resolveEndpoints, runEventHandler, eventThread, finishEvents, receiveEvents, verifyHmacSha256, } from "../http/provider.js";
+import { isEndpointCallback } from "../http/endpoint.js";
+import { interruptedNotice, pendingDecision } from "../http/studio.js";
+import { withPausedNotice } from "../messaging-registry.js";
+import { logger } from "../../runtime/log.js";
+import { connections } from "../../connections.js";
+import { ConnectionsNotConfiguredError } from "../../agent-auth.js";
+import { GITHUB_TOKEN_SLUG, githubAppConnectionSlug } from "./connections.js";
+import { ENDPOINT_EVENT_FIELDS, SUPPORTED_EVENT_KEYS, githubReceiptSchema, githubIdentifierSchema, githubEventSchema, } from "./schema.js";
+const EVENT_KEYS = new Set(SUPPORTED_EVENT_KEYS);
+/** Adapt verified GitHub events into HTTP channel messages or skips. */
+export function githubChannel(options = {}) {
+    const handlers = resolveEndpoints("GitHub", options.onEvent, ENDPOINT_EVENT_FIELDS);
+    checkEventKeys("GitHub", handlers, EVENT_KEYS);
+    // A misspelled option would silently widen what the agent's token reaches.
+    const unknown = Object.keys(options.app ?? {}).filter((key) => key !== "permissions" && key !== "repositories");
+    if (unknown.length)
+        throw new TypeError(`unknown GitHub app option ${unknown.join(", ")}; use permissions or repositories`);
+    // GitHub names are case-insensitive; deploy validates the rest.
+    const repositories = options.app?.repositories?.map((repository) => repository.trim().toLowerCase());
+    if (repositories?.length === 0)
+        throw new TypeError("GitHub app.repositories must list at least one repository; omit it to allow every repository");
+    const channel = httpChannel({
+        provider: "github",
+        ...(options.multitaskStrategy && {
+            multitaskStrategy: options.multitaskStrategy,
+        }),
+        providerConfig: {
+            // Deploy subscribes the GitHub App to the handled events.
+            events: handledEventKeys(handlers),
+            ...(options.app && { app: appConfig(options.app) }),
+        },
+        verify: verifyGitHubRequest,
+        parse: (context) => parseGitHubRequest(context, handlers, channelName(channel), repositories),
+        input: (message, rawEvent) => handlerInput(handlers, rawEvent, {
+            id: message.threadId,
+            channel: { name: channelName(channel) },
+        }),
+        onReceived: receiveEvents(options.onReceived, githubEvent, () => channelName(channel)),
+        onFinish: finishEvents((target, delivery) => notifyWaiting(handlers, target, delivery, channelName(channel)), options.onFinish, githubEvent, (delivery) => eventThread(delivery, channelName(channel))),
+    });
+    // A run that stops on interrupts says so itself (../delivery.ts): the
+    // handler accepted the event that started it.
+    return withPausedNotice(channel, postInterruptedNotice);
+}
+/**
+ * Tell the issue or pull request that a new event found its thread waiting
+ * on a decision. Only for an event its handler would act on, so the handler's
+ * filters, such as trusted senders or mentions, decide who gets a notice. The
+ * handler knows it is only asked, so it can skip side effects.
+ */
+async function notifyWaiting(handlers, target, delivery, name) {
+    if (pendingDecision(delivery) !== "waiting")
+        return;
+    if ((await handlerInput(handlers, delivery.rawEvent, {
+        id: delivery.threadId,
+        channel: { name },
+        interrupted: true,
+    })) === undefined)
+        return;
+    await postInterruptedNotice(target, delivery, "waiting");
+}
+/** The App options deploy reads, without unset fields. */
+function appConfig(app) {
+    return definedFields({
+        permissions: app.permissions && { ...app.permissions },
+        repositories: app.repositories && [...app.repositories],
+    });
+}
+/**
+ * The App's webhook secret or bot ID: the `GH_*` env override when set,
+ * otherwise the agent secret Agent Auth stored when `mda deploy` created the
+ * App, at `mda/github-app/{deployment}/{suffix}`. Only a missing connection
+ * reads as `undefined`; credential store failures propagate.
+ */
+function gitHubAppValue(envKey, suffix) {
+    return readDeploymentSecret(envKey, (deploymentId) => githubAppConnectionSlug(deploymentId, suffix), `GitHub App ${suffix}`);
+}
+/** Forget values read from Agent Auth; for tests. */
+export function resetGitHubAppValues() {
+    resetDeploymentSecrets();
+}
+/** GitHub's delivery ID for a log line, or `unknown` when it is not one. */
+function deliveryLabel(deliveryId) {
+    return deliveryId && /^[0-9a-fA-F-]{1,64}$/.test(deliveryId)
+        ? deliveryId
+        : "unknown";
+}
+async function verifyGitHubRequest({ request, rawBody, }) {
+    // GitHub pings a new App before Agent Auth has its webhook secret, and a
+    // ping starts nothing, so it needs no secret. Reading it here would also
+    // remember the secret as missing and reject the first real events.
+    if (request.headers.get("x-github-event") === "ping")
+        return true;
+    // Reject unsigned deliveries before reading the secret from Agent Auth.
+    const signature = request.headers.get("x-hub-signature-256") ?? "";
+    if (!/^sha256=[a-fA-F0-9]{64}$/.test(signature))
+        return false;
+    let secret;
+    try {
+        secret = await gitHubAppValue("GH_WEBHOOK_SECRET", "webhook-secret");
+    }
+    catch (error) {
+        if (error instanceof ConnectionsNotConfiguredError) {
+            // The message names only the missing setting, so it is safe to log.
+            logger.error(`GitHub delivery ${deliveryLabel(request.headers.get("x-github-delivery"))} ` +
+                `cannot be verified: ${error.message}`);
+        }
+        throw error;
+    }
+    if (!secret)
+        return false;
+    return verifyHmacSha256(secret, rawBody, signature.slice(7));
+}
+async function parseGitHubRequest({ request }, handlers, channelName, repositories) {
+    const envelope = githubReceiptSchema.parse({
+        event: request.headers.get("x-github-event"),
+        deliveryId: request.headers.get("x-github-delivery"),
+        payload: await request.json(),
+    });
+    const { event, deliveryId, payload } = envelope;
+    logReceipt(envelope);
+    const response = Response.json({ status: "received" }, { status: event === "ping" ? 200 : 202 });
+    // Events nothing handles stop here, before run creation.
+    // Events without an action, such as `push`, are keyed by their name.
+    const key = (payload.action === undefined ? event : `${event}.${payload.action}`);
+    if (!Object.hasOwn(handlers, key) || handlers[key] === undefined)
+        return { type: "ignore", response };
+    const parsedEvent = githubEventSchema.parse({ key, payload, deliveryId });
+    // Events from repositories the channel is not limited to start nothing.
+    if (repositories &&
+        !repositories.includes(parsedEvent.repository.fullName.toLowerCase()))
+        return { type: "ignore", response };
+    // Ignore the App's own activity to avoid triggering ourselves.
+    const configuredBotId = (await gitHubAppValue("GH_APP_BOT_ID", "bot-id")) ?? "";
+    if (!/^[1-9][0-9]*$/.test(configuredBotId))
+        throw new TypeError("GitHub App bot ID is unavailable; run `mda deploy` to store it or set GH_APP_BOT_ID");
+    const botId = githubIdentifierSchema.parse(Number(configuredBotId));
+    if (parsedEvent.sender.id === botId)
+        return { type: "ignore", response };
+    // Preserve the original event even if a callback modifies its argument.
+    const snapshot = eventSnapshot(parsedEvent, "GitHub");
+    // One thread per issue or pull request, so the agent keeps the
+    // conversation. Other events get their own thread, keyed by the delivery so
+    // a redelivery still finds the run it started.
+    const number = conversationNumber(parsedEvent);
+    const threadId = channelThreadId(channelName, number === undefined
+        ? `delivery/${deliveryId}`
+        : `${parsedEvent.repository.id}/${number}`);
+    const target = number === undefined
+        ? null
+        : { repository: parsedEvent.repository.fullName, number };
+    // What the run starts with is decided once MDA knows the thread takes a
+    // new turn.
+    return {
+        type: "message",
+        message: {
+            threadId,
+            userId: senderUserId(parsedEvent.sender),
+            target,
+            deliveryKey: deliveryId,
+            // An endpoint may take longer to answer than GitHub waits.
+            ...(isEndpointCallback(handlers[key]) && { background: true }),
+        },
+        rawEvent: snapshot,
+        response,
+    };
+}
+/**
+ * Who the run acts for. GitHub signs each delivery, so its sender is verified:
+ * a person acts as `github:<id>`, by the numeric ID that outlives login
+ * renames, and gets their own user memory where the agent allows it. Bots and
+ * organizations run as the channel.
+ */
+function senderUserId(sender) {
+    return sender.type === "User" ? `github:${sender.id}` : "mda:channel";
+}
+/** What the event's handler starts a run with; `undefined` when it skips or fails. */
+async function handlerInput(handlers, rawEvent, thread) {
+    const event = githubEvent(rawEvent);
+    const handler = event && Object.hasOwn(handlers, event.key)
+        ? handlers[event.key]
+        : undefined;
+    if (!event || !handler)
+        return undefined;
+    const outcome = await runEventHandler("GitHub", event, () => handler(event, thread));
+    return outcome.type === "input" ? outcome.input : undefined;
+}
+/** The parsed event a delivery carries, as handlers may change it. */
+function githubEvent(rawEvent) {
+    if (!rawEvent || typeof rawEvent !== "object" || Array.isArray(rawEvent))
+        return undefined;
+    const event = structuredClone(rawEvent);
+    return EVENT_KEYS.has(event.key) ? event : undefined;
+}
+/** The issue or pull request an event is about, if any. */
+function conversationNumber(event) {
+    const payload = event.payload;
+    for (const subject of ["issue", "pull_request"]) {
+        const number = payload[subject]
+            ?.number;
+        if (isIssueNumber(number))
+            return number;
+    }
+    // A CI run belongs to a pull request only when it ran for exactly one.
+    for (const run of ["workflow_run", "check_run", "check_suite"]) {
+        const pullRequests = payload[run]?.pull_requests;
+        if (Array.isArray(pullRequests) && pullRequests.length === 1) {
+            const number = pullRequests[0]?.number;
+            if (isIssueNumber(number))
+                return number;
+        }
+    }
+    return undefined;
+}
+function isIssueNumber(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+const REPOSITORY_PATTERN = /^[A-Za-z0-9-]+\/[A-Za-z0-9._-]+$/;
+const GITHUB_API_TIMEOUT_MS = 10_000;
+/**
+ * The thread waits on an interrupt, so tell the issue or pull request where
+ * to continue it. Posts as the App; the notice is fixed text.
+ */
+async function postInterruptedNotice(target, delivery, outcome) {
+    if (!isGitHubTarget(target))
+        return;
+    const [owner, name] = target.repository.split("/");
+    const token = await connections.resolveDeploymentSecret(GITHUB_TOKEN_SLUG);
+    const response = await fetch(`https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(name)}/issues/${target.number}/comments`, {
+        method: "POST",
+        headers: {
+            Accept: "application/vnd.github+json",
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+            "X-GitHub-Api-Version": "2022-11-28",
+        },
+        body: JSON.stringify({
+            body: interruptedNotice(outcome, delivery, "comment again"),
+        }),
+        signal: AbortSignal.timeout(GITHUB_API_TIMEOUT_MS),
+    });
+    if (!response.ok)
+        throw new Error(`GitHub refused the interrupted notice (HTTP ${response.status})`);
+}
+function isGitHubTarget(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const { repository, number } = value;
+    return (typeof repository === "string" &&
+        REPOSITORY_PATTERN.test(repository) &&
+        isIssueNumber(number));
+}
+function logReceipt({ event, deliveryId, payload, }) {
+    const receipt = {
+        event: logger.logIdentifier(event),
+        deliveryId: logger.logIdentifier(deliveryId),
+    };
+    if (payload.action !== undefined)
+        receipt.action = logger.logIdentifier(payload.action);
+    for (const [key, field] of [
+        ["repository", "id"],
+        ["issue", "number"],
+        ["pull_request", "number"],
+    ]) {
+        const id = payload[key]?.[field];
+        if (typeof id === "number")
+            receipt[key] = id;
+    }
+    logger.info(`github receipt ${JSON.stringify(receipt)}`);
+    return receipt;
+}
+//# sourceMappingURL=index.js.map

package/dist/channels/github/index.js.map

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

package/dist/channels/github/mentions.d.ts

@@ -0,0 +1,12 @@
+/** The handles an event's text mentions: GitHub sends no event for a mention. */
+import type { z } from "zod";
+import type { githubDispatchSchema } from "./schema.js";
+type DispatchEvent = z.output<typeof githubDispatchSchema>;
+/**
+ * The handles, such as `@octocat`, the text the event wrote mentions:
+ * lowercased, each once, in order. As on GitHub, code, quotes and HTML
+ * comments mention no one. An edit lists only the handles it added.
+ */
+export declare function eventMentions(event: DispatchEvent): string[];
+export {};
+//# sourceMappingURL=mentions.d.ts.map

package/dist/channels/github/mentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.d.ts","sourceRoot":"","sources":["../../../src/channels/github/mentions.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,KAAK,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAyD3D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CA0B5D"}