digipair 0.113.1 → 0.114.2

package/assets/default.json

@@ -0,0 +1,10 @@
+{
+  "name": "default",
+  "description": "default actions.",
+  "metadata": { "color": "#3b82f6" },
+  "libraries": {},
+  "variables": {},
+  "privates": {
+    "MODEL_DSP": [{ "library": "@digipair/skill-dsp", "element": "modelOpenAI" }]
+  }
+}

package/assets/digipairs/AGENTS.md

@@ -0,0 +1,189 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+
+- Source: JSON-based agent, tool, and workflow definitions at the repo root.
+- Agents: `tardi-*`, `studio`, `common`, `worker-skill-builder` (each contains `config.json`, `schema.json`, `*.json` actions/boosts/workflows, and `avatar.png`).
+- Tools: `tool-*` directories (HTTP, JSON, PDF, OAuth2, Sharp, etc.).
+- Core config: `default.json` (global settings), `planning.jsonl` (cron-like scheduled tasks).
+
+## Build, Test, and Development Commands
+
+- Build: none. The Digipair/Tessi runtime consumes these JSON files directly.
+- Validate JSON: `jq . tool-http/config.json` (repeat for edited files).
+- Find required fields: `rg -n "metadata.output"` to confirm actions declare output schema.
+- OpenAPI lint (optional): `npx @redocly/cli lint tool-http/schema.json`.
+- Runtime check: load/reload the repository in the Digipair runtime; watch logs for schema or dependency errors.
+
+## Coding Style & Naming Conventions
+
+- Format: valid JSON, 2-space indentation, no trailing commas.
+- Naming: directories kebab-case; files kebab-case with intent, e.g., `action-*.json`, `workflow-*.json`.
+- Schemas: `schema.json` must be OpenAPI 3.0 compliant; do not edit schemas to register new reasonings (they are auto-discovered).
+- Libraries: prefer `latest` for `@digipair/skill-*` entries unless a pin is required.
+
+## Testing Guidelines
+
+- Syntax: validate all edited JSON with `jq`.
+- Contract: ensure every action declares `metadata.output` with the expected result schema.
+- OpenAPI: validate `schema.json` with an OpenAPI linter.
+- Smoke test: run affected boosts/actions in the runtime UI; verify variables, conditions, and file flows (e.g., S3 `reference`) behave as expected.
+
+## Commit & Pull Request Guidelines
+
+- Commits: use concise Conventional-style prefixes seen in history (e.g., `feat: ...`, `fix: ...`). Keep summaries imperative and under ~72 chars.
+- PRs: include purpose, scope, sample paths touched (e.g., `tool-pdf/*`), and screenshots only if UI-facing. Link issues/tickets. Checklist: JSON valid, schemas linted, `metadata.output` present, no secrets committed.
+
+## Security & Configuration Tips
+
+- Do not commit secrets or real endpoints; use placeholders and environment-based configuration where applicable.
+
+## Project Architecture
+
+This is a **Digipair Agent Factory** containing example configurations for a Tardigrade/Tessi system. The project provides templates and examples for creating AI agents, tools, and automated workflows using the Digipair framework.
+
+### Agent Types
+
+- **common**: Shared agent with common actions and utilities
+- **studio**: Development studio agent for managing digipairs, tools, and workers
+
+### Tool Categories
+
+- **tool-\* directories**: Various service integrations (HTTP, JSON, PDF, OAuth2, etc.)
+- **worker-\* directories**: Digital agent expert in a specific trade/domain
+
+### Core Configuration Structure
+
+- `default.json`: Global default configuration with model endpoints and system paths
+- `planning.jsonl`: JSONL file containing scheduled tasks by cron
+
+### Configuration File Structure
+
+Each agent/tool directory contains:
+
+- `config.json`: Main configuration with metadata, skill dependencies, and variables
+- `schema.json`: OpenAPI 3.0 schema defining available API endpoints
+- `*.json`: Individual reasoning files (actions, boosts, workflows)
+- `avatar.png`: Visual representation of the agent
+
+### Skill System Architecture
+
+The Digipair framework uses a modular skill system:
+
+- `@digipair/skill-*`: Main framework skills (basic, chatbot, editor, http, etc.)
+- Libraries defined in `config.json` under the `libraries` and `webLibraries` sections
+- All versions generally set to "latest"
+
+### Model Configuration
+
+The `default.json` file configures AI model endpoints:
+
+- `MODEL_DSP` / `MODEL_LLM`: Main language models (using vLLM with Gemma 3)
+- `MODEL_DSP_VISION` / `MODEL_VISION`: Vision-capable models
+- `MODEL_EMBEDDINGS`: Embedding models (using Alibaba GTE-Qwen2)
+
+### Reasoning and Workflow System
+
+**Reasoning Files**: JSON-based workflow definitions that can be:
+
+- **Actions**: Simple API endpoints or operations
+- **Workflows**: Multi-step automated processes
+
+### Working with Agent Configurations
+
+#### Configuration Guidelines
+
+1. **JSON Syntax**: All files must be valid JSON—syntax errors break the entire system
+2. **Schema Compliance**: `schema.json` files must follow the OpenAPI 3.0 specification
+3. **Library Versions**: Use "latest" for all `@digipair/skill-*` dependencies
+4. **Metadata**: Controls UI appearance (colors, avatars, descriptions)
+
+#### Key Configuration Templates
+
+**Agent Metadata**:
+
+```json
+"metadata": {
+  "color": "#3b82f6",
+  "primary": "#51E0DC",
+  "textPrimary": "#242E3B"
+}
+```
+
+**Skill Dependencies**:
+
+```json
+"libraries": {
+  "@digipair/skill-basic": "latest",
+  "@digipair/skill-chatbot": "latest"
+},
+"webLibraries": {
+  "blockly": "latest",
+  "toastify-js": "latest"
+}
+```
+
+### Scheduled Automation
+
+**planning.jsonl Structure**:
+
+- Each line is a separate JSON object with cron scheduling
+- Current scheduled tasks:
+  - Daily consumption calculation (3 AM)
+  - Log cleanup (3:30 AM)
+- Reference to specific digipair and reasoning combinations
+
+### Development Environment
+
+- **No Build System**: JSON configurations are loaded directly by the Digipair runtime
+- **Hot Reloading**: Changes take effect when the system reloads configurations
+- **No Package Management**: Dependencies managed via the skill system
+- **Runtime Validation**: Invalid JSON or missing dependencies cause runtime errors
+
+### File Type Reference
+
+- `config.json`: Agent/tool configuration and dependencies
+- `schema.json`: OpenAPI 3.0 API definitions
+- `*.json`: Reasoning files (actions, boosts, workflows)
+- `planning.jsonl`: Scheduled tasks by cron (JSONL format)
+- `avatar.png`: 256x256 agent avatars
+- `default.json`: Global system configuration
+
+### Action JSON
+
+- An action must always have a JSON schema for the output format in the `metadata.output` parameter
+- Do not update the `schema.json` file when adding JSON reasoning files, as they are added automatically
+- Do not handle error cases (try/catch) in actions—leave error handling to the factory
+- Expressions used after the "FEEL:" keyword are in DMN FEEL format
+- String values in properties are interpreted by Handlebars by default, unless they start with "FEEL:"
+
+### List of Usable DMN FEEL Functions
+
+In addition to standard DMN FEEL language functions, the following functions can be used within an action:
+
+```typescript
+  getTime: (time: string) => new Date(time).getTime(),
+  fromTime: (time: number) => new Date(time).toISOString(),
+  atob: (value: string) => atob(value),
+  btoa: (value: string) => btoa(value),
+  encodeURIComponent: (value: string | number | boolean) => encodeURIComponent(value),
+  decodeURIComponent: (value: string) => decodeURIComponent(value),
+  encodeUTF8: (value: string) =>
+    Array.from(new TextEncoder().encode(value))
+      .map(b => String.fromCharCode(b))
+      .join(''),
+  decodeUTF8: (value: string) =>
+    new TextDecoder().decode(new Uint8Array(Array.from(value).map(c => c.charCodeAt(0)))),
+  JSONparse: (value: string) => JSON.parse(value),
+  JSONstringify: (value: string) => JSON.stringify(value),
+```
+
+### List of Usable Handlebars Functions
+
+In addition to standard Handlebars template language functions, the following functions can be used within an action:
+
+```typescript
+Handlebars.registerHelper('JSONstringify', function (value: any) {
+  return JSON.stringify(value);
+});
+```

