@datalayer/agent-runtimes 1.3.105 → 1.3.106

package/lib/specs/appspecSchema.js

@@ -1227,11 +1227,38 @@ export const APPSPEC_SCHEMA = {
                     title: 'Code',
                     type: 'string',
                 },
+                files: {
+                    description: 'Text files it is given with what it is asked, each in the message after it',
+                    items: {
+                        $ref: '#/$defs/AppTestFile',
+                    },
+                    title: 'Files',
+                    type: 'array',
+                },
             },
             required: ['ask', 'expect'],
             title: 'AppTestCase',
             type: 'object',
         },
+        AppTestFile: {
+            additionalProperties: false,
+            description: 'A text file a test gives with what it asks, as a person gives one on its page.',
+            properties: {
+                name: {
+                    description: 'Its name, without a folder: `orders.csv`',
+                    title: 'Name',
+                    type: 'string',
+                },
+                text: {
+                    description: 'What it holds',
+                    title: 'Text',
+                    type: 'string',
+                },
+            },
+            required: ['name', 'text'],
+            title: 'AppTestFile',
+            type: 'object',
+        },
         AppTests: {
             additionalProperties: false,
             description: 'How the application is verified.',

package/lib/types/agentspecs.d.ts

@@ -737,6 +737,13 @@ export interface AppInterfaceSpec {
      */
     outputs: string[];
 }
+/** A text file a test gives with what it asks, as a person gives one on its page. */
+export interface AppTestFileSpec {
+    /** Its name, without a folder: `orders.csv`. */
+    name: string;
+    /** What it holds. */
+    text: string;
+}
 export interface AppTestCaseSpec {
     ask: string;
     expect: string;
@@ -746,6 +753,11 @@ export interface AppTestCaseSpec {
      * the file. Empty, or absent, for a case in words alone.
      */
     code?: string;
+    /**
+     * Text files it is given with what it is asked, each in the message after
+     * it. Absent for a case in words alone.
+     */
+    files?: AppTestFileSpec[];
 }
 /**
  * What was verified, and how, each in a sentence a person reads (LOOP E-14):

package/package.json

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

package/scripts/codegen/generate_apps.py

@@ -128,6 +128,9 @@ def load_specs(specs_dir: Path) -> tuple[list[dict[str, Any]], dict[str, Any]]:
         for case in spec["tests"]["cases"]:
             if not case.get("code"):
                 case.pop("code", None)
+            # A case given files names them; the others say nothing of them.
+            if not case.get("files"):
+                case.pop("files", None)
         # Components of its own: said only when it has some.
         if not spec["interface"].get("custom_components"):
             spec["interface"].pop("custom_components", None)

package/scripts/validate_pap_examples.py

@@ -0,0 +1,44 @@
+# Copyright (c) 2025-2026 Datalayer, Inc.
+# Distributed under the terms of the Modified BSD License.
+
+"""Build every Agent Runtimes PAP example and reject duplicate identifiers."""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+from agent_runtimes.loop.apps.build import build
+
+ROOT = Path(__file__).parents[1]
+EXAMPLES = ROOT / "examples" / "personal-agent-protocol"
+
+
+def main() -> int:
+    """Validate each PAP application definition."""
+
+    app_ids: set[str] = set()
+    tool_names: set[tuple[str, str]] = set()
+    paths = sorted(EXAMPLES.glob("*/app.py"))
+    if not paths:
+        raise RuntimeError("No Agent Runtimes PAP examples were found")
+    for path in paths:
+        built = build(str(path))
+        app_id = built.application.spec.id
+        if app_id in app_ids:
+            raise RuntimeError(f"Duplicate example application id: {app_id}")
+        app_ids.add(app_id)
+        for tool in built.application.spec.tools:
+            key = (app_id, tool.name)
+            if key in tool_names:
+                raise RuntimeError(f"Duplicate example tool: {app_id}/{tool.name}")
+            tool_names.add(key)
+        sys.stdout.write(
+            f"{path.relative_to(ROOT)}: {app_id} "
+            f"({len(built.application.spec.tools)} tool)\n"
+        )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())