@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/core/schema/status-defs-file.d.ts

@@ -5,52 +5,52 @@ export type { RuntimeStatusDefinition, RuntimeStatusRole, } from "../../types/in
 export declare const BUILTIN_STATUS_IDS: ReadonlySet<string>;
 /** The shape persisted at `.agents/pm/schema/statuses.json`. */
 export interface StatusDefsFile {
-    /** Value that configures or reports statuses for this contract. */
-    statuses: RuntimeStatusDefinition[];
+/** Value that configures or reports statuses for this contract. */
+statuses: RuntimeStatusDefinition[];
 }
 /** Documents the raw add status input payload exchanged by command, SDK, and package integrations. */
 export interface RawAddStatusInput {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string | undefined;
-    /** Value that configures or reports roles for this contract. */
-    roles?: string[];
-    /** Value that configures or reports aliases for this contract. */
-    aliases?: string[];
-    /** Value that configures or reports description for this contract. */
-    description?: string;
-    /** Value that configures or reports order for this contract. */
-    order?: number;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string | undefined;
+/** Value that configures or reports roles for this contract. */
+roles?: string[];
+/** Value that configures or reports aliases for this contract. */
+aliases?: string[];
+/** Value that configures or reports description for this contract. */
+description?: string;
+/** Value that configures or reports order for this contract. */
+order?: number;
 }
 /** Documents the normalized add status input payload exchanged by command, SDK, and package integrations. */
 export interface NormalizedAddStatusInput {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Normalized roles, or `undefined` when the raw input did not supply a roles field at all. `undefined` means "leave existing roles untouched" on upsert; an explicit empty array means "clear roles". This distinction is what keeps `add-status review --description x` from wiping a previously-set role. */
-    roles?: RuntimeStatusRole[];
-    /** Same omitted-vs-explicit-empty semantics as `roles`. */
-    aliases?: string[];
-    /** Value that configures or reports description for this contract. */
-    description?: string;
-    /** Value that configures or reports order for this contract. */
-    order?: number;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Normalized roles, or `undefined` when the raw input did not supply a roles field at all. `undefined` means "leave existing roles untouched" on upsert; an explicit empty array means "clear roles". This distinction is what keeps `add-status review --description x` from wiping a previously-set role. */
+roles?: RuntimeStatusRole[];
+/** Same omitted-vs-explicit-empty semantics as `roles`. */
+aliases?: string[];
+/** Value that configures or reports description for this contract. */
+description?: string;
+/** Value that configures or reports order for this contract. */
+order?: number;
 }
 /** Documents the upsert status def result payload exchanged by command, SDK, and package integrations. */
 export interface UpsertStatusDefResult {
-    /** Value that configures or reports file for this contract. */
-    file: StatusDefsFile;
-    /** The definition as stored after the upsert (existing fields preserved). */
-    definition: RuntimeStatusDefinition;
-    /** True when an existing definition with the same (normalized) id was replaced. */
-    replaced: boolean;
+/** Value that configures or reports file for this contract. */
+file: StatusDefsFile;
+/** The definition as stored after the upsert (existing fields preserved). */
+definition: RuntimeStatusDefinition;
+/** True when an existing definition with the same (normalized) id was replaced. */
+replaced: boolean;
 }
 /** Documents the remove status def result payload exchanged by command, SDK, and package integrations. */
 export interface RemoveStatusDefResult {
-    /** Value that configures or reports file for this contract. */
-    file: StatusDefsFile;
-    /** True when a matching definition existed and was dropped from the file. */
-    removed: boolean;
-    /** The removed definition, when one matched the requested id. */
-    definition?: RuntimeStatusDefinition;
+/** Value that configures or reports file for this contract. */
+file: StatusDefsFile;
+/** True when a matching definition existed and was dropped from the file. */
+removed: boolean;
+/** The removed definition, when one matched the requested id. */
+definition?: RuntimeStatusDefinition;
 }
 /**
  * Validates and normalizes raw add-status CLI input. Throws a plain Error with a
@@ -73,6 +73,6 @@ export declare function upsertStatusDef(file: StatusDefsFile, input: NormalizedA
 export declare function removeStatusDef(file: StatusDefsFile, id: string | undefined): RemoveStatusDefResult;
 /** Throws when the new status id or any explicitly-supplied alias collides with a DIFFERENT existing status's id/alias. `resolvedAliasToId` maps a normalized token to its owning status id (the runtime status registry's alias_to_id map, which stores ids and aliases in one namespace). Re-adding the same status (matching id) is allowed — only cross-status collisions throw. This prevents a custom status from shadowing a built-in lifecycle token (for example `add-status review --alias open`, or a custom id `cancelled` that aliases the built-in `canceled`), which would make `pm update --status open` resolve to the wrong status. The CLI layer maps the thrown Error to a USAGE exit code. */
 export declare function assertStatusTokensAvailable(input: {
-    id: string;
-    aliases?: string[];
+id: string;
+aliases?: string[];
 }, resolvedAliasToId: ReadonlyMap<string, string>): void;

