@vypdev/copilot 3.2.0 → 3.3.1

package/build/api/src/api.d.ts

@@ -0,0 +1,35 @@
+import type { Execution } from './data/model/execution';
+import type { FindingsQueryPort } from './application/ports/agent_findings_ports';
+import type { BugbotContextPorts } from './application/ports/bugbot_context_ports';
+import type { BugbotFindingPublicationPorts } from './application/ports/bugbot_finding_publication_ports';
+import type { BugbotFindingResolutionPorts } from './application/ports/bugbot_finding_resolution_ports';
+import type { BugbotTelemetryPort } from './application/ports/bugbot_telemetry_ports';
+import type { BugbotReviewCommandOverrides } from './domain/bugbot/review_command';
+export interface BugbotScmGateway {
+    readonly context: BugbotContextPorts;
+    readonly publication: BugbotFindingPublicationPorts;
+    readonly resolution: BugbotFindingResolutionPorts;
+    readonly telemetry?: BugbotTelemetryPort;
+}
+/** Provider-neutral programmatic entry point. Consumers supply agent and SCM adapters. */
+export declare class BugbotReviewService {
+    private readonly useCase;
+    constructor(agent: FindingsQueryPort, scm: BugbotScmGateway);
+    review(execution: Execution, options?: BugbotReviewCommandOverrides): Promise<import("./data/model/result").Result[]>;
+}
+export { evaluateBugbotFindings, evaluateBugbotQualityGate } from './tooling/bugbot_quality_eval';
+export { evaluateBugbotBenchmark, loadBugbotBenchmark, loadBugbotPredictions } from './tooling/bugbot_benchmark';
+export { buildBugbotAnalytics, parseBugbotTelemetry } from './tooling/bugbot_analytics';
+export { buildSemanticFindingFingerprint, buildFindingFingerprint } from './domain/bugbot/finding_identity';
+export { normalizeBugbotReviewConfiguration, resolveBugbotReviewEffort } from './domain/bugbot/review_configuration';
+export { Execution } from './data/model/execution';
+export { Ai } from './data/model/ai';
+export type { FindingsQueryPort } from './application/ports/agent_findings_ports';
+export type { BugbotContextPorts } from './application/ports/bugbot_context_ports';
+export type { BugbotFindingPublicationPorts } from './application/ports/bugbot_finding_publication_ports';
+export type { BugbotFindingResolutionPorts } from './application/ports/bugbot_finding_resolution_ports';
+export type { BugbotTelemetryPort } from './application/ports/bugbot_telemetry_ports';
+export type { Result } from './data/model/result';
+export type { BugbotFinding } from './application/usecases/steps/commit/bugbot/types';
+export type { BugbotReviewConfiguration } from './domain/bugbot/review_configuration';
+export type { BugbotReviewTelemetrySnapshot } from './application/ports/bugbot_telemetry_ports';

package/build/api/src/application/ports/agent_configuration_ports.d.ts

@@ -0,0 +1,3 @@
+export type { AgentConfiguration } from '../../domain/agent';
+/** Runtime-neutral configuration values supplied by an outer adapter. */
+export type AgentConfigurationEnvironment = Readonly<Record<string, string | undefined>>;

package/build/api/src/application/ports/agent_findings_ports.d.ts

@@ -0,0 +1,8 @@
+import type { AgentQueryRequest, AgentQueryResult } from './agent_query_ports';
+export type { AgentQueryOptions } from './agent_query_ports';
+export interface FindingsQueryRequest extends AgentQueryRequest {
+    agentId: string;
+}
+export interface FindingsQueryPort {
+    query(request: FindingsQueryRequest): Promise<AgentQueryResult>;
+}

package/build/api/src/application/ports/agent_query_ports.d.ts

@@ -0,0 +1,14 @@
+import type { AgentConfiguration } from './agent_configuration_ports';
+/** Options shared by read-only, structured agent capabilities. */
+export interface AgentQueryOptions {
+    expectJson?: boolean;
+    schema?: Record<string, unknown>;
+    schemaName?: string;
+    includeReasoning?: boolean;
+}
+export interface AgentQueryRequest {
+    configuration: AgentConfiguration | undefined;
+    prompt: string;
+    options?: AgentQueryOptions;
+}
+export type AgentQueryResult = string | Record<string, unknown> | undefined;

