@deepseek-ai/dsh-plugin-manager 0.1.6-alpha.2

package/lib/typert.remote-client.js

@@ -0,0 +1,393 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
+import { z } from 'zod'
+
+let _deepseek_ai_dsh_plugin_manager_pluginManager_cancelInstall_parameter_0$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_cancelInstall_parameter_0$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_cancelInstall_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_plugin_manager_pluginManager_cancelInstall_result$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_cancelInstall_result$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_cancelInstall_result$schema$value ??= z.object({
+  'status': z.union([z.literal("cancelled"), z.literal("not-running"), z.literal("too-late")]).readonly(),
+}))
+let _deepseek_ai_dsh_plugin_manager_pluginManager_inspect_parameter_0$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_inspect_parameter_0$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_inspect_parameter_0$schema$value ??= z.string())
+let _deepseek_ai_dsh_plugin_manager_pluginManager_inspect_result$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_inspect_result$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_inspect_result$schema$value ??= z.union([z.object({
+  'status': z.literal("accepted").readonly(),
+  'kind': z.union([z.literal("registry"), z.literal("path"), z.literal("git"), z.literal("tarball")]).readonly(),
+  'name': z.string().readonly().optional(),
+  'version': z.string().readonly().optional(),
+  'description': z.string().readonly().optional(),
+  'bundle': z.union([z.literal(null), z.literal(false), z.literal(true)]).readonly(),
+}), z.object({
+  'status': z.literal("refused").readonly(),
+  'problem': z.union([z.literal("invalid-spec"), z.literal("already-installed"), z.literal("not-found"), z.literal("not-a-package"), z.literal("not-a-bundle"), z.literal("network"), z.literal("unknown")]).readonly(),
+  'reason': z.string().readonly(),
+})]))
+let _deepseek_ai_dsh_plugin_manager_pluginManager_installBundle_parameter_0$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_installBundle_parameter_0$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_installBundle_parameter_0$schema$value ??= z.string())
+let _deepseek_ai_dsh_plugin_manager_pluginManager_installBundle_parameter_1$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_installBundle_parameter_1$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_installBundle_parameter_1$schema$value ??= z.union([z.undefined(), z.object({
+  'enabled': z.boolean().optional(),
+  'requestId': z.intersection(z.string(), z.unknown()).optional(),
+  'approvedBuilds': z.array(z.string()).optional(),
+})]))
+let _deepseek_ai_dsh_plugin_manager_pluginManager_installBundle_result$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_installBundle_result$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_installBundle_result$schema$value ??= z.object({
+  'changed': z.boolean(),
+  'application': z.union([z.literal("failed"), z.literal("cancelled"), z.literal("applied"), z.literal("restart-required"), z.literal("overridden")]),
+  'stage': z.union([z.literal("remove"), z.literal("install"), z.literal("enable")]),
+  'target': z.string(),
+  'enabled': z.boolean().optional(),
+  'error': z.object({
+  'code': z.union([z.literal("management-required"), z.literal("unaddressable"), z.literal("unknown-plugin"), z.literal("invalid-spec"), z.literal("ambiguous-install"), z.literal("not-bundle"), z.literal("not-removable"), z.literal("stop-profile"), z.literal("bundle-in-use"), z.literal("stale-approval"), z.literal("operation-error")]),
+  'diagnostic': z.string().optional(),
+}).optional(),
+  'warnings': z.array(z.string()).optional(),
+  'packageResult': z.object({
+  'exitCode': z.number(),
+  'output': z.string(),
+  'truncated': z.boolean(),
+  'logPath': z.string(),
+  'kind': z.union([z.literal("not-found"), z.literal("network"), z.literal("unknown"), z.literal("pnpm-missing"), z.literal("timeout"), z.literal("no-matching-version"), z.literal("disk-full"), z.literal("permission"), z.literal("build-blocked"), z.literal("integrity")]).optional(),
+}).optional(),
+  'bundle': z.string().optional(),
+  'pendingBuilds': z.array(z.string()).optional(),
+  'approvedBuilds': z.array(z.string()).optional(),
+}))
+let _deepseek_ai_dsh_plugin_manager_pluginManager_listBundles_result$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_listBundles_result$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_listBundles_result$schema$value ??= z.array(z.object({
+  'name': z.string(),
+  'version': z.string().optional(),
+  'description': z.string().optional(),
+  'enabled': z.boolean(),
+  'installed': z.boolean(),
+  'optional': z.boolean(),
+  'removable': z.boolean(),
+  'readOnlyReason': z.union([z.literal("management-required"), z.literal("unaddressable")]).optional(),
+  'error': z.object({
+  'code': z.union([z.literal("management-required"), z.literal("unaddressable"), z.literal("unknown-plugin"), z.literal("invalid-spec"), z.literal("ambiguous-install"), z.literal("not-bundle"), z.literal("not-removable"), z.literal("stop-profile"), z.literal("bundle-in-use"), z.literal("stale-approval"), z.literal("operation-error")]),
+  'diagnostic': z.string().optional(),
+}).optional(),
+  'rows': z.array(z.object({
+  'rowId': z.string(),
+  'moduleName': z.string(),
+  'entryId': z.intersection(z.string(), z.unknown()).optional(),
+})),
+  'overrides': z.array(z.string()),
+})))
+let _deepseek_ai_dsh_plugin_manager_pluginManager_listPlugins_result$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_listPlugins_result$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_listPlugins_result$schema$value ??= z.array(z.union([z.intersection(z.object({
+  'entryId': z.intersection(z.string(), z.unknown()).readonly(),
+  'moduleName': z.string().readonly(),
+  'enabled': z.boolean().readonly(),
+  'fiberPhase': z.union([z.literal(null), z.literal("pending"), z.literal("active"), z.literal("failed"), z.literal("loading"), z.literal("unloading")]).readonly(),
+}), z.object({
+  'patchId': z.string(),
+  'readOnlyReason': z.never().optional(),
+})), z.intersection(z.object({
+  'entryId': z.intersection(z.string(), z.unknown()).readonly(),
+  'moduleName': z.string().readonly(),
+  'enabled': z.boolean().readonly(),
+  'fiberPhase': z.union([z.literal(null), z.literal("pending"), z.literal("active"), z.literal("failed"), z.literal("loading"), z.literal("unloading")]).readonly(),
+}), z.object({
+  'patchId': z.never().optional(),
+  'readOnlyReason': z.union([z.literal("management-required"), z.literal("unaddressable")]),
+}))])))
+let _deepseek_ai_dsh_plugin_manager_pluginManager_removeBundle_parameter_0$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_removeBundle_parameter_0$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_removeBundle_parameter_0$schema$value ??= z.string())
+let _deepseek_ai_dsh_plugin_manager_pluginManager_removeBundle_result$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_removeBundle_result$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_removeBundle_result$schema$value ??= z.object({
+  'changed': z.boolean(),
+  'application': z.union([z.literal("failed"), z.literal("cancelled"), z.literal("applied"), z.literal("restart-required"), z.literal("overridden")]),
+  'stage': z.union([z.literal("remove"), z.literal("install"), z.literal("enable")]),
+  'target': z.string(),
+  'enabled': z.boolean().optional(),
+  'error': z.object({
+  'code': z.union([z.literal("management-required"), z.literal("unaddressable"), z.literal("unknown-plugin"), z.literal("invalid-spec"), z.literal("ambiguous-install"), z.literal("not-bundle"), z.literal("not-removable"), z.literal("stop-profile"), z.literal("bundle-in-use"), z.literal("stale-approval"), z.literal("operation-error")]),
+  'diagnostic': z.string().optional(),
+}).optional(),
+  'warnings': z.array(z.string()).optional(),
+  'packageResult': z.object({
+  'exitCode': z.number(),
+  'output': z.string(),
+  'truncated': z.boolean(),
+  'logPath': z.string(),
+  'kind': z.union([z.literal("not-found"), z.literal("network"), z.literal("unknown"), z.literal("pnpm-missing"), z.literal("timeout"), z.literal("no-matching-version"), z.literal("disk-full"), z.literal("permission"), z.literal("build-blocked"), z.literal("integrity")]).optional(),
+}).optional(),
+  'bundle': z.string().optional(),
+  'pendingBuilds': z.array(z.string()).optional(),
+  'approvedBuilds': z.array(z.string()).optional(),
+}))
+let _deepseek_ai_dsh_plugin_manager_pluginManager_setBundleEnabled_parameter_0$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_setBundleEnabled_parameter_0$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_setBundleEnabled_parameter_0$schema$value ??= z.string())
+let _deepseek_ai_dsh_plugin_manager_pluginManager_setBundleEnabled_parameter_1$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_setBundleEnabled_parameter_1$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_setBundleEnabled_parameter_1$schema$value ??= z.boolean())
+let _deepseek_ai_dsh_plugin_manager_pluginManager_setBundleEnabled_result$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_setBundleEnabled_result$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_setBundleEnabled_result$schema$value ??= z.object({
+  'changed': z.boolean(),
+  'application': z.union([z.literal("failed"), z.literal("cancelled"), z.literal("applied"), z.literal("restart-required"), z.literal("overridden")]),
+  'stage': z.union([z.literal("remove"), z.literal("install"), z.literal("enable")]),
+  'target': z.string(),
+  'enabled': z.boolean().optional(),
+  'error': z.object({
+  'code': z.union([z.literal("management-required"), z.literal("unaddressable"), z.literal("unknown-plugin"), z.literal("invalid-spec"), z.literal("ambiguous-install"), z.literal("not-bundle"), z.literal("not-removable"), z.literal("stop-profile"), z.literal("bundle-in-use"), z.literal("stale-approval"), z.literal("operation-error")]),
+  'diagnostic': z.string().optional(),
+}).optional(),
+  'warnings': z.array(z.string()).optional(),
+  'packageResult': z.object({
+  'exitCode': z.number(),
+  'output': z.string(),
+  'truncated': z.boolean(),
+  'logPath': z.string(),
+  'kind': z.union([z.literal("not-found"), z.literal("network"), z.literal("unknown"), z.literal("pnpm-missing"), z.literal("timeout"), z.literal("no-matching-version"), z.literal("disk-full"), z.literal("permission"), z.literal("build-blocked"), z.literal("integrity")]).optional(),
+}).optional(),
+  'bundle': z.string().optional(),
+  'pendingBuilds': z.array(z.string()).optional(),
+  'approvedBuilds': z.array(z.string()).optional(),
+}))
+let _deepseek_ai_dsh_plugin_manager_pluginManager_setPluginEnabled_parameter_0$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_setPluginEnabled_parameter_0$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_setPluginEnabled_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+let _deepseek_ai_dsh_plugin_manager_pluginManager_setPluginEnabled_parameter_1$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_setPluginEnabled_parameter_1$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_setPluginEnabled_parameter_1$schema$value ??= z.boolean())
+let _deepseek_ai_dsh_plugin_manager_pluginManager_setPluginEnabled_result$schema$value
+const _deepseek_ai_dsh_plugin_manager_pluginManager_setPluginEnabled_result$schema = () => (_deepseek_ai_dsh_plugin_manager_pluginManager_setPluginEnabled_result$schema$value ??= z.object({
+  'changed': z.boolean(),
+  'application': z.union([z.literal("failed"), z.literal("cancelled"), z.literal("applied"), z.literal("restart-required"), z.literal("overridden")]),
+  'stage': z.union([z.literal("remove"), z.literal("install"), z.literal("enable")]),
+  'target': z.string(),
+  'enabled': z.boolean().optional(),
+  'error': z.object({
+  'code': z.union([z.literal("management-required"), z.literal("unaddressable"), z.literal("unknown-plugin"), z.literal("invalid-spec"), z.literal("ambiguous-install"), z.literal("not-bundle"), z.literal("not-removable"), z.literal("stop-profile"), z.literal("bundle-in-use"), z.literal("stale-approval"), z.literal("operation-error")]),
+  'diagnostic': z.string().optional(),
+}).optional(),
+  'warnings': z.array(z.string()).optional(),
+  'packageResult': z.object({
+  'exitCode': z.number(),
+  'output': z.string(),
+  'truncated': z.boolean(),
+  'logPath': z.string(),
+  'kind': z.union([z.literal("not-found"), z.literal("network"), z.literal("unknown"), z.literal("pnpm-missing"), z.literal("timeout"), z.literal("no-matching-version"), z.literal("disk-full"), z.literal("permission"), z.literal("build-blocked"), z.literal("integrity")]).optional(),
+}).optional(),
+  'bundle': z.string().optional(),
+  'pendingBuilds': z.array(z.string()).optional(),
+  'approvedBuilds': z.array(z.string()).optional(),
+}))
+
+export const TYPERT_REMOTE = {
+  package: '@deepseek-ai/dsh-plugin-manager',
+  descriptors: [
+    {
+      id: '@deepseek-ai/dsh-plugin-manager#pluginManager/cancelInstall',
+      service: 'pluginManager',
+      namespace: 'pluginManager',
+      method: 'cancelInstall',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'requestId',
+          wire: 'requestId',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-plugin-manager/types#PluginInstallRequestId',
+            create: _deepseek_ai_dsh_plugin_manager_pluginManager_cancelInstall_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-plugin-manager/types#PluginInstallCancellation',
+        create: _deepseek_ai_dsh_plugin_manager_pluginManager_cancelInstall_result$schema,
+      },
+      sourceLocation: {"file":"packages/boot/plugin-manager/src/index.ts","line":406,"column":9},
+    },
+    {
+      id: '@deepseek-ai/dsh-plugin-manager#pluginManager/inspect',
+      service: 'pluginManager',
+      namespace: 'pluginManager',
+      method: 'inspect',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'spec',
+          wire: 'spec',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-plugin-manager#pluginManager/inspect:spec',
+            create: _deepseek_ai_dsh_plugin_manager_pluginManager_inspect_parameter_0$schema,
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-plugin-manager/types#PluginSpecInspection',
+        create: _deepseek_ai_dsh_plugin_manager_pluginManager_inspect_result$schema,
+      },
+      sourceLocation: {"file":"packages/boot/plugin-manager/src/index.ts","line":233,"column":9},
+    },
+    {
+      id: '@deepseek-ai/dsh-plugin-manager#pluginManager/installBundle',
+      service: 'pluginManager',
+      namespace: 'pluginManager',
+      method: 'installBundle',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'spec',
+          wire: 'spec',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-plugin-manager#pluginManager/installBundle:spec',
+            create: _deepseek_ai_dsh_plugin_manager_pluginManager_installBundle_parameter_0$schema,
+          },
+        },
+        {
+          name: 'options',
+          wire: 'options',
+          source: 'json',
+          acceptsUndefined: true,
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-plugin-manager/types#InstallBundleOptions',
+            create: _deepseek_ai_dsh_plugin_manager_pluginManager_installBundle_parameter_1$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-plugin-manager/types#ChangeResult',
+        create: _deepseek_ai_dsh_plugin_manager_pluginManager_installBundle_result$schema,
+      },
+      sourceLocation: {"file":"packages/boot/plugin-manager/src/index.ts","line":338,"column":3},
+    },
+    {
+      id: '@deepseek-ai/dsh-plugin-manager#pluginManager/listBundles',
+      service: 'pluginManager',
+      namespace: 'pluginManager',
+      method: 'listBundles',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-plugin-manager#pluginManager/listBundles:result',
+        create: _deepseek_ai_dsh_plugin_manager_pluginManager_listBundles_result$schema,
+      },
+      sourceLocation: {"file":"packages/boot/plugin-manager/src/index.ts","line":194,"column":3},
+    },
+    {
+      id: '@deepseek-ai/dsh-plugin-manager#pluginManager/listPlugins',
+      service: 'pluginManager',
+      namespace: 'pluginManager',
+      method: 'listPlugins',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-plugin-manager#pluginManager/listPlugins:result',
+        create: _deepseek_ai_dsh_plugin_manager_pluginManager_listPlugins_result$schema,
+      },
+      sourceLocation: {"file":"packages/boot/plugin-manager/src/index.ts","line":170,"column":9},
+    },
+    {
+      id: '@deepseek-ai/dsh-plugin-manager#pluginManager/removeBundle',
+      service: 'pluginManager',
+      namespace: 'pluginManager',
+      method: 'removeBundle',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'name',
+          wire: 'name',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-plugin-manager#pluginManager/removeBundle:name',
+            create: _deepseek_ai_dsh_plugin_manager_pluginManager_removeBundle_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-plugin-manager/types#ChangeResult',
+        create: _deepseek_ai_dsh_plugin_manager_pluginManager_removeBundle_result$schema,
+      },
+      sourceLocation: {"file":"packages/boot/plugin-manager/src/index.ts","line":421,"column":3},
+    },
+    {
+      id: '@deepseek-ai/dsh-plugin-manager#pluginManager/setBundleEnabled',
+      service: 'pluginManager',
+      namespace: 'pluginManager',
+      method: 'setBundleEnabled',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'name',
+          wire: 'name',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-plugin-manager#pluginManager/setBundleEnabled:name',
+            create: _deepseek_ai_dsh_plugin_manager_pluginManager_setBundleEnabled_parameter_0$schema,
+          },
+        },
+        {
+          name: 'enabled',
+          wire: 'enabled',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-plugin-manager#pluginManager/setBundleEnabled:enabled',
+            create: _deepseek_ai_dsh_plugin_manager_pluginManager_setBundleEnabled_parameter_1$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-plugin-manager/types#ChangeResult',
+        create: _deepseek_ai_dsh_plugin_manager_pluginManager_setBundleEnabled_result$schema,
+      },
+      sourceLocation: {"file":"packages/boot/plugin-manager/src/index.ts","line":321,"column":3},
+    },
+    {
+      id: '@deepseek-ai/dsh-plugin-manager#pluginManager/setPluginEnabled',
+      service: 'pluginManager',
+      namespace: 'pluginManager',
+      method: 'setPluginEnabled',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'id',
+          wire: 'id',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-host-plugin-inventory/types#PluginEntryId',
+            create: _deepseek_ai_dsh_plugin_manager_pluginManager_setPluginEnabled_parameter_0$schema,
+          },
+        },
+        {
+          name: 'enabled',
+          wire: 'enabled',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-plugin-manager#pluginManager/setPluginEnabled:enabled',
+            create: _deepseek_ai_dsh_plugin_manager_pluginManager_setPluginEnabled_parameter_1$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepseek-ai/dsh-plugin-manager/types#ChangeResult',
+        create: _deepseek_ai_dsh_plugin_manager_pluginManager_setPluginEnabled_result$schema,
+      },
+      sourceLocation: {"file":"packages/boot/plugin-manager/src/index.ts","line":303,"column":3},
+    },
+  ],
+}
+
+export default TYPERT_REMOTE