package/assets/digipairs/common/answer.json

@@ -0,0 +1,90 @@
+{
+  "description": "Génération d'une réponse pour l'utilisateur via le chatbot.",
+  "library": "@digipair/skill-factory",
+  "element": "task",
+  "metadata": {},
+  "properties": {
+    "execute": [
+      {
+        "library": "@digipair/skill-basic",
+        "element": "setVariable",
+        "properties": {
+          "name": "userMessageId",
+          "execute": [
+            {
+              "library": "@digipair/skill-basic",
+              "element": "transform",
+              "properties": {
+                "value": "FEEL:if requester.request.body.prompt != null and requester.request.body.prompt != \"\" then getTime() else null"
+              }
+            }
+          ]
+        }
+      },
+      {
+        "library": "@digipair/skill-basic",
+        "element": "setVariable",
+        "properties": {
+          "name": "boost",
+          "value": {
+            "reasoning": "FEEL:requester.request.reasoning",
+            "step": "FEEL:request.body.boost[1].step",
+            "prompt": "FEEL:request.body.boost[1].prompt",
+            "required": "FEEL:request.body.boost[1].required",
+            "selector": "FEEL:request.body.boost[1].selector",
+            "url": "FEEL:request.body.boost[1].url",
+            "inputs": "FEEL:request.body.boost[1].inputs",
+            "context": "FEEL:requester.request.body.context"
+          }
+        },
+        "conditions": {
+          "if": "FEEL:request.body.boost[1]"
+        }
+      },
+      {
+        "library": "@digipair/skill-basic",
+        "element": "transform",
+        "properties": {
+          "value": {
+            "uuid": "FEEL:previous[1]",
+            "parent_history": "FEEL:variables.userMessageId",
+            "parent_conversation": "FEEL:requester.request.body.parent_conversation",
+            "assistant": "{{request.body.assistant}}",
+            "command": "FEEL:if request.body.command then request.body.command else []",
+            "boost": "FEEL:variables.boost",
+            "boosts": "FEEL:request.body.boosts",
+            "sources": "FEEL:request.body.sources",
+            "files": "FEEL:request.body.files",
+            "logs": "FEEL:request.body.logs"
+          }
+        }
+      },
+      {
+        "library": "@digipair/skill-factory",
+        "element": "execute",
+        "properties": {
+          "execute": [
+            {
+              "library": "@digipair/skill-chatbot",
+              "element": "answer",
+              "properties": {
+                "assistant": "FEEL:data.assistant",
+                "boosts": "FEEL:data.boosts",
+                "logs": "FEEL:data.logs",
+                "parent_conversation": "FEEL:data.parent_conversation",
+                "parent_history": "FEEL:data.parent_history",
+                "sources": "FEEL:data.sources",
+                "files": "FEEL:data.files",
+                "uuid": "FEEL:data.uuid",
+                "boost": "FEEL:data.boost",
+                "command": "FEEL:data.command"
+              }
+            }
+          ],
+          "context": "FEEL:context put(requester, \"data\", previous)"
+        }
+      }
+    ]
+  },
+  "pins": []
+}

