@anhlp/alp-protocol 0.0.1-beta.3 → 0.0.1-beta.4

package/schema/ipc-v1.json

@@ -111,6 +111,18 @@
         "promptImages": {
           "type": "boolean"
         },
+        "promptAttachments": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "file.path",
+              "document.native",
+              "text.extract"
+            ]
+          }
+        },
         "usage": {
           "$ref": "#/$defs/usage"
         }
@@ -343,6 +355,31 @@
       ],
       "additionalProperties": true
     },
+    "attention": {
+      "type": "object",
+      "properties": {
+        "reason": {
+          "enum": [
+            "finished",
+            "error"
+          ]
+        },
+        "at": {
+          "type": "string"
+        },
+        "turnId": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "reason",
+        "at"
+      ],
+      "additionalProperties": true
+    },
     "spec": {
       "type": "object",
       "properties": {
@@ -530,24 +567,49 @@
       ]
     },
     "notification": {
-      "type": "object",
-      "properties": {
-        "jsonrpc": {
-          "const": "2.0"
-        },
-        "method": {
-          "const": "event"
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "jsonrpc": {
+              "const": "2.0"
+            },
+            "method": {
+              "const": "event"
+            },
+            "params": {
+              "$ref": "#/$defs/envelope"
+            }
+          },
+          "required": [
+            "jsonrpc",
+            "method",
+            "params"
+          ],
+          "additionalProperties": true
         },
-        "params": {
-          "$ref": "#/$defs/envelope"
+        {
+          "type": "object",
+          "description": "A terminal's output, exit or detach (capability terminal, §12.10).",
+          "properties": {
+            "jsonrpc": {
+              "const": "2.0"
+            },
+            "method": {
+              "const": "terminal.event"
+            },
+            "params": {
+              "$ref": "#/$defs/terminalEvent"
+            }
+          },
+          "required": [
+            "jsonrpc",
+            "method",
+            "params"
+          ],
+          "additionalProperties": true
         }
-      },
-      "required": [
-        "jsonrpc",
-        "method",
-        "params"
-      ],
-      "additionalProperties": true
+      ]
     },
     "knownEvent": {
       "oneOf": [
@@ -889,6 +951,47 @@
             "reason"
           ],
           "additionalProperties": true
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "attention"
+            },
+            "attention": {
+              "$ref": "#/$defs/attention"
+            }
+          },
+          "required": [
+            "type"
+          ],
+          "additionalProperties": true
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "history.reset"
+            },
+            "generation": {
+              "type": "string",
+              "pattern": "^[0-9a-f]{32}$"
+            },
+            "reason": {
+              "const": "rewind"
+            },
+            "branchId": {
+              "type": "string",
+              "pattern": "^br_[0-9a-f]{16}$"
+            }
+          },
+          "required": [
+            "type",
+            "generation",
+            "reason",
+            "branchId"
+          ],
+          "additionalProperties": true
         }
       ]
     },
@@ -915,7 +1018,9 @@
               "question",
               "question.resolved",
               "pin",
-              "unpin"
+              "unpin",
+              "attention",
+              "history.reset"
             ]
           }
         }
