@frontera-sdk/functions 1.50.57 → 1.50.59

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontera-sdk/functions",
-  "version": "1.50.57",
+  "version": "1.50.59",
   "description": "Author Frontera functions: manifest, triggers and the typed handler contract.",
   "keywords": [
     "frontera",
@@ -42,7 +42,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@frontera-sdk/blueprint": "1.50.57",
+    "@frontera-sdk/blueprint": "1.50.59",
     "cron-parser": "^5.0.6"
   }
 }

package/src/runtime-context.ts

@@ -575,7 +575,7 @@ export function buildContext(deps: Deps): AutomationContext {
 
     agent(slug: string) {
       return {
-        run: (prompt: string, options?: { files?: Array<{ fileId: string }> }) =>
+        run: (prompt: string, options?: { files?: Array<{ fileId: string }>; timeoutMs?: number }) =>
           step('agent', `agent:${slug}`, async () => {
             requireGrant(`agent:${slug}:run`)
             // `files` hands the agent already-uploaded files by canonical id —
@@ -590,6 +590,7 @@ export function buildContext(deps: Deps): AutomationContext {
                 slug,
                 prompt,
                 ...(options?.files?.length ? { files: options.files.map((f) => ({ fileId: f.fileId })) } : {}),
+                ...(options?.timeoutMs !== undefined ? { timeoutMs: options.timeoutMs } : {}),
               }),
             })
             if (!res.ok) throw new Error(`agent ${slug} → ${res.status} ${await refusal(res)}`)

package/src/types.ts

@@ -216,8 +216,12 @@ export interface AgentHandle {
    * carries, so an input forwards directly: `run(p, { files: [ctx.input.doc] })`.
    * Each id is authorized against this run's workspace and the bytes are staged
    * onto the agent's computer; the agent is told the staged paths.
+   *
+   * `options.timeoutMs` waits longer than the default 120 s for work known to
+   * be long (a long scanned document); the service caps it at 480 s, under
+   * the run's own 10-minute ceiling.
    */
-  run(prompt: string, options?: { files?: readonly FileRef[] }): Promise<{ text: string }>
+  run(prompt: string, options?: { files?: readonly FileRef[]; timeoutMs?: number }): Promise<{ text: string }>
 }
 
 /**