/** Git + build metadata captured when `@ory/argus` was built. */ export interface BuildInfo { /** Full 40-char commit SHA, or `null` when git was unavailable at build. */ commit: string | null; /** Abbreviated commit SHA. */ commitShort: string | null; /** Branch the build was cut from. */ branch: string | null; /** ISO-8601 commit date. */ commitDate: string | null; /** Whether the working tree had uncommitted changes at build time. */ dirty: boolean | null; /** ISO-8601 timestamp of when the build ran. */ builtAt: string | null; /** * Where the info came from: `embedded` (build-time file, authoritative * for a release), `git` (live probe of a confirmed ory-agent-plugins * checkout — dev/local), or `unknown` (neither available). */ source: "embedded" | "git" | "unknown"; } /** * Resolve the ory-agent-plugins build/commit metadata: prefer the * build-time embedded file (authoritative for published packages), fall * back to a live git probe of a confirmed monorepo checkout, else report * `unknown`. */ export declare function resolveBuildInfo(): BuildInfo; /** * Resolve the `@ory/argus` core version from this module's own package.json. * Exported so the install flow can surface the running CLI version — every * `@ory/*` package releases in lockstep, so the core version is the release * version of whatever plugin CLI is executing. */ export declare function resolveCoreVersion(): string; export interface VersionInfo { plugin: { name: string; version: string; }; core: { name: string; version: string; }; node: string; build: BuildInfo; } /** Assemble the full version report as structured data. */ export declare function collectVersionInfo(packageRoot: string): VersionInfo; export interface VersionCommandOptions { /** The plugin package root — `path.resolve(__dirname, "..", "..")` from `dist/cli/main.js`. */ packageRoot: string; } /** * Render the `version` output. Supports `--json` for machine-readable * output. Returns a numeric exit code (always 0 today) to match the shape * of the other async CLI helpers. */ export declare function runVersionCommand(binName: string, args: string[], options: VersionCommandOptions): number;