package/assets/digipairs/common/avatar.png.json

@@ -0,0 +1,46 @@
+{
+  "description": "Vérifier si le fichier \"avatar.png\" est un format d'image valide et s'assurer qu'il peut être utilisé comme avatar (taille, résolution, contenu approprié).",
+  "summary": "Gestion des images",
+  "library": "@digipair/skill-service",
+  "element": "service",
+  "metadata": {},
+  "properties": {
+    "execute": [
+      {
+        "library": "@digipair/skill-basic",
+        "element": "setVariable",
+        "properties": {
+          "name": "avatar",
+          "execute": [
+            {
+              "library": "@digipair/skill-common",
+              "element": "avatar",
+              "properties": {
+                "digipair": "FEEL: request.digipair"
+              }
+            }
+          ]
+        }
+      },
+      {
+        "library": "@digipair/skill-service",
+        "element": "headers",
+        "properties": {
+          "headers": {
+            "Content-Type": "FEEL: substring(split(variables.avatar, \";base64,\")[1], 6)"
+          }
+        }
+      },
+      {
+        "library": "@digipair/skill-basic",
+        "element": "base64ToBuffer",
+        "properties": {
+          "base64": "FEEL: variables.avatar"
+        }
+      }
+    ]
+  },
+  "pins": [],
+  "digipair": "common",
+  "id": "avatar.png"
+}