package/dist/core/schema/type-inference.d.ts

@@ -1,22 +1,22 @@
 /** Documents the inferred type candidate payload exchanged by command, SDK, and package integrations. */
 export interface InferredTypeCandidate {
-    /** Suggested PascalCase type name derived from the prefix. */
-    name: string;
-    /** The normalized prefix token (lowercase) the items share. */
-    prefix: string;
-    /** How many scanned titles carry this prefix. */
-    count: number;
-    /** A few example titles (capped) for human/agent review. */
-    examples: string[];
-    /** True when `name` already resolves to a reserved built-in type. */
-    shadows_builtin: boolean;
+/** Suggested PascalCase type name derived from the prefix. */
+name: string;
+/** The normalized prefix token (lowercase) the items share. */
+prefix: string;
+/** How many scanned titles carry this prefix. */
+count: number;
+/** A few example titles (capped) for human/agent review. */
+examples: string[];
+/** True when `name` already resolves to a reserved built-in type. */
+shadows_builtin: boolean;
 }
 /** Documents the infer types options payload exchanged by command, SDK, and package integrations. */
 export interface InferTypesOptions {
-    /** Minimum number of titles that must share a prefix to surface it (default 10). */
-    minCount?: number;
-    /** Maximum example titles retained per candidate (default 3). */
-    maxExamples?: number;
+/** Minimum number of titles that must share a prefix to surface it (default 10). */
+minCount?: number;
+/** Maximum example titles retained per candidate (default 3). */
+maxExamples?: number;
 }
 /** Extracts the leading prefix token from a title, or undefined when the title has no stable letter-led `PREFIX-`/`PREFIX:` convention. */
 export declare function extractTitlePrefix(title: string): string | undefined;

package/dist/core/schema/type-workflows.d.ts

