@unbrained/pm-cli 2026.7.7 → 2026.7.8

package/dist/sdk/runtime.d.ts

@@ -2,7 +2,7 @@ import { type ExtensionRegistrationRegistry } from "../core/extensions/index.js"
 import type { GlobalOptions } from "../core/shared/command-types.js";
 import type { PmToolAction } from "./cli-contracts/enum-contracts.js";
 export { clearWorkspaceContractsCache } from "./workspace-contracts-cache.js";
-import { type AggregateOptions, type AggregateResult } from "../cli/commands/index.js";
+import { type AggregateOptions, type AggregateResult, type ExtensionCommandOptions, type ExtensionCommandResult, type UpgradeCommandOptions, type UpgradeResult } from "../cli/commands/index.js";
 import type { ContextOptions, ContextResult } from "../cli/commands/context.js";
 import type { GetOptions, GetResult } from "../cli/commands/get.js";
 import type { CloseManyCommandOptions } from "../cli/commands/close-many.js";
@@ -51,6 +51,8 @@ export { loadCreateTemplateOptions, runTemplatesList, runTemplatesSave, runTempl
 export { runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, type TestRunsListCommandOptions, type TestRunsLogsCommandOptions, type TestRunsResumeCommandOptions, type TestRunsStopCommandOptions, } from "../cli/commands/test-runs.js";
 export { CONFIDENCE_TEXT_VALUES, DEPENDENCY_KIND_VALUES, BUILTIN_ITEM_TYPE_VALUES, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, RISK_VALUES, STATUS_VALUES, } from "../types/index.js";
 export type { GlobalOptions } from "../core/shared/command-types.js";
+export type PackageCommandOptions = ExtensionCommandOptions;
+export type PackageCommandResult = ExtensionCommandResult;
 export type { Dependency, ItemDocument, ItemMetadata, ItemStatus, ItemType, LinkedDoc, LinkedFile, LinkedTest, LogNote, PmSettings, } from "../types/index.js";
 /**
  * Documents the get contracts options payload exchanged by command, SDK, and package integrations.
@@ -235,6 +237,70 @@ export declare class PmClient {
      * Close an item and release its active assignment.
      */
     closeTask(id: string, reason: string, options?: PmClientMutationOptions): Promise<unknown>;
+    /**
+     * Run the extension lifecycle surface with the same result shape as `pm extension`.
+     */
+    extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
+    /**
+     * List project or global extensions without constructing command-line argv.
+     */
+    extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
+    /**
+     * Enable an installed extension using the same action as `pm extension activate`.
+     */
+    extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
+    /**
+     * Disable an installed extension using the same action as `pm extension deactivate`.
+     */
+    extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
+    /**
+     * Run the package lifecycle surface with package vocabulary preserved.
+     */
+    package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * List project or global packages through the package lifecycle primitive.
+     */
+    packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Install a package or extension source using the same action as `pm package install`.
+     */
+    packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Uninstall a package or extension using the same action as `pm package uninstall`.
+     */
+    packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Read package lifecycle diagnostics using the same action as `pm package doctor`.
+     */
+    packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Inspect managed package state using the same action as `pm package manage`.
+     */
+    packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Describe installed package surfaces using the same action as `pm package describe`.
+     */
+    packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Reload installed package extensions using the same action as `pm package reload`.
+     */
+    packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Read bundled package catalog metadata using the same action as `pm package catalog`.
+     */
+    packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Enable an installed package using the same action as `pm package activate`.
+     */
+    packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Disable an installed package using the same action as `pm package deactivate`.
+     */
+    packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
+    /**
+     * Upgrade the pm CLI and/or managed packages through the public SDK dispatcher.
+     */
+    upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>;
 }
 /**
  * Return the same context snapshot produced by `pm context` without constructing
@@ -318,6 +384,70 @@ export declare function pauseTask(id: string, options?: PmClientMutationOptions,
  * Close an item and release its active assignment without constructing a client.
  */
 export declare function closeTask(id: string, reason: string, options?: PmClientMutationOptions, clientOptions?: PmClientOptions): Promise<unknown>;