package/build/api/src/application/ports/bugbot_context_ports.d.ts

@@ -0,0 +1,9 @@
+import type { BugbotIssueReadPort } from './bugbot_issue_read_ports';
+import type { BugbotPullRequestReadPort } from './bugbot_pull_request_read_ports';
+import type { BugbotRuleFileQueryPort } from './bugbot_rule_ports';
+export interface BugbotContextPorts {
+    issue: BugbotIssueReadPort;
+    pullRequest: BugbotPullRequestReadPort;
+    /** Optional for compatibility with embedders that do not expose a workspace. */
+    rules?: BugbotRuleFileQueryPort;
+}

package/build/api/src/application/ports/bugbot_finding_publication_ports.d.ts

@@ -0,0 +1,7 @@
+import type { BugbotIssueCommentWritePort } from "./bugbot_issue_write_ports";
+import type { BugbotPullRequestWritePort } from "./bugbot_pull_request_write_ports";
+/** Minimum capabilities needed to publish or refresh findings. */
+export interface BugbotFindingPublicationPorts {
+    issueComments: BugbotIssueCommentWritePort;
+    pullRequestComments: BugbotPullRequestWritePort;
+}

package/build/api/src/application/ports/bugbot_finding_resolution_ports.d.ts

@@ -0,0 +1,6 @@
+import type { BugbotIssueCommentUpdatePort } from "./bugbot_issue_write_ports";
+import type { BugbotPullRequestResolutionPort } from "./bugbot_pull_request_resolution_ports";
+export interface BugbotFindingResolutionPorts {
+    issueComments: BugbotIssueCommentUpdatePort;
+    pullRequestComments: BugbotPullRequestResolutionPort;
+}

package/build/api/src/application/ports/bugbot_issue_read_ports.d.ts

@@ -0,0 +1,10 @@
+export interface BugbotIssueComment {
+    id: number;
+    body: string | null;
+    user?: {
+        login?: string;
+    };
+}
+export interface BugbotIssueReadPort {
+    listIssueComments(owner: string, repository: string, issueNumber: number, token: string): Promise<BugbotIssueComment[]>;
+}

package/build/api/src/application/ports/bugbot_issue_write_ports.d.ts

@@ -0,0 +1,12 @@
+export interface BugbotIssueCommentCreatePort {
+    addComment(owner: string, repository: string, issueNumber: number, comment: string, token: string, options?: {
+        commitSha?: string;
+    }): Promise<void>;
+}
+export interface BugbotIssueCommentUpdatePort {
+    updateComment(owner: string, repository: string, issueNumber: number, commentId: number, comment: string, token: string, options?: {
+        commitSha?: string;
+    }): Promise<void>;
+}
+export interface BugbotIssueCommentWritePort extends BugbotIssueCommentCreatePort, BugbotIssueCommentUpdatePort {
+}

package/build/api/src/application/ports/bugbot_pull_request_read_ports.d.ts

