@hachej/boring-agent 0.1.17 → 0.1.20

package/dist/front/styles.css

@@ -211,6 +211,9 @@
   .ml-2 {
     margin-left: calc(var(--spacing) * 2);
   }
+  .ml-4 {
+    margin-left: calc(var(--spacing) * 4);
+  }
   .ml-auto {
     margin-left: auto;
   }
@@ -307,6 +310,9 @@
   .\!h-9 {
     height: calc(var(--spacing) * 9) !important;
   }
+  .h-2 {
+    height: calc(var(--spacing) * 2);
+  }
   .h-3 {
     height: calc(var(--spacing) * 3);
   }
@@ -373,6 +379,9 @@
   .w-1\/4 {
     width: calc(1 / 4 * 100%);
   }
+  .w-2 {
+    width: calc(var(--spacing) * 2);
+  }
   .w-3 {
     width: calc(var(--spacing) * 3);
   }
@@ -494,6 +503,9 @@
   .resize-none {
     resize: none;
   }
+  .list-disc {
+    list-style-type: disc;
+  }
   .grid-cols-1 {
     grid-template-columns: repeat(1, minmax(0, 1fr));
   }
@@ -720,6 +732,15 @@
       border-color: color-mix(in oklab, var(--input) 80%, transparent) !important;
     }
   }
