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

package/lib/types/types.d.ts

@@ -0,0 +1,169 @@
+/** Public plugin management records shared with clients. */
+import type { Branded } from '@deepseek-ai/dsh-brand';
+import type { PluginInventoryEntry } from '@deepseek-ai/dsh-host-plugin-inventory/types';
+export type { PluginEntryId } from '@deepseek-ai/dsh-host-plugin-inventory/types';
+import type { PluginEntryId } from '@deepseek-ai/dsh-host-plugin-inventory/types';
+/** Reasons a profile control cannot modify its target. */
+export type ReadOnlyReason = 'management-required' | 'unaddressable';
+/** Localizable management failure and optional external diagnostic. */
+export interface ManagementError {
+    code: ReadOnlyReason | 'unknown-plugin' | 'invalid-spec' | 'ambiguous-install' | 'not-bundle' | 'not-removable' | 'stop-profile' | 'bundle-in-use' | 'stale-approval' | 'operation-error';
+    diagnostic?: string;
+}
+/** One running-profile entry and its persistent control availability. */
+export type PluginInfo = PluginInventoryEntry & ({
+    patchId: string;
+    readOnlyReason?: never;
+} | {
+    patchId?: never;
+    readOnlyReason: ReadOnlyReason;
+});
+/** One row a bundle's patch declares, with its live entry while the bundle contributes it. */
+export interface BundleRowInfo {
+    /** The row id as the patch declares it. */
+    rowId: string;
+    /** The module the row names. */
+    moduleName: string;
+    /** The Loader entry carrying this row, when exactly one live entry has its id. */
+    entryId?: PluginEntryId;
+}
+/** One installed or installation-provided bundle. */
+export interface BundleInfo {
+    name: string;
+    version?: string;
+    /** `description` of the package manifest. */
+    description?: string;
+    enabled: boolean;
+    /** Whether the profile's own dependencies hold the package; false for a bundle the dsh installation supplies. */
+    installed: boolean;
+    /**
+     * Whether the installation ships the bundle for the person to switch on: named by the launcher's `OPTIONAL_BUNDLES`,
+     * held by the installation's dependencies, selected by no shipped template, and never removable.
+     */
+    optional: boolean;
+    removable: boolean;
+    readOnlyReason?: ReadOnlyReason;
+    error?: ManagementError;
+    /** The rows the bundle's patch inserts, in declaration order; empty when the patch cannot be read. */
+    rows: BundleRowInfo[];
+    /** Ids of rows the bundle's patch changes without declaring them: the built-in rows it configures or disables. */
+    overrides: string[];
+}
+/** How a pnpm run failed, read off how it ended and what it printed. */
+export type PluginInstallFailureKind = 'pnpm-missing' | 'timeout' | 'not-found' | 'no-matching-version' | 'network' | 'disk-full' | 'permission' | 'build-blocked' | 'integrity' | 'unknown';
+/** Pnpm completion, including a retrieval path for unabridged diagnostics. */
+export interface PackageResult {
+    exitCode: number;
+    output: string;
+    truncated: boolean;
+    logPath: string;
+    /** Present when the run failed: what kind of failure its exit and output describe. */
+    kind?: PluginInstallFailureKind;
+}
+/** Persisted change and independently observed application outcome. */
+export interface ChangeResult {
+    changed: boolean;
+    /** `cancelled` is an installation the caller stopped, its files restored. */
+    application: 'applied' | 'restart-required' | 'overridden' | 'failed' | 'cancelled';
+    /** Last attempted step; successful installation can proceed to enablement. */
+    stage: 'install' | 'enable' | 'remove';
+    target: string;
+    enabled?: boolean;
+    error?: ManagementError;
+    /** Pre-existing inactive entries the operation left as they were. */
+    warnings?: string[];
+    packageResult?: PackageResult;
+    /** The bundle an installation added, once pnpm and the bundle check accepted it. */
+    bundle?: string;
+    /** Exact package names awaiting explicit script approval in the profile's pnpm settings, read after a failed run. */
+    pendingBuilds?: string[];
+    /** Package script permissions saved before this installation attempt. */
+    approvedBuilds?: string[];
+}
+/** Identifies one installation from its start to its settlement, including its log chunks and cancellation. */
+export type PluginInstallRequestId = Branded<'PluginInstallRequestId'>;
+/** Bundle installation defaults to activation; callers that offer cancellation supply their request id. */
+export interface InstallBundleOptions {
+    enabled?: boolean;
+    requestId?: PluginInstallRequestId;
+    /** Explicitly allow these pending packages' scripts for this profile, then install; a name no longer pending refuses the call. */
+    approvedBuilds?: string[];
+}
+/** The form one install spec takes, in pnpm's vocabulary. */
+export type InstallSpecKind = 'registry' | 'path' | 'git' | 'tarball';
+/** Why a spec was refused before anything installed. */
+export type PluginInspectProblem = 'invalid-spec' | 'already-installed' | 'not-found' | 'not-a-package' | 'not-a-bundle' | 'network' | 'unknown';
+/**
+ * What a spec names, read before installing it: the registry's answer for a
+ * name, a directory's manifest for a path, and only the form for a git or
+ * tarball spec, whose package is known once pnpm has fetched it.
+ */
+export type PluginSpecInspection = {
+    readonly status: 'accepted';
+    readonly kind: InstallSpecKind;
+    readonly name?: string;
+    readonly version?: string;
+    /** `description` of the package manifest. */
+    readonly description?: string;
+    /** Whether the package declares a bundle patch; null when the spec's form does not say. */
+    readonly bundle: boolean | null;
+} | {
+    readonly status: 'refused';
+    readonly problem: PluginInspectProblem;
+    /** What pnpm, the registry, or the file system said. */
+    readonly reason: string;
+};
+/** The Host phase of one installation, before its install call settles. */
+export interface PluginInstallProgress {
+    readonly requestId: PluginInstallRequestId;
+    readonly phase: 'installing' | 'cancelling' | 'applying';
+}
+/** Cancellation is confirmed only after process exit and file restoration. */
+export interface PluginInstallCancellation {
+    readonly status: 'cancelled' | 'too-late' | 'not-running';
+}
+/** One chunk of a pnpm run's output, as the run produces it. */
+export interface PluginInstallLogChunk {
+    /** The installation the run belongs to, when its caller supplied a request id. */
+    readonly requestId?: PluginInstallRequestId;
+    /** The run the chunk belongs to. */
+    readonly jobId: string;
+    /** The command line the run executes: pnpm's command name, then its arguments. */
+    readonly argv: readonly string[];
+    /** The directory the run executes in: the profile directory. */
+    readonly cwd: string;
+    readonly stream: 'stdout' | 'stderr';
+    readonly text: string;
+    /** Present on the run's last chunk: pnpm's exit code, null when it ended without one. */
+    readonly exitCode?: number | null;
+}
+/** What changed in the profile, for consumers that show it. */
+export interface PluginChange {
+    /** The operation that changed it. */
+    readonly reason: 'plugin' | 'bundle' | 'install' | 'remove';
+}
+declare module '@deepseek-ai/cordis' {
+    interface Events {
+        /**
+         * The profile's plugins, bundles, or composition changed: a manager
+         * operation completed. A patch generation applied outside the manager,
+         * by HMR's watcher after a CLI or hand edit, announces nothing here.
+         * @mode emit
+         * @param change - what changed.
+         */
+        'plugin-manager/changed'(change: PluginChange): void;
+        /**
+         * One chunk of a pnpm run's output, streamed as the run produces it.
+         * @mode emit
+         * @param chunk - the chunk and the run it belongs to.
+         */
+        'plugin-manager/install-log'(chunk: PluginInstallLogChunk): void;
+        /**
+         * An installation moved between its Host phases.
+         * @mode emit
+         * @param progress - the installation's request id and phase.
+         */
+        'plugin-manager/install-state'(progress: PluginInstallProgress): void;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@deepseek-ai/dsh-plugin-manager",
+  "description": "Current-profile plugin and bundle management shared by dsh CLI, Web and agent tools",
+  "version": "0.1.6-alpha.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/boot/plugin-manager"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./types": {
+      "types": "./lib/types/types.d.ts",
+      "default": "./lib/types/types.js"
+    },
+    "./typert": {
+      "types": "./lib/typert.host.d.ts",
+      "default": "./lib/typert.host.js"
+    },
+    "./remote": {
+      "types": "./lib/typert.remote-client.d.ts",
+      "default": "./lib/typert.remote-client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json",
+    "./operations": {
+      "types": "./lib/types/operations.d.ts",
+      "default": "./lib/types/operations.js"
+    },
+    "./tools": {
+      "types": "./lib/types/tools.d.ts",
+      "default": "./lib/types/tools.js"
+    }
+  },
+  "files": [
+    "lib/index.js",
+    "lib/types/**/*.js",
+    "lib/types/**/*.d.ts",
+    "lib/typert.host.js",
+    "lib/typert.host.d.ts",
+    "lib/typert.remote-client.js",
+    "lib/typert.remote-client.d.ts"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "execa": "^10.0.0",
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3",
+    "@deepseek-ai/dsh-app-boot": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-atomic-write": "^0.1.6-alpha.2",
+    "@deepseek-ai/schemastery": "^3.18.2",
+    "@deepseek-ai/dsh-util-values": "^0.1.6-alpha.2"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
+    "@deepseek-ai/dsh-subprocess": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-tools": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-host-plugin-inventory": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-brand": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-sandbox-policy": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-hmr": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-user-approval": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-sandbox": "^0.1.6-alpha.2"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-hmr": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-user-approval": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
+    "@deepseek-ai/dsh-tools": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-subprocess": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-hmr": "^0.1.6-alpha.2",
+    "@deepseek-ai/cordis-plugin-timer": "^1.1.4",
+    "@deepseek-ai/dsh-sandbox-policy": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-brand": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-sandbox": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-user-approval": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-host-plugin-inventory": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2"
+  }
+}