@@ -0,0 +1,47 @@
+import type { PullRequestReviewComment } from "./pull_request_review_comment_ports";
+export interface PullRequestDiffLocation {
+    line: number;
+    side: "LEFT" | "RIGHT";
+}
+export interface PullRequestReviewChange {
+    filename: string;
+    status: string;
+    additions: number;
+    deletions: number;
+    patch: string;
+}
+export interface PullRequestReviewDiffSnapshot {
+    changes: PullRequestReviewChange[];
+    filesWithFirstDiffLine: Array<{
+        path: string;
+        firstLine: number;
+    }>;
+    filesWithDiffLocations: Array<{
+        path: string;
+        locations: PullRequestDiffLocation[];
+    }>;
+}
+export interface BugbotPullRequestQueryPort {
+    getHeadBranchForIssue(owner: string, repository: string, issueNumber: number, token: string): Promise<string | undefined>;
+    getPullRequestReviewCommentBody(owner: string, repository: string, pullNumber: number, commentId: number, token: string): Promise<string | null>;
+}
+export interface BugbotPullRequestReadPort extends BugbotPullRequestQueryPort {
+    getOpenPullRequestNumbersByHeadBranch(owner: string, repository: string, branch: string, token: string): Promise<number[]>;
+    listPullRequestReviewComments(owner: string, repository: string, pullNumber: number, token: string): Promise<PullRequestReviewComment[]>;
+    getPullRequestHeadSha(owner: string, repository: string, pullNumber: number, token: string): Promise<string | undefined>;
+    getChangedFiles(owner: string, repository: string, pullNumber: number, token: string): Promise<Array<{
+        filename: string;
+        status: string;
+    }>>;
+    getFilesWithFirstDiffLine(owner: string, repository: string, pullNumber: number, token: string): Promise<Array<{
+        path: string;
+        firstLine: number;
+    }>>;
+    getFilesWithDiffLocations?(owner: string, repository: string, pullNumber: number, token: string): Promise<Array<{
+        path: string;
+        locations: PullRequestDiffLocation[];
+    }>>;
+    /** Loads all diff projections from one paginated GitHub request. */
+    getReviewDiffSnapshot?(owner: string, repository: string, pullNumber: number, token: string): Promise<PullRequestReviewDiffSnapshot>;
+    listPullRequestReviewThreadStates?(owner: string, repository: string, pullNumber: number, token: string): Promise<Record<string, boolean>>;
+}

package/build/api/src/application/ports/bugbot_pull_request_resolution_ports.d.ts

@@ -0,0 +1,3 @@
+import type { PullRequestReviewCommentListQueryPort, PullRequestReviewCommentUpdatePort, PullRequestReviewThreadCommandPort } from "./pull_request_review_comment_ports";
+export interface BugbotPullRequestResolutionPort extends PullRequestReviewCommentListQueryPort, PullRequestReviewCommentUpdatePort, PullRequestReviewThreadCommandPort {
+}

package/build/api/src/application/ports/bugbot_pull_request_write_ports.d.ts

@@ -0,0 +1,4 @@
+import type { PullRequestReviewCommentCommandPort, PullRequestReviewThreadCommandPort } from "./pull_request_review_comment_ports";
+/** Publication may refresh a comment and reopen its thread when a finding returns. */
+export interface BugbotPullRequestWritePort extends PullRequestReviewCommentCommandPort, Pick<PullRequestReviewThreadCommandPort, "unresolvePullRequestReviewThread"> {
+}

package/build/api/src/application/ports/bugbot_rule_ports.d.ts

@@ -0,0 +1,12 @@
+export type BugbotRuleScope = 'organization' | 'repository' | 'path' | 'learned';
+export interface BugbotReviewRule {
+    readonly source: string;
+    readonly scope: BugbotRuleScope;
+    readonly content: string;
+}
+export interface BugbotRuleFileQueryPort {
+    loadRules(changedFiles: readonly string[]): Promise<readonly BugbotReviewRule[]>;
+}
+export interface BugbotLearnedRuleCommandPort {
+    rememberRule(rule: string): Promise<'created' | 'existing'>;
+}

package/build/api/src/application/ports/bugbot_telemetry_ports.d.ts

@@ -0,0 +1,32 @@
+export type BugbotReviewOutcome = 'completed' | 'no-findings' | 'dry-run' | 'superseded' | 'skipped' | 'failed';
+export interface BugbotReviewTelemetrySnapshot {
+    readonly schemaVersion: 1;
+    readonly reviewId: string;
+    readonly repository: string;
+    readonly pullRequestNumber?: number;
+    readonly headSha?: string;
+    readonly publicationMode: 'publish' | 'dry-run';
+    readonly configuredEffort: string;
+    readonly agentProvider?: string;
+    readonly agentModel?: string;
+    readonly startedAt: string;
+    readonly elapsedMs: number;
+    readonly stagesMs: Readonly<Record<string, number>>;
+    readonly promptCharacters: number;
+    readonly responseCharacters: number;
+    readonly estimatedInputTokens: number;
+    readonly estimatedOutputTokens: number;
+    readonly changedFiles: number;
+    readonly changedLines: number;
+    readonly rulesLoaded: number;
+    readonly candidateFindings: number;
+    readonly publishedFindings: number;
+    readonly overflowFindings: number;
+    readonly resolvedFindings: number;
+    readonly findingStates?: Readonly<Record<'open' | 'fixed' | 'obsolete' | 'dismissed' | 'reopened', number>>;
+    readonly outcome: BugbotReviewOutcome;
+    readonly errorCategory?: string;
+}
+export interface BugbotTelemetryPort {
+    publish(snapshot: BugbotReviewTelemetrySnapshot): Promise<void> | void;
+}

