@hachej/boring-agent 0.1.37 → 0.1.39

package/dist/{agentPluginEvents-DgNc3erX.d.ts → agentPluginEvents-CKrZLW3g.d.ts}

@@ -73,6 +73,17 @@ interface AgentHarness {
     getSystemPrompt?: (sessionId: string) => string | undefined;
     /** Reload native agent resources/extensions for an existing session. */
     reloadSession?: (sessionId: string) => Promise<boolean>;
+    /**
+     * Resource (skill/extension) load diagnostics for an existing session.
+     * Returns `[]` when the session has no live agent session yet. Lets the
+     * /reload route and the `plugin_diagnostics` tool surface silent
+     * skill/extension load failures back to the UI and the agent.
+     */
+    getResourceDiagnostics?: (sessionId: string) => Array<{
+        source: string;
+        message: string;
+        path?: string;
+    }>;
     /** List slash commands registered in the agent runtime for a given session. */
     getSlashCommands?: (sessionId: string, ctx: RunContext) => ReadonlyArray<AgentSlashCommandSummary> | Promise<ReadonlyArray<AgentSlashCommandSummary>>;
     /**

package/dist/front/index.d.ts

@@ -314,6 +314,7 @@ interface RemotePiSessionOptions {
     };
     setTimeoutFn?: typeof globalThis.setTimeout;
     clearTimeoutFn?: typeof globalThis.clearTimeout;
+    requestTimeoutMs?: number;
 }
 interface RemotePiSessionLargeStateWarning {
     type: 'large-state';
@@ -358,6 +359,7 @@ declare class RemotePiSession {
     private readonly storageScope;
     private readonly setTimeoutFn;
     private readonly clearTimeoutFn;
+    private readonly requestTimeoutMs;
     private generation;
     private streamRunId;
     private reconnectAttempt;

package/dist/front/index.js

@@ -4441,6 +4441,7 @@ function schedulePiChatReconnect({
 var SUPPORTED_PROTOCOL_VERSION = 1;
 var DEFAULT_RECONNECT_BASE_MS = 1e3;
 var DEFAULT_RECONNECT_MAX_MS = 3e4;
+var DEFAULT_REQUEST_TIMEOUT_MS = 15e3;
 var DEFAULT_LARGE_STATE_WARNING_BYTES = 5 * 1024 * 1024;
 var DEFAULT_LARGE_STATE_WARNING_MESSAGES = 300;
 var EVENT_TYPE_RING_LIMIT = 20;
@@ -4456,6 +4457,7 @@ var RemotePiSession = class {
     this.fetchImpl = options.fetch ?? globalThis.fetch.bind(globalThis);
     this.setTimeoutFn = options.setTimeoutFn ?? globalThis.setTimeout;
     this.clearTimeoutFn = options.clearTimeoutFn ?? globalThis.clearTimeout;
+    this.requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
     this.store = createPiChatStore(createInitialPiChatState({
       sessionId: options.sessionId,
       workspaceId: options.workspaceId,
@@ -4471,6 +4473,7 @@ var RemotePiSession = class {
   storageScope;
   setTimeoutFn;
   clearTimeoutFn;
+  requestTimeoutMs;
   generation = 0;
   streamRunId = 0;
   reconnectAttempt = 0;
@@ -4631,9 +4634,21 @@ var RemotePiSession = class {
       opened = true;
       onOpen?.();
     };
+    let connectTimedOut = false;
+    let connectTimer = globalThis.setTimeout(() => {
+      connectTimedOut = true;
+      controller.abort();
+    }, this.requestTimeoutMs);
+    const clearConnectTimer = () => {
+      if (connectTimer !== void 0) {
+        globalThis.clearTimeout(connectTimer);
+        connectTimer = void 0;
+      }
+    };
     try {
       const headers = await this.requestHeaders();
       if (!this.isStreamActive(generation, runId)) {
+        clearConnectTimer();
         markOpen();
         return;
       }
@@ -4642,6 +4657,7 @@ var RemotePiSession = class {
         headers,
         signal: controller.signal
       });
+      clearConnectTimer();
       if (!this.isStreamActive(generation, runId)) {
         markOpen();
         return;
@@ -4699,10 +4715,14 @@ var RemotePiSession = class {
         this.scheduleReconnect(generation);
       }
     } catch (error) {
+      clearConnectTimer();
       markOpen();
-      if (!this.isStreamActive(generation, runId) || shouldIgnoreStreamClose(error, controller)) return;
-      this.dispatchProtocolError(errorMessage(error, "Pi chat event stream disconnected."));
+      if (!this.isStreamActive(generation, runId)) return;
+      if (!connectTimedOut && shouldIgnoreStreamClose(error, controller)) return;
+      this.dispatchProtocolError(connectTimedOut ? `Pi chat event stream timed out after ${this.requestTimeoutMs}ms.` : errorMessage(error, "Pi chat event stream disconnected."));
       this.scheduleReconnect(generation);
+    } finally {
+      clearConnectTimer();
     }
   }
   rehydrateAfterStreamReset(generation, options = {}) {
@@ -4755,12 +4775,21 @@ var RemotePiSession = class {
   async fetchJson(url, init) {
     const controller = new AbortController();
     this.fetchControllers.add(controller);
+    let timedOut = false;
+    const timer = globalThis.setTimeout(() => {
+      timedOut = true;
+      controller.abort();
+    }, this.requestTimeoutMs);
     try {
       const response = await this.fetchImpl(url, { ...init, signal: controller.signal });
       const body = await safeReadJson(response);
       if (!response.ok) throw new RemotePiSessionHttpError(response.status, routeErrorMessage(body, `HTTP ${response.status}`), body);
       return body;
+    } catch (error) {
+      if (timedOut) throw new Error(`Request to ${url} timed out after ${this.requestTimeoutMs}ms.`);
+      throw error;
     } finally {
+      globalThis.clearTimeout(timer);
       this.fetchControllers.delete(controller);
     }
   }

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
-import { o as WorkspaceRuntimeContext, S as Sandbox, g as SandboxHandleStore, f as SandboxHandleRecord, W as Workspace, j as TelemetrySink, F as FileSearch, P as PluginRestartWarning, A as AgentTool, q as AgentHarnessFactory } from '../agentPluginEvents-DgNc3erX.js';
-export { r as AgentHarnessFactoryInput } from '../agentPluginEvents-DgNc3erX.js';
+import { o as WorkspaceRuntimeContext, S as Sandbox, g as SandboxHandleStore, f as SandboxHandleRecord, W as Workspace, j as TelemetrySink, F as FileSearch, P as PluginRestartWarning, A as AgentTool, q as AgentHarnessFactory } from '../agentPluginEvents-CKrZLW3g.js';
+export { r as AgentHarnessFactoryInput } from '../agentPluginEvents-CKrZLW3g.js';
 import { Sandbox as Sandbox$1 } from '@vercel/sandbox';
 import { FastifyInstance, FastifyRequest, FastifyPluginAsync } from 'fastify';
 import { PackageSource, ExtensionFactory, SettingsManager } from '@mariozechner/pi-coding-agent';
@@ -533,6 +533,19 @@ interface CreateAgentAppOptions {
      * the workspace plugin layer.
      */
     systemPromptDynamic?: () => string | undefined | Promise<string | undefined>;
+    /**
+     * Optional host callback returning current plugin/skill load diagnostics
+     * for this workspace. Surfaced by the `plugin_diagnostics` agent tool so the
+     * model can iterate on plugin/skill load errors after a /reload.
+     */
+    getPluginDiagnostics?: (args: {
+        workspaceId: string;
+        workspaceRoot: string;
+    }) => Promise<Array<{
+        source: string;
+        message: string;
+        pluginId?: string;
+    }>>;
 }
 declare function createAgentApp(opts?: CreateAgentAppOptions): Promise<FastifyInstance>;
 
