@openma/common 0.0.0-stage → 0.9.0

package/dist/acp-harnesses/installer.d.ts

@@ -0,0 +1,145 @@
+import type { KnownAgentEntry } from "./known-agents.js";
+import { type CommandInvocation } from "./launcher.js";
+export declare const ACP_NPM_INSTALL_TIMEOUT_MS: number;
+interface AcpRegistryNpxDistribution {
+    package: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+interface AcpRegistryUvxDistribution {
+    package: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+interface AcpRegistryTargetConfig {
+    archive: string;
+    cmd: string;
+    args?: string[];
+    env?: Record<string, string>;
+    sha256?: string;
+}
+export interface AcpRegistryAgent {
+    id: string;
+    name?: string;
+    version?: string;
+    description?: string;
+    website?: string;
+    repository?: string;
+    distribution?: {
+        binary?: Record<string, AcpRegistryTargetConfig>;
+        npx?: AcpRegistryNpxDistribution;
+        uvx?: AcpRegistryUvxDistribution;
+    };
+}
+export interface InstallAcpRegistryAgentOptions {
+    registryId: string;
+    registryAgent?: AcpRegistryAgent;
+    shimName: string;
+    binDir: string;
+    fetchImpl?: typeof fetch;
+    npmCommand?: string;
+    npmCommandArgs?: string[];
+    npmEnv?: NodeJS.ProcessEnv;
+    npmRegistryUrls?: string[];
+    installRoot?: string;
+    shimArgs?: string[];
+    shimEnv?: Record<string, string | undefined>;
+    env?: NodeJS.ProcessEnv;
+    /**
+     * npm installs only: dependency name to exact version. Written as npm
+     * `overrides`, so every copy in the tree is that version, and checked
+     * against what npm installed.
+     */
+    npmOverrides?: Record<string, string>;
+}
+export interface AcpRegistryCatalogAgent {
+    id: string;
+    name: string;
+    version?: string;
+    description?: string;
+    homepage?: string;
+    installable: boolean;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface InstallManagedAdapterOptions {
+    id: string;
+    label: string;
+    command: string;
+    args?: string[];
+    downloadUrl: string;
+    binDir: string;
+    fetchImpl?: typeof fetch;
+}
+export interface InstallResult {
+    commandPath: string;
+    version?: string;
+    /** Installed versions of the dependencies named in `npmOverrides`. */
+    dependencies?: Record<string, string>;
+}
+export interface AcpRegistryInstallMetadata {
+    source: "registry";
+    registryId: string;
+    shimName: string;
+    version?: string;
+    /** Present for an install made with `npmOverrides`. */
+    dependencies?: Record<string, string>;
+    installedAt: string;
+}
+export interface UninstallAcpRegistryAgentOptions {
+    registryId: string;
+    shimName: string;
+    binDir: string;
+    installRoot?: string;
+}
+export interface UninstallManagedAdapterOptions {
+    command: string;
+    binDir: string;
+}
+export declare function listAcpRegistryCatalog(options?: {
+    fetchImpl?: typeof fetch;
+}): Promise<AcpRegistryCatalogAgent[]>;
+export declare function readAcpRegistryInstallMetadata(options: {
+    registryId: string;
+    binDir: string;
+    installRoot?: string;
+}): Promise<AcpRegistryInstallMetadata | null>;
+/**
+ * Rebuild a managed shim whose installed command moved together with the ACP
+ * install root. The command is derived from its registry-relative suffix, so
+ * no previous storage location is read or treated as a fallback.
+ */
+export declare function repairRelocatedAcpRegistryShim(options: {
+    registryId: string;
+    shimName: string;
+    binDir: string;
+    installRoot?: string;
+}): Promise<boolean>;
+/**
+ * How a host starts a launcher this installer wrote. A POSIX launcher starts
+ * directly; a Windows `.cmd` launcher has to go through `cmd.exe`.
+ */
+export declare function acpLauncherInvocation(commandPath: string, args?: readonly string[], options?: {
+    platform?: NodeJS.Platform;
+    comSpec?: string;
+}): CommandInvocation;
+export declare function installAcpRegistryAgent(options: InstallAcpRegistryAgentOptions): Promise<InstallResult>;
+export type InstallPinnedAcpHarnessOptions = Pick<InstallAcpRegistryAgentOptions, "binDir" | "installRoot" | "npmCommand" | "npmCommandArgs" | "npmEnv" | "npmRegistryUrls" | "env" | "fetchImpl"> & {
+    entry: KnownAgentEntry;
+    /** Defaults to the running platform. */
+    platform?: NodeJS.Platform;
+};
+/**
+ * Installs a harness at the exact versions its registry entry pins
+ * (`KnownAgentEntry.pinned`), for hosts that need the same agent on every
+ * machine. The launcher and the install state use the names from
+ * `pinnedAcpHarnessPaths`, never the product install's, so both can live in
+ * one bin directory. On Windows the launcher is a `.cmd` file; start it with
+ * `acpLauncherInvocation`.
+ */
+export declare function installPinnedAcpHarness(options: InstallPinnedAcpHarnessOptions): Promise<InstallResult>;
+export { readAcpHarnessInstallState, readAcpHarnessPinState, pinnedAcpHarnessPaths, acpHarnessPinnedPackages, compareCodePoints, type AcpHarnessInstallState, type AcpHarnessPinState, type ReadAcpHarnessInstallStateOptions, OPENMA_NPM_HARNESS_IDS, usesOpenMaNpmLatestSource, latestNpmPackageVersion, npmPackageNameFromSpec, npmVersionFromSpec, readInstalledNpmPackageVersion, installedNpmPackageVersionFromShim, isStrictlyNewerVersion, } from "./install-state.js";
+export declare function installManagedAdapter(options: InstallManagedAdapterOptions): Promise<InstallResult>;
+export declare function uninstallAcpRegistryAgent(options: UninstallAcpRegistryAgentOptions): Promise<void>;
+export declare function uninstallManagedAdapter(options: UninstallManagedAdapterOptions): Promise<void>;
+//# sourceMappingURL=installer.d.ts.map

package/dist/acp-harnesses/installer.d.ts.map

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