package/build/api/src/application/ports/pull_request_review_comment_ports.d.ts

@@ -0,0 +1,43 @@
+export type PullRequestReviewComment = {
+    /** Event-facing numeric reference retained only for point lookups. */
+    id: number;
+    /** Lossless opaque identity used by mutations and thread lookup. */
+    identity: string;
+    body: string | null;
+    path?: string;
+    line?: number;
+    authorLogin?: string;
+};
+export type PullRequestReviewCommentDraft = {
+    path: string;
+    body: string;
+    line?: number;
+    side?: "LEFT" | "RIGHT";
+    startLine?: number;
+    startSide?: "LEFT" | "RIGHT";
+    subjectType?: "line" | "file";
+};
+export interface PullRequestReviewCommentListQueryPort {
+    listPullRequestReviewComments(owner: string, repository: string, pullRequestNumber: number, token: string): Promise<PullRequestReviewComment[]>;
+}
+export interface PullRequestReviewCommentBodyQueryPort {
+    getPullRequestReviewCommentBody(owner: string, repository: string, pullRequestNumber: number, commentId: number, token: string): Promise<string | null>;
+}
+export interface PullRequestReviewCommentQueryPort extends PullRequestReviewCommentListQueryPort, PullRequestReviewCommentBodyQueryPort {
+}
+export interface PullRequestReviewCommentCreatePort {
+    createReviewWithComments(owner: string, repository: string, pullRequestNumber: number, commitId: string, body: string, comments: PullRequestReviewCommentDraft[], token: string): Promise<void>;
+}
+export interface PullRequestReviewCommentUpdatePort {
+    updatePullRequestReviewComment(owner: string, repository: string, commentIdentity: string, body: string, token: string): Promise<void>;
+}
+export interface PullRequestReviewCommentCommandPort extends PullRequestReviewCommentCreatePort, PullRequestReviewCommentUpdatePort {
+}
+export interface PullRequestReviewThreadCommandPort {
+    resolvePullRequestReviewThread(owner: string, repository: string, pullRequestNumber: number, commentIdentity: string, token: string): Promise<void>;
+    unresolvePullRequestReviewThread(owner: string, repository: string, pullRequestNumber: number, commentIdentity: string, token: string): Promise<void>;
+}
+export interface PullRequestReviewThreadStateQueryPort {
+    /** Maps review-comment node identities to their parent thread resolution state. */
+    listPullRequestReviewThreadStates(owner: string, repository: string, pullRequestNumber: number, token: string): Promise<Record<string, boolean>>;
+}