@@ -611,6 +624,19 @@ interface RegisterAgentRoutesOptions {
         workspaceRoot: string;
         request: FastifyRequest;
     }) => void | ReloadHookResult | undefined | Promise<void | ReloadHookResult | undefined>;
+    /**
+     * Optional host callback returning current plugin/skill load diagnostics
+     * for a workspace. Surfaced by the `plugin_diagnostics` agent tool so the
+     * model can iterate on plugin/skill load errors after a /reload.
+     */
+    getPluginDiagnostics?: (args: {
+        workspaceId: string;
+        workspaceRoot: string;
+    }) => Promise<Array<{
+        source: string;
+        message: string;
+        pluginId?: string;
+    }>>;
 }
 /**
  * Fastify plugin that mounts agent routes onto a host app (typically core-built).

package/dist/server/index.js

@@ -6564,6 +6564,40 @@ function createPiCodingAgentHarness(opts) {
     hasPiSession(sessionId) {
       return piSessions.has(sessionId);
     },
+    /**
+     * Surface Pi's skill/extension load diagnostics for a session so silent
+     * load failures (bad SKILL.md, extension import errors) reach the UI and
+     * the agent. Returns [] when the session has no live pi session yet.
+     * The resourceLoader getters are synchronous.
+     */
+    getResourceDiagnostics(sessionId) {
+      const handle = piSessions.get(sessionId);
+      if (!handle) return [];
+      const out = [];
+      const seen = /* @__PURE__ */ new Set();
+      const push = (entry) => {
+        const key = `${entry.source}
+${entry.message}`;
+        if (seen.has(key)) return;
+        seen.add(key);
+        out.push(entry);
+      };
+      for (const diagnostic of handle.resourceLoader.getSkills().diagnostics) {
+        push({
+          source: "pi-skills",
+          message: diagnostic.path && !diagnostic.message.includes(diagnostic.path) ? `${diagnostic.message} (${diagnostic.path})` : diagnostic.message,
+          ...diagnostic.path ? { path: diagnostic.path } : {}
+        });
+      }
+      for (const error of handle.resourceLoader.getExtensions().errors) {
+        push({
+          source: "pi-extensions",
+          message: error.error.includes(error.path) ? error.error : `${error.error} (${error.path})`,
+          path: error.path
+        });
+      }
+      return out;
+    },
     reloadSession: reloadPiSession,
     async getSlashCommands(sessionId, ctx) {
       const handle = await getOrCreatePiSession(sessionId, { sessionId, message: "" }, ctx);
@@ -8110,8 +8144,10 @@ function skillsRoutes(app, opts, done) {
       }));
       cached.set(cacheKey, { skills, expiresAt: now + CACHE_TTL_MS2 });
       return reply.code(200).send({ skills });
