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

FieldTypeRequiredDescriptionConstraints
idstringyesThe tool's id. It never changes.
  • pattern ^mtl_[0-9A-HJKMNP-TV-Z]{26}$
ownerobjectyesWho made it.
  • no other fields
owner.subjectstringyes
  • pattern ^usr_[0-9A-HJKMNP-TV-Z]{26}$
owner.namestringTheir display name when the tool was read, for people.
  • minLength 1
  • maxLength 80
slugstringyesA short name, unique among the owner's tools (summarize-email), for addresses and an agent's tool list.
  • pattern ^[a-z][a-z0-9-]{1,39}$
namestringyes
  • minLength 1
  • maxLength 80
summarystringyesOne plain sentence: what the tool does. Agents read it to decide when to use the tool.
  • minLength 1
  • maxLength 200
kindenumyesprompt: 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.
  • one of "prompt", "code", "chain"
inputobjectyesJSON Schema (2020-12) of a run's input: an object schema.
input.typeconstyes
  • = "object"
outputobjectyes
  • no other fields
output.kindenumyesjson: result.data, checked against schema. text: result.text.
  • one of "json", "text"
output.schemaobjectJSON Schema of result.data. Required when kind is json.
output.schema.typeconstyes
  • = "object"
promptobject | nullyesA prompt tool's instructions and model; null for a code tool.
codeobject | nullyesA code tool's entry; null for a prompt tool.
netenumyesThe 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).
  • one of "deny", "public", "openvibe-only"
hostingenumyesWhere 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).
  • one of "openvibe", "mine", "shared"
visibilityenumyes
  • one of "private", "unlisted", "public"
versionintegeryes1 when made; each change adds one.
  • minimum 1
runobjectyes
  • no other fields
run.methodconstyes
  • = "POST"
run.pathstringyes
  • pattern ^/api/v1/made-tools/mtl_[0-9A-HJKMNP-TV-Z]{26}/run$
runsintegerHow many times it has run (all callers).
  • minimum 0
created_atstringyes
  • format date-time
updated_atstringyes
  • format date-time
chainobject | nullA 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 }] }