package/build/api/src/application/usecases/steps/commit/bugbot/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Bugbot types: data structures used across detection, publishing, and autofix.
+ * GitHub supplies the canonical PR diff and the configured agent can inspect
+ * the read-only workspace for context before returning findings.
+ */
+/** Single finding from the configured findings agent. */
+export interface BugbotFinding {
+    id: string;
+    title: string;
+    description: string;
+    /** Computed locally; never accepted from the agent as an authority. */
+    fingerprint?: string;
+    /** Location-independent reconciliation identity computed locally. */
+    semanticFingerprint?: string;
+    file?: string;
+    line?: number;
+    endLine?: number;
+    severity?: string;
+    confidence?: number;
+    category?: string;
+    evidence?: string;
+    suggestion?: string;
+    /** Optional enclosing symbol used only to improve local identity. */
+    symbol?: string;
+    /** Short code anchor used only to improve local identity. */
+    codeSnippet?: string;
+    /** Exact replacement text for a GitHub suggested change, when safe and local. */
+    suggestedCode?: string;
+}
+export interface ExistingIssueFindingInfo {
+    commentId: number;
+    resolved: boolean;
+    fingerprint?: string;
+    semanticFingerprint?: string;
+    resolution?: BugbotFindingResolution;
+}
+export interface ExistingPullRequestFindingInfo {
+    commentIdentity: string;
+    pullRequestNumber: number;
+    resolved: boolean;
+    /** Fresh GitHub thread state when the provider supplied it. */
+    threadResolved?: boolean;
+    fingerprint?: string;
+    semanticFingerprint?: string;
+    resolution?: BugbotFindingResolution;
+}
+export type BugbotFindingResolution = 'fixed' | 'obsolete' | 'dismissed';
+/** Tracks each published destination independently so partial failures remain retryable. */
+export interface ExistingFindingInfo {
+    issue?: ExistingIssueFindingInfo;
+    pullRequest?: ExistingPullRequestFindingInfo;
+}
+export type ExistingByFindingId = Record<string, ExistingFindingInfo>;
+export declare function isExistingFindingFullyResolved(finding: ExistingFindingInfo): boolean;
+/** PR metadata used only when publishing findings to GitHub. */
+export interface BugbotPrContext {
+    prHeadSha: string;
+    prFiles: Array<{
+        filename: string;
+        status: string;
+    }>;
+    pathToFirstDiffLine: Record<string, number>;
+    pathToDiffLocations?: Record<string, Array<{
+        line: number;
+        side: 'LEFT' | 'RIGHT';
+    }>>;
+    changes?: Array<{
+        filename: string;
+        status: string;
+        additions: number;
+        deletions: number;
+        patch: string;
+    }>;
+}
+/** Unresolved finding with a prompt-bounded comment body. */
+export interface UnresolvedFindingWithBody {
+    id: string;
+    fullBody: string;
+}
+/** Finding projection used by prompts that ask the agent to select findings. */
+export interface UnresolvedFindingSummary {
+    id: string;
+    title: string;
+    description?: string;
+    file?: string;
+    line?: number;
+}
+export declare function findExistingFindingInfo(existingByFindingId: ExistingByFindingId, finding: Pick<BugbotFinding, 'id' | 'fingerprint' | 'semanticFingerprint'>): ExistingFindingInfo | undefined;
+/** Full context for detection, mutation, publishing, and autofix intent. */
+export interface BugbotContext {
+    existingByFindingId: ExistingByFindingId;
+    /** Full issue-comment bodies reserved for read-modify-write operations. */
+    issueComments: Array<{
+        id: number;
+        body: string | null;
+    }>;
+    openPrNumbers: number[];
+    /** Bounded text sent to the configured findings agent. */
+    previousFindingsBlock: string;
+    /** Canonical, bounded PR diff supplied by the GitHub API. */
+    reviewDiffBlock?: string;
+    /** Bounded human review discussion that may affect finding validity. */
+    reviewConversationBlock?: string;
+    prContext: BugbotPrContext | null;
+    /** Bounded bodies used by intent prompts and autofix. */
+    unresolvedFindingsWithBody: UnresolvedFindingWithBody[];
+    /** Ordered, bounded rule content supplied to the reviewer. */
+    reviewRulesBlock?: string;
+    /** Auditable rule identities in effective precedence order. */
+    reviewRuleSources?: string[];
+    omittedReviewRules?: number;
+}

package/build/api/src/data/model/agent.d.ts

@@ -0,0 +1,2 @@
+export type { AgentConfiguration, AgentProvider, AgentCapability, AgentTask, AgentTaskConfiguration, } from '../../domain/agent';
+export { isAgentConfigurationReady } from '../../domain/agent';

package/build/api/src/data/model/ai.d.ts

