oh-my-super-agent 0.1.0

package/dist/src/live-probes/gh-adapter.js

@@ -0,0 +1,188 @@
+import { isRecord, validateExistingDirectory } from "../utils/fs.js";
+export const MAX_GH_OUTPUT_BYTES = 1024 * 1024;
+const MAX_ISSUE_BODY_BYTES = 256 * 1024;
+const GITHUB_ISSUE_TARGETS = new WeakSet();
+export function normalizeGithubIssueTarget(input) {
+    const target = Object.freeze({
+        repository: validateRepository(input.repository),
+        readyLabel: validateLabel(input.readyLabel ?? "oms:ready"),
+        limit: validateLimit(input.limit ?? 1),
+    });
+    GITHUB_ISSUE_TARGETS.add(target);
+    return target;
+}
+/** Pure request construction. Contact is owned exclusively by runGithubQueueProbe. */
+export function buildGithubIssueListRequest(options) {
+    assertGithubIssueTarget(options.target);
+    const cwd = validateExistingDirectory(options.cwd, "GitHub probe working directory");
+    return Object.freeze({
+        command: "gh",
+        args: Object.freeze([
+            "issue",
+            "list",
+            "--repo",
+            options.target.repository,
+            "--state",
+            "open",
+            "--label",
+            options.target.readyLabel,
+            "--limit",
+            String(options.target.limit),
+            "--json",
+            "id,number,title,body,labels,url,updatedAt",
+        ]),
+        cwd,
+        env: Object.freeze(githubEnvironment(options.env ?? process.env)),
+        timeoutMs: 30_000,
+        maxBufferBytes: MAX_GH_OUTPUT_BYTES,
+    });
+}
+export function parseGithubIssueListResult(result, target) {
+    assertGithubIssueTarget(target);
+    if (result.error)
+        throw new Error("GitHub probe failed to start gh");
+    if (result.status !== 0 || result.signal !== null) {
+        throw new Error(`GitHub probe gh exited ${result.status ?? "without status"}`);
+    }
+    if (Buffer.byteLength(result.stdout, "utf8") > MAX_GH_OUTPUT_BYTES) {
+        throw new Error("GitHub probe output exceeds limit");
+    }
+    let value;
+    try {
+        value = JSON.parse(result.stdout);
+    }
+    catch {
+        throw new Error("GitHub probe returned malformed JSON");
+    }
+    if (!Array.isArray(value) || value.length > target.limit) {
+        throw new Error("GitHub probe returned an invalid issue list");
+    }
+    const issues = value.map((issue, index) => parseIssue(issue, index, target));
+    assertUniqueIssues(issues);
+    return issues;
+}
+function assertGithubIssueTarget(value) {
+    if (typeof value !== "object"
+        || value === null
+        || !GITHUB_ISSUE_TARGETS.has(value)
+        || !Object.isFrozen(value)) {
+        throw new Error("GitHub issue target was not created by the trusted normalization boundary");
+    }
+}
+function parseIssue(value, index, target) {
+    if (!isRecord(value))
+        throw new Error(`GitHub issue ${index} must be an object`);
+    const expected = ["body", "id", "labels", "number", "title", "updatedAt", "url"];
+    if (Object.keys(value).sort().join(",") !== expected.join(",")) {
+        throw new Error(`GitHub issue ${index} has unexpected fields`);
+    }
+    if (typeof value.id !== "string" || !/^[A-Za-z0-9_=-]{1,512}$/.test(value.id)) {
+        throw new Error(`GitHub issue ${index} has invalid id`);
+    }
+    if (typeof value.number !== "number" || !Number.isSafeInteger(value.number) || value.number < 1) {
+        throw new Error(`GitHub issue ${index} has invalid number`);
+    }
+    if (typeof value.title !== "string" || value.title.length < 1 || Buffer.byteLength(value.title, "utf8") > 16 * 1024) {
+        throw new Error(`GitHub issue ${index} has invalid title`);
+    }
+    if (typeof value.body !== "string" || Buffer.byteLength(value.body, "utf8") > MAX_ISSUE_BODY_BYTES) {
+        throw new Error(`GitHub issue ${index} has invalid body`);
+    }
+    if (!Array.isArray(value.labels) || value.labels.length > 100) {
+        throw new Error(`GitHub issue ${index} has invalid labels`);
+    }
+    const labels = [...new Set(value.labels.map((label, labelIndex) => {
+            if (!isRecord(label) || typeof label.name !== "string") {
+                throw new Error(`GitHub issue ${index} label ${labelIndex} is invalid`);
+            }
+            return validateLabel(label.name);
+        }))].sort();
+    if (!labels.includes(target.readyLabel)) {
+        throw new Error(`GitHub issue ${index} is missing ready label ${target.readyLabel}`);
+    }
+    if (typeof value.url !== "string")
+        throw new Error(`GitHub issue ${index} has invalid url`);
+    const urlValue = value.url;
+    const url = parseIssueUrl(urlValue, index);
+    if (url.repository.toLowerCase() !== target.repository.toLowerCase() || url.number !== value.number) {
+        throw new Error(`GitHub issue ${index} does not match the requested target`);
+    }
+    if (typeof value.updatedAt !== "string" || !isFiniteTimestamp(value.updatedAt)) {
+        throw new Error(`GitHub issue ${index} has invalid updatedAt`);
+    }
+    return {
+        id: value.id,
+        number: value.number,
+        title: value.title,
+        body: value.body,
+        labels,
+        url: urlValue,
+        updatedAt: value.updatedAt,
+    };
+}
+function assertUniqueIssues(issues) {
+    const ids = new Set();
+    const numbers = new Set();
+    const urls = new Set();
+    for (const issue of issues) {
+        if (ids.has(issue.id) || numbers.has(issue.number) || urls.has(issue.url)) {
+            throw new Error("GitHub probe returned duplicate or conflicting issues");
+        }
+        ids.add(issue.id);
+        numbers.add(issue.number);
+        urls.add(issue.url);
+    }
+}
+function parseIssueUrl(value, index) {
+    if (typeof value !== "string")
+        throw new Error(`GitHub issue ${index} has invalid url`);
+    const match = /^https:\/\/github\.com\/([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)\/issues\/([1-9][0-9]*)$/.exec(value);
+    if (!match?.[1] || !match[2] || !match[3])
+        throw new Error(`GitHub issue ${index} has invalid url`);
+    return { repository: `${match[1]}/${match[2]}`, number: Number(match[3]) };
+}
+function validateRepository(value) {
+    const [owner, name, extra] = value.split("/");
+    if (extra !== undefined
+        || !owner
+        || !name
+        || !/^[A-Za-z0-9][A-Za-z0-9-]{0,38}$/.test(owner)
+        || !/^[A-Za-z0-9._-]{1,100}$/.test(name)
+        || name === "."
+        || name === "..")
+        throw new Error("invalid GitHub repository");
+    return value;
+}
+function validateLabel(value) {
+    if (!/^[A-Za-z0-9][A-Za-z0-9:._ -]{0,99}$/.test(value))
+        throw new Error("invalid GitHub label");
+    return value;
+}
+function validateLimit(value) {
+    if (!Number.isSafeInteger(value) || value < 1 || value > 100) {
+        throw new Error("GitHub issue limit must be between 1 and 100");
+    }
+    return value;
+}
+function githubEnvironment(input) {
+    if (input.GH_HOST && input.GH_HOST !== "github.com")
+        throw new Error("GitHub probe supports github.com only");
+    const env = {};
+    for (const key of ["PATH", "HOME", "GH_TOKEN", "GITHUB_TOKEN", "GH_HOST", "NO_COLOR"]) {
+        if (input[key] !== undefined)
+            env[key] = input[key];
+    }
+    return env;
+}
+function isFiniteTimestamp(value) {
+    if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?Z$/.test(value))
+        return false;
+    const epoch = Date.parse(value);
+    if (!Number.isFinite(epoch))
+        return false;
+    const normalized = value.includes(".")
+        ? value.replace(/\.(\d{1,3})Z$/u, (_match, fraction) => `.${fraction.padEnd(3, "0")}Z`)
+        : value.replace(/Z$/u, ".000Z");
+    return new Date(epoch).toISOString() === normalized;
+}
+//# sourceMappingURL=gh-adapter.js.map

