MadeTool tools.made-tool@1
Generated at from
openvibe-contracts v0.443.0 and
openvibe-sdk v0.177.0.
- Version
- 1.1.0
- Owner
- tools
- Visibility
- public
- Status
- active
- Compatibility
- backward
- Schema
https://openvibe.network/contracts/tools/made-tool.v1.json
A tool a person made on openvibe.tools (plan 2026-11-13 §AD.7 step 2; the owner, 11-15: "people should be able to make their own tools … AI or Codes to generate them … model selection and OpenVibe.exchange"). GET /api/v1/made-tools/:id answers one, GET /api/v1/made-tools (public ones) and /api/v1/made-tools?mine=1 (the caller's own) list them; POST makes one and PATCH changes it (each change is the next version); DELETE removes it. KIND says how it runs. A prompt tool is instructions and a model: a run sends the instructions and the input to the model through OpenVibe.AI as the person who runs it (on_behalf_of: their free allowance, their Vibes or their own keys pay, never the tool's maker), and the answer is result.data (output.kind json, checked against output.schema) or result.text (output.kind text). A code tool is one JavaScript entry pinned by its sha256 that runs as a skill-runner function job (JSON in on stdin, at most 64 KiB of JSON out, no spawn, write or eval, the network that NET allows) placed by OpenVibe.Run on HOSTING: openvibe (OpenVibe's runner), mine (the owner's own Link nodes) or shared (nodes that serve others). INPUT is the JSON Schema (2020-12) a run's input must match. VISIBILITY: private (the owner alone sees and runs it), unlisted (anyone with its id runs it; never listed or indexed) or public (listed, searchable, runnable by anyone signed in). RUN.PATH is POST /api/v1/made-tools/{id}/run, body { input }, answered with tools.run@1. A CHAIN tool (1.1.0) runs other tools in order: each step names a tool (a catalogue id or a made tool's mtl_ id) and its input, whose values may be templates: "{{input.<field>}}" (the chain's own input) or "{{steps.<n>.<path>}}" (an earlier step's result data, or text for a text result); a value that is only a template takes the value as it is, a template inside other words is written in as text. The chain's answer is the last step's result (output_from last) or every step's (all). A chain runs as the person who runs it: every step is one run with their own credentials and paid as that run is. RULES this schema enforces: a prompt tool has prompt and no code; a code tool has code and no prompt; a chain tool has chain and neither; json output has a schema.
Fields
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
id | string | yes | The tool's id. It never changes. |
|
owner | object | yes | Who made it. |
|
owner.subject | string | yes |
| |
owner.name | string | Their display name when the tool was read, for people. |
| |
slug | string | yes | A short name, unique among the owner's tools (summarize-email), for addresses and an agent's tool list. |
|
name | string | yes |
| |
summary | string | yes | One plain sentence: what the tool does. Agents read it to decide when to use the tool. |
|
kind | enum | yes | prompt: instructions run by a model through OpenVibe.AI. code: a JavaScript entry run as a skill-runner function job. chain (1.1.0): other tools run in order, each step's input from the chain's input or an earlier step. |
|
input | object | yes | JSON Schema (2020-12) of a run's input: an object schema. | |
input.type | const | yes |
| |
output | object | yes |
| |
output.kind | enum | yes | json: result.data, checked against schema. text: result.text. |
|
output.schema | object | JSON Schema of result.data. Required when kind is json. | ||
output.schema.type | const | yes |
| |
prompt | object | null | yes | A prompt tool's instructions and model; null for a code tool. | |
code | object | null | yes | A code tool's entry; null for a prompt tool. | |
net | enum | yes | The network a code tool may reach: none, the public internet (through the egress guard), or OpenVibe's own sites only. A prompt tool reaches no network (deny). |
|
hosting | enum | yes | Where a code tool runs: OpenVibe's runner, the owner's own Link nodes, or nodes shared with others. A prompt tool runs on OpenVibe (openvibe). |
|
visibility | enum | yes |
| |
version | integer | yes | 1 when made; each change adds one. |
|
run | object | yes |
| |
run.method | const | yes |
| |
run.path | string | yes |
| |
runs | integer | How many times it has run (all callers). |
| |
created_at | string | yes |
| |
updated_at | string | yes |
| |
chain | object | null | A chain tool's steps (1.1.0); absent or null for the other kinds. |
Examples
From the contract's own test fixtures: valid ones validate, rejected ones must fail.
Valid: chain-tool
{
"id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FB1",
"owner": {
"subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
"name": "Ada"
},
"slug": "site-check",
"name": "Site check",
"summary": "Looks up a domain's DNS, then summarizes it in plain words.",
"kind": "chain",
"input": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
}
},
"output": {
"kind": "text"
},
"prompt": null,
"code": null,
"net": "deny",
"hosting": "openvibe",
"visibility": "public",
"version": 3,
"run": {
"method": "POST",
"path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FB1/run"
},
"runs": 12,
"created_at": "2026-11-15T17:00:00.000Z",
"updated_at": "2026-11-15T17:40:00.000Z",
"chain": {
"steps": [
{
"tool": "dns",
"name": "Look up the DNS",
"input": {
"target": "{{input.domain}}"
}
},
{
"tool": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV",
"name": "Say it plainly",
"input": {
"message": "The DNS of {{input.domain}}: {{steps.0.records}}"
}
}
],
"output_from": "last"
}
}Valid: code-tool
{
"id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAX",
"owner": {
"subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW"
},
"slug": "csv-columns",
"name": "CSV columns",
"summary": "Lists a CSV's columns and how many rows it has.",
"kind": "code",
"input": {
"type": "object",
"required": [
"csv"
],
"properties": {
"csv": {
"type": "string",
"maxLength": 60000
}
}
},
"output": {
"kind": "json",
"schema": {
"type": "object",
"properties": {
"columns": {
"type": "array",
"items": {
"type": "string"
}
},
"rows": {
"type": "integer"
}
}
}
},
"prompt": null,
"code": {
"sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
"entry": "tool.js",
"source": "https://git.openvibe.codes/ada/csv-columns",
"bytes": 1412
},
"net": "deny",
"hosting": "mine",
"visibility": "private",
"version": 1,
"run": {
"method": "POST",
"path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FAX/run"
},
"created_at": "2026-11-15T17:00:00.000Z",
"updated_at": "2026-11-15T17:00:00.000Z"
}Valid: prompt-tool
{
"id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV",
"owner": {
"subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
"name": "Ada"
},
"slug": "reply-kindly",
"name": "Reply kindly",
"summary": "Drafts a short, kind reply to a message.",
"kind": "prompt",
"input": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string",
"maxLength": 4000
}
}
},
"output": {
"kind": "json",
"schema": {
"type": "object",
"required": [
"reply"
],
"properties": {
"reply": {
"type": "string"
}
}
}
},
"prompt": {
"instructions": "Write a short, kind reply to the message. Answer as JSON: { \"reply\": \"…\" }.",
"model": "auto",
"temperature": 0.4,
"max_tokens": 400
},
"code": null,
"net": "deny",
"hosting": "openvibe",
"visibility": "public",
"version": 3,
"run": {
"method": "POST",
"path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV/run"
},
"runs": 12,
"created_at": "2026-11-15T17:00:00.000Z",
"updated_at": "2026-11-15T17:40:00.000Z"
}Rejected: bad-slug
{
"id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV",
"owner": {
"subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
"name": "Ada"
},
"slug": "Reply Kindly",
"name": "Reply kindly",
"summary": "Drafts a short, kind reply to a message.",
"kind": "prompt",
"input": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string",
"maxLength": 4000
}
}
},
"output": {
"kind": "json",
"schema": {
"type": "object",
"required": [
"reply"
],
"properties": {
"reply": {
"type": "string"
}
}
}
},
"prompt": {
"instructions": "Write a short, kind reply to the message. Answer as JSON: { \"reply\": \"…\" }.",
"model": "auto",
"temperature": 0.4,
"max_tokens": 400
},
"code": null,
"net": "deny",
"hosting": "openvibe",
"visibility": "public",
"version": 3,
"run": {
"method": "POST",
"path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV/run"
},
"runs": 12,
"created_at": "2026-11-15T17:00:00.000Z",
"updated_at": "2026-11-15T17:40:00.000Z"
}Rejected: chain-one-step
{
"id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FB1",
"owner": {
"subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
"name": "Ada"
},
"slug": "site-check",
"name": "Site check",
"summary": "Looks up a domain's DNS, then summarizes it in plain words.",
"kind": "chain",
"input": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
}
},
"output": {
"kind": "text"
},
"prompt": null,
"code": null,
"net": "deny",
"hosting": "openvibe",
"visibility": "public",
"version": 3,
"run": {
"method": "POST",
"path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FB1/run"
},
"runs": 12,
"created_at": "2026-11-15T17:00:00.000Z",
"updated_at": "2026-11-15T17:40:00.000Z",
"chain": {
"steps": [
{
"tool": "dns",
"name": "Look up the DNS",
"input": {
"target": "{{input.domain}}"
}
}
]
}
}Rejected: chain-with-prompt
{
"id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FB1",
"owner": {
"subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
"name": "Ada"
},
"slug": "site-check",
"name": "Site check",
"summary": "Looks up a domain's DNS, then summarizes it in plain words.",
"kind": "chain",
"input": {
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
}
},
"output": {
"kind": "text"
},
"prompt": {
"instructions": "x",
"model": "auto"
},
"code": null,
"net": "deny",
"hosting": "openvibe",
"visibility": "public",
"version": 3,
"run": {
"method": "POST",
"path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FB1/run"
},
"runs": 12,
"created_at": "2026-11-15T17:00:00.000Z",
"updated_at": "2026-11-15T17:40:00.000Z",
"chain": {
"steps": [
{
"tool": "dns",
"name": "Look up the DNS",
"input": {
"target": "{{input.domain}}"
}
},
{
"tool": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV",
"name": "Say it plainly",
"input": {
"message": "The DNS of {{input.domain}}: {{steps.0.records}}"
}
}
],
"output_from": "last"
}
}Rejected: json-without-schema
{
"id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV",
"owner": {
"subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
"name": "Ada"
},
"slug": "reply-kindly",
"name": "Reply kindly",
"summary": "Drafts a short, kind reply to a message.",
"kind": "prompt",
"input": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string",
"maxLength": 4000
}
}
},
"output": {
"kind": "json"
},
"prompt": {
"instructions": "Write a short, kind reply to the message. Answer as JSON: { \"reply\": \"…\" }.",
"model": "auto",
"temperature": 0.4,
"max_tokens": 400
},
"code": null,
"net": "deny",
"hosting": "openvibe",
"visibility": "public",
"version": 3,
"run": {
"method": "POST",
"path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV/run"
},
"runs": 12,
"created_at": "2026-11-15T17:00:00.000Z",
"updated_at": "2026-11-15T17:40:00.000Z"
}Rejected: prompt-with-code
{
"id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV",
"owner": {
"subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
"name": "Ada"
},
"slug": "reply-kindly",
"name": "Reply kindly",
"summary": "Drafts a short, kind reply to a message.",
"kind": "prompt",
"input": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string",
"maxLength": 4000
}
}
},
"output": {
"kind": "json",
"schema": {
"type": "object",
"required": [
"reply"
],
"properties": {
"reply": {
"type": "string"
}
}
}
},
"prompt": {
"instructions": "Write a short, kind reply to the message. Answer as JSON: { \"reply\": \"…\" }.",
"model": "auto",
"temperature": 0.4,
"max_tokens": 400
},
"code": {
"sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
"entry": "tool.js"
},
"net": "deny",
"hosting": "openvibe",
"visibility": "public",
"version": 3,
"run": {
"method": "POST",
"path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV/run"
},
"runs": 12,
"created_at": "2026-11-15T17:00:00.000Z",
"updated_at": "2026-11-15T17:40:00.000Z"
}Rejected: prompt-with-network
{
"id": "mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV",
"owner": {
"subject": "usr_01JCZ3NDEKTSV4RRFFQ69G5FAW",
"name": "Ada"
},
"slug": "reply-kindly",
"name": "Reply kindly",
"summary": "Drafts a short, kind reply to a message.",
"kind": "prompt",
"input": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string",
"maxLength": 4000
}
}
},
"output": {
"kind": "json",
"schema": {
"type": "object",
"required": [
"reply"
],
"properties": {
"reply": {
"type": "string"
}
}
}
},
"prompt": {
"instructions": "Write a short, kind reply to the message. Answer as JSON: { \"reply\": \"…\" }.",
"model": "auto",
"temperature": 0.4,
"max_tokens": 400
},
"code": null,
"net": "public",
"hosting": "openvibe",
"visibility": "public",
"version": 3,
"run": {
"method": "POST",
"path": "/api/v1/made-tools/mtl_01JCZ3NDEKTSV4RRFFQ69G5FAV/run"
},
"runs": 12,
"created_at": "2026-11-15T17:00:00.000Z",
"updated_at": "2026-11-15T17:40:00.000Z"
}Validate
const contracts = require('openvibe-contracts');
contracts.validate('tools.made-tool@1', value); // { valid, errors: [{ path, message }] }