@@ -945,6 +1050,43 @@
             "images": {
               "type": "integer",
               "minimum": 1
+            },
+            "attachments": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "attachmentId": {
+                    "type": "string",
+                    "pattern": "^att_[0-9a-f]{32}$"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "mimeType": {
+                    "type": "string"
+                  },
+                  "size": {
+                    "type": "integer",
+                    "minimum": 0
+                  }
+                },
+                "required": [
+                  "attachmentId",
+                  "name",
+                  "mimeType",
+                  "size"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "origin": {
+              "enum": [
+                "user",
+                "wake",
+                "assignment",
+                "runtime"
+              ]
             }
           },
           "required": [
@@ -1537,6 +1679,9 @@
         "archived": {
           "type": "boolean"
         },
+        "attention": {
+          "$ref": "#/$defs/attention"
+        },
         "lastError": {
           "type": "object",
           "properties": {
@@ -1557,6 +1702,59 @@
         },
         "updatedAt": {
           "type": "string"
+        },
+        "conversation": {
+          "type": "object",
+          "properties": {
+            "fork": {
+              "type": "boolean"
+            },
+            "rewind": {
+              "type": "boolean"
+            },
+            "reload": {
+              "type": "boolean",
+              "description": "Whether session.reload can restart this root's native process (§12.8); the root must also be open and idle."
+            },
+            "configure": {
+              "type": "boolean",
+              "description": "Whether session.configure can change this root's model, effort or team (§12.9); the root must also be open and idle."
+            },
+            "reason": {
+              "enum": [
+                "runtime_unsupported",
+                "not_persistent",
+                "not_root"
+              ]
+            }
+          },
+          "required": [
+            "fork",
+            "rewind"
+          ],
+          "additionalProperties": true
+        },
+        "forkedFrom": {
+          "$ref": "#/$defs/forkProvenance"
+        },
+        "branches": {
+          "type": "array",
+          "maxItems": 100,
+          "items": {
+            "$ref": "#/$defs/conversationBranch"
+          }
+        },
+        "promptAttachments": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "file.path",
+              "document.native",
+              "text.extract"
+            ]
+          }
         }
       },
       "required": [
@@ -2330,6 +2528,744 @@
         "data"
       ],
       "additionalProperties": false