package/assets/digipairs/common/boosts.json

@@ -0,0 +1,18 @@
+{
+  "summary": "Get boosts",
+  "description": "Get boosts for a Digipair.",
+  "metadata": {},
+  "library": "@digipair/skill-service",
+  "element": "service",
+  "properties": {
+    "execute": [
+      {
+        "library": "@digipair/skill-common",
+        "element": "boosts",
+        "properties": {
+          "digipair": "{{request.digipair}}"
+        }
+      }
+    ]
+  }
+}

package/assets/digipairs/common/chat.json

@@ -0,0 +1,18 @@
+{
+  "summary": "Chatbot",
+  "description": "Chatbot",
+  "library": "@digipair/skill-web",
+  "element": "page",
+  "metadata": {},
+  "properties": {
+    "body": [
+      {
+        "library": "@digipair/skill-web-chatbot",
+        "element": "digipair-chatbot-full",
+        "properties": { "code": "{{request.digipair}}" }
+      }
+    ],
+    "styleBody": "background-color:#212E3C;"
+  },
+  "pins": []
+}

package/assets/digipairs/common/config.json

@@ -0,0 +1,20 @@
+{
+  "name": "common",
+  "description": "common actions.",
+  "metadata": { "color": "#3b82f6" },
+  "libraries": {
+    "@digipair/skill-basic": "latest",
+    "@digipair/skill-factory": "latest",
+    "@digipair/skill-service": "latest",
+    "@digipair/skill-chatbot": "latest",
+    "@digipair/skill-dsp": "latest",
+    "@digipair/skill-sse": "latest",
+    "@digipair/skill-common": "latest",
+    "@digipair/skill-debug": "latest",
+    "@digipair/skill-web": "latest",
+    "@digipair/skill-web-chatbot": "latest",
+    "@digipair/skill-web-inputs": "latest"
+  },
+  "variables": {},
+  "privates": {}
+}

package/assets/digipairs/common/context.json