package/dist/src/live-probes/gh-adapter.js.map

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

package/dist/src/live-probes/github-queue.d.ts

@@ -0,0 +1 @@
+export { GithubQueueProbeError, runGithubQueueProbe, runNonCertifyingGithubQueueProbeFixture, type GithubProbeCertification, type GithubQueueDisclosure, type GithubQueueProbeOptions, type GithubQueueProbeResult, type GithubSyncedTicket, type NonCertifyingGithubQueueProbeFixtureOptions, } from "../evidence/store.js";

package/dist/src/live-probes/github-queue.js

@@ -0,0 +1,2 @@
+export { GithubQueueProbeError, runGithubQueueProbe, runNonCertifyingGithubQueueProbeFixture, } from "../evidence/store.js";
+//# sourceMappingURL=github-queue.js.map

package/dist/src/live-probes/github-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-queue.js","sourceRoot":"","sources":["../../../src/live-probes/github-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,uCAAuC,GAOxC,MAAM,sBAAsB,CAAC"}

package/dist/src/notifications/slack-request.d.ts

@@ -0,0 +1,13 @@
+import { type RuntimeEventBus, type TypedOutboxEvent } from "../events/bus.js";
+import type { SlackNotificationRequestedPayload } from "../events/kinds.js";
+export interface SlackNotificationRequestInput extends SlackNotificationRequestedPayload {
+    readonly occurredAt: string;
+}
+/** Records delivery intent only. OMS v1 deliberately has no Slack sender. */
+export declare function requestSlackNotification(options: {
+    bus: RuntimeEventBus;
+    input: SlackNotificationRequestInput;
+}): Readonly<{
+    status: "created" | "replayed";
+    event: TypedOutboxEvent<"slack-notification-requested">;
+}>;

