@t-req/core 0.2.0 → 0.2.1

package/dist/plugin/loader.d.ts

@@ -0,0 +1,69 @@
+import type { LoadedPlugin, PluginConfigRef, PluginPermission, PluginPermissionsConfig, SubprocessPluginConfig, TreqPlugin } from './types';
+/**
+ * Get the unique identifier for a plugin: name#instanceId
+ */
+export declare function getPluginId(plugin: TreqPlugin): string;
+/**
+ * Parse a plugin ID into name and instanceId.
+ */
+export declare function parsePluginId(id: string): {
+    name: string;
+    instanceId: string;
+};
+/**
+ * Check if a config ref is a subprocess plugin config.
+ */
+export declare function isSubprocessPluginConfig(ref: PluginConfigRef): ref is SubprocessPluginConfig;
+/**
+ * Check if a config ref is an inline plugin.
+ */
+export declare function isInlinePlugin(ref: PluginConfigRef): ref is TreqPlugin;
+/**
+ * Check if a config ref is a file:// path.
+ */
+export declare function isFilePlugin(ref: PluginConfigRef): boolean;
+/**
+ * Check if a config ref is an npm package.
+ */
+export declare function isNpmPlugin(ref: PluginConfigRef): boolean;
+export declare function resolveFilePath(fileUrl: string, projectRoot: string, allowOutsideProject: boolean): string;
+/**
+ * Resolve and validate a file path, following symlinks.
+ * This is called after the initial path resolution to verify the real path.
+ */
+export declare function resolveAndValidateFilePath(filePath: string, projectRoot: string, allowOutsideProject: boolean): Promise<string>;
+/**
+ * Resolve permissions for a plugin.
+ */
+export declare function resolvePermissions(plugin: TreqPlugin, permissionsConfig: PluginPermissionsConfig | undefined, warnings: string[]): PluginPermission[];
+export interface LoadPluginsOptions {
+    /** Project root directory */
+    projectRoot: string;
+    /** Plugin configuration references */
+    plugins: PluginConfigRef[];
+    /** Security settings */
+    security?: {
+        allowPluginsOutsideProject?: boolean;
+    };
+    /** Permission configuration */
+    pluginPermissions?: PluginPermissionsConfig;
+    /** Warning collector */
+    warnings?: string[];
+}
+export interface LoadPluginsResult {
+    /** Loaded plugins in order */
+    plugins: LoadedPlugin[];
+    /** Warnings generated during loading */
+    warnings: string[];
+}
+/**
+ * Load plugins from configuration.
+ * Handles npm packages, file:// URLs, inline plugins, and subprocess plugins.
+ */
+export declare function loadPlugins(options: LoadPluginsOptions): Promise<LoadPluginsResult>;
+/**
+ * Merge plugin arrays with deduplication by name#instanceId.
+ * Later definitions override earlier ones.
+ */
+export declare function mergePluginRefs(base: PluginConfigRef[], overlay: PluginConfigRef[]): PluginConfigRef[];
+//# sourceMappingURL=loader.d.ts.map

package/dist/plugin/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugin/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,UAAU,EACX,MAAM,SAAS,CAAC;AAYjB;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAS9E;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,eAAe,GAAG,GAAG,IAAI,sBAAsB,CAQ5F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,GAAG,IAAI,UAAU,CAStE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAQ1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAQzD;AAaD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,OAAO,GAC3B,MAAM,CA+BR;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,OAAO,GAC3B,OAAO,CAAC,MAAM,CAAC,CA6BjB;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,iBAAiB,EAAE,uBAAuB,GAAG,SAAS,EACtD,QAAQ,EAAE,MAAM,EAAE,GACjB,gBAAgB,EAAE,CAqCpB;AAMD,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,wBAAwB;IACxB,QAAQ,CAAC,EAAE;QACT,0BAA0B,CAAC,EAAE,OAAO,CAAC;KACtC,CAAC;IACF,+BAA+B;IAC/B,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;IAC5C,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqCzF;AAyMD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,eAAe,EAAE,EACvB,OAAO,EAAE,eAAe,EAAE,GACzB,eAAe,EAAE,CAInB"}

