@hachej/boring-workspace 0.1.33 → 0.1.34

package/dist/{createInMemoryBridge-HJopAIbo.d.ts → createInMemoryBridge-zb8MpO60.d.ts}

@@ -46,11 +46,20 @@ interface BoringPluginListEntry$1 {
     frontTarget?: BoringPluginFrontTarget$1;
 }
 
+type BoringPluginSourceKind = "internal" | "external";
+interface BoringPluginSource {
+    rootDir: string;
+    kind: BoringPluginSourceKind;
+    workspaceId?: string;
+}
+type BoringPluginSourceInput = string | BoringPluginSource;
 interface BoringServerPluginManifest {
     id: string;
     rootDir: string;
     version: string;
     boring: BoringPackageBoringField;
+    /** True when package.json explicitly declares a boring manifest. Pi-only packages remain valid Pi resources but are not listed as Boring plugins. */
+    hasBoring: boolean;
     pi?: BoringPackagePiField;
     frontPath?: string;
     /** Legacy Vite-dev browser import fallback (`/@fs/...`). */
@@ -58,6 +67,7 @@ interface BoringServerPluginManifest {
     serverPath?: string;
     extensionPaths?: string[];
     skillPaths?: string[];
+    source: BoringPluginSource;
 }
 type BoringPluginNativeFrontTargetTrust = BoringPluginNativeFrontTargetTrust$1;
 type BoringPluginNativeFrontTarget = BoringPluginNativeFrontTarget$1;
@@ -168,4 +178,4 @@ declare function bootstrapServer(options: ServerBootstrapOptions): ServerBootstr
 
 declare function createInMemoryBridge(): UiBridge;
 
-export { type BoringPluginFrontTargetResolver as B, type PluginRestartSurface as P, type ServerBootstrapOptions as S, type WorkspaceServerPlugin as W, type WorkspaceProvisioningContribution as a, type WorkspaceRouteContribution as b, createInMemoryBridge as c, type WorkspaceRuntimeProvisioningInput as d, type WorkspaceServerPluginAsset as e, type BoringServerPluginManifest as f, type BoringPluginListEntry as g, type BoringPluginFrontTarget as h, type BoringPluginEvent as i, type BoringPluginFrontTargetResolverContext as j, type BoringPluginNativeFrontTarget as k, type BoringPluginNativeFrontTargetTrust as l, type ServerBootstrapResult as m, bootstrapServer as n, defineServerPlugin as o, validateServerPlugin as v };
+export { type BoringPluginSourceInput as B, type PluginRestartSurface as P, type ServerBootstrapOptions as S, type WorkspaceServerPlugin as W, type BoringPluginFrontTargetResolver as a, type WorkspaceProvisioningContribution as b, type WorkspaceRouteContribution as c, createInMemoryBridge as d, type WorkspaceRuntimeProvisioningInput as e, type WorkspaceServerPluginAsset as f, type BoringServerPluginManifest as g, type BoringPluginListEntry as h, type BoringPluginFrontTarget as i, type BoringPluginSource as j, type BoringPluginEvent as k, type BoringPluginFrontTargetResolverContext as l, type BoringPluginNativeFrontTarget as m, type BoringPluginNativeFrontTargetTrust as n, type BoringPluginSourceKind as o, type ServerBootstrapResult as p, bootstrapServer as q, defineServerPlugin as r, validateServerPlugin as v };

package/dist/runtime-server.d.ts

@@ -0,0 +1,47 @@
+interface PluginLogger {
+    debug(fields: Record<string, unknown>, message?: string): void;
+    debug(message: string): void;
+    info(fields: Record<string, unknown>, message?: string): void;
+    info(message: string): void;
+    warn(fields: Record<string, unknown>, message?: string): void;
+    warn(message: string): void;
+    error(fields: Record<string, unknown>, message?: string): void;
+    error(message: string): void;
+}
+type ReadonlyHeaders = Pick<Headers, "entries" | "forEach" | "get" | "has" | typeof Symbol.iterator>;
+interface RuntimePluginContext {
+    pluginId: string;
+    method: string;
+    path: string;
+    query: URLSearchParams;
+    headers: ReadonlyHeaders;
+    signal: AbortSignal;
+    body: unknown;
+    logger: PluginLogger;
+}
+type RuntimePluginHandler = (ctx: RuntimePluginContext) => unknown | Promise<unknown>;
+interface RuntimePluginRouter {
+    get(path: string, handler: RuntimePluginHandler): void;
+    post(path: string, handler: RuntimePluginHandler): void;
+    put(path: string, handler: RuntimePluginHandler): void;
+    patch(path: string, handler: RuntimePluginHandler): void;
+    delete(path: string, handler: RuntimePluginHandler): void;
+    head(path: string, handler: RuntimePluginHandler): void;
+    options(path: string, handler: RuntimePluginHandler): void;
+    all(path: string, handler: RuntimePluginHandler): void;
+}
+interface RuntimePluginResponse {
+    kind: "response";
+    status?: number;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+interface RuntimeServerPlugin {
+    routes(router: RuntimePluginRouter): void | Promise<void>;
+    dispose?(): void | Promise<void>;
+}
+declare function defineRuntimeServerPlugin(plugin: RuntimeServerPlugin): RuntimeServerPlugin;
+declare function validateRuntimeServerPlugin(value: unknown): RuntimeServerPlugin;
+declare function isRuntimePluginResponse(value: unknown): value is RuntimePluginResponse;
+
+export { type PluginLogger, type ReadonlyHeaders, type RuntimePluginContext, type RuntimePluginHandler, type RuntimePluginResponse, type RuntimePluginRouter, type RuntimeServerPlugin, defineRuntimeServerPlugin, isRuntimePluginResponse, validateRuntimeServerPlugin };

package/dist/runtime-server.js

@@ -0,0 +1,32 @@
+// src/server/runtimeBackend/defineRuntimeServerPlugin.ts
+function defineRuntimeServerPlugin(plugin) {
+  return plugin;
+}
+function isPlainObject(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+function validateRuntimeServerPlugin(value) {
+  if (!isPlainObject(value)) {
+    throw new Error("runtime server plugin default export must be a plain object");
+  }
+  if ("id" in value) {
+    throw new Error("runtime server plugin must not declare id; the host supplies plugin id from package metadata");
+  }
+  if (typeof value.routes !== "function") {
+    throw new Error("runtime server plugin default export must define routes(router)");
+  }
+  if (value.dispose !== void 0 && typeof value.dispose !== "function") {
+    throw new Error("runtime server plugin dispose must be a function when provided");
+  }
+  return value;
+}
+function isRuntimePluginResponse(value) {
+  return isPlainObject(value) && value.kind === "response";
+}
+export {
+  defineRuntimeServerPlugin,
+  isRuntimePluginResponse,
+  validateRuntimeServerPlugin
+};

package/dist/server.d.ts

@@ -1,10 +1,13 @@
-import { e as WorkspaceServerPluginAsset, f as BoringServerPluginManifest, B as BoringPluginFrontTargetResolver, g as BoringPluginListEntry, h as BoringPluginFrontTarget, i as BoringPluginEvent, P as PluginRestartSurface } from './createInMemoryBridge-HJopAIbo.js';
-export { j as BoringPluginFrontTargetResolverContext, k as BoringPluginNativeFrontTarget, l as BoringPluginNativeFrontTargetTrust, S as ServerBootstrapOptions, m as ServerBootstrapResult, a as WorkspaceProvisioningContribution, b as WorkspaceRouteContribution, W as WorkspaceServerPlugin, n as bootstrapServer, c as createInMemoryBridge, o as defineServerPlugin, v as validateServerPlugin } from './createInMemoryBridge-HJopAIbo.js';
+import { f as WorkspaceServerPluginAsset, g as BoringServerPluginManifest, B as BoringPluginSourceInput, a as BoringPluginFrontTargetResolver, h as BoringPluginListEntry, i as BoringPluginFrontTarget, j as BoringPluginSource, k as BoringPluginEvent, P as PluginRestartSurface } from './createInMemoryBridge-zb8MpO60.js';
+export { l as BoringPluginFrontTargetResolverContext, m as BoringPluginNativeFrontTarget, n as BoringPluginNativeFrontTargetTrust, o as BoringPluginSourceKind, S as ServerBootstrapOptions, p as ServerBootstrapResult, b as WorkspaceProvisioningContribution, c as WorkspaceRouteContribution, W as WorkspaceServerPlugin, q as bootstrapServer, d as createInMemoryBridge, r as defineServerPlugin, v as validateServerPlugin } from './createInMemoryBridge-zb8MpO60.js';
 import { FastifyRequest, FastifyInstance } from 'fastify';
 import { U as UiBridge, A as AgentTool } from './ui-bridge-DFNem0df.js';
 export { C as CommandResult, a as UiCommand, b as UiState } from './ui-bridge-DFNem0df.js';
 import { PiPackageSource } from '@hachej/boring-agent/server';
 export { PiPackageSource as WorkspacePiPackageSource } from '@hachej/boring-agent/server';
+import { PluginLogger } from './runtime-server.js';
+export { RuntimePluginContext, RuntimePluginHandler, RuntimePluginResponse, RuntimePluginRouter, RuntimeServerPlugin, defineRuntimeServerPlugin, validateRuntimeServerPlugin } from './runtime-server.js';
+import { ErrorCode } from '@hachej/boring-agent/shared';
 import './manifest-C2vVgH_e.js';
 
 declare function definePluginAsset(importMetaUrl: string, name: string, relativeSource: string, options?: {
@@ -171,12 +174,12 @@ interface BoringPluginScanResult {
     preflight: BoringPluginPreflightResult;
     plugins: BoringServerPluginManifest[];
 }
-declare function scanBoringPlugins(pluginDirs: string[]): BoringPluginScanResult;
-declare function preflightBoringPlugins(pluginDirs: string[]): BoringPluginPreflightResult;
-declare function readBoringPlugins(pluginDirs: string[]): BoringServerPluginManifest[];
+declare function scanBoringPlugins(pluginDirs: BoringPluginSourceInput[]): BoringPluginScanResult;
+declare function preflightBoringPlugins(pluginDirs: BoringPluginSourceInput[]): BoringPluginPreflightResult;
+declare function readBoringPlugins(pluginDirs: BoringPluginSourceInput[]): BoringServerPluginManifest[];
 
 interface BoringPluginAssetManagerOptions {
-    pluginDirs: string[];
+    pluginDirs: BoringPluginSourceInput[];
     /**
      * Root directory for per-plugin `.error` sidecar files written by the
      * asset manager and read by verify-plugin. Defaults to `<cwd>/.pi/extensions`.
@@ -212,6 +215,8 @@ interface LoadedBoringPluginInspection {
     rootDir: string;
     frontPath?: string;
     frontTarget?: BoringPluginFrontTarget;
+    serverPath?: string;
+    source: BoringPluginSource;
 }
 interface LoadedBoringPluginPiSnapshot {
     additionalSkillPaths: string[];
@@ -253,14 +258,6 @@ declare class BoringPluginAssetManager {
     private clearError;
 }
 
-interface PluginReloadRebuild {
-    ok: boolean;
-    diagnostics: {
-        source: string;
-        message: string;
-        pluginId?: string;
-    }[];
-}
 /**
  * One per plugin whose load event carried a non-empty
  * `requiresRestart` field. Surfaced alongside the /reload response so
@@ -281,16 +278,6 @@ interface PluginRestartWarning {
 declare function collectRestartWarnings(events: BoringPluginEvent[]): PluginRestartWarning[];
 interface BoringPluginRoutesOptions {
     manager: BoringPluginAssetManager;
-    /**
-     * Server-side plugin rebuild closure (jiti re-import of dir-source
-     * entries). Called AFTER the asset manager scan. Per-plugin failures
-     * surface as diagnostics; combined with asset-manager errors into the
-     * 422 response body so the agent's /reload UI can show them. Optional —
-     * tests that exercise the route in isolation can omit it.
-     */
-    rebuildPlugins?: () => Promise<PluginReloadRebuild>;
-    /** Register the developer reload endpoint. Static discovery/listing remains available when false. */
-    enableReloadRoute?: boolean;
 }
 declare function boringPluginRoutes(app: FastifyInstance, opts: BoringPluginRoutesOptions): Promise<void>;
 
@@ -327,4 +314,55 @@ declare function pluginFileSignature(path: string | undefined): string;
 declare function writePluginSignatureCache(pluginRootDir: string, payload: Omit<PluginSignatureCachePayload, "version" | "loadedAt"> & Partial<Pick<PluginSignatureCachePayload, "loadedAt">>): void;
 declare function readPluginSignatureCache(pluginRootDir: string): PluginSignatureCachePayload | null;
 
-export { BoringPluginAssetManager, BoringPluginEvent, BoringPluginFrontTarget, BoringPluginFrontTargetResolver, BoringPluginListEntry, type BoringPluginScanResult, BoringServerPluginManifest, type PluginReloadRebuild, type PluginRestartWarning, UiBridge, type UiRoutesOptions, WorkspaceServerPluginAsset, aggregatePluginPrompts, boringPluginRoutes, buildBoringSystemPrompt, collectRestartWarnings, createExecUiTool, createGetUiStateTool, createWorkspaceUiTools, definePluginAsset, pluginFileSignature, preflightBoringPlugins, readBoringPlugins, readPluginSignatureCache, resolvePluginAssetPath, scanBoringPlugins, uiRoutes, writePluginSignatureCache };
+interface RuntimeBackendDiagnostic {
+    pluginId?: string;
+    source: string;
+    code: ErrorCode;
+    message: string;
+}
+interface RuntimeBackendReloadResult {
+    ok: boolean;
+    diagnostics: RuntimeBackendDiagnostic[];
+}
+interface RuntimeBackendDispatchRequest {
+    pluginId: string;
+    method: string;
+    path: string;
+    query: URLSearchParams;
+    headers: Headers;
+    signal: AbortSignal;
+    body: unknown;
+    logger: PluginLogger;
+    workspaceId?: string;
+}
+interface RuntimeBackendDispatchResponse {
+    status: number;
+    headers: Record<string, string>;
+    body?: unknown;
+}
+declare class RuntimeBackendError extends Error {
+    readonly code: ErrorCode;
+    readonly statusCode: number;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: ErrorCode, statusCode: number, message: string, details?: Record<string, unknown> | undefined);
+}
+declare class RuntimeBackendRegistry {
+    private readonly snapshots;
+    private lastDiagnostics;
+    private reloadQueue;
+    getDiagnostics(): RuntimeBackendDiagnostic[];
+    listPluginIds(): string[];
+    reloadFromLoadedPlugins(plugins: LoadedBoringPluginInspection[]): Promise<RuntimeBackendReloadResult>;
+    close(): Promise<RuntimeBackendReloadResult>;
+    dispatch(request: RuntimeBackendDispatchRequest): Promise<RuntimeBackendDispatchResponse>;
+    private reloadOnce;
+    private closeOnce;
+}
+
+interface RuntimeBackendGatewayOptions {
+    registry: RuntimeBackendRegistry;
+    defaultWorkspaceId?: string;
+}
+declare function runtimeBackendGateway(app: FastifyInstance, opts: RuntimeBackendGatewayOptions): Promise<void>;
+
+export { BoringPluginAssetManager, BoringPluginEvent, BoringPluginFrontTarget, BoringPluginFrontTargetResolver, BoringPluginListEntry, type BoringPluginScanResult, BoringPluginSource, BoringPluginSourceInput, BoringServerPluginManifest, type PluginRestartWarning, type RuntimeBackendDiagnostic, type RuntimeBackendDispatchRequest, type RuntimeBackendDispatchResponse, RuntimeBackendError, type RuntimeBackendGatewayOptions, RuntimeBackendRegistry, type RuntimeBackendReloadResult, UiBridge, type UiRoutesOptions, WorkspaceServerPluginAsset, aggregatePluginPrompts, boringPluginRoutes, buildBoringSystemPrompt, collectRestartWarnings, createExecUiTool, createGetUiStateTool, createWorkspaceUiTools, definePluginAsset, pluginFileSignature, preflightBoringPlugins, readBoringPlugins, readPluginSignatureCache, resolvePluginAssetPath, runtimeBackendGateway, scanBoringPlugins, uiRoutes, writePluginSignatureCache };