package/dist/src/notifications/slack-request.js

@@ -0,0 +1,40 @@
+import { assertOpaqueId } from "../domain/records.js";
+import { assertRuntimeEventBus, } from "../events/bus.js";
+import { canonicalTimestamp } from "../queue/model.js";
+import { createStableId } from "../runtime/stable-id.js";
+/** Records delivery intent only. OMS v1 deliberately has no Slack sender. */
+export function requestSlackNotification(options) {
+    const bus = options.bus;
+    assertRuntimeEventBus(bus);
+    const input = captureInput(options.input);
+    const occurredAt = canonicalTimestamp(input.occurredAt, "Slack request timestamp");
+    const subjectId = assertOpaqueId(input.subject_id, "Slack request subject id");
+    const payload = {
+        subject_kind: input.subject_kind,
+        subject_id: subjectId,
+        source_version: input.source_version,
+        template_id: assertOpaqueId(input.template_id, "Slack template id"),
+        severity: input.severity,
+        artifact_ref: assertOpaqueId(input.artifact_ref, "Slack artifact reference"),
+        channel_ref: assertOpaqueId(input.channel_ref, "Slack channel reference"),
+    };
+    return bus.publish("slack-notification-requested", {
+        sourceId: subjectId,
+        sourceVersion: input.source_version,
+        dedupeKey: createStableId("slack-request", input.subject_kind, subjectId, String(input.source_version), input.template_id, input.severity, input.artifact_ref, input.channel_ref),
+        occurredAt,
+    }, payload);
+}
+function captureInput(input) {
+    return {
+        subject_kind: input.subject_kind,
+        subject_id: input.subject_id,
+        source_version: input.source_version,
+        template_id: input.template_id,
+        severity: input.severity,
+        artifact_ref: input.artifact_ref,
+        channel_ref: input.channel_ref,
+        occurredAt: input.occurredAt,
+    };
+}
+//# sourceMappingURL=slack-request.js.map