package/dist/plugin/manager.d.ts

@@ -0,0 +1,186 @@
+import type { EngineEvent } from '../runtime/types';
+import type { Resolver } from '../types';
+import type { CombinedEventSink, CommandHandler, CompiledInput, CompiledOutput, EnterpriseContext, ErrorInput, ErrorOutput, HookContext, LoadedPlugin, MiddlewareFunction, ParseInput, ParseOutput, PluginConfigRef, PluginPermissionsConfig, RequestAfterInput, RequestInput, RequestOutput, ResponseInput, ResponseOutput, RetrySignal, ToolDefinition } from './types';
+export interface PluginManagerOptions {
+    /** Project root directory */
+    projectRoot: string;
+    /** Plugin configuration references */
+    plugins?: PluginConfigRef[];
+    /** Security settings */
+    security?: {
+        allowPluginsOutsideProject?: boolean;
+    };
+    /** Permission configuration */
+    pluginPermissions?: PluginPermissionsConfig;
+    /** Event sink for combined events */
+    onEvent?: CombinedEventSink;
+    /** Enterprise context (if available) */
+    enterprise?: EnterpriseContext;
+    /** Initial secrets for secrets API */
+    secrets?: Record<string, string>;
+}
+export interface HookExecutionResult<TOutput> {
+    /** Final output after all plugins processed */
+    output: TOutput;
+    /** Whether any plugin modified the output */
+    modified: boolean;
+    /** Retry signal if any plugin requested retry */
+    retry?: RetrySignal;
+    /** Whether to skip the request */
+    skip?: boolean;
+}
+/**
+ * Central manager for plugin lifecycle, hook execution, and event emission.
+ */
+export declare class PluginManager {
+    private options;
+    private plugins;
+    private resolvers;
+    private commands;
+    private middleware;
+    private tools;
+    private warnings;
+    private initialized;
+    private config;
+    private onEvent?;
+    private enterprise?;
+    private secrets?;
+    private session;
+    constructor(options: PluginManagerOptions);
+    /**
+     * Set the event sink for plugin events.
+     * This allows setting the event handler after the plugin manager is created,
+     * which is useful when the event handler depends on runtime context.
+     */
+    setEventSink(sink: CombinedEventSink): void;
+    /**
+     * Load and initialize all plugins.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Initialize a single plugin.
+     */
+    private initializePlugin;
+    /**
+     * Register a plugin's contributions (resolvers, commands, middleware, tools).
+     */
+    private registerPluginContributions;
+    /**
+     * Teardown all plugins in reverse order.
+     */
+    teardown(): Promise<void>;
+    /**
+     * Create a hook context.
+     */
+    createHookContext(options: {
+        retries?: number;
+        maxRetries?: number;
+        variables?: Record<string, unknown>;
+    }): HookContext;
+    /**
+     * Execute parse.after hooks.
+     */
+    triggerParseAfter(input: ParseInput, output: ParseOutput): Promise<HookExecutionResult<ParseOutput>>;
+    /**
+     * Execute request.before hooks.
+     */
+    triggerRequestBefore(input: RequestInput, output: RequestOutput): Promise<HookExecutionResult<RequestOutput>>;
+    /**
+     * Execute request.compiled hooks.
+     */
+    triggerRequestCompiled(input: CompiledInput, output: CompiledOutput): Promise<HookExecutionResult<CompiledOutput>>;
+    /**
+     * Execute request.after hooks (read-only).
+     */
+    triggerRequestAfter(input: RequestAfterInput): Promise<void>;
+    /**
+     * Execute response.after hooks.
+     */
+    triggerResponseAfter(input: ResponseInput, output: ResponseOutput): Promise<HookExecutionResult<ResponseOutput>>;
+    /**
+     * Execute error hooks.
+     */
+    triggerError(input: ErrorInput, output: ErrorOutput): Promise<HookExecutionResult<ErrorOutput>>;
+    /**
+     * Generic hook execution with input/output pattern.
+     */
+    private executeHook;
+    /**
+     * Execute a read-only hook (no output parameter).
+     */
+    private executeReadOnlyHook;
+    /**
+     * Emit a plugin event.
+     */
+    private emitPluginEvent;
+    /**
+     * Emit an engine event to all plugins.
+     */
+    emitEngineEvent(event: EngineEvent): void;
+    /**
+     * Get all registered resolvers.
+     */
+    getResolvers(): Record<string, Resolver>;
+    /**
+     * Get a specific resolver.
+     */
+    getResolver(name: string): Resolver | undefined;
+    /**
+     * Call a resolver and handle errors.
+     */
+    callResolver(name: string, args: string[]): Promise<string>;
+    /**
+     * Get all registered commands.
+     */
+    getCommands(): Record<string, CommandHandler>;
+    /**
+     * Get a specific command.
+     */
+    getCommand(name: string): CommandHandler | undefined;
+    /**
+     * Get all registered middleware.
+     */
+    getMiddleware(): MiddlewareFunction[];
+    /**
+     * Get all registered tools.
+     */
+    getTools(): Record<string, ToolDefinition>;
+    /**
+     * Get all loaded plugins.
+     */
+    getPlugins(): LoadedPlugin[];
+    /**
+     * Get all warnings.
+     */
+    getWarnings(): string[];
+    /**
+     * Check if plugins are loaded.
+     */
+    hasPlugins(): boolean;
+    /**
+     * Get plugin by name.
+     */
+    getPlugin(name: string): LoadedPlugin | undefined;
+    /**
+     * Get plugin info for display.
+     */
+    getPluginInfo(): Array<{
+        name: string;
+        version?: string;
+        source: string;
+        permissions: string[];
+    }>;
+    /**
+     * Update session variables.
+     */
+    setSessionVariable(key: string, value: unknown): void;
+    /**
+     * Get session variables.
+     */
+    getSessionVariables(): Record<string, unknown>;
+}
+/**
+ * Create a new plugin manager.
+ */
+export declare function createPluginManager(options: PluginManagerOptions): PluginManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/plugin/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/plugin/manager.ts"],"names":[],"mappings":"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"}