+    },
+    "scheduleId": {
+      "type": "string",
+      "pattern": "^sch_[0-9a-f]{16}$"
+    },
+    "scheduleError": {
+      "type": "object",
+      "properties": {
+        "message": {
+          "type": "string"
+        },
+        "code": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "message"
+      ],
+      "additionalProperties": true
+    },
+    "scheduleJob": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/scheduleId"
+        },
+        "projectRoot": {
+          "$ref": "#/$defs/projectRoot"
+        },
+        "sessionId": {
+          "type": "string"
+        },
+        "prompt": {
+          "type": "string"
+        },
+        "dueAt": {
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,3})?(Z|[+-]\\d{2}:\\d{2})$"
+        },
+        "status": {
+          "enum": [
+            "pending",
+            "delivered",
+            "failed",
+            "cancelled"
+          ]
+        },
+        "attempts": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "updatedAt": {
+          "type": "string"
+        },
+        "deliveredAt": {
+          "type": "string"
+        },
+        "failedAt": {
+          "type": "string"
+        },
+        "cancelledAt": {
+          "type": "string"
+        },
+        "attemptedAt": {
+          "type": "string"
+        },
+        "lateByMs": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "lastError": {
+          "$ref": "#/$defs/scheduleError"
+        }
+      },
+      "required": [
+        "id",
+        "projectRoot",
+        "sessionId",
+        "prompt",
+        "dueAt",
+        "status",
+        "attempts",
+        "createdAt",
+        "updatedAt"
+      ],
+      "additionalProperties": true
+    },
+    "registryProject": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "root": {
+          "type": "string"
+        },
+        "customName": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "addedAt": {
+          "type": "string"
+        },
+        "removedAt": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "canonical": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "root",
+        "addedAt"
+      ],
+      "additionalProperties": false
+    },
+    "registryWorkspace": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "projectId": {
+          "type": "string"
+        },
+        "directory": {
+          "type": "string"
+        },
+        "title": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "pinnedAt": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "archivedAt": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "labels": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "canonical": {
+          "type": "string"
+        },
+        "idempotencyKey": {
+          "type": "string"
+        },
+        "branch": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "managedWorktree": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "id",
+        "projectId",
+        "directory",
+        "labels",
+        "createdAt"
+      ],
+      "additionalProperties": false
+    },
+    "attachment": {
+      "type": "object",
+      "description": "A committed attachment as clients see it: ids, display metadata and its digest, never a host path or URL.",
+      "properties": {
+        "attachmentId": {
+          "type": "string",
+          "pattern": "^att_[0-9a-f]{32}$"
+        },
+        "sessionId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 255
+        },
+        "mimeType": {
+          "type": "string",
+          "minLength": 3,
+          "maxLength": 255
+        },
+        "detectedMimeType": {
+          "type": "string",
+          "minLength": 3,
+          "maxLength": 255
+        },
+        "size": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "committedAt": {
+          "type": "string"
+        },
+        "referenced": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "attachmentId",
+        "sessionId",
+        "name",
+        "mimeType",
+        "detectedMimeType",
+        "size",
+        "sha256",
+        "createdAt",
+        "committedAt",
+        "referenced"
+      ],
+      "additionalProperties": false
+    },
+    "forkProvenance": {
+      "type": "object",
+      "description": "Where a fork came from (§12.7): the source root, and the turn its conversation was cut at.",
+      "properties": {
+        "sessionId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128
+        },
+        "turnId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "boundary": {
+          "enum": [
+            "through",
+            "before",
+            "whole"
+          ]
+        },
+        "branchId": {
+          "type": "string",
+          "pattern": "^br_[0-9a-f]{16}$"
+        },
+        "at": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        }
+      },
+      "required": [
+        "sessionId",
+        "boundary",
+        "at"
+      ],
+      "additionalProperties": true
+    },
+    "conversationBranch": {
+      "type": "object",
+      "description": "Later turns a rewind set aside (§12.7): kept, never deleted, recoverable as a new session with session.fork { branchId }.",
+      "properties": {
+        "branchId": {
+          "type": "string",
+          "pattern": "^br_[0-9a-f]{16}$"
+        },
+        "beforeTurnId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "turns": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "at": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        }
+      },
+      "required": [
+        "branchId",
+        "beforeTurnId",
+        "turns",
+        "at"
+      ],
+      "additionalProperties": true
+    },
+    "effectiveConfig": {
+      "type": "object",
+      "description": "The configuration a root runs with, or would after a change, as alpd resolved it (§12.9).",
+      "properties": {
+        "team": {
+          "type": "string"
+        },
+        "teamLabel": {
+          "type": "string"
+        },
+        "agent": {
+          "type": "string"
+        },
+        "runtime": {
+          "enum": [
+            "claude",
+            "codex",
+            "acp",
+            "antigravity"
+          ]
+        },
+        "model": {
+          "type": "string"
+        },
+        "thinking": {
+          "type": "string"
+        },
+        "mode": {
+          "type": "string"
+        },
+        "permissionProfile": {
+          "type": "string",
+          "description": "The permission profile capping the agent's mode, when one does."
+        },
+        "supervisor": {
+          "type": "boolean"
+        },
+        "maxPeers": {
+          "type": "integer"
+        },
+        "delegates": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Agents the root may delegate to."
+        },
+        "tools": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "ALP tools the root's agent is given."
+        },
+        "mcpServers": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "kind": {
+                "enum": [
+                  "stdio",
+                  "http"
+                ]
+              }
+            },
+            "required": [
+              "name",
+              "kind"
+            ],
+            "additionalProperties": true
+          }
+        },
+        "hooks": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "How many hook commands the agent runs."
+        },
+        "instructionsSha": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "team",
+        "agent",
+        "runtime",
+        "model",
+        "thinking",
+        "mode",
+        "supervisor",
+        "delegates",
+        "tools",
+        "mcpServers",
+        "hooks"
+      ],
+      "additionalProperties": true
+    },
+    "configurePreview": {
+      "type": "object",
+      "properties": {
+        "current": {
+          "$ref": "#/$defs/effectiveConfig"
+        },
+        "proposed": {
+          "$ref": "#/$defs/effectiveConfig"
+        },
+        "changes": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "model",
+              "thinking",
+              "team",
+              "mode"
+            ]
+          }
+        },
+        "restart": {
+          "type": "boolean",
+          "description": "Whether applying it restarts the root's native process (on its own conversation)."
+        },
+        "allowed": {
+          "type": "boolean",
+          "description": "Whether session.configure would take it now; a busy tree may still refuse it later."
+        },
+        "reason": {
+          "enum": [
+            "session_busy",
+            "session_closed",
+            "not_root",
+            "runtime_unsupported",
+            "runtime_mismatch",
+            "agent_mismatch",
+            "permission_escalation",
+            "team_not_found",
+            "invalid_params",
+            "not_persistent"
+          ]
+        },
+        "message": {
+          "type": "string"
+        },
+        "teams": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "label": {
+                "type": "string"
+              },
+              "description": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "label"
+            ],
+            "additionalProperties": true
+          }
+        }
+      },
+      "required": [
+        "current",
+        "proposed",
+        "changes",
+        "restart",
+        "allowed",
+        "teams"
+      ],
+      "additionalProperties": true
+    },
+    "configureOutcome": {
+      "type": "object",
+      "properties": {
+        "status": {
+          "enum": [
+            "applied",
+            "unchanged"
+          ]
+        },
+        "requested": {
+          "type": "object",
+          "properties": {
+            "model": {
+              "type": "string"
+            },
+            "thinking": {
+              "type": "string"
+            },
+            "team": {
+              "type": "string"
+            },
+            "mode": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        },
+        "effective": {
+          "$ref": "#/$defs/effectiveConfig"
+        },
+        "restarted": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "status",
+        "requested",
+        "effective",
+        "restarted"
+      ],
+      "additionalProperties": true
+    },
+    "terminal": {
+      "type": "object",
+      "description": "A terminal as clients see it: ids, size and state, never a process id, shell path or host path.",
+      "properties": {
+        "terminalId": {
+          "type": "string",
+          "pattern": "^term_[0-9a-f]{32}$"
+        },
+        "workspaceId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "title": {
+          "type": "string",
+          "maxLength": 64
+        },
+        "cols": {
+          "type": "integer",
+          "minimum": 2,
+          "maximum": 500
+        },
+        "rows": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 200
+        },
+        "state": {
+          "enum": [
+            "running",
+            "exited"
+          ]
+        },
+        "attached": {
+          "type": "boolean"
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "lastActivityAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "expiresAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "exitCode": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "signal": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "endReason": {
+          "enum": [
+            "exited",
+            "closed",
+            "idle",
+            "lifetime",
+            "detached",
+            "revoked",
+            "disabled",
+            "shutdown"
+          ]
+        }
+      },
+      "required": [
+        "terminalId",
+        "workspaceId",
+        "title",
+        "cols",
+        "rows",
+        "state",
+        "attached",
+        "createdAt",
+        "lastActivityAt",
+        "expiresAt"
+      ],
+      "additionalProperties": false
+    },
+    "terminalEvent": {
+      "description": "params of a terminal.event notification (§12.10): sent only to the connection attached to the terminal.",
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "terminalId": {
+              "type": "string",
+              "pattern": "^term_[0-9a-f]{32}$"
+            },
+            "type": {
+              "const": "output"
+            },
+            "seq": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "data": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 65536
+            }
+          },
+          "required": [
+            "terminalId",
+            "type",
+            "seq",
+            "data"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "terminalId": {
+              "type": "string",
+              "pattern": "^term_[0-9a-f]{32}$"
+            },
+            "type": {
+              "const": "exit"
+            },
+            "seq": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "exitCode": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "signal": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "reason": {
+              "enum": [
+                "exited",
+                "closed",
+                "idle",
+                "lifetime",
+                "detached",
+                "revoked",
+                "disabled",
+                "shutdown"
+              ]
+            }
+          },
+          "required": [
+            "terminalId",
+            "type",
+            "seq",
+            "exitCode",
+            "signal",
+            "reason"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "terminalId": {
+              "type": "string",
+              "pattern": "^term_[0-9a-f]{32}$"
+            },
+            "type": {
+              "const": "detached"
+            },
+            "reason": {
+              "enum": [
+                "replaced",
+                "slow_consumer"
+              ]
+            }
+          },
+          "required": [
+            "terminalId",
+            "type",
+            "reason"
+          ],
+          "additionalProperties": false
+        }
+      ]
     }
   }
 }