package/dist/src/notifications/slack-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-request.js","sourceRoot":"","sources":["../../../src/notifications/slack-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,qBAAqB,GAGtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAMzD,6EAA6E;AAC7E,MAAM,UAAU,wBAAwB,CAAC,OAGxC;IAIC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;IACnF,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,UAAU,EAAE,0BAA0B,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAsC;QACjD,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,UAAU,EAAE,SAAS;QACrB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,WAAW,EAAE,cAAc,CAAC,KAAK,CAAC,WAAW,EAAE,mBAAmB,CAAC;QACnE,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,YAAY,EAAE,cAAc,CAAC,KAAK,CAAC,YAAY,EAAE,0BAA0B,CAAC;QAC5E,WAAW,EAAE,cAAc,CAAC,KAAK,CAAC,WAAW,EAAE,yBAAyB,CAAC;KAC1E,CAAC;IACF,OAAO,GAAG,CAAC,OAAO,CAAC,8BAA8B,EAAE;QACjD,QAAQ,EAAE,SAAS;QACnB,aAAa,EAAE,KAAK,CAAC,cAAc;QACnC,SAAS,EAAE,cAAc,CACvB,eAAe,EACf,KAAK,CAAC,YAAY,EAClB,SAAS,EACT,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,EAC5B,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,YAAY,EAClB,KAAK,CAAC,WAAW,CAClB;QACD,UAAU;KACX,EAAE,OAAO,CAAC,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,KAAoC;IACxD,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC"}

package/dist/src/outbox/processor.d.ts

@@ -0,0 +1,27 @@
+import type { OutboxEvent, OutboxReceipt, OutboxStore } from "./store.js";
+declare const OUTBOX_PROCESSOR: unique symbol;
+export interface OutboxHandlerContext {
+    operationNonce: string;
+}
+export type OutboxHandler = (event: Readonly<OutboxEvent>, context: Readonly<OutboxHandlerContext>) => Record<string, unknown> | Promise<Record<string, unknown>>;
+export interface ProcessOutboxEventInput {
+    eventId: string;
+    consumerId: string;
+    processedAt: string;
+}
+export type ProcessOutboxEventResult = {
+    status: "processed";
+    event: OutboxEvent;
+    receipt: OutboxReceipt;
+} | {
+    status: "replayed";
+    event: OutboxEvent;
+    receipt: OutboxReceipt;
+};
+export interface OutboxProcessor {
+    readonly [OUTBOX_PROCESSOR]: true;
+    processOne(input: ProcessOutboxEventInput, handler: OutboxHandler): Promise<ProcessOutboxEventResult>;
+}
+export declare function createOutboxProcessor(store: OutboxStore): OutboxProcessor;
+export declare function assertOutboxProcessor(value: unknown): asserts value is OutboxProcessor;
+export {};

package/dist/src/outbox/processor.js

@@ -0,0 +1,63 @@
+import { assertActorId, assertOpaqueId } from "../domain/records.js";
+import { assertOutboxStore, assertOutboxTimestamp, deriveOperationNonce } from "./store.js";
+const OUTBOX_PROCESSOR = Symbol("OMS outbox processor");
+const OUTBOX_PROCESSORS = new WeakSet();
+export function createOutboxProcessor(store) {
+    assertOutboxStore(store);
+    const capturedStore = store;
+    const processor = Object.freeze({
+        [OUTBOX_PROCESSOR]: true,
+        async processOne(input, handler) {
+            const eventId = assertOpaqueId(input.eventId, "event id");
+            const consumerId = assertActorId(input.consumerId, "consumer id");
+            const processedAt = assertOutboxTimestamp(input.processedAt, "receipt timestamp");
+            const capturedHandler = handler;
+            if (typeof capturedHandler !== "function")
+                throw new Error("outbox handler must be a function");
+            const event = capturedStore.readEvent(eventId);
+            const replay = capturedStore.readReceipt(eventId, consumerId);
+            if (replay)
+                return deepFreeze({ status: "replayed", event, receipt: replay });
+            const lock = capturedStore.acquireProcessingLock(eventId, consumerId);
+            try {
+                const existing = capturedStore.readReceipt(eventId, consumerId);
+                if (existing)
+                    return deepFreeze({ status: "replayed", event, receipt: existing });
+                const operationNonce = deriveOperationNonce(eventId, consumerId);
+                const result = await capturedHandler(deepFreeze(structuredClone(event)), deepFreeze({ operationNonce }));
+                const committed = capturedStore.commitReceipt({
+                    eventId,
+                    consumerId,
+                    processedAt,
+                    result,
+                });
+                return deepFreeze({
+                    status: committed.status === "created" ? "processed" : "replayed",
+                    event,
+                    receipt: committed.receipt,
+                });
+            }
+            finally {
+                lock.release();
+            }
+        },
+    });
+    OUTBOX_PROCESSORS.add(processor);
+    return processor;
+}
+export function assertOutboxProcessor(value) {
+    if (typeof value !== "object" || value === null || !OUTBOX_PROCESSORS.has(value)) {
+        throw new Error("outbox operation requires a real OMS OutboxProcessor");
+    }
+    if (!Object.isFrozen(value))
+        throw new Error("outbox processor lost its frozen authority boundary");
+}
+function deepFreeze(value, seen = new Set()) {
+    if (typeof value !== "object" || value === null || seen.has(value))
+        return value;
+    seen.add(value);
+    for (const child of Object.values(value))
+        deepFreeze(child, seen);
+    return Object.freeze(value);
+}
+//# sourceMappingURL=processor.js.map

