@hydraharness/harness-plugin-runtime 0.1.1-rc.10

package/lib/types/invariant.d.ts

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

package/lib/types/invariant.js

@@ -0,0 +1,11 @@
+/** Package-owned invariant companion. @module @hydraharness/harness-plugin-runtime/invariant */
+const PACKAGE_NAME = '@hydraharness/harness-plugin-runtime';
+/** Cordis companion plugin name. */
+export const name = 'plugin-runtime-invariant';
+/** Service required before the companion can reserve package ownership. */
+export const inject = ['invariants'];
+/** No runtime invariant: runtime lifecycle observations are covered by the package's focused tests. */
+const install = () => { };
+/** Register the package ownership companion. */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//# sourceMappingURL=invariant.js.map

package/lib/types/types.d.ts

@@ -0,0 +1,107 @@
+/** Public types for the shared imported-plugin runtime. */
+declare const importedPluginIdentityBrand: unique symbol;
+/** Source-qualified identity: `<plugin-name>@<source-id>`. */
+export type ImportedPluginIdentity = string & {
+    readonly [importedPluginIdentityBrand]: true;
+};
+/** Source descriptor retained for stable upgrades and source-owned paths. */
+export interface ImportedPluginSource {
+    readonly kind: 'local' | 'git' | 'marketplace-local' | 'marketplace-git';
+    readonly source: string;
+    readonly sourceId: string;
+    readonly ref?: string;
+    readonly path?: string;
+    readonly marketplace?: string;
+}
+/** Optional structured form of an import source. A string is the common direct-import form. */
+export interface ImportPluginRequest {
+    /** Local plugin/marketplace folder or a Git repository source. */
+    readonly source: string;
+    /** Marketplace plugin name when the source is a marketplace with multiple entries. */
+    readonly plugin?: string;
+    /** Optional Git ref for a direct Git source. */
+    readonly ref?: string;
+    /** Optional plugin subdirectory for a direct Git source. */
+    readonly path?: string;
+}
+/** A direct source string or the structured marketplace/Git form. */
+export type PluginImportSource = string | ImportPluginRequest;
+/** Persisted/imported bundle lifecycle state. */
+export type ImportedPluginLifecycle = 'installed' | 'disabled' | 'enabled' | 'loaded';
+/** Current review state for discovered hooks, independent of plugin enablement. */
+export type HookTrustState = 'not-applicable' | 'pending' | 'trusted';
+/** OpenAI skill/plugin presentation and invocation metadata from `agents/openai.yaml`. */
+export interface ImportedPluginAgentMetadata {
+    readonly displayName?: string;
+    readonly shortDescription?: string;
+    readonly iconSmall?: string;
+    readonly iconLarge?: string;
+    readonly brandColor?: string;
+    readonly defaultPrompt?: string;
+    readonly allowImplicitInvocation?: boolean;
+}
+/** Per-server state projected even before an MCP process is mounted. */
+export interface ImportedMcpServerSnapshot {
+    readonly name: string;
+    readonly enabled: boolean;
+    readonly startupState: 'not-started' | 'starting' | 'started' | 'failed';
+    /** Local stdio servers need no connection authentication; remote state is host-observed. */
+    readonly authenticationState: 'not-applicable' | 'unknown';
+    readonly defaultToolsApprovalMode: 'ask' | 'allow' | 'deny';
+    readonly toolApproval: Readonly<Record<string, 'ask' | 'allow' | 'deny'>>;
+    /** Currently registered, host-qualified MCP tool names. */
+    readonly tools: readonly string[];
+}
+/** One installed bundle's browser/command-facing state. */
+export interface ImportedPluginEntry {
+    readonly identity: ImportedPluginIdentity;
+    readonly name: string;
+    /** Summary supplied by the installed plugin manifest. */
+    readonly description?: string;
+    /** Usage guidance supplied by the installed plugin manifest. */
+    readonly application?: string;
+    readonly version: string;
+    readonly source: ImportedPluginSource;
+    readonly pluginRoot: string;
+    readonly dataPath: string;
+    readonly enabled: boolean;
+    /** Enablement at runtime startup; bundles installed afterwards start disabled. */
+    readonly initialEnabled?: boolean;
+    readonly lifecycle: ImportedPluginLifecycle;
+    readonly hookTrustState: HookTrustState;
+    readonly hookDefinitionDigest?: string;
+    readonly skills: readonly string[];
+    readonly mcpServers: readonly ImportedMcpServerSnapshot[];
+    readonly hooks: readonly string[];
+    /** OpenAI presentation metadata; it does not execute plugin code. */
+    readonly agentMetadata?: ImportedPluginAgentMetadata;
+    /** Registered app/MCP mapping names from inert `.app.json` metadata. */
+    readonly appMappings?: readonly string[];
+    readonly installationStatus: 'installed';
+}
+/** Complete immutable snapshot returned by every public operation. */
+export interface ImportedPluginSnapshot {
+    readonly plugins: readonly ImportedPluginEntry[];
+}
+/** Manifest metadata that the importer understands without executing bundle code. */
+export interface PluginManifest {
+    /** Manifest format selected by the runtime. */
+    readonly format?: 'legacy' | 'portable' | 'claude';
+    readonly name: string;
+    readonly version: string;
+    readonly description?: string;
+    /** Optional usage guidance shown by plugin information dialogs. */
+    readonly application?: string;
+    readonly author?: string | Readonly<Record<string, unknown>>;
+    readonly homepage?: string;
+    readonly repository?: string;
+    readonly license?: string;
+    readonly keywords?: readonly string[];
+    readonly skills?: string | readonly string[];
+    readonly mcpServers?: string | readonly string[] | Readonly<Record<string, unknown>>;
+    readonly apps?: string | readonly string[] | Readonly<Record<string, unknown>>;
+    readonly hooks?: string | readonly string[] | Readonly<Record<string, unknown>> | readonly Readonly<Record<string, unknown>>[];
+    readonly interface?: Readonly<Record<string, unknown>>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/lib/types/types.js

@@ -0,0 +1,3 @@
+/** Public types for the shared imported-plugin runtime. */
+export {};
+//# sourceMappingURL=types.js.map

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@hydraharness/harness-plugin-runtime",
+  "description": "Shared immutable OpenAI/Codex-compatible imported plugin runtime for the Hydra harness",
+  "hydra": {
+    "plugin": {
+      "application": "Import compatible plugin bundles and activate their skills, commands, MCP servers, and trusted hooks."
+    }
+  },
+  "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-runtime"
+  },
+  "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"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@hydraharness/harness-optional-plugins": "^0.1.1-rc.10",
+    "@hydraharness/harness-atomic-write": "^0.1.1-rc.10",
+    "@hydraharness/harness-commands": "^0.1.1-rc.10",
+    "@hydraharness/harness-hook-protocol": "^0.1.1-rc.10",
+    "@hydraharness/harness-home-paths": "^0.1.1-rc.10",
+    "@hydraharness/harness-invariants": "^0.1.1-rc.10",
+    "@hydraharness/harness-llm": "^0.1.1-rc.10",
+    "@hydraharness/harness-hooks-codex": "^0.1.1-rc.10",
+    "@hydraharness/harness-mcp-client": "^0.1.1-rc.10",
+    "@hydraharness/harness-skill": "^0.1.1-rc.10",
+    "@hydraharness/cordis": "^4.0.2",
+    "@hydraharness/harness-tools": "^0.1.1-rc.10"
+  },
+  "dependencies": {
+    "smol-toml": "^1.7.1",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@hydraharness/harness-optional-plugins": "^0.1.1-rc.10",
+    "@hydraharness/harness-hooks-codex": "^0.1.1-rc.10",
+    "@hydraharness/harness-commands": "^0.1.1-rc.10",
+    "@hydraharness/harness-atomic-write": "^0.1.1-rc.10",
+    "@hydraharness/harness-hook-protocol": "^0.1.1-rc.10",
+    "@hydraharness/harness-home-paths": "^0.1.1-rc.10",
+    "@hydraharness/harness-invariants": "^0.1.1-rc.10",
+    "@hydraharness/harness-llm": "^0.1.1-rc.10",
+    "@hydraharness/harness-mcp-client": "^0.1.1-rc.10",
+    "@hydraharness/harness-skill": "^0.1.1-rc.10",
+    "@hydraharness/harness-system-prompt": "^0.1.1-rc.10",
+    "@hydraharness/cordis": "^4.0.2",
+    "@hydraharness/harness-tools": "^0.1.1-rc.10"
+  }
+}