pi-harness-runtime 0.5.0 → 0.6.3-beta.13

package/packages/framework-plugin-sdk/dist/types.d.ts

@@ -0,0 +1,349 @@
+/**
+ * Framework Plugin SDK - Types
+ *
+ * Core types for the plugin system.
+ */
+/**
+ * SDK version for compatibility checks
+ */
+export declare const SDK_VERSION = "1.0.0";
+/**
+ * Plugin capability
+ */
+export type PluginCapability = "provider" | "framework" | "generator" | "linter" | "template" | "validator" | "tool" | "hook";
+/**
+ * Plugin status
+ */
+export type PluginStatus = "registered" | "loaded" | "initialized" | "active" | "inactive" | "error" | "unloaded";
+/**
+ * Plugin manifest
+ */
+export interface PluginManifest {
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    author?: string;
+    license?: string;
+    homepage?: string;
+    repository?: string;
+    capabilities: PluginCapability[];
+    dependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    entryPoint?: string;
+    configuration?: PluginConfiguration;
+    hooks?: HookDefinition[];
+    permissions?: PluginPermission[];
+    compatibility?: {
+        minSdkVersion?: string;
+        maxSdkVersion?: string;
+    };
+}
+/**
+ * Plugin configuration schema
+ */
+export interface PluginConfiguration {
+    schema?: Record<string, ConfigSchemaEntry>;
+    defaults?: Record<string, unknown>;
+}
+/**
+ * Config schema entry
+ */
+export interface ConfigSchemaEntry {
+    type: "string" | "number" | "boolean" | "object" | "array";
+    description?: string;
+    default?: unknown;
+    required?: boolean;
+    minimum?: number;
+    maximum?: number;
+    pattern?: string;
+    enum?: unknown[];
+}
+/**
+ * Hook definition
+ */
+export interface HookDefinition {
+    name: string;
+    description?: string;
+    parameter?: string;
+    returnType?: string;
+}
+/**
+ * Plugin permission
+ */
+export interface PluginPermission {
+    action: "read" | "write" | "execute" | "network" | "filesystem";
+    resource?: string;
+    scope?: "own" | "all";
+}
+/**
+ * Plugin instance
+ */
+export interface Plugin {
+    /**
+     * Unique plugin ID
+     */
+    id: string;
+    /**
+     * Plugin manifest
+     */
+    manifest: PluginManifest;
+    /**
+     * Current status
+     */
+    status: PluginStatus;
+    /**
+     * Plugin instance
+     */
+    instance?: unknown;
+    /**
+     * Configuration
+     */
+    configuration: Record<string, unknown>;
+    /**
+     * Registered capabilities
+     */
+    capabilities: Map<PluginCapability, unknown>;
+    /**
+     * Error if status is error
+     */
+    error?: string;
+    /**
+     * Load time
+     */
+    loadedAt?: string;
+    /**
+     * Activation time
+     */
+    activatedAt?: string;
+}
+/**
+ * Plugin lifecycle events
+ */
+export type PluginLifecycleEvent = "beforeLoad" | "afterLoad" | "beforeInitialize" | "afterInitialize" | "beforeActivate" | "afterActivate" | "beforeDeactivate" | "afterDeactivate" | "beforeUnload" | "afterUnload";
+/**
+ * Lifecycle context
+ */
+export interface LifecycleContext {
+    pluginId: string;
+    event: PluginLifecycleEvent;
+    timestamp: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Hook handler
+ */
+export interface HookHandler {
+    id: string;
+    name: string;
+    pluginId: string;
+    priority: number;
+    handler: HookFunction;
+    description?: string;
+}
+/**
+ * Hook function
+ */
+export type HookFunction = (context: unknown, ...args: unknown[]) => unknown | Promise<unknown>;
+/**
+ * Hook result
+ */
+export interface HookResult {
+    hook: string;
+    handlers: number;
+    results: unknown[];
+    durationMs: number;
+}
+/**
+ * Provider extension
+ */
+export interface ProviderExtension {
+    capability: "provider";
+    name: string;
+    provider: {
+        complete: (prompt: string, options?: unknown) => Promise<unknown>;
+        stream?: (prompt: string, options?: unknown) => AsyncGenerator<unknown>;
+        embed?: (input: string) => Promise<number[]>;
+    };
+    config?: Record<string, unknown>;
+}
+/**
+ * Framework extension
+ */
+export interface FrameworkExtension {
+    capability: "framework";
+    name: string;
+    detector: {
+        detect: (context: unknown) => Promise<unknown>;
+        signals?: unknown[];
+    };
+    config?: Record<string, unknown>;
+}
+/**
+ * Generator extension
+ */
+export interface GeneratorExtension {
+    capability: "generator";
+    name: string;
+    generator: {
+        generate: (template: string, variables: Record<string, unknown>) => Promise<string>;
+        validate?: (code: string) => Promise<boolean>;
+    };
+    config?: Record<string, unknown>;
+}
+/**
+ * Linter extension
+ */
+export interface LinterExtension {
+    capability: "linter";
+    name: string;
+    rules: unknown[];
+    config?: Record<string, unknown>;
+}
+/**
+ * Template extension
+ */
+export interface TemplateExtension {
+    capability: "template";
+    name: string;
+    templates: unknown[];
+    config?: Record<string, unknown>;
+}
+/**
+ * Validator extension
+ */
+export interface ValidatorExtension {
+    capability: "validator";
+    name: string;
+    validators: unknown[];
+    config?: Record<string, unknown>;
+}
+/**
+ * Tool extension
+ */
+export interface ToolExtension {
+    capability: "tool";
+    name: string;
+    tools: {
+        name: string;
+        description: string;
+        parameters?: unknown;
+        execute: (params: unknown) => Promise<unknown>;
+    }[];
+    config?: Record<string, unknown>;
+}
+/**
+ * Sandbox configuration
+ */
+export interface SandboxConfig {
+    timeout?: number;
+    memoryLimit?: number;
+    networkAccess?: boolean;
+    filesystemAccess?: "none" | "own" | "all";
+    allowEval?: boolean;
+}
+/**
+ * Sandbox result
+ */
+export interface SandboxResult {
+    success: boolean;
+    result?: unknown;
+    error?: string;
+    durationMs: number;
+}
+/**
+ * Registry entry
+ */
+export interface RegistryEntry {
+    id: string;
+    name: string;
+    version: string;
+    pluginId: string;
+    capability: PluginCapability;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Plugin manager configuration
+ */
+export interface PluginManagerConfig {
+    /**
+     * Plugin directory
+     */
+    pluginDir?: string;
+    /**
+     * Auto-load plugins
+     */
+    autoLoad?: boolean;
+    /**
+     * Auto-activate plugins
+     */
+    autoActivate?: boolean;
+    /**
+     * Plugin search patterns
+     */
+    patterns?: string[];
+    /**
+     * Sandbox configuration
+     */
+    sandbox?: SandboxConfig;
+    /**
+     * Enable hooks
+     */
+    hooks?: boolean;
+    /**
+     * Log level
+     */
+    logLevel?: "debug" | "info" | "warn" | "error";
+}
+/**
+ * Load options
+ */
+export interface LoadOptions {
+    /**
+     * Plugin ID or path
+     */
+    plugin: string;
+    /**
+     * Configuration
+     */
+    config?: Record<string, unknown>;
+    /**
+     * Sandbox configuration
+     */
+    sandbox?: SandboxConfig;
+    /**
+     * Skip validation
+     */
+    skipValidation?: boolean;
+}
+/**
+ * Plugin error
+ */
+export declare class PluginError extends Error {
+    readonly code: string;
+    readonly pluginId?: string | undefined;
+    constructor(message: string, code: string, pluginId?: string | undefined);
+}
+/**
+ * Error codes
+ */
+export declare const PluginErrorCode: {
+    readonly MANIFEST_NOT_FOUND: "MANIFEST_NOT_FOUND";
+    readonly MANIFEST_INVALID: "MANIFEST_INVALID";
+    readonly ENTRY_NOT_FOUND: "ENTRY_NOT_FOUND";
+    readonly LOAD_FAILED: "LOAD_FAILED";
+    readonly INIT_FAILED: "INIT_FAILED";
+    readonly ACTIVATE_FAILED: "ACTIVATE_FAILED";
+    readonly DEACTIVATE_FAILED: "DEACTIVATE_FAILED";
+    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
+    readonly CAPABILITY_NOT_FOUND: "CAPABILITY_NOT_FOUND";
+    readonly DEPENDENCY_MISSING: "DEPENDENCY_MISSING";
+    readonly DEPENDENCY_CONFLICT: "DEPENDENCY_CONFLICT";
+    readonly INCOMPATIBLE_VERSION: "INCOMPATIBLE_VERSION";
+    readonly HOOK_FAILED: "HOOK_FAILED";
+    readonly SANDBOX_ERROR: "SANDBOX_ERROR";
+    readonly ALREADY_LOADED: "ALREADY_LOADED";
+    readonly NOT_LOADED: "NOT_LOADED";
+    readonly NOT_ACTIVE: "NOT_ACTIVE";
+};
+//# sourceMappingURL=types.d.ts.map

package/packages/framework-plugin-sdk/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,eAAO,MAAM,WAAW,UAAU,CAAC;AAInC;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACzB,UAAU,GACV,WAAW,GACX,WAAW,GACX,QAAQ,GACR,UAAU,GACV,WAAW,GACX,MAAM,GACN,MAAM,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,YAAY,GACZ,QAAQ,GACR,aAAa,GACb,QAAQ,GACR,UAAU,GACV,OAAO,GACP,UAAU,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC,aAAa,CAAC,EAAE;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CACtB;AAID;;GAEG;AACH,MAAM,WAAW,MAAM;IACtB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,MAAM,EAAE,YAAY,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC;;OAEG;IACH,YAAY,EAAE,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAE7C;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC7B,YAAY,GACZ,WAAW,GACX,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,iBAAiB,GACjB,cAAc,GACd,aAAa,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAID;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAC1B,OAAO,EAAE,OAAO,EAChB,GAAG,IAAI,EAAE,OAAO,EAAE,KACd,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACnB;AAID;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACT,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC;QACxE,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;KAC7C,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,UAAU,EAAE,WAAW,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACT,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/C,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;KACpB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,UAAU,EAAE,WAAW,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE;QACV,QAAQ,EAAE,CACT,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC9C,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,QAAQ,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,UAAU,EAAE,WAAW,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC/C,EAAE,CAAC;IACJ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAID;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACnB;AAID;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAID;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB;AAID;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAGpB,IAAI,EAAE,MAAM;aACZ,QAAQ,CAAC,EAAE,MAAM;gBAFjC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,YAAA;CAKlC;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;CAkBlB,CAAC"}

package/packages/framework-plugin-sdk/dist/types.js

@@ -0,0 +1,47 @@
+/**
+ * Framework Plugin SDK - Types
+ *
+ * Core types for the plugin system.
+ */
+// ─── SDK Version ────────────────────────────────────────────────────────────
+/**
+ * SDK version for compatibility checks
+ */
+export const SDK_VERSION = "1.0.0";
+// ─── Error Types ────────────────────────────────────────────────────────────
+/**
+ * Plugin error
+ */
+export class PluginError extends Error {
+    code;
+    pluginId;
+    constructor(message, code, pluginId) {
+        super(message);
+        this.code = code;
+        this.pluginId = pluginId;
+        this.name = "PluginError";
+    }
+}
+/**
+ * Error codes
+ */
+export const PluginErrorCode = {
+    MANIFEST_NOT_FOUND: "MANIFEST_NOT_FOUND",
+    MANIFEST_INVALID: "MANIFEST_INVALID",
+    ENTRY_NOT_FOUND: "ENTRY_NOT_FOUND",
+    LOAD_FAILED: "LOAD_FAILED",
+    INIT_FAILED: "INIT_FAILED",
+    ACTIVATE_FAILED: "ACTIVATE_FAILED",
+    DEACTIVATE_FAILED: "DEACTIVATE_FAILED",
+    PERMISSION_DENIED: "PERMISSION_DENIED",
+    CAPABILITY_NOT_FOUND: "CAPABILITY_NOT_FOUND",
+    DEPENDENCY_MISSING: "DEPENDENCY_MISSING",
+    DEPENDENCY_CONFLICT: "DEPENDENCY_CONFLICT",
+    INCOMPATIBLE_VERSION: "INCOMPATIBLE_VERSION",
+    HOOK_FAILED: "HOOK_FAILED",
+    SANDBOX_ERROR: "SANDBOX_ERROR",
+    ALREADY_LOADED: "ALREADY_LOADED",
+    NOT_LOADED: "NOT_LOADED",
+    NOT_ACTIVE: "NOT_ACTIVE",
+};
+//# sourceMappingURL=types.js.map

package/packages/framework-plugin-sdk/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAgZnC,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGpB;IACA;IAHjB,YACC,OAAe,EACC,IAAY,EACZ,QAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,aAAQ,GAAR,QAAQ,CAAS;QAGjC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC3B,CAAC;CACD;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC9B,kBAAkB,EAAE,oBAAoB;IACxC,gBAAgB,EAAE,kBAAkB;IACpC,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,iBAAiB;IAClC,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,mBAAmB;IACtC,oBAAoB,EAAE,sBAAsB;IAC5C,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;CACf,CAAC"}

package/packages/framework-plugin-sdk/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@pi/framework-plugin-sdk",
+  "version": "0.6.3-beta.13",
+  "description": "Framework plugin SDK for pi-harness-runtime",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test",
+    "test:watch": "bun test --watch"
+  },
+  "keywords": [
+    "pi",
+    "harness",
+    "runtime",
+    "plugin",
+    "sdk",
+    "extensions"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  }
+}