@@ -0,0 +1,28 @@
+import { AgentConfiguration, AgentTask, AgentTaskConfiguration } from './agent';
+import { type PullRequestDescriptionMode } from '../../domain/pull_request_description';
+import { type BugbotReviewConfiguration } from '../../domain/bugbot/review_configuration';
+export declare class Ai {
+    private aiPullRequestDescription;
+    private aiMembersOnly;
+    private aiIgnoreFiles;
+    private aiIncludeReasoning;
+    private bugbotMinSeverity;
+    private bugbotCommentLimit;
+    private bugbotFixVerifyCommands;
+    private agentTasks;
+    private pullRequestDescriptionMode;
+    private bugbotReviewConfiguration;
+    constructor(_configurationSource: string, model: string, aiPullRequestDescription: boolean, aiMembersOnly: boolean, aiIgnoreFiles: string[], aiIncludeReasoning: boolean, bugbotMinSeverity: string, bugbotCommentLimit: number, bugbotFixVerifyCommands?: string[], agentTasks?: AgentTaskConfiguration, pullRequestDescriptionMode?: PullRequestDescriptionMode, bugbotReviewConfiguration?: Partial<BugbotReviewConfiguration>);
+    getAiPullRequestDescription(): boolean;
+    getPullRequestDescriptionMode(): PullRequestDescriptionMode;
+    getAiMembersOnly(): boolean;
+    getAiIgnoreFiles(): string[];
+    getAiIncludeReasoning(): boolean;
+    getBugbotMinSeverity(): string;
+    getBugbotCommentLimit(): number;
+    getBugbotFixVerifyCommands(): string[];
+    getBugbotReviewConfiguration(): BugbotReviewConfiguration;
+    /** Applies command-scoped review options and restores the shared configuration afterwards. */
+    withBugbotReviewConfiguration<T>(overrides: Partial<BugbotReviewConfiguration>, operation: () => Promise<T>): Promise<T>;
+    getAgentConfiguration(task: AgentTask): AgentConfiguration;
+}

package/build/api/src/data/model/branch_configuration.d.ts

@@ -0,0 +1,6 @@
+export declare class BranchConfiguration {
+    name: string;
+    oid: string;
+    children: BranchConfiguration[];
+    constructor(data: unknown);
+}

package/build/api/src/data/model/branches.d.ts

@@ -0,0 +1,12 @@
+export declare class Branches {
+    main: string;
+    defaultBranch: string;
+    development: string;
+    featureTree: string;
+    bugfixTree: string;
+    hotfixTree: string;
+    releaseTree: string;
+    docsTree: string;
+    choreTree: string;
+    constructor(main: string, defaultBranch: string, development: string, featureTree: string, bugfixTree: string, hotfixTree: string, releaseTree: string, docsTree: string, choreTree: string);
+}

package/build/api/src/data/model/commit.d.ts

@@ -0,0 +1,8 @@
+import type { EventCommitPayload, ExecutionInputs } from './execution_inputs';
+export declare class Commit {
+    private inputs;
+    constructor(inputs?: ExecutionInputs | undefined);
+    get branchReference(): string;
+    get branch(): string;
+    get commits(): EventCommitPayload[];
+}

package/build/api/src/data/model/config.d.ts

@@ -0,0 +1,30 @@
+import { BranchConfiguration } from "./branch_configuration";
+import { RecommendationState } from "./recommendation_state";
+import { Result } from "./result";
+/** Version of the durable configuration contract stored in issue/PR content. */
+export declare const CONFIG_SCHEMA_VERSION = 2;
+export interface ConfigurationMigrationResult {
+    readonly payload: Record<string, unknown>;
+    readonly sourceVersion: number;
+    readonly migrated: boolean;
+    readonly futureVersion: boolean;
+}
+/**
+ * Normalizes persisted configuration without silently losing fields from a
+ * newer installation. Unknown keys are deliberately retained so a downgrade
+ * or a mixed-version workflow can round-trip data safely.
+ */
+export declare function migrateConfigurationPayload(value: unknown): ConfigurationMigrationResult;
+export declare class Config {
+    readonly schemaVersion: number;
+    branchType: string;
+    releaseBranch: string | undefined;
+    workingBranch: string | undefined;
+    parentBranch: string | undefined;
+    hotfixOriginBranch: string | undefined;
+    hotfixBranch: string | undefined;
+    results: Result[];
+    branchConfiguration: BranchConfiguration | undefined;
+    recommendationState: RecommendationState | undefined;
+    constructor(data: unknown);
+}

package/build/api/src/data/model/emoji.d.ts

@@ -0,0 +1,5 @@
+export declare class Emoji {
+    emojiLabeledTitle: boolean;
+    branchManagementEmoji: string;
+    constructor(emojiLabeledTitle: boolean, branchManagementEmoji: string);
+}

package/build/api/src/data/model/execution.d.ts

