@agent-native/core 0.80.2 → 0.80.5

package/corpus/templates/slides/app/components/design-system/DesignSystemSetup.tsx

@@ -36,11 +36,11 @@ import { Textarea } from "@/components/ui/textarea";
 import { toast } from "@/hooks/use-toast";
 
 import {
-  MAX_FIG_UPLOAD_BYTES,
+  MAX_BUILDER_INDEX_UPLOAD_BYTES,
+  readBuilderIndexResponse,
   formatFileSize,
-  readFigImportResponse,
-  type FigImportResult,
-} from "./fig-import-response";
+  type BuilderIndexResult,
+} from "./builder-index-response";
 
 interface DesignSystemSetupProps {
   open: boolean;
@@ -105,9 +105,12 @@ export function DesignSystemSetup({
   const [brandNotes, setBrandNotes] = useState("");
   const [customInstructions, setCustomInstructions] = useState("");
   const [generating, setGenerating] = useState(false);
-  const [figParsing, setFigParsing] = useState(false);
-  const [figResult, setFigResult] = useState<FigImportResult | null>(null);
-  const [figError, setFigError] = useState<string | null>(null);
+  const [builderIndexing, setBuilderIndexing] = useState(false);
+  const [builderIndexResult, setBuilderIndexResult] =
+    useState<BuilderIndexResult | null>(null);
+  const [builderIndexError, setBuilderIndexError] = useState<string | null>(
+    null,
+  );
 
   const codeInputRef = useRef<HTMLInputElement>(null);
   const docInputRef = useRef<HTMLInputElement>(null);
@@ -158,9 +161,9 @@ export function DesignSystemSetup({
       setBrandNotes("");
       setCustomInstructions("");
       setSelectedSystemId("");
-      setFigParsing(false);
-      setFigResult(null);
-      setFigError(null);
+      setBuilderIndexing(false);
+      setBuilderIndexResult(null);
+      setBuilderIndexError(null);
     }
   }, [open]);
 
@@ -170,6 +173,7 @@ export function DesignSystemSetup({
       websiteUrls.length > 0 ||
       githubLinks.length > 0 ||
       codeFiles.length > 0 ||
+      builderIndexResult ||
       docFiles.length > 0 ||
       imageFiles.length > 0 ||
       selectedSystemId ||
@@ -181,6 +185,7 @@ export function DesignSystemSetup({
     websiteUrls,
     githubLinks,
     codeFiles,
+    builderIndexResult,
     docFiles,
     imageFiles,
     selectedSystemId,
@@ -238,44 +243,47 @@ export function DesignSystemSetup({
     [t],
   );
 
-  const handleFigImport = useCallback(
+  const handleBuilderIndexUpload = useCallback(
     async (event: React.ChangeEvent<HTMLInputElement>) => {
       const file = event.target.files?.[0];
       event.target.value = "";
       if (!file) return;
       if (!file.name.toLowerCase().endsWith(".fig")) {
-        setFigError(t("designSystemSetup.figFileRequired"));
+        setBuilderIndexError(t("designSystemSetup.figFileRequired"));
         return;
       }
-      if (file.size > MAX_FIG_UPLOAD_BYTES) {
-        setFigError(
+      if (file.size > MAX_BUILDER_INDEX_UPLOAD_BYTES) {
+        setBuilderIndexError(
           t("designSystemSetup.figFileTooLarge", {
-            maxSize: formatFileSize(MAX_FIG_UPLOAD_BYTES),
+            maxSize: formatFileSize(MAX_BUILDER_INDEX_UPLOAD_BYTES),
           }),
         );
         return;
       }
 
-      setFigError(null);
-      setFigResult(null);
-      setFigParsing(true);
+      setBuilderIndexError(null);
+      setBuilderIndexResult(null);
+      setBuilderIndexing(true);
       try {
         const body = new FormData();
         body.append("file", file);
-        const res = await fetch(appApiPath("/api/import-figma-system"), {
-          method: "POST",
-          body,
-        });
-        const parsed = await readFigImportResponse(res);
-        setFigResult(parsed);
+        const res = await fetch(
+          appApiPath("/api/index-design-system-with-builder"),
+          {
+            method: "POST",
+            body,
+          },
+        );
+        const parsed = await readBuilderIndexResponse(res);
+        setBuilderIndexResult(parsed);
       } catch (err) {
-        setFigError(
+        setBuilderIndexError(
           err instanceof Error
             ? err.message
             : t("designSystemSetup.figParseFailed"),
         );
       } finally {
-        setFigParsing(false);
+        setBuilderIndexing(false);
       }
     },
     [t],
@@ -353,6 +361,12 @@ export function DesignSystemSetup({
       }
     }
 
+    if (builderIndexResult) {
+      parts.push(
+        `\n## Builder-Indexed Figma File\nBuilder design-system indexing has already started.\n- Design system: ${builderIndexResult.designSystemId}\n- Local selectable design system: ${builderIndexResult.localDesignSystemId ?? "(not returned)"}\n- Project: ${builderIndexResult.projectId}\n- Job: ${builderIndexResult.jobId}\n- URL: ${builderIndexResult.builderUrl}\n\nUse Builder as the source of truth for extracted tokens, assets, and guidance. Do not call \`create-design-system\` again for this Builder-indexed source.`,
+      );
+    }
+
     if (docFiles.length > 0) {
       const inlined = docFiles.filter((f) => f.textContent);
       const binary = docFiles.filter((f) => !f.textContent);
@@ -419,6 +433,7 @@ export function DesignSystemSetup({
     websiteUrls,
     githubLinks,
     codeFiles,
+    builderIndexResult,
     docFiles,
     imageFiles,
     selectedSystemId,
@@ -469,15 +484,15 @@ export function DesignSystemSetup({
                     <IconBrandFigma className="w-3.5 h-3.5" />
                     {t("designSystemSetup.figmaFile")}
                   </Label>
-                  {!figResult ? (
+                  {!builderIndexResult ? (
                     <>
                       <button
                         type="button"
                         onClick={() => figInputRef.current?.click()}
-                        disabled={figParsing}
+                        disabled={builderIndexing}
                         className="w-full border border-dashed border-border rounded-lg p-4 text-center hover:border-foreground/20 cursor-pointer disabled:cursor-wait disabled:opacity-70"
                       >
-                        {figParsing ? (
+                        {builderIndexing ? (
                           <span className="inline-flex items-center gap-2 text-xs text-muted-foreground">
                             <IconLoader2 className="w-3.5 h-3.5 animate-spin" />
                             {t("designSystemSetup.parsingFigmaFile")}
@@ -492,24 +507,24 @@ export function DesignSystemSetup({
                         ref={figInputRef}
                         type="file"
                         accept=".fig"
-                        onChange={handleFigImport}
+                        onChange={handleBuilderIndexUpload}
                         className="hidden"
                       />
-                      {figError && (
+                      {builderIndexError && (
                         <div
                           role="alert"
                           className="rounded-md border border-destructive/30 bg-destructive/10 px-3 py-2 text-sm text-destructive"
                         >
-                          {figError}
+                          {builderIndexError}
                         </div>
                       )}
                     </>
                   ) : (
-                    <FigImportPreview
-                      result={figResult}
+                    <BuilderIndexPreview
+                      result={builderIndexResult}
                       onReset={() => {
-                        setFigResult(null);
-                        setFigError(null);
+                        setBuilderIndexResult(null);
+                        setBuilderIndexError(null);
                       }}
                     />
                   )}
@@ -842,11 +857,11 @@ function TagList({
   );
 }
 
-function FigImportPreview({
+function BuilderIndexPreview({
   result,
   onReset,
 }: {
-  result: FigImportResult;
+  result: BuilderIndexResult;
   onReset: () => void;
 }) {
   const t = useT();

package/corpus/templates/slides/app/components/design-system/{fig-import-response.ts → builder-index-response.ts}

@@ -1,4 +1,4 @@
-export interface FigImportResult {
+export interface BuilderIndexResult {
   ok: boolean;
   source: "builder";
   suggestedTitle: string;
@@ -7,10 +7,13 @@ export interface FigImportResult {
   designSystemId: string;
   builderUrl: string;
   status: "in-progress";
+  localDesignSystemId?: string;
+  uploadedFileCount?: number;
+  instructions?: string;
   builderConnectUrl?: string;
 }
 
-export const MAX_FIG_UPLOAD_BYTES = 200 * 1024 * 1024;
+export const MAX_BUILDER_INDEX_UPLOAD_BYTES = 200 * 1024 * 1024;
 
 export function formatFileSize(bytes: number): string {
   return `${Math.round(bytes / 1024 / 1024)} MB`;
@@ -18,7 +21,7 @@ export function formatFileSize(bytes: number): string {
 
 function summarizeUploadFailure(status: number, bodyText: string): string {
   if (status === 413) {
-    return `File too large (max ${formatFileSize(MAX_FIG_UPLOAD_BYTES)}).`;
+    return `File too large (max ${formatFileSize(MAX_BUILDER_INDEX_UPLOAD_BYTES)}).`;
   }
 
   const trimmed = bodyText
@@ -31,9 +34,9 @@ function summarizeUploadFailure(status: number, bodyText: string): string {
   return `Upload failed (${status})`;
 }
 
-export async function readFigImportResponse(
+export async function readBuilderIndexResponse(
   res: Response,
-): Promise<FigImportResult> {
+): Promise<BuilderIndexResult> {
   const bodyText = await res.text();
   let json: unknown = null;
 
@@ -59,5 +62,5 @@ export async function readFigImportResponse(
     throw new Error(summarizeUploadFailure(res.status, bodyText));
   }
 
-  return json as FigImportResult;
+  return json as BuilderIndexResult;
 }

package/corpus/templates/slides/app/components/visual-editor/MultiSelectChip.tsx

@@ -17,7 +17,7 @@ interface MultiSelectChipProps {
 }
 
 /**
- * Floating chip that hovers above a multi-select selection (Figma-style).
+ * Floating chip that hovers above a multi-select selection (design-editor style).
  * Rendered via portal so it isn't constrained by the slide canvas's stacking
  * context. Reusable across the slides editor and the design template.
  */

package/corpus/templates/slides/changelog/2026-06-29-design-system-setup-now-indexes-uploaded-design-files-throug.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-29
+---
+
+Design system setup now indexes uploaded design files through Builder.

package/corpus/templates/slides/changelog/2026-06-29-longer-hosted-agent-turns.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-29
+---
+
+Hosted deck generation and editing chats have a longer background run window, reducing timeouts during complex creative turns.

package/corpus/templates/slides/netlify.toml

@@ -8,13 +8,10 @@ functions = "templates/slides/.netlify/functions-internal"
 GA_MEASUREMENT_ID = "G-ESF7FYXGN9"
 NITRO_PRESET = "netlify"
 NPM_CONFIG_PRODUCTION = "false"
+AGENT_CHAT_DURABLE_BACKGROUND = "true"
 
 # Function wall for the non-agent long-request paths (deck import/export,
-# image generation). NOTE: this does NOT set the agent-chat chunk boundary —
-# on hosted runtimes the agent run soft-timeout is clamped to
-# HOSTED_SOFT_TIMEOUT_CEILING_MS (40s) in @agent-native/core run-manager.ts,
-# regardless of the per-template runSoftTimeoutMs. The agent's hidden
-# auto-continuation hands off at ~40s; this 300s ceiling only protects the
-# longer non-agent HTTP handlers.
+# image generation). Agent chat opts into the separate Netlify background
+# function so hosted creative turns can use the longer background budget.
 [functions."*"]
 timeout = 300

package/corpus/templates/slides/server/handlers/index-design-system-with-builder.ts

@@ -0,0 +1,116 @@
+import {
+  FeatureNotConfiguredError,
+  getSession,
+  startBuilderDesignSystemIndex,
+} from "@agent-native/core/server";
+import {
+  defineEventHandler,
+  getRequestHeader,
+  readMultipartFormData,
+  setResponseStatus,
+} from "h3";
+
+import { upsertBuilderProxyDesignSystem } from "../lib/builder-design-system-proxy.js";
+
+const MAX_FIG_BYTES = 200 * 1024 * 1024;
+const MULTIPART_OVERHEAD_BYTES = 1024 * 1024;
+
+function requestContentLength(event: Parameters<typeof getRequestHeader>[0]) {
+  const raw = getRequestHeader(event, "content-length");
+  if (!raw) return null;
+  const parsed = Number(raw);
+  return Number.isFinite(parsed) && parsed >= 0 ? parsed : null;
+}
+
+export const indexDesignSystemWithBuilder = defineEventHandler(
+  async (event) => {
+    const session = await getSession(event).catch(() => null);
+    if (!session?.email) {
+      setResponseStatus(event, 401);
+      return { error: "Unauthorized" };
+    }
+
+    const contentLength = requestContentLength(event);
+    if (
+      contentLength !== null &&
+      contentLength > MAX_FIG_BYTES + MULTIPART_OVERHEAD_BYTES
+    ) {
+      setResponseStatus(event, 413);
+      return {
+        error: `File too large (max ${Math.round(MAX_FIG_BYTES / 1024 / 1024)} MB).`,
+      };
+    }
+
+    let parts;
+    try {
+      parts = await readMultipartFormData(event);
+    } catch {
+      setResponseStatus(event, 413);
+      return { error: "Upload too large or malformed." };
+    }
+
+    const part = parts?.find(
+      (p) => (p.name === "file" || p.name === "fig") && p.data,
+    );
+    if (!part) {
+      setResponseStatus(event, 400);
+      return {
+        error: "No .fig file uploaded (expected multipart field 'file').",
+      };
+    }
+    if (part.data.length > MAX_FIG_BYTES) {
+      setResponseStatus(event, 413);
+      return {
+        error: `File too large (max ${Math.round(MAX_FIG_BYTES / 1024 / 1024)} MB).`,
+      };
+    }
+
+    const suggestedTitle =
+      (part.filename || "Imported brand")
+        .replace(/\.fig$/i, "")
+        .replace(/[-_]+/g, " ")
+        .trim() || "Imported brand";
+
+    try {
+      const result = await startBuilderDesignSystemIndex({
+        projectName: suggestedTitle,
+        files: [
+          {
+            name: part.filename || "brand.fig",
+            data: part.data,
+            mimeType: "application/octet-stream",
+          },
+        ],
+      });
+      const proxy = await upsertBuilderProxyDesignSystem({
+        result,
+        ownerEmail: session.email,
+        orgId: session.orgId ?? null,
+        projectName: suggestedTitle,
+      });
+      return {
+        ...result,
+        ...proxy,
+        uploadedFileCount: 1,
+      };
+    } catch (err) {
+      if (err instanceof FeatureNotConfiguredError) {
+        setResponseStatus(event, 412);
+        return {
+          error:
+            err.message ||
+            "Connect Builder.io before indexing a design system from Figma.",
+          builderConnectUrl:
+            err.builderConnectUrl ?? "/_agent-native/builder/connect",
+        };
+      }
+      setResponseStatus(event, 502);
+      return {
+        error:
+          err instanceof Error
+            ? err.message
+            : "Builder design-system indexing failed.",
+      };
+    }
+  },
+);

package/corpus/templates/slides/server/lib/builder-design-system-proxy.ts

@@ -0,0 +1,179 @@
+import { eq } from "drizzle-orm";
+import { nanoid } from "nanoid";
+
+import { getDb, schema } from "../db/index.js";
+
+type BuilderDesignSystemIndexResult = {
+  designSystemId: string;
+  jobId: string;
+  builderUrl: string;
+};
+
+function localBuilderDesignSystemId(builderDesignSystemId: string): string {
+  const slug = builderDesignSystemId
+    .replace(/[^a-zA-Z0-9_-]+/g, "-")
+    .replace(/^-+|-+$/g, "")
+    .slice(0, 96);
+  return `builder-${slug || "design-system"}`;
+}
+
+function builderProxyData({
+  builderDesignSystemId,
+  jobId,
+  builderUrl,
+  projectName,
+  description,
+}: {
+  builderDesignSystemId: string;
+  jobId: string;
+  builderUrl: string;
+  projectName?: string;
+  description?: string;
+}) {
+  return JSON.stringify({
+    source: "builder",
+    builderDesignSystemId,
+    builderJobId: jobId,
+    builderUrl,
+    colors: {
+      primary: "var(--primary)",
+      secondary: "var(--secondary)",
+      accent: "var(--accent)",
+      background: "var(--background)",
+      surface: "var(--card)",
+      text: "var(--foreground)",
+      textMuted: "var(--muted-foreground)",
+    },
+    typography: {
+      headingFont: "inherit",
+      bodyFont: "inherit",
+      headingWeight: "700",
+      bodyWeight: "400",
+      headingSizes: { h1: "48px", h2: "32px", h3: "24px" },
+    },
+    spacing: { elementGap: "24px", slidePadding: "48px" },
+    borders: { radius: "12px", accentWidth: "1px" },
+    logos: [],
+    notes: [
+      "This is a local proxy for a Builder-indexed design system.",
+      `Builder design system id: ${builderDesignSystemId}`,
+      `Builder indexing job id: ${jobId}`,
+      `Builder URL: ${builderUrl}`,
+      projectName ? `Requested name: ${projectName}` : "",
+      description ? `Context: ${description}` : "",
+      "Use Builder as the source of truth for extracted tokens and guidance.",
+    ]
+      .filter(Boolean)
+      .join("\n"),
+  });
+}
+
+function builderProxyInstructions({
+  builderDesignSystemId,
+  jobId,
+  builderUrl,
+}: {
+  builderDesignSystemId: string;
+  jobId: string;
+  builderUrl: string;
+}) {
+  return [
+    "This design system is indexed and owned by Builder.",
+    `Builder design system id: ${builderDesignSystemId}`,
+    `Builder job id: ${jobId}`,
+    `Builder URL: ${builderUrl}`,
+    "When generating slides, treat Builder as the source of truth for the final extracted tokens, assets, and guidance.",
+  ].join("\n");
+}
+
+export async function upsertBuilderProxyDesignSystem({
+  result,
+  ownerEmail,
+  orgId,
+  projectName,
+  description,
+}: {
+  result: BuilderDesignSystemIndexResult;
+  ownerEmail: string;
+  orgId?: string | null;
+  projectName?: string;
+  description?: string;
+}) {
+  const db = getDb();
+  const now = new Date().toISOString();
+  const baseLocalDesignSystemId = localBuilderDesignSystemId(
+    result.designSystemId,
+  );
+  const title = projectName?.trim() || "Builder indexed design system";
+  const localData = builderProxyData({
+    builderDesignSystemId: result.designSystemId,
+    jobId: result.jobId,
+    builderUrl: result.builderUrl,
+    projectName,
+    description,
+  });
+  const customInstructions = builderProxyInstructions({
+    builderDesignSystemId: result.designSystemId,
+    jobId: result.jobId,
+    builderUrl: result.builderUrl,
+  });
+  const [existing] = await db
+    .select({
+      id: schema.designSystems.id,
+      ownerEmail: schema.designSystems.ownerEmail,
+    })
+    .from(schema.designSystems)
+    .where(eq(schema.designSystems.id, baseLocalDesignSystemId))
+    .limit(1);
+  const localDesignSystemId =
+    existing && existing.ownerEmail !== ownerEmail
+      ? `${baseLocalDesignSystemId}-${nanoid(8)}`
+      : baseLocalDesignSystemId;
+  if (existing && existing.ownerEmail === ownerEmail) {
+    await db
+      .update(schema.designSystems)
+      .set({
+        title,
+        description:
+          description ??
+          `Builder indexed design system ${result.designSystemId}`,
+        data: localData,
+        assets: "[]",
+        customInstructions,
+        updatedAt: now,
+      })
+      .where(eq(schema.designSystems.id, existing.id));
+  } else {
+    const [ownedSystem] = await db
+      .select({ id: schema.designSystems.id })
+      .from(schema.designSystems)
+      .where(eq(schema.designSystems.ownerEmail, ownerEmail))
+      .limit(1);
+    await db.insert(schema.designSystems).values({
+      id: localDesignSystemId,
+      title,
+      description:
+        description ?? `Builder indexed design system ${result.designSystemId}`,
+      data: localData,
+      assets: "[]",
+      customInstructions,
+      isDefault: !ownedSystem,
+      ownerEmail,
+      orgId: orgId ?? null,
+      createdAt: now,
+      updatedAt: now,
+    });
+  }
+
+  return {
+    localDesignSystemId,
+    instructions: [
+      "Builder design-system indexing has started.",
+      `Builder design system: ${result.designSystemId}`,
+      `Local selectable design system: ${localDesignSystemId}`,
+      `Builder job: ${result.jobId}`,
+      `Open: ${result.builderUrl}`,
+      "Use the local design system id in Slides flows; Builder remains the source of truth for the indexed brand kit.",
+    ].join("\n"),
+  };
+}

package/corpus/templates/slides/server/plugins/agent-chat.ts

@@ -8,6 +8,8 @@ import actionsRegistry from "../../.generated/actions-registry.js";
 import { prepareSlidesChatAttachments } from "../lib/chat-attachments.js";
 import "../register-secrets.js";
 
+const SLIDES_BACKGROUND_RUN_SOFT_TIMEOUT_MS = 13 * 60_000;
+
 const INITIAL_TOOL_NAMES = [
   "view-screen",
   "list-decks",
@@ -31,7 +33,8 @@ export default createAgentChatPlugin({
   appId: "slides",
   actions: loadActionsFromStaticRegistry(actionsRegistry),
   initialToolNames: INITIAL_TOOL_NAMES,
-  runSoftTimeoutMs: 240_000,
+  durableBackgroundRuns: true,
+  runSoftTimeoutMs: SLIDES_BACKGROUND_RUN_SOFT_TIMEOUT_MS,
   // Enable sandboxed JavaScript execution so Slides agents can fetch,
   // paginate, and reduce provider data through providerFetch() without us
   // hardcoding one action per Google Drive endpoint.

package/corpus/templates/slides/server/routes/api/index-design-system-with-builder.post.ts

@@ -0,0 +1 @@
+export { indexDesignSystemWithBuilder as default } from "../../handlers/index-design-system-with-builder";

package/dist/action.d.ts

@@ -266,6 +266,10 @@ interface DefineActionWithSchema<TSchema extends StandardSchemaV1, TReturn = any
      *  Defaults to true. Set to false only for metadata/read actions that safely
      *  handle `ctx.userEmail` / `getRequestUserEmail()` being undefined. */
     requiresAuth?: boolean;
+    /** Max HTTP request body in bytes. When set, the route 413s on the declared
+     *  `Content-Length` before parsing. Use for public, no-auth POST actions;
+     *  unset = no route-level cap. */
+    maxBodyBytes?: number;
     /** Whether this action is exposed to the agent — the in-app assistant and the
      *  app's MCP/A2A tool surfaces — as a callable tool. **Default-allow opt-out**:
      *  `undefined` / `true` expose it; only an explicit `false` hides it from every
@@ -314,6 +318,13 @@ interface DefineActionWithSchema<TSchema extends StandardSchemaV1, TReturn = any
     /** Optional native Agent-Native chat renderer for this action's structured
      *  result. This is first-party React UI, not arbitrary HTML/JS. */
     chatUI?: ActionChatUIConfig;
+    /**
+     * Per-tool timeout override in milliseconds for agent-loop tool calls. Use
+     * sparingly for actions that legitimately wait on slow provider work.
+     */
+    timeoutMs?: number;
+    /** Per-tool result truncation override for agent-loop tool calls. */
+    maxResultChars?: number;
     /**
      * Opt-in human-in-the-loop approval gate. **Default off** — the framework
      * intentionally keeps HITL approvals rare; almost every action should run
@@ -361,6 +372,9 @@ interface DefineActionWithParams<TParams extends Record<string, ParameterSchema>
     /** Whether the HTTP/frontend action route must have an authenticated owner.
      *  Defaults to true. See the schema overload above. */
     requiresAuth?: boolean;
+    /** Max HTTP request body in bytes; 413s on `Content-Length` before parsing.
+     *  See the schema overload above. */
+    maxBodyBytes?: number;
     /** Whether this action is exposed to the agent as a callable tool. Only an
      *  explicit `false` hides it from every agent tool list while keeping it
      *  frontend/HTTP-callable. See the schema overload above and actions.md. */
@@ -383,6 +397,10 @@ interface DefineActionWithParams<TParams extends Record<string, ParameterSchema>
     mcpApp?: ActionMcpAppConfig;
     /** Optional native Agent-Native chat renderer. See schema overload above. */
     chatUI?: ActionChatUIConfig;
+    /** Per-tool timeout override in milliseconds. See schema overload above. */
+    timeoutMs?: number;
+    /** Per-tool result truncation override. See schema overload above. */
+    maxResultChars?: number;
     /** Opt-in human-in-the-loop approval gate (default off). See the schema
      *  overload above for full semantics. */
     needsApproval?: boolean | ((args: InferParams<TParams>, ctx?: ActionRunContext) => boolean | Promise<boolean>);
@@ -413,6 +431,7 @@ export interface ActionDefinition<TInput, TReturn> {
     readonly tool: import("./agent/types.js").ActionTool;
     readonly http?: ActionHttpConfig | false;
     readonly requiresAuth?: boolean;
+    readonly maxBodyBytes?: number;
     readonly agentTool?: boolean;
     readonly readOnly?: boolean;
     readonly parallelSafe?: boolean;
@@ -421,6 +440,10 @@ export interface ActionDefinition<TInput, TReturn> {
     readonly link?: ActionLinkBuilder;
     readonly mcpApp?: ActionMcpAppConfig;
     readonly chatUI?: ActionChatUIConfig;
+    /** Per-tool timeout override in milliseconds for agent-loop tool calls. */
+    readonly timeoutMs?: number;
+    /** Per-tool result truncation override for agent-loop tool calls. */
+    readonly maxResultChars?: number;
     /** Standard Schema the action's RETURN value is validated against after
      *  `run()` resolves. Present only when the caller passed `outputSchema`. */
     readonly outputSchema?: StandardSchemaV1;