online.fg-goose.gsb.defs

ember.delve.town

Documentation

answerView object

The caller's projected turn answer. Preview outcomes use previewView, whose schema has no receipt.

Properties

$type string Optional

No description available.

card string Optional

The exact card the turn offered (or, for a try, would offer), as the caller may read it.

cardCid string cid Optional

CID of the exact offered card encoded as a DAG-CBOR string, including its trailing newline; not a repository record CID.

offers array of string Optional

Cards offered to the caller, verbatim.

turns array of ref#answerView Optional

No description available.

maxLength: 4 items
View raw schema
{
  "description": "The caller's projected turn answer. Preview outcomes use previewView, whose schema has no receipt.",
  "properties": {
    "$type": {
      "const": "online.fg-goose.gsb.defs#answerView",
      "type": "string"
    },
    "card": {
      "description": "The exact card the turn offered (or, for a try, would offer), as the caller may read it.",
      "type": "string"
    },
    "cardCid": {
      "description": "CID of the exact offered card encoded as a DAG-CBOR string, including its trailing newline; not a repository record CID.",
      "format": "cid",
      "type": "string"
    },
    "offers": {
      "description": "Cards offered to the caller, verbatim.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "outcome": {
      "ref": "online.fg-goose.gsb.defs#outcome",
      "type": "ref"
    },
    "receipt": {
      "ref": "online.fg-goose.gsb.defs#receipt",
      "type": "ref"
    },
    "trace": {
      "ref": "online.fg-goose.gsb.defs#trace",
      "type": "ref"
    },
    "turns": {
      "items": {
        "ref": "#answerView",
        "type": "ref"
      },
      "maxLength": 4,
      "type": "array"
    }
  },
  "required": [
    "outcome"
  ],
  "type": "object"
}
call object

One untagged call: exactly {spell}, or {object, verb, fields?}. Shared wire judgement enforces the exclusive forms; fields must be a JSON object.

Properties

fields unknown Optional

The verb's fields as a JSON object.

object string Optional

The object id.

maxLength: 128 bytesminLength: 1 bytes
spell string Optional

A spell: the delvetalk line and its field lines.

maxLength: 4096 bytesminLength: 1 bytes
verb string Optional

The verb or method name.

maxLength: 128 bytesminLength: 1 bytes
View raw schema
{
  "description": "One untagged call: exactly {spell}, or {object, verb, fields?}. Shared wire judgement enforces the exclusive forms; fields must be a JSON object.",
  "properties": {
    "fields": {
      "description": "The verb's fields as a JSON object.",
      "type": "unknown"
    },
    "object": {
      "description": "The object id.",
      "maxLength": 128,
      "minLength": 1,
      "type": "string"
    },
    "spell": {
      "description": "A spell: the delvetalk line and its field lines.",
      "maxLength": 4096,
      "minLength": 1,
      "type": "string"
    },
    "verb": {
      "description": "The verb or method name.",
      "maxLength": 128,
      "minLength": 1,
      "type": "string"
    }
  },
  "type": "object"
}
moved object

No description available.

Properties

now integer Required

The version the object stands at.

minimum: 0
object string Required

No description available.

was integer Required

The version the pin named.

minimum: 0
View raw schema
{
  "properties": {
    "now": {
      "description": "The version the object stands at.",
      "minimum": 0,
      "type": "integer"
    },
    "object": {
      "type": "string"
    },
    "was": {
      "description": "The version the pin named.",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "object",
    "was",
    "now"
  ],
  "type": "object"
}
outcome object

No description available.

Properties

class string Optional

A refusal's class.

clause string Optional

No description available.

line string Required

The host's stamp line as the public reads it: a refusal's only when the host gives it a public projection.

moved array of ref#moved Optional

No description available.

reason string Optional

No description available.

status string Required

No description available.

View raw schema
{
  "properties": {
    "class": {
      "description": "A refusal's class.",
      "type": "string"
    },
    "clause": {
      "type": "string"
    },
    "line": {
      "description": "The host's stamp line as the public reads it: a refusal's only when the host gives it a public projection.",
      "type": "string"
    },
    "moved": {
      "items": {
        "ref": "#moved",
        "type": "ref"
      },
      "type": "array"
    },
    "reason": {
      "type": "string"
    },
    "status": {
      "enum": [
        "admitted",
        "refused",
        "suspended",
        "moved",
        "unsupported",
        "spells",
        "usage",
        "unreached",
        "invalid",
        "error",
        "unknown",
        "denied",
        "looked",
        "receipt"
      ],
      "type": "string"
    }
  },
  "required": [
    "status",
    "line"
  ],
  "type": "object"
}
pin object

Commit-if-unchanged: the object must stand at this version (and state CID) when the turn commits, else the turn is refused `moved`.

Properties

cid string cid Optional

The object's stateCid at that version (an object projection's of CID).

object string Required

No description available.

version integer Required

No description available.