@@ -20,37 +20,37 @@ export { normalizeStatusToken } from "./status-token.js";
  * CLI enforcement point (src/cli/commands/lifecycle/update.ts) is the only consumer.
  */
 export interface NormalizedTypeWorkflow {
-    /** Lower-cased type name used for case-insensitive matching. */
-    type: string;
-    /** Allowed [from, to] pairs as normalized status ids. */
-    allowed_transitions: [string, string][];
+/** Lower-cased type name used for case-insensitive matching. */
+type: string;
+/** Allowed [from, to] pairs as normalized status ids. */
+allowed_transitions: [string, string][];
 }
 /** Minimal status-registry surface needed to resolve a status token to its id. */
 export interface StatusTokenResolver {
-    /** Value that configures or reports alias to id for this contract. */
-    alias_to_id: Map<string, string>;
+/** Value that configures or reports alias to id for this contract. */
+alias_to_id: Map<string, string>;
 }
 /** Documents the evaluate transition input payload exchanged by command, SDK, and package integrations. */
 export interface EvaluateTransitionInput {
-    /** Value that configures or reports type name for this contract. */
-    typeName: string;
-    /** Status id the workflow transition starts from. */
-    fromStatus: string;
-    /** Status id the workflow transition moves to. */
-    toStatus: string;
-    /** Value that configures or reports type workflows for this contract. */
-    typeWorkflows: NormalizedTypeWorkflow[];
-    /** Value that configures or reports status registry for this contract. */
-    statusRegistry?: StatusTokenResolver;
+/** Value that configures or reports type name for this contract. */
+typeName: string;
+/** Status id the workflow transition starts from. */
+fromStatus: string;
+/** Status id the workflow transition moves to. */
+toStatus: string;
+/** Value that configures or reports type workflows for this contract. */
+typeWorkflows: NormalizedTypeWorkflow[];
+/** Value that configures or reports status registry for this contract. */
+statusRegistry?: StatusTokenResolver;
 }
 /** Documents the evaluate transition result payload exchanged by command, SDK, and package integrations. */
 export interface EvaluateTransitionResult {
-    /** Whether the transition is permitted. */
-    allowed: boolean;
-    /** Whether a matching per-type rule constrained the transition. */
-    hasRule: boolean;
-    /** Allowed [from, to] pairs for the matched type (normalized ids). Empty when the type is unrestricted. */
-    allowedTransitions: [string, string][];
+/** Whether the transition is permitted. */
+allowed: boolean;
+/** Whether a matching per-type rule constrained the transition. */
+hasRule: boolean;
+/** Allowed [from, to] pairs for the matched type (normalized ids). Empty when the type is unrestricted. */
+allowedTransitions: [string, string][];
 }
 /**
  * Normalize the raw type_workflows from a runtime schema into a deduped,

package/dist/core/search/background-refresh.d.ts

@@ -12,17 +12,17 @@ export declare function drainPendingRefreshIds(pmRoot: string): Promise<string[]
 export declare function scheduleBackgroundSemanticRefresh(pmRoot: string, itemIds: string[]): Promise<void>;
 /** Documents the semantic refresh worker result payload exchanged by command, SDK, and package integrations. */
 export interface SemanticRefreshWorkerResult {
-    /** Value that configures or reports processed for this contract. */
-    processed: string[];
-    /** Value that configures or reports rounds for this contract. */
-    rounds: number;
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
+/** Value that configures or reports processed for this contract. */
+processed: string[];
+/** Value that configures or reports rounds for this contract. */
+rounds: number;
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
 }
 type SemanticRefreshFn = (pmRoot: string, itemIds: string[]) => Promise<{
-    refreshed: string[];
-    skipped: string[];
-    warnings: string[];
+refreshed: string[];
+skipped: string[];
+warnings: string[];
 }>;
 /** Drain the pending queue and refresh semantic vectors under the reindex lock so the local vector store is never rewritten concurrently. If the lock is held by another worker we exit immediately — that holder drains our enqueued ids. After releasing we re-check the queue once and re-dispatch if a sibling enqueued ids during our final window, guaranteeing eventual processing. */
 export declare function runSemanticRefreshWorker(pmRoot: string, refresh: SemanticRefreshFn, scheduleRetry?: (root: string) => void): Promise<SemanticRefreshWorkerResult>;

package/dist/core/search/bm25.d.ts