+  .border-\[oklch\(0\.78_0\.13_148\)\]\/35 {
+    border-color: color-mix(in oklab, oklch(0.78 0.13 148) 35%, transparent);
+  }
+  .border-\[oklch\(0\.78_0\.13_148\)\]\/40 {
+    border-color: color-mix(in oklab, oklch(0.78 0.13 148) 40%, transparent);
+  }
+  .border-\[oklch\(0\.78_0\.15_85\)\]\/40 {
+    border-color: color-mix(in oklab, oklch(0.78 0.15 85) 40%, transparent);
+  }
   .border-\[var\(--boring-agent-code-border\,\#404040\)\] {
     border-color: var(--boring-agent-code-border,#404040);
   }
@@ -732,6 +753,12 @@
   .border-\[var\(--boring-agent-tool-border\,\#e5e7eb\)\] {
     border-color: var(--boring-agent-tool-border,#e5e7eb);
   }
+  .border-accent\/30 {
+    border-color: var(--accent);
+    @supports (color: color-mix(in lab, red, red)) {
+      border-color: color-mix(in oklab, var(--accent) 30%, transparent);
+    }
+  }
   .border-accent\/40 {
     border-color: var(--accent);
     @supports (color: color-mix(in lab, red, red)) {
@@ -804,6 +831,9 @@
       border-color: color-mix(in oklab, var(--primary) 30%, transparent);
     }
   }
+  .border-transparent {
+    border-color: transparent;
+  }
   .\!bg-destructive\/10 {
     background-color: var(--destructive) !important;
     @supports (color: color-mix(in lab, red, red)) {
@@ -843,6 +873,15 @@
   .bg-\[color\:var\(--surface-chat\)\] {
     background-color: var(--surface-chat);
   }
+  .bg-\[oklch\(0\.95_0\.05_148\/0\.3\)\] {
+    background-color: oklch(0.95 0.05 148/0.3);
+  }
+  .bg-\[oklch\(0\.95_0\.05_148\/0\.25\)\] {
+    background-color: oklch(0.95 0.05 148/0.25);
+  }
+  .bg-\[oklch\(0\.95_0\.06_85\/0\.4\)\] {
+    background-color: oklch(0.95 0.06 85/0.4);
+  }
   .bg-\[oklch\(from_var\(--accent\)_l_c_h\/0\.08\)\] {
     background-color: oklch(from var(--accent) l c h/0.08);
   }
@@ -1358,6 +1397,12 @@
   .text-\[color\:var\(--accent-foreground\)\] {
     color: var(--accent-foreground);
   }
+  .text-\[oklch\(0\.45_0\.13_148\)\] {
+    color: oklch(0.45 0.13 148);
+  }
+  .text-\[oklch\(0\.48_0\.15_60\)\] {
+    color: oklch(0.48 0.15 60);
+  }
   .text-\[var\(--boring-agent-code-fg\,\#d4d4d4\)\] {
     color: var(--boring-agent-code-fg,#d4d4d4);
   }
@@ -1430,6 +1475,12 @@
   .text-foreground {
     color: var(--foreground);
   }
+  .text-foreground\/70 {
+    color: var(--foreground);
+    @supports (color: color-mix(in lab, red, red)) {
+      color: color-mix(in oklab, var(--foreground) 70%, transparent);
+    }
+  }
   .text-foreground\/80 {
     color: var(--foreground);
     @supports (color: color-mix(in lab, red, red)) {
@@ -1935,6 +1986,16 @@
       }
     }
   }
+  .hover\:bg-destructive\/10 {
+    &:hover {
+      @media (hover: hover) {
+        background-color: var(--destructive);
+        @supports (color: color-mix(in lab, red, red)) {
+          background-color: color-mix(in oklab, var(--destructive) 10%, transparent);
+        }
+      }
+    }
+  }
   .hover\:bg-destructive\/15 {
     &:hover {
       @media (hover: hover) {

package/dist/{tool-ui-DSmWuqGe.d.ts → harness-DRrTn_5T.d.ts}

@@ -29,6 +29,46 @@ interface SessionDetail extends SessionSummary {
     messages: UIMessage[];
 }
 
+type JSONSchema = Record<string, unknown>;
+interface AgentTool {
+    name: string;
+    description: string;
+    /** Optional one-line prompt entry. Pi-built tools should preserve pi's snippet verbatim. */
+    promptSnippet?: string;
+    parameters: JSONSchema;
+    execute(params: Record<string, unknown>, ctx: ToolExecContext): Promise<ToolResult>;
+}
+interface ToolExecContext {
+    abortSignal: AbortSignal;
+    toolCallId: string;
+    onUpdate?: (partial: string) => void;
+    /** Agent chat/session id executing this tool, when known. */
+    sessionId?: string;
+}
+interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+    details?: unknown;
+}
+
+interface AgentHarnessFactoryInput {
+    tools: AgentTool[];
+    cwd: string;
+    systemPromptAppend?: string;
+    sessionNamespace?: string;
+    sessionDir?: string;
+    /**
+     * Optional dynamic system-prompt source. Harness calls it whenever it
+     * builds or rebuilds a session prompt and appends the returned string.
+     * Workspace plugin layer wires this so live-reloaded plugins can contribute
+     * prompt context without a workspace-injected harness extension.
+     */
+    systemPromptDynamic?: () => string | undefined | Promise<string | undefined>;
+}
+type AgentHarnessFactory = (input: AgentHarnessFactoryInput) => AgentHarness | Promise<AgentHarness>;
 interface AgentHarness {
     readonly id: string;
     readonly placement: 'server' | 'browser';
@@ -58,6 +98,8 @@ interface AgentHarness {
      * client message, implementations should remove only that item if possible.
      */
     clearFollowUp?(sessionId: string, options?: FollowUpOptions): void;
+    /** Reload native agent resources/extensions for an existing session. */
+    reloadSession?: (sessionId: string) => Promise<boolean>;
 }
 interface FollowUpOptions {
     clientNonce?: string;
@@ -85,27 +127,4 @@ interface RunContext {
     userId?: string;
 }
 
-interface ToolUiMetadata {
-    /** Renderer key registered by the app shell, e.g. `pi-subagent`. */
-    rendererId?: string;
-    /** Optional grouping label for future tool timelines/summaries. */
-    displayGroup?: string;
-    /** Optional icon hint. Frontends decide whether/how to honor it. */
-    icon?: string;
-    /** Renderer-specific structured data. */
-    details?: unknown;
-}
-declare function isToolUiMetadata(value: unknown): value is ToolUiMetadata;
-/**
- * Extract structured UI metadata from a ToolResult-like output.
- *
- * Preferred shape:
- *   output.details.ui = { rendererId, displayGroup, icon, details }
- *
- * Compatibility shape for early overlays:
- *   output.details.uiKind = 'pi-subagent'
- *   output.details = { uiKind, ...rendererDetails }
- */
-declare function extractToolUiMetadata(output: unknown): ToolUiMetadata | undefined;
-
-export { type AgentHarness as A, type RunContext as R, type SendMessageInput as S, type ToolUiMetadata as T, type SessionCtx as a, type SessionDetail as b, type SessionStore as c, type SessionSummary as d, extractToolUiMetadata as e, isToolUiMetadata as i };
+export type { AgentTool as A, JSONSchema as J, RunContext as R, SendMessageInput as S, ToolExecContext as T, AgentHarness as a, SessionCtx as b, SessionDetail as c, SessionStore as d, SessionSummary as e, ToolResult as f, AgentHarnessFactory as g, AgentHarnessFactoryInput as h };

package/dist/server/index.d.ts

@@ -1,7 +1,10 @@
-import { S as Sandbox, f as SandboxHandleStore, e as SandboxHandleRecord, W as Workspace, F as FileSearch, A as AgentTool } from '../sandbox-handle-store-hK76cTjn.js';
+import { S as Sandbox, f as SandboxHandleStore, e as SandboxHandleRecord, W as Workspace, F as FileSearch, P as PluginRestartWarning } from '../agentPluginEvents-zyIvVjsA.js';
 import { Sandbox as Sandbox$1 } from '@vercel/sandbox';
 import { FastifyInstance, FastifyRequest, FastifyPluginAsync } from 'fastify';
-import { PackageSource } from '@mariozechner/pi-coding-agent';
+import { A as AgentTool, g as AgentHarnessFactory } from '../harness-DRrTn_5T.js';
+export { h as AgentHarnessFactoryInput } from '../harness-DRrTn_5T.js';
+import { PackageSource, ExtensionFactory, SettingsManager } from '@mariozechner/pi-coding-agent';
+import 'ai';
 
 declare function createDirectSandbox(): Sandbox;
 
@@ -192,9 +195,17 @@ interface RuntimePythonSpec {
     /** Env vars exported by command shims, e.g. plugin builtin paths. */
     env?: Record<string, string | URL>;
 }
+interface RuntimeNodePackageSpec {
+    id: string;
+    /** Package name materialized under workspaceRoot/node_modules, e.g. @boring/workspace. */
+    packageName: string;
+    /** Source package root. The provisioner copies the built package payload into node_modules. */
+    packageRoot: string | URL;
+}
 interface RuntimeProvisioningContribution {
     templateDirs?: RuntimeTemplateContribution[];
     python?: RuntimePythonSpec[];
+    nodePackages?: RuntimeNodePackageSpec[];
 }
 interface ProvisionRuntimeWorkspaceOptions {
     workspaceRoot: string;
@@ -249,13 +260,30 @@ declare function hasBwrap(): boolean;
 declare function autoDetectMode(): RuntimeModeId;
 declare function resolveMode(mode?: RuntimeModeId): RuntimeModeAdapter;
 
+interface ReloadHookDiagnostic {
+    source: string;
+    message: string;
+    pluginId?: string;
+}
+interface ReloadHookResult {
+    /**
+     * One per plugin that loaded successfully but whose server-side
+     * surfaces (routes, agentTools) still hold pre-reload code. The
+     * /api/v1/agent/reload response surfaces these so the chat UI can
+     * render a "restart needed" banner without subscribing to SSE.
+     */
+    restart_warnings?: ReadonlyArray<PluginRestartWarning>;
+    /** Non-fatal plugin reload diagnostics to surface to the caller/UI. */
+    diagnostics?: ReadonlyArray<ReloadHookDiagnostic>;
+}
+
 type PiPackageSource = PackageSource;
 declare const PI_PACKAGE_RESOURCE_FILTERS: readonly ["extensions", "skills", "prompts", "themes"];
 declare function piPackageSourceKey(source: PiPackageSource): string;
 declare function compactPiPackages(sources: Array<PiPackageSource | undefined>): PiPackageSource[];
 declare function mergePiPackageSources(base?: PiPackageSource[], additional?: PiPackageSource[]): PiPackageSource[];
 
-interface PiResourceLoaderOptions {
+interface PiHarnessOptions {
     noContextFiles?: boolean;
     noSkills?: boolean;
     additionalSkillPaths?: string[];
@@ -264,8 +292,31 @@ interface PiResourceLoaderOptions {
      * These are applied as in-memory SettingsManager overrides, so host/plugin
      * declarations do not mutate .pi/settings.json.
      */
-    piPackages?: PiPackageSource[];
+    packages?: PiPackageSource[];
+    /**
+     * Additional native pi extension entrypoints. Pi loads these through jiti and
+     * re-imports them on ctx.reload(), which is required for hot-reloadable
+     * boring agent plugins.
+     */
+    extensionPaths?: string[];
+    /** In-process host extensions. Use only for trusted built-ins; hot plugin code should use paths. */
+    extensionFactories?: ExtensionFactory[];
+    /**
+     * Optional source of hot-reloadable Pi resources. Pi calls it on every
+     * reloadSession() (and once at session build) and merges the result with
+     * the static fields above. Lets the workspace plugin layer refresh
+     * package.json-discovered skills/packages/extensions without mutating
+     * arrays that the harness already captured.
+     */
+    getHotReloadableResources?: () => HotReloadablePiResources;
+}
+interface HotReloadablePiResources {
+    additionalSkillPaths?: string[];
+    packages?: PiPackageSource[];
+    extensionPaths?: string[];
 }
+type PiExtensionFactory = ExtensionFactory;
+declare function createResourceSettingsManager(cwd: string, agentDir: string, piPackages: PiPackageSource[]): SettingsManager;
 
 interface CreateAgentAppOptions {
     workspaceRoot?: string;
@@ -287,12 +338,27 @@ interface CreateAgentAppOptions {
      * via DefaultResourceLoader's `appendSystemPromptSource`.
      */
     systemPromptAppend?: string;
-    /** Optional pi resource-loader isolation knobs. */
-    resourceLoaderOptions?: PiResourceLoaderOptions;
+    /** Override the default pi-backed harness with a custom agent runtime. */
+    harnessFactory?: AgentHarnessFactory;
+    /** Optional pi adapter/runtime knobs used by the default harness. */
+    pi?: PiHarnessOptions;
     /** Optional stable namespace for file-backed session storage. */
     sessionNamespace?: string;
     /** Optional explicit file-backed session directory. Mostly for tests/hosts. */
     sessionDir?: string;
+    /**
+     * Called BEFORE the harness reloads its session. May return a
+     * `ReloadHookResult` (with `restart_warnings` and/or diagnostics) —
+     * surfaced verbatim on the /api/v1/agent/reload response. `void` /
+     * undefined return = no warnings (backwards compatible).
+     */
+    beforeReload?: () => void | ReloadHookResult | undefined | Promise<void | ReloadHookResult | undefined>;
+    /**
+     * Optional dynamic system-prompt source forwarded to the harness. The
+     * harness calls it whenever it builds or rebuilds a session prompt. Used by
+     * the workspace plugin layer.
+     */
+    systemPromptDynamic?: () => string | undefined | Promise<string | undefined>;
 }
 declare function createAgentApp(opts?: CreateAgentAppOptions): Promise<FastifyInstance>;
 
@@ -324,12 +390,15 @@ interface RegisterAgentRoutesOptions {
         workspaceFsCapability?: Workspace['fsCapability'];
     }) => AgentTool[] | Promise<AgentTool[]>;
     systemPromptAppend?: string;
-    resourceLoaderOptions?: PiResourceLoaderOptions;
-    getResourceLoaderOptions?: (ctx: {
+    /** Override the default pi-backed harness with a custom agent runtime. */
+    harnessFactory?: AgentHarnessFactory;
+    /** Optional pi adapter/runtime knobs used by the default harness. */
+    pi?: PiHarnessOptions;
+    getPi?: (ctx: {
         workspaceId: string;
         workspaceRoot: string;
         request?: FastifyRequest;
-    }) => PiResourceLoaderOptions | undefined | Promise<PiResourceLoaderOptions | undefined>;
+    }) => PiHarnessOptions | undefined | Promise<PiHarnessOptions | undefined>;
     sessionNamespace?: string;
     getSessionNamespace?: (ctx: {
         workspaceId: string;
@@ -361,4 +430,4 @@ interface Logger {
 }
 declare function createLogger(prefix: string): Logger;
 
-export { type BuiltinRuntimeModeId, type CreateAgentAppOptions, type DeploymentSnapshotProvider, type DeploymentSnapshotRecipe, type DeploymentSnapshotResult, type DeploymentSnapshotStatus, FileHandleStore, type LogFields, type Logger, type ModeContext, PI_PACKAGE_RESOURCE_FILTERS, type PiPackageSource, type PiResourceLoaderOptions, type ProvisionRuntimeWorkspaceOptions, type RegisterAgentRoutesOptions, type RuntimeBundle, type RuntimeModeAdapter, type RuntimeModeId, type RuntimeProvisioningContribution, type RuntimePythonSpec, type RuntimeTemplateContribution, type RuntimeWorkspaceProvisioningResult, type SnapshotBakeOptions, type SnapshotBakeResult, UV_SETUP_COMMANDS, UV_SETUP_COMMANDS as VERCEL_UV_SETUP_COMMANDS, type VercelBakeClient, type VercelBakeSandbox, type VercelDeploymentSnapshotOptions, applyCspHeaders, autoDetectMode, bakeSnapshotIfNeeded, buildDeploymentSnapshotRecipe, buildPackageHash, buildSnapshotRecipeHash, compactPiPackages, createAgentApp, createBwrapSandbox, createDirectSandbox, createLogger, createNodeWorkspace, createVercelDeploymentSnapshotProvider, createVercelSandboxWorkspace, fileRoutes, hasBwrap, mergePiPackageSources, piPackageSourceKey, prepareDeploymentSnapshot, prepareVercelDeploymentSnapshot, provisionRuntimeWorkspace, registerAgentRoutes, resolveMode, resolveSandboxHandle };
+export { AgentHarnessFactory, type BuiltinRuntimeModeId, type CreateAgentAppOptions, type DeploymentSnapshotProvider, type DeploymentSnapshotRecipe, type DeploymentSnapshotResult, type DeploymentSnapshotStatus, FileHandleStore, type LogFields, type Logger, type ModeContext, PI_PACKAGE_RESOURCE_FILTERS, type PiExtensionFactory, type PiHarnessOptions, type PiPackageSource, type ProvisionRuntimeWorkspaceOptions, type RegisterAgentRoutesOptions, type RuntimeBundle, type RuntimeModeAdapter, type RuntimeModeId, type RuntimeNodePackageSpec, type RuntimeProvisioningContribution, type RuntimePythonSpec, type RuntimeTemplateContribution, type RuntimeWorkspaceProvisioningResult, type SnapshotBakeOptions, type SnapshotBakeResult, UV_SETUP_COMMANDS, UV_SETUP_COMMANDS as VERCEL_UV_SETUP_COMMANDS, type VercelBakeClient, type VercelBakeSandbox, type VercelDeploymentSnapshotOptions, applyCspHeaders, autoDetectMode, bakeSnapshotIfNeeded, buildDeploymentSnapshotRecipe, buildPackageHash, buildSnapshotRecipeHash, compactPiPackages, createAgentApp, createBwrapSandbox, createDirectSandbox, createLogger, createNodeWorkspace, createResourceSettingsManager, createVercelDeploymentSnapshotProvider, createVercelSandboxWorkspace, fileRoutes, hasBwrap, mergePiPackageSources, piPackageSourceKey, prepareDeploymentSnapshot, prepareVercelDeploymentSnapshot, provisionRuntimeWorkspace, registerAgentRoutes, resolveMode, resolveSandboxHandle };