-    } catch {
-      return reply.code(200).send({ skills: [] });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      request.log.warn({ err: error }, "[agent] failed to load skills");
+      return reply.code(200).send({ skills: [], error: message });
     }
   });
   done();
@@ -8741,13 +8777,27 @@ function reloadRoutes(app, opts, done) {
       const hookResult = await opts.beforeReload?.();
       const reloaded = await opts.harness.reloadSession(sessionId);
       const restart_warnings = hookResult?.restart_warnings;
-      const diagnostics = hookResult?.diagnostics;
+      const diagnostics = [
+        ...hookResult?.diagnostics ?? [],
+        ...(opts.harness.getResourceDiagnostics?.(sessionId) ?? []).map((d) => ({
+          source: d.source,
+          // The harness already folds the path into the message.
+          message: d.message
+        }))
+      ];
+      if (!reloaded) {
+        diagnostics.push({
+          source: "reload",
+          message: "No live agent session to reload yet \u2014 changes apply to the next session."
+        });
+      }
+      opts.onDiagnostics?.(diagnostics);
       return {
         ok: true,
         sessionId,
         reloaded,
         ...restart_warnings && restart_warnings.length > 0 ? { restart_warnings } : {},
-        ...diagnostics && diagnostics.length > 0 ? { diagnostics } : {}
+        ...diagnostics.length > 0 ? { diagnostics } : {}
       };
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
@@ -10402,6 +10452,41 @@ function toSessionCtx(ctx) {
   return { workspaceId: ctx.workspaceId, userId: ctx.authSubject };
 }
 
+// src/server/tools/pluginDiagnostics.ts
+function createPluginDiagnosticsTool(deps) {
+  return {
+    name: "plugin_diagnostics",
+    description: [
+      "Return current plugin/skill loading errors plus the diagnostics from the",
+      "last /reload. Call this after asking the user to run /reload \u2014 or whenever a",
+      "plugin or skill you expected does not appear to be loaded \u2014 then fix the",
+      "reported error and ask the user to /reload again. Returns a JSON object with",
+      "lastReloadDiagnostics, resourceDiagnostics, and pluginErrors arrays; an empty",
+      "result means no load errors were detected."
+    ].join(" "),
+    parameters: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    async execute(_params, ctx) {
+      const harness = deps.getHarness();
+      const resourceDiagnostics = harness?.getResourceDiagnostics?.(ctx.sessionId ?? "") ?? [];
+      const pluginErrors = deps.getPluginErrors ? await deps.getPluginErrors() : [];
+      const payload = {
+        lastReloadDiagnostics: deps.getLastReloadDiagnostics(),
+        resourceDiagnostics,
+        pluginErrors
+      };
+      return {
+        content: [{ type: "text", text: JSON.stringify(payload) }],
+        details: payload,
+        isError: false
+      };
+    }
+  };
+}
+
 // src/server/createAgentApp.ts
 var DEFAULT_VERSION = "0.1.0-dev";
 var DEFAULT_SESSION_ID = "default";
@@ -10437,6 +10522,8 @@ async function createAgentApp(opts = {}) {
       ...opts.pi?.additionalSkillPaths ?? []
     ]
   };
