@hydraharness/harness-host-plugin-inventory 0.1.1-rc.10

package/lib/types/invariant.d.ts

@@ -0,0 +1,9 @@
+/** Package-owned invariant companion. @module @hydraharness/harness-host-plugin-inventory/invariant */
+import type { Context } from '@hydraharness/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "host-plugin-inventory-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/** Register this package's invariant companion. */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/types/invariant.js

@@ -0,0 +1,12 @@
+/** Package-owned invariant companion. @module @hydraharness/harness-host-plugin-inventory/invariant */
+const PACKAGE_NAME = '@hydraharness/harness-host-plugin-inventory';
+/** Cordis companion plugin name. */
+export const name = 'host-plugin-inventory-invariant';
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants'];
+/** No runtime invariant: every snapshot is projected directly from Loader-owned state. */
+const install = () => { };
+/** Register this package's invariant companion. */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+/* jscpd:ignore-end */
+//# sourceMappingURL=invariant.js.map

package/lib/types/types.d.ts

@@ -0,0 +1,106 @@
+import type { Branded } from '@hydraharness/harness-brand';
+import type { SettingsTarget } from '@hydraharness/harness-workspace-config/types';
+export type { SettingsTarget } from '@hydraharness/harness-workspace-config/types';
+export type { ImportedPluginEntry, ImportedPluginSnapshot, PluginImportSource } from '@hydraharness/harness-plugin-runtime/types';
+export type { McpServerDefinitionRequest, McpServerEnablementRequest, McpServerSnapshot, McpServerStatus, McpServerTransport, McpServerView, } from '@hydraharness/harness-mcp-registry/types';
+export type { HookDialect, HookRecordDefinitionRequest, HookRecordEnablementRequest, HookRecordSnapshot, HookRecordStatus, HookRecordView, HookSourceKind, } from '@hydraharness/harness-hooks-registry/types';
+/** Stable Loader-tree identity of one configured plugin entry. */
+export type PluginEntryId = Branded<'PluginEntryId'>;
+/** Lifecycle state of an entry's root Fiber, or null when it has no live root Fiber. */
+export type PluginFiberPhase = 'pending' | 'loading' | 'active' | 'failed' | 'unloading' | null;
+/** One non-group Loader entry exposed to trusted clients. */
+export interface PluginInventoryEntry {
+    /** Functionality or dependency protected from optional-plugin suspension, separately from restart semantics. */
+    readonly required?: boolean;
+    readonly entryId: PluginEntryId;
+    /** Exact module specifier imported by the Loader entry. */
+    readonly moduleName: string;
+    /** Package-authored summary from package.json description. */
+    readonly description?: string;
+    /** Package-authored usage guidance from package.json hydra.plugin.application. */
+    readonly application?: string;
+    /** Core entries are saved for the next app start; omitted means normal. */
+    readonly pluginType?: 'core' | 'normal';
+    /** Modules with the same declared function, controlled by this entry. */
+    readonly relatedModules?: readonly string[];
+    /** Members currently have different desired states; either toggle value changes the group. */
+    readonly mixedEnabled?: boolean;
+    /** Enablement at Host start; null means grouped entries started with different states. */
+    readonly initialEnabled?: boolean | null;
+    /** Whether any saved member differs from its enablement at Host start. */
+    readonly changedSinceStart?: boolean;
+    /** Effective Loader enablement, including disabled ancestor groups. */
+    readonly enabled: boolean;
+    /** Agent preset that owns this entry, when it is not a Host entry. */
+    readonly presetId?: string;
+    /** Leaf row within {@link presetId}; identifies its settings override. */
+    readonly presetRowId?: string;
+    /** Whether a changed preset entry affects only sessions created afterwards. */
+    readonly newSessionsOnly?: boolean;
+    /** Desired root-entry enablement waiting for the next profile start. */
+    readonly pendingEnabled?: boolean;
+    /** Whether the persisted desired state differs from the live Loader state. */
+    readonly restartRequired: boolean;
+    /** Whether this app can persistently change the entry's enablement. */
+    readonly toggleable: boolean;
+    readonly fiberPhase: PluginFiberPhase;
+}
+/** Requested persistent enablement for one Loader entry. */
+export interface PluginEnablementRequest extends SettingsTarget {
+    readonly entryId: PluginEntryId;
+    readonly enabled: boolean;
+}
+/** Point-in-time inventory returned by the plugin inventory Remote. */
+export interface PluginInventorySnapshot extends SettingsTarget {
+    readonly entries: readonly PluginInventoryEntry[];
+}
+/** Result of changing one native plugin's desired state. */
+export interface PluginEnablementResult {
+    readonly snapshot: PluginInventorySnapshot;
+    /** Whether this specific mutation waits for the next profile start. */
+    readonly restartRequired: boolean;
+}
+/** Persist one Git-backed or local marketplace root. */
+export interface AddPluginMarketplaceRequest {
+    readonly source: string;
+    readonly gitRef?: string;
+    readonly sparsePaths?: readonly string[];
+}
+/** Host-normalized source fields shared by every marketplace state. */
+export interface PluginMarketplaceSourceView {
+    readonly source: string;
+    readonly gitRef?: string;
+    readonly sparsePaths: readonly string[];
+    /** Marketplace slot state; disabling or removing it cascades to its imported plugins. */
+    readonly enabled: boolean;
+}
+/** Toggle one marketplace slot; disabling cascades to disable its imported plugins. */
+export interface SetPluginMarketplaceEnablementRequest {
+    readonly source: string;
+    readonly enabled: boolean;
+}
+/** One persisted marketplace and its latest Host-side load result. */
+export type PluginMarketplaceView = PluginMarketplaceSourceView & ({
+    readonly status: 'ready';
+} | {
+    readonly status: 'unavailable';
+});
+/** Point-in-time marketplace catalog returned by the plugin inventory Remote. */
+export interface PluginMarketplaceSnapshot {
+    readonly marketplaces: readonly PluginMarketplaceView[];
+}
+/** Enable or disable one imported plugin MCP server. */
+export interface ImportedPluginMcpServerEnablementRequest {
+    readonly identity: string;
+    readonly server: string;
+    readonly enabled: boolean;
+}
+/** Set one imported MCP tool's approval mode. */
+export interface ImportedPluginMcpToolApprovalRequest {
+    readonly identity: string;
+    readonly server: string;
+    /** Raw MCP name or its host-qualified public tool name. */
+    readonly tool: string;
+    readonly approval: 'ask' | 'allow' | 'deny';
+}
+//# 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,94 @@
+{
+  "name": "@hydraharness/harness-host-plugin-inventory",
+  "description": "Remote projection and shared-settings controls for current Cordis Loader plugin state",
+  "hydra": {
+    "plugin": {
+      "application": "Expose installed plugin information and persist plugin, marketplace, MCP, and hook settings."
+    }
+  },
+  "version": "0.1.1-rc.10",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MaiHongPhong2010/Hydra-Harness.git",
+    "directory": "packages/host/plugin-inventory"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.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"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.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": {
+    "zod": "^4.4.3",
+    "@hydraharness/schemastery": "^3.18.2"
+  },
+  "peerDependencies": {
+    "@hydraharness/harness-optional-plugins": "^0.1.1-rc.10",
+    "@hydraharness/harness-app-boot": "^0.1.1-rc.10",
+    "@hydraharness/harness-atomic-write": "^0.1.1-rc.10",
+    "@hydraharness/harness-brand": "^0.1.1-rc.10",
+    "@hydraharness/harness-hooks-registry": "^0.1.1-rc.10",
+    "@hydraharness/harness-mcp-registry": "^0.1.1-rc.10",
+    "@hydraharness/harness-plugin-runtime": "^0.1.1-rc.10",
+    "@hydraharness/harness-settings": "^0.1.1-rc.10",
+    "@hydraharness/harness-typert-protocol": "^0.1.1-rc.10",
+    "@hydraharness/harness-invariants": "^0.1.1-rc.10",
+    "@hydraharness/harness-workspace-config": "^0.1.1-rc.10",
+    "@hydraharness/cordis": "^4.0.2",
+    "@hydraharness/cordis-plugin-include": "^1.0.7",
+    "@hydraharness/cordis-plugin-loader": "^1.0.3"
+  },
+  "devDependencies": {
+    "@hydraharness/harness-agent-presets": "^0.1.1-rc.10",
+    "@hydraharness/harness-optional-plugins": "^0.1.1-rc.10",
+    "@hydraharness/harness-app-boot": "^0.1.1-rc.10",
+    "@hydraharness/harness-brand": "^0.1.1-rc.10",
+    "@hydraharness/harness-atomic-write": "^0.1.1-rc.10",
+    "@hydraharness/harness-hooks-registry": "^0.1.1-rc.10",
+    "@hydraharness/harness-invariants": "^0.1.1-rc.10",
+    "@hydraharness/harness-mcp-registry": "^0.1.1-rc.10",
+    "@hydraharness/harness-plugin-runtime": "^0.1.1-rc.10",
+    "@hydraharness/harness-settings": "^0.1.1-rc.10",
+    "@hydraharness/harness-workspace-config": "^0.1.1-rc.10",
+    "@hydraharness/harness-settings-file": "^0.1.1-rc.10",
+    "@hydraharness/cordis": "^4.0.2",
+    "@hydraharness/cordis-plugin-include": "^1.0.7",
+    "@hydraharness/cordis-plugin-loader": "^1.0.3",
+    "@hydraharness/harness-typert-protocol": "^0.1.1-rc.10"
+  }
+}