package/packages/framework-plugin-sdk/src/index.ts

@@ -0,0 +1,45 @@
+/**
+ * Framework Plugin SDK
+ *
+ * Extensible plugin system for framework integrations.
+ */
+
+// ─── Manager ──────────────────────────────────────────────────────────
+
+export {
+	PluginManager,
+	createPluginManager,
+} from "./manager.js";
+
+// ─── Types ────────────────────────────────────────────────────────────
+
+export {
+	SDK_VERSION,
+	type PluginCapability,
+	type PluginStatus,
+	type PluginManifest,
+	type PluginConfiguration,
+	type ConfigSchemaEntry,
+	type HookDefinition,
+	type PluginPermission,
+	type Plugin,
+	type PluginLifecycleEvent,
+	type LifecycleContext,
+	type HookHandler,
+	type HookFunction,
+	type HookResult,
+	type ProviderExtension,
+	type FrameworkExtension,
+	type GeneratorExtension,
+	type LinterExtension,
+	type TemplateExtension,
+	type ValidatorExtension,
+	type ToolExtension,
+	type SandboxConfig,
+	type SandboxResult,
+	type RegistryEntry,
+	type PluginManagerConfig,
+	type LoadOptions,
+	PluginError,
+	PluginErrorCode,
+} from "./types.js";