@@ -23,10 +23,10 @@ export declare const DEFAULT_BM25_B = 0.75;
  * {@link resolveBm25Params} before scoring.
  */
 export interface Bm25Params {
-    /** Term-frequency saturation (`k1`); finite and `>= 0`. */
-    k1: number;
-    /** Length normalization (`b`); finite and within `[0, 1]`. */
-    b: number;
+/** Term-frequency saturation (`k1`); finite and `>= 0`. */
+k1: number;
+/** Length normalization (`b`); finite and within `[0, 1]`. */
+b: number;
 }
 /**
  * One corpus document supplied to {@link buildBm25Index}: a stable id and the
@@ -34,10 +34,10 @@ export interface Bm25Params {
  * fields they want indexed (typically the resolved `search.corpus_fields`).
  */
 export interface Bm25Document {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports text for this contract. */
-    text: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports text for this contract. */
+text: string;
 }
 /**
  * Per-document statistics retained in a {@link Bm25Index}: the term-frequency
@@ -45,9 +45,9 @@ export interface Bm25Document {
  * normalization.
  */
 interface Bm25DocumentStats {
-    id: string;
-    termFrequencies: Map<string, number>;
-    length: number;
+id: string;
+termFrequencies: Map<string, number>;
+length: number;
 }
 /**
  * An immutable BM25 index built from a document set. Carries the per-document
@@ -56,14 +56,14 @@ interface Bm25DocumentStats {
  * {@link buildBm25Index}, then score with {@link scoreBm25Query}.
  */
 export interface Bm25Index {
-    /** Value that configures or reports documents for this contract. */
-    documents: Bm25DocumentStats[];
-    /** Value that configures or reports document frequency for this contract. */
-    documentFrequency: Map<string, number>;
-    /** Number of document entries represented by this result. */
-    documentCount: number;
-    /** Value that configures or reports average document length for this contract. */
-    averageDocumentLength: number;
+/** Value that configures or reports documents for this contract. */
+documents: Bm25DocumentStats[];
+/** Value that configures or reports document frequency for this contract. */
+documentFrequency: Map<string, number>;
+/** Number of document entries represented by this result. */
+documentCount: number;
+/** Value that configures or reports average document length for this contract. */
+averageDocumentLength: number;
 }
 /**
  * Tokenize a document/query string into BM25 terms. Shares

package/dist/core/search/cache.d.ts

@@ -8,49 +8,49 @@ export declare const SEARCH_CACHE_ARTIFACT_PATHS: readonly ["index/manifest.json
 export declare const VECTORIZATION_STATUS_LEDGER_PATH = "search/vectorization-status.json";
 /** Documents the search cache invalidation result payload exchanged by command, SDK, and package integrations. */
 export interface SearchCacheInvalidationResult {
-    /** Value that configures or reports invalidated for this contract. */
-    invalidated: string[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
+/** Value that configures or reports invalidated for this contract. */
+invalidated: string[];
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
 }
 /** Documents the semantic mutation refresh result payload exchanged by command, SDK, and package integrations. */
 export interface SemanticMutationRefreshResult {
-    /** Value that configures or reports refreshed for this contract. */
-    refreshed: string[];
-    /** Value that configures or reports skipped for this contract. */
-    skipped: string[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
+/** Value that configures or reports refreshed for this contract. */
+refreshed: string[];
+/** Value that configures or reports skipped for this contract. */
+skipped: string[];
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
 }
 /** Documents the search mutation artifact refresh result payload exchanged by command, SDK, and package integrations. */
 export interface SearchMutationArtifactRefreshResult extends SearchCacheInvalidationResult {
-    /** Value that configures or reports refreshed for this contract. */
-    refreshed: string[];
-    /** Value that configures or reports skipped for this contract. */
-    skipped: string[];
-    /** True when the semantic refresh was dispatched to a detached background worker. */
-    scheduled?: boolean;
+/** Value that configures or reports refreshed for this contract. */
+refreshed: string[];
+/** Value that configures or reports skipped for this contract. */
+skipped: string[];
+/** True when the semantic refresh was dispatched to a detached background worker. */
+scheduled?: boolean;
 }
 /** Documents the refresh search artifacts for mutation options payload exchanged by command, SDK, and package integrations. */
 export interface RefreshSearchArtifactsForMutationOptions {
-    /** When true and semantic search is active, the (slow) embedding refresh is dispatched to a detached background worker instead of awaited inline so the mutation returns immediately. The synchronous keyword-cache invalidation still runs first. Callers pass this only outside test runners. */
-    background?: boolean;
+/** When true and semantic search is active, the (slow) embedding refresh is dispatched to a detached background worker instead of awaited inline so the mutation returns immediately. The synchronous keyword-cache invalidation still runs first. Callers pass this only outside test runners. */
+background?: boolean;
 }
 /** Documents the semantic refresh options payload exchanged by command, SDK, and package integrations. */
 export interface SemanticRefreshOptions {
-    /** Value that configures or reports settings for this contract. */
-    settings?: Awaited<ReturnType<typeof readSettings>>;
-    /** Value that configures or reports apply runtime defaults for this contract. */
-    apply_runtime_defaults?: boolean;
+/** Value that configures or reports settings for this contract. */
+settings?: Awaited<ReturnType<typeof readSettings>>;
+/** Value that configures or reports apply runtime defaults for this contract. */
+apply_runtime_defaults?: boolean;
 }
 /** Documents the vectorization status ledger read result payload exchanged by command, SDK, and package integrations. */
 export interface VectorizationStatusLedgerReadResult {
-    /** Value that configures or reports entries for this contract. */
-    entries: Record<string, string>;
-    /** Value that configures or reports embedding for this contract. */
-    embedding: VectorizationEmbeddingMetadata | null;
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
+/** Value that configures or reports entries for this contract. */
+entries: Record<string, string>;
+/** Value that configures or reports embedding for this contract. */
+embedding: VectorizationEmbeddingMetadata | null;
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
 }
 declare function normalizeVectorizationLedgerEntries(entries: Record<string, string>): Record<string, string>;
 /** Implements read vectorization status ledger for the public runtime surface of this module. */
@@ -58,9 +58,9 @@ export declare function readVectorizationStatusLedger(pmRoot: string): Promise<V
 /** Implements write vectorization status ledger for the public runtime surface of this module. */
 export declare function writeVectorizationStatusLedger(pmRoot: string, entries: Record<string, string>, embedding?: VectorizationEmbeddingMetadata | null): Promise<void>;
 interface SemanticRefreshOperationResult {
-    refreshed: string[];
-    skipped: string[];
-    warnings: string[];
+refreshed: string[];
+skipped: string[];
+warnings: string[];
 }
 declare function buildVectorizationIdentityForProvider(provider: EmbeddingProviderConfig): VectorizationEmbeddingIdentity;
 declare function buildSkippedSemanticRefreshResult(itemIds: string[], warning: string): SemanticMutationRefreshResult;
@@ -75,9 +75,9 @@ export declare function isSemanticRefreshActive(settings: Awaited<ReturnType<typ
 export declare function refreshSearchArtifactsForMutation(pmRoot: string, itemIds: string[], options?: RefreshSearchArtifactsForMutationOptions): Promise<SearchMutationArtifactRefreshResult>;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    buildSkippedSemanticRefreshResult: typeof buildSkippedSemanticRefreshResult;
-    buildVectorizationIdentityForProvider: typeof buildVectorizationIdentityForProvider;
-    normalizeVectorizationLedgerEntries: typeof normalizeVectorizationLedgerEntries;
-    resetSemanticVectorStore: typeof resetSemanticVectorStore;
+buildSkippedSemanticRefreshResult: typeof buildSkippedSemanticRefreshResult;
+buildVectorizationIdentityForProvider: typeof buildVectorizationIdentityForProvider;
+normalizeVectorizationLedgerEntries: typeof normalizeVectorizationLedgerEntries;
+resetSemanticVectorStore: typeof resetSemanticVectorStore;
 };
 export {};

package/dist/core/search/corpus.d.ts

@@ -42,11 +42,11 @@ export declare function buildPlanFlatCorpus(item: ItemMetadata): string;
 export declare function buildPlanCorpus(item: ItemMetadata): Record<string, unknown> | undefined;
 /** Documents the search corpus options payload exchanged by command, SDK, and package integrations. */
 export interface SearchCorpusOptions {
-    /**
+/**
      * Field names to include. When omitted, the full default set is used.
      * See {@link DEFAULT_SEARCH_CORPUS_FIELDS} and {@link resolveSearchCorpusFields}.
      */
-    fields?: string[];
+fields?: string[];
 }
 /** Implements build search corpus for the public runtime surface of this module. */
 export declare function buildSearchCorpus(document: ItemDocument, options?: SearchCorpusOptions): Record<string, unknown>;
@@ -54,26 +54,26 @@ export declare function buildSearchCorpus(document: ItemDocument, options?: Sear
 export declare function resolveSemanticCorpusInputCharacterLimit(providerName: string | undefined): number;
 /** Documents the semantic corpus character limit resolution payload exchanged by command, SDK, and package integrations. */
 export interface SemanticCorpusCharacterLimitResolution {
-    /** Value that configures or reports max characters for this contract. */
-    maxCharacters: number;
-    /** Value that configures or reports warning for this contract. */
-    warning: string | null;
+/** Value that configures or reports max characters for this contract. */
+maxCharacters: number;
+/** Value that configures or reports warning for this contract. */
+warning: string | null;
 }
 /** Implements resolve semantic corpus character limit for the public runtime surface of this module. */
 export declare function resolveSemanticCorpusCharacterLimit(providerName: string | undefined, configuredMaxCharacters: unknown): SemanticCorpusCharacterLimitResolution;
 /** Documents the semantic corpus input options payload exchanged by command, SDK, and package integrations. */
 export interface SemanticCorpusInputOptions {
-    /** Value that configures or reports provider name for this contract. */
-    providerName?: string;
-    /** Value that configures or reports max characters for this contract. */
-    maxCharacters?: number;
-    /**
+/** Value that configures or reports provider name for this contract. */
+providerName?: string;
+/** Value that configures or reports max characters for this contract. */
+maxCharacters?: number;
+/**
      * Corpus field names to include. When omitted, the full default set is used
      * (see {@link DEFAULT_SEARCH_CORPUS_FIELDS}). Thread the resolved list from
      * {@link resolveSearchCorpusFields} so the embedded input honours
      * `search.corpus_fields`.
      */
-    fields?: string[];
+fields?: string[];
 }
 /** Implements build semantic corpus input for the public runtime surface of this module. */
 export declare function buildSemanticCorpusInput(document: ItemDocument, options?: SemanticCorpusInputOptions): string;

package/dist/core/search/embedding-batches.d.ts

@@ -8,63 +8,63 @@ import type { PmSettings } from "../../types/index.js";
 import type { EmbeddingProviderConfig } from "./providers.js";
 /** Completed vectors and execution evidence returned only after every input succeeds. */
 export interface EmbeddingBatchExecutionResult {
-    /** One vector for each input position, including repeated input text. */
-    vectors: number[][];
-    /** Truncation, retry, and split diagnostics; never contains source input text. */
-    warnings: string[];
-    /** Actual provider work, including retries and adaptive splits. */
-    receipt?: EmbeddingBatchReceipt;
+/** One vector for each input position, including repeated input text. */
+vectors: number[][];
+/** Truncation, retry, and split diagnostics; never contains source input text. */
+warnings: string[];
+/** Actual provider work, including retries and adaptive splits. */
+receipt?: EmbeddingBatchReceipt;
 }
 /** Bounded summary of actual provider work; histogram keys are successful request sizes. */
 export interface EmbeddingBatchReceipt {
-    /** Provider and model used for this execution, without endpoint or credentials. */
-    provider: string;
-    /** Model requested from the provider. */
-    model: string;
-    /** Maximum encoded JSON request size, including model and escaping. */
-    max_request_bytes: number;
-    /** Whether the request ceiling was supplied by the caller or the runtime. */
-    limit_source: "caller" | "default";
-    /** Number of requests planned before adaptive splitting. */
-    planned_batches: number;
-    /** Total HTTP attempts, including unsuccessful requests. */
-    requests: number;
-    /** Requests that returned validated vectors. */
-    successful_batches: number;
-    /** Failed requests subdivided into smaller requests. */
-    split_batches: number;
-    /** Additional attempts of the same batch after a transient failure. */
-    retries: number;
-    /** Successful request count by number of input positions. */
-    batch_size_histogram: Record<string, number>;
-    /** Wall-clock duration including provider time and retry backoff. */
-    elapsed_ms: number;
-    /** Completed input positions divided by elapsed seconds. */
-    inputs_per_second: number;
+/** Provider and model used for this execution, without endpoint or credentials. */
+provider: string;
+/** Model requested from the provider. */
+model: string;
+/** Maximum encoded JSON request size, including model and escaping. */
+max_request_bytes: number;
+/** Whether the request ceiling was supplied by the caller or the runtime. */
+limit_source: "caller" | "default";
+/** Number of requests planned before adaptive splitting. */
+planned_batches: number;
+/** Total HTTP attempts, including unsuccessful requests. */
+requests: number;
+/** Requests that returned validated vectors. */
+successful_batches: number;
+/** Failed requests subdivided into smaller requests. */
+split_batches: number;
+/** Additional attempts of the same batch after a transient failure. */
+retries: number;
+/** Successful request count by number of input positions. */
+batch_size_histogram: Record<string, number>;
+/** Wall-clock duration including provider time and retry backoff. */
+elapsed_ms: number;
+/** Completed input positions divided by elapsed seconds. */
+inputs_per_second: number;
 }
 /** Progress across planned batches; actual HTTP work is reported separately in the receipt. */
 export interface EmbeddingBatchProgressEvent {
-    /** One-based index of the current planned batch. */
-    batch_index: number;
-    /** Number of planned batches before adaptive splitting. */
-    batch_total: number;
-    /** Number of input positions in the current planned batch. */
-    batch_size: number;
-    /** Input positions successfully embedded before or after this event. */
-    completed_inputs: number;
-    /** Total input positions in this execution. */
-    total_inputs: number;
-    /** Optional attempt counter for callers extending progress reporting. */
-    attempt?: number;
-    /** Whether dispatch is starting or the complete planned batch has succeeded. */
-    phase: "start" | "complete";
+/** One-based index of the current planned batch. */
+batch_index: number;
+/** Number of planned batches before adaptive splitting. */
+batch_total: number;
+/** Number of input positions in the current planned batch. */
+batch_size: number;
+/** Input positions successfully embedded before or after this event. */
+completed_inputs: number;
+/** Total input positions in this execution. */
+total_inputs: number;
+/** Optional attempt counter for callers extending progress reporting. */
+attempt?: number;
+/** Whether dispatch is starting or the complete planned batch has succeeded. */
+phase: "start" | "complete";
 }
 /** Host controls for progress reporting and transport payload bounds. */
 export interface EmbeddingBatchExecutionOptions {
-    /** Observe planned-batch boundaries without receiving input text. */
-    onProgress?: (event: EmbeddingBatchProgressEvent) => void;
-    /** Positive JSON payload byte ceiling, independent of per-input corpus truncation; defaults to 256 KiB. */
-    maxRequestBytes?: number;
+/** Observe planned-batch boundaries without receiving input text. */
+onProgress?: (event: EmbeddingBatchProgressEvent) => void;
+/** Positive JSON payload byte ceiling, independent of per-input corpus truncation; defaults to 256 KiB. */
+maxRequestBytes?: number;
 }
 /** Execute count- and byte-bounded batches in order. Reject impossible inputs before dispatch, retry transient failures, and subdivide size or timeout failures without returning partial vectors. */
 export declare function executeEmbeddingBatchesWithRetry(provider: EmbeddingProviderConfig, settings: PmSettings, inputs: string[], options?: EmbeddingBatchExecutionOptions): Promise<EmbeddingBatchExecutionResult>;