@ellipsis-dev/sdk 0.2.1 → 0.2.3

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentSessionWire, L as ListSessionRecordsResponse, a as ListSessionTurnsResponse, b as ListSessionExecutionsResponse, S as SessionMessageWire } from './types-CtvSTnzA.js';
-export { c as AgentSessionExitStatus, d as AgentSessionPr, e as AgentSessionSource, f as AgentSessionStatus, g as AgentTurn, h as AgentTurnStatus, i as AttributionType, B as BudgetSource, D as DefaultResolution, j as DeltaFrame, k as DoneFrame, E as ErrorFrame, G as GithubAccountSnippet, l as GithubAccountType, H as Harness, m as HeartbeatFrame, M as ModelTokensInfo, P as ParentKind, R as RecordsAppendFrame, n as SendSessionMessageRequest, o as SessionExecutionWire, p as SessionFrame, q as SessionLiveness, r as SessionMessageStatus, s as SessionRecordWire, t as SessionState, u as SessionStreamFrame, v as SessionSurface, w as SnapshotFrame, x as StreamFrame, T as TokensInfo, y as TurnTokensInfo, z as components, C as paths } from './types-CtvSTnzA.js';
+import { A as AgentSessionWire, L as ListSessionRecordsResponse, a as ListSessionTurnsResponse, b as ListSessionExecutionsResponse, S as SessionMessageWire } from './types-CNx-q_eN.js';
+export { c as AgentSessionExitStatus, d as AgentSessionPr, e as AgentSessionSource, f as AgentSessionStatus, g as AgentTurn, h as AgentTurnStatus, i as AttributionType, B as BudgetSource, D as DefaultResolution, j as DeltaFrame, k as DoneFrame, E as ErrorFrame, G as GithubAccountSnippet, l as GithubAccountType, H as Harness, m as HeartbeatFrame, M as ModelTokensInfo, P as ParentKind, n as PromptBlockedReason, R as RecordsAppendFrame, o as SendSessionMessageRequest, p as SessionExecutionWire, q as SessionFrame, r as SessionLiveness, s as SessionMessageStatus, t as SessionPrompting, u as SessionRecordWire, v as SessionState, w as SessionStreamFrame, x as SessionSurface, y as SnapshotFrame, z as StreamFrame, T as TokensInfo, C as TurnTokensInfo, F as components, I as paths } from './types-CNx-q_eN.js';
 
 type FetchJson = (path: string, init?: {
     method?: string;

package/dist/store/index.d.ts

@@ -1,4 +1,4 @@
-import { s as SessionRecordWire, A as AgentSessionWire, S as SessionMessageWire, x as StreamFrame } from '../types-CtvSTnzA.js';
+import { u as SessionRecordWire, A as AgentSessionWire, S as SessionMessageWire, z as StreamFrame } from '../types-CNx-q_eN.js';
 
 interface ChatToolNode {
     key: string;

package/dist/stream/index.d.ts

@@ -1,4 +1,4 @@
-import { x as StreamFrame, A as AgentSessionWire } from '../types-CtvSTnzA.js';
+import { z as StreamFrame, A as AgentSessionWire } from '../types-CNx-q_eN.js';
 
 declare const SESSION_STREAM_PROTOCOL_VERSION = 3;
 declare const WS_CLOSE_NORMAL = 1000;

package/dist/{types-CtvSTnzA.d.ts → types-CNx-q_eN.d.ts}

@@ -192,6 +192,7 @@ interface components {
             parent_kind?: components['schemas']['ParentKind'] | null;
             /** Prompt */
             prompt?: string | null;
+            prompting: components['schemas']['SessionPrompting'];
             /** Replayed From Session Id */
             replayed_from_session_id?: string | null;
             /** Resolved Budget Cents */
@@ -477,6 +478,12 @@ interface components {
          * @enum {string}
          */
         ParentKind: 'continuation' | 'handoff' | 'resume';
+        /**
+         * PromptBlockedReason
+         * @description Why direct prompting is refused. Absent when prompting is allowed.
+         * @enum {string}
+         */
+        PromptBlockedReason: 'mention_surface' | 'ephemeral_trigger' | 'non_interactive' | 'closed' | 'laptop';
         /**
          * RecordSource
          * @description `session_records.source` — the client render switch. `lifecycle` rows are
@@ -621,6 +628,22 @@ interface components {
             sender_attribution_type?: components['schemas']['AttributionType'] | null;
             status: components['schemas']['SessionMessageStatus'];
         };
+        /**
+         * SessionPrompting
+         * @description The prompt-affordance projection. `enabled` answers "would a send work",
+         *     and when it wouldn't, `blocked_reason` + `detail` say why.
+         *
+         *     `surface_name` is set only for MENTION_SURFACE, naming where to reply.
+         */
+        SessionPrompting: {
+            blocked_reason?: components['schemas']['PromptBlockedReason'] | null;
+            /** Detail */
+            detail?: string | null;
+            /** Enabled */
+            enabled: boolean;
+            /** Surface Name */
+            surface_name?: string | null;
+        };
         /**
          * SessionRecordWire
          * @description The wire shape of one session record (§3.3): the §3.6 stable envelope +
@@ -1005,6 +1028,10 @@ type Harness = 'claude_code';
  * down (interactive platform; later phase).
  */
 type ParentKind = 'continuation' | 'handoff' | 'resume';
+/**
+ * Why direct prompting is refused. Absent when prompting is allowed.
+ */
+type PromptBlockedReason = 'mention_surface' | 'ephemeral_trigger' | 'non_interactive' | 'closed' | 'laptop';
 /**
  * Which layer actually determined the enforced budget.
  *
@@ -1090,6 +1117,7 @@ interface AgentSessionWire {
     parent_agent_session_id: string | null;
     parent_kind: ParentKind | null;
     prompt: string | null;
+    prompting: SessionPrompting;
     replayed_from_session_id: string | null;
     resolved_budget_cents: number;
     resolved_budget_source: BudgetSource;
@@ -1138,6 +1166,18 @@ interface AgentSessionPr {
     repo_full_name: string;
     url: string;
 }
+/**
+ * The prompt-affordance projection. `enabled` answers "would a send work",
+ * and when it wouldn't, `blocked_reason` + `detail` say why.
+ *
+ * `surface_name` is set only for MENTION_SURFACE, naming where to reply.
+ */
+interface SessionPrompting {
+    blocked_reason: PromptBlockedReason | null;
+    detail: string | null;
+    enabled: boolean;
+    surface_name: string | null;
+}
 /**
  * The three fields we expose. All `None` for an un-keyed (laptop) session.
  *
@@ -1272,4 +1312,4 @@ type AgentTurnStatus = components['schemas']['AgentTurnStatus'];
 type ListSessionExecutionsResponse = components['schemas']['ListSessionExecutionsResponse'];
 type SessionExecutionWire = components['schemas']['SessionExecutionWire'];
 
-export type { AgentSessionWire as A, BudgetSource as B, paths as C, DefaultResolution as D, ErrorFrame as E, GithubAccountSnippet as G, Harness as H, ListSessionRecordsResponse as L, ModelTokensInfo as M, ParentKind as P, RecordsAppendFrame as R, SessionMessageWire as S, TokensInfo as T, ListSessionTurnsResponse as a, ListSessionExecutionsResponse as b, AgentSessionExitStatus as c, AgentSessionPr as d, AgentSessionSource as e, AgentSessionStatus as f, AgentTurn as g, AgentTurnStatus as h, AttributionType as i, DeltaFrame as j, DoneFrame as k, GithubAccountType as l, HeartbeatFrame as m, SendSessionMessageRequest as n, SessionExecutionWire as o, SessionFrame as p, SessionLiveness as q, SessionMessageStatus as r, SessionRecordWire as s, SessionState as t, SessionStreamFrame as u, SessionSurface as v, SnapshotFrame as w, StreamFrame as x, TurnTokensInfo as y, components as z };
+export type { AgentSessionWire as A, BudgetSource as B, TurnTokensInfo as C, DefaultResolution as D, ErrorFrame as E, components as F, GithubAccountSnippet as G, Harness as H, paths as I, ListSessionRecordsResponse as L, ModelTokensInfo as M, ParentKind as P, RecordsAppendFrame as R, SessionMessageWire as S, TokensInfo as T, ListSessionTurnsResponse as a, ListSessionExecutionsResponse as b, AgentSessionExitStatus as c, AgentSessionPr as d, AgentSessionSource as e, AgentSessionStatus as f, AgentTurn as g, AgentTurnStatus as h, AttributionType as i, DeltaFrame as j, DoneFrame as k, GithubAccountType as l, HeartbeatFrame as m, PromptBlockedReason as n, SendSessionMessageRequest as o, SessionExecutionWire as p, SessionFrame as q, SessionLiveness as r, SessionMessageStatus as s, SessionPrompting as t, SessionRecordWire as u, SessionState as v, SessionStreamFrame as w, SessionSurface as x, SnapshotFrame as y, StreamFrame as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ellipsis-dev/sdk",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "TypeScript SDK for the Ellipsis agents platform: /v1 REST types + client, the session stream WebSocket client, and the session transcript store.",
   "license": "MIT",
   "type": "module",

package/schema/frames.schema.json

@@ -333,6 +333,9 @@
           "default": null,
           "title": "Prompt"
         },
+        "prompting": {
+          "$ref": "#/$defs/SessionPrompting"
+        },
         "replayed_from_session_id": {
           "anyOf": [
             {
@@ -536,6 +539,7 @@
         "parent_agent_session_id",
         "parent_kind",
         "prompt",
+        "prompting",
         "replayed_from_session_id",
         "resolved_budget_cents",
         "resolved_budget_source",
@@ -805,6 +809,18 @@
       "title": "ParentKind",
       "type": "string"
     },
+    "PromptBlockedReason": {
+      "description": "Why direct prompting is refused. Absent when prompting is allowed.",
+      "enum": [
+        "mention_surface",
+        "ephemeral_trigger",
+        "non_interactive",
+        "closed",
+        "laptop"
+      ],
+      "title": "PromptBlockedReason",
+      "type": "string"
+    },
     "RecordsAppendFrame": {
       "description": "Cursored append-only: raw records ordered by feed_seq, all sources.\nEvery record in the frame advances the resume cursor \u2014 including ones a\nclient renders as nothing (\u00a73.4).",
       "properties": {
@@ -995,6 +1011,58 @@
       "title": "SessionMessageWire",
       "type": "object"
     },
+    "SessionPrompting": {
+      "description": "The prompt-affordance projection. `enabled` answers \"would a send work\",\nand when it wouldn't, `blocked_reason` + `detail` say why.\n\n`surface_name` is set only for MENTION_SURFACE, naming where to reply.",
+      "properties": {
+        "blocked_reason": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/PromptBlockedReason"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "detail": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Detail"
+        },
+        "enabled": {
+          "title": "Enabled",
+          "type": "boolean"
+        },
+        "surface_name": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Surface Name"
+        }
+      },
+      "required": [
+        "blocked_reason",
+        "detail",
+        "enabled",
+        "surface_name"
+      ],
+      "title": "SessionPrompting",
+      "type": "object"
+    },
     "SessionRecordWire": {
       "description": "The wire shape of one session record (\u00a73.3): the \u00a73.6 stable envelope +\nthe native `payload`, by explicit allowlist. Internal-only columns\n(`search_text`, `clis`, ingest bookkeeping, attribution denormalizations)\nare deliberately absent so internal model evolution stays free.",
       "properties": {

package/schema/lifecycle.schema.json

@@ -314,6 +314,18 @@
     "SessionScheduledPayload": {
       "description": "session_scheduled \u2014 the session row exists and is queued for a worker.\nThe one session-scoped record emitted at creation (no execution yet).",
       "properties": {
+        "config_commit_sha": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Config Commit Sha"
+        },
         "config_name": {
           "anyOf": [
             {

package/schema/openapi.v1.json

@@ -314,6 +314,9 @@
             ],
             "title": "Prompt"
           },
+          "prompting": {
+            "$ref": "#/components/schemas/SessionPrompting"
+          },
           "replayed_from_session_id": {
             "anyOf": [
               {
@@ -491,7 +494,8 @@
           "tokens_model",
           "resolved_budget_cents",
           "resolved_budget_source",
-          "status"
+          "status",
+          "prompting"
         ],
         "title": "AgentSessionWire",
         "type": "object"
@@ -922,6 +926,18 @@
         "title": "ParentKind",
         "type": "string"
       },
+      "PromptBlockedReason": {
+        "description": "Why direct prompting is refused. Absent when prompting is allowed.",
+        "enum": [
+          "mention_surface",
+          "ephemeral_trigger",
+          "non_interactive",
+          "closed",
+          "laptop"
+        ],
+        "title": "PromptBlockedReason",
+        "type": "string"
+      },
       "RecordSource": {
         "description": "`session_records.source` \u2014 the client render switch. `lifecycle` rows are\ncontroller-emitted platform notifications; a harness value means a native\ntranscript record from that harness.",
         "enum": [
@@ -1331,6 +1347,52 @@
         "title": "SessionMessageWire",
         "type": "object"
       },
+      "SessionPrompting": {
+        "description": "The prompt-affordance projection. `enabled` answers \"would a send work\",\nand when it wouldn't, `blocked_reason` + `detail` say why.\n\n`surface_name` is set only for MENTION_SURFACE, naming where to reply.",
+        "properties": {
+          "blocked_reason": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/PromptBlockedReason"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "detail": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Detail"
+          },
+          "enabled": {
+            "title": "Enabled",
+            "type": "boolean"
+          },
+          "surface_name": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Surface Name"
+          }
+        },
+        "required": [
+          "enabled"
+        ],
+        "title": "SessionPrompting",
+        "type": "object"
+      },
       "SessionRecordWire": {
         "description": "The wire shape of one session record (\u00a73.3): the \u00a73.6 stable envelope +\nthe native `payload`, by explicit allowlist. Internal-only columns\n(`search_text`, `clis`, ingest bookkeeping, attribution denormalizations)\nare deliberately absent so internal model evolution stays free.",
         "properties": {