package/dist/src/outbox/processor.js.map

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

package/dist/src/outbox/store.d.ts

@@ -0,0 +1,158 @@
+import { type AcquiredLock, type RecoveredLock } from "../runtime/lock.js";
+declare const OUTBOX_STORE: unique symbol;
+declare const CERTIFICATION_WRITER: unique symbol;
+declare const CERTIFICATION_RESOLVER: unique symbol;
+declare const CERTIFICATION_REFERENCE: unique symbol;
+declare const CERTIFICATION_CONSUMER_ID = "run-ledger-authority";
+export interface OutboxEvent {
+    schema_version: 1;
+    event_id: string;
+    event_kind: string;
+    source_id: string;
+    source_version: number;
+    dedupe_key: string;
+    occurred_at: string;
+    payload: Record<string, unknown>;
+}
+export interface OutboxReceipt {
+    schema_version: 1;
+    receipt_id: string;
+    event_id: string;
+    consumer_id: string;
+    operation_nonce: string;
+    processed_at: string;
+    result: Record<string, unknown>;
+}
+export interface PublishOutboxEventInput {
+    eventKind: string;
+    sourceId: string;
+    sourceVersion: number;
+    dedupeKey: string;
+    occurredAt: string;
+    payload: Record<string, unknown>;
+}
+export interface CommitOutboxReceiptInput {
+    eventId: string;
+    consumerId: string;
+    processedAt: string;
+    result: Record<string, unknown>;
+}
+export interface OutboxStore {
+    readonly [OUTBOX_STORE]: true;
+    publish(input: PublishOutboxEventInput): Readonly<{
+        status: "created" | "replayed";
+        event: OutboxEvent;
+    }>;
+    readEvent(eventId: string): OutboxEvent;
+    readReceipt(eventId: string, consumerId: string): OutboxReceipt | undefined;
+    listEvents(): readonly OutboxEvent[];
+    listPending(consumerId: string): readonly OutboxEvent[];
+    acquireProcessingLock(eventId: string, consumerId: string): AcquiredLock;
+    recoverProcessingLock(input: {
+        eventId: string;
+        consumerId: string;
+        recoveredBy: string;
+        reason: string;
+        expectedGenerationId: string;
+    }): RecoveredLock;
+    commitReceipt(input: CommitOutboxReceiptInput): Readonly<{
+        status: "created" | "replayed";
+        receipt: OutboxReceipt;
+    }>;
+}
+export interface CanonicalRunHeadReference {
+    readonly entry_id: string;
+    readonly run_id: string;
+    readonly sequence: number;
+    readonly sha256: string;
+    readonly file_name: string;
+}
+export interface CanonicalRunCertificationReference {
+    readonly run_id: string;
+    readonly head: CanonicalRunHeadReference;
+    readonly metrics_sha256: string;
+}
+export type RunCertificationAuthorityAction = "start" | "heartbeat" | "process-restart" | "complete";
+export interface RunCertificationAuthorityBinding {
+    readonly schema_version: 1;
+    readonly action: RunCertificationAuthorityAction;
+    readonly completion_semantics: "begin-run" | "append-heartbeat" | "record-process-restart" | "terminal-run-completed";
+    readonly run_id: string;
+    readonly operation_id: string;
+    readonly run_kind: "12h" | "24h";
+    readonly policy_sha256: string;
+    readonly ticket_set_digest: string;
+    readonly service_plan_digest: string;
+    readonly expected_head: CanonicalRunHeadReference | null;
+    readonly previous_canary: CanonicalRunCertificationReference | null;
+}
+export interface AuthorizeRunCertificationInput {
+    readonly action: RunCertificationAuthorityAction;
+    readonly decisionId: string;
+    readonly authorizedBy: string;
+    readonly runId: string;
+    readonly operationId: string;
+    readonly runKind: "12h" | "24h";
+    readonly policyDigest: string;
+    readonly ticketSetDigest: string;
+    readonly servicePlanDigest: string;
+    readonly expectedHead: CanonicalRunHeadReference | null;
+    readonly previousCanary: CanonicalRunCertificationReference | null;
+}
+export interface RunCertificationAuthorityReference {
+    readonly [CERTIFICATION_REFERENCE]: true;
+    readonly eventId: string;
+    readonly consumerId: typeof CERTIFICATION_CONSUMER_ID;
+}
+export interface ResolvedRunCertificationAuthority {
+    readonly reference: {
+        readonly event_id: string;
+        readonly consumer_id: typeof CERTIFICATION_CONSUMER_ID;
+    };
+    readonly binding: RunCertificationAuthorityBinding;
+    readonly decision_id: string;
+    readonly authorized_by: string;
+    readonly event_sha256: string;
+    readonly receipt_sha256: string;
+    readonly occurred_at: string;
+    readonly processed_at: string;
+}
+export interface RunCertificationAuthorityWriter {
+    readonly [CERTIFICATION_WRITER]: true;
+    authorize(input: AuthorizeRunCertificationInput): RunCertificationAuthorityReference;
+}
+export interface RunCertificationAuthorityResolver {
+    readonly [CERTIFICATION_RESOLVER]: true;
+    resolve(reference: RunCertificationAuthorityReference): ResolvedRunCertificationAuthority;
+    hydrate(reference: {
+        readonly eventId: string;
+        readonly consumerId: string;
+    }): RunCertificationAuthorityReference;
+    resolveStored(reference: {
+        readonly event_id: string;
+        readonly consumer_id: string;
+    }): ResolvedRunCertificationAuthority;
+}
+export interface RunCertificationAuthority {
+    readonly writer: RunCertificationAuthorityWriter;
+    readonly resolver: RunCertificationAuthorityResolver;
+}
+export declare class ImmutableOutboxConflictError extends Error {
+    constructor(kind: "event" | "receipt", id: string);
+}
+export declare function createOutboxStore(options: {
+    eventsRoot: string;
+    receiptsRoot: string;
+    locksRoot: string;
+}): OutboxStore;
+export declare function assertOutboxStore(value: unknown): asserts value is OutboxStore;
+export declare function createRunCertificationAuthority(outbox: OutboxStore): RunCertificationAuthority;
+export declare function assertRunCertificationAuthorityWriter(value: unknown): asserts value is RunCertificationAuthorityWriter;
+export declare function assertRunCertificationAuthorityResolver(value: unknown): asserts value is RunCertificationAuthorityResolver;
+export declare function assertRunCertificationAuthorityReference(value: unknown): asserts value is RunCertificationAuthorityReference;
+export declare function deriveEventId(input: Pick<PublishOutboxEventInput, "eventKind" | "sourceId" | "sourceVersion" | "dedupeKey">): string;
+export declare function deriveReceiptId(eventId: string, consumerId: string): string;
+export declare function deriveOperationNonce(eventId: string, consumerId: string): string;
+export declare function deriveProcessingLockId(eventId: string, consumerId: string): string;
+export declare function assertOutboxTimestamp(value: string, label: string): string;
+export {};