@hachej/boring-agent 0.1.23 → 0.1.26

package/dist/{agentPluginEvents-zyIvVjsA.d.ts → agentPluginEvents-CF0BGY4D.d.ts}

@@ -1,5 +1,12 @@
+interface WorkspaceRuntimeContext {
+    /** Agent-visible working directory shared by file-tree and shell execution. */
+    readonly runtimeCwd: string;
+}
+
 interface Workspace {
+    /** Agent-visible workspace root; must match runtimeContext.runtimeCwd. */
     readonly root: string;
+    readonly runtimeContext: WorkspaceRuntimeContext;
     readFile(relPath: string): Promise<string>;
     /** Optional binary read operation for media/document previews. */
     readBinaryFile?(relPath: string): Promise<Uint8Array>;
@@ -137,6 +144,8 @@ interface Sandbox {
     readonly provider: string;
     /** Capabilities this sandbox advertises (used for tool gating). */
     readonly capabilities: readonly SandboxCapability[];
+    /** Agent-visible runtime cwd; must match the paired Workspace root. */
+    readonly runtimeContext: WorkspaceRuntimeContext;
     /**
      * Optional initialization hook. Some backends bind to a workspace +
      * session at construction (Vercel: snapshot warm-up; Bwrap: bind
@@ -171,6 +180,7 @@ interface Sandbox {
     dispose?(): Promise<void>;
 }
 interface ExecOptions {
+    /** Runtime-visible cwd. Relative paths resolve from `runtimeContext.runtimeCwd`. */
     cwd?: string;
     env?: Record<string, string>;
     signal?: AbortSignal;
@@ -287,4 +297,4 @@ interface PluginRestartWarning {
     message: string;
 }
 
-export { type Entry as E, type FileSearch as F, type IsolatedCodeInput as I, type PluginRestartWarning as P, type Sandbox as S, type Workspace as W, type ExecOptions as a, type ExecResult as b, type IsolatedCodeOutput as c, type SandboxCapability as d, type SandboxHandleRecord as e, type SandboxHandleStore as f, type Stat as g, WORKSPACE_AGENT_PLUGINS_RELOADED_EVENT as h };
+export { type Entry as E, type FileSearch as F, type IsolatedCodeInput as I, type PluginRestartWarning as P, type Sandbox as S, type Workspace as W, type ExecOptions as a, type ExecResult as b, type IsolatedCodeOutput as c, type SandboxCapability as d, type SandboxHandleRecord as e, type SandboxHandleStore as f, type Stat as g, WORKSPACE_AGENT_PLUGINS_RELOADED_EVENT as h, type WorkspaceRuntimeContext as i };

package/dist/chunk-HDOSWEXG.js

@@ -0,0 +1,29 @@
+// src/shared/telemetry.ts
+var noopTelemetry = {
+  capture() {
+  }
+};
+function safeCapture(telemetry, event) {
+  try {
+    void Promise.resolve(telemetry.capture(event)).catch(() => {
+    });
+  } catch {
+  }
+}
+
+// src/shared/validateTool.ts
+function validateTool(tool) {
+  if (typeof tool !== "object" || tool === null) return null;
+  const t = tool;
+  if (typeof t.name !== "string" || t.name.length === 0) return null;
+  if (typeof t.description !== "string") return null;
+  if (typeof t.parameters !== "object" || t.parameters === null) return null;
+  if (typeof t.execute !== "function") return null;
+  return t;
+}
+
+export {
+  noopTelemetry,
+  safeCapture,
+  validateTool
+};

package/dist/{chunk-6R7O6BHW.js → chunk-UBWQ5LT4.js}

@@ -1,16 +1,3 @@
-// src/shared/telemetry.ts
-var noopTelemetry = {
-  capture() {
-  }
-};
-function safeCapture(telemetry, event) {
-  try {
-    void Promise.resolve(telemetry.capture(event)).catch(() => {
-    });
-  } catch {
-  }
-}
-
 // src/shared/error-codes.ts
 import { z } from "zod";
 var ErrorCode = z.enum([
@@ -28,6 +15,11 @@ var ErrorCode = z.enum([
   "PATH_NOT_FOUND",
   "PATH_NOT_WRITABLE",
   "WORKSPACE_UNINITIALIZED",
+  "WORKSPACE_NOT_READY",
+  // Agent runtime / provisioning
+  "AGENT_RUNTIME_NOT_READY",
+  "RUNTIME_PROVISIONING_FAILED",
+  "RUNTIME_PROVISIONING_LOCKED",
   // Sandbox / exec
   "BWRAP_UNAVAILABLE",
   "BWRAP_TIMEOUT",
@@ -50,6 +42,10 @@ var ErrorCode = z.enum([
   // Plugin
   "PLUGIN_LOAD_FAILED",
   "PLUGIN_NAME_COLLISION",
+  "PLUGIN_RUNTIME_REVISION_MISMATCH",
+  "PLUGIN_RUNTIME_PRIVATE_FILE",
+  "PLUGIN_RUNTIME_UNSAFE_IMPORT",
+  "PLUGIN_RUNTIME_TRANSFORM_FAILED",
   // Runtime provisioning
   "PROVISIONING_LAYOUT_FAILED",
   "PROVISIONING_SKILLS_FAILED",
@@ -78,24 +74,10 @@ var ErrorLogFieldsSchema = z.object({
   msg: z.string().min(1)
 }).catchall(z.unknown());
 
-// src/shared/validateTool.ts
-function validateTool(tool) {
-  if (typeof tool !== "object" || tool === null) return null;
-  const t = tool;
-  if (typeof t.name !== "string" || t.name.length === 0) return null;
-  if (typeof t.description !== "string") return null;
-  if (typeof t.parameters !== "object" || t.parameters === null) return null;
-  if (typeof t.execute !== "function") return null;
-  return t;
-}
-
 export {
-  noopTelemetry,
-  safeCapture,
   ErrorCode,
   ERROR_CODES,
   ApiErrorPayloadSchema,
   ApiErrorResponseSchema,
-  ErrorLogFieldsSchema,
-  validateTool
+  ErrorLogFieldsSchema
 };

package/dist/eval/index.d.ts

@@ -90,6 +90,10 @@ interface EvalPromptOptions {
     systemPrompt?: string;
     /** Override the chat session id (defaults to a fresh uuid). */
     sessionId?: string;
+    /** Optional headers sent to session/chat requests (e.g. workspace scoping). */
+    headers?: Record<string, string>;
+    /** Optional query params appended to session/chat requests (e.g. workspaceId). */
+    query?: Record<string, string | number | boolean | undefined>;
     /** Per-call timeout in ms. Defaults to 30_000. */
     timeoutMs?: number;
     /** Per-prompt retry count. Default: 0. */

package/dist/eval/index.js

@@ -206,7 +206,9 @@ async function evalAgentPrompt(opts) {
         prompt: opts.prompt,
         systemPrompt: opts.systemPrompt,
         model,
-        timeoutMs
+        timeoutMs,
+        headers: opts.headers,
+        query: opts.query
       });
     } catch (err) {
       lastResult = {
@@ -219,6 +221,18 @@ async function evalAgentPrompt(opts) {
       if (attempts > maxRetries) return lastResult;
       continue;
     }
+    if (captured.errorText) {
+      lastResult = {
+        ok: false,
+        actual: captured.toolCalls,
+        text: captured.text,
+        usage: captured.usage,
+        attempts,
+        reason: `stream: ${captured.errorText}`
+      };
+      if (attempts > maxRetries) return lastResult;
+      continue;
+    }
     const matchResult = matchExpectations(opts, captured.toolCalls);
     lastResult = {
       ok: matchResult.ok,
@@ -265,9 +279,11 @@ function matchExpectations(opts, actual) {
   return someCallMatches(opts.expect, actual);
 }
 async function runOnce(app, opts) {
+  const querySuffix = formatQuerySuffix(opts.query);
   await app.inject({
     method: "POST",
-    url: "/api/v1/agent/sessions",
+    url: `/api/v1/agent/sessions${querySuffix}`,
+    headers: opts.headers,
     payload: { id: opts.sessionId }
   });
   const userMessage = opts.systemPrompt ? `[SYSTEM]
@@ -280,7 +296,8 @@ ${opts.prompt}` : opts.prompt;
     res = await withTimeout(
       app.inject({
         method: "POST",
-        url: "/api/v1/agent/chat",
+        url: `/api/v1/agent/chat${querySuffix}`,
+        headers: opts.headers,
         payload: {
           sessionId: opts.sessionId,
           message: userMessage,
@@ -293,7 +310,8 @@ ${opts.prompt}` : opts.prompt;
   } finally {
     void app.inject({
       method: "DELETE",
-      url: `/api/v1/agent/sessions/${encodeURIComponent(opts.sessionId)}`
+      url: `/api/v1/agent/sessions/${encodeURIComponent(opts.sessionId)}${querySuffix}`,
+      headers: opts.headers
     }).catch(() => {
     });
   }
@@ -304,9 +322,20 @@ ${opts.prompt}` : opts.prompt;
   }
   return parseSseStream(res.body);
 }
+function formatQuerySuffix(query) {
+  if (!query) return "";
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(query)) {
+    if (value === void 0) continue;
+    params.set(key, String(value));
+  }
+  const encoded = params.toString();
+  return encoded ? `?${encoded}` : "";
+}
 function parseSseStream(body) {
   const toolCalls = [];
   const textParts = [];
+  const errorParts = [];
   let usage;
   for (const line of body.split("\n")) {
     const trimmed = line.trim();
@@ -337,9 +366,28 @@ function parseSseStream(body) {
           usage = { input: obj.input, output: obj.output };
         }
       }
+    } else if (type === "error") {
+      const text = stringifyStreamError(chunk);
+      if (text) errorParts.push(text);
+    }
+  }
+  return {
+    toolCalls,
+    text: textParts.join(""),
+    usage,
+    errorText: errorParts.length ? errorParts.join("\n") : void 0
+  };
+}
+function stringifyStreamError(chunk) {
+  for (const key of ["errorText", "message", "error"]) {
+    const value = chunk[key];
+    if (typeof value === "string" && value.trim()) return value;
+    if (value && typeof value === "object") {
+      const message = value.message;
+      if (typeof message === "string" && message.trim()) return message;
     }
   }
-  return { toolCalls, text: textParts.join(""), usage };
+  return "unknown stream error";
 }
 function withTimeout(p, ms, label) {
   return new Promise((resolve, reject) => {

package/dist/front/index.d.ts

@@ -1,11 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as ai from 'ai';
+import { FileUIPart, UIMessage, ChatStatus } from 'ai';
 import * as react from 'react';
 import { ReactNode, ComponentType, HTMLAttributes, ComponentProps, FormEvent } from 'react';
 import { T as ToolUiMetadata } from '../tool-ui-DIFNGwYd.js';
-import * as ai from 'ai';
-import { UIMessage, FileUIPart, ChatStatus } from 'ai';
 import * as _ai_sdk_react from '@ai-sdk/react';
-import { S as SendMessageInput, e as SessionSummary } from '../harness-BCit36Ha.js';
+import { S as SendMessageInput, e as SessionSummary } from '../harness-CQ0uw6xW.js';
 import { Button, Collapsible, CollapsibleContent, CollapsibleTrigger, InputGroupAddon, InputGroupButton, InputGroupTextarea } from '@hachej/boring-ui-kit';
 import { Streamdown } from 'streamdown';
 import { StickToBottom } from 'use-stick-to-bottom';
@@ -165,6 +165,23 @@ type ComposerBlocker = {
     sessionId?: string;
     actions?: ComposerBlockerAction[];
 };
+type ChatPanelWorkspaceWarmupStatus = {
+    status: 'preparing';
+    requirement?: 'workspace-fs' | 'sandbox-exec' | 'ui-bridge';
+    message?: string;
+} | {
+    status: 'ready';
+} | {
+    status: 'failed';
+    requirement?: 'workspace-fs' | 'sandbox-exec' | 'ui-bridge';
+    message?: string;
+};
+type ChatSubmitSource = 'composer' | 'suggestion';
+interface ChatSubmitContext {
+    files: FileUIPart[];
+    sessionId: string;
+    source: ChatSubmitSource;
+}
 interface ChatPanelProps {
     sessionId: string;
     toolRenderers?: ToolRendererOverrides;
@@ -222,6 +239,8 @@ interface ChatPanelProps {
     onData?: (part: unknown) => void;
     /** Headers sent with chat and chat-history requests. */
     requestHeaders?: Record<string, string>;
+    /** When false, skip initial chat history/stream resume requests until the user sends. */
+    hydrateMessages?: boolean;
     /**
      * Called with a file path when the user clicks the path label inside
      * a read / write / edit tool card. Hosts (e.g. @hachej/boring-workspace)
@@ -237,6 +256,29 @@ interface ChatPanelProps {
      * is zero-cost when off.
      */
     debug?: boolean;
+    /** Draft text restored into the composer on mount/update. */
+    initialDraft?: string;
+    /** Auto-submit initialDraft once after it is restored. Defaults to false. */
+    autoSubmitInitialDraft?: boolean;
+    /** Called after initialDraft is applied to the composer. */
+    onDraftRestored?: () => void;
+    /** Called after an auto-submitted initial draft is accepted for sending. */
+    onAutoSubmitInitialDraftAccepted?: () => void;
+    /** Called after an auto-submitted initial draft finishes its turn. */
+    onAutoSubmitInitialDraftSettled?: () => void;
+    /**
+     * Runs before any agent/model/session-history network send. Return false to
+     * cancel submission and keep the draft in the composer.
+     */
+    onBeforeSubmit?: (draft: string, ctx: ChatSubmitContext) => false | void | Promise<false | void>;
+    /** Disable server-backed model/skill discovery for public/local-only shells. */
+    serverResourcesEnabled?: boolean;
+    /** Center the empty-state prompt/composer for public landing experiences. */
+    emptyPlacement?: 'default' | 'hero';
+    /** Placeholder shown in the composer textarea. */
+    composerPlaceholder?: string;
+    /** Current workspace warmup state. Preparing/failed states keep submits local so drafts are not lost. */
+    workspaceWarmupStatus?: ChatPanelWorkspaceWarmupStatus;
     /** Generic host-provided blockers that prevent starting a new user turn. */
     composerBlockers?: ComposerBlocker[];
     /** Called when the user presses Stop in the composer. */
@@ -276,12 +318,15 @@ type UseAgentChatOptions = Pick<SendMessageInput, 'sessionId' | 'model' | 'think
     onData?: (part: unknown) => void;
     requestHeaders?: Record<string, string>;
     persistMessages?: boolean;
+    hydrateMessages?: boolean;
 };
 declare function useAgentChat(opts: UseAgentChatOptions): _ai_sdk_react.UseChatHelpers<UIMessage<unknown, ai.UIDataTypes, ai.UITools>>;
 
 interface UseSessionsOptions {
     requestHeaders?: Record<string, string>;
     storageKey?: string;
+    enabled?: boolean;
+    refreshKey?: unknown;
 }
 interface UseSessionsResult {
     sessions: SessionSummary[];
@@ -384,7 +429,7 @@ type PromptInputProps = Omit<HTMLAttributes<HTMLFormElement>, "onSubmit" | "onEr
         code: "max_files" | "max_file_size" | "accept";
         message: string;
     }) => void;
-    onSubmit: (message: PromptInputMessage, event: FormEvent<HTMLFormElement>) => void | Promise<void>;
+    onSubmit: (message: PromptInputMessage, event: FormEvent<HTMLFormElement>) => false | void | Promise<false | void>;
     /** When provided, files are uploaded to the server immediately on add and the
      * attachment URL is replaced with the stable server path before submit. */
     onUploadFile?: (file: File) => Promise<{