@@ -0,0 +1,75 @@
+import { Ai } from "./ai";
+import { Branches } from "./branches";
+import { Commit } from "./commit";
+import { Config } from "./config";
+import { Emoji } from "./emoji";
+import { Hotfix } from "./hotfix";
+import { Images } from "./images";
+import { Issue } from "./issue";
+import { IssueTypes } from "./issue_types";
+import { Labels } from "./labels";
+import { Locale } from "./locale";
+import { Projects } from "./projects";
+import { PullRequest } from "./pull_request";
+import { Release } from "./release";
+import { SingleAction } from "./single_action";
+import { SizeThresholds } from "./size_thresholds";
+import { Tokens } from "./tokens";
+import { Welcome } from "./welcome";
+import { Workflows } from "./workflows";
+import type { ExecutionInputs } from './execution_inputs';
+import type { ExecutionComponents } from './execution_components';
+export declare class Execution {
+    debug: boolean;
+    welcome: Welcome | undefined;
+    /**
+     * Every usage of this field should be checked.
+     * PRs with no issue ID in the head branch won't have it.
+     *
+     * master <- develop
+     */
+    issueNumber: number;
+    singleAction: SingleAction;
+    commitPrefixBuilder: string;
+    commitPrefixBuilderParams: Record<string, unknown>;
+    emoji: Emoji;
+    images: Images;
+    tokens: Tokens;
+    ai: Ai;
+    labels: Labels;
+    issueTypes: IssueTypes;
+    locale: Locale;
+    sizeThresholds: SizeThresholds;
+    branches: Branches;
+    release: Release;
+    hotfix: Hotfix;
+    issue: Issue;
+    pullRequest: PullRequest;
+    workflows: Workflows;
+    project: Projects;
+    previousConfiguration: Config | undefined;
+    currentConfiguration: Config;
+    tokenUser: string | undefined;
+    inactivityThresholdHours: number;
+    inputs: ExecutionInputs | undefined;
+    get eventName(): string;
+    get actor(): string;
+    get isSingleAction(): boolean;
+    get isIssue(): boolean;
+    get isPullRequest(): boolean;
+    get isPush(): boolean;
+    get repo(): string;
+    get owner(): string;
+    get isFeature(): boolean;
+    get isBugfix(): boolean;
+    get isDocs(): boolean;
+    get isChore(): boolean;
+    get isBranched(): boolean;
+    get issueNotBranched(): boolean;
+    get managementBranch(): string;
+    get issueType(): string;
+    get cleanIssueBranches(): boolean;
+    get commit(): Commit;
+    get runnedByToken(): boolean;
+    constructor(components: ExecutionComponents);
+}

package/build/api/src/data/model/execution_components.d.ts

@@ -0,0 +1,43 @@
+import type { Ai } from './ai';
+import type { Branches } from './branches';
+import type { Emoji } from './emoji';
+import type { Hotfix } from './hotfix';
+import type { Images } from './images';
+import type { Issue } from './issue';
+import type { IssueTypes } from './issue_types';
+import type { Labels } from './labels';
+import type { Locale } from './locale';
+import type { Projects } from './projects';
+import type { PullRequest } from './pull_request';
+import type { Release } from './release';
+import type { SingleAction } from './single_action';
+import type { SizeThresholds } from './size_thresholds';
+import type { Tokens } from './tokens';
+import type { Welcome } from './welcome';
+import type { Workflows } from './workflows';
+import type { ExecutionInputs } from './execution_inputs';
+/** Immutable construction contract for the runtime execution aggregate. */
+export interface ExecutionComponents {
+    debug: boolean;
+    singleAction: SingleAction;
+    commitPrefixBuilder: string;
+    issue: Issue;
+    pullRequest: PullRequest;
+    emoji: Emoji;
+    images: Images;
+    tokens: Tokens;
+    ai: Ai;
+    labels: Labels;
+    issueTypes: IssueTypes;
+    locale: Locale;
+    sizeThresholds: SizeThresholds;
+    branches: Branches;
+    release: Release;
+    hotfix: Hotfix;
+    workflows: Workflows;
+    projects: Projects;
+    tokenUser?: string;
+    welcome?: Welcome;
+    inactivityThresholdHours?: number;
+    inputs?: ExecutionInputs;
+}