@datalayer/agent-runtimes 1.0.3 → 1.0.4

package/lib/specs/tools.js

@@ -10,9 +10,10 @@ export const RUNTIME_ECHO_TOOL_SPEC_0_0_1 = {
     version: '0.0.1',
     name: 'Runtime Echo',
     description: 'Echo text back to the caller for quick runtime verification.',
-    tags: ['runtime', 'utility'],
+    tags: ["runtime", "utility"],
     enabled: true,
     approval: 'auto',
+    timeout: undefined,
     requiresApproval: false,
     runtime: {
         language: 'python',
@@ -27,9 +28,10 @@ export const RUNTIME_SEND_MAIL_TOOL_SPEC_0_0_1 = {
     version: '0.0.1',
     name: 'Runtime Send Mail (Fake)',
     description: 'Fake mail sender for tool approval demos; returns a simulated send receipt.',
-    tags: ['runtime', 'approval', 'mail'],
+    tags: ["runtime", "approval", "mail"],
     enabled: true,
     approval: 'manual',
+    timeout: undefined,
     requiresApproval: true,
     runtime: {
         language: 'python',
@@ -44,9 +46,10 @@ export const RUNTIME_SENSITIVE_ECHO_TOOL_SPEC_0_0_1 = {
     version: '0.0.1',
     name: 'Runtime Sensitive Echo',
     description: 'Echo text with a manual approval checkpoint before execution.',
-    tags: ['runtime', 'approval'],
+    tags: ["runtime", "approval"],
     enabled: true,
     approval: 'manual',
+    timeout: '5h0m0s',
     requiresApproval: true,
     runtime: {
         language: 'python',

package/lib/specs/triggers.js

@@ -12,35 +12,10 @@ export const EVENT_TRIGGER_SPEC_0_0_1 = {
     description: 'Trigger on specific events such as a webhook call, API request, database change, file upload, or email arrival.',
     type: 'event',
     fields: [
-        {
-            name: 'event_source',
-            label: 'Event Source URL',
-            type: 'string',
-            required: false,
-            placeholder: 'https://helpdesk.example.com/webhooks',
-            help: 'Allowed event source URL (leave empty to allow any source)',
-        },
-        {
-            name: 'event',
-            label: 'Event Name',
-            type: 'string',
-            required: false,
-            placeholder: 'email_received',
-        },
-        {
-            name: 'description',
-            label: 'Description',
-            type: 'string',
-            required: false,
-            placeholder: "Description (e.g. 'Triggered on incoming email')",
-        },
-        {
-            name: 'prompt',
-            label: 'Trigger Prompt',
-            type: 'string',
-            required: false,
-            placeholder: 'Handle the incoming event and execute the agent end-to-end.',
-        },
+        { name: 'event_source', label: 'Event Source URL', type: 'string', required: false, placeholder: 'https://helpdesk.example.com/webhooks', help: 'Allowed event source URL (leave empty to allow any source)' },
+        { name: 'event', label: 'Event Name', type: 'string', required: false, placeholder: 'email_received' },
+        { name: 'description', label: 'Description', type: 'string', required: false, placeholder: 'Description (e.g. \'Triggered on incoming email\')' },
+        { name: 'prompt', label: 'Trigger Prompt', type: 'string', required: false, placeholder: 'Handle the incoming event and execute the agent end-to-end.' },
     ],
 };
 export const ONCE_TRIGGER_SPEC_0_0_1 = {
@@ -50,13 +25,7 @@ export const ONCE_TRIGGER_SPEC_0_0_1 = {
     description: 'Execute agent immediately after deployment.',
     type: 'once',
     fields: [
-        {
-            name: 'prompt',
-            label: 'Trigger Prompt',
-            type: 'string',
-            required: false,
-            placeholder: 'Start when requested by a user and complete the agent once.',
-        },
+        { name: 'prompt', label: 'Trigger Prompt', type: 'string', required: false, placeholder: 'Start when requested by a user and complete the agent once.' },
     ],
 };
 export const SCHEDULE_TRIGGER_SPEC_0_0_1 = {
@@ -66,37 +35,18 @@ export const SCHEDULE_TRIGGER_SPEC_0_0_1 = {
     description: 'Run on a recurring schedule using a cron expression (e.g. daily at 9 AM, every Monday, monthly on the 1st).',
     type: 'schedule',
     fields: [
-        {
-            name: 'cron',
-            label: 'Cron Expression',
-            type: 'string',
-            required: true,
-            placeholder: '0 9 * * * (every day at 9 AM)',
-            font: 'mono',
-        },
-        {
-            name: 'description',
-            label: 'Description',
-            type: 'string',
-            required: false,
-            placeholder: "Description (e.g. 'Monthly sales report')",
-        },
-        {
-            name: 'prompt',
-            label: 'Trigger Prompt',
-            type: 'string',
-            required: false,
-            placeholder: 'Run the scheduled agent and produce the configured deliverable.',
-        },
+        { name: 'cron', label: 'Cron Expression', type: 'string', required: true, placeholder: '0 9 * * * (every day at 9 AM)', font: 'mono' },
+        { name: 'description', label: 'Description', type: 'string', required: false, placeholder: 'Description (e.g. \'Monthly sales report\')' },
+        { name: 'prompt', label: 'Trigger Prompt', type: 'string', required: false, placeholder: 'Run the scheduled agent and produce the configured deliverable.' },
     ],
 };
 // ============================================================================
 // Trigger Catalog
 // ============================================================================
 export const TRIGGER_CATALOG = {
-    event: EVENT_TRIGGER_SPEC_0_0_1,
-    once: ONCE_TRIGGER_SPEC_0_0_1,
-    schedule: SCHEDULE_TRIGGER_SPEC_0_0_1,
+    'event': EVENT_TRIGGER_SPEC_0_0_1,
+    'once': ONCE_TRIGGER_SPEC_0_0_1,
+    'schedule': SCHEDULE_TRIGGER_SPEC_0_0_1,
 };
 export function getTriggerSpecs() {
     return Object.values(TRIGGER_CATALOG);

package/lib/types/tools.d.ts

@@ -27,6 +27,8 @@ export interface ToolSpec {
     enabled: boolean;
     /** Approval policy for this tool */
     approval: 'auto' | 'manual';
+    /** Approval timeout duration (e.g. 0h5m0s, 2d6h, 1mo2d3h4m5s) */
+    timeout?: string;
     /** Whether tool requires human approval before execution */
     requiresApproval?: boolean;
     /** Runtime binding metadata */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalayer/agent-runtimes",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "type": "module",
   "workspaces": [
     ".",

package/scripts/codegen/generate_agents.py

@@ -192,7 +192,10 @@ from agent_runtimes.types import AgentSpec
 
             # Clean description for Python (single line)
             description = (
-                spec["description"].replace("\n", " ").replace("  ", " ").strip()
+                spec["description"]
+                .replace("\n", " ")
+                .replace("  ", " ")
+                .strip()
                 .replace('"', '\\"')
             )
 

package/scripts/codegen/generate_events.py

@@ -100,7 +100,9 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
     for spec in specs:
         event_id = spec["id"]
         version = spec["version"]
-        const_name = f"{event_id.upper().replace('-', '_')}_EVENT_SPEC{version_suffix(version)}"
+        const_name = (
+            f"{event_id.upper().replace('-', '_')}_EVENT_SPEC{version_suffix(version)}"
+        )
         desc = _esc_dq(spec.get("description", "").strip().replace("\n", " "))
         kind = spec.get("kind", event_id)
         fields = spec.get("fields", [])
@@ -135,7 +137,9 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
     for spec in specs:
         event_id = spec["id"]
         version = spec["version"]
-        const_name = f"{event_id.upper().replace('-', '_')}_EVENT_SPEC{version_suffix(version)}"
+        const_name = (
+            f"{event_id.upper().replace('-', '_')}_EVENT_SPEC{version_suffix(version)}"
+        )
         lines.append(f'    "{event_id}": {const_name},')
     lines.extend(
         [
@@ -201,7 +205,9 @@ def generate_typescript_code(specs: list[dict[str, Any]]) -> str:
     for spec in specs:
         event_id = spec["id"]
         version = spec["version"]
-        const_name = f"{event_id.upper().replace('-', '_')}_EVENT_SPEC{version_suffix(version)}"
+        const_name = (
+            f"{event_id.upper().replace('-', '_')}_EVENT_SPEC{version_suffix(version)}"
+        )
         desc = _esc(spec.get("description", "").strip().replace("\n", " "))
         kind = spec.get("kind", event_id)
         fields = spec.get("fields", [])
@@ -246,7 +252,9 @@ def generate_typescript_code(specs: list[dict[str, Any]]) -> str:
     for spec in specs:
         event_id = spec["id"]
         version = spec["version"]
-        const_name = f"{event_id.upper().replace('-', '_')}_EVENT_SPEC{version_suffix(version)}"
+        const_name = (
+            f"{event_id.upper().replace('-', '_')}_EVENT_SPEC{version_suffix(version)}"
+        )
         lines.append(f"  '{event_id}': {const_name},")
     lines.extend(
         [

package/scripts/codegen/generate_tools.py

@@ -7,6 +7,7 @@ Generate Python and TypeScript code from YAML tool specifications.
 """
 
 import argparse
+import re
 import sys
 from pathlib import Path
 from typing import Any
@@ -57,6 +58,19 @@ def _requires_approval(spec: dict[str, Any]) -> bool:
     return str(spec.get("approval", "auto")).lower() == "manual"
 
 
+def _timeout_hms(spec: dict[str, Any]) -> str | None:
+    raw = spec.get("timeout")
+    if raw in (None, ""):
+        return None
+    value = str(raw).strip()
+    if not re.fullmatch(r"(?i)(?:\d+mo|\d+d|\d+h|\d+m|\d+s)+", value):
+        raise ValueError(
+            f"Tool '{spec.get('id', '<unknown>')}' has invalid timeout '{raw}'. "
+            "Expected duration format like '0h5m0s', '2d6h', or '1mo2d3h4m5s'."
+        )
+    return value
+
+
 def load_tool_specs(specs_dir: Path) -> list[dict[str, Any]]:
     specs: list[dict[str, Any]] = []
     for yaml_file in sorted(specs_dir.glob("*.yaml")):
@@ -99,8 +113,10 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
         )
         runtime = _require_runtime(spec)
         requires_approval = _requires_approval(spec)
+        timeout = _timeout_hms(spec)
         icon = f'"{spec.get("icon")}"' if spec.get("icon") else "None"
         emoji = f'"{spec.get("emoji")}"' if spec.get("emoji") else "None"
+        timeout_py = f'"{timeout}"' if timeout else "None"
 
         lines.extend(
             [
@@ -112,6 +128,7 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
                 f"    tags={_fmt_list(spec.get('tags', []))},",
                 f"    enabled={spec.get('enabled', True)},",
                 f'    approval="{spec.get("approval", "auto")}",',
+                f"    timeout={timeout_py},",
                 f"    requires_approval={requires_approval},",
                 "    runtime=ToolRuntimeSpec(",
                 f'        language="{runtime["language"]}",',
@@ -201,9 +218,11 @@ def generate_typescript_code(specs: list[dict[str, Any]]) -> str:
         )
         runtime = _require_runtime(spec)
         requires_approval = _requires_approval(spec)
+        timeout = _timeout_hms(spec)
         tags_json = str(spec.get("tags", [])).replace("'", '"')
         icon = f"'{spec.get('icon')}'" if spec.get("icon") else "undefined"
         emoji = f"'{spec.get('emoji')}'" if spec.get("emoji") else "undefined"
+        timeout_ts = f"'{timeout}'" if timeout else "undefined"
 
         lines.extend(
             [
@@ -215,6 +234,7 @@ def generate_typescript_code(specs: list[dict[str, Any]]) -> str:
                 f"  tags: {tags_json},",
                 f"  enabled: {str(spec.get('enabled', True)).lower()},",
                 f"  approval: '{spec.get('approval', 'auto')}',",
+                f"  timeout: {timeout_ts},",
                 f"  requiresApproval: {str(requires_approval).lower()},",
                 "  runtime: {",
                 f"    language: '{runtime['language']}',",

package/style/primer-primitives.css

@@ -3,14 +3,9 @@
  * Distributed under the terms of the Modified BSD License.
  */
 
-/*
- * Copyright (c) 2021-2024 Datalayer, Inc.
- *
- * Datalayer License
- */
-
 @import url('~@primer/primitives/dist/css/base/size/size.css');
 @import url('~@primer/primitives/dist/css/base/typography/typography.css');
+@import url('~@primer/primitives/dist/css/base/motion/motion.css');
 @import url('~@primer/primitives/dist/css/functional/size/border.css');
 @import url('~@primer/primitives/dist/css/functional/size/breakpoints.css');
 @import url('~@primer/primitives/dist/css/functional/size/size-coarse.css');