package/dist/plugin/permissions.d.ts

@@ -0,0 +1,33 @@
+import type { EnterpriseContext, PluginContext, PluginPermission, ResolvedPluginConfig, TreqPlugin } from './types';
+/**
+ * Error thrown when a plugin tries to access a capability without permission.
+ */
+export declare class PermissionDeniedError extends Error {
+    readonly permission: PluginPermission;
+    readonly pluginName: string;
+    constructor(permission: PluginPermission, pluginName: string);
+}
+export interface CreateRestrictedContextOptions {
+    plugin: TreqPlugin;
+    permissions: PluginPermission[];
+    config: ResolvedPluginConfig;
+    enterprise?: EnterpriseContext;
+    secrets?: Record<string, string>;
+}
+/**
+ * Create a restricted context for a plugin based on its permissions.
+ */
+export declare function createRestrictedContext(options: CreateRestrictedContextOptions): PluginContext;
+/**
+ * Validate that a plugin has the required permissions.
+ */
+export declare function validatePermissions(plugin: TreqPlugin, grantedPermissions: PluginPermission[], requiredPermissions: PluginPermission[]): string[];
+/**
+ * Check if a plugin has a specific permission.
+ */
+export declare function hasPermission(grantedPermissions: PluginPermission[], permission: PluginPermission): boolean;
+/**
+ * Assert that a plugin has a specific permission.
+ */
+export declare function assertPermission(grantedPermissions: PluginPermission[], permission: PluginPermission, pluginName: string): void;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/plugin/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/plugin/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACX,MAAM,SAAS,CAAC;AAMjB;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAE5B,UAAU,EAAE,gBAAgB;aAC5B,UAAU,EAAE,MAAM;gBADlB,UAAU,EAAE,gBAAgB,EAC5B,UAAU,EAAE,MAAM;CAKrC;AAuOD,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,aAAa,CA4C9F;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,kBAAkB,EAAE,gBAAgB,EAAE,EACtC,mBAAmB,EAAE,gBAAgB,EAAE,GACtC,MAAM,EAAE,CAUV;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,kBAAkB,EAAE,gBAAgB,EAAE,EACtC,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,kBAAkB,EAAE,gBAAgB,EAAE,EACtC,UAAU,EAAE,gBAAgB,EAC5B,UAAU,EAAE,MAAM,GACjB,IAAI,CAIN"}