package/lib/types/build-approval.d.ts

@@ -0,0 +1,12 @@
+/** Read package names left undecided by pnpm 11, including after installation cleanup.
+ * @param dir Current profile directory.
+ * @returns Exact package names awaiting a build decision; wildcard rules are excluded.
+ */
+export declare function readPendingBuilds(dir: string): Promise<string[]>;
+/** Persist approval without running scripts; the caller holds the profile manifest lock.
+ * @param dir Current profile directory.
+ * @param names Explicit package names from the pending build list.
+ * @throws If a name is no longer pending or allowBuilds contains YAML anchors or aliases; no approvals are written.
+ */
+export declare function approveBuilds(dir: string, names: readonly string[]): Promise<void>;
+//# sourceMappingURL=build-approval.d.ts.map

package/lib/types/build-approval.js

@@ -0,0 +1,56 @@
+/** Approve pnpm's pending dependency scripts in the current profile's workspace settings. */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { isAlias, isMap, isNode, isScalar, parseDocument, visit } from 'yaml';
+import { ManagementFailure } from "./failure.js";
+import { writeFileAtomic } from '@deepseek-ai/dsh-atomic-write';
+async function readPolicy(dir) {
+    let text;
+    try {
+        text = await readFile(join(dir, 'pnpm-workspace.yaml'), 'utf8');
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+        text = '{}\n';
+    }
+    const document = parseDocument(text);
+    if (document.errors[0] !== undefined)
+        throw document.errors[0];
+    if (!isMap(document.contents))
+        throw new Error('pnpm-workspace.yaml must be a YAML mapping');
+    const builds = document.get('allowBuilds');
+    if (builds !== undefined && !isMap(builds))
+        throw new Error('allowBuilds must be a YAML mapping');
+    visit(builds ?? null, (_key, node) => {
+        if (isAlias(node) || (isNode(node) && 'anchor' in node && node.anchor)) {
+            throw new Error('allowBuilds must not contain YAML anchors or aliases');
+        }
+    });
+    const pending = isMap(builds) ? builds.items.flatMap(({ key, value }) => isScalar(key) && typeof key.value === 'string' && !/[*?]/.test(key.value)
+        && isScalar(value) && value.value === 'set this to true or false' ? [key.value] : []) : [];
+    return { document, pending };
+}
+/** Read package names left undecided by pnpm 11, including after installation cleanup.
+ * @param dir Current profile directory.
+ * @returns Exact package names awaiting a build decision; wildcard rules are excluded.
+ */
+export async function readPendingBuilds(dir) {
+    return (await readPolicy(dir)).pending;
+}
+/** Persist approval without running scripts; the caller holds the profile manifest lock.
+ * @param dir Current profile directory.
+ * @param names Explicit package names from the pending build list.
+ * @throws If a name is no longer pending or allowBuilds contains YAML anchors or aliases; no approvals are written.
+ */
+export async function approveBuilds(dir, names) {
+    const { document, pending } = await readPolicy(dir);
+    if (names.some(name => !pending.includes(name)))
+        throw new ManagementFailure('stale-approval');
+    if (names.length === 0)
+        return;
+    for (const name of names)
+        document.setIn(['allowBuilds', name], true);
+    await writeFileAtomic(join(dir, 'pnpm-workspace.yaml'), String(document), { mode: 0o600 });
+}
+//# sourceMappingURL=build-approval.js.map

