@datalayer/agent-runtimes 1.3.79 → 1.3.81

package/lib/types/agentspecs.d.ts

@@ -538,14 +538,42 @@ export interface AppChecksSpec {
     gates: string[];
     track: string;
 }
+/** A function of the host page the application's agent may call (LOOP D-10). */
+export interface AppHostFunctionSpec {
+    /** Lower-case words joined by `_`: called as the tool `host_<name>`. */
+    name: string;
+    /** What it does, for the agent: when to call it. */
+    description: string;
+    /** Its arguments, a JSON Schema of `type: object`. */
+    parameters: Record<string, unknown>;
+}
+/**
+ * What the host page and an embedded application say to each other (LOOP
+ * D-10): the host's values it reads (`user`, `page`, or the host's own),
+ * through the tool `host_context`, and the host's functions it may call,
+ * each through `host_<name>` — every one of them decided by a rule that
+ * names it.
+ */
+export interface AppHostBridgeSpec {
+    context: string[];
+    functions: AppHostFunctionSpec[];
+}
 export interface AppDeploymentSpec {
     hosted?: {
         visibility: 'private' | 'invited' | 'organization' | 'link' | 'public';
         slug: string;
+        /**
+         * At its address, only its character (LOOP T-21): the conversation
+         * opens in its balloon, as when it is shipped as `assistant`. Off
+         * unless said.
+         */
+        characterAlone?: boolean;
     };
     embedded?: {
         mode: AppEmbedMode;
         origins: string[];
+        /** What the host page passes it and the functions of the host it may call (LOOP D-10). */
+        host?: AppHostBridgeSpec;
     };
 }
 /** What starts a worker's work. */

package/package.json

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

package/scripts/codegen/generate_apps.py

@@ -53,6 +53,7 @@ CAMEL = {
     "min_confidence": "minConfidence",
     "decision_model": "decisionModel",
     "backend_tools": "backendTools",
+    "character_alone": "characterAlone",
 }
 
 #: The keys whose value is carried as it is written: a component tree, weights by name.
@@ -90,6 +91,12 @@ def load_specs(specs_dir: Path) -> tuple[list[dict[str, Any]], dict[str, Any]]:
         spec["interface"]["layout"] = app.layout.value
         spec["record"]["retention_days"] = app.record.retention_days
         spec["setup"] = apps_module.app_setup(app)
+        # What TypeScript reads only when it is said: off, or none.
+        deployment = spec.get("deployment") or {}
+        if (deployment.get("hosted") or {}).get("character_alone") is False:
+            del deployment["hosted"]["character_alone"]
+        if deployment.get("embedded") and deployment["embedded"].get("host") is None:
+            del deployment["embedded"]["host"]
         behaviours[identity] = {
             tool: behaviour.value
             for tool, behaviour in sorted(apps_module.tool_behaviours(app).items())