@ellipsis-dev/sdk 0.36.0 → 0.38.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +186 -510
- package/dist/index.js +90 -430
- package/dist/store/index.d.ts +11 -25
- package/dist/store/index.js +151 -284
- package/dist/stream/index.d.ts +2 -3
- package/dist/stream/index.js +11 -22
- package/dist/{types-CbePyY-S.d.ts → types-D4cLMGUn.d.ts} +1896 -4803
- package/package.json +1 -1
- package/schema/collection_frames.schema.json +442 -231
- package/schema/frames.schema.json +1089 -1521
- package/schema/lifecycle.schema.json +389 -150
- package/schema/openapi.v1.json +3972 -8663
- package/schema/trigger_fields.schema.json +6 -1
|
@@ -501,7 +501,7 @@
|
|
|
501
501
|
}
|
|
502
502
|
],
|
|
503
503
|
"default": null,
|
|
504
|
-
"description": "The initial user message, passed verbatim. Omit to start an interactive session with no
|
|
504
|
+
"description": "The initial user message, passed verbatim. Omit to start an interactive session with no message, waiting for one.",
|
|
505
505
|
"title": "Prompt"
|
|
506
506
|
},
|
|
507
507
|
"settings": {
|
|
@@ -541,7 +541,7 @@
|
|
|
541
541
|
}
|
|
542
542
|
],
|
|
543
543
|
"default": null,
|
|
544
|
-
"description": "Reasoning effort for every
|
|
544
|
+
"description": "Reasoning effort for every message. Omit to use the model default."
|
|
545
545
|
},
|
|
546
546
|
"model": {
|
|
547
547
|
"description": "The model the session runs on: a Responses-capable id from the models table. Required.",
|
|
@@ -558,7 +558,7 @@
|
|
|
558
558
|
}
|
|
559
559
|
],
|
|
560
560
|
"default": null,
|
|
561
|
-
"description": "The initial user message, passed verbatim. Omit to start an interactive session with no
|
|
561
|
+
"description": "The initial user message, passed verbatim. Omit to start an interactive session with no message, waiting for one.",
|
|
562
562
|
"title": "Prompt"
|
|
563
563
|
}
|
|
564
564
|
},
|
|
@@ -1159,6 +1159,30 @@
|
|
|
1159
1159
|
"title": "EnvironmentVariable",
|
|
1160
1160
|
"type": "object"
|
|
1161
1161
|
},
|
|
1162
|
+
"ErrorReason": {
|
|
1163
|
+
"description": "Why a message failed, was stopped, or was cancelled.",
|
|
1164
|
+
"enum": [
|
|
1165
|
+
"error",
|
|
1166
|
+
"tool_call_failed",
|
|
1167
|
+
"budget_hit",
|
|
1168
|
+
"payment_required",
|
|
1169
|
+
"blocked",
|
|
1170
|
+
"contact_email_required",
|
|
1171
|
+
"lifecycle_hook_failed",
|
|
1172
|
+
"missing_repo_access",
|
|
1173
|
+
"missing_token_permissions",
|
|
1174
|
+
"missing_environment_variables",
|
|
1175
|
+
"missing_github_integration",
|
|
1176
|
+
"agent_unavailable",
|
|
1177
|
+
"upstream_unavailable",
|
|
1178
|
+
"unsupported_configuration",
|
|
1179
|
+
"execution_disabled",
|
|
1180
|
+
"interrupted",
|
|
1181
|
+
"stopped"
|
|
1182
|
+
],
|
|
1183
|
+
"title": "ErrorReason",
|
|
1184
|
+
"type": "string"
|
|
1185
|
+
},
|
|
1162
1186
|
"GeminiConfig": {
|
|
1163
1187
|
"additionalProperties": false,
|
|
1164
1188
|
"description": "Native options supported by the current Gemini CLI adapter.",
|
|
@@ -1178,7 +1202,7 @@
|
|
|
1178
1202
|
}
|
|
1179
1203
|
],
|
|
1180
1204
|
"default": null,
|
|
1181
|
-
"description": "The initial user message, passed verbatim. Omit to start an interactive session with no
|
|
1205
|
+
"description": "The initial user message, passed verbatim. Omit to start an interactive session with no message, waiting for one.",
|
|
1182
1206
|
"title": "Prompt"
|
|
1183
1207
|
}
|
|
1184
1208
|
},
|
|
@@ -2051,11 +2075,82 @@
|
|
|
2051
2075
|
},
|
|
2052
2076
|
"LinearIssueAction": {
|
|
2053
2077
|
"enum": [
|
|
2054
|
-
"opened"
|
|
2078
|
+
"opened",
|
|
2079
|
+
"updated"
|
|
2055
2080
|
],
|
|
2056
2081
|
"title": "LinearIssueAction",
|
|
2057
2082
|
"type": "string"
|
|
2058
2083
|
},
|
|
2084
|
+
"LinearIssueChanged": {
|
|
2085
|
+
"additionalProperties": false,
|
|
2086
|
+
"description": "The fields an `updated` event watches. Every listed field must change in\nthe same edit.",
|
|
2087
|
+
"properties": {
|
|
2088
|
+
"assignee": {
|
|
2089
|
+
"anyOf": [
|
|
2090
|
+
{
|
|
2091
|
+
"$ref": "#/$defs/LinearValueChange"
|
|
2092
|
+
},
|
|
2093
|
+
{
|
|
2094
|
+
"type": "null"
|
|
2095
|
+
}
|
|
2096
|
+
],
|
|
2097
|
+
"default": null
|
|
2098
|
+
},
|
|
2099
|
+
"labels": {
|
|
2100
|
+
"anyOf": [
|
|
2101
|
+
{
|
|
2102
|
+
"$ref": "#/$defs/LinearLabelsChange"
|
|
2103
|
+
},
|
|
2104
|
+
{
|
|
2105
|
+
"type": "null"
|
|
2106
|
+
}
|
|
2107
|
+
],
|
|
2108
|
+
"default": null
|
|
2109
|
+
},
|
|
2110
|
+
"priority": {
|
|
2111
|
+
"anyOf": [
|
|
2112
|
+
{
|
|
2113
|
+
"$ref": "#/$defs/LinearValueChange"
|
|
2114
|
+
},
|
|
2115
|
+
{
|
|
2116
|
+
"type": "null"
|
|
2117
|
+
}
|
|
2118
|
+
],
|
|
2119
|
+
"default": null
|
|
2120
|
+
},
|
|
2121
|
+
"project": {
|
|
2122
|
+
"anyOf": [
|
|
2123
|
+
{
|
|
2124
|
+
"$ref": "#/$defs/LinearValueChange"
|
|
2125
|
+
},
|
|
2126
|
+
{
|
|
2127
|
+
"type": "null"
|
|
2128
|
+
}
|
|
2129
|
+
],
|
|
2130
|
+
"default": null
|
|
2131
|
+
},
|
|
2132
|
+
"state": {
|
|
2133
|
+
"anyOf": [
|
|
2134
|
+
{
|
|
2135
|
+
"$ref": "#/$defs/LinearValueChange"
|
|
2136
|
+
},
|
|
2137
|
+
{
|
|
2138
|
+
"type": "null"
|
|
2139
|
+
}
|
|
2140
|
+
],
|
|
2141
|
+
"default": null
|
|
2142
|
+
}
|
|
2143
|
+
},
|
|
2144
|
+
"required": [
|
|
2145
|
+
"assignee",
|
|
2146
|
+
"labels",
|
|
2147
|
+
"priority",
|
|
2148
|
+
"project",
|
|
2149
|
+
"state"
|
|
2150
|
+
],
|
|
2151
|
+
"title": "LinearIssueChanged",
|
|
2152
|
+
"type": "object"
|
|
2153
|
+
},
|
|
2059
2154
|
"LinearIssueEvent": {
|
|
2060
2155
|
"properties": {
|
|
2061
2156
|
"action": {
|
|
@@ -2127,6 +2222,115 @@
|
|
|
2127
2222
|
"title": "LinearIssueEvent",
|
|
2128
2223
|
"type": "object"
|
|
2129
2224
|
},
|
|
2225
|
+
"LinearLabelsChange": {
|
|
2226
|
+
"additionalProperties": false,
|
|
2227
|
+
"description": "A change to the issue's labels. `added` matches when a listed label was\nadded and `removed` when a listed label was removed. `{}` is any label\nchange.",
|
|
2228
|
+
"properties": {
|
|
2229
|
+
"added": {
|
|
2230
|
+
"anyOf": [
|
|
2231
|
+
{
|
|
2232
|
+
"$ref": "#/$defs/LinearValueFilter"
|
|
2233
|
+
},
|
|
2234
|
+
{
|
|
2235
|
+
"type": "null"
|
|
2236
|
+
}
|
|
2237
|
+
],
|
|
2238
|
+
"default": null
|
|
2239
|
+
},
|
|
2240
|
+
"removed": {
|
|
2241
|
+
"anyOf": [
|
|
2242
|
+
{
|
|
2243
|
+
"$ref": "#/$defs/LinearValueFilter"
|
|
2244
|
+
},
|
|
2245
|
+
{
|
|
2246
|
+
"type": "null"
|
|
2247
|
+
}
|
|
2248
|
+
],
|
|
2249
|
+
"default": null
|
|
2250
|
+
}
|
|
2251
|
+
},
|
|
2252
|
+
"required": [
|
|
2253
|
+
"added",
|
|
2254
|
+
"removed"
|
|
2255
|
+
],
|
|
2256
|
+
"title": "LinearLabelsChange",
|
|
2257
|
+
"type": "object"
|
|
2258
|
+
},
|
|
2259
|
+
"LinearValueChange": {
|
|
2260
|
+
"additionalProperties": false,
|
|
2261
|
+
"description": "A change to one issue field. `from` matches the value before the change\nand `to` the value after it. Leaving either out matches any value, so `{}`\nis any change to the field.",
|
|
2262
|
+
"properties": {
|
|
2263
|
+
"from": {
|
|
2264
|
+
"anyOf": [
|
|
2265
|
+
{
|
|
2266
|
+
"$ref": "#/$defs/LinearValueFilter"
|
|
2267
|
+
},
|
|
2268
|
+
{
|
|
2269
|
+
"type": "null"
|
|
2270
|
+
}
|
|
2271
|
+
],
|
|
2272
|
+
"default": null
|
|
2273
|
+
},
|
|
2274
|
+
"to": {
|
|
2275
|
+
"anyOf": [
|
|
2276
|
+
{
|
|
2277
|
+
"$ref": "#/$defs/LinearValueFilter"
|
|
2278
|
+
},
|
|
2279
|
+
{
|
|
2280
|
+
"type": "null"
|
|
2281
|
+
}
|
|
2282
|
+
],
|
|
2283
|
+
"default": null
|
|
2284
|
+
}
|
|
2285
|
+
},
|
|
2286
|
+
"required": [
|
|
2287
|
+
"from",
|
|
2288
|
+
"to"
|
|
2289
|
+
],
|
|
2290
|
+
"title": "LinearValueChange",
|
|
2291
|
+
"type": "object"
|
|
2292
|
+
},
|
|
2293
|
+
"LinearValueFilter": {
|
|
2294
|
+
"anyOf": [
|
|
2295
|
+
{
|
|
2296
|
+
"additionalProperties": false,
|
|
2297
|
+
"description": "Linear names to match, include minus exclude. A bare list or a bare\nstring is shorthand for `include`. It matches when one of the issue's\nvalues is included (or nothing is) and none is excluded. `none` names an\nunset assignee or project, and `any` names any set assignee.",
|
|
2298
|
+
"properties": {
|
|
2299
|
+
"exclude": {
|
|
2300
|
+
"default": [],
|
|
2301
|
+
"items": {
|
|
2302
|
+
"type": "string"
|
|
2303
|
+
},
|
|
2304
|
+
"title": "Exclude",
|
|
2305
|
+
"type": "array"
|
|
2306
|
+
},
|
|
2307
|
+
"include": {
|
|
2308
|
+
"default": [],
|
|
2309
|
+
"items": {
|
|
2310
|
+
"type": "string"
|
|
2311
|
+
},
|
|
2312
|
+
"title": "Include",
|
|
2313
|
+
"type": "array"
|
|
2314
|
+
}
|
|
2315
|
+
},
|
|
2316
|
+
"required": [
|
|
2317
|
+
"exclude",
|
|
2318
|
+
"include"
|
|
2319
|
+
],
|
|
2320
|
+
"title": "LinearValueFilter",
|
|
2321
|
+
"type": "object"
|
|
2322
|
+
},
|
|
2323
|
+
{
|
|
2324
|
+
"items": {
|
|
2325
|
+
"type": "string"
|
|
2326
|
+
},
|
|
2327
|
+
"type": "array"
|
|
2328
|
+
},
|
|
2329
|
+
{
|
|
2330
|
+
"type": "string"
|
|
2331
|
+
}
|
|
2332
|
+
]
|
|
2333
|
+
},
|
|
2130
2334
|
"LlmCost": {
|
|
2131
2335
|
"description": "What LLM tokens cost, in total and by model.",
|
|
2132
2336
|
"properties": {
|
|
@@ -2457,7 +2661,8 @@
|
|
|
2457
2661
|
"non_interactive",
|
|
2458
2662
|
"harness_single_turn",
|
|
2459
2663
|
"budget_exhausted",
|
|
2460
|
-
"closed"
|
|
2664
|
+
"closed",
|
|
2665
|
+
"archived"
|
|
2461
2666
|
],
|
|
2462
2667
|
"title": "PromptBlockedReason",
|
|
2463
2668
|
"type": "string"
|
|
@@ -2498,9 +2703,6 @@
|
|
|
2498
2703
|
"type": "array"
|
|
2499
2704
|
},
|
|
2500
2705
|
"on": {
|
|
2501
|
-
"default": [
|
|
2502
|
-
"failed"
|
|
2503
|
-
],
|
|
2504
2706
|
"items": {
|
|
2505
2707
|
"$ref": "#/$defs/CheckRunAction"
|
|
2506
2708
|
},
|
|
@@ -2545,9 +2747,6 @@
|
|
|
2545
2747
|
"$ref": "#/$defs/GithubAccountSelector"
|
|
2546
2748
|
},
|
|
2547
2749
|
"on": {
|
|
2548
|
-
"default": [
|
|
2549
|
-
"failed"
|
|
2550
|
-
],
|
|
2551
2750
|
"items": {
|
|
2552
2751
|
"$ref": "#/$defs/CheckSuiteAction"
|
|
2553
2752
|
},
|
|
@@ -2604,24 +2803,106 @@
|
|
|
2604
2803
|
},
|
|
2605
2804
|
"ReactLinearIssue": {
|
|
2606
2805
|
"additionalProperties": false,
|
|
2806
|
+
"description": "A Linear issue being created (`opened`) or changed (`updated`). An\n`updated` event fires only when every field under `changed` changed in\none edit. `team`, `state`, `labels`, `project`, `assignee`, and\n`priority` filter on the issue as it is after the event. `state` matches\na status name or a status type. `for` is the person who created or\nchanged the issue.",
|
|
2607
2807
|
"properties": {
|
|
2808
|
+
"assignee": {
|
|
2809
|
+
"anyOf": [
|
|
2810
|
+
{
|
|
2811
|
+
"$ref": "#/$defs/LinearValueFilter"
|
|
2812
|
+
},
|
|
2813
|
+
{
|
|
2814
|
+
"type": "null"
|
|
2815
|
+
}
|
|
2816
|
+
],
|
|
2817
|
+
"default": null
|
|
2818
|
+
},
|
|
2819
|
+
"changed": {
|
|
2820
|
+
"anyOf": [
|
|
2821
|
+
{
|
|
2822
|
+
"$ref": "#/$defs/LinearIssueChanged"
|
|
2823
|
+
},
|
|
2824
|
+
{
|
|
2825
|
+
"type": "null"
|
|
2826
|
+
}
|
|
2827
|
+
],
|
|
2828
|
+
"default": null
|
|
2829
|
+
},
|
|
2608
2830
|
"for": {
|
|
2609
2831
|
"$ref": "#/$defs/GithubAccountSelector"
|
|
2610
2832
|
},
|
|
2611
|
-
"
|
|
2612
|
-
"
|
|
2613
|
-
|
|
2833
|
+
"labels": {
|
|
2834
|
+
"anyOf": [
|
|
2835
|
+
{
|
|
2836
|
+
"$ref": "#/$defs/LinearValueFilter"
|
|
2837
|
+
},
|
|
2838
|
+
{
|
|
2839
|
+
"type": "null"
|
|
2840
|
+
}
|
|
2614
2841
|
],
|
|
2842
|
+
"default": null
|
|
2843
|
+
},
|
|
2844
|
+
"on": {
|
|
2615
2845
|
"items": {
|
|
2616
2846
|
"$ref": "#/$defs/LinearIssueAction"
|
|
2617
2847
|
},
|
|
2618
2848
|
"title": "On",
|
|
2619
2849
|
"type": "array"
|
|
2850
|
+
},
|
|
2851
|
+
"priority": {
|
|
2852
|
+
"anyOf": [
|
|
2853
|
+
{
|
|
2854
|
+
"$ref": "#/$defs/LinearValueFilter"
|
|
2855
|
+
},
|
|
2856
|
+
{
|
|
2857
|
+
"type": "null"
|
|
2858
|
+
}
|
|
2859
|
+
],
|
|
2860
|
+
"default": null
|
|
2861
|
+
},
|
|
2862
|
+
"project": {
|
|
2863
|
+
"anyOf": [
|
|
2864
|
+
{
|
|
2865
|
+
"$ref": "#/$defs/LinearValueFilter"
|
|
2866
|
+
},
|
|
2867
|
+
{
|
|
2868
|
+
"type": "null"
|
|
2869
|
+
}
|
|
2870
|
+
],
|
|
2871
|
+
"default": null
|
|
2872
|
+
},
|
|
2873
|
+
"state": {
|
|
2874
|
+
"anyOf": [
|
|
2875
|
+
{
|
|
2876
|
+
"$ref": "#/$defs/LinearValueFilter"
|
|
2877
|
+
},
|
|
2878
|
+
{
|
|
2879
|
+
"type": "null"
|
|
2880
|
+
}
|
|
2881
|
+
],
|
|
2882
|
+
"default": null
|
|
2883
|
+
},
|
|
2884
|
+
"team": {
|
|
2885
|
+
"anyOf": [
|
|
2886
|
+
{
|
|
2887
|
+
"$ref": "#/$defs/LinearValueFilter"
|
|
2888
|
+
},
|
|
2889
|
+
{
|
|
2890
|
+
"type": "null"
|
|
2891
|
+
}
|
|
2892
|
+
],
|
|
2893
|
+
"default": null
|
|
2620
2894
|
}
|
|
2621
2895
|
},
|
|
2622
2896
|
"required": [
|
|
2897
|
+
"assignee",
|
|
2898
|
+
"changed",
|
|
2623
2899
|
"for",
|
|
2624
|
-
"
|
|
2900
|
+
"labels",
|
|
2901
|
+
"on",
|
|
2902
|
+
"priority",
|
|
2903
|
+
"project",
|
|
2904
|
+
"state",
|
|
2905
|
+
"team"
|
|
2625
2906
|
],
|
|
2626
2907
|
"title": "ReactLinearIssue",
|
|
2627
2908
|
"type": "object"
|
|
@@ -2743,9 +3024,6 @@
|
|
|
2743
3024
|
"$ref": "#/$defs/GithubAccountSelector"
|
|
2744
3025
|
},
|
|
2745
3026
|
"on": {
|
|
2746
|
-
"default": [
|
|
2747
|
-
"published"
|
|
2748
|
-
],
|
|
2749
3027
|
"items": {
|
|
2750
3028
|
"$ref": "#/$defs/ReleaseAction"
|
|
2751
3029
|
},
|
|
@@ -2842,9 +3120,6 @@
|
|
|
2842
3120
|
"type": "array"
|
|
2843
3121
|
},
|
|
2844
3122
|
"on": {
|
|
2845
|
-
"default": [
|
|
2846
|
-
"failed"
|
|
2847
|
-
],
|
|
2848
3123
|
"items": {
|
|
2849
3124
|
"$ref": "#/$defs/StatusAction"
|
|
2850
3125
|
},
|
|
@@ -3044,9 +3319,6 @@
|
|
|
3044
3319
|
"type": "array"
|
|
3045
3320
|
},
|
|
3046
3321
|
"on": {
|
|
3047
|
-
"default": [
|
|
3048
|
-
"failed"
|
|
3049
|
-
],
|
|
3050
3322
|
"items": {
|
|
3051
3323
|
"$ref": "#/$defs/WorkflowRunAction"
|
|
3052
3324
|
},
|
|
@@ -3512,7 +3784,7 @@
|
|
|
3512
3784
|
]
|
|
3513
3785
|
}
|
|
3514
3786
|
],
|
|
3515
|
-
"description": "An agent session: one conversation with an agent. Returned by\n`GET /v1/sessions/{id}` and carried by the session stream's\n`session
|
|
3787
|
+
"description": "An agent session: one conversation with an agent. Returned by\n`GET /v1/sessions/{id}` and carried by the session stream's\n`session` frames; REST and stream never disagree about what a\nsession looks like.",
|
|
3516
3788
|
"properties": {
|
|
3517
3789
|
"agent": {
|
|
3518
3790
|
"anyOf": [
|
|
@@ -3536,7 +3808,7 @@
|
|
|
3536
3808
|
}
|
|
3537
3809
|
],
|
|
3538
3810
|
"default": null,
|
|
3539
|
-
"description": "When and by whom the session was archived
|
|
3811
|
+
"description": "When and by whom the session was archived, or null when it isn't. A session is archived when it closes, after the account's archive_inactive_sessions_days without a message, or by PUT /v1/sessions/{id}. An archived session takes no messages, and a reply on the Slack thread, pull request, issue, or Linear issue it answers starts a new session."
|
|
3540
3812
|
},
|
|
3541
3813
|
"attribution": {
|
|
3542
3814
|
"$ref": "#/$defs/SessionAttribution",
|
|
@@ -3572,6 +3844,20 @@
|
|
|
3572
3844
|
"default": null,
|
|
3573
3845
|
"description": "Codex input and native options. Set exactly one of claude_code, codex, or gemini."
|
|
3574
3846
|
},
|
|
3847
|
+
"content_deleted_at": {
|
|
3848
|
+
"anyOf": [
|
|
3849
|
+
{
|
|
3850
|
+
"format": "date-time",
|
|
3851
|
+
"type": "string"
|
|
3852
|
+
},
|
|
3853
|
+
{
|
|
3854
|
+
"type": "null"
|
|
3855
|
+
}
|
|
3856
|
+
],
|
|
3857
|
+
"default": null,
|
|
3858
|
+
"description": "When session log retention deleted the session's records, messages, and prompt, or null. The session's status, cost, tokens, and summary stay.",
|
|
3859
|
+
"title": "Content Deleted At"
|
|
3860
|
+
},
|
|
3575
3861
|
"conversation": {
|
|
3576
3862
|
"$ref": "#/$defs/SessionConversation",
|
|
3577
3863
|
"description": "Whether the session can take more messages, and whether an agent is warm to answer one."
|
|
@@ -3590,6 +3876,18 @@
|
|
|
3590
3876
|
"$ref": "#/$defs/SessionEnvironment",
|
|
3591
3877
|
"description": "The full environment configuration frozen when the session was created, with the saved environment's id and how it was chosen."
|
|
3592
3878
|
},
|
|
3879
|
+
"error": {
|
|
3880
|
+
"anyOf": [
|
|
3881
|
+
{
|
|
3882
|
+
"$ref": "#/$defs/SessionError"
|
|
3883
|
+
},
|
|
3884
|
+
{
|
|
3885
|
+
"type": "null"
|
|
3886
|
+
}
|
|
3887
|
+
],
|
|
3888
|
+
"default": null,
|
|
3889
|
+
"description": "Why the last message failed, was stopped, or was cancelled; null otherwise."
|
|
3890
|
+
},
|
|
3593
3891
|
"event": {
|
|
3594
3892
|
"anyOf": [
|
|
3595
3893
|
{
|
|
@@ -3717,7 +4015,7 @@
|
|
|
3717
4015
|
}
|
|
3718
4016
|
],
|
|
3719
4017
|
"default": null,
|
|
3720
|
-
"description": "The session's structured output: the `json_schema` the agent must satisfy and, once
|
|
4018
|
+
"description": "The session's structured output: the `json_schema` the agent must satisfy and, once the agent has submitted it, the `result`."
|
|
3721
4019
|
},
|
|
3722
4020
|
"parent": {
|
|
3723
4021
|
"anyOf": [
|
|
@@ -3735,6 +4033,18 @@
|
|
|
3735
4033
|
"$ref": "#/$defs/PermissionsConfig",
|
|
3736
4034
|
"description": "What the session may touch, per minted credential."
|
|
3737
4035
|
},
|
|
4036
|
+
"review": {
|
|
4037
|
+
"anyOf": [
|
|
4038
|
+
{
|
|
4039
|
+
"$ref": "#/$defs/SessionReview"
|
|
4040
|
+
},
|
|
4041
|
+
{
|
|
4042
|
+
"type": "null"
|
|
4043
|
+
}
|
|
4044
|
+
],
|
|
4045
|
+
"default": null,
|
|
4046
|
+
"description": "The code review this session ran for; null unless the source is `code_review`."
|
|
4047
|
+
},
|
|
3738
4048
|
"skills": {
|
|
3739
4049
|
"description": "Skills installed for this session.",
|
|
3740
4050
|
"items": {
|
|
@@ -3747,6 +4057,10 @@
|
|
|
3747
4057
|
"$ref": "#/$defs/SessionSource",
|
|
3748
4058
|
"description": "Where the session came from (e.g. react, web, api, cli, mention, cron)."
|
|
3749
4059
|
},
|
|
4060
|
+
"status": {
|
|
4061
|
+
"$ref": "#/$defs/SessionStatus",
|
|
4062
|
+
"description": "Where the session is. A message you sent is answered once the status is `idle` or `closed`; its `message_ended` record in GET /v1/sessions/{id}/records says how."
|
|
4063
|
+
},
|
|
3750
4064
|
"summary": {
|
|
3751
4065
|
"anyOf": [
|
|
3752
4066
|
{
|
|
@@ -3763,23 +4077,24 @@
|
|
|
3763
4077
|
"$ref": "#/$defs/Tokens",
|
|
3764
4078
|
"description": "The tokens the session has used so far."
|
|
3765
4079
|
},
|
|
3766
|
-
"
|
|
4080
|
+
"updated_at": {
|
|
4081
|
+
"description": "When the session was last updated.",
|
|
4082
|
+
"format": "date-time",
|
|
4083
|
+
"title": "Updated At",
|
|
4084
|
+
"type": "string"
|
|
4085
|
+
},
|
|
4086
|
+
"wait_ms": {
|
|
3767
4087
|
"anyOf": [
|
|
3768
4088
|
{
|
|
3769
|
-
"
|
|
4089
|
+
"type": "integer"
|
|
3770
4090
|
},
|
|
3771
4091
|
{
|
|
3772
4092
|
"type": "null"
|
|
3773
4093
|
}
|
|
3774
4094
|
],
|
|
3775
4095
|
"default": null,
|
|
3776
|
-
"description": "
|
|
3777
|
-
|
|
3778
|
-
"updated_at": {
|
|
3779
|
-
"description": "When the session was last updated.",
|
|
3780
|
-
"format": "date-time",
|
|
3781
|
-
"title": "Updated At",
|
|
3782
|
-
"type": "string"
|
|
4096
|
+
"description": "Milliseconds from when the session was created to when it started, including any time it waited because your account already had its limit of sessions alive. Null until the session starts, and for sessions created before this field was added.",
|
|
4097
|
+
"title": "Wait Ms"
|
|
3783
4098
|
}
|
|
3784
4099
|
},
|
|
3785
4100
|
"required": [
|
|
@@ -3789,10 +4104,12 @@
|
|
|
3789
4104
|
"budget",
|
|
3790
4105
|
"claude_code",
|
|
3791
4106
|
"codex",
|
|
4107
|
+
"content_deleted_at",
|
|
3792
4108
|
"conversation",
|
|
3793
4109
|
"cost",
|
|
3794
4110
|
"created_at",
|
|
3795
4111
|
"environment",
|
|
4112
|
+
"error",
|
|
3796
4113
|
"event",
|
|
3797
4114
|
"gemini",
|
|
3798
4115
|
"git",
|
|
@@ -3802,12 +4119,14 @@
|
|
|
3802
4119
|
"output",
|
|
3803
4120
|
"parent",
|
|
3804
4121
|
"permissions",
|
|
4122
|
+
"review",
|
|
3805
4123
|
"skills",
|
|
3806
4124
|
"source",
|
|
4125
|
+
"status",
|
|
3807
4126
|
"summary",
|
|
3808
4127
|
"tokens",
|
|
3809
|
-
"
|
|
3810
|
-
"
|
|
4128
|
+
"updated_at",
|
|
4129
|
+
"wait_ms"
|
|
3811
4130
|
],
|
|
3812
4131
|
"title": "Session",
|
|
3813
4132
|
"type": "object"
|
|
@@ -3860,11 +4179,26 @@
|
|
|
3860
4179
|
],
|
|
3861
4180
|
"default": null,
|
|
3862
4181
|
"description": "The GitHub user who archived the session; null if unknown or unavailable."
|
|
4182
|
+
},
|
|
4183
|
+
"deletes_at": {
|
|
4184
|
+
"anyOf": [
|
|
4185
|
+
{
|
|
4186
|
+
"format": "date-time",
|
|
4187
|
+
"type": "string"
|
|
4188
|
+
},
|
|
4189
|
+
{
|
|
4190
|
+
"type": "null"
|
|
4191
|
+
}
|
|
4192
|
+
],
|
|
4193
|
+
"default": null,
|
|
4194
|
+
"description": "When the session's records and messages are deleted, from the account's current session log retention. It moves when the retention changes. Null when the account keeps them or they're already deleted.",
|
|
4195
|
+
"title": "Deletes At"
|
|
3863
4196
|
}
|
|
3864
4197
|
},
|
|
3865
4198
|
"required": [
|
|
3866
4199
|
"at",
|
|
3867
|
-
"by"
|
|
4200
|
+
"by",
|
|
4201
|
+
"deletes_at"
|
|
3868
4202
|
],
|
|
3869
4203
|
"title": "SessionArchived",
|
|
3870
4204
|
"type": "object"
|
|
@@ -4123,7 +4457,7 @@
|
|
|
4123
4457
|
"description": "Whether the session can take more messages, and how quickly it would\nanswer one.",
|
|
4124
4458
|
"properties": {
|
|
4125
4459
|
"interactive": {
|
|
4126
|
-
"description": "Whether the session stays open after its first
|
|
4460
|
+
"description": "Whether the session stays open after its first message is answered.",
|
|
4127
4461
|
"title": "Interactive",
|
|
4128
4462
|
"type": "boolean"
|
|
4129
4463
|
},
|
|
@@ -4131,10 +4465,6 @@
|
|
|
4131
4465
|
"$ref": "#/$defs/SessionPrompting",
|
|
4132
4466
|
"description": "The session's policy for direct messages. Caller authorization and message validation are checked separately."
|
|
4133
4467
|
},
|
|
4134
|
-
"state": {
|
|
4135
|
-
"$ref": "#/$defs/SessionState",
|
|
4136
|
-
"description": "`open` while the session can take messages; `closed` is permanent."
|
|
4137
|
-
},
|
|
4138
4468
|
"warm": {
|
|
4139
4469
|
"description": "Whether an agent is ready to answer the next message right away. When false, the next message first prepares an environment, which takes longer. A hint only; clients need no logic on it.",
|
|
4140
4470
|
"title": "Warm",
|
|
@@ -4144,7 +4474,6 @@
|
|
|
4144
4474
|
"required": [
|
|
4145
4475
|
"interactive",
|
|
4146
4476
|
"prompting",
|
|
4147
|
-
"state",
|
|
4148
4477
|
"warm"
|
|
4149
4478
|
],
|
|
4150
4479
|
"title": "SessionConversation",
|
|
@@ -4156,7 +4485,7 @@
|
|
|
4156
4485
|
"properties": {
|
|
4157
4486
|
"interactive": {
|
|
4158
4487
|
"default": true,
|
|
4159
|
-
"description": "Whether the session stays open after its first
|
|
4488
|
+
"description": "Whether the session stays open after its first message is answered. Defaults to true; false runs once and requires a prompt. Requires the model's interactive capability when true. Direct message acceptance is reported separately in conversation.prompting.",
|
|
4160
4489
|
"title": "Interactive",
|
|
4161
4490
|
"type": "boolean"
|
|
4162
4491
|
}
|
|
@@ -4265,6 +4594,34 @@
|
|
|
4265
4594
|
"title": "SessionEnvironment",
|
|
4266
4595
|
"type": "object"
|
|
4267
4596
|
},
|
|
4597
|
+
"SessionError": {
|
|
4598
|
+
"description": "Why the last message failed, was stopped, or was cancelled. Cleared\nwhen the next message starts.",
|
|
4599
|
+
"properties": {
|
|
4600
|
+
"detail": {
|
|
4601
|
+
"anyOf": [
|
|
4602
|
+
{
|
|
4603
|
+
"type": "string"
|
|
4604
|
+
},
|
|
4605
|
+
{
|
|
4606
|
+
"type": "null"
|
|
4607
|
+
}
|
|
4608
|
+
],
|
|
4609
|
+
"default": null,
|
|
4610
|
+
"description": "A human-readable explanation.",
|
|
4611
|
+
"title": "Detail"
|
|
4612
|
+
},
|
|
4613
|
+
"reason": {
|
|
4614
|
+
"$ref": "#/$defs/ErrorReason",
|
|
4615
|
+
"description": "What went wrong."
|
|
4616
|
+
}
|
|
4617
|
+
},
|
|
4618
|
+
"required": [
|
|
4619
|
+
"detail",
|
|
4620
|
+
"reason"
|
|
4621
|
+
],
|
|
4622
|
+
"title": "SessionError",
|
|
4623
|
+
"type": "object"
|
|
4624
|
+
},
|
|
4268
4625
|
"SessionEventActor": {
|
|
4269
4626
|
"description": "The event's initiator, when known; never inferred from resource ownership.",
|
|
4270
4627
|
"properties": {
|
|
@@ -4568,7 +4925,7 @@
|
|
|
4568
4925
|
"type": "object"
|
|
4569
4926
|
},
|
|
4570
4927
|
"SessionOutput": {
|
|
4571
|
-
"description": "Structured output on the wire: the contract and, when
|
|
4928
|
+
"description": "Structured output on the wire: the contract and, when the agent has\nsubmitted one, the payload. `result` is None while the session runs and\nwhen the agent submitted nothing; it is the agent's own JSON, in the\nshape of `json_schema`.",
|
|
4572
4929
|
"properties": {
|
|
4573
4930
|
"json_schema": {
|
|
4574
4931
|
"additionalProperties": true,
|
|
@@ -4587,7 +4944,7 @@
|
|
|
4587
4944
|
}
|
|
4588
4945
|
],
|
|
4589
4946
|
"default": null,
|
|
4590
|
-
"description": "The payload the agent submitted, or null until
|
|
4947
|
+
"description": "The payload the agent submitted, or null until it submits one.",
|
|
4591
4948
|
"title": "Result"
|
|
4592
4949
|
}
|
|
4593
4950
|
},
|
|
@@ -4673,6 +5030,21 @@
|
|
|
4673
5030
|
"title": "SessionPrompting",
|
|
4674
5031
|
"type": "object"
|
|
4675
5032
|
},
|
|
5033
|
+
"SessionReview": {
|
|
5034
|
+
"description": "The code review a reviewer session ran for.",
|
|
5035
|
+
"properties": {
|
|
5036
|
+
"id": {
|
|
5037
|
+
"description": "Identifier of the code review.",
|
|
5038
|
+
"title": "Id",
|
|
5039
|
+
"type": "string"
|
|
5040
|
+
}
|
|
5041
|
+
},
|
|
5042
|
+
"required": [
|
|
5043
|
+
"id"
|
|
5044
|
+
],
|
|
5045
|
+
"title": "SessionReview",
|
|
5046
|
+
"type": "object"
|
|
5047
|
+
},
|
|
4676
5048
|
"SessionSource": {
|
|
4677
5049
|
"description": "Where a session came from: the credential that started it (web app,\nAPI key, CLI) or the trigger that fired (react, mention, cron, code\nreview). Never taken from a request body.",
|
|
4678
5050
|
"enum": [
|
|
@@ -4687,44 +5059,18 @@
|
|
|
4687
5059
|
"title": "SessionSource",
|
|
4688
5060
|
"type": "string"
|
|
4689
5061
|
},
|
|
4690
|
-
"
|
|
4691
|
-
"description": "
|
|
5062
|
+
"SessionStatus": {
|
|
5063
|
+
"description": "Where the session is. `queued` while a message waits for a worker,\n`preparing` while its environment is set up, `running` while the agent\nworks, `idle` when every message has been answered and the session can\ntake another, and `closed` when it can take no more. `closed` is\npermanent.",
|
|
4692
5064
|
"enum": [
|
|
4693
|
-
"
|
|
5065
|
+
"queued",
|
|
5066
|
+
"preparing",
|
|
5067
|
+
"running",
|
|
5068
|
+
"idle",
|
|
4694
5069
|
"closed"
|
|
4695
5070
|
],
|
|
4696
|
-
"title": "
|
|
5071
|
+
"title": "SessionStatus",
|
|
4697
5072
|
"type": "string"
|
|
4698
5073
|
},
|
|
4699
|
-
"SessionStopped": {
|
|
4700
|
-
"description": "When a stop was requested and the GitHub user who requested it.",
|
|
4701
|
-
"properties": {
|
|
4702
|
-
"at": {
|
|
4703
|
-
"description": "When a stop was requested.",
|
|
4704
|
-
"format": "date-time",
|
|
4705
|
-
"title": "At",
|
|
4706
|
-
"type": "string"
|
|
4707
|
-
},
|
|
4708
|
-
"by": {
|
|
4709
|
-
"anyOf": [
|
|
4710
|
-
{
|
|
4711
|
-
"$ref": "#/$defs/GithubAccountSnippet"
|
|
4712
|
-
},
|
|
4713
|
-
{
|
|
4714
|
-
"type": "null"
|
|
4715
|
-
}
|
|
4716
|
-
],
|
|
4717
|
-
"default": null,
|
|
4718
|
-
"description": "The GitHub user who stopped the session, resolved at read time. Null if the user is unknown or unavailable."
|
|
4719
|
-
}
|
|
4720
|
-
},
|
|
4721
|
-
"required": [
|
|
4722
|
-
"at",
|
|
4723
|
-
"by"
|
|
4724
|
-
],
|
|
4725
|
-
"title": "SessionStopped",
|
|
4726
|
-
"type": "object"
|
|
4727
|
-
},
|
|
4728
5074
|
"SessionSummary": {
|
|
4729
5075
|
"description": "A live one-line summary of what the session is doing, refreshed\nevery few steps while it runs.",
|
|
4730
5076
|
"properties": {
|
|
@@ -4746,127 +5092,29 @@
|
|
|
4746
5092
|
"description": "One-line description of what the session is doing.",
|
|
4747
5093
|
"title": "Description",
|
|
4748
5094
|
"type": "string"
|
|
5095
|
+
},
|
|
5096
|
+
"source": {
|
|
5097
|
+
"$ref": "#/$defs/SessionSummarySource",
|
|
5098
|
+
"description": "Where this summary came from. `prompt` is the first line of the prompt the session started with, `generated` is written by Ellipsis as the session runs, and `user` was set by a person and is never replaced by a generated one."
|
|
4749
5099
|
}
|
|
4750
5100
|
},
|
|
4751
5101
|
"required": [
|
|
4752
5102
|
"created_at",
|
|
4753
|
-
"description"
|
|
5103
|
+
"description",
|
|
5104
|
+
"source"
|
|
4754
5105
|
],
|
|
4755
5106
|
"title": "SessionSummary",
|
|
4756
5107
|
"type": "object"
|
|
4757
5108
|
},
|
|
4758
|
-
"
|
|
4759
|
-
"description": "
|
|
4760
|
-
"
|
|
4761
|
-
"
|
|
4762
|
-
|
|
4763
|
-
|
|
4764
|
-
},
|
|
4765
|
-
"created_at": {
|
|
4766
|
-
"description": "When the turn's message was received.",
|
|
4767
|
-
"format": "date-time",
|
|
4768
|
-
"title": "Created At",
|
|
4769
|
-
"type": "string"
|
|
4770
|
-
},
|
|
4771
|
-
"detail": {
|
|
4772
|
-
"anyOf": [
|
|
4773
|
-
{
|
|
4774
|
-
"type": "string"
|
|
4775
|
-
},
|
|
4776
|
-
{
|
|
4777
|
-
"type": "null"
|
|
4778
|
-
}
|
|
4779
|
-
],
|
|
4780
|
-
"default": null,
|
|
4781
|
-
"description": "A human-readable explanation of a failed, stopped, or cancelled turn, or of why a queued turn waits.",
|
|
4782
|
-
"title": "Detail"
|
|
4783
|
-
},
|
|
4784
|
-
"ended_at": {
|
|
4785
|
-
"anyOf": [
|
|
4786
|
-
{
|
|
4787
|
-
"format": "date-time",
|
|
4788
|
-
"type": "string"
|
|
4789
|
-
},
|
|
4790
|
-
{
|
|
4791
|
-
"type": "null"
|
|
4792
|
-
}
|
|
4793
|
-
],
|
|
4794
|
-
"default": null,
|
|
4795
|
-
"description": "When the turn reached its final status.",
|
|
4796
|
-
"title": "Ended At"
|
|
4797
|
-
},
|
|
4798
|
-
"id": {
|
|
4799
|
-
"description": "Unique identifier of the turn.",
|
|
4800
|
-
"title": "Id",
|
|
4801
|
-
"type": "string"
|
|
4802
|
-
},
|
|
4803
|
-
"index": {
|
|
4804
|
-
"description": "Position in the session, starting at 0.",
|
|
4805
|
-
"title": "Index",
|
|
4806
|
-
"type": "integer"
|
|
4807
|
-
},
|
|
4808
|
-
"reason": {
|
|
4809
|
-
"anyOf": [
|
|
4810
|
-
{
|
|
4811
|
-
"$ref": "#/$defs/TurnReason"
|
|
4812
|
-
},
|
|
4813
|
-
{
|
|
4814
|
-
"type": "null"
|
|
4815
|
-
}
|
|
4816
|
-
],
|
|
4817
|
-
"default": null,
|
|
4818
|
-
"description": "Why the turn failed or was cancelled; null on every other status."
|
|
4819
|
-
},
|
|
4820
|
-
"started_at": {
|
|
4821
|
-
"anyOf": [
|
|
4822
|
-
{
|
|
4823
|
-
"format": "date-time",
|
|
4824
|
-
"type": "string"
|
|
4825
|
-
},
|
|
4826
|
-
{
|
|
4827
|
-
"type": "null"
|
|
4828
|
-
}
|
|
4829
|
-
],
|
|
4830
|
-
"default": null,
|
|
4831
|
-
"description": "When the agent started on the message.",
|
|
4832
|
-
"title": "Started At"
|
|
4833
|
-
},
|
|
4834
|
-
"status": {
|
|
4835
|
-
"$ref": "#/$defs/TurnStatus",
|
|
4836
|
-
"description": "Where the turn is."
|
|
4837
|
-
},
|
|
4838
|
-
"stopped": {
|
|
4839
|
-
"anyOf": [
|
|
4840
|
-
{
|
|
4841
|
-
"$ref": "#/$defs/SessionStopped"
|
|
4842
|
-
},
|
|
4843
|
-
{
|
|
4844
|
-
"type": "null"
|
|
4845
|
-
}
|
|
4846
|
-
],
|
|
4847
|
-
"default": null,
|
|
4848
|
-
"description": "When and by whom a stop was requested; null when none was."
|
|
4849
|
-
},
|
|
4850
|
-
"tokens": {
|
|
4851
|
-
"$ref": "#/$defs/Tokens",
|
|
4852
|
-
"description": "The tokens the turn spent and the model they went to."
|
|
4853
|
-
}
|
|
4854
|
-
},
|
|
4855
|
-
"required": [
|
|
4856
|
-
"cost",
|
|
4857
|
-
"created_at",
|
|
4858
|
-
"detail",
|
|
4859
|
-
"ended_at",
|
|
4860
|
-
"id",
|
|
4861
|
-
"index",
|
|
4862
|
-
"reason",
|
|
4863
|
-
"started_at",
|
|
4864
|
-
"status",
|
|
4865
|
-
"stopped",
|
|
4866
|
-
"tokens"
|
|
5109
|
+
"SessionSummarySource": {
|
|
5110
|
+
"description": "Where a session's summary came from.",
|
|
5111
|
+
"enum": [
|
|
5112
|
+
"prompt",
|
|
5113
|
+
"generated",
|
|
5114
|
+
"user"
|
|
4867
5115
|
],
|
|
4868
|
-
"title": "
|
|
4869
|
-
"type": "
|
|
5116
|
+
"title": "SessionSummarySource",
|
|
5117
|
+
"type": "string"
|
|
4870
5118
|
},
|
|
4871
5119
|
"SettingsRef": {
|
|
4872
5120
|
"additionalProperties": false,
|
|
@@ -5127,43 +5375,6 @@
|
|
|
5127
5375
|
"title": "Tokens",
|
|
5128
5376
|
"type": "object"
|
|
5129
5377
|
},
|
|
5130
|
-
"TurnReason": {
|
|
5131
|
-
"description": "Why a turn failed or was cancelled. Null on every other outcome.",
|
|
5132
|
-
"enum": [
|
|
5133
|
-
"error",
|
|
5134
|
-
"tool_call_failed",
|
|
5135
|
-
"budget_hit",
|
|
5136
|
-
"payment_required",
|
|
5137
|
-
"blocked",
|
|
5138
|
-
"contact_email_required",
|
|
5139
|
-
"lifecycle_hook_failed",
|
|
5140
|
-
"missing_repo_access",
|
|
5141
|
-
"missing_token_permissions",
|
|
5142
|
-
"missing_environment_variables",
|
|
5143
|
-
"missing_github_integration",
|
|
5144
|
-
"agent_unavailable",
|
|
5145
|
-
"upstream_unavailable",
|
|
5146
|
-
"unsupported_configuration",
|
|
5147
|
-
"execution_disabled",
|
|
5148
|
-
"interrupted"
|
|
5149
|
-
],
|
|
5150
|
-
"title": "TurnReason",
|
|
5151
|
-
"type": "string"
|
|
5152
|
-
},
|
|
5153
|
-
"TurnStatus": {
|
|
5154
|
-
"description": "Where one turn is: waiting, preparing, being answered, or over.\n\n`queued` turns wait to start, behind another turn or for a free session\nslot on the account. `preparing` turns wait while the environment is set\nup. `stopped` and `cancelled` are their own outcomes; `reason` explains a\n`failed` or `cancelled` turn.",
|
|
5155
|
-
"enum": [
|
|
5156
|
-
"queued",
|
|
5157
|
-
"preparing",
|
|
5158
|
-
"running",
|
|
5159
|
-
"completed",
|
|
5160
|
-
"failed",
|
|
5161
|
-
"stopped",
|
|
5162
|
-
"cancelled"
|
|
5163
|
-
],
|
|
5164
|
-
"title": "TurnStatus",
|
|
5165
|
-
"type": "string"
|
|
5166
|
-
},
|
|
5167
5378
|
"VMExecutionResponse": {
|
|
5168
5379
|
"properties": {
|
|
5169
5380
|
"cache_tier": {
|