@@ -0,0 +1,76 @@
+{
+  "description": "Étude des éléments environnants pour comprendre le contexte.",
+  "summary": "Analyse contextuelle",
+  "library": "@digipair/skill-service",
+  "element": "service",
+  "metadata": {},
+  "properties": {
+    "execute": [
+      {
+        "library": "@digipair/skill-basic",
+        "element": "setVariable",
+        "properties": {
+          "name": "schema",
+          "execute": [
+            {
+              "library": "@digipair/skill-factory",
+              "element": "start",
+              "properties": {
+                "reasoning": "schema.json",
+                "digipair": "FEEL: request.digipair"
+              }
+            }
+          ]
+        }
+      },
+      {
+        "library": "@digipair/skill-basic",
+        "element": "setVariable",
+        "properties": {
+          "name": "context",
+          "execute": [
+            {
+              "library": "@digipair/skill-basic",
+              "element": "transform",
+              "properties": {
+                "value": "FEEL: get value(variables.schema.paths, \"/\" + request.body.reasoning).post.parameters"
+              }
+            },
+            {
+              "library": "@digipair/skill-basic",
+              "element": "transform",
+              "properties": {
+                "value": "FEEL: get value(variables.schema.paths, \"/\" + substring(request.body.reasoning, 7)).post.parameters"
+              },
+              "conditions": {
+                "if": "FEEL: previous = null and starts with(request.body.reasoning, \"boost-\")"
+              }
+            },
+            {
+              "library": "@digipair/skill-basic",
+              "element": "transform",
+              "properties": {
+                "value": []
+              },
+              "conditions": {
+                "if": "FEEL: previous = null"
+              }
+            }
+          ]
+        }
+      },
+      {
+        "library": "@digipair/skill-basic",
+        "element": "transform",
+        "properties": {
+          "value": {
+            "summary": "FEEL: variables.schema.info.summary",
+            "description": "FEEL: variables.schema.info.description",
+            "context": "FEEL: variables.context"
+          }
+        }
+      }
+    ]
+  },
+  "pins": []
+}

package/assets/digipairs/common/conversation.json

@@ -0,0 +1,66 @@
+{
+  "description": "Generating a response for the user via the chatbot.",
+  "summary": "Conversation",
+  "library": "@digipair/skill-chatbot",
+  "element": "boost",
+  "metadata": {
+    "standalone": false,
+    "selector": "any",
+    "url": "^$"
+  },
+  "properties": {
+    "steps": [
+      {
+        "name": "Conversation",
+        "execute": [
+          {
+            "library": "@digipair/skill-basic",
+            "element": "setVariable",
+            "properties": {
+              "name": "history",
+              "value": "FEEL:if request.body.inputs[1].value = null then []\nelse request.body.inputs[1].value"
+            }
+          },
+          {
+            "library": "@digipair/skill-dsp",
+            "element": "generate",
+            "properties": {
+              "signature": "\"You are a helpful assistant, capable of explaining concepts in a simple manner.\" \nuserQuestion:string,\nhistory?:string[] ->\n  answer: string \"Assistant answer\"",
+              "input": {
+                "userQuestion": "{{request.body.prompt}}",
+                "history": "FEEL:variables.history"
+              }
+            }
+          },
+          {
+            "library": "@digipair/skill-factory",
+            "element": "start",
+            "properties": {
+              "reasoning": "answer",
+              "body": {
+                "assistant": "{{previous.answer}}",
+                "boost": [
+                  {
+                    "prompt": true,
+                    "required": true,
+                    "step": "Conversation",
+                    "inputs": [
+                      {
+                        "library": "@digipair/skill-web-inputs",
+                        "element": "digipair-input-hidden",
+                        "properties": {
+                          "value": "FEEL:flatten([variables.history, [\n  \"user: \" + request.body.prompt,\n  \"assistant: \" + parent.previous.answer\n]])"
+                        }
+                      }
+                    ]
+                  }
+                ]
+              }
+            }
+          }
+        ]
+      }
+    ]
+  },
+  "pins": []
+}

package/assets/digipairs/common/history.json

@@ -0,0 +1,23 @@
+{
+  "summary": "History",
+  "description": "Return the start conversation history.",
+  "metadata": {},
+  "library": "@digipair/skill-service",
+  "element": "service",
+  "properties": {
+    "execute": [
+      {
+        "library": "@digipair/skill-basic",
+        "element": "transform",
+        "properties": {
+          "value": [
+            {
+              "role": "assistant",
+              "content": "Welcome! How may I assist you today?"
+            }
+          ]
+        }
+      }
+    ]
+  }
+}

