@ellipsis-dev/sdk 0.7.0 → 0.8.0

package/schema/openapi.v1.json

@@ -2583,6 +2583,33 @@
         "title": "CreateFileResponse",
         "type": "object"
       },
+      "CreateMemoryRequest": {
+        "description": "Create a memory at a path that does not exist yet.",
+        "properties": {
+          "content": {
+            "description": "The memory's markdown content, at most 100 KB of UTF-8.",
+            "title": "Content",
+            "type": "string"
+          },
+          "description": {
+            "description": "A one-line summary, at most 200 characters and no newlines. This is the only thing a reader sees in the index, so make it say what the memory is for.",
+            "title": "Description",
+            "type": "string"
+          },
+          "path": {
+            "description": "Where to store the memory. A memory path is slash-separated segments of [a-z0-9._-], with no leading or trailing slash, no empty segments, no '.' or '..' segments, at most 512 characters, ending in '.md'.",
+            "title": "Path",
+            "type": "string"
+          }
+        },
+        "required": [
+          "path",
+          "description",
+          "content"
+        ],
+        "title": "CreateMemoryRequest",
+        "type": "object"
+      },
       "CreateReviewRequest": {
         "description": "Request an explicit review of one existing pull request.\n\nWhich review pipeline runs is not a parameter: it is resolved from the\nrepository's committed code-review configuration, the same way an\nautomatic review resolves it. To change what runs, commit a\n`.ellipsis/code_review.yaml`.",
         "properties": {
@@ -2694,6 +2721,49 @@
         "title": "DurationPercentiles",
         "type": "object"
       },
+      "EditMemoryRequest": {
+        "description": "Update an existing memory. At least one of description or content is\nrequired; this never creates a memory, and never moves it.",
+        "properties": {
+          "content": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Replacement markdown content. Omit to keep it.",
+            "title": "Content"
+          },
+          "description": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Replacement one-line summary. Omit to keep it.",
+            "title": "Description"
+          },
+          "if_sha256": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Only apply the edit if the memory's current content_sha256 matches. Returns 409 if it doesn't, so a concurrent write is a visible conflict rather than a silent overwrite.",
+            "title": "If Sha256"
+          }
+        },
+        "title": "EditMemoryRequest",
+        "type": "object"
+      },
       "EffortLevel": {
         "enum": [
           "low",
@@ -4272,6 +4342,30 @@
         "title": "ListLinearTeamsResponse",
         "type": "object"
       },
+      "ListMemoriesWireResponse": {
+        "description": "The organization's memories: the rendered index a reader scans, plus the\nsame entries structured. Content is fetched per memory.",
+        "properties": {
+          "index": {
+            "description": "The memories rendered as a markdown index \u2014 one line per memory carrying its id, path, and description, grouped by top-level prefix. Read this, then fetch the ids that matter.",
+            "title": "Index",
+            "type": "string"
+          },
+          "memories": {
+            "description": "The same memories as structured entries, ordered by path.",
+            "items": {
+              "$ref": "#/components/schemas/MemoryStubWire"
+            },
+            "title": "Memories",
+            "type": "array"
+          }
+        },
+        "required": [
+          "index",
+          "memories"
+        ],
+        "title": "ListMemoriesWireResponse",
+        "type": "object"
+      },
       "ListReviewsResponse": {
         "description": "Reviews matching the query, newest first. `findings` are omitted\n(counters only); automatically-triggered reviews are included, so this\nanswers \"show me every review on this pull request\".",
         "properties": {
@@ -4576,8 +4670,157 @@
         "title": "LogSearchHit",
         "type": "object"
       },
+      "MemoryActorType": {
+        "enum": [
+          "agent_session",
+          "api_key",
+          "user"
+        ],
+        "title": "MemoryActorType",
+        "type": "string"
+      },
+      "MemoryActorWire": {
+        "description": "Who wrote a memory, derived from their credential.",
+        "properties": {
+          "id": {
+            "description": "The writer's identifier: the agent session id, the API key id, or the GitHub account id, matching `type`.",
+            "title": "Id",
+            "type": "string"
+          },
+          "type": {
+            "$ref": "#/components/schemas/MemoryActorType",
+            "description": "The kind of credential that wrote the memory: agent_session (an agent writing from inside its sandbox), api_key, or user."
+          }
+        },
+        "required": [
+          "type",
+          "id"
+        ],
+        "title": "MemoryActorWire",
+        "type": "object"
+      },
+      "MemoryStubWire": {
+        "description": "One entry in the index: a memory with every field except `content`.\n\nContent is the only omission, and it's the whole reason this shape exists \u2014\nan account can hold 2,000 memories of 100 KB each, so a listing that carried\ncontent would be a 200 MB response.",
+        "properties": {
+          "content_sha256": {
+            "description": "Hex SHA-256 of the content, usable as an `if_sha256` precondition.",
+            "title": "Content Sha256",
+            "type": "string"
+          },
+          "created_at": {
+            "description": "When the memory was created.",
+            "format": "date-time",
+            "title": "Created At",
+            "type": "string"
+          },
+          "created_by": {
+            "$ref": "#/components/schemas/MemoryActorWire",
+            "description": "The credential that created the memory."
+          },
+          "description": {
+            "description": "The one-line summary of the memory.",
+            "title": "Description",
+            "type": "string"
+          },
+          "id": {
+            "description": "The memory's unique identifier.",
+            "title": "Id",
+            "type": "string"
+          },
+          "path": {
+            "description": "The memory's address within the organization.",
+            "title": "Path",
+            "type": "string"
+          },
+          "updated_at": {
+            "description": "When the memory was last written.",
+            "format": "date-time",
+            "title": "Updated At",
+            "type": "string"
+          },
+          "updated_by": {
+            "$ref": "#/components/schemas/MemoryActorWire",
+            "description": "The credential that last wrote the memory."
+          }
+        },
+        "required": [
+          "id",
+          "path",
+          "description",
+          "content_sha256",
+          "created_by",
+          "updated_by",
+          "created_at",
+          "updated_at"
+        ],
+        "title": "MemoryStubWire",
+        "type": "object"
+      },
+      "MemoryWire": {
+        "description": "One memory, including its full markdown content.",
+        "properties": {
+          "content": {
+            "description": "The memory's markdown content.",
+            "title": "Content",
+            "type": "string"
+          },
+          "content_sha256": {
+            "description": "Hex SHA-256 of the content, computed server-side. Pass it back as `if_sha256` on an edit or delete to fail instead of overwriting a change someone else made in the meantime.",
+            "title": "Content Sha256",
+            "type": "string"
+          },
+          "created_at": {
+            "description": "When the memory was created.",
+            "format": "date-time",
+            "title": "Created At",
+            "type": "string"
+          },
+          "created_by": {
+            "$ref": "#/components/schemas/MemoryActorWire",
+            "description": "The credential that created the memory."
+          },
+          "description": {
+            "description": "The one-line summary shown in the index. This is what a reader sees before deciding to open the memory.",
+            "title": "Description",
+            "type": "string"
+          },
+          "id": {
+            "description": "The memory's unique identifier.",
+            "title": "Id",
+            "type": "string"
+          },
+          "path": {
+            "description": "The memory's address, unique within the organization, e.g. repos/acme/deploys.md.",
+            "title": "Path",
+            "type": "string"
+          },
+          "updated_at": {
+            "description": "When the memory was last written.",
+            "format": "date-time",
+            "title": "Updated At",
+            "type": "string"
+          },
+          "updated_by": {
+            "$ref": "#/components/schemas/MemoryActorWire",
+            "description": "The credential that last wrote the memory."
+          }
+        },
+        "required": [
+          "id",
+          "path",
+          "description",
+          "content",
+          "content_sha256",
+          "created_by",
+          "updated_by",
+          "created_at",
+          "updated_at"
+        ],
+        "title": "MemoryWire",
+        "type": "object"
+      },
       "ModelManufacturer": {
-        "description": "Who BUILT a model. Never who serves it.\n\nServing path is irrelevant here. Anthropic built every Claude model, so all of\nthem are ANTHROPIC whether we reach them through the first-party Anthropic API\nor through Bedrock -- a choice made per request by the llm_providers chain, so\nit is not even a fixed property of the model. Likewise the `bedrock-gpt-5.6-*`\nrows are OPENAI (OpenAI's models, served by AWS), and GLM is ZAI (Z.ai's model,\nserved by Wafer or Concentrate over an OpenAI-compatible API).\n\nSo this is deliberately NOT derived from `EgressRoute.provider`: routing is an\ninfrastructure fact that changes when we move a model between providers, while\nthe manufacturer is a property of the model itself and never changes.\n\nThe frontend renders a vendor logo per model, which is why it needs the maker.\nKeying that UI off the egress provider would put an AWS logo on a GPT model and\nan OpenAI logo on GLM.",
+        "description": "Who BUILT a model. Never who serves it.\n\nServing path is irrelevant here. Anthropic built every Claude model, so all of\nthem are ANTHROPIC whether we reach them through the first-party Anthropic API\nor through Bedrock -- a choice made per request by the llm_providers chain, so\nit is not even a fixed property of the model. Likewise the `bedrock-gpt-5.6-*`\nrows are OPENAI (OpenAI's models, served by AWS), and GLM is ZAI (Z.ai's model,\nserved by Concentrate).\n\nSo this is deliberately NOT derived from `EgressRoute.provider`: routing is an\ninfrastructure fact that changes when we move a model between providers, while\nthe manufacturer is a property of the model itself and never changes.\n\nThe frontend renders a vendor logo per model, which is why it needs the maker.\nKeying that UI off the egress provider would put an AWS logo on a GPT model and\nan OpenAI logo on GLM.",
         "enum": [
           "anthropic",
           "openai",
@@ -11957,6 +12200,511 @@
         ]
       }
     },
+    "/memories": {
+      "get": {
+        "description": "List the organization's memories as a readable index.\n\nReturns the memories rendered as a markdown index (one line per\nmemory, carrying its id, path, and description) plus the same\nentries structured, each with every field except `content`. Read\nthe index, then fetch the ids whose content you want.",
+        "operationId": "list_memories",
+        "parameters": [
+          {
+            "description": "Limit to memories under this path prefix, matched on whole segments \u2014 repos/acme matches repos/acme/x.md but not repos/acme2/x.md.",
+            "in": "query",
+            "name": "prefix",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Limit to memories under this path prefix, matched on whole segments \u2014 repos/acme matches repos/acme/x.md but not repos/acme2/x.md.",
+              "title": "Prefix"
+            }
+          },
+          {
+            "in": "header",
+            "name": "user-agent",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "User-Agent"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ListMemoriesWireResponse"
+                }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "List Memories",
+        "tags": [
+          "v1"
+        ]
+      },
+      "post": {
+        "description": "Save a memory for future agent sessions.\n\nMemories are durable lessons shared across the whole\norganization \u2014 conventions, past decisions, known gotchas that an\nagent cannot derive from the repository itself. One concise fact\nper memory; the description is what a reader sees in the index.\n\nCreating never overwrites: a path that already exists is a 409, so\ncorrecting an existing memory is an explicit edit.",
+        "operationId": "create_memory",
+        "parameters": [
+          {
+            "in": "header",
+            "name": "user-agent",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "User-Agent"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateMemoryRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/MemoryWire"
+                }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "A memory already exists at that path."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The path violates the path grammar, the description or content exceeds its limit, or the organization is at the memory cap."
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Create Memory",
+        "tags": [
+          "v1"
+        ]
+      }
+    },
+    "/memories/{memory_id}": {
+      "delete": {
+        "description": "Delete a memory that is no longer true.\n\nAvailable to every credential type, agents included \u2014 a wrong\nmemory is worse than a missing one. The deleted content is kept in\nthe memory's history for forensics, not for an undo API.",
+        "operationId": "delete_memory",
+        "parameters": [
+          {
+            "in": "path",
+            "name": "memory_id",
+            "required": true,
+            "schema": {
+              "title": "Memory Id",
+              "type": "string"
+            }
+          },
+          {
+            "description": "Only delete if the memory's current content_sha256 matches.",
+            "in": "query",
+            "name": "if_sha256",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Only delete if the memory's current content_sha256 matches.",
+              "title": "If Sha256"
+            }
+          },
+          {
+            "in": "header",
+            "name": "user-agent",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "User-Agent"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Successful Response"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "No such memory in your account."
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "if_sha256 does not match the memory's current content."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Delete Memory",
+        "tags": [
+          "v1"
+        ]
+      },
+      "get": {
+        "description": "Read one memory's full content.\n\nThe id comes from the index returned by listing memories.",
+        "operationId": "get_memory",
+        "parameters": [
+          {
+            "in": "path",
+            "name": "memory_id",
+            "required": true,
+            "schema": {
+              "title": "Memory Id",
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "user-agent",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "User-Agent"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/MemoryWire"
+                }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "No such memory in your account."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Get Memory",
+        "tags": [
+          "v1"
+        ]
+      },
+      "put": {
+        "description": "Correct an existing memory in place.\n\nPass description, content, or both. This never creates a memory (an\nunknown id is a 404) and never moves one \u2014 the path is immutable, so\nrelocating a memory is a delete plus a create.\n\nPass `if_sha256` (from a previous read) to make a concurrent write\na 409 instead of silently overwriting it.",
+        "operationId": "edit_memory",
+        "parameters": [
+          {
+            "in": "path",
+            "name": "memory_id",
+            "required": true,
+            "schema": {
+              "title": "Memory Id",
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "user-agent",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "User-Agent"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/EditMemoryRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/MemoryWire"
+                }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "No such memory in your account."
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "if_sha256 does not match the memory's current content."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Neither description nor content was provided, or one of them exceeds its limit."
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Edit Memory",
+        "tags": [
+          "v1"
+        ]
+      }
+    },
     "/models": {
       "get": {
         "description": "List selectable agent models.\n\nMost expensive first, with the platform default flagged.\n\nReads the same registry as the dashboard's rate table, so a\nclient's model picker can never drift from what's offered.\nBehind auth but not account-scoped \u2014 the selectable set is\nglobal.",