@weareikko/code-review 0.0.1 → 0.8.1

package/dist/github.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Metadata about a single completed HTTP request, reported to `onResponse`.
+ * Deliberately telemetry-agnostic: the OTel bridge maps these onto HTTP
+ * semantic-convention span attributes, but the client itself has no OTel
+ * dependency. Carries no secrets — the token lives in a request header, not
+ * the URL.
+ */
+export interface GitHubResponseInfo {
+    method: string;
+    path: string;
+    url: string;
+    status: number;
+    /** Parsed Content-Length header in bytes, when the response provided one. */
+    responseContentLength?: number;
+}
+export interface GitHubClientOptions {
+    /**
+     * REST API base, honoring `GITHUB_API_URL` (default `https://api.github.com`;
+     * GitHub Enterprise sets it to e.g. `https://ghe.example.com/api/v3`). Paths
+     * are appended directly, so the base must already include any `/api/v3` prefix.
+     */
+    apiUrl?: string;
+    token: string;
+    fetchImpl?: typeof fetch;
+    requestTimeout?: number;
+    /**
+     * Optional instrumentation callback invoked once per completed HTTP response
+     * (success or error status), before any error is thrown. Used to surface HTTP
+     * metadata to diagnostics/OTel without coupling the client to those layers.
+     */
+    onResponse?: (info: GitHubResponseInfo) => void;
+}
+export declare const DEFAULT_GITHUB_API_URL = "https://api.github.com";
+/**
+ * Extract the `rel="next"` URL from a GitHub `Link` response header, or `null`
+ * when there is no next page. GitHub paginates with absolute URLs in this header
+ * rather than the page-number headers GitLab uses.
+ */
+export declare function parseNextLink(header: string | null | undefined): string | null;
+export interface PullRequestRef {
+    ref: string;
+    sha: string;
+}
+export interface PullRequest {
+    head: PullRequestRef;
+    base: PullRequestRef;
+    /** PR title — the one-line declared intent of the change. May be empty. */
+    title?: string;
+    /** PR body — the author's full reasoning / decision log. May be empty or null. */
+    body?: string | null;
+}
+export interface GitHubUser {
+    id: number;
+    login: string;
+}
+/** An inline pull-request review comment (positioned against the diff). */
+export interface PullRequestReviewComment {
+    id: number;
+    body?: string | null;
+    path?: string;
+    /** Line in the diff's new file, when the comment still anchors to it. */
+    line?: number | null;
+    original_line?: number | null;
+    side?: string | null;
+    in_reply_to_id?: number;
+    user?: GitHubUser | null;
+}
+/** A non-positional issue/PR-level comment (the summary note lives here). */
+export interface IssueComment {
+    id: number;
+    body?: string | null;
+    user?: GitHubUser | null;
+}
+/** A single inline comment in a batched review payload. */
+export interface ReviewCommentInput {
+    path: string;
+    body: string;
+    line?: number;
+    side?: string;
+    start_line?: number;
+    start_side?: string;
+}
+/**
+ * Payload for a batched pull-request review. Posted as one atomic review
+ * (`event: 'COMMENT'`) to avoid per-comment secondary rate limits.
+ */
+export interface CreateReviewInput {
+    commit_id: string;
+    event?: string;
+    body?: string;
+    comments?: ReviewCommentInput[];
+}
+export interface Review {
+    id: number;
+}
+export declare class GitHubClient {
+    private readonly base;
+    private readonly token;
+    private readonly fetchImpl;
+    private readonly requestTimeout;
+    private readonly onResponse?;
+    constructor(options: GitHubClientOptions);
+    private reportResponse;
+    url(path: string, query?: Record<string, string | number | boolean | undefined>): string;
+    private headers;
+    private fetchWithTimeout;
+    private failure;
+    request<T>(path: string, init?: RequestInit, query?: Record<string, string | number | boolean | undefined>): Promise<T>;
+    /** Follow GitHub `Link` `rel="next"` headers, accumulating every page. */
+    paginate<T>(path: string, query?: Record<string, string | number | boolean | undefined>): Promise<T[]>;
+    getPullRequest(owner: string, repo: string, pull: number): Promise<PullRequest>;
+    listReviewComments(owner: string, repo: string, pull: number): Promise<PullRequestReviewComment[]>;
+    listIssueComments(owner: string, repo: string, pull: number): Promise<IssueComment[]>;
+    createReview(owner: string, repo: string, pull: number, payload: CreateReviewInput): Promise<Review>;
+    createIssueComment(owner: string, repo: string, pull: number, body: string): Promise<IssueComment>;
+    updateIssueComment(owner: string, repo: string, commentId: number, body: string): Promise<IssueComment>;
+    getCurrentUser(): Promise<GitHubUser>;
+}
+//# sourceMappingURL=github.d.ts.map