package/assets/digipairs/common/mcp.json

@@ -0,0 +1,88 @@
+{
+  "description": "Exposition of the agent via the MCP (Model Context Protocol)",
+  "summary": "Model Context Protocol",
+  "library": "@digipair/skill-service",
+  "element": "service",
+  "metadata": {},
+  "properties": {
+    "execute": [
+      {
+        "library": "@digipair/skill-basic",
+        "element": "setVariable",
+        "properties": {
+          "name": "remote",
+          "execute": [
+            {
+              "library": "@digipair/skill-common",
+              "element": "metadata",
+              "properties": { "digipair": "FEEL: request.digipair" }
+            },
+            {
+              "library": "@digipair/skill-basic",
+              "element": "transform",
+              "properties": { "value": "FEEL: previous.remote" }
+            }
+          ]
+        }
+      },
+      {
+        "library": "@digipair/skill-basic",
+        "element": "transform",
+        "properties": {
+          "execute": [
+            {
+              "library": "@digipair/skill-factory",
+              "element": "stop",
+              "properties": { "value": 405 }
+            }
+          ]
+        },
+        "conditions": { "if": "FEEL: variables.remote != true" }
+      },
+      {
+        "library": "@digipair/skill-basic",
+        "element": "transform",
+        "properties": {
+          "execute": [
+            {
+              "library": "@digipair/skill-basic",
+              "element": "setVariable",
+              "properties": {
+                "name": "tools",
+                "execute": [
+                  {
+                    "library": "@digipair/skill-factory",
+                    "element": "start",
+                    "properties": { "reasoning": "schema.json" }
+                  },
+                  {
+                    "library": "@digipair/skill-basic",
+                    "element": "transform",
+                    "properties": {
+                      "value": {
+                        "name": "FEEL: substring(item.key, 2)",
+                        "description": "FEEL: item.value.post.description",
+                        "title": "FEEL: item.value.post.summary",
+                        "inputSchema": "FEEL: context(\n  for parameter in item.value.post.parameters return \n    { key: parameter.name, value: parameter.schema }\n)",
+                        "execute": "FEEL:  [\n  {\n    \"library\": \"@digipair/skill-factory\",\n    \"element\": \"start\",\n    \"properties\": {\n      \"reasoning\": substring(item.key, 2),\n      \"body\": \"FEEL: params\"\n    }\n  },\n  {\n    \"library\": \"@digipair/skill-basic\",\n    \"element\": \"transform\",\n    \"properties\": {\n      \"value\": \"FEEL: { content: [{ type: \\\"text\\\", text: JSONstringify(if previous != null then previous else {}) }], structuredContent: previous }\"\n    }\n  }\n]"
+                      }
+                    },
+                    "conditions": { "each": "FEEL: get entries(previous.paths)" }
+                  }
+                ]
+              }
+            },
+            {
+              "library": "@digipair/skill-mcp",
+              "element": "createServer",
+              "properties": { "tools": "FEEL: variables.tools" }
+            },
+            { "library": "@digipair/skill-factory", "element": "keepAlive" }
+          ]
+        },
+        "conditions": { "if": "FEEL: variables.remote = true" }
+      }
+    ]
+  },
+  "pins": []
+}

package/assets/digipairs/common/metadata.json

@@ -0,0 +1,18 @@
+{
+  "summary": "Get metadata",
+  "description": "Get metadata for a Digipair.",
+  "metadata": {},
+  "library": "@digipair/skill-service",
+  "element": "service",
+  "properties": {
+    "execute": [
+      {
+        "library": "@digipair/skill-common",
+        "element": "metadata",
+        "properties": {
+          "digipair": "{{request.digipair}}"
+        }
+      }
+    ]
+  }
+}