minimum: 0
View raw schema
{
  "description": "Commit-if-unchanged: the object must stand at this version (and state CID) when the turn commits, else the turn is refused `moved`.",
  "properties": {
    "cid": {
      "description": "The object's stateCid at that version (an object projection's of CID).",
      "format": "cid",
      "type": "string"
    },
    "object": {
      "type": "string"
    },
    "version": {
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "object",
    "version"
  ],
  "type": "object"
}
planCall object

One spell only; a plan never contains object calls.

Properties

spell string Required

A spell: the delvetalk line and its field lines.

maxLength: 4096 bytesminLength: 1 bytes
View raw schema
{
  "description": "One spell only; a plan never contains object calls.",
  "properties": {
    "spell": {
      "description": "A spell: the delvetalk line and its field lines.",
      "maxLength": 4096,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "spell"
  ],
  "type": "object"
}
previewOutcome object

No description available.

Properties

class string Optional

A refusal's class.

clause string Optional

No description available.

line string Required

The host's stamp line as the public reads it: a refusal's only when the host gives it a public projection.

moved array of ref#moved Optional

No description available.

reason string Optional

No description available.

status string Required

No description available.

View raw schema
{
  "properties": {
    "class": {
      "description": "A refusal's class.",
      "type": "string"
    },
    "clause": {
      "type": "string"
    },
    "line": {
      "description": "The host's stamp line as the public reads it: a refusal's only when the host gives it a public projection.",
      "type": "string"
    },
    "moved": {
      "items": {
        "ref": "#moved",
        "type": "ref"
      },
      "type": "array"
    },
    "reason": {
      "type": "string"
    },
    "status": {
      "const": "previewed",
      "type": "string"
    }
  },
  "required": [
    "status",
    "line"
  ],
  "type": "object"
}
previewView object

A projected world-try reply, returned only. No receipt, slug, entry or record is claimed.

Properties

$type string Required

No description available.

card string Optional

The exact card the turn offered (or, for a try, would offer), as the caller may read it.

cardCid string cid Optional

CID of the exact offered card encoded as a DAG-CBOR string, including its trailing newline; not a repository record CID.

offers array of string Optional

Cards offered to the caller, verbatim.

turns array of ref#previewView Optional

No description available.

maxLength: 4 items
View raw schema
{
  "description": "A projected world-try reply, returned only. No receipt, slug, entry or record is claimed.",
  "properties": {
    "$type": {
      "const": "online.fg-goose.gsb.defs#previewView",
      "type": "string"
    },
    "card": {
      "description": "The exact card the turn offered (or, for a try, would offer), as the caller may read it.",
      "type": "string"
    },
    "cardCid": {
      "description": "CID of the exact offered card encoded as a DAG-CBOR string, including its trailing newline; not a repository record CID.",
      "format": "cid",
      "type": "string"
    },
    "offers": {
      "description": "Cards offered to the caller, verbatim.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "outcome": {
      "ref": "#previewOutcome",
      "type": "ref"
    },
    "trace": {
      "ref": "online.fg-goose.gsb.defs#trace",
      "type": "ref"
    },
    "turns": {
      "items": {
        "ref": "#previewView",
        "type": "ref"
      },
      "maxLength": 4,
      "type": "array"
    }
  },
  "required": [
    "$type",
    "outcome"
  ],
  "type": "object"
}
receipt object

The journal entry the turn made. Absent from a preview, which can never pass for a receipt.

Properties

entry cid-link Required

The entry's hash: the CID of its canonical DAG-CBOR without `hash`, signed in the world's repository.

height integer Required

No description available.

minimum: 1
slug string Required

Two proquint words: what a post cites.

View raw schema
{
  "description": "The journal entry the turn made. Absent from a preview, which can never pass for a receipt.",
  "properties": {
    "entry": {
      "description": "The entry's hash: the CID of its canonical DAG-CBOR without `hash`, signed in the world's repository.",
      "type": "cid-link"
    },
    "height": {
      "minimum": 1,
      "type": "integer"
    },
    "slug": {
      "description": "Two proquint words: what a post cites.",
      "type": "string"
    }
  },
  "required": [
    "slug",
    "height",
    "entry"
  ],
  "type": "object"
}
trace object

What the turn read and moved, over objects the reader may view.

Properties

fired array of unknown Optional

Rules fired, as journaled.

revealed array of string Optional

The host's revealed lines, verbatim.

roots array of ref#version Optional

Objects read, at the versions read.

unwanted array of ref#wantChange Optional

Wants closed.

wanted array of ref#wantChange Optional

Wants opened.

writes array of ref#version Optional

Objects written, each with its new version and stateCid.

View raw schema
{
  "description": "What the turn read and moved, over objects the reader may view.",
  "properties": {
    "fired": {
      "description": "Rules fired, as journaled.",
      "items": {
        "type": "unknown"
      },
      "type": "array"
    },
    "revealed": {
      "description": "The host's revealed lines, verbatim.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "roots": {
      "description": "Objects read, at the versions read.",
      "items": {
        "ref": "#version",
        "type": "ref"
      },
      "type": "array"
    },
    "unwanted": {
      "description": "Wants closed.",
      "items": {
        "ref": "#wantChange",
        "type": "ref"
      },
      "type": "array"
    },
    "wanted": {
      "description": "Wants opened.",
      "items": {
        "ref": "#wantChange",
        "type": "ref"
      },
      "type": "array"
    },
    "writes": {
      "description": "Objects written, each with its new version and stateCid.",
      "items": {
        "ref": "#version",
        "type": "ref"
      },
      "type": "array"
    }
  },
  "type": "object"
}
version object

No description available.

Properties

object string Required

No description available.

stateCid string cid Optional

A content identifier (CID) referencing immutable data.

version integer Required

No description available.

minimum: 0
View raw schema
{
  "properties": {
    "object": {
      "type": "string"
    },
    "stateCid": {
      "format": "cid",
      "type": "string"
    },
    "version": {
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "object",
    "version"
  ],
  "type": "object"
}
wantChange object

No description available.

Properties

object string Required

No description available.

want string Required

No description available.

View raw schema
{
  "properties": {
    "object": {
      "type": "string"
    },
    "want": {
      "type": "string"
    }
  },
  "required": [
    "object",
    "want"
  ],
  "type": "object"
}

Lexicon Garden

@