+/**
+ * Run the extension lifecycle surface without constructing a reusable client.
+ */
+export declare function extension(target?: string, options?: ExtensionCommandOptions, clientOptions?: PmClientOptions): Promise<ExtensionCommandResult>;
+/**
+ * List extensions without constructing a reusable client.
+ */
+export declare function extensionList(options?: ExtensionCommandOptions, clientOptions?: PmClientOptions): Promise<ExtensionCommandResult>;
+/**
+ * Enable an extension without constructing a reusable client.
+ */
+export declare function extensionActivate(target: string, options?: ExtensionCommandOptions, clientOptions?: PmClientOptions): Promise<ExtensionCommandResult>;
+/**
+ * Disable an extension without constructing a reusable client.
+ */
+export declare function extensionDeactivate(target: string, options?: ExtensionCommandOptions, clientOptions?: PmClientOptions): Promise<ExtensionCommandResult>;
+/**
+ * Run the package lifecycle surface without constructing a reusable client.
+ */
+export declare function packageLifecycle(target?: string, options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * List packages without constructing a reusable client.
+ */
+export declare function packageList(options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Install a package or extension source without constructing a reusable client.
+ */
+export declare function packageInstall(target: string, options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Uninstall a package or extension without constructing a reusable client.
+ */
+export declare function packageUninstall(target: string, options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Read package lifecycle diagnostics without constructing a reusable client.
+ */
+export declare function packageDoctor(options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Inspect managed package state without constructing a reusable client.
+ */
+export declare function packageManage(target?: string, options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Describe package surfaces without constructing a reusable client.
+ */
+export declare function packageDescribe(target?: string, options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Reload package extensions without constructing a reusable client.
+ */
+export declare function packageReload(options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Read bundled package catalog metadata without constructing a reusable client.
+ */
+export declare function packageCatalog(options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Enable a package without constructing a reusable client.
+ */
+export declare function packageActivate(target: string, options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Disable a package without constructing a reusable client.
+ */
+export declare function packageDeactivate(target: string, options?: PackageCommandOptions, clientOptions?: PmClientOptions): Promise<PackageCommandResult>;
+/**
+ * Upgrade the pm CLI and/or managed packages without constructing a reusable client.
+ */
+export declare function upgrade(target?: string, options?: UpgradeCommandOptions, clientOptions?: PmClientOptions): Promise<UpgradeResult>;
 /**
  * Implements get workspace contracts for the public runtime surface of this module.
  */
@@ -384,3 +514,4 @@ declare global {
     var __pmCliActionRunnerTestHooks: typeof actionRunnerTestHooks | undefined;
 }
 export type { ContractsCommandOptions, ContractsResult };
+export type { ExtensionCommandOptions, ExtensionCommandResult, UpgradeCommandOptions, UpgradeResult };

package/dist/sdk/runtime.js

@@ -4,7 +4,7 @@
  * Defines public SDK APIs and package-author helpers for Runtime.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="89db1e15-b152-57e2-910d-64ed77eb540b")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6781d5a3-3e21-5198-a534-fb2be114b6e1")}catch(e){}}();
 import path from "node:path";
 import { createEmptyExtensionCommandRegistry, createEmptyExtensionHookRegistry, createEmptyExtensionParserRegistry, createEmptyExtensionPreflightRegistry, createEmptyExtensionRegistrationRegistry, createEmptyExtensionRendererRegistry, createEmptyExtensionServiceRegistry, } from "../core/extensions/extension-registries.js";
 import { activateExtensions, deactivateExtensions, loadExtensions, runActiveCommandHandler, setActiveExtensionCommands, setActiveExtensionHooks, setActiveExtensionParsers, setActiveExtensionPreflight, setActiveExtensionRegistrations, setActiveExtensionRenderers, setActiveExtensionServices, } from "../core/extensions/index.js";
@@ -224,6 +224,105 @@ export class PmClient {
     closeTask(id, reason, options = {}) {
         return this.run("close-task", { id, reason, ...splitClientMutationOptions(options) });
     }
+    /**
+     * Run the extension lifecycle surface with the same result shape as `pm extension`.
+     */
+    extension(target, options = {}) {
+        return this.runTyped("extension", { ...(target === undefined ? {} : { target }), options });
+    }
+    /**
+     * List project or global extensions without constructing command-line argv.
+     */
+    extensionList(options = {}) {
+        return this.extension("list", options);
+    }
+    /**
+     * Enable an installed extension using the same action as `pm extension activate`.
+     */
+    extensionActivate(target, options = {}) {
+        return this.runTyped("extension-activate", { target, options });
+    }
+    /**
+     * Disable an installed extension using the same action as `pm extension deactivate`.
+     */
+    extensionDeactivate(target, options = {}) {
+        return this.runTyped("extension-deactivate", { target, options });
+    }
+    /**
+     * Run the package lifecycle surface with package vocabulary preserved.
+     */
+    package(target, options = {}) {
+        return this.runTyped("package", {
+            ...(target === undefined ? {} : { target }),
+            options: { ...options, vocabulary: "package" },
+        });
+    }
+    /**
+     * List project or global packages through the package lifecycle primitive.
+     */
+    packageList(options = {}) {
+        return this.package("list", options);
+    }
+    /**
+     * Install a package or extension source using the same action as `pm package install`.
+     */
+    packageInstall(target, options = {}) {
+        return this.runTyped("package-install", { target, options });
+    }
+    /**
+     * Uninstall a package or extension using the same action as `pm package uninstall`.
+     */
+    packageUninstall(target, options = {}) {
+        return this.runTyped("package-uninstall", { target, options });
+    }
+    /**
+     * Read package lifecycle diagnostics using the same action as `pm package doctor`.
+     */
+    packageDoctor(options = {}) {
+        return this.runTyped("package-doctor", { options });
+    }
+    /**
+     * Inspect managed package state using the same action as `pm package manage`.
+     */
+    packageManage(target, options = {}) {
+        return this.runTyped("package-manage", { ...(target === undefined ? {} : { target }), options });
+    }
+    /**
+     * Describe installed package surfaces using the same action as `pm package describe`.
+     */
+    packageDescribe(target, options = {}) {
+        return this.runTyped("package-describe", { ...(target === undefined ? {} : { target }), options });
+    }
+    /**
+     * Reload installed package extensions using the same action as `pm package reload`.
+     */
+    packageReload(options = {}) {
+        return this.runTyped("package-reload", { options });
+    }
+    /**
+     * Read bundled package catalog metadata using the same action as `pm package catalog`.
+     */
+    packageCatalog(options = {}) {
+        return this.runTyped("package-catalog", { options });
+    }
+    /**
+     * Enable an installed package using the same action as `pm package activate`.
+     */
+    packageActivate(target, options = {}) {
+        return this.runTyped("package-activate", { target, options });
+    }
+    /**
+     * Disable an installed package using the same action as `pm package deactivate`.
+     */
+    packageDeactivate(target, options = {}) {
+        return this.runTyped("package-deactivate", { target, options });
+    }
+    /**
+     * Upgrade the pm CLI and/or managed packages through the public SDK dispatcher.
+     */
+    upgrade(target, options = {}) {
+        return this.runTyped("upgrade", { ...(target === undefined ? {} : { target }), options });
+    }
 }
 /**
  * Return the same context snapshot produced by `pm context` without constructing
@@ -345,6 +444,102 @@ export function pauseTask(id, options = {}, clientOptions = {}) {
 export function closeTask(id, reason, options = {}, clientOptions = {}) {
     return new PmClient(clientOptions).closeTask(id, reason, options);
 }
+/**
+ * Run the extension lifecycle surface without constructing a reusable client.
+ */
+export function extension(target, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).extension(target, options);
+}
+/**
+ * List extensions without constructing a reusable client.
+ */
+export function extensionList(options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).extensionList(options);
+}
+/**
+ * Enable an extension without constructing a reusable client.
+ */
+export function extensionActivate(target, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).extensionActivate(target, options);
+}
+/**
+ * Disable an extension without constructing a reusable client.
+ */
+export function extensionDeactivate(target, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).extensionDeactivate(target, options);
+}
+/**
+ * Run the package lifecycle surface without constructing a reusable client.
+ */
+export function packageLifecycle(target, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).package(target, options);
+}
+/**
+ * List packages without constructing a reusable client.
+ */
+export function packageList(options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).packageList(options);
+}
+/**
+ * Install a package or extension source without constructing a reusable client.
+ */
+export function packageInstall(target, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).packageInstall(target, options);
+}
+/**
+ * Uninstall a package or extension without constructing a reusable client.
+ */
+export function packageUninstall(target, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).packageUninstall(target, options);
+}
+/**
+ * Read package lifecycle diagnostics without constructing a reusable client.
+ */
+export function packageDoctor(options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).packageDoctor(options);
+}
+/**
+ * Inspect managed package state without constructing a reusable client.
+ */
+export function packageManage(target, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).packageManage(target, options);
+}
+/**
+ * Describe package surfaces without constructing a reusable client.
+ */
+export function packageDescribe(target, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).packageDescribe(target, options);
+}
+/**
+ * Reload package extensions without constructing a reusable client.
+ */
+export function packageReload(options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).packageReload(options);
+}
+/**
+ * Read bundled package catalog metadata without constructing a reusable client.
+ */
+export function packageCatalog(options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).packageCatalog(options);
+}
+/**
+ * Enable a package without constructing a reusable client.
+ */
+export function packageActivate(target, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).packageActivate(target, options);
+}
+/**
+ * Disable a package without constructing a reusable client.
+ */
+export function packageDeactivate(target, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).packageDeactivate(target, options);
+}
+/**
+ * Upgrade the pm CLI and/or managed packages without constructing a reusable client.
+ */
+export function upgrade(target, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).upgrade(target, options);
+}
 /**
  * Process-lifetime memo of activated extension registrations, keyed by resolved
  * pm root + cwd + extension settings. `getWorkspaceContracts` is frequently
@@ -993,6 +1188,9 @@ function resolveSdkActionInput(args) {
     if (alias?.options !== undefined) {
         resolvedArgs.options = { ...alias.options, ...asRecordClone(args.options) };
     }
+    if (action === "package") {
+        resolvedArgs.options = { ...asRecordClone(resolvedArgs.options), vocabulary: "package" };
+    }
     return { action, args: resolvedArgs };
 }
 function shouldInvalidateWorkspaceContractsCacheAfterAction(action) {
@@ -1500,4 +1698,4 @@ async function loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
     }
 }
 //# sourceMappingURL=runtime.js.map
-//# debugId=89db1e15-b152-57e2-910d-64ed77eb540b
+//# debugId=6781d5a3-3e21-5198-a534-fb2be114b6e1