@jwillert/forgeflow 0.1.0

package/dist/core/capabilities.d.ts

@@ -0,0 +1,75 @@
+import type { AgentCommand, ChangeRequestDetails, ChangeRequestRef, CheckoutSpec, CodeTargetRef, CommentRef, GeneralComment, InlineReviewComment, ReviewThread, WorkTargetRef, WorkTargetSnapshot } from "./types.js";
+export interface PollingEventSource {
+    readonly provider: string;
+    readonly targetId: string;
+    poll(input: {
+        cursor?: {
+            value?: string;
+        };
+        maxEvents: number;
+    }): Promise<{
+        events: import("./types.js").NormalizedEvent[];
+        nextCursor?: {
+            value?: string;
+        };
+    }>;
+}
+export interface WorkReader {
+    getTarget(target: WorkTargetRef): Promise<WorkTargetSnapshot>;
+    /** Other issues/change requests that block this target from proceeding (native forge relationships and/or a "Blocked by #N" text convention in the body). */
+    listBlockingIssues(target: WorkTargetRef): Promise<WorkTargetRef[]>;
+}
+export interface WorkTracker extends WorkReader {
+    addLabel(target: WorkTargetRef, label: string): Promise<void>;
+    removeLabel(target: WorkTargetRef, label: string): Promise<void>;
+    addComment(target: WorkTargetRef, body: string): Promise<CommentRef>;
+}
+export interface CodeReader {
+    resolveCheckout(target: CodeTargetRef, command: AgentCommand): Promise<CheckoutSpec>;
+}
+export interface CodeHost extends CodeReader {
+    openOrUpdateChangeRequest(input: {
+        existing?: ChangeRequestRef;
+        sourceBranch: import("./types.js").BranchRef;
+        targetBranch: string;
+        title: string;
+        body: string;
+    }): Promise<ChangeRequestRef>;
+}
+/**
+ * Forge-agnostic surface for reviewing a change request (GitHub pull request /
+ * GitLab merge request) or discussing an issue. `listGeneralComments` works for
+ * any WorkTargetRef (issue or change request); the rest are change-request only.
+ */
+export interface CodeReviewHost {
+    getChangeRequestDetails(target: WorkTargetRef): Promise<ChangeRequestDetails>;
+    listGeneralComments(target: WorkTargetRef): Promise<GeneralComment[]>;
+    listReviewThreads(target: WorkTargetRef): Promise<ReviewThread[]>;
+    postReview(target: WorkTargetRef, input: {
+        commitSha: string;
+        summary: string;
+        inlineComments: InlineReviewComment[];
+    }): Promise<void>;
+    replyToThread(target: WorkTargetRef, input: {
+        threadId: string;
+        body: string;
+    }): Promise<void>;
+    markReady(target: WorkTargetRef): Promise<void>;
+}
+export interface CapabilityRegistry {
+    optional<T = unknown>(name: string): T | undefined;
+}
+export interface TrustPolicy {
+    canProcessEvent(input: {
+        event: import("./types.js").NormalizedEvent;
+        workflowKind?: "read" | "write";
+    }): Promise<{
+        allowed: boolean;
+        reason?: string;
+    }>;
+}
+export interface CommandState {
+    getLinkedChangeRequest(): Promise<ChangeRequestRef | undefined>;
+    linkChangeRequest(ref: ChangeRequestRef): Promise<void>;
+    getLastExecutionResult(): Promise<import("./types.js").ExecutionResult | undefined>;
+}

package/dist/core/capabilities.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=capabilities.js.map

package/dist/core/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/core/capabilities.ts"],"names":[],"mappings":""}

package/dist/core/config.d.ts

