@ellipsis-dev/sdk 0.2.1 → 0.2.2

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-B5A_axbQ.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-B5A_axbQ.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 { s as SessionRecordWire, A as AgentSessionWire, S as SessionMessageWire, x as StreamFrame } from '../types-B5A_axbQ.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 { x as StreamFrame, A as AgentSessionWire } from '../types-B5A_axbQ.js';
 
 declare const SESSION_STREAM_PROTOCOL_VERSION = 3;
 declare const WS_CLOSE_NORMAL = 1000;

package/dist/{types-CtvSTnzA.d.ts → types-B5A_axbQ.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.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ellipsis-dev/sdk",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "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": {