Playable Gift

Saves a supplied self-contained HTML game as a free private draft. Returns a preview URL and private management token. Accepted games have inline code and embedded assets, keyboard and touch controls, a goal and restart. Network requests, payments and personal-data collection are prohibited. Repeated requests with the same idempotency key return the existing draft.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "create_custom_game",
    "arguments": {
      "recipient": "...",
      "sender": "...",
      "title": "...",
      "concept": "...",
      "game": {},
      "idempotencyKey": "..."
    }
  }
}

Returns a private draft as portable JSON containing its complete self-contained game HTML. The recipient's email address and private tokens are excluded. An optional revision number selects a retained revision instead of the current version.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "export_gift",
    "arguments": {
      "managementToken": "..."
    }
  }
}

Returns a private draft's metadata, current revision, preview link and status for the supplied management token. Game HTML is excluded.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_gift",
    "arguments": {
      "managementToken": "..."
    }
  }
}

Returns the supported formats, capabilities, requirements and limits for saving custom HTML games as private drafts.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_gift_catalog",
    "arguments": {}
  }
}

Returns the last five retained revisions of a private draft for the supplied management token. Revision metadata may contain the sender's personal content. Game HTML is excluded.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_gift_history",
    "arguments": {
      "managementToken": "..."
    }
  }
}

Returns the current stage of a game generation job identified by its private idempotency key. A completed job includes the title, cast, recipient play link and sender management link. Management links grant private sender access.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_made_game",
    "arguments": {
      "idempotencyKey": "..."
    }
  }
}

Starts generation of a small browser game about one person from the sender's supplied habits or inside jokes. Returns immediately with build progress. Games are free within a daily allowance. When the assistant allowance runs out, returns an OAuth sign-in request or a handoff URL. It never charges anyone or sends messages.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "make_game",
    "arguments": {
      "brief": "...",
      "idempotencyKey": "..."
    }
  }
}

Replaces an existing private draft with supplied HTML and game details. Requires the draft's management token and current revision number. A stale expectedRevision is rejected to prevent overwriting another edit.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "revise_custom_game",
    "arguments": {
      "recipient": "...",
      "sender": "...",
      "title": "...",
      "concept": "...",
      "game": {},
      "expectedRevision": 0,
      "managementToken": "..."
    }
  }
}