+  let harnessRef;
+  let lastReloadDiagnostics = [];
   const tools = [
     ...buildHarnessAgentTools(runtimeBundle, {
       getCurrent: () => {
@@ -10446,7 +10533,14 @@ async function createAgentApp(opts = {}) {
     }),
     ...opts.disableDefaultFileTools ? [] : buildFilesystemAgentTools(runtimeBundle),
     ...opts.extraTools ?? [],
-    ...pluginTools
+    ...pluginTools,
+    createPluginDiagnosticsTool({
+      getLastReloadDiagnostics: () => lastReloadDiagnostics,
+      getHarness: () => harnessRef,
+      ...opts.getPluginDiagnostics ? {
+        getPluginErrors: () => opts.getPluginDiagnostics({ workspaceId: sessionId, workspaceRoot })
+      } : {}
+    })
   ];
   const harnessFactory = opts.harnessFactory ?? ((input) => createPiCodingAgentHarness({
     ...input,
@@ -10465,6 +10559,7 @@ async function createAgentApp(opts = {}) {
     systemPromptDynamic: opts.systemPromptDynamic,
     telemetry: opts.telemetry
   });
+  harnessRef = harness;
   const sessionChangesTracker = new InMemorySessionChangesTracker();
   const readyTracker = new ReadyStatusTracker({
     sandboxReady: resolvedMode !== "vercel-sandbox",
@@ -10515,7 +10610,14 @@ async function createAgentApp(opts = {}) {
   await app.register(sessionChangesRoutes, { tracker: sessionChangesTracker });
   await app.register(catalogRoutes, { tools });
   await app.register(commandsRoutes, { harness, defaultSessionId: sessionId, workdir: runtimeBundle.workspace.root });
-  await app.register(reloadRoutes, { harness, defaultSessionId: sessionId, beforeReload: opts.beforeReload });
+  await app.register(reloadRoutes, {
+    harness,
+    defaultSessionId: sessionId,
+    beforeReload: opts.beforeReload,
+    onDiagnostics: (diagnostics) => {
+      lastReloadDiagnostics = diagnostics;
+    }
+  });
   await app.register(readyStatusRoutes, { tracker: readyTracker });
   return app;
 }
@@ -10984,7 +11086,15 @@ var registerAgentRoutes = async (app, opts) => {
         getReadiness: () => checkReadiness("runtime:python", {})
       }),
       ...buildFilesystemAgentTools(runtimeBundle),
-      ...buildUploadAgentTools(runtimeBundle)
+      ...buildUploadAgentTools(runtimeBundle),
+      createPluginDiagnosticsTool({
+        // `binding` is assigned later in this function; read through thunks.
+        getLastReloadDiagnostics: () => binding?.lastReloadDiagnostics ?? [],
+        getHarness: () => binding?.harness,
+        ...opts.getPluginDiagnostics ? {
+          getPluginErrors: () => opts.getPluginDiagnostics({ workspaceId, workspaceRoot: root })
+        } : {}
+      })
     ];
     const pluginTools = [];
     if (modeAdapter.workspaceFsCapability === "strong") {
@@ -11302,13 +11412,28 @@ var registerAgentRoutes = async (app, opts) => {
       const reloadSessionId = request.body?.sessionId || sessionId;
       const reloaded = await binding.harness.reloadSession(reloadSessionId);
       const restart_warnings = hookResult?.restart_warnings;
-      const diagnostics = hookResult?.diagnostics;
+      const diagnostics = [
+        ...hookResult?.diagnostics ?? [],
+        ...(binding.harness.getResourceDiagnostics?.(reloadSessionId) ?? []).map((d) => ({
+          source: d.source,
+          // The harness already folds the path into the message (front only
+          // renders `.message`).
+          message: d.message
+        }))
+      ];
+      if (!reloaded) {
+        diagnostics.push({
+          source: "reload",
+          message: "No live agent session to reload yet \u2014 changes apply to the next session."
+        });
+      }
+      binding.lastReloadDiagnostics = diagnostics;
       return {
         ok: true,
         sessionId: reloadSessionId,
         reloaded,
         ...restart_warnings && restart_warnings.length > 0 ? { restart_warnings } : {},
-        ...diagnostics && diagnostics.length > 0 ? { diagnostics } : {}
+        ...diagnostics.length > 0 ? { diagnostics } : {}
       };
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);

package/dist/shared/index.d.ts

@@ -1,5 +1,5 @@
-import { W as Workspace, S as Sandbox, F as FileSearch, A as AgentTool } from '../agentPluginEvents-DgNc3erX.js';
-export { a as AgentHarness, C as CommandNotifyPayload, E as Entry, b as ExecOptions, c as ExecResult, I as IsolatedCodeInput, d as IsolatedCodeOutput, J as JSONSchema, R as RunContext, e as SandboxCapability, f as SandboxHandleRecord, g as SandboxHandleStore, h as SendMessageInput, i as Stat, T as TelemetryEvent, j as TelemetrySink, k as ToolExecContext, l as ToolResult, m as WORKSPACE_AGENT_PLUGINS_RELOADED_EVENT, n as WORKSPACE_COMMAND_NOTIFY_EVENT, o as WorkspaceRuntimeContext, p as noopTelemetry, s as safeCapture } from '../agentPluginEvents-DgNc3erX.js';
+import { W as Workspace, S as Sandbox, F as FileSearch, A as AgentTool } from '../agentPluginEvents-CKrZLW3g.js';
+export { a as AgentHarness, C as CommandNotifyPayload, E as Entry, b as ExecOptions, c as ExecResult, I as IsolatedCodeInput, d as IsolatedCodeOutput, J as JSONSchema, R as RunContext, e as SandboxCapability, f as SandboxHandleRecord, g as SandboxHandleStore, h as SendMessageInput, i as Stat, T as TelemetryEvent, j as TelemetrySink, k as ToolExecContext, l as ToolResult, m as WORKSPACE_AGENT_PLUGINS_RELOADED_EVENT, n as WORKSPACE_COMMAND_NOTIFY_EVENT, o as WorkspaceRuntimeContext, p as noopTelemetry, s as safeCapture } from '../agentPluginEvents-CKrZLW3g.js';
 import { B as BoringChatPart, T as ToolUiMetadata } from '../piChatEvent-Ck1BAE_m.js';
 export { A as ApiErrorPayload, a as ApiErrorPayloadSchema, b as ApiErrorResponse, c as ApiErrorResponseSchema, d as BoringChatMessage, C as ChatAttachmentPayload, e as ChatError, f as ChatModelSelection, g as ChatSubmitPayload, h as CommandReceipt, E as ERROR_CODES, i as ErrorCode, j as ErrorLogFields, k as ErrorLogFieldsSchema, F as FollowUpPayload, l as FollowUpReceipt, I as InterruptPayload, m as InterruptReceipt, P as PiChatEvent, n as PiChatHeartbeatFrame, o as PiChatSnapshot, p as PiChatStatus, q as PiChatStreamFrame, r as PromptPayload, s as PromptReceipt, Q as QueueClearPayload, t as QueueClearReceipt, u as QueuedUserMessage, S as StopPayload, v as StopReceipt, w as ThinkingLevel, x as extractToolUiMetadata, y as isToolUiMetadata } from '../piChatEvent-Ck1BAE_m.js';
 export { S as SessionCtx, a as SessionDetail, b as SessionStore, c as SessionSummary } from '../session-BRovhe0D.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachej/boring-agent",
-  "version": "0.1.37",
+  "version": "0.1.39",
   "type": "module",
   "license": "MIT",
   "description": "Pane-embeddable coding agent. Ships direct/local/vercel-sandbox execution modes behind one interface.",
@@ -74,7 +74,7 @@
     "use-stick-to-bottom": "^1.1.3",
     "yaml": "^2.8.3",
     "zod": "^3.25.76",
-    "@hachej/boring-ui-kit": "0.1.37"
+    "@hachej/boring-ui-kit": "0.1.39"
   },
   "devDependencies": {
     "@antithesishq/bombadil": "0.5.0",