ONE path:mark

path:mark

path family

Mark the path between two steps of a workflow — strength on the edge from one step's thing to another's, through the same substrate.mark the /api/mark route uses (TypeDB path + D1 mirror). Steps are named; a step's id is its thing's tid (apply-diff projects every step; workflow:project backfills). The caller must control the workflow's workspace; a workflow you do not control answers not_found. Contract (text/contracts.md § mark): pre both endpoints resolve and strength ≥ 0; post the edge reads back with strength grown by at most `strength`.

Effect: ask; Awaits an outcome — the call returns the response below.
Caller: manage_paths; The class of authority the caller must already hold, decided from the attested context with no round trip.
Cost: free; What one call costs, so you can budget before acting.
Reversible: yes; The effect can be undone by a later call.
Idempotent: no; Not safe to blind-retry — dedupe on the envelope idempotencyKey.

Send it with your agent

One click hands your coding agent a prompt that registers the substrate, reads this contract, and makes the call. Launch opens the app; the others copy the prompt.

Claude Code

Codex

Cursor

Gemini CLI

Claude Desktop

ChatGPT

curl -X POST https://one.ie/api/ask/path:mark \
  -H "Authorization: Bearer $ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data": { "workflow": <string>, "from": <string>, "to": <string> }}'

The key is never in a link. npx -y @oneie/cli login writes it to ~/.config/oneie/key on your machine.

Request

Validated before dispatch — an invalid payload is refused with the fix, never half-applied.

workflow string required The workflow id whose steps the edge joins — the path the edge belongs to
from string required The step the move came from, by its name in that workflow (e.g. a beat's name, 'start' for the first)
to string required The step the move arrived at, by its name in that workflow
strength number optional How much to deposit, 0–10. Default 1

Response

What comes back from the call.

ok boolean
source string The from step's thing tid
target string The to step's thing tid
strength number The edge's strength after the mark, read back
delta number How much it grew — never more than the requested strength
error string Why it was refused, by name: missing · bad_strength · self_edge · not_found · unknown_step:<name> · thing_missing:<tid> (run workflow:project) · graph_unavailable:<why> · post_failed

Traffic

Every call to path:mark, counted where it is dispatched — over HTTP or in-process alike. Aggregate only — no actor, no payload, no workspace.

Counting…

Wiring

Every place in the open source that names path:mark, and the file that answers it. Read from the tree at build time — a receiver is reached by NAME through one door, so there is no import edge to follow and a grep is the honest shape of the question. Structure, not volume — the count is in Traffic above.

Called from

UI 1

one.ie/web/src/components/analytics/SignalStream.tsx:55

API route 4

one.ie/web/src/lib/agent-events.ts:36
one.ie/web/src/lib/dashboard-v2/measured.ts:14
one.ie/web/src/lib/event-vocabulary.ts:44
one.ie/web/src/lib/receiver-index.generated.ts:297

→

Answered by

path:mark one.ie/web/src/lib/resolvers/path.ts:57 Dispatched through POST /api/ask/path:mark, after the envelope validates the payload.

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "workflow": {
      "type": "string",
      "description": "The workflow id whose steps the edge joins — the path the edge belongs to"
    },
    "from": {
      "type": "string",
      "description": "The step the move came from, by its name in that workflow (e.g. a beat's name, 'start' for the first)"
    },
    "to": {
      "type": "string",
      "description": "The step the move arrived at, by its name in that workflow"
    },
    "strength": {
      "description": "How much to deposit, 0–10. Default 1",
      "type": "number",
      "minimum": 0,
      "maximum": 10
    }
  },
  "required": [
    "workflow",
    "from",
    "to"
  ]
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "source": {
      "description": "The from step's thing tid",
      "type": "string"
    },
    "target": {
      "description": "The to step's thing tid",
      "type": "string"
    },
    "strength": {
      "description": "The edge's strength after the mark, read back",
      "type": "number"
    },
    "delta": {
      "description": "How much it grew — never more than the requested strength",
      "type": "number"
    },
    "error": {
      "description": "Why it was refused, by name: missing · bad_strength · self_edge · not_found · unknown_step:<name> · thing_missing:<tid> (run workflow:project) · graph_unavailable:<why> · post_failed",
      "type": "string"
    }
  },
  "required": [
    "ok"
  ]
}