@@ -0,0 +1,38 @@
+import type { TrustPolicy } from "./capabilities.js";
+import type { StateStore } from "./state.js";
+import type { Workflow } from "./workflow.js";
+export type EnabledTarget = {
+    provider: string;
+    id: string;
+    codeRepo: string;
+    baseBranch?: string;
+    workflows: Workflow[];
+    pollingSource: import("./capabilities.js").PollingEventSource;
+    workReader: import("./capabilities.js").WorkReader;
+    workTracker: import("./capabilities.js").WorkTracker;
+    codeReader: import("./capabilities.js").CodeReader;
+    codeHost: import("./capabilities.js").CodeHost;
+    codeReviewHost: import("./capabilities.js").CodeReviewHost;
+};
+export type ForgeflowConfig = {
+    state: StateStore;
+    enabledTargets: EnabledTarget[];
+    trustPolicy?: TrustPolicy;
+    defaultDeferInterval?: string;
+    eventAudit?: {
+        storeRawPayloads?: boolean | "redacted";
+    };
+    capabilities?: Record<string, unknown>;
+};
+export type EnvReader = {
+    required(name: string): string;
+    optional(name: string): string | undefined;
+    optional(name: string, defaultValue: string): string;
+};
+export declare function createEnvReader(source?: NodeJS.ProcessEnv): EnvReader;
+export declare function defineConfig(factory: (ctx: {
+    env: EnvReader;
+}) => ForgeflowConfig | Promise<ForgeflowConfig>): (ctx: {
+    env: EnvReader;
+}) => ForgeflowConfig | Promise<ForgeflowConfig>;
+export declare function defaultTrustPolicy(): TrustPolicy;

package/dist/core/config.js

