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

package/dist/events.d.ts

@@ -11,6 +11,15 @@ export type TimelineItem = {
     text: string;
     clientMessageId?: string; /** How many images the message carried; their data is not replayed. */
     images?: number;
+    /** Files attached to the message (capability `attachments`, §12.6): ids, display names, types and sizes, never a host path. */
+    attachments?: Array<{
+        attachmentId: string;
+        name: string;
+        mimeType: string;
+        size: number;
+    }>;
+    /** Who wrote it: the user, or ALP itself (mail, a brief, a resume); absent when the runtime cannot tell. Only the user's words name a root (ALPD §15). */
+    origin?: TurnOrigin;
 } | {
     kind: 'assistant_message';
     id: string;
@@ -164,6 +173,11 @@ export type SessionSnapshot = {
     instructionsSha?: string;
     /** The session's runtime takes images in session.prompt (capability `prompt.images`); absent means it does not. */
     promptImages?: boolean;
+    /**
+     * How the session's runtime can use files attached in session.prompt (§12.6): `file.path` (its tools
+     * read a staged read-only copy), `document.native`, `text.extract`. Absent: it takes no attachment parts.
+     */
+    promptAttachments?: Array<'file.path' | 'document.native' | 'text.extract'>;
     /** The latest usage the session's runtime reported (ALPD §57); absent before its first report. */
     usage?: SessionUsage;
 };
@@ -181,6 +195,17 @@ export type AssignmentSnapshot = {
 };
 /** runtime: a turn the native runtime started by itself, such as Claude after a background task ended. */
 export type TurnOrigin = 'user' | 'wake' | 'assignment' | 'runtime';
+/**
+ * A root's turn that ended while nobody looked (Paseo's attention): `finished` for a completed turn,
+ * `error` for a failed one. alpd keeps it for every client until one acknowledges it or the root
+ * starts another turn (docs/protocol/alp-json-rpc-v1.md §12.2).
+ */
+export type TurnAttention = {
+    reason: 'finished' | 'error';
+    at: string;
+    turnId?: string;
+    message?: string;
+};
 /** A question an agent asked the user with alp_ask to: "user". */
 export type UserQuestion = {
     id: string;
@@ -295,6 +320,22 @@ export type AlpEvent = {
     type: 'unpin';
     pinId: string;
     reason: 'unpinned' | 'session_ended';
+}
+/** A root's attention set, or cleared when absent: sent only to `question.watch { attention: true }` connections, never kept. */
+ | {
+    type: 'attention';
+    attention?: TurnAttention;
+}
+/**
+ * The root's conversation was rewound (capability `session.rewind`, §12.7): history pages and cursors of
+ * the earlier generation are stale. Sent to attached connections only, never kept: drop the cached
+ * history, fetch a new tail and attach again with this generation.
+ */
+ | {
+    type: 'history.reset';
+    generation: string;
+    reason: 'rewind';
+    branchId: string;
 };
 export type Envelope = {
     sessionId: string;

package/dist/index.d.ts

@@ -3,4 +3,5 @@ export type * from './dto.js';
 export type * from './events.js';
 export type * from './connection.js';
 export type * from './session.js';
+export type * from './schedule.js';
 export type * from './rpc.js';