@hachej/boring-workspace 0.1.16 → 0.1.18

package/dist/app-server.d.ts

@@ -1,9 +1,44 @@
-import { PiPackageSource, CreateAgentAppOptions } from '@hachej/boring-agent/server';
+import { PiPackageSource, PiExtensionFactory, CreateAgentAppOptions } from '@hachej/boring-agent/server';
 export { PiPackageSource as WorkspacePiPackageSource } from '@hachej/boring-agent/server';
 import { FastifyInstance } from 'fastify';
-import { S as ServerBootstrapOptions, c as createInMemoryBridge, W as WorkspaceServerPlugin, a as WorkspaceProvisioningContribution, b as WorkspaceRouteContribution } from './bootstrapServer-BreQ9QBc.js';
-export { C as ComposeServerPluginsOptions, d as composeServerPlugins, e as defineServerPlugin } from './bootstrapServer-BreQ9QBc.js';
-import './agent-tool-DEtfQPVB.js';
+import { W as WorkspaceServerPlugin, S as ServerBootstrapOptions, a as WorkspaceProvisioningContribution, b as WorkspaceRouteContribution, c as createInMemoryBridge } from './createInMemoryBridge-BDxDzihm.js';
+import './ui-bridge-Gfh1MMgl.js';
+
+/**
+ * Directory-source entry: `{ dir, options?, hotReload? }`. Resolved via
+ * jiti when `hotReload: true`, native `import()` otherwise.
+ */
+interface DirPluginEntry {
+    dir: string;
+    options?: unknown;
+    hotReload?: boolean;
+}
+/**
+ * Context the resolver hands to plugin factories. Same shape as the
+ * top-level `WorkspaceAgentServerPluginContext` (workspaceRoot + bridge)
+ * — keeping a single name here would create a circular type import,
+ * but the structural type is identical and callers cast between them.
+ */
+interface PluginResolveContext {
+    workspaceRoot: string;
+    bridge: unknown;
+}
+/**
+ * Returns true when a directory-source package has an importable server entry.
+ * Missing package.json, unsafe explicit entries, and declared-but-missing
+ * entries still throw — only the legitimate "front/Pi-only package" case
+ * (no manifest server) returns false.
+ */
+declare function hasDirServerPlugin(entry: DirPluginEntry): boolean;
+/**
+ * Single dispatch point for any entry shape:
+ *   - WorkspaceServerPlugin object → pass through
+ *   - DirPluginEntry → jiti/import + factory
+ *
+ * Used by both initial install (createWorkspaceAgentServer) and rebuild
+ * (rebuildServerPlugins) so the dispatch lives in one place.
+ */
+declare function resolveOnePluginEntry<TPlugin extends WorkspaceServerPlugin>(entry: unknown, ctx: PluginResolveContext): Promise<TPlugin>;
 
 /**
  * Standalone workspace + agent Fastify composition.
@@ -12,39 +47,99 @@ import './agent-tool-DEtfQPVB.js';
  * workspace entrypoints must not.
  */
 