@@ -0,0 +1,25 @@
+export function createEnvReader(source = process.env) {
+    function optional(name, defaultValue) {
+        return source[name] ?? defaultValue;
+    }
+    return {
+        required(name) {
+            const value = source[name];
+            if (!value)
+                throw new Error(`Missing required environment variable ${name}`);
+            return value;
+        },
+        optional,
+    };
+}
+export function defineConfig(factory) {
+    return factory;
+}
+export function defaultTrustPolicy() {
+    return {
+        async canProcessEvent() {
+            return { allowed: true };
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAiCA,MAAM,UAAU,eAAe,CAAC,SAA4B,OAAO,CAAC,GAAG;IAGrE,SAAS,QAAQ,CAAC,IAAY,EAAE,YAAqB;QACnD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,YAAY,CAAA;IACrC,CAAC;IAED,OAAO;QACL,QAAQ,CAAC,IAAY;YACnB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;YAC1B,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,IAAI,EAAE,CAAC,CAAA;YAC5E,OAAO,KAAK,CAAA;QACd,CAAC;QACD,QAAQ;KACT,CAAA;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgF;IAC3G,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,KAAK,CAAC,eAAe;YACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAC1B,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/core/engine.d.ts

@@ -0,0 +1,44 @@
+import type { ForgeflowConfig } from "./config.js";
+export declare class ForgeflowGateway {
+    private readonly config;
+    constructor(config: ForgeflowConfig);
+    runOnce(options?: {
+        maxEvents?: number;
+        limit?: number;
+        parallel?: number;
+    }): Promise<{
+        poll: {
+            events: number;
+            commands: number;
+            deferred: number;
+            rejected: number;
+        };
+        worker: {
+            processed: number;
+            succeeded: number;
+            failed: number;
+        };
+    }>;
+    poll(options?: {
+        maxEvents?: number;
+    }): Promise<{
+        events: number;
+        commands: number;
+        deferred: number;
+        rejected: number;
+    }>;
+    /** Re-runs match() for a deferred command against its original triggering event, so a still-blocked condition reschedules instead of blindly proceeding. */
+    private recheckDeferred;
+    private handleEvent;
+    worker(options?: {
+        limit?: number;
+        parallel?: number;
+    }): Promise<{
+        processed: number;
+        succeeded: number;
+        failed: number;
+    }>;
+    private runCommand;
+    private findTargetForCommand;
+}
+export declare function createGateway(config: ForgeflowConfig): ForgeflowGateway;

package/dist/core/engine.js

@@ -0,0 +1,225 @@
+import { createCommandState } from "./state.js";
+import { codeTargetFromEnabledTarget, defaultCommandId } from "./workflow.js";
+import { defaultTrustPolicy } from "./config.js";
+function nowIso() { return new Date().toISOString(); }
+function isActiveStatus(status) {
+    return status === "queued" || status === "deferred" || status === "running";
+}
+function workTargetKey(target) {
+    return `${target.provider}:${target.repo ?? target.project ?? ""}:${target.kind}:${target.id}`;
+}
+function addInterval(from, interval = "15m") {
+    const match = /^(\d+)\s*([smhd])$/.exec(interval);
+    if (!match)
+        return new Date(from.getTime() + 15 * 60_000).toISOString();
+    const n = Number(match[1]);
+    const unit = match[2];
+    const ms = unit === "s" ? n * 1000 : unit === "m" ? n * 60_000 : unit === "h" ? n * 3_600_000 : n * 86_400_000;
+    return new Date(from.getTime() + ms).toISOString();
+}
+export class ForgeflowGateway {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async runOnce(options = {}) {
+        const poll = await this.poll({ maxEvents: options.maxEvents });
+        const worker = await this.worker({ limit: options.limit, parallel: options.parallel });
+        return { poll, worker };
+    }
+    async poll(options = {}) {
+        const maxEvents = options.maxEvents ?? 100;
+        let budget = maxEvents;
+        let eventsSeen = 0, commands = 0, deferred = 0, rejected = 0;
+        for (const target of this.config.enabledTargets) {
+            if (budget <= 0)
+                break;
+            const sourceKey = `${target.provider}:${target.id}`;
+            const cursor = await this.config.state.getCursor(sourceKey);
+            const batch = await target.pollingSource.poll({ cursor, maxEvents: budget });
+            for (const event of batch.events) {
+                if (budget <= 0)
+                    break;
+                budget--;
+                eventsSeen++;
+                const result = await this.handleEvent(target, event);
+                if (result === "accepted")
+                    commands++;
+                if (result === "deferred")
+                    deferred++;
+                if (result === "rejected")
+                    rejected++;
+            }
+            await this.config.state.setCursor(sourceKey, batch.nextCursor);
+        }
+        if (budget > 0) {
+            const due = await this.config.state.listDueDeferred(nowIso(), budget);
+            for (const command of due) {
+                budget--;
+                const outcome = await this.recheckDeferred(command);
+                if (outcome === "queued")
+                    commands++;
+                if (outcome === "deferred")
+                    deferred++;
+                if (outcome === "rejected")
+                    rejected++;
+            }
+        }
+        return { events: eventsSeen, commands, deferred, rejected };
+    }
+    /** Re-runs match() for a deferred command against its original triggering event, so a still-blocked condition reschedules instead of blindly proceeding. */
+    async recheckDeferred(command) {
+        const target = this.findTargetForCommand(command);
+        const workflow = target?.workflows.find(w => w.id === command.workflowId);
+        if (!target || !workflow) {
+            await this.config.state.updateCommandStatus(command.id, "failed", { reason: "No enabled target/workflow found" });
+            return "rejected";
+        }
+        const decision = await workflow.match({
+            event: command.triggerEvent,
+            workReader: target.workReader,
+            codeReader: target.codeReader,
+            state: this.config.state,
+            trustPolicy: this.config.trustPolicy ?? defaultTrustPolicy(),
+        });
+        if (decision.type === "ignore") {
+            await this.config.state.updateCommandStatus(command.id, "rejected", { reason: "No longer applicable on recheck" });
+            return "rejected";
+        }
+        if (decision.type === "reject") {
+            await this.config.state.updateCommandStatus(command.id, "rejected", { reason: decision.reason });
+            return "rejected";
+        }
+        if (decision.type === "defer") {
+            await this.config.state.updateCommandStatus(command.id, "deferred", {
+                reason: decision.reason,
+                nextCheckAt: decision.nextCheckAt ?? addInterval(new Date(), this.config.defaultDeferInterval).toString(),
+            });
+            return "deferred";
+        }
+        await this.config.state.updateCommandStatus(command.id, "queued");
+        return "queued";
+    }
+    async handleEvent(target, event) {
+        if (await this.config.state.hasProcessedEvent(event.id))
+            return "ignored";
+        await this.config.state.recordEvent(event, { rawPayload: this.config.eventAudit?.storeRawPayloads ? event.raw : undefined });
+        if (event.kind === "comment_created" && event.comment?.body.trim() === "/agent retry") {
+            const failed = await this.config.state.findLatestFailedCommandForTarget(workTargetKey(event.workTarget));
+            if (failed)
+                await this.config.state.updateCommandStatus(failed.id, "queued");
+            await this.config.state.markEventProcessed(event.id);
+            return failed ? "accepted" : "ignored";
+        }
+        const trust = await (this.config.trustPolicy ?? defaultTrustPolicy()).canProcessEvent({ event });
+        if (!trust.allowed) {
+            await this.config.state.markEventProcessed(event.id);
+            return "rejected";
+        }
+        for (const workflow of target.workflows) {
+            const decision = await workflow.match({
+                event,
+                workReader: target.workReader,
+                codeReader: target.codeReader,
+                state: this.config.state,
+                trustPolicy: this.config.trustPolicy ?? defaultTrustPolicy(),
+            });
+            if (decision.type === "ignore")
+                continue;
+            const commandId = defaultCommandId({ event, workflowId: workflow.id });
+            if (decision.type === "reject") {
+                await this.config.state.markEventProcessed(event.id);
+                return "rejected";
+            }
+            const existing = await this.config.state.getCommand(commandId);
+            if (existing && isActiveStatus(existing.status)) {
+                await this.config.state.markEventProcessed(event.id);
+                return "ignored";
+            }
+            if (existing) {
+                // Prior run for this trigger reached a terminal state (succeeded/failed/rejected);
+                // re-queue it in place rather than creating a duplicate command with the same id.
+                await this.config.state.updateCommandStatus(commandId, decision.type === "defer" ? "deferred" : "queued", {
+                    reason: decision.type === "defer" ? decision.reason : undefined,
+                    nextCheckAt: decision.type === "defer" ? decision.nextCheckAt ?? addInterval(new Date(), this.config.defaultDeferInterval).toString() : undefined,
+                });
+                await this.config.state.markEventProcessed(event.id);
+                return decision.type === "defer" ? "deferred" : "accepted";
+            }
+            const snapshot = await target.workReader.getTarget(event.workTarget).catch(() => undefined);
+            const createdAt = nowIso();
+            const command = {
+                id: commandId,
+                workflowId: workflow.id,
+                triggerEvent: event,
+                workTarget: event.workTarget,
+                codeTarget: codeTargetFromEnabledTarget(target),
+                title: decision.type === "accept" && decision.title ? decision.title : snapshot?.title ?? `${workflow.id} for ${event.workTarget.kind} ${event.workTarget.id}`,
+                body: decision.type === "accept" && decision.body ? decision.body : snapshot?.body,
+                status: decision.type === "defer" ? "deferred" : "queued",
+                deferReason: decision.type === "defer" ? decision.reason : undefined,
+                nextCheckAt: decision.type === "defer" ? decision.nextCheckAt ?? addInterval(new Date(), this.config.defaultDeferInterval).toString() : undefined,
+                createdAt,
+                updatedAt: createdAt,
+            };
+            await this.config.state.createCommand(command);
+            await this.config.state.markEventProcessed(event.id);
+            return decision.type === "defer" ? "deferred" : "accepted";
+        }
+        await this.config.state.markEventProcessed(event.id);
+        return "ignored";
+    }
+    async worker(options = {}) {
+        const parallel = Math.max(1, options.parallel ?? 3);
+        const limit = options.limit ?? parallel;
+        const commands = await this.config.state.claimQueued(limit);
+        let succeeded = 0, failed = 0;
+        for (let index = 0; index < commands.length; index += parallel) {
+            const batch = commands.slice(index, index + parallel);
+            const settled = await Promise.allSettled(batch.map(command => this.runCommand(command)));
+            for (const outcome of settled) {
+                if (outcome.status === "fulfilled" && outcome.value === "succeeded")
+                    succeeded++;
+                else
+                    failed++;
+            }
+        }
+        return { processed: commands.length, succeeded, failed };
+    }
+    async runCommand(command) {
+        const target = this.findTargetForCommand(command);
+        const workflow = target?.workflows.find(w => w.id === command.workflowId);
+        if (!target || !workflow) {
+            await this.config.state.updateCommandStatus(command.id, "failed", { reason: "No enabled target/workflow found" });
+            return "failed";
+        }
+        const startedAt = nowIso();
+        await this.config.state.recordWorkflowRun({ commandId: command.id, workflowId: command.workflowId, status: "running", startedAt });
+        try {
+            const result = await workflow.run({
+                command,
+                workReader: target.workReader,
+                workTracker: target.workTracker,
+                codeHost: target.codeHost,
+                codeReviewHost: target.codeReviewHost,
+                commandState: createCommandState(this.config.state, command.id),
+                capabilities: { optional: (name) => this.config.capabilities?.[name] },
+            });
+            await this.config.state.updateCommandStatus(command.id, "succeeded");
+            await this.config.state.recordWorkflowRun({ commandId: command.id, workflowId: command.workflowId, status: "succeeded", startedAt, completedAt: nowIso(), summary: result?.summary });
+            return "succeeded";
+        }
+        catch (error) {
+            await this.config.state.updateCommandStatus(command.id, "failed", { reason: error instanceof Error ? error.message : String(error) });
+            await this.config.state.recordWorkflowRun({ commandId: command.id, workflowId: command.workflowId, status: "failed", startedAt, completedAt: nowIso(), error: error instanceof Error ? error.stack ?? error.message : String(error) });
+            return "failed";
+        }
+    }
+    findTargetForCommand(command) {
+        return this.config.enabledTargets.find(t => t.provider === command.codeTarget.provider && t.codeRepo === command.codeTarget.repo);
+    }
+}
+export function createGateway(config) {
+    return new ForgeflowGateway(config);
+}
+//# sourceMappingURL=engine.js.map

package/dist/core/engine.js.map

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

package/dist/core/state.d.ts

@@ -0,0 +1,42 @@
+import type { AgentCommand, AgentCommandStatus, ChangeRequestRef, ExecutionResult, NormalizedEvent } from "./types.js";
+export interface StateStore {
+    getCursor(sourceKey: string): Promise<{
+        value?: string;
+    } | undefined>;
+    setCursor(sourceKey: string, cursor?: {
+        value?: string;
+    }): Promise<void>;
+    hasProcessedEvent(eventId: string): Promise<boolean>;
+    recordEvent(event: NormalizedEvent, options?: {
+        rawPayload?: unknown;
+    }): Promise<void>;
+    markEventProcessed(eventId: string): Promise<void>;
+    hasCommand(commandId: string): Promise<boolean>;
+    createCommand(command: AgentCommand): Promise<void>;
+    updateCommandStatus(commandId: string, status: AgentCommandStatus, input?: {
+        reason?: string;
+        nextCheckAt?: string;
+    }): Promise<void>;
+    getCommand(commandId: string): Promise<AgentCommand | undefined>;
+    findLatestFailedCommandForTarget(targetKey: string): Promise<AgentCommand | undefined>;
+    listDueDeferred(now: string, limit: number): Promise<AgentCommand[]>;
+    claimQueued(limit: number): Promise<AgentCommand[]>;
+    getLinkedChangeRequest(commandId: string): Promise<ChangeRequestRef | undefined>;
+    linkChangeRequest(commandId: string, ref: ChangeRequestRef): Promise<void>;
+    getLastExecutionResult(commandId: string): Promise<ExecutionResult | undefined>;
+    recordWorkflowRun(input: {
+        commandId: string;
+        workflowId: string;
+        status: "running" | "succeeded" | "failed";
+        startedAt?: string;
+        completedAt?: string;
+        summary?: string;
+        execution?: ExecutionResult;
+        error?: string;
+    }): Promise<void>;
+}
+export declare function createCommandState(state: StateStore, commandId: string): {
+    getLinkedChangeRequest: () => Promise<ChangeRequestRef | undefined>;
+    linkChangeRequest: (ref: ChangeRequestRef) => Promise<void>;
+    getLastExecutionResult: () => Promise<ExecutionResult | undefined>;
+};

package/dist/core/state.js

@@ -0,0 +1,8 @@
+export function createCommandState(state, commandId) {
+    return {
+        getLinkedChangeRequest: () => state.getLinkedChangeRequest(commandId),
+        linkChangeRequest: (ref) => state.linkChangeRequest(commandId, ref),
+        getLastExecutionResult: () => state.getLastExecutionResult(commandId),
+    };
+}
+//# sourceMappingURL=state.js.map

package/dist/core/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,kBAAkB,CAAC,KAAiB,EAAE,SAAiB;IACrE,OAAO;QACL,sBAAsB,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,sBAAsB,CAAC,SAAS,CAAC;QACrE,iBAAiB,EAAE,CAAC,GAAqB,EAAE,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,SAAS,EAAE,GAAG,CAAC;QACrF,sBAAsB,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,sBAAsB,CAAC,SAAS,CAAC;KACtE,CAAA;AACH,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,141 @@
+export type ProviderId = string;
+export type TargetKind = "issue" | "pull_request" | "merge_request" | "project" | "repo" | "tag";
+export type WorkTargetRef = {
+    provider: ProviderId;
+    id: string;
+    kind: TargetKind;
+    repo?: string;
+    project?: string;
+    url?: string;
+};
+export type CodeTargetRef = {
+    provider: ProviderId;
+    repo: string;
+    baseBranch?: string;
+};
+export type ActorRef = {
+    provider: ProviderId;
+    id: string;
+    login: string;
+};
+export type NormalizedEvent = {
+    id: string;
+    provider: ProviderId;
+    source: "poll" | "webhook";
+    provenance: "historical" | "synthetic";
+    kind: "label_added" | "label_removed" | "comment_created" | "comment_command" | "target_updated" | "target_opened" | "tag_created";
+    workTarget: WorkTargetRef;
+    actor?: ActorRef;
+    label?: string;
+    comment?: {
+        id: string;
+        body: string;
+        url?: string;
+    };
+    command?: string;
+    tag?: string;
+    occurredAt: string;
+    observedAt: string;
+    raw?: unknown;
+};
+export type PollCursor = {
+    value?: string;
+};
+export type PollBatch = {
+    events: NormalizedEvent[];
+    nextCursor?: PollCursor;
+};
+export type WorkTargetSnapshot = {
+    target: WorkTargetRef;
+    title?: string;
+    body?: string;
+    labels: string[];
+    author?: ActorRef;
+    url?: string;
+    updatedAt?: string;
+    state?: "open" | "closed";
+};
+export type CheckoutSpec = {
+    cloneUrl: string;
+    baseRef: string;
+    workBranch: string;
+    authRef: string;
+};
+export type BranchRef = {
+    provider: ProviderId;
+    repo: string;
+    name: string;
+    url?: string;
+};
+export type CommentRef = {
+    id: string;
+    url?: string;
+};
+export type ChangeRequestRef = {
+    provider: ProviderId;
+    id: string;
+    url?: string;
+    kind: TargetKind;
+};
+export type ChangeRequestDetails = {
+    sourceBranch: string;
+    sourceSha: string;
+    targetBranch: string;
+    title: string;
+    isCrossRepository: boolean;
+    linkedIssueId?: string;
+};
+export type GeneralComment = {
+    author?: string;
+    body: string;
+    createdAt?: string;
+};
+export type ReviewThreadComment = {
+    id: string;
+    author?: string;
+    body: string;
+};
+export type ReviewThread = {
+    id: string;
+    path?: string;
+    line?: number;
+    isResolved: boolean;
+    comments: ReviewThreadComment[];
+};
+export type InlineReviewComment = {
+    path: string;
+    line: number;
+    body: string;
+};
+export type ExecutionResult = {
+    status: "success";
+    mode: "pushed_branch";
+    summary: string;
+    branch: BranchRef;
+    commitSha?: string;
+    logsUrl?: string;
+    artifacts?: Array<{
+        name: string;
+        url: string;
+    }>;
+} | {
+    status: "failed";
+    summary: string;
+    logsUrl?: string;
+    error?: string;
+};
+export type AgentCommandStatus = "queued" | "deferred" | "running" | "succeeded" | "failed" | "rejected";
+export type AgentCommand = {
+    id: string;
+    workflowId: string;
+    triggerEvent: NormalizedEvent;
+    workTarget: WorkTargetRef;
+    codeTarget: CodeTargetRef;
+    title: string;
+    body?: string;
+    status: AgentCommandStatus;
+    deferReason?: string;
+    nextCheckAt?: string;
+    createdAt: string;
+    updatedAt: string;
+};

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}