package/dist/github.d.ts.map

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

package/dist/gitlab-review.d.ts

@@ -0,0 +1,210 @@
+import type { AgentEvent, AgentTool } from '@earendil-works/pi-agent-core';
+import type { AssistantMessage, Model } from '@earendil-works/pi-ai';
+import type { Config } from './config.js';
+import type { Logger } from './logger.js';
+import type { PriorThread } from './prior-threads.js';
+import type { Skill } from './skills.js';
+import { type SkippedDiffFile } from './skipped-retrieval.js';
+import { type ReviewAngle } from './triage.js';
+import type { GitLabReviewSeverity, SizeSkippedFile, ThinkingLevel } from './types.js';
+export interface UsageBreakdown {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    total: number;
+}
+/**
+ * MR size signals derived from the reviewed diff: files dropped for exceeding
+ * the char budget, and an optional "this MR is too big — decompose it" hint when
+ * the reviewed changed-line count crosses the configured threshold.
+ */
+export interface ReviewSizeNotice {
+    sizeSkippedFiles: SizeSkippedFile[];
+    decomposeHint?: {
+        lines: number;
+        threshold: number;
+    };
+    /**
+     * Diff coverage when files were dropped for the char budget: how many changed
+     * lines were actually reviewed vs the total. Present only when something was
+     * size-skipped, so a partial review reports its coverage instead of reading as
+     * a confident full review.
+     */
+    coverage?: {
+        reviewedLines: number;
+        totalLines: number;
+    };
+}
+/** Token and cost usage attributed to a single pool member. */
+export interface ModelUsage {
+    model: string;
+    tokens: UsageBreakdown;
+    cost: UsageBreakdown;
+}
+export interface ReviewUsage {
+    model: string;
+    /** Reasoning effort the main agent ran at, surfaced alongside the model in the footer. */
+    thinkingLevel: ThinkingLevel;
+    tokens: UsageBreakdown;
+    cost: UsageBreakdown;
+    /**
+     * Per-pool-member usage breakdown for heterogeneous `full`-depth runs. Each
+     * entry attributes the tokens/cost of the agents that ran on that pool member.
+     * The top-level `model`/`tokens`/`cost` stay the main model and the totals (the
+     * sum of all entries). Present only when more than one distinct model ran; the
+     * single-model path leaves it undefined so output is byte-identical to before.
+     */
+    byModel?: ModelUsage[];
+    skills: string[];
+    /**
+     * Size signals for surfacing in the MR summary. `sizeSkippedFiles` lists files
+     * dropped for the char budget; `decomposeHint` is set when the reviewed diff is
+     * past the configured line threshold. Both feed the prominent summary callout.
+     */
+    sizeNotice: ReviewSizeNotice;
+}
+export interface AgentLike {
+    subscribe(listener: (event: AgentEvent) => void | Promise<void>): () => void;
+    prompt(input: string): Promise<void>;
+}
+export interface CreateAgentParams {
+    systemPrompt: string;
+    model: Model<string>;
+    tools: AgentTool[];
+    thinkingLevel: ThinkingLevel;
+    getApiKey: () => Promise<string>;
+}
+export type CreateAgent = (params: CreateAgentParams) => AgentLike;
+export interface RunReviewOptions {
+    cwd?: string;
+    diff: string;
+    /**
+     * Commit messages for all non-merge commits in the MR (merge-base…HEAD),
+     * in chronological order. When provided, a `<commits>` section is prepended
+     * to the user prompt so the reviewer understands the intent behind each change.
+     * Produced by `getMergeCommitLog` in `src/git.ts`.
+     */
+    commitLog?: string;
+    createAgent?: CreateAgent;
+    timeoutMs?: number;
+    logger?: Logger;
+    /**
+     * Prior developer replies to bot-posted review threads on the MR.
+     * When provided, a `<prior_review_feedback>` section is appended to the user
+     * prompt after `<diff>` so the reviewer can avoid re-raising already-acknowledged
+     * concerns and can provide contextual follow-up.
+     * Produced by `extractPriorThreads` in `src/prior-threads.ts`.
+     */
+    priorThreads?: PriorThread[];
+    /**
+     * Author-declared intent for the MR (title + description). When present and
+     * non-empty, an `<intent>` block is prepended to the user prompt so the
+     * reviewer can check the diff against the stated purpose and flag code/intent
+     * mismatches. A missing or empty description degrades gracefully (no block).
+     * Sourced from the GitLab MR via `getMergeRequest` in `src/gitlab.ts`.
+     */
+    intent?: ReviewIntent;
+    /**
+     * Called with the agent after it is created, before the first prompt.
+     * Use this to attach telemetry (e.g. `otelBridge.createAgentTelemetry(runId)`).
+     * The returned function, if any, is called after the review completes.
+     */
+    attachTelemetry?: (agent: AgentLike) => (() => void) | undefined;
+}
+interface ContextFile {
+    path: string;
+    content: string;
+}
+interface ReviewContext {
+    conventions: ContextFile[];
+    reviewRules: ContextFile[];
+    skills: Skill[];
+}
+export interface LoadReviewContextOptions {
+    /** Re-clone `git:` / `git+ssh:` skills, bypassing the on-disk clone cache. */
+    refreshGitSkills?: boolean;
+}
+export declare function loadReviewContext(cwd: string, skillNames?: string[], warn?: (msg: string) => void, options?: LoadReviewContextOptions): Promise<ReviewContext>;
+export interface FilteredDiff {
+    diff: string;
+    /** Files dropped because they matched a noise pattern (lockfiles, generated, build output). */
+    noiseSkippedFiles: string[];
+    /** Files dropped because including them would exceed the char budget, with their diff size. */
+    sizeSkippedFiles: SizeSkippedFile[];
+    /** Number of added/removed lines in the reviewed (included) diff. */
+    reviewedChangedLines: number;
+    /** Number of added/removed lines in files dropped for the char budget. */
+    skippedChangedLines: number;
+    /**
+     * The raw diff text of each size-dropped file, keyed by path. Lets the caller
+     * write them to disk so an agentic reviewer can read the dropped diffs on
+     * demand instead of losing them entirely (opt-in retrieval).
+     */
+    sizeSkippedSections: Array<{
+        path: string;
+        section: string;
+    }>;
+}
+export declare function filterDiff(raw: string, maxChars?: number): FilteredDiff;
+export declare function buildJSONSystemPrompt(context: ReviewContext, minSeverity: GitLabReviewSeverity): string;
+/**
+ * Author-declared intent for the change, sourced from the GitLab MR.
+ * Both fields are optional and may be empty/whitespace — the renderer degrades
+ * gracefully and emits no intent block when there is nothing meaningful to show.
+ */
+export interface ReviewIntent {
+    title?: string;
+    description?: string | null;
+}
+/**
+ * Build a Find system prompt specialised to one review angle. Used by `full`
+ * depth, which runs one finder per angle. The base prompt (severity/confidence
+ * tiers, output format, skills, conventions) is unchanged; an `<review_angle>`
+ * section narrows the finder to its lane so the finders cover breadth rather
+ * than all re-finding the same top issue.
+ */
+export declare function buildAngleSystemPrompt(context: ReviewContext, minSeverity: GitLabReviewSeverity, angle: ReviewAngle): string;
+export declare function buildUserPrompt(diff: string, skippedFiles?: string[], commitLog?: string, priorThreads?: PriorThread[], intent?: ReviewIntent, coverage?: {
+    reviewedLines: number;
+    totalLines: number;
+}, retrievableSkipped?: SkippedDiffFile[]): string;
+export declare function extractLastAssistantText(messages: AssistantMessage[]): string;
+/**
+ * One usable model in the review pool. `id` is the original `provider/modelId`
+ * string — the stable identity used for fixed angle→model mapping, cross-family
+ * verifier selection, and per-model usage keying. `getApiKey` resolves THIS
+ * member's provider key, so a key for provider X is never sent to provider Y.
+ */
+export interface PoolMember {
+    id: string;
+    model: Model<string>;
+    getApiKey: () => Promise<string>;
+}
+/**
+ * Build the effective model pool from `config.model` plus `config.modelPool`,
+ * resolving each member's own provider key and dropping (with a warning) any
+ * member whose key is missing/empty. Order and duplicates from `config.modelPool`
+ * are preserved by first occurrence. When the pool is empty or every member is
+ * unusable, falls back to a single-member pool of `config.model` (already
+ * validated to have a key) — reproducing single-model behaviour exactly.
+ *
+ * `config.apiKey` (which honours `--api-key`) is used for any member whose id
+ * equals `config.model`, so an explicit override key still applies; other members
+ * resolve their key via the provider-aware resolver.
+ */
+export declare function buildEffectivePool(config: Config, logger: Logger): PoolMember[];
+/** Blended per-token cost (input + output) used to compare model tiers. */
+export declare function blendedCost(model: Model<string>): number;
+/**
+ * Resolve `config.verifyModel` into a dedicated Verify-stage pool member. Returns
+ * null when unset (Verify falls back to the pool's cross-family pick) or when the
+ * model/key can't be resolved (warns and falls back, so a bad value never aborts
+ * the run). Also warns when the verify model is a *cheaper* tier than the finder:
+ * the Verify stage is a precision-judgment task, and a weak verifier drops real
+ * findings (recall loss) — so cheap-find/strong-verify is the intended shape.
+ */
+export declare function resolveVerifyMember(config: Config, primary: PoolMember, logger: Logger): PoolMember | null;
+export declare function runReview(config: Config, options: RunReviewOptions): Promise<ReviewUsage>;
+export {};
+//# sourceMappingURL=gitlab-review.d.ts.map