-interface WorkspaceAgentResourceLoaderOptions {
+type HostExtensionFactory = PiExtensionFactory;
+interface WorkspaceAgentPiOptions {
     noContextFiles?: boolean;
     noSkills?: boolean;
     additionalSkillPaths?: string[];
-    piPackages?: PiPackageSource[];
+    packages?: PiPackageSource[];
+    extensionPaths?: string[];
+    extensionFactories?: HostExtensionFactory[];
 }
-type WorkspaceAgentCreateOptions = Omit<CreateAgentAppOptions, "resourceLoaderOptions"> & {
-    resourceLoaderOptions?: WorkspaceAgentResourceLoaderOptions;
+type WorkspaceAgentCreateOptions = Omit<CreateAgentAppOptions, "pi"> & {
+    pi?: WorkspaceAgentPiOptions;
 };
 interface WorkspaceAgentServerPluginContext {
     workspaceRoot: string;
     bridge: ReturnType<typeof createInMemoryBridge>;
 }
-type WorkspaceAgentServerPluginFactory = (context: WorkspaceAgentServerPluginContext) => WorkspaceServerPlugin;
-interface CreateWorkspaceAgentServerOptions extends WorkspaceAgentCreateOptions, Pick<ServerBootstrapOptions, "plugins" | "defaults" | "excludeDefaults"> {
-    pluginFactories?: WorkspaceAgentServerPluginFactory[];
+/**
+ * Single install entry type. Accepts:
+ *  - `WorkspaceServerPlugin` — pre-built plugin object.
+ *  - `{ dir, options?, hotReload? }` — directory-source plugin resolved
+ *     via explicit package.json#boring.server. Declared-but-missing throws.
+ *     hotReload uses jiti for diagnostic re-imports, while route/tool
+ *     registration is still boot-time.
+ */
+type WorkspacePluginEntry = WorkspaceServerPlugin | DirPluginEntry;
+interface CreateWorkspaceAgentServerOptions extends WorkspaceAgentCreateOptions, Pick<ServerBootstrapOptions, "defaults" | "excludeDefaults"> {
+    /**
+     * Plugins to install. Accepts pre-built `WorkspaceServerPlugin` objects
+     * or `{ dir, options?, hotReload? }` directory-source entries.
+     */
+    plugins?: WorkspacePluginEntry[];
     provisionWorkspace?: boolean;
     workspaceProvisioning?: {
         force?: boolean;
     };
     validateUiPaths?: boolean;
+    /**
+     * Whether live plugin reload endpoints refresh discovered package plugins.
+     * When true, chat `/reload` refreshes package front/Pi metadata and reports
+     * static-server restart warnings; dir-source server entries are re-imported
+     * for diagnostics only. When false, initial static discovery still runs, but
+     * dynamic Pi/system-prompt refresh and `POST /api/boring.reload` are disabled.
+     * Defaults to true.
+     */
+    pluginHotReload?: boolean;
+    /**
+     * App-default plugin packages (by npm name OR absolute filesystem path).
+     * Each entry is resolved at boot, registered as a Pi package (so Pi sees
+     * its skills/extensions/prompts), and discovered by the
+     * `BoringPluginAssetManager` (so the workspace sees its
+     * package.json#boring contributions). One declaration, both sides.
+     *
+     * Equivalent to the user manually placing each package under
+     * `.pi/extensions/<name>/` and `pi install`-ing it — done programmatically
+     * at app boot. Combined with `.pi/extensions/<name>/` (user-added) and
+     * any `pi install npm:<pkg>` packages, all three flow through the same
+     * load process.
+     */
+    defaultPluginPackages?: string[];
+    /**
+     * Absolute path to the app's `package.json`. When passed, the workspace
+     * reads `package.json#boring.defaultPluginPackages: string[]` from it
+     * and merges those entries with anything passed in
+     * `defaultPluginPackages`. Relative entries in package.json resolve
+     * against the package.json's own directory.
+     *
+     * Example app `package.json`:
+     *
+     *     {
+     *       "name": "my-app",
+     *       "boring": {
+     *         "defaultPluginPackages": [
+     *           "@hachej/boring-ask-user",
+     *           "./src/plugins/playgroundDataCatalog"
+     *         ]
+     *       }
+     *     }
+     *
+     * Lets apps declare their plugin set in the canonical app manifest
+     * instead of inside the server boot path.
+     */
+    appPackageJsonPath?: string;
 }
-
 interface WorkspaceAgentServerPluginCollection {
     provisioningContributions: WorkspaceProvisioningContribution[];
     routeContributions: WorkspaceRouteContribution[];
     preservedUiStateKeys: string[];
-    agentOptions: Pick<WorkspaceAgentCreateOptions, "extraTools" | "systemPromptAppend" | "resourceLoaderOptions">;
+    agentOptions: Pick<WorkspaceAgentCreateOptions, "extraTools" | "systemPromptAppend" | "pi">;
 }
 interface CollectWorkspaceAgentServerPluginsOptions extends Pick<ServerBootstrapOptions, "plugins" | "defaults" | "excludeDefaults"> {
     workspaceRoot?: string;
     systemPromptAppend?: string;
-    resourceLoaderOptions?: WorkspaceAgentResourceLoaderOptions;
+    pi?: WorkspaceAgentPiOptions;
 }
 declare function buildWorkspaceContextPrompt(): string;
 declare function collectWorkspaceAgentServerPlugins(opts?: CollectWorkspaceAgentServerPluginsOptions): WorkspaceAgentServerPluginCollection;
@@ -53,6 +148,26 @@ declare function provisionWorkspaceAgentServer(opts: {
     provisioningContributions?: WorkspaceProvisioningContribution[];
     force?: boolean;
 }): Promise<void>;
+interface WorkspacePluginPackagePiSnapshot {
+    additionalSkillPaths: string[];
+    packages: PiPackageSource[];
+    extensionPaths: string[];
+    systemPromptAppend?: string;
+}
+declare function readWorkspacePluginPackagePiSnapshot(pluginDirs: string[]): WorkspacePluginPackagePiSnapshot;
 declare function createWorkspaceAgentServer(opts?: CreateWorkspaceAgentServerOptions): Promise<FastifyInstance>;
 
-export { type CollectWorkspaceAgentServerPluginsOptions, type CreateWorkspaceAgentServerOptions, type WorkspaceAgentResourceLoaderOptions, type WorkspaceAgentServerPluginCollection, type WorkspaceAgentServerPluginContext, type WorkspaceAgentServerPluginFactory, WorkspaceProvisioningContribution, WorkspaceRouteContribution, WorkspaceServerPlugin, buildWorkspaceContextPrompt, collectWorkspaceAgentServerPlugins, createWorkspaceAgentServer, provisionWorkspaceAgentServer };
+interface ResolveDefaultWorkspacePluginPackagePathsOptions {
+    workspaceRoot?: string;
+    defaultPluginPackages?: string[];
+    appPackageJsonPath?: string;
+}
+/**
+ * Resolve app-default plugin package declarations exactly once for app hosts.
+ * This is shared by standalone workspace-agent and core composition so both
+ * read `package.json#boring.defaultPluginPackages` with the same relative-path
+ * and package-name semantics.
+ */
+declare function resolveDefaultWorkspacePluginPackagePaths({ workspaceRoot, defaultPluginPackages, appPackageJsonPath, }?: ResolveDefaultWorkspacePluginPackagePathsOptions): string[];
+
+export { type CollectWorkspaceAgentServerPluginsOptions, type CreateWorkspaceAgentServerOptions, type DirPluginEntry, type PluginResolveContext, type ResolveDefaultWorkspacePluginPackagePathsOptions, type WorkspaceAgentPiOptions, type WorkspaceAgentServerPluginCollection, type WorkspaceAgentServerPluginContext, type WorkspacePluginEntry, type WorkspacePluginPackagePiSnapshot, WorkspaceProvisioningContribution, WorkspaceRouteContribution, buildWorkspaceContextPrompt, collectWorkspaceAgentServerPlugins, createWorkspaceAgentServer, hasDirServerPlugin, provisionWorkspaceAgentServer, readWorkspacePluginPackagePiSnapshot, resolveDefaultWorkspacePluginPackagePaths, resolveOnePluginEntry };