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

package/lib/types/index.d.ts

@@ -0,0 +1,230 @@
+/** Runtime plugin inventory plus shared user-setting enablement controls. */
+import { Service, type Context } from '@hydraharness/cordis';
+import { TypertRemoteService } from '@hydraharness/harness-typert-protocol';
+import type { ImportedPluginEntry, ImportedPluginSnapshot, PluginImportSource } from '@hydraharness/harness-plugin-runtime';
+import type { HookRecordDefinitionRequest, HookRecordEnablementRequest, HookRecordSnapshot } from '@hydraharness/harness-hooks-registry';
+import type { McpServerDefinitionRequest, McpServerEnablementRequest, McpServerSnapshot } from '@hydraharness/harness-mcp-registry';
+import z from '@hydraharness/schemastery';
+import type { AddPluginMarketplaceRequest, ImportedPluginMcpServerEnablementRequest, ImportedPluginMcpToolApprovalRequest, PluginEnablementRequest, PluginEnablementResult, PluginInventorySnapshot, PluginMarketplaceSnapshot, SetPluginMarketplaceEnablementRequest } from './types.ts';
+export type * from './types.ts';
+declare module '@hydraharness/cordis-plugin-loader' {
+    interface EntryOptions {
+        /** Optional composition-specific summary, overriding the package description. */
+        description?: string;
+        /** Optional composition-specific usage guidance, overriding package metadata. */
+        application?: string;
+        /** Core plugins change only on restart; omitted means normal. */
+        pluginType?: 'core' | 'normal';
+        /** Entries that implement one feature and share one Settings switch. */
+        pluginGroup?: string;
+    }
+}
+/** Inventory exclusions for entries owned by another composition plane. */
+export interface Config {
+    /** Entry ids owned by another composition plane and omitted from this inventory. */
+    compositionEntryIds?: string[];
+}
+/** Remote-only service exposing the Loader's current non-group entry state. */
+export declare class PluginInventoryGateway extends TypertRemoteService {
+    static inject: string[];
+    static Config: z<Config>;
+    private readonly compositionEntryIds;
+    private readonly settings;
+    private readonly marketplaceSettings;
+    private readonly defaultEnabled;
+    private readonly initialEnabled;
+    private readonly originalConfigs;
+    private readonly appliedSettings;
+    private restartEnablement;
+    private mutationTail;
+    constructor(ctx: Context, config?: Config);
+    protected [Service.init](): Promise<void>;
+    private rootInclude;
+    /** Project persisted OpenAI/Codex marketplace sources without exposing their entries here. */
+    private marketplaceSnapshot;
+    private moduleEntries;
+    /** One logical row per module, preferring the profile-owned entry. */
+    private representatives;
+    /** Whether changing this root entry must wait for the next profile boot. */
+    private isRestartOnly;
+    private isToggleable;
+    private enabled;
+    /** Desired state used by the switch; restart-only entries retain the live Loader state until reboot. */
+    private desiredEnabled;
+    /** Whether the currently loaded entry still differs from its persisted desired state. */
+    private restartRequired;
+    /** Resolve the active root Include to the profile directory the launcher owns. */
+    private profileDir;
+    /** Persist one restart-only root switch without changing the live Loader tree. */
+    private setRestartEnabled;
+    private isHmrWatchOnly;
+    private enqueue;
+    private restore;
+    /** Keep one configured instance active; HMR's disabled state remains watch-only. */
+    private updateModule;
+    private applySettings;
+    /**
+     * Read the Loader and optional preset roster directly on every call. Cordis's
+     * internal plugin/status events already maintain Entry.fiber and Fiber state,
+     * so a second Host cache would only add another lifecycle truth to synchronize.
+     * @returns Current Host entries followed by preset-owned leaf entries.
+     */
+    private hostEntries;
+    private presetEntries;
+    /**
+     * List Host entries and the optional preset-owned leaf entries.
+     * @returns the current inventory projection.
+     */
+    list(): Promise<PluginInventorySnapshot>;
+    /** Group only explicitly related entries, preferring a persistently editable owner. */
+    private inventoryGroups;
+    /**
+     * Persist a restart-only root state without live unload, or apply one normal
+     * module-wide live state and persist it in the shared settings document.
+     * @param request - target entry and desired enablement.
+     * @returns The fresh snapshot and whether this mutation needs a restart.
+     */
+    setEnabled(request: PluginEnablementRequest): Promise<PluginEnablementResult>;
+    /**
+     * Project every persisted OpenAI/Codex marketplace source.
+     * @returns OpenAI/Codex marketplace sources in persisted order.
+     */
+    listMarketplaces(): Promise<PluginMarketplaceSnapshot>;
+    /**
+     * Persist one validated OpenAI/Codex marketplace source, replacing any source of the same location.
+     * @param request - marketplace location with its optional Git ref and sparse paths.
+     * @returns The refreshed OpenAI/Codex marketplace source list.
+     */
+    addMarketplace(request: AddPluginMarketplaceRequest): Promise<PluginMarketplaceSnapshot>;
+    /**
+     * Enable or disable one marketplace slot, cascading to its imported plugins.
+     * @param request - marketplace source and its desired enablement.
+     * @returns The refreshed OpenAI/Codex marketplace source list.
+     */
+    setMarketplaceEnabled(request: SetPluginMarketplaceEnablementRequest): Promise<PluginMarketplaceSnapshot>;
+    /**
+     * Remove one persisted OpenAI/Codex marketplace source and uninstall its imported plugins.
+     * @param source - the persisted marketplace location to delete.
+     * @returns The refreshed OpenAI/Codex marketplace source list.
+     */
+    removeMarketplace(source: string): Promise<PluginMarketplaceSnapshot>;
+    /**
+     * Apply one lifecycle action to every plugin imported from this marketplace root.
+     * A no-op when the imported-plugin runtime is not part of this composition.
+     */
+    private cascadeMarketplacePlugins;
+    /**
+     * List source-qualified imported OpenAI/Codex plugin bundles.
+     * @returns Current imported-plugin projection.
+     */
+    listImportedPlugins(): Promise<ImportedPluginSnapshot>;
+    /**
+     * Stage a direct local/Git source or marketplace bundle through the shared runtime.
+     * @param source - Plugin source to import.
+     * @returns Current imported-plugin projection.
+     */
+    importPlugin(source: PluginImportSource): Promise<ImportedPluginSnapshot>;
+    /**
+     * Read one imported bundle by source-qualified identity or an unambiguous name.
+     * @param identityOrName - Source-qualified identity or unambiguous plugin name.
+     * @returns Current plugin projection.
+     */
+    infoPlugin(identityOrName: string): Promise<ImportedPluginEntry>;
+    /**
+     * Enable and load one imported bundle without changing native Hydra package state.
+     * @param identityOrName - Source-qualified identity or unambiguous plugin name.
+     * @returns Current imported-plugin projection.
+     */
+    enablePlugin(identityOrName: string): Promise<ImportedPluginSnapshot>;
+    /**
+     * Disable and deterministically unload one imported bundle.
+     * @param identityOrName - Source-qualified identity or unambiguous plugin name.
+     * @returns Current imported-plugin projection.
+     */
+    disablePlugin(identityOrName: string): Promise<ImportedPluginSnapshot>;
+    /**
+     * Change one imported plugin MCP server without changing hook trust.
+     * @param request - plugin identity, server name, and desired enablement.
+     * @returns Current imported-plugin projection.
+     */
+    setPluginMcpServerEnabled(request: ImportedPluginMcpServerEnablementRequest): Promise<ImportedPluginSnapshot>;
+    /**
+     * Set one imported MCP tool's approval mode without changing server enablement.
+     * @param request - Plugin identity, server, tool, and approval mode.
+     * @returns Current imported-plugin projection.
+     */
+    setPluginMcpToolApproval(request: ImportedPluginMcpToolApprovalRequest): Promise<ImportedPluginSnapshot>;
+    /**
+     * Trust only the current hook definitions; MCP/tool approval remains independent.
+     * @param identityOrName - Source-qualified identity or unambiguous plugin name.
+     * @returns Current imported-plugin projection.
+     */
+    trustPlugin(identityOrName: string): Promise<ImportedPluginSnapshot>;
+    /**
+     * Revoke hook trust without disabling other plugin components.
+     * @param identityOrName - Source-qualified identity or unambiguous plugin name.
+     * @returns Current imported-plugin projection.
+     */
+    untrustPlugin(identityOrName: string): Promise<ImportedPluginSnapshot>;
+    /**
+     * Remove one imported bundle and its writable plugin data.
+     * @param identityOrName - Source-qualified identity or unambiguous plugin name.
+     * @returns Current imported-plugin projection.
+     */
+    removePlugin(identityOrName: string): Promise<ImportedPluginSnapshot>;
+    /**
+     * List the user's own MCP server records with their live state.
+     * @returns Current MCP record projection.
+     */
+    listMcpServers(): Promise<McpServerSnapshot>;
+    /**
+     * Store one complete MCP server definition and converge its mount.
+     * @param request - Complete server definition.
+     * @returns Refreshed MCP record projection.
+     */
+    defineMcpServer(request: McpServerDefinitionRequest): Promise<McpServerSnapshot>;
+    /**
+     * Change one MCP record's desired state without touching its definition.
+     * @param request - Target record and desired state.
+     * @returns Refreshed MCP record projection.
+     */
+    setMcpServerEnabled(request: McpServerEnablementRequest): Promise<McpServerSnapshot>;
+    /**
+     * Remove one MCP record and unmount its server.
+     * @param name - Stored record name.
+     * @returns Refreshed MCP record projection.
+     */
+    removeMcpServer(name: string): Promise<McpServerSnapshot>;
+    /**
+     * List the user's own hook records with their live state.
+     * @returns Current hook record projection.
+     */
+    listHookRecords(): Promise<HookRecordSnapshot>;
+    /**
+     * Store one complete hook record definition and converge its bridge mount.
+     * @param request - Complete record definition.
+     * @returns Refreshed hook record projection.
+     */
+    defineHookRecord(request: HookRecordDefinitionRequest): Promise<HookRecordSnapshot>;
+    /**
+     * Change one hook record's desired state without touching its definition.
+     * @param request - Target record and desired state.
+     * @returns Refreshed hook record projection.
+     */
+    setHookRecordEnabled(request: HookRecordEnablementRequest): Promise<HookRecordSnapshot>;
+    /**
+     * Remove one hook record and unmount its bridge.
+     * @param name - Stored record name.
+     * @returns Refreshed hook record projection.
+     */
+    removeHookRecord(name: string): Promise<HookRecordSnapshot>;
+    private importedPlugins;
+    /** The MCP record registry is optional in compositions without user MCP servers. */
+    private mcpServers;
+    /** The hook record registry is optional in compositions without user hooks. */
+    private hookRecords;
+    /** Agent-preset ownership is optional in headless and non-roster compositions. */
+    private agentPresets;
+}
+export default PluginInventoryGateway;
+//# sourceMappingURL=index.d.ts.map