package/lib/types/failure.d.ts

@@ -0,0 +1,10 @@
+/** Localizable rejections shared by profile management operations. */
+import type { ManagementError } from './types.ts';
+/** Expected management rejection; presentation belongs to the caller's locale. */
+export declare class ManagementFailure extends Error {
+    /** Code rendered by the caller's locale dictionary. */
+    readonly code: ManagementError['code'];
+    /** @param code Localizable management rejection. */
+    constructor(code: ManagementError['code']);
+}
+//# sourceMappingURL=failure.d.ts.map

package/lib/types/failure.js

@@ -0,0 +1,8 @@
+/** Expected management rejection; presentation belongs to the caller's locale. */
+export class ManagementFailure extends Error {
+    /** Code rendered by the caller's locale dictionary. */
+    code;
+    /** @param code Localizable management rejection. */
+    constructor(code) { super(code); this.code = code; }
+}
+//# sourceMappingURL=failure.js.map

package/lib/types/index.d.ts

@@ -0,0 +1,107 @@
+import { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import type { BundleInfo, ChangeResult, InstallBundleOptions, PluginEntryId, PluginInfo, PluginInstallCancellation, PluginInstallRequestId, PluginSpecInspection } from './types.ts';
+export type * from './types.ts';
+export { classifyInstallFailure, type InstallFailureFacts } from './install-failure.ts';
+export { InvalidInstallSpecError, parseInstallSpec, type ParsedInstallSpec } from './install-spec.ts';
+/** The pnpm executable and the limits for package diagnostics and registry lookups. */
+export interface Config {
+    /** The pnpm executable name or path; resolved through `PATH` like the `dsh plugin` command. */
+    pnpmCommand?: string;
+    /** Maximum retained pnpm diagnostic bytes per operation. */
+    outputBytes?: number;
+    /** Maximum time to wait for another process's profile package operation. */
+    lockWaitMs?: number;
+    /** Bound on one registry lookup an inspection runs, in milliseconds. */
+    inspectTimeoutMs?: number;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** Persistent management of the current profile's composition and packages. */
+        pluginManager: PluginManager;
+    }
+}
+/** Manage profile files and apply their declared reload lifecycle. */
+export declare class PluginManager extends TypertRemoteService {
+    static inject: string[];
+    static Config: z<Config>;
+    private readonly ownerEntryId;
+    private readonly packageOperations;
+    private readonly profile;
+    private readonly outputBytes;
+    private readonly lockWaitMs;
+    private readonly inspectTimeoutMs;
+    private readonly pnpmCommand;
+    private readonly ownerContext;
+    private readonly abort;
+    /** Installations by request id, from their call until it settles. */
+    private readonly installs;
+    constructor(ctx: Context, config: Config);
+    /** Read current plugins, including why a row cannot be changed through the profile patch.
+     * @returns Current runtime entries with persistent patch targets.
+     */
+    listPlugins(): Promise<PluginInfo[]>;
+    /** Read the profile's installed bundles, the bundles this dsh installation supplies, and the selected names that are not bundles.
+     * A dependency without a bundle patch is listed, as a `not-bundle` problem, only while it is selected.
+     * @returns Package versions, one-liners, rows, activation selections, whether the installation offers the
+     * bundle, and removal availability.
+     */
+    listBundles(): Promise<BundleInfo[]>;
+    /** Read what a spec names before installing it.
+     * @param spec One package spec: a registry name, an absolute path, a git address, or a tarball.
+     * @param signal Ends a registry lookup early.
+     * @returns The package the spec names, or why it is refused.
+     */
+    inspect(spec: string, signal?: AbortSignal): Promise<PluginSpecInspection>;
+    /** Persist a plugin entry's desired enablement and apply it on live profiles.
+     * @param id Loader entry identity returned by listPlugins.
+     * @param enabled Whether the plugin should run.
+     * @returns Saved and runtime outcomes, including higher-priority overrides.
+     */
+    setPluginEnabled(id: PluginEntryId, enabled: boolean): Promise<ChangeResult>;
+    /** Select or remove a bundle layer while retaining installed dependencies.
+     * @param name Bundle package name.
+     * @param enabled Whether the bundle contributes its patch layer.
+     * @returns Persisted and runtime outcomes.
+     */
+    setBundleEnabled(name: string, enabled: boolean): Promise<ChangeResult>;
+    /**
+     * Install a package using the same pnpm implementation as dsh plugin. A run
+     * that fails, is cancelled, or adds a package without a bundle patch restores
+     * `package.json` and `pnpm-lock.yaml` as they were; downloaded files can stay.
+     * @param spec One package spec, including local paths relative to the invocation directory.
+     * @param options Whether to activate the installed bundle (defaults to true), the request id a cancellation names, and
+     * the pending build scripts to allow for this profile before pnpm runs.
+     * @returns Package-manager diagnostics and observed activation outcome.
+     */
+    installBundle(spec: string, options?: InstallBundleOptions): Promise<ChangeResult>;
+    /** Stop an installation this manager owns and wait until its files are back.
+     * @param requestId The id the installation was started with.
+     * @returns `cancelled` once pnpm exited and the files are restored, `too-late` once the bundle is being
+     * applied, `not-running` for any other id.
+     */
+    cancelInstall(requestId: PluginInstallRequestId): Promise<PluginInstallCancellation>;
+    /** Unload and remove a profile-owned bundle dependency through dsh plugin's pnpm path.
+     * @param name Installed dependency name.
+     * @returns Removal diagnostics and the remaining profile state.
+     */
+    removeBundle(name: string): Promise<ChangeResult>;
+    /** The rows a bundle's patch inserts and the existing rows it changes; an unreadable patch throws. */
+    private declaredRows;
+    /** Run one pnpm command in the profile, streaming its output as install-log chunks. */
+    private runPnpm;
+    /** The profile files an installation may rewrite, as they are now; absent files read as undefined. */
+    private readRestoredFiles;
+    /** Put the profile files back; pnpm has exited by the time this runs. */
+    private restoreFiles;
+    private selectBundle;
+    private bundleRows;
+    private protectsManager;
+    private configure;
+    private reload;
+    private change;
+    private diskState;
+}
+export default PluginManager;
+//# sourceMappingURL=index.d.ts.map