Operations: chats

Your Studio chats. 3 operations. How to call them, and what the answers mean: Operations reference.

Generated from the operation catalog: src/lib/ops/public-catalog.json in publicsummerengine at 0d85f61e2b and the summer-engine npm package 4.0.0 for engine and local operations. If something here is wrong, the operation’s definition is wrong.

Operation	What it does	Asks you first
`chats.delete`	Ask the person to delete one of their Studio chats and its messages for good.	Yes, by default
`chats.list`	List the person’s recent chats with the Studio assistant, newest first: chat id, name, when it started and its Studio link.	Never
`chats.rename`	Give one of the person’s Studio chats a new name (1 to 80 characters), as the chat list’s rename does; it shows on every device.	Not by default

delete

chats.delete: Delete a Studio chat Ask the person to delete one of their Studio chats and its messages for good. Returns a link; nothing changes until they confirm. Next: jobs.wait.


MCP	`summer_call` with `"op": "chats.delete"`
CLI	`summer chats delete`
Runs	On Summer’s servers: the hosted MCP, or the npm MCP after `summer login`. Needs your Summer sign-in.
Effect	Removes or stops something for good.
Asks you first	Yes: Delete for good is off by default in Agent permissions.

Inputs:

Input	Type	Required	Description
`chatId`	string	Yes	A chat, from chats.list.
`dryRun`	boolean	No	Check and describe the call without doing it: nothing changes, nothing is spent.
`idempotencyKey`	string	No	Retry key. Reuse it only to retry the identical request, so it never happens twice. Length 1 to 128.

Input JSON schema

{
  "type": "object",
  "properties": {
    "chatId": {
      "description": "A chat, from chats.list.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "dryRun": {
      "description": "Check and describe the call without doing it: nothing changes, nothing is spent.",
      "type": "boolean"
    },
    "idempotencyKey": {
      "description": "Retry key. Reuse it only to retry the identical request, so it never happens twice.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "required": [
    "chatId"
  ]
}

Result JSON schema

{
  "type": "object",
  "properties": {
    "chatId": {
      "type": "string"
    },
    "deleted": {
      "type": "boolean"
    }
  },
  "required": [
    "chatId",
    "deleted"
  ],
  "additionalProperties": false
}

Example: An old chat the person no longer wants.

{
  "name": "summer_call",
  "arguments": {
    "op": "chats.delete",
    "input": {
      "chatId": "4c5d6e7f-8a9b-4c0d-9e1f-2a3b4c5d6e7f"
    }
  }
}

summer chats delete --chat-id 4c5d6e7f-8a9b-4c0d-9e1f-2a3b4c5d6e7f

list

chats.list: List my Studio chats List the person’s recent chats with the Studio assistant, newest first: chat id, name, when it started and its Studio link. Next: chats.rename or chats.delete.


MCP	`summer_call` with `"op": "chats.list"`
CLI	`summer chats list`
Runs	On Summer’s servers: the hosted MCP, or the npm MCP after `summer login`. Needs your Summer sign-in.
Effect	Reads only. Changes nothing.
Asks you first	No. It changes nothing.

Inputs:

Input	Type	Required	Description
`limit`	integer	No	Default `10`. Range 1 to 50.

Input JSON schema

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  }
}

Result JSON schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "chatId": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "createdAt": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "chatId",
          "title",
          "createdAt",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "items"
  ],
  "additionalProperties": false
}

Example: Which chats does the person have?

{
  "name": "summer_call",
  "arguments": {
    "op": "chats.list",
    "input": {
      "limit": 10
    }
  }
}

summer chats list --limit 10

rename

chats.rename: Rename a Studio chat Give one of the person’s Studio chats a new name (1 to 80 characters), as the chat list’s rename does; it shows on every device. Returns the saved name. Next: chats.list.


MCP	`summer_call` with `"op": "chats.rename"`
CLI	`summer chats rename`
Runs	On Summer’s servers: the hosted MCP, or the npm MCP after `summer login`. Needs your Summer sign-in.
Effect	Changes your own drafts, files or settings. Nobody else sees it yet.
Asks you first	No: Make and build is on by default in Agent permissions. When it is off, your agent asks you first.

Inputs:

Input	Type	Required	Description
`chatId`	string	Yes	A chat, from chats.list.
`title`	string	Yes	Length 1 to 80.
`dryRun`	boolean	No	Check and describe the call without doing it: nothing changes, nothing is spent.
`idempotencyKey`	string	No	Retry key. Reuse it only to retry the identical request, so it never happens twice. Length 1 to 128.

Input JSON schema

{
  "type": "object",
  "properties": {
    "chatId": {
      "description": "A chat, from chats.list.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "dryRun": {
      "description": "Check and describe the call without doing it: nothing changes, nothing is spent.",
      "type": "boolean"
    },
    "idempotencyKey": {
      "description": "Retry key. Reuse it only to retry the identical request, so it never happens twice.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "required": [
    "chatId",
    "title"
  ]
}

Result JSON schema

{
  "type": "object",
  "properties": {
    "chatId": {
      "type": "string"
    },
    "title": {
      "type": "string"
    }
  },
  "required": [
    "chatId",
    "title"
  ],
  "additionalProperties": false
}

Example: A clearer name.

{
  "name": "summer_call",
  "arguments": {
    "op": "chats.rename",
    "input": {
      "chatId": "4c5d6e7f-8a9b-4c0d-9e1f-2a3b4c5d6e7f",
      "title": "Lighthouse level ideas"
    }
  }
}

summer chats rename --chat-id 4c5d6e7f-8a9b-4c0d-9e1f-2a3b4c5d6e7f --title 'Lighthouse level ideas'

Overview

Operations

HTTP API

GDScript API

Migration and extensions

MCP

delete

list

rename

​delete

​list

​rename

delete

list

rename