package/dist/plugin/subprocess.d.ts

@@ -0,0 +1,100 @@
+import type { EngineEvent } from '../runtime/types';
+import type { LoadedPlugin, PluginHooks, PluginPermission, SubprocessPluginConfig, TreqPlugin } from './types';
+/**
+ * Manages a subprocess plugin process.
+ * Communicates via NDJSON over stdin/stdout.
+ */
+export declare class SubprocessPlugin {
+    private config;
+    private projectRoot;
+    private process;
+    private requestId;
+    private pendingRequests;
+    private buffer;
+    private initialized;
+    private restartCount;
+    private capabilities;
+    private pluginInfo;
+    constructor(config: SubprocessPluginConfig, projectRoot: string);
+    /**
+     * Start the subprocess and initialize it.
+     */
+    start(): Promise<void>;
+    /**
+     * Spawn the subprocess.
+     */
+    private spawn;
+    /**
+     * Initialize the plugin by sending init message.
+     */
+    private initialize;
+    /**
+     * Handle stdout data.
+     */
+    private handleStdout;
+    /**
+     * Handle a parsed response.
+     */
+    private handleResponse;
+    /**
+     * Handle process close.
+     */
+    private handleClose;
+    /**
+     * Handle spawn error.
+     */
+    private handleError;
+    /**
+     * Get the next request ID.
+     */
+    private nextId;
+    /**
+     * Send a request and wait for response.
+     */
+    private sendRequest;
+    /**
+     * Send an event notification (fire-and-forget).
+     */
+    sendEvent(event: EngineEvent): void;
+    /**
+     * Call a resolver.
+     */
+    callResolver(name: string, args: string[]): Promise<string>;
+    /**
+     * Call a hook.
+     */
+    callHook(name: keyof PluginHooks, input: Record<string, unknown>, output: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Shutdown the plugin gracefully.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get plugin info.
+     */
+    getPluginInfo(): {
+        name: string;
+        version?: string;
+        permissions?: PluginPermission[];
+    };
+    /**
+     * Get plugin capabilities.
+     */
+    getCapabilities(): {
+        hooks: string[];
+        resolvers: string[];
+        commands: string[];
+    };
+    /**
+     * Check if the plugin is initialized.
+     */
+    isInitialized(): boolean;
+}
+/**
+ * Create a TreqPlugin wrapper for a subprocess plugin.
+ */
+export declare function createSubprocessPluginWrapper(subprocessPlugin: SubprocessPlugin): TreqPlugin;
+/**
+ * Load and initialize a subprocess plugin.
+ */
+export declare function loadSubprocessPlugin(config: SubprocessPluginConfig, projectRoot: string): Promise<LoadedPlugin>;
+//# sourceMappingURL=subprocess.d.ts.map

package/dist/plugin/subprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess.d.ts","sourceRoot":"","sources":["../../src/plugin/subprocess.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAEV,YAAY,EACZ,WAAW,EACX,gBAAgB,EAMhB,sBAAsB,EAGtB,UAAU,EACX,MAAM,SAAS,CAAC;AAoCjB;;;GAGG;AACH,qBAAa,gBAAgB;IAmBzB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,WAAW;IAnBrB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAI2B;IAC/C,OAAO,CAAC,UAAU,CAIM;gBAGd,MAAM,EAAE,sBAAsB,EAC9B,WAAW,EAAE,MAAM;IAG7B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;YACW,KAAK;IAoCnB;;OAEG;YACW,UAAU;IAiDxB;;OAEG;IACH,OAAO,CAAC,YAAY;IA6BpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAwBnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;OAEG;YACW,WAAW;IAyBzB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAOnC;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBjE;;OAEG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,WAAW,EACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAsBnC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA+B/B;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAA;KAAE;IAIrF;;OAEG;IACH,eAAe,IAAI;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IAI/E;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB;AAMD;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,UAAU,CA8J5F;AA4CD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,sBAAsB,EAC9B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CAcvB"}