package/dist/gitlab-review.d.ts.map

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

package/dist/gitlab.d.ts

@@ -0,0 +1,98 @@
+import type { GitLabAuthHeader } from './config.js';
+/**
+ * Metadata about a single completed HTTP request, reported to `onResponse`.
+ * Deliberately telemetry-agnostic: the OTel bridge maps these onto HTTP
+ * semantic-convention span attributes, but the client itself has no OTel
+ * dependency. Carries no secrets — the token lives in a request header, not
+ * the URL.
+ */
+export interface GitLabResponseInfo {
+    method: string;
+    path: string;
+    url: string;
+    status: number;
+    /** Parsed Content-Length header in bytes, when the response provided one. */
+    responseContentLength?: number;
+}
+export interface GitLabClientOptions {
+    gitlabUrl: string;
+    token: string;
+    authHeader?: GitLabAuthHeader;
+    fetchImpl?: typeof fetch;
+    requestTimeout?: number;
+    /**
+     * Optional instrumentation callback invoked once per completed HTTP response
+     * (success or error status), before any error is thrown. Used to surface HTTP
+     * metadata to diagnostics/OTel without coupling the client to those layers.
+     */
+    onResponse?: (info: GitLabResponseInfo) => void;
+}
+export interface MergeRequest {
+    source_branch: string;
+    target_branch: string;
+    /** MR title — the one-line declared intent of the change. May be empty. */
+    title?: string;
+    /** MR description — the author's full reasoning / decision log. May be empty or null. */
+    description?: string | null;
+}
+export interface Version {
+    base_commit_sha: string;
+    start_commit_sha: string;
+    head_commit_sha: string;
+}
+export interface DiscussionNotePosition {
+    old_path?: string | null;
+    new_path?: string | null;
+    old_line?: number | null;
+    new_line?: number | null;
+}
+export interface DiscussionNote {
+    id?: number;
+    body?: string | null;
+    system?: boolean;
+    resolved?: boolean;
+    position?: DiscussionNotePosition;
+}
+export interface Discussion {
+    notes: DiscussionNote[];
+}
+export interface MergeRequestNote {
+    id: number;
+    body: string;
+}
+export interface DraftNote {
+    id: number;
+    author_id: number;
+    note: string;
+}
+export interface CurrentUser {
+    id: number;
+}
+export declare class GitLabClient {
+    private readonly base;
+    private readonly token;
+    private readonly authHeader;
+    private readonly fetchImpl;
+    private readonly requestTimeout;
+    private readonly onResponse?;
+    constructor(options: GitLabClientOptions);
+    private reportResponse;
+    url(path: string, query?: Record<string, string | number | boolean | undefined>): string;
+    private headers;
+    private fetchWithTimeout;
+    request<T>(path: string, init?: RequestInit, query?: Record<string, string | number | boolean | undefined>): Promise<T>;
+    paginate<T>(path: string, query?: Record<string, string | number | boolean | undefined>): Promise<T[]>;
+    getMergeRequest(project: string, mr: string): Promise<MergeRequest>;
+    getLatestVersion(project: string, mr: string): Promise<Version>;
+    getDiscussions(project: string, mr: string): Promise<Discussion[]>;
+    postDiscussion(project: string, mr: string, payload: unknown): Promise<unknown>;
+    createMergeRequestNote(project: string, mr: string, body: string): Promise<MergeRequestNote>;
+    updateMergeRequestNote(project: string, mr: string, noteId: number, body: string): Promise<MergeRequestNote>;
+    getCurrentUser(): Promise<CurrentUser>;
+    listDraftNotes(project: string, mr: string): Promise<DraftNote[]>;
+    createDraftNote(project: string, mr: string, payload: unknown): Promise<DraftNote>;
+    deleteDraftNote(project: string, mr: string, id: number): Promise<void>;
+    bulkPublishDraftNotes(project: string, mr: string): Promise<void>;
+    publishDraftNote(project: string, mr: string, id: number): Promise<void>;
+}
+//# sourceMappingURL=gitlab.d.ts.map

package/dist/gitlab.d.ts.map

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

package/dist/logger.d.ts

@@ -0,0 +1,10 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface Logger {
+    debug(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+export declare function createLogger(minLevel?: LogLevel): Logger;
+export declare const noopLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAI3D,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,wBAAgB,YAAY,CAAC,QAAQ,GAAE,QAAiB,GAAG,MAAM,CAYhE;AAED,eAAO,MAAM,UAAU,EAAE,MAKxB,CAAC"}

package/dist/otel.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Optional OpenTelemetry bridge over `diagnostics_channel` and the agent
+ * event stream.
+ *
+ * Subscribes to every `@weareikko/code-review:*` tracing channel, opens an
+ * OTel span on `start`, and closes it on `asyncEnd`/`error`. The `reviewer.run`
+ * phase additionally carries OpenTelemetry GenAI semantic-convention
+ * attributes (`gen_ai.*`) and emits the standardized GenAI client metrics
+ * (`gen_ai.client.operation.duration`, `gen_ai.client.token.usage`,
+ * `gen_ai.client.cost`, `gen_ai.client.time_to_first_token`) so
+ * metrics-driven AI observability surfaces auto-discover the service.
+ *
+ * Per-turn and per-tool-call telemetry is captured via `createAgentTelemetry`,
+ * which subscribes to the agent's live event stream and emits:
+ *   - `gen_ai.agent.turn` child spans under `invoke_agent code-review`
+ *   - `execute_tool <name>` grandchild spans under each turn
+ *   - Per-turn `gen_ai.client.token.usage` and `gen_ai.client.cost` metrics
+ *   - `gen_ai.client.time_to_first_token` when streaming events fire
+ *
+ * Opt-in: set `CODE_REVIEW_OTEL=1`. Exporter selection and endpoint follow
+ * the standard `OTEL_*` env vars (`OTEL_EXPORTER_OTLP_ENDPOINT`,
+ * `OTEL_EXPORTER_OTLP_HEADERS`, …).
+ *
+ * **Content capture**: set `CODE_REVIEW_OTEL_CAPTURE_CONTENT=1` to attach
+ * LLM output text and tool arguments/results to spans as `gen_ai.output.messages`,
+ * `gen_ai.tool.call.arguments`, and `gen_ai.tool.call.result`. These attributes
+ * may contain code diffs and review commentary — only enable after confirming
+ * your observability backend's data-retention and PII policies allow it.
+ *
+ * **Grafana Cloud token scopes**: for all three signals to reach their
+ * respective backends, the service account token used in
+ * `OTEL_EXPORTER_OTLP_HEADERS` must have:
+ *   - `Traces Publisher` — writes to Tempo (traces)
+ *   - `Metrics Publisher` — writes to Mimir (gen_ai.* histograms)
+ *   - `Logs Publisher` — writes to Loki (structured log records)
+ * A token missing any of these scopes will receive `401 Unauthorized:
+ * invalid scope requested` silently from the OTLP gateway. Enable OTel
+ * diagnostics with `OTEL_LOG_LEVEL=error` to surface export failures.
+ *
+ * The OTel SDK runtime is bundled but loaded via dynamic `import()` behind the
+ * env check, so disabling the bridge skips the SDK boot entirely. Library
+ * callers who already have configured providers in their process can inject
+ * their own runtime via `startOtelBridge({ runtime })` so spans and metrics
+ * join the host providers instead of a second `NodeSDK`.
+ */
+import type { MeterProvider, TracerProvider } from '@opentelemetry/api';
+import type { LoggerProvider } from '@opentelemetry/api-logs';
+import type { AgentLike } from './gitlab-review.js';
+import { type GeneratedComment } from './types.js';
+export interface OtelBridge {
+    shutdown(): Promise<void>;
+    /**
+     * Returns a function that, when called with an agent, subscribes to its live
+     * event stream and emits per-turn and per-tool-call OTel spans/metrics.
+     * Must be called after the `reviewer.run` diagnostic span is open (i.e. from
+     * inside `traceDiagnosticPhase('reviewer.run', ...)`). Returns `undefined`
+     * when the span is not yet open or OTel is disabled.
+     */
+    createAgentTelemetry(runId: string): ((agent: AgentLike) => () => void) | undefined;
+    /**
+     * Emits one structured OTel log record per generated comment to Loki/the
+     * configured log backend. Each record carries `event.name`,
+     * `gitlab_review.comment.*` attributes, and the comment body as the log
+     * line. Safe to call at any point after the run phase has opened.
+     */
+    logComments(comments: GeneratedComment[], runId: string): void;
+}
+export interface OtelRuntime {
+    tracerProvider: TracerProvider;
+    meterProvider: MeterProvider;
+    loggerProvider: LoggerProvider;
+    shutdown(): Promise<void>;
+}
+export interface OtelBridgeOptions {
+    /**
+     * Pre-wired OTel runtime. When provided, the bridge uses the supplied
+     * providers and skips dynamic import of `@opentelemetry/sdk-node`. Library
+     * callers with configured `TracerProvider`/`MeterProvider` should pass their
+     * own providers plus a no-op `shutdown`; tests inject fakes with assertion
+     * hooks.
+     */
+    runtime?: OtelRuntime;
+    /**
+     * Override the env source used for the opt-in check. Defaults to
+     * `process.env`.
+     */
+    env?: NodeJS.ProcessEnv;
+    /**
+     * When true, attaches LLM output text and tool call arguments/results to
+     * spans as `gen_ai.output.messages`, `gen_ai.tool.call.arguments`, and
+     * `gen_ai.tool.call.result`. Defaults to `isContentCaptureEnabled(env)`.
+     *
+     * Only enable after confirming your observability backend's data-retention
+     * and PII policies permit storing code review content.
+     */
+    captureContent?: boolean;
+}
+export declare function isOtelEnabled(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Returns true when `CODE_REVIEW_OTEL_CAPTURE_CONTENT=1` (or `true`) is set.
+ *
+ * When enabled, per-turn assistant output text is attached to turn spans as
+ * `gen_ai.output.messages`, and tool arguments / results are attached to
+ * `execute_tool` spans as `gen_ai.tool.call.arguments` / `gen_ai.tool.call.result`.
+ *
+ * These fields may contain code diffs and review commentary — only enable after
+ * confirming your observability backend's data-retention and PII policies.
+ */
+export declare function isContentCaptureEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare function startOtelBridge(options?: OtelBridgeOptions): Promise<OtelBridge | null>;
+//# sourceMappingURL=otel.d.ts.map

package/dist/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../src/otel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,KAAK,EAMV,aAAa,EAGb,cAAc,EACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAU,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAQtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAO/D,MAAM,WAAW,UAAU;IACzB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;;;;;;OAMG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,KAAK,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACpF;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAChE;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA4DD,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAE3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAIrF;AAED,wBAAsB,eAAe,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAmUjG"}

package/dist/parser.d.ts

@@ -0,0 +1,27 @@
+import { type ReviewComment } from './types.js';
+/** Why the reviewer's JSON could not be recovered. Surfaced for diagnostics. */
+export type ParseFailureReason = 
+/** A ```json fence was present but its contents could not be parsed or repaired. */
+'fence_unparseable'
+/** An unfenced reviewer-shaped object was present but could not be parsed or repaired. */
+ | 'object_unparseable';
+export interface ParseFailure {
+    reason: ParseFailureReason;
+    /** Whitespace-collapsed first ~200 chars of the offending block, for logs/OTel. */
+    preview: string;
+}
+export interface ParseResult {
+    comments: ReviewComment[];
+    summary: string | null;
+    warnings: string[];
+    /**
+     * Set when the reviewer clearly intended to emit the `{ summary, comments }`
+     * JSON object but it could not be parsed (even after a best-effort repair),
+     * and nothing usable was recovered; `null` otherwise. The CLI fails loudly on
+     * a non-null value rather than marking the job successful with an empty review.
+     */
+    malformed: ParseFailure | null;
+}
+export declare function parseReviewMarkdownWithWarnings(markdown: string): ParseResult;
+export declare function parseReviewMarkdown(markdown: string): ReviewComment[];
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0C,KAAK,aAAa,EAAa,MAAM,YAAY,CAAC;AAGnG,gFAAgF;AAChF,MAAM,MAAM,kBAAkB;AAC5B,oFAAoF;AAClF,mBAAmB;AACrB,0FAA0F;GACxF,oBAAoB,CAAC;AAEzB,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;OAKG;IACH,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;CAChC;AAgVD,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAmB7E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAErE"}

package/dist/payloads.d.ts

@@ -0,0 +1,30 @@
+import { type ResolvedDiffLine } from './diff-lines.js';
+import type { Confidence, DiffRefs, GeneratedComment, GitLabDiscussionPayload, ReviewComment } from './types.js';
+export { type ResolvedDiffLine, resolveDiffLine } from './diff-lines.js';
+/**
+ * Builds the visible body of an inline comment.
+ *
+ * Layout:
+ *   <bold Conventional Comment title>
+ *   <discussion>
+ *
+ *   _Confidence: <level>._
+ *
+ *   ---
+ *
+ *   <commit footer>
+ *
+ * The confidence line sits between the reviewer's discussion and the
+ * horizontal rule so developers can see the reviewer's certainty without
+ * scrolling past the footer. The footer mirrors the format used in the
+ * MR-level summary note.
+ *
+ * Neither the confidence line nor the footer is included in the fingerprint
+ * hash, so comment identity (deduplication) remains stable across commits
+ * even when the SHA in the footer changes or the reviewer revises its
+ * confidence judgment.
+ */
+export declare function buildCommentBody(body: string, commitSha: string, confidence: Confidence): string;
+export declare function buildPayload(comment: ReviewComment, body: string, refs: DiffRefs, resolved?: ResolvedDiffLine | null): GitLabDiscussionPayload;
+export declare function buildGeneratedComments(comments: ReviewComment[], diff: string, refs: DiffRefs, existingFingerprints: Set<string>): GeneratedComment<GitLabDiscussionPayload>[];
+//# sourceMappingURL=payloads.d.ts.map

package/dist/payloads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payloads.d.ts","sourceRoot":"","sources":["../src/payloads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAmB,MAAM,iBAAiB,CAAC;AAGzE,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACd,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,KAAK,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAczE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CAIhG;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,EACd,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI,GACjC,uBAAuB,CAwBzB;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,aAAa,EAAE,EACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,EACd,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,GAChC,gBAAgB,CAAC,uBAAuB,CAAC,EAAE,CAuB7C"}