@compozy/client 0.4.5 → 0.4.7

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.
@@ -2845,24 +2845,24 @@ export class openai extends HeyApiClient {
2845
2845
  });
2846
2846
  }
2847
2847
  }
2848
- export class profiles extends HeyApiClient {
2848
+ export class sessions extends HeyApiClient {
2849
2849
  /**
2850
- * List profiles
2850
+ * List processes grouped by session, including left-running processes
2851
2851
  */
2852
- listProfiles(options) {
2852
+ listProcesses(options) {
2853
2853
  return (options?.client ?? this.client).get({
2854
2854
  responseStyle: "data",
2855
- url: "/api/profiles",
2855
+ url: "/api/processes",
2856
2856
  ...options,
2857
2857
  });
2858
2858
  }
2859
2859
  /**
2860
- * Create a profile
2860
+ * Terminate identity-verified processes with missing or retained session owners
2861
2861
  */
2862
- createProfile(options) {
2862
+ terminateProcesses(options) {
2863
2863
  return (options.client ?? this.client).post({
2864
2864
  responseStyle: "data",
2865
- url: "/api/profiles",
2865
+ url: "/api/processes/terminate",
2866
2866
  ...options,
2867
2867
  headers: {
2868
2868
  "Content-Type": "application/json",
@@ -2871,184 +2871,180 @@ export class profiles extends HeyApiClient {
2871
2871
  });
2872
2872
  }
2873
2873
  /**
2874
- * List profile lifecycle operations
2874
+ * List sessions
2875
2875
  */
2876
- listProfileOperations(options) {
2876
+ listSessions(options) {
2877
2877
  return (options?.client ?? this.client).get({
2878
2878
  responseStyle: "data",
2879
- url: "/api/profiles/ops",
2879
+ url: "/api/sessions",
2880
2880
  ...options,
2881
2881
  });
2882
2882
  }
2883
2883
  /**
2884
- * Retry a profile lifecycle operation
2884
+ * Create a session
2885
2885
  */
2886
- retryProfileOperation(options) {
2886
+ createSession(options) {
2887
2887
  return (options.client ?? this.client).post({
2888
2888
  responseStyle: "data",
2889
- url: "/api/profiles/ops/{op_id}/retry",
2889
+ url: "/api/sessions",
2890
2890
  ...options,
2891
+ headers: {
2892
+ "Content-Type": "application/json",
2893
+ ...options.headers,
2894
+ },
2891
2895
  });
2892
2896
  }
2893
2897
  /**
2894
- * Read profile selections
2898
+ * Get exact session attention counts
2895
2899
  */
2896
- getProfileSelections(options) {
2900
+ getSessionAttentionSummary(options) {
2897
2901
  return (options?.client ?? this.client).get({
2898
2902
  responseStyle: "data",
2899
- url: "/api/profiles/selection",
2903
+ url: "/api/sessions/attention-summary",
2900
2904
  ...options,
2901
2905
  });
2902
2906
  }
2903
2907
  /**
2904
- * Remember a profile selection
2908
+ * Count session catalog facets
2905
2909
  */
2906
- putProfileSelection(options) {
2907
- return (options.client ?? this.client).put({
2910
+ listSessionFacets(options) {
2911
+ return (options?.client ?? this.client).get({
2908
2912
  responseStyle: "data",
2909
- url: "/api/profiles/selection",
2913
+ url: "/api/sessions/facets",
2910
2914
  ...options,
2911
- headers: {
2912
- "Content-Type": "application/json",
2913
- ...options.headers,
2914
- },
2915
2915
  });
2916
2916
  }
2917
2917
  /**
2918
- * Delete a profile
2918
+ * Get one session snapshot by id
2919
2919
  */
2920
- deleteProfile(options) {
2921
- return (options.client ?? this.client).delete({
2920
+ getSessionByID(options) {
2921
+ return (options.client ?? this.client).get({
2922
2922
  responseStyle: "data",
2923
- url: "/api/profiles/{name}",
2923
+ url: "/api/sessions/{session_id}",
2924
2924
  ...options,
2925
2925
  });
2926
2926
  }
2927
2927
  /**
2928
- * Get a profile
2928
+ * List persisted session events for a Global session
2929
2929
  */
2930
- getProfile(options) {
2930
+ listGlobalSessionEvents(options) {
2931
2931
  return (options.client ?? this.client).get({
2932
2932
  responseStyle: "data",
2933
- url: "/api/profiles/{name}",
2933
+ url: "/api/sessions/{session_id}/events",
2934
2934
  ...options,
2935
2935
  });
2936
2936
  }
2937
2937
  /**
2938
- * Update profile identity
2938
+ * List grouped session turn history for a Global session
2939
2939
  */
2940
- updateProfile(options) {
2941
- return (options.client ?? this.client).patch({
2940
+ getGlobalSessionHistory(options) {
2941
+ return (options.client ?? this.client).get({
2942
2942
  responseStyle: "data",
2943
- url: "/api/profiles/{name}",
2943
+ url: "/api/sessions/{session_id}/history",
2944
2944
  ...options,
2945
- headers: {
2946
- "Content-Type": "application/json",
2947
- ...options.headers,
2948
- },
2949
2945
  });
2950
2946
  }
2951
2947
  /**
2952
- * Archive a profile
2948
+ * Get a session owner; Global history has an empty workspace id
2953
2949
  */
2954
- archiveProfile(options) {
2950
+ getSessionOwner(options) {
2951
+ return (options.client ?? this.client).get({
2952
+ responseStyle: "data",
2953
+ url: "/api/sessions/{session_id}/owner",
2954
+ ...options,
2955
+ });
2956
+ }
2957
+ /**
2958
+ * Refresh a session pull request
2959
+ */
2960
+ refreshSessionPullRequest(options) {
2955
2961
  return (options.client ?? this.client).post({
2956
2962
  responseStyle: "data",
2957
- url: "/api/profiles/{name}/archive",
2963
+ url: "/api/sessions/{session_id}/pull-request/refresh",
2958
2964
  ...options,
2959
- headers: {
2960
- "Content-Type": "application/json",
2961
- ...options.headers,
2962
- },
2963
2965
  });
2964
2966
  }
2965
2967
  /**
2966
- * Preview profile archival
2968
+ * Read compact session status and wake eligibility for a Global session
2967
2969
  */
2968
- prepareProfileArchive(options) {
2970
+ getGlobalSessionStatus(options) {
2969
2971
  return (options.client ?? this.client).get({
2970
2972
  responseStyle: "data",
2971
- url: "/api/profiles/{name}/archive-plan",
2973
+ url: "/api/sessions/{session_id}/status",
2972
2974
  ...options,
2973
2975
  });
2974
2976
  }
2975
2977
  /**
2976
- * Preview profile deletion
2978
+ * Get a bounded materialized transcript page for a Global session
2977
2979
  */
2978
- prepareProfileDelete(options) {
2980
+ getGlobalSessionTranscript(options) {
2979
2981
  return (options.client ?? this.client).get({
2980
2982
  responseStyle: "data",
2981
- url: "/api/profiles/{name}/delete-plan",
2983
+ url: "/api/sessions/{session_id}/transcript",
2982
2984
  ...options,
2983
2985
  });
2984
2986
  }
2985
2987
  /**
2986
- * Rename a profile
2988
+ * Get the full retained operator-message trail with reply previews for a Global session
2987
2989
  */
2988
- renameProfile(options) {
2989
- return (options.client ?? this.client).post({
2990
+ getGlobalSessionTranscriptOutline(options) {
2991
+ return (options.client ?? this.client).get({
2990
2992
  responseStyle: "data",
2991
- url: "/api/profiles/{name}/rename",
2993
+ url: "/api/sessions/{session_id}/transcript/outline",
2992
2994
  ...options,
2993
- headers: {
2994
- "Content-Type": "application/json",
2995
- ...options.headers,
2996
- },
2997
2995
  });
2998
2996
  }
2999
2997
  /**
3000
- * Preview a profile rename
2998
+ * Search retained transcript messages with bounded literal matches for a Global session
3001
2999
  */
3002
- prepareProfileRename(options) {
3000
+ searchGlobalSessionTranscript(options) {
3003
3001
  return (options.client ?? this.client).get({
3004
3002
  responseStyle: "data",
3005
- url: "/api/profiles/{name}/rename-plan",
3003
+ url: "/api/sessions/{session_id}/transcript/search",
3006
3004
  ...options,
3007
3005
  });
3008
3006
  }
3009
3007
  /**
3010
- * Unarchive a profile
3008
+ * List session folders in manual order
3011
3009
  */
3012
- unarchiveProfile(options) {
3013
- return (options.client ?? this.client).post({
3010
+ listSessionFolders(options) {
3011
+ return (options.client ?? this.client).get({
3014
3012
  responseStyle: "data",
3015
- url: "/api/profiles/{name}/unarchive",
3013
+ url: "/api/workspaces/{workspace_id}/session-folders",
3016
3014
  ...options,
3017
- headers: {
3018
- "Content-Type": "application/json",
3019
- ...options.headers,
3020
- },
3021
3015
  });
3022
3016
  }
3023
- }
3024
- export class resources extends HeyApiClient {
3025
3017
  /**
3026
- * List desired-state resources on the local operator control plane
3018
+ * Create a session folder
3027
3019
  */
3028
- listResources(options) {
3029
- return (options?.client ?? this.client).get({
3020
+ createSessionFolder(options) {
3021
+ return (options.client ?? this.client).post({
3030
3022
  responseStyle: "data",
3031
- url: "/api/resources",
3023
+ url: "/api/workspaces/{workspace_id}/session-folders",
3032
3024
  ...options,
3025
+ headers: {
3026
+ "Content-Type": "application/json",
3027
+ ...options.headers,
3028
+ },
3033
3029
  });
3034
3030
  }
3035
3031
  /**
3036
- * List one desired-state resource kind on the local operator control plane
3032
+ * Delete a session folder; its sessions return to the workspace root
3037
3033
  */
3038
- listResourcesByKind(options) {
3039
- return (options.client ?? this.client).get({
3034
+ deleteSessionFolder(options) {
3035
+ return (options.client ?? this.client).delete({
3040
3036
  responseStyle: "data",
3041
- url: "/api/resources/{kind}",
3037
+ url: "/api/workspaces/{workspace_id}/session-folders/{folder_id}",
3042
3038
  ...options,
3043
3039
  });
3044
3040
  }
3045
3041
  /**
3046
- * Delete one desired-state resource on the local operator control plane
3042
+ * Rename a session folder
3047
3043
  */
3048
- deleteResource(options) {
3049
- return (options.client ?? this.client).delete({
3044
+ renameSessionFolder(options) {
3045
+ return (options.client ?? this.client).patch({
3050
3046
  responseStyle: "data",
3051
- url: "/api/resources/{kind}/{id}",
3047
+ url: "/api/workspaces/{workspace_id}/session-folders/{folder_id}",
3052
3048
  ...options,
3053
3049
  headers: {
3054
3050
  "Content-Type": "application/json",
@@ -3057,22 +3053,26 @@ export class resources extends HeyApiClient {
3057
3053
  });
3058
3054
  }
3059
3055
  /**
3060
- * Read one desired-state resource on the local operator control plane
3056
+ * Set the complete session folder order
3061
3057
  */
3062
- getResource(options) {
3063
- return (options.client ?? this.client).get({
3058
+ reorderSessionFolders(options) {
3059
+ return (options.client ?? this.client).put({
3064
3060
  responseStyle: "data",
3065
- url: "/api/resources/{kind}/{id}",
3061
+ url: "/api/workspaces/{workspace_id}/session-order/folders",
3066
3062
  ...options,
3063
+ headers: {
3064
+ "Content-Type": "application/json",
3065
+ ...options.headers,
3066
+ },
3067
3067
  });
3068
3068
  }
3069
3069
  /**
3070
- * Create or replace one desired-state resource on the local operator control plane
3070
+ * Set the manual session order in a folder or the workspace root
3071
3071
  */
3072
- putResource(options) {
3072
+ reorderSessions(options) {
3073
3073
  return (options.client ?? this.client).put({
3074
3074
  responseStyle: "data",
3075
- url: "/api/resources/{kind}/{id}",
3075
+ url: "/api/workspaces/{workspace_id}/session-order/sessions",
3076
3076
  ...options,
3077
3077
  headers: {
3078
3078
  "Content-Type": "application/json",
@@ -3080,51 +3080,43 @@ export class resources extends HeyApiClient {
3080
3080
  },
3081
3081
  });
3082
3082
  }
3083
- }
3084
- export class roles extends HeyApiClient {
3085
3083
  /**
3086
- * List effective background role configuration
3084
+ * List sessions
3087
3085
  */
3088
- listRoles(options) {
3089
- return (options?.client ?? this.client).get({
3086
+ listWorkspaceSessions(options) {
3087
+ return (options.client ?? this.client).get({
3090
3088
  responseStyle: "data",
3091
- url: "/api/roles",
3089
+ url: "/api/workspaces/{workspace_id}/sessions",
3092
3090
  ...options,
3093
3091
  });
3094
3092
  }
3095
3093
  /**
3096
- * Get effective background role configuration
3094
+ * Delete one session and remove it from persisted history
3097
3095
  */
3098
- getRole(options) {
3099
- return (options.client ?? this.client).get({
3096
+ deleteSession(options) {
3097
+ return (options.client ?? this.client).delete({
3100
3098
  responseStyle: "data",
3101
- url: "/api/roles/{role}",
3099
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}",
3102
3100
  ...options,
3103
3101
  });
3104
3102
  }
3105
- }
3106
- export class tasks extends HeyApiClient {
3107
3103
  /**
3108
- * Force fail a bounded set of queued or claimed task runs
3104
+ * Get one session snapshot
3109
3105
  */
3110
- bulkForceFailTaskRuns(options) {
3111
- return (options.client ?? this.client).post({
3106
+ getSession(options) {
3107
+ return (options.client ?? this.client).get({
3112
3108
  responseStyle: "data",
3113
- url: "/api/runs/bulk/fail",
3109
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}",
3114
3110
  ...options,
3115
- headers: {
3116
- "Content-Type": "application/json",
3117
- ...options.headers,
3118
- },
3119
3111
  });
3120
3112
  }
3121
3113
  /**
3122
- * Force release a bounded set of claimed task runs
3114
+ * Rename one user session
3123
3115
  */
3124
- bulkForceReleaseTaskRuns(options) {
3125
- return (options.client ?? this.client).post({
3116
+ renameSession(options) {
3117
+ return (options.client ?? this.client).patch({
3126
3118
  responseStyle: "data",
3127
- url: "/api/runs/bulk/release",
3119
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}",
3128
3120
  ...options,
3129
3121
  headers: {
3130
3122
  "Content-Type": "application/json",
@@ -3133,12 +3125,12 @@ export class tasks extends HeyApiClient {
3133
3125
  });
3134
3126
  }
3135
3127
  /**
3136
- * Force fail one queued or claimed task run
3128
+ * Approve or deny an interactive permission request
3137
3129
  */
3138
- forceFailTaskRun(options) {
3130
+ approveSession(options) {
3139
3131
  return (options.client ?? this.client).post({
3140
3132
  responseStyle: "data",
3141
- url: "/api/runs/{id}/fail",
3133
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/approve",
3142
3134
  ...options,
3143
3135
  headers: {
3144
3136
  "Content-Type": "application/json",
@@ -3147,22 +3139,22 @@ export class tasks extends HeyApiClient {
3147
3139
  });
3148
3140
  }
3149
3141
  /**
3150
- * Inspect one task run with diagnostics
3142
+ * Archive a stopped session, or stop and archive a live session with stop=true
3151
3143
  */
3152
- inspectRun(options) {
3153
- return (options.client ?? this.client).get({
3144
+ archiveSession(options) {
3145
+ return (options.client ?? this.client).post({
3154
3146
  responseStyle: "data",
3155
- url: "/api/runs/{id}/inspect",
3147
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/archive",
3156
3148
  ...options,
3157
3149
  });
3158
3150
  }
3159
3151
  /**
3160
- * Recover one needs_attention task run
3152
+ * Attach to a resumable live session
3161
3153
  */
3162
- recoverTaskRun(options) {
3154
+ attachSession(options) {
3163
3155
  return (options.client ?? this.client).post({
3164
3156
  responseStyle: "data",
3165
- url: "/api/runs/{id}/recover",
3157
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/attach",
3166
3158
  ...options,
3167
3159
  headers: {
3168
3160
  "Content-Type": "application/json",
@@ -3171,112 +3163,107 @@ export class tasks extends HeyApiClient {
3171
3163
  });
3172
3164
  }
3173
3165
  /**
3174
- * Force release one claimed task run
3166
+ * Upload a session attachment
3175
3167
  */
3176
- forceReleaseTaskRun(options) {
3168
+ uploadSessionAttachment(options) {
3177
3169
  return (options.client ?? this.client).post({
3170
+ ...formDataBodySerializer,
3178
3171
  responseStyle: "data",
3179
- url: "/api/runs/{id}/release",
3172
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/attachments",
3180
3173
  ...options,
3181
3174
  headers: {
3182
- "Content-Type": "application/json",
3175
+ "Content-Type": null,
3183
3176
  ...options.headers,
3184
3177
  },
3185
3178
  });
3186
3179
  }
3187
3180
  /**
3188
- * Retry one failed task run
3181
+ * Delete a session attachment
3189
3182
  */
3190
- retryTaskRun(options) {
3191
- return (options.client ?? this.client).post({
3183
+ deleteSessionAttachment(options) {
3184
+ return (options.client ?? this.client).delete({
3192
3185
  responseStyle: "data",
3193
- url: "/api/runs/{id}/retry",
3186
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/attachments/{attachment_id}",
3194
3187
  ...options,
3195
- headers: {
3196
- "Content-Type": "application/json",
3197
- ...options.headers,
3198
- },
3199
3188
  });
3200
3189
  }
3201
3190
  /**
3202
- * Get scheduler pause state and queue pressure
3191
+ * Read session attachment bytes
3203
3192
  */
3204
- getScheduler(options) {
3205
- return (options?.client ?? this.client).get({
3193
+ readSessionAttachmentBytes(options) {
3194
+ return (options.client ?? this.client).get({
3206
3195
  responseStyle: "data",
3207
- url: "/api/scheduler",
3196
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/attachments/{attachment_id}/bytes",
3208
3197
  ...options,
3209
3198
  });
3210
3199
  }
3211
3200
  /**
3212
- * List queued scheduler backlog rows
3201
+ * List the live pending clarification for a session
3213
3202
  */
3214
- getSchedulerBacklog(options) {
3215
- return (options?.client ?? this.client).get({
3203
+ listSessionClarifications(options) {
3204
+ return (options.client ?? this.client).get({
3216
3205
  responseStyle: "data",
3217
- url: "/api/scheduler/backlog",
3206
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/clarifications",
3218
3207
  ...options,
3219
3208
  });
3220
3209
  }
3221
3210
  /**
3222
- * Pause the scheduler and wait for active claims to drain
3211
+ * Answer a live session clarification
3223
3212
  */
3224
- drainScheduler(options) {
3225
- return (options?.client ?? this.client).post({
3213
+ answerSessionClarification(options) {
3214
+ return (options.client ?? this.client).post({
3226
3215
  responseStyle: "data",
3227
- url: "/api/scheduler/drain",
3216
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/clarifications/{request_id}/answer",
3228
3217
  ...options,
3229
3218
  headers: {
3230
3219
  "Content-Type": "application/json",
3231
- ...options?.headers,
3220
+ ...options.headers,
3232
3221
  },
3233
3222
  });
3234
3223
  }
3235
3224
  /**
3236
- * Pause scheduler dispatch and task-run claims
3225
+ * Clear conversation history and restart the session context
3237
3226
  */
3238
- pauseScheduler(options) {
3239
- return (options?.client ?? this.client).post({
3227
+ clearSessionConversation(options) {
3228
+ return (options.client ?? this.client).post({
3240
3229
  responseStyle: "data",
3241
- url: "/api/scheduler/pause",
3230
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/clear",
3242
3231
  ...options,
3243
- headers: {
3244
- "Content-Type": "application/json",
3245
- ...options?.headers,
3246
- },
3247
3232
  });
3248
3233
  }
3249
3234
  /**
3250
- * Resume scheduler dispatch and task-run claims
3235
+ * List commands available to a session
3251
3236
  */
3252
- resumeScheduler(options) {
3253
- return (options?.client ?? this.client).post({
3237
+ getSessionCommands(options) {
3238
+ return (options.client ?? this.client).get({
3254
3239
  responseStyle: "data",
3255
- url: "/api/scheduler/resume",
3240
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/commands",
3256
3241
  ...options,
3257
- headers: {
3258
- "Content-Type": "application/json",
3259
- ...options?.headers,
3260
- },
3261
3242
  });
3262
3243
  }
3263
3244
  /**
3264
- * Get one task-run review
3245
+ * Request advertised native agent compaction (experimental)
3246
+ *
3247
+ * @stability experimental
3265
3248
  */
3266
- getTaskRunReview(options) {
3267
- return (options.client ?? this.client).get({
3249
+ compactSession(options) {
3250
+ return (options.client ?? this.client).post({
3268
3251
  responseStyle: "data",
3269
- url: "/api/task-reviews/{id}",
3252
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/compact",
3270
3253
  ...options,
3254
+ headers: {
3255
+ "Content-Type": "application/json",
3256
+ ...options.headers,
3257
+ },
3271
3258
  });
3272
3259
  }
3273
3260
  /**
3274
- * Submit one task-run review verdict
3261
+ * Continue a session with another agent, runtime, or declared route
3275
3262
  */
3276
- submitTaskRunReviewVerdict(options) {
3263
+ continueSession(options) {
3277
3264
  return (options.client ?? this.client).post({
3278
3265
  responseStyle: "data",
3279
- url: "/api/task-reviews/{id}/verdict",
3266
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/continue",
3280
3267
  ...options,
3281
3268
  headers: {
3282
3269
  "Content-Type": "application/json",
@@ -3285,50 +3272,42 @@ export class tasks extends HeyApiClient {
3285
3272
  });
3286
3273
  }
3287
3274
  /**
3288
- * Get one task run detail
3275
+ * Preview what a continue or fork of a session would carry
3289
3276
  */
3290
- getTaskRun(options) {
3277
+ previewSessionDerive(options) {
3291
3278
  return (options.client ?? this.client).get({
3292
3279
  responseStyle: "data",
3293
- url: "/api/task-runs/{id}",
3280
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/derive/preview",
3294
3281
  ...options,
3295
3282
  });
3296
3283
  }
3297
3284
  /**
3298
- * Attach an existing session to one task run
3285
+ * List persisted session events
3299
3286
  */
3300
- attachTaskRunSession(options) {
3301
- return (options.client ?? this.client).post({
3287
+ listSessionEvents(options) {
3288
+ return (options.client ?? this.client).get({
3302
3289
  responseStyle: "data",
3303
- url: "/api/task-runs/{id}/attach-session",
3290
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/events",
3304
3291
  ...options,
3305
- headers: {
3306
- "Content-Type": "application/json",
3307
- ...options.headers,
3308
- },
3309
3292
  });
3310
3293
  }
3311
3294
  /**
3312
- * Cancel one task run
3295
+ * Search files and folders under a session's working directory
3313
3296
  */
3314
- cancelTaskRun(options) {
3315
- return (options.client ?? this.client).post({
3297
+ searchSessionFiles(options) {
3298
+ return (options.client ?? this.client).get({
3316
3299
  responseStyle: "data",
3317
- url: "/api/task-runs/{id}/cancel",
3300
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/files",
3318
3301
  ...options,
3319
- headers: {
3320
- "Content-Type": "application/json",
3321
- ...options.headers,
3322
- },
3323
3302
  });
3324
3303
  }
3325
3304
  /**
3326
- * Complete one running task run
3305
+ * Fork a session with the same agent, whole or through one user message and its turn
3327
3306
  */
3328
- completeTaskRun(options) {
3307
+ forkSession(options) {
3329
3308
  return (options.client ?? this.client).post({
3330
3309
  responseStyle: "data",
3331
- url: "/api/task-runs/{id}/complete",
3310
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/fork",
3332
3311
  ...options,
3333
3312
  headers: {
3334
3313
  "Content-Type": "application/json",
@@ -3337,60 +3316,52 @@ export class tasks extends HeyApiClient {
3337
3316
  });
3338
3317
  }
3339
3318
  /**
3340
- * Fail one task run
3319
+ * Read metadata-only session health and wake eligibility
3341
3320
  */
3342
- failTaskRun(options) {
3343
- return (options.client ?? this.client).post({
3321
+ getSessionHealth(options) {
3322
+ return (options.client ?? this.client).get({
3344
3323
  responseStyle: "data",
3345
- url: "/api/task-runs/{id}/fail",
3324
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/health",
3346
3325
  ...options,
3347
- headers: {
3348
- "Content-Type": "application/json",
3349
- ...options.headers,
3350
- },
3351
3326
  });
3352
3327
  }
3353
3328
  /**
3354
- * Read one exact byte page from a task-run result
3329
+ * List grouped session turn history
3355
3330
  */
3356
- readTaskRunResult(options) {
3331
+ getSessionHistory(options) {
3357
3332
  return (options.client ?? this.client).get({
3358
3333
  responseStyle: "data",
3359
- url: "/api/task-runs/{id}/result",
3334
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/history",
3360
3335
  ...options,
3361
3336
  });
3362
3337
  }
3363
3338
  /**
3364
- * List reviews for one task run
3339
+ * Inspect session health, wake audit, and policy correlation metadata
3365
3340
  */
3366
- listTaskRunReviews(options) {
3341
+ inspectSession(options) {
3367
3342
  return (options.client ?? this.client).get({
3368
3343
  responseStyle: "data",
3369
- url: "/api/task-runs/{id}/reviews",
3344
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/inspect",
3370
3345
  ...options,
3371
3346
  });
3372
3347
  }
3373
3348
  /**
3374
- * Request review for one terminal task run
3349
+ * List pending session interactions
3375
3350
  */
3376
- requestTaskRunReview(options) {
3377
- return (options.client ?? this.client).post({
3351
+ listSessionInteractions(options) {
3352
+ return (options.client ?? this.client).get({
3378
3353
  responseStyle: "data",
3379
- url: "/api/task-runs/{id}/reviews",
3354
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/interactions",
3380
3355
  ...options,
3381
- headers: {
3382
- "Content-Type": "application/json",
3383
- ...options.headers,
3384
- },
3385
3356
  });
3386
3357
  }
3387
3358
  /**
3388
- * Start one claimed task run
3359
+ * Stop a session and its children and park them in Later, with an optional reason and return time
3389
3360
  */
3390
- startTaskRun(options) {
3361
+ moveSessionToLater(options) {
3391
3362
  return (options.client ?? this.client).post({
3392
3363
  responseStyle: "data",
3393
- url: "/api/task-runs/{id}/start",
3364
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/later",
3394
3365
  ...options,
3395
3366
  headers: {
3396
3367
  "Content-Type": "application/json",
@@ -3399,56 +3370,56 @@ export class tasks extends HeyApiClient {
3399
3370
  });
3400
3371
  }
3401
3372
  /**
3402
- * List a bounded task catalog page
3373
+ * List a session's monitors
3403
3374
  */
3404
- listTasks(options) {
3405
- return (options?.client ?? this.client).get({
3375
+ listSessionMonitors(options) {
3376
+ return (options.client ?? this.client).get({
3406
3377
  responseStyle: "data",
3407
- url: "/api/tasks",
3378
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/monitors",
3408
3379
  ...options,
3409
3380
  });
3410
3381
  }
3411
3382
  /**
3412
- * Create a task
3383
+ * Cancel a session monitor without waking the session
3413
3384
  */
3414
- createTask(options) {
3385
+ cancelSessionMonitor(options) {
3415
3386
  return (options.client ?? this.client).post({
3416
3387
  responseStyle: "data",
3417
- url: "/api/tasks",
3388
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/monitors/{monitor_id}/cancel",
3418
3389
  ...options,
3419
- headers: {
3420
- "Content-Type": "application/json",
3421
- ...options.headers,
3422
- },
3423
3390
  });
3424
3391
  }
3425
3392
  /**
3426
- * Delete one task
3393
+ * Move a session into a folder or back to the workspace root
3427
3394
  */
3428
- deleteTask(options) {
3429
- return (options.client ?? this.client).delete({
3395
+ moveSession(options) {
3396
+ return (options.client ?? this.client).post({
3430
3397
  responseStyle: "data",
3431
- url: "/api/tasks/{id}",
3398
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/move",
3432
3399
  ...options,
3400
+ headers: {
3401
+ "Content-Type": "application/json",
3402
+ ...options.headers,
3403
+ },
3433
3404
  });
3434
3405
  }
3435
3406
  /**
3436
- * Get one task with detail
3407
+ * Make an adopted child session top-level again
3437
3408
  */
3438
- getTask(options) {
3439
- return (options.client ?? this.client).get({
3409
+ clearSessionParent(options) {
3410
+ return (options.client ?? this.client).delete({
3440
3411
  responseStyle: "data",
3441
- url: "/api/tasks/{id}",
3412
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/parent",
3442
3413
  ...options,
3443
3414
  });
3444
3415
  }
3445
3416
  /**
3446
- * Update one task
3417
+ * Adopt a parentless user session as a child of another session
3447
3418
  */
3448
- updateTask(options) {
3449
- return (options.client ?? this.client).patch({
3419
+ setSessionParent(options) {
3420
+ return (options.client ?? this.client).put({
3450
3421
  responseStyle: "data",
3451
- url: "/api/tasks/{id}",
3422
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/parent",
3452
3423
  ...options,
3453
3424
  headers: {
3454
3425
  "Content-Type": "application/json",
@@ -3457,12 +3428,12 @@ export class tasks extends HeyApiClient {
3457
3428
  });
3458
3429
  }
3459
3430
  /**
3460
- * Approve one approval-gated task and enqueue executable work
3431
+ * Update operator session presence
3461
3432
  */
3462
- approveTask(options) {
3433
+ updateSessionPresence(options) {
3463
3434
  return (options.client ?? this.client).post({
3464
3435
  responseStyle: "data",
3465
- url: "/api/tasks/{id}/approve",
3436
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/presence",
3466
3437
  ...options,
3467
3438
  headers: {
3468
3439
  "Content-Type": "application/json",
@@ -3471,22 +3442,22 @@ export class tasks extends HeyApiClient {
3471
3442
  });
3472
3443
  }
3473
3444
  /**
3474
- * List typed task blocks
3445
+ * List attributed session processes
3475
3446
  */
3476
- listTaskBlocks(options) {
3447
+ listSessionProcesses(options) {
3477
3448
  return (options.client ?? this.client).get({
3478
3449
  responseStyle: "data",
3479
- url: "/api/tasks/{id}/blocks",
3450
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/processes",
3480
3451
  ...options,
3481
3452
  });
3482
3453
  }
3483
3454
  /**
3484
- * Create one typed task block
3455
+ * Terminate identity-verified session processes
3485
3456
  */
3486
- blockTask(options) {
3457
+ terminateSessionProcesses(options) {
3487
3458
  return (options.client ?? this.client).post({
3488
3459
  responseStyle: "data",
3489
- url: "/api/tasks/{id}/blocks",
3460
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/processes/terminate",
3490
3461
  ...options,
3491
3462
  headers: {
3492
3463
  "Content-Type": "application/json",
@@ -3495,98 +3466,52 @@ export class tasks extends HeyApiClient {
3495
3466
  });
3496
3467
  }
3497
3468
  /**
3498
- * Clear one typed task block
3469
+ * Cancel the active session prompt
3499
3470
  */
3500
- clearTaskBlock(options) {
3471
+ cancelSessionPrompt(options) {
3501
3472
  return (options.client ?? this.client).post({
3502
3473
  responseStyle: "data",
3503
- url: "/api/tasks/{id}/blocks/{block_id}/clear",
3474
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/prompt/cancel",
3504
3475
  ...options,
3505
- headers: {
3506
- "Content-Type": "application/json",
3507
- ...options.headers,
3508
- },
3509
3476
  });
3510
3477
  }
3511
3478
  /**
3512
- * Cancel one task tree
3479
+ * Clear queued input with attributed per-entry traces
3513
3480
  */
3514
- cancelTask(options) {
3515
- return (options.client ?? this.client).post({
3481
+ clearSessionInputs(options) {
3482
+ return (options.client ?? this.client).delete({
3516
3483
  responseStyle: "data",
3517
- url: "/api/tasks/{id}/cancel",
3484
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/prompt/queue",
3518
3485
  ...options,
3519
- headers: {
3520
- "Content-Type": "application/json",
3521
- ...options.headers,
3522
- },
3523
3486
  });
3524
3487
  }
3525
3488
  /**
3526
- * Create one child task
3489
+ * List pending session input
3527
3490
  */
3528
- createChildTask(options) {
3529
- return (options.client ?? this.client).post({
3491
+ listSessionInputs(options) {
3492
+ return (options.client ?? this.client).get({
3530
3493
  responseStyle: "data",
3531
- url: "/api/tasks/{id}/children",
3494
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/prompt/queue",
3532
3495
  ...options,
3533
- headers: {
3534
- "Content-Type": "application/json",
3535
- ...options.headers,
3536
- },
3537
3496
  });
3538
3497
  }
3539
3498
  /**
3540
- * Add one task dependency
3499
+ * Cancel a queued session prompt entry
3541
3500
  */
3542
- addTaskDependency(options) {
3543
- return (options.client ?? this.client).post({
3501
+ cancelQueuedSessionPrompt(options) {
3502
+ return (options.client ?? this.client).delete({
3544
3503
  responseStyle: "data",
3545
- url: "/api/tasks/{id}/dependencies",
3504
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/prompt/queue/{queue_entry_id}",
3546
3505
  ...options,
3547
- headers: {
3548
- "Content-Type": "application/json",
3549
- ...options.headers,
3550
- },
3551
3506
  });
3552
3507
  }
3553
3508
  /**
3554
- * Remove one task dependency
3509
+ * Replace queued session input atomically
3555
3510
  */
3556
- removeTaskDependency(options) {
3557
- return (options.client ?? this.client).delete({
3558
- responseStyle: "data",
3559
- url: "/api/tasks/{id}/dependencies/{depends_on_id}",
3560
- ...options,
3561
- });
3562
- }
3563
- /**
3564
- * Delete one task execution profile
3565
- */
3566
- deleteTaskExecutionProfile(options) {
3567
- return (options.client ?? this.client).delete({
3568
- responseStyle: "data",
3569
- url: "/api/tasks/{id}/execution-profile",
3570
- ...options,
3571
- });
3572
- }
3573
- /**
3574
- * Get one task execution profile
3575
- */
3576
- getTaskExecutionProfile(options) {
3577
- return (options.client ?? this.client).get({
3578
- responseStyle: "data",
3579
- url: "/api/tasks/{id}/execution-profile",
3580
- ...options,
3581
- });
3582
- }
3583
- /**
3584
- * Replace one task execution profile
3585
- */
3586
- setTaskExecutionProfile(options) {
3511
+ replaceSessionInput(options) {
3587
3512
  return (options.client ?? this.client).put({
3588
3513
  responseStyle: "data",
3589
- url: "/api/tasks/{id}/execution-profile",
3514
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/prompt/queue/{queue_entry_id}",
3590
3515
  ...options,
3591
3516
  headers: {
3592
3517
  "Content-Type": "application/json",
@@ -3595,12 +3520,12 @@ export class tasks extends HeyApiClient {
3595
3520
  });
3596
3521
  }
3597
3522
  /**
3598
- * Set one task worktree policy
3523
+ * Promote queued session input to steering
3599
3524
  */
3600
- setTaskWorktreePolicy(options) {
3601
- return (options.client ?? this.client).patch({
3525
+ promoteSessionInput(options) {
3526
+ return (options.client ?? this.client).post({
3602
3527
  responseStyle: "data",
3603
- url: "/api/tasks/{id}/execution-profile/worktree",
3528
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/prompt/queue/{queue_entry_id}/steer",
3604
3529
  ...options,
3605
3530
  headers: {
3606
3531
  "Content-Type": "application/json",
@@ -3609,36 +3534,32 @@ export class tasks extends HeyApiClient {
3609
3534
  });
3610
3535
  }
3611
3536
  /**
3612
- * Inspect one task with diagnostics
3537
+ * Get a deterministic session recap
3613
3538
  */
3614
- inspectTask(options) {
3539
+ getSessionRecap(options) {
3615
3540
  return (options.client ?? this.client).get({
3616
3541
  responseStyle: "data",
3617
- url: "/api/tasks/{id}/inspect",
3542
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/recap",
3618
3543
  ...options,
3619
3544
  });
3620
3545
  }
3621
3546
  /**
3622
- * Pause one task for future scheduler claims
3547
+ * Inspect and repair an interrupted session transcript
3623
3548
  */
3624
- pauseTask(options) {
3549
+ repairSession(options) {
3625
3550
  return (options.client ?? this.client).post({
3626
3551
  responseStyle: "data",
3627
- url: "/api/tasks/{id}/pause",
3552
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/repair",
3628
3553
  ...options,
3629
- headers: {
3630
- "Content-Type": "application/json",
3631
- ...options.headers,
3632
- },
3633
3554
  });
3634
3555
  }
3635
3556
  /**
3636
- * Publish one draft task and enqueue executable work
3557
+ * Return a parked session, and optionally its parked children, to the normal flow
3637
3558
  */
3638
- publishTask(options) {
3559
+ resumeSessionFromLater(options) {
3639
3560
  return (options.client ?? this.client).post({
3640
3561
  responseStyle: "data",
3641
- url: "/api/tasks/{id}/publish",
3562
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/resume-later",
3642
3563
  ...options,
3643
3564
  headers: {
3644
3565
  "Content-Type": "application/json",
@@ -3647,12 +3568,12 @@ export class tasks extends HeyApiClient {
3647
3568
  });
3648
3569
  }
3649
3570
  /**
3650
- * Recover one task from needs_attention
3571
+ * Rewind a conversation before one durable user message
3651
3572
  */
3652
- recoverTask(options) {
3573
+ rewindSessionConversation(options) {
3653
3574
  return (options.client ?? this.client).post({
3654
3575
  responseStyle: "data",
3655
- url: "/api/tasks/{id}/recover",
3576
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/rewind",
3656
3577
  ...options,
3657
3578
  headers: {
3658
3579
  "Content-Type": "application/json",
@@ -3661,22 +3582,22 @@ export class tasks extends HeyApiClient {
3661
3582
  });
3662
3583
  }
3663
3584
  /**
3664
- * Reject one approval-gated task
3585
+ * Clear the default runtime for future prompts
3665
3586
  */
3666
- rejectTask(options) {
3667
- return (options.client ?? this.client).post({
3587
+ clearSessionRuntime(options) {
3588
+ return (options.client ?? this.client).delete({
3668
3589
  responseStyle: "data",
3669
- url: "/api/tasks/{id}/reject",
3590
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/runtime",
3670
3591
  ...options,
3671
3592
  });
3672
3593
  }
3673
3594
  /**
3674
- * Resume one paused task for future scheduler claims
3595
+ * Select the default runtime for future prompts
3675
3596
  */
3676
- resumeTask(options) {
3677
- return (options.client ?? this.client).post({
3597
+ setSessionRuntime(options) {
3598
+ return (options.client ?? this.client).put({
3678
3599
  responseStyle: "data",
3679
- url: "/api/tasks/{id}/resume",
3600
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/runtime",
3680
3601
  ...options,
3681
3602
  headers: {
3682
3603
  "Content-Type": "application/json",
@@ -3685,32 +3606,36 @@ export class tasks extends HeyApiClient {
3685
3606
  });
3686
3607
  }
3687
3608
  /**
3688
- * List task-run reviews for one task
3609
+ * Refresh an idle session's Soul snapshot through body-level CAS
3689
3610
  */
3690
- listTaskReviews(options) {
3691
- return (options.client ?? this.client).get({
3611
+ refreshSessionSoul(options) {
3612
+ return (options.client ?? this.client).post({
3692
3613
  responseStyle: "data",
3693
- url: "/api/tasks/{id}/reviews",
3614
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/soul/refresh",
3694
3615
  ...options,
3616
+ headers: {
3617
+ "Content-Type": "application/json",
3618
+ ...options.headers,
3619
+ },
3695
3620
  });
3696
3621
  }
3697
3622
  /**
3698
- * List runs for one task
3623
+ * Read compact session status and wake eligibility
3699
3624
  */
3700
- listTaskRuns(options) {
3625
+ getSessionStatus(options) {
3701
3626
  return (options.client ?? this.client).get({
3702
3627
  responseStyle: "data",
3703
- url: "/api/tasks/{id}/runs",
3628
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/status",
3704
3629
  ...options,
3705
3630
  });
3706
3631
  }
3707
3632
  /**
3708
- * Enqueue one task run
3633
+ * Stage steering input for the active session turn
3709
3634
  */
3710
- enqueueTaskRun(options) {
3635
+ steerSessionPrompt(options) {
3711
3636
  return (options.client ?? this.client).post({
3712
3637
  responseStyle: "data",
3713
- url: "/api/tasks/{id}/runs",
3638
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/steer",
3714
3639
  ...options,
3715
3640
  headers: {
3716
3641
  "Content-Type": "application/json",
@@ -3719,12 +3644,12 @@ export class tasks extends HeyApiClient {
3719
3644
  });
3720
3645
  }
3721
3646
  /**
3722
- * Enqueue designated sibling runs for one task
3647
+ * Stop a session without deleting persisted history
3723
3648
  */
3724
- fanOutTaskRuns(options) {
3649
+ stopSession(options) {
3725
3650
  return (options.client ?? this.client).post({
3726
3651
  responseStyle: "data",
3727
- url: "/api/tasks/{id}/runs/fan-out",
3652
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/stop",
3728
3653
  ...options,
3729
3654
  headers: {
3730
3655
  "Content-Type": "application/json",
@@ -3733,12 +3658,32 @@ export class tasks extends HeyApiClient {
3733
3658
  });
3734
3659
  }
3735
3660
  /**
3736
- * Start one task by enqueueing executable work
3661
+ * List a session's subagents
3737
3662
  */
3738
- startTask(options) {
3663
+ listSessionSubagents(options) {
3664
+ return (options.client ?? this.client).get({
3665
+ responseStyle: "data",
3666
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/subagents",
3667
+ ...options,
3668
+ });
3669
+ }
3670
+ /**
3671
+ * List session-callable registry tools
3672
+ */
3673
+ listSessionTools(options) {
3674
+ return (options.client ?? this.client).get({
3675
+ responseStyle: "data",
3676
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/tools",
3677
+ ...options,
3678
+ });
3679
+ }
3680
+ /**
3681
+ * Search session-callable registry tools
3682
+ */
3683
+ searchSessionTools(options) {
3739
3684
  return (options.client ?? this.client).post({
3740
3685
  responseStyle: "data",
3741
- url: "/api/tasks/{id}/start",
3686
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/tools/search",
3742
3687
  ...options,
3743
3688
  headers: {
3744
3689
  "Content-Type": "application/json",
@@ -3747,74 +3692,72 @@ export class tasks extends HeyApiClient {
3747
3692
  });
3748
3693
  }
3749
3694
  /**
3750
- * Get one task timeline
3695
+ * Get a bounded materialized transcript page
3751
3696
  */
3752
- getTaskTimeline(options) {
3697
+ getSessionTranscript(options) {
3753
3698
  return (options.client ?? this.client).get({
3754
3699
  responseStyle: "data",
3755
- url: "/api/tasks/{id}/timeline",
3700
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/transcript",
3756
3701
  ...options,
3757
3702
  });
3758
3703
  }
3759
3704
  /**
3760
- * Get one task tree live view
3705
+ * Get the full retained operator-message trail with reply previews
3761
3706
  */
3762
- getTaskTree(options) {
3707
+ getSessionTranscriptOutline(options) {
3763
3708
  return (options.client ?? this.client).get({
3764
3709
  responseStyle: "data",
3765
- url: "/api/tasks/{id}/tree",
3710
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/transcript/outline",
3766
3711
  ...options,
3767
3712
  });
3768
3713
  }
3769
3714
  /**
3770
- * Archive one task inbox item
3715
+ * Search retained transcript messages with bounded literal matches
3771
3716
  */
3772
- archiveTask(options) {
3773
- return (options.client ?? this.client).post({
3717
+ searchSessionTranscript(options) {
3718
+ return (options.client ?? this.client).get({
3774
3719
  responseStyle: "data",
3775
- url: "/api/tasks/{id}/triage/archive",
3720
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/transcript/search",
3776
3721
  ...options,
3777
3722
  });
3778
3723
  }
3779
3724
  /**
3780
- * Dismiss one task inbox item
3725
+ * Restore an archived session
3781
3726
  */
3782
- dismissTask(options) {
3727
+ unarchiveSession(options) {
3783
3728
  return (options.client ?? this.client).post({
3784
3729
  responseStyle: "data",
3785
- url: "/api/tasks/{id}/triage/dismiss",
3730
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/unarchive",
3786
3731
  ...options,
3787
3732
  });
3788
3733
  }
3789
3734
  /**
3790
- * Mark one task inbox item as read
3735
+ * Get aggregated token usage for a session
3791
3736
  */
3792
- markTaskRead(options) {
3793
- return (options.client ?? this.client).post({
3737
+ getSessionUsage(options) {
3738
+ return (options.client ?? this.client).get({
3794
3739
  responseStyle: "data",
3795
- url: "/api/tasks/{id}/triage/read",
3740
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/usage",
3796
3741
  ...options,
3797
3742
  });
3798
3743
  }
3799
- }
3800
- export class sessions extends HeyApiClient {
3801
3744
  /**
3802
- * List sessions
3745
+ * Get per-turn session usage and native compaction markers
3803
3746
  */
3804
- listSessions(options) {
3805
- return (options?.client ?? this.client).get({
3747
+ getSessionUsageTurns(options) {
3748
+ return (options.client ?? this.client).get({
3806
3749
  responseStyle: "data",
3807
- url: "/api/sessions",
3750
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/usage/turns",
3808
3751
  ...options,
3809
3752
  });
3810
3753
  }
3811
3754
  /**
3812
- * Create a session
3755
+ * Wait for a session state
3813
3756
  */
3814
- createSession(options) {
3757
+ waitForSession(options) {
3815
3758
  return (options.client ?? this.client).post({
3816
3759
  responseStyle: "data",
3817
- url: "/api/sessions",
3760
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/wait",
3818
3761
  ...options,
3819
3762
  headers: {
3820
3763
  "Content-Type": "application/json",
@@ -3823,132 +3766,212 @@ export class sessions extends HeyApiClient {
3823
3766
  });
3824
3767
  }
3825
3768
  /**
3826
- * Get exact session attention counts
3769
+ * Return an idle session to the workspace root in place
3827
3770
  */
3828
- getSessionAttentionSummary(options) {
3829
- return (options?.client ?? this.client).get({
3771
+ unbindSessionWorktree(options) {
3772
+ return (options.client ?? this.client).delete({
3830
3773
  responseStyle: "data",
3831
- url: "/api/sessions/attention-summary",
3774
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/worktree",
3832
3775
  ...options,
3833
3776
  });
3834
3777
  }
3835
3778
  /**
3836
- * Count session catalog facets
3779
+ * Bind an idle existing session to a ready worktree in place
3837
3780
  */
3838
- listSessionFacets(options) {
3839
- return (options?.client ?? this.client).get({
3781
+ bindSessionWorktree(options) {
3782
+ return (options.client ?? this.client).put({
3840
3783
  responseStyle: "data",
3841
- url: "/api/sessions/facets",
3784
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/worktree",
3842
3785
  ...options,
3786
+ headers: {
3787
+ "Content-Type": "application/json",
3788
+ ...options.headers,
3789
+ },
3843
3790
  });
3844
3791
  }
3845
3792
  /**
3846
- * Get one session snapshot by id
3793
+ * Fork a live session into a worktree
3847
3794
  */
3848
- getSessionByID(options) {
3849
- return (options.client ?? this.client).get({
3795
+ forkSessionToWorktree(options) {
3796
+ return (options.client ?? this.client).post({
3850
3797
  responseStyle: "data",
3851
- url: "/api/sessions/{session_id}",
3798
+ url: "/api/workspaces/{workspace_id}/sessions/{session_id}/worktree-fork",
3852
3799
  ...options,
3800
+ headers: {
3801
+ "Content-Type": "application/json",
3802
+ ...options.headers,
3803
+ },
3853
3804
  });
3854
3805
  }
3855
3806
  /**
3856
- * List persisted session events for a Global session
3807
+ * Read one subagent
3857
3808
  */
3858
- listGlobalSessionEvents(options) {
3809
+ getSubagent(options) {
3859
3810
  return (options.client ?? this.client).get({
3860
3811
  responseStyle: "data",
3861
- url: "/api/sessions/{session_id}/events",
3812
+ url: "/api/workspaces/{workspace_id}/subagents/{subagent_id}",
3862
3813
  ...options,
3863
3814
  });
3864
3815
  }
3865
3816
  /**
3866
- * List grouped session turn history for a Global session
3817
+ * Cancel a delegated subagent
3867
3818
  */
3868
- getGlobalSessionHistory(options) {
3869
- return (options.client ?? this.client).get({
3819
+ cancelSubagent(options) {
3820
+ return (options.client ?? this.client).post({
3870
3821
  responseStyle: "data",
3871
- url: "/api/sessions/{session_id}/history",
3822
+ url: "/api/workspaces/{workspace_id}/subagents/{subagent_id}/cancel",
3872
3823
  ...options,
3824
+ headers: {
3825
+ "Content-Type": "application/json",
3826
+ ...options.headers,
3827
+ },
3873
3828
  });
3874
3829
  }
3830
+ }
3831
+ export class profiles extends HeyApiClient {
3875
3832
  /**
3876
- * Get a session owner; Global history has an empty workspace id
3833
+ * List profiles
3877
3834
  */
3878
- getSessionOwner(options) {
3879
- return (options.client ?? this.client).get({
3835
+ listProfiles(options) {
3836
+ return (options?.client ?? this.client).get({
3880
3837
  responseStyle: "data",
3881
- url: "/api/sessions/{session_id}/owner",
3838
+ url: "/api/profiles",
3882
3839
  ...options,
3883
3840
  });
3884
3841
  }
3885
3842
  /**
3886
- * Refresh a session pull request
3843
+ * Create a profile
3887
3844
  */
3888
- refreshSessionPullRequest(options) {
3845
+ createProfile(options) {
3889
3846
  return (options.client ?? this.client).post({
3890
3847
  responseStyle: "data",
3891
- url: "/api/sessions/{session_id}/pull-request/refresh",
3848
+ url: "/api/profiles",
3892
3849
  ...options,
3893
- });
3894
- }
3895
- /**
3896
- * Read compact session status and wake eligibility for a Global session
3850
+ headers: {
3851
+ "Content-Type": "application/json",
3852
+ ...options.headers,
3853
+ },
3854
+ });
3855
+ }
3856
+ /**
3857
+ * List profile lifecycle operations
3897
3858
  */
3898
- getGlobalSessionStatus(options) {
3899
- return (options.client ?? this.client).get({
3859
+ listProfileOperations(options) {
3860
+ return (options?.client ?? this.client).get({
3900
3861
  responseStyle: "data",
3901
- url: "/api/sessions/{session_id}/status",
3862
+ url: "/api/profiles/ops",
3902
3863
  ...options,
3903
3864
  });
3904
3865
  }
3905
3866
  /**
3906
- * Get a bounded materialized transcript page for a Global session
3867
+ * Retry a profile lifecycle operation
3907
3868
  */
3908
- getGlobalSessionTranscript(options) {
3909
- return (options.client ?? this.client).get({
3869
+ retryProfileOperation(options) {
3870
+ return (options.client ?? this.client).post({
3910
3871
  responseStyle: "data",
3911
- url: "/api/sessions/{session_id}/transcript",
3872
+ url: "/api/profiles/ops/{op_id}/retry",
3912
3873
  ...options,
3913
3874
  });
3914
3875
  }
3915
3876
  /**
3916
- * Get the full retained operator-message trail with reply previews for a Global session
3877
+ * Read profile selections
3917
3878
  */
3918
- getGlobalSessionTranscriptOutline(options) {
3879
+ getProfileSelections(options) {
3880
+ return (options?.client ?? this.client).get({
3881
+ responseStyle: "data",
3882
+ url: "/api/profiles/selection",
3883
+ ...options,
3884
+ });
3885
+ }
3886
+ /**
3887
+ * Remember a profile selection
3888
+ */
3889
+ putProfileSelection(options) {
3890
+ return (options.client ?? this.client).put({
3891
+ responseStyle: "data",
3892
+ url: "/api/profiles/selection",
3893
+ ...options,
3894
+ headers: {
3895
+ "Content-Type": "application/json",
3896
+ ...options.headers,
3897
+ },
3898
+ });
3899
+ }
3900
+ /**
3901
+ * Delete a profile
3902
+ */
3903
+ deleteProfile(options) {
3904
+ return (options.client ?? this.client).delete({
3905
+ responseStyle: "data",
3906
+ url: "/api/profiles/{name}",
3907
+ ...options,
3908
+ });
3909
+ }
3910
+ /**
3911
+ * Get a profile
3912
+ */
3913
+ getProfile(options) {
3919
3914
  return (options.client ?? this.client).get({
3920
3915
  responseStyle: "data",
3921
- url: "/api/sessions/{session_id}/transcript/outline",
3916
+ url: "/api/profiles/{name}",
3922
3917
  ...options,
3923
3918
  });
3924
3919
  }
3925
3920
  /**
3926
- * Search retained transcript messages with bounded literal matches for a Global session
3921
+ * Update profile identity
3927
3922
  */
3928
- searchGlobalSessionTranscript(options) {
3923
+ updateProfile(options) {
3924
+ return (options.client ?? this.client).patch({
3925
+ responseStyle: "data",
3926
+ url: "/api/profiles/{name}",
3927
+ ...options,
3928
+ headers: {
3929
+ "Content-Type": "application/json",
3930
+ ...options.headers,
3931
+ },
3932
+ });
3933
+ }
3934
+ /**
3935
+ * Archive a profile
3936
+ */
3937
+ archiveProfile(options) {
3938
+ return (options.client ?? this.client).post({
3939
+ responseStyle: "data",
3940
+ url: "/api/profiles/{name}/archive",
3941
+ ...options,
3942
+ headers: {
3943
+ "Content-Type": "application/json",
3944
+ ...options.headers,
3945
+ },
3946
+ });
3947
+ }
3948
+ /**
3949
+ * Preview profile archival
3950
+ */
3951
+ prepareProfileArchive(options) {
3929
3952
  return (options.client ?? this.client).get({
3930
3953
  responseStyle: "data",
3931
- url: "/api/sessions/{session_id}/transcript/search",
3954
+ url: "/api/profiles/{name}/archive-plan",
3932
3955
  ...options,
3933
3956
  });
3934
3957
  }
3935
3958
  /**
3936
- * List session folders in manual order
3959
+ * Preview profile deletion
3937
3960
  */
3938
- listSessionFolders(options) {
3961
+ prepareProfileDelete(options) {
3939
3962
  return (options.client ?? this.client).get({
3940
3963
  responseStyle: "data",
3941
- url: "/api/workspaces/{workspace_id}/session-folders",
3964
+ url: "/api/profiles/{name}/delete-plan",
3942
3965
  ...options,
3943
3966
  });
3944
3967
  }
3945
3968
  /**
3946
- * Create a session folder
3969
+ * Rename a profile
3947
3970
  */
3948
- createSessionFolder(options) {
3971
+ renameProfile(options) {
3949
3972
  return (options.client ?? this.client).post({
3950
3973
  responseStyle: "data",
3951
- url: "/api/workspaces/{workspace_id}/session-folders",
3974
+ url: "/api/profiles/{name}/rename",
3952
3975
  ...options,
3953
3976
  headers: {
3954
3977
  "Content-Type": "application/json",
@@ -3957,22 +3980,22 @@ export class sessions extends HeyApiClient {
3957
3980
  });
3958
3981
  }
3959
3982
  /**
3960
- * Delete a session folder; its sessions return to the workspace root
3983
+ * Preview a profile rename
3961
3984
  */
3962
- deleteSessionFolder(options) {
3963
- return (options.client ?? this.client).delete({
3985
+ prepareProfileRename(options) {
3986
+ return (options.client ?? this.client).get({
3964
3987
  responseStyle: "data",
3965
- url: "/api/workspaces/{workspace_id}/session-folders/{folder_id}",
3988
+ url: "/api/profiles/{name}/rename-plan",
3966
3989
  ...options,
3967
3990
  });
3968
3991
  }
3969
3992
  /**
3970
- * Rename a session folder
3993
+ * Unarchive a profile
3971
3994
  */
3972
- renameSessionFolder(options) {
3973
- return (options.client ?? this.client).patch({
3995
+ unarchiveProfile(options) {
3996
+ return (options.client ?? this.client).post({
3974
3997
  responseStyle: "data",
3975
- url: "/api/workspaces/{workspace_id}/session-folders/{folder_id}",
3998
+ url: "/api/profiles/{name}/unarchive",
3976
3999
  ...options,
3977
4000
  headers: {
3978
4001
  "Content-Type": "application/json",
@@ -3980,13 +4003,35 @@ export class sessions extends HeyApiClient {
3980
4003
  },
3981
4004
  });
3982
4005
  }
4006
+ }
4007
+ export class resources extends HeyApiClient {
3983
4008
  /**
3984
- * Set the complete session folder order
4009
+ * List desired-state resources on the local operator control plane
3985
4010
  */
3986
- reorderSessionFolders(options) {
3987
- return (options.client ?? this.client).put({
4011
+ listResources(options) {
4012
+ return (options?.client ?? this.client).get({
3988
4013
  responseStyle: "data",
3989
- url: "/api/workspaces/{workspace_id}/session-order/folders",
4014
+ url: "/api/resources",
4015
+ ...options,
4016
+ });
4017
+ }
4018
+ /**
4019
+ * List one desired-state resource kind on the local operator control plane
4020
+ */
4021
+ listResourcesByKind(options) {
4022
+ return (options.client ?? this.client).get({
4023
+ responseStyle: "data",
4024
+ url: "/api/resources/{kind}",
4025
+ ...options,
4026
+ });
4027
+ }
4028
+ /**
4029
+ * Delete one desired-state resource on the local operator control plane
4030
+ */
4031
+ deleteResource(options) {
4032
+ return (options.client ?? this.client).delete({
4033
+ responseStyle: "data",
4034
+ url: "/api/resources/{kind}/{id}",
3990
4035
  ...options,
3991
4036
  headers: {
3992
4037
  "Content-Type": "application/json",
@@ -3995,12 +4040,22 @@ export class sessions extends HeyApiClient {
3995
4040
  });
3996
4041
  }
3997
4042
  /**
3998
- * Set the manual session order in a folder or the workspace root
4043
+ * Read one desired-state resource on the local operator control plane
3999
4044
  */
4000
- reorderSessions(options) {
4045
+ getResource(options) {
4046
+ return (options.client ?? this.client).get({
4047
+ responseStyle: "data",
4048
+ url: "/api/resources/{kind}/{id}",
4049
+ ...options,
4050
+ });
4051
+ }
4052
+ /**
4053
+ * Create or replace one desired-state resource on the local operator control plane
4054
+ */
4055
+ putResource(options) {
4001
4056
  return (options.client ?? this.client).put({
4002
4057
  responseStyle: "data",
4003
- url: "/api/workspaces/{workspace_id}/session-order/sessions",
4058
+ url: "/api/resources/{kind}/{id}",
4004
4059
  ...options,
4005
4060
  headers: {
4006
4061
  "Content-Type": "application/json",
@@ -4008,43 +4063,51 @@ export class sessions extends HeyApiClient {
4008
4063
  },
4009
4064
  });
4010
4065
  }
4066
+ }
4067
+ export class roles extends HeyApiClient {
4011
4068
  /**
4012
- * List sessions
4069
+ * List effective background role configuration
4013
4070
  */
4014
- listWorkspaceSessions(options) {
4015
- return (options.client ?? this.client).get({
4071
+ listRoles(options) {
4072
+ return (options?.client ?? this.client).get({
4016
4073
  responseStyle: "data",
4017
- url: "/api/workspaces/{workspace_id}/sessions",
4074
+ url: "/api/roles",
4018
4075
  ...options,
4019
4076
  });
4020
4077
  }
4021
4078
  /**
4022
- * Delete one session and remove it from persisted history
4079
+ * Get effective background role configuration
4023
4080
  */
4024
- deleteSession(options) {
4025
- return (options.client ?? this.client).delete({
4081
+ getRole(options) {
4082
+ return (options.client ?? this.client).get({
4026
4083
  responseStyle: "data",
4027
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}",
4084
+ url: "/api/roles/{role}",
4028
4085
  ...options,
4029
4086
  });
4030
4087
  }
4088
+ }
4089
+ export class tasks extends HeyApiClient {
4031
4090
  /**
4032
- * Get one session snapshot
4091
+ * Force fail a bounded set of queued or claimed task runs
4033
4092
  */
4034
- getSession(options) {
4035
- return (options.client ?? this.client).get({
4093
+ bulkForceFailTaskRuns(options) {
4094
+ return (options.client ?? this.client).post({
4036
4095
  responseStyle: "data",
4037
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}",
4096
+ url: "/api/runs/bulk/fail",
4038
4097
  ...options,
4098
+ headers: {
4099
+ "Content-Type": "application/json",
4100
+ ...options.headers,
4101
+ },
4039
4102
  });
4040
4103
  }
4041
4104
  /**
4042
- * Rename one user session
4105
+ * Force release a bounded set of claimed task runs
4043
4106
  */
4044
- renameSession(options) {
4045
- return (options.client ?? this.client).patch({
4107
+ bulkForceReleaseTaskRuns(options) {
4108
+ return (options.client ?? this.client).post({
4046
4109
  responseStyle: "data",
4047
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}",
4110
+ url: "/api/runs/bulk/release",
4048
4111
  ...options,
4049
4112
  headers: {
4050
4113
  "Content-Type": "application/json",
@@ -4053,12 +4116,12 @@ export class sessions extends HeyApiClient {
4053
4116
  });
4054
4117
  }
4055
4118
  /**
4056
- * Approve or deny an interactive permission request
4119
+ * Force fail one queued or claimed task run
4057
4120
  */
4058
- approveSession(options) {
4121
+ forceFailTaskRun(options) {
4059
4122
  return (options.client ?? this.client).post({
4060
4123
  responseStyle: "data",
4061
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/approve",
4124
+ url: "/api/runs/{id}/fail",
4062
4125
  ...options,
4063
4126
  headers: {
4064
4127
  "Content-Type": "application/json",
@@ -4067,22 +4130,36 @@ export class sessions extends HeyApiClient {
4067
4130
  });
4068
4131
  }
4069
4132
  /**
4070
- * Archive a stopped session, or stop and archive a live session with stop=true
4133
+ * Inspect one task run with diagnostics
4071
4134
  */
4072
- archiveSession(options) {
4135
+ inspectRun(options) {
4136
+ return (options.client ?? this.client).get({
4137
+ responseStyle: "data",
4138
+ url: "/api/runs/{id}/inspect",
4139
+ ...options,
4140
+ });
4141
+ }
4142
+ /**
4143
+ * Recover one needs_attention task run
4144
+ */
4145
+ recoverTaskRun(options) {
4073
4146
  return (options.client ?? this.client).post({
4074
4147
  responseStyle: "data",
4075
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/archive",
4148
+ url: "/api/runs/{id}/recover",
4076
4149
  ...options,
4150
+ headers: {
4151
+ "Content-Type": "application/json",
4152
+ ...options.headers,
4153
+ },
4077
4154
  });
4078
4155
  }
4079
4156
  /**
4080
- * Attach to a resumable live session
4157
+ * Force release one claimed task run
4081
4158
  */
4082
- attachSession(options) {
4159
+ forceReleaseTaskRun(options) {
4083
4160
  return (options.client ?? this.client).post({
4084
4161
  responseStyle: "data",
4085
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/attach",
4162
+ url: "/api/runs/{id}/release",
4086
4163
  ...options,
4087
4164
  headers: {
4088
4165
  "Content-Type": "application/json",
@@ -4091,57 +4168,98 @@ export class sessions extends HeyApiClient {
4091
4168
  });
4092
4169
  }
4093
4170
  /**
4094
- * Upload a session attachment
4171
+ * Retry one failed task run
4095
4172
  */
4096
- uploadSessionAttachment(options) {
4173
+ retryTaskRun(options) {
4097
4174
  return (options.client ?? this.client).post({
4098
- ...formDataBodySerializer,
4099
4175
  responseStyle: "data",
4100
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/attachments",
4176
+ url: "/api/runs/{id}/retry",
4101
4177
  ...options,
4102
4178
  headers: {
4103
- "Content-Type": null,
4179
+ "Content-Type": "application/json",
4104
4180
  ...options.headers,
4105
4181
  },
4106
4182
  });
4107
4183
  }
4108
4184
  /**
4109
- * Delete a session attachment
4185
+ * Get scheduler pause state and queue pressure
4110
4186
  */
4111
- deleteSessionAttachment(options) {
4112
- return (options.client ?? this.client).delete({
4187
+ getScheduler(options) {
4188
+ return (options?.client ?? this.client).get({
4113
4189
  responseStyle: "data",
4114
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/attachments/{attachment_id}",
4190
+ url: "/api/scheduler",
4191
+ ...options,
4192
+ });
4193
+ }
4194
+ /**
4195
+ * List queued scheduler backlog rows
4196
+ */
4197
+ getSchedulerBacklog(options) {
4198
+ return (options?.client ?? this.client).get({
4199
+ responseStyle: "data",
4200
+ url: "/api/scheduler/backlog",
4201
+ ...options,
4202
+ });
4203
+ }
4204
+ /**
4205
+ * Pause the scheduler and wait for active claims to drain
4206
+ */
4207
+ drainScheduler(options) {
4208
+ return (options?.client ?? this.client).post({
4209
+ responseStyle: "data",
4210
+ url: "/api/scheduler/drain",
4211
+ ...options,
4212
+ headers: {
4213
+ "Content-Type": "application/json",
4214
+ ...options?.headers,
4215
+ },
4216
+ });
4217
+ }
4218
+ /**
4219
+ * Pause scheduler dispatch and task-run claims
4220
+ */
4221
+ pauseScheduler(options) {
4222
+ return (options?.client ?? this.client).post({
4223
+ responseStyle: "data",
4224
+ url: "/api/scheduler/pause",
4115
4225
  ...options,
4226
+ headers: {
4227
+ "Content-Type": "application/json",
4228
+ ...options?.headers,
4229
+ },
4116
4230
  });
4117
4231
  }
4118
4232
  /**
4119
- * Read session attachment bytes
4233
+ * Resume scheduler dispatch and task-run claims
4120
4234
  */
4121
- readSessionAttachmentBytes(options) {
4122
- return (options.client ?? this.client).get({
4235
+ resumeScheduler(options) {
4236
+ return (options?.client ?? this.client).post({
4123
4237
  responseStyle: "data",
4124
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/attachments/{attachment_id}/bytes",
4238
+ url: "/api/scheduler/resume",
4125
4239
  ...options,
4240
+ headers: {
4241
+ "Content-Type": "application/json",
4242
+ ...options?.headers,
4243
+ },
4126
4244
  });
4127
4245
  }
4128
4246
  /**
4129
- * List the live pending clarification for a session
4247
+ * Get one task-run review
4130
4248
  */
4131
- listSessionClarifications(options) {
4249
+ getTaskRunReview(options) {
4132
4250
  return (options.client ?? this.client).get({
4133
4251
  responseStyle: "data",
4134
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/clarifications",
4252
+ url: "/api/task-reviews/{id}",
4135
4253
  ...options,
4136
4254
  });
4137
4255
  }
4138
4256
  /**
4139
- * Answer a live session clarification
4257
+ * Submit one task-run review verdict
4140
4258
  */
4141
- answerSessionClarification(options) {
4259
+ submitTaskRunReviewVerdict(options) {
4142
4260
  return (options.client ?? this.client).post({
4143
4261
  responseStyle: "data",
4144
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/clarifications/{request_id}/answer",
4262
+ url: "/api/task-reviews/{id}/verdict",
4145
4263
  ...options,
4146
4264
  headers: {
4147
4265
  "Content-Type": "application/json",
@@ -4150,34 +4268,36 @@ export class sessions extends HeyApiClient {
4150
4268
  });
4151
4269
  }
4152
4270
  /**
4153
- * Clear conversation history and restart the session context
4271
+ * Get one task run detail
4154
4272
  */
4155
- clearSessionConversation(options) {
4156
- return (options.client ?? this.client).post({
4273
+ getTaskRun(options) {
4274
+ return (options.client ?? this.client).get({
4157
4275
  responseStyle: "data",
4158
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/clear",
4276
+ url: "/api/task-runs/{id}",
4159
4277
  ...options,
4160
4278
  });
4161
4279
  }
4162
4280
  /**
4163
- * List commands available to a session
4281
+ * Attach an existing session to one task run
4164
4282
  */
4165
- getSessionCommands(options) {
4166
- return (options.client ?? this.client).get({
4283
+ attachTaskRunSession(options) {
4284
+ return (options.client ?? this.client).post({
4167
4285
  responseStyle: "data",
4168
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/commands",
4286
+ url: "/api/task-runs/{id}/attach-session",
4169
4287
  ...options,
4288
+ headers: {
4289
+ "Content-Type": "application/json",
4290
+ ...options.headers,
4291
+ },
4170
4292
  });
4171
4293
  }
4172
4294
  /**
4173
- * Request advertised native agent compaction (experimental)
4174
- *
4175
- * @stability experimental
4295
+ * Cancel one task run
4176
4296
  */
4177
- compactSession(options) {
4297
+ cancelTaskRun(options) {
4178
4298
  return (options.client ?? this.client).post({
4179
4299
  responseStyle: "data",
4180
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/compact",
4300
+ url: "/api/task-runs/{id}/cancel",
4181
4301
  ...options,
4182
4302
  headers: {
4183
4303
  "Content-Type": "application/json",
@@ -4186,12 +4306,12 @@ export class sessions extends HeyApiClient {
4186
4306
  });
4187
4307
  }
4188
4308
  /**
4189
- * Continue a session with another agent, runtime, or declared route
4309
+ * Complete one running task run
4190
4310
  */
4191
- continueSession(options) {
4311
+ completeTaskRun(options) {
4192
4312
  return (options.client ?? this.client).post({
4193
4313
  responseStyle: "data",
4194
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/continue",
4314
+ url: "/api/task-runs/{id}/complete",
4195
4315
  ...options,
4196
4316
  headers: {
4197
4317
  "Content-Type": "application/json",
@@ -4200,42 +4320,46 @@ export class sessions extends HeyApiClient {
4200
4320
  });
4201
4321
  }
4202
4322
  /**
4203
- * Preview what a continue or fork of a session would carry
4323
+ * Fail one task run
4204
4324
  */
4205
- previewSessionDerive(options) {
4206
- return (options.client ?? this.client).get({
4325
+ failTaskRun(options) {
4326
+ return (options.client ?? this.client).post({
4207
4327
  responseStyle: "data",
4208
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/derive/preview",
4328
+ url: "/api/task-runs/{id}/fail",
4209
4329
  ...options,
4330
+ headers: {
4331
+ "Content-Type": "application/json",
4332
+ ...options.headers,
4333
+ },
4210
4334
  });
4211
4335
  }
4212
4336
  /**
4213
- * List persisted session events
4337
+ * Read one exact byte page from a task-run result
4214
4338
  */
4215
- listSessionEvents(options) {
4339
+ readTaskRunResult(options) {
4216
4340
  return (options.client ?? this.client).get({
4217
4341
  responseStyle: "data",
4218
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/events",
4342
+ url: "/api/task-runs/{id}/result",
4219
4343
  ...options,
4220
4344
  });
4221
4345
  }
4222
4346
  /**
4223
- * Search files and folders under a session's working directory
4347
+ * List reviews for one task run
4224
4348
  */
4225
- searchSessionFiles(options) {
4349
+ listTaskRunReviews(options) {
4226
4350
  return (options.client ?? this.client).get({
4227
4351
  responseStyle: "data",
4228
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/files",
4352
+ url: "/api/task-runs/{id}/reviews",
4229
4353
  ...options,
4230
4354
  });
4231
4355
  }
4232
4356
  /**
4233
- * Fork a session with the same agent, whole or through one user message and its turn
4357
+ * Request review for one terminal task run
4234
4358
  */
4235
- forkSession(options) {
4359
+ requestTaskRunReview(options) {
4236
4360
  return (options.client ?? this.client).post({
4237
4361
  responseStyle: "data",
4238
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/fork",
4362
+ url: "/api/task-runs/{id}/reviews",
4239
4363
  ...options,
4240
4364
  headers: {
4241
4365
  "Content-Type": "application/json",
@@ -4244,72 +4368,84 @@ export class sessions extends HeyApiClient {
4244
4368
  });
4245
4369
  }
4246
4370
  /**
4247
- * Read metadata-only session health and wake eligibility
4371
+ * Start one claimed task run
4248
4372
  */
4249
- getSessionHealth(options) {
4250
- return (options.client ?? this.client).get({
4373
+ startTaskRun(options) {
4374
+ return (options.client ?? this.client).post({
4251
4375
  responseStyle: "data",
4252
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/health",
4376
+ url: "/api/task-runs/{id}/start",
4253
4377
  ...options,
4378
+ headers: {
4379
+ "Content-Type": "application/json",
4380
+ ...options.headers,
4381
+ },
4254
4382
  });
4255
4383
  }
4256
4384
  /**
4257
- * List grouped session turn history
4385
+ * List a bounded task catalog page
4258
4386
  */
4259
- getSessionHistory(options) {
4260
- return (options.client ?? this.client).get({
4387
+ listTasks(options) {
4388
+ return (options?.client ?? this.client).get({
4261
4389
  responseStyle: "data",
4262
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/history",
4390
+ url: "/api/tasks",
4263
4391
  ...options,
4264
4392
  });
4265
4393
  }
4266
4394
  /**
4267
- * Inspect session health, wake audit, and policy correlation metadata
4395
+ * Create a task
4268
4396
  */
4269
- inspectSession(options) {
4270
- return (options.client ?? this.client).get({
4397
+ createTask(options) {
4398
+ return (options.client ?? this.client).post({
4271
4399
  responseStyle: "data",
4272
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/inspect",
4400
+ url: "/api/tasks",
4273
4401
  ...options,
4402
+ headers: {
4403
+ "Content-Type": "application/json",
4404
+ ...options.headers,
4405
+ },
4274
4406
  });
4275
4407
  }
4276
4408
  /**
4277
- * List pending session interactions
4409
+ * Delete one task
4278
4410
  */
4279
- listSessionInteractions(options) {
4280
- return (options.client ?? this.client).get({
4411
+ deleteTask(options) {
4412
+ return (options.client ?? this.client).delete({
4281
4413
  responseStyle: "data",
4282
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/interactions",
4414
+ url: "/api/tasks/{id}",
4283
4415
  ...options,
4284
4416
  });
4285
4417
  }
4286
4418
  /**
4287
- * List a session's monitors
4419
+ * Get one task with detail
4288
4420
  */
4289
- listSessionMonitors(options) {
4421
+ getTask(options) {
4290
4422
  return (options.client ?? this.client).get({
4291
4423
  responseStyle: "data",
4292
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/monitors",
4424
+ url: "/api/tasks/{id}",
4293
4425
  ...options,
4294
4426
  });
4295
4427
  }
4296
4428
  /**
4297
- * Cancel a session monitor without waking the session
4429
+ * Update one task
4298
4430
  */
4299
- cancelSessionMonitor(options) {
4300
- return (options.client ?? this.client).post({
4431
+ updateTask(options) {
4432
+ return (options.client ?? this.client).patch({
4301
4433
  responseStyle: "data",
4302
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/monitors/{monitor_id}/cancel",
4434
+ url: "/api/tasks/{id}",
4303
4435
  ...options,
4436
+ headers: {
4437
+ "Content-Type": "application/json",
4438
+ ...options.headers,
4439
+ },
4304
4440
  });
4305
4441
  }
4306
4442
  /**
4307
- * Move a session into a folder or back to the workspace root
4443
+ * Approve one approval-gated task and enqueue executable work
4308
4444
  */
4309
- moveSession(options) {
4445
+ approveTask(options) {
4310
4446
  return (options.client ?? this.client).post({
4311
4447
  responseStyle: "data",
4312
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/move",
4448
+ url: "/api/tasks/{id}/approve",
4313
4449
  ...options,
4314
4450
  headers: {
4315
4451
  "Content-Type": "application/json",
@@ -4318,22 +4454,22 @@ export class sessions extends HeyApiClient {
4318
4454
  });
4319
4455
  }
4320
4456
  /**
4321
- * Make an adopted child session top-level again
4457
+ * List typed task blocks
4322
4458
  */
4323
- clearSessionParent(options) {
4324
- return (options.client ?? this.client).delete({
4459
+ listTaskBlocks(options) {
4460
+ return (options.client ?? this.client).get({
4325
4461
  responseStyle: "data",
4326
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/parent",
4462
+ url: "/api/tasks/{id}/blocks",
4327
4463
  ...options,
4328
4464
  });
4329
4465
  }
4330
4466
  /**
4331
- * Adopt a parentless user session as a child of another session
4467
+ * Create one typed task block
4332
4468
  */
4333
- setSessionParent(options) {
4334
- return (options.client ?? this.client).put({
4469
+ blockTask(options) {
4470
+ return (options.client ?? this.client).post({
4335
4471
  responseStyle: "data",
4336
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/parent",
4472
+ url: "/api/tasks/{id}/blocks",
4337
4473
  ...options,
4338
4474
  headers: {
4339
4475
  "Content-Type": "application/json",
@@ -4342,12 +4478,12 @@ export class sessions extends HeyApiClient {
4342
4478
  });
4343
4479
  }
4344
4480
  /**
4345
- * Update operator session presence
4481
+ * Clear one typed task block
4346
4482
  */
4347
- updateSessionPresence(options) {
4483
+ clearTaskBlock(options) {
4348
4484
  return (options.client ?? this.client).post({
4349
4485
  responseStyle: "data",
4350
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/presence",
4486
+ url: "/api/tasks/{id}/blocks/{block_id}/clear",
4351
4487
  ...options,
4352
4488
  headers: {
4353
4489
  "Content-Type": "application/json",
@@ -4356,52 +4492,12 @@ export class sessions extends HeyApiClient {
4356
4492
  });
4357
4493
  }
4358
4494
  /**
4359
- * Cancel the active session prompt
4495
+ * Cancel one task tree
4360
4496
  */
4361
- cancelSessionPrompt(options) {
4497
+ cancelTask(options) {
4362
4498
  return (options.client ?? this.client).post({
4363
4499
  responseStyle: "data",
4364
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/prompt/cancel",
4365
- ...options,
4366
- });
4367
- }
4368
- /**
4369
- * Clear queued input with attributed per-entry traces
4370
- */
4371
- clearSessionInputs(options) {
4372
- return (options.client ?? this.client).delete({
4373
- responseStyle: "data",
4374
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/prompt/queue",
4375
- ...options,
4376
- });
4377
- }
4378
- /**
4379
- * List pending session input
4380
- */
4381
- listSessionInputs(options) {
4382
- return (options.client ?? this.client).get({
4383
- responseStyle: "data",
4384
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/prompt/queue",
4385
- ...options,
4386
- });
4387
- }
4388
- /**
4389
- * Cancel a queued session prompt entry
4390
- */
4391
- cancelQueuedSessionPrompt(options) {
4392
- return (options.client ?? this.client).delete({
4393
- responseStyle: "data",
4394
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/prompt/queue/{queue_entry_id}",
4395
- ...options,
4396
- });
4397
- }
4398
- /**
4399
- * Replace queued session input atomically
4400
- */
4401
- replaceSessionInput(options) {
4402
- return (options.client ?? this.client).put({
4403
- responseStyle: "data",
4404
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/prompt/queue/{queue_entry_id}",
4500
+ url: "/api/tasks/{id}/cancel",
4405
4501
  ...options,
4406
4502
  headers: {
4407
4503
  "Content-Type": "application/json",
@@ -4410,12 +4506,12 @@ export class sessions extends HeyApiClient {
4410
4506
  });
4411
4507
  }
4412
4508
  /**
4413
- * Promote queued session input to steering
4509
+ * Create one child task
4414
4510
  */
4415
- promoteSessionInput(options) {
4511
+ createChildTask(options) {
4416
4512
  return (options.client ?? this.client).post({
4417
4513
  responseStyle: "data",
4418
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/prompt/queue/{queue_entry_id}/steer",
4514
+ url: "/api/tasks/{id}/children",
4419
4515
  ...options,
4420
4516
  headers: {
4421
4517
  "Content-Type": "application/json",
@@ -4424,56 +4520,56 @@ export class sessions extends HeyApiClient {
4424
4520
  });
4425
4521
  }
4426
4522
  /**
4427
- * Get a deterministic session recap
4523
+ * Add one task dependency
4428
4524
  */
4429
- getSessionRecap(options) {
4430
- return (options.client ?? this.client).get({
4525
+ addTaskDependency(options) {
4526
+ return (options.client ?? this.client).post({
4431
4527
  responseStyle: "data",
4432
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/recap",
4528
+ url: "/api/tasks/{id}/dependencies",
4433
4529
  ...options,
4530
+ headers: {
4531
+ "Content-Type": "application/json",
4532
+ ...options.headers,
4533
+ },
4434
4534
  });
4435
4535
  }
4436
4536
  /**
4437
- * Inspect and repair an interrupted session transcript
4537
+ * Remove one task dependency
4438
4538
  */
4439
- repairSession(options) {
4440
- return (options.client ?? this.client).post({
4539
+ removeTaskDependency(options) {
4540
+ return (options.client ?? this.client).delete({
4441
4541
  responseStyle: "data",
4442
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/repair",
4542
+ url: "/api/tasks/{id}/dependencies/{depends_on_id}",
4443
4543
  ...options,
4444
4544
  });
4445
4545
  }
4446
4546
  /**
4447
- * Rewind a conversation before one durable user message
4547
+ * Delete one task execution profile
4448
4548
  */
4449
- rewindSessionConversation(options) {
4450
- return (options.client ?? this.client).post({
4549
+ deleteTaskExecutionProfile(options) {
4550
+ return (options.client ?? this.client).delete({
4451
4551
  responseStyle: "data",
4452
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/rewind",
4552
+ url: "/api/tasks/{id}/execution-profile",
4453
4553
  ...options,
4454
- headers: {
4455
- "Content-Type": "application/json",
4456
- ...options.headers,
4457
- },
4458
4554
  });
4459
4555
  }
4460
4556
  /**
4461
- * Clear the default runtime for future prompts
4557
+ * Get one task execution profile
4462
4558
  */
4463
- clearSessionRuntime(options) {
4464
- return (options.client ?? this.client).delete({
4559
+ getTaskExecutionProfile(options) {
4560
+ return (options.client ?? this.client).get({
4465
4561
  responseStyle: "data",
4466
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/runtime",
4562
+ url: "/api/tasks/{id}/execution-profile",
4467
4563
  ...options,
4468
4564
  });
4469
4565
  }
4470
4566
  /**
4471
- * Select the default runtime for future prompts
4567
+ * Replace one task execution profile
4472
4568
  */
4473
- setSessionRuntime(options) {
4569
+ setTaskExecutionProfile(options) {
4474
4570
  return (options.client ?? this.client).put({
4475
4571
  responseStyle: "data",
4476
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/runtime",
4572
+ url: "/api/tasks/{id}/execution-profile",
4477
4573
  ...options,
4478
4574
  headers: {
4479
4575
  "Content-Type": "application/json",
@@ -4482,12 +4578,12 @@ export class sessions extends HeyApiClient {
4482
4578
  });
4483
4579
  }
4484
4580
  /**
4485
- * Refresh an idle session's Soul snapshot through body-level CAS
4581
+ * Set one task worktree policy
4486
4582
  */
4487
- refreshSessionSoul(options) {
4488
- return (options.client ?? this.client).post({
4583
+ setTaskWorktreePolicy(options) {
4584
+ return (options.client ?? this.client).patch({
4489
4585
  responseStyle: "data",
4490
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/soul/refresh",
4586
+ url: "/api/tasks/{id}/execution-profile/worktree",
4491
4587
  ...options,
4492
4588
  headers: {
4493
4589
  "Content-Type": "application/json",
@@ -4496,22 +4592,22 @@ export class sessions extends HeyApiClient {
4496
4592
  });
4497
4593
  }
4498
4594
  /**
4499
- * Read compact session status and wake eligibility
4595
+ * Inspect one task with diagnostics
4500
4596
  */
4501
- getSessionStatus(options) {
4597
+ inspectTask(options) {
4502
4598
  return (options.client ?? this.client).get({
4503
4599
  responseStyle: "data",
4504
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/status",
4600
+ url: "/api/tasks/{id}/inspect",
4505
4601
  ...options,
4506
4602
  });
4507
4603
  }
4508
4604
  /**
4509
- * Stage steering input for the active session turn
4605
+ * Pause one task for future scheduler claims
4510
4606
  */
4511
- steerSessionPrompt(options) {
4607
+ pauseTask(options) {
4512
4608
  return (options.client ?? this.client).post({
4513
4609
  responseStyle: "data",
4514
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/steer",
4610
+ url: "/api/tasks/{id}/pause",
4515
4611
  ...options,
4516
4612
  headers: {
4517
4613
  "Content-Type": "application/json",
@@ -4520,12 +4616,12 @@ export class sessions extends HeyApiClient {
4520
4616
  });
4521
4617
  }
4522
4618
  /**
4523
- * Stop a session without deleting persisted history
4619
+ * Publish one draft task and enqueue executable work
4524
4620
  */
4525
- stopSession(options) {
4621
+ publishTask(options) {
4526
4622
  return (options.client ?? this.client).post({
4527
4623
  responseStyle: "data",
4528
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/stop",
4624
+ url: "/api/tasks/{id}/publish",
4529
4625
  ...options,
4530
4626
  headers: {
4531
4627
  "Content-Type": "application/json",
@@ -4534,32 +4630,36 @@ export class sessions extends HeyApiClient {
4534
4630
  });
4535
4631
  }
4536
4632
  /**
4537
- * List a session's subagents
4633
+ * Recover one task from needs_attention
4538
4634
  */
4539
- listSessionSubagents(options) {
4540
- return (options.client ?? this.client).get({
4635
+ recoverTask(options) {
4636
+ return (options.client ?? this.client).post({
4541
4637
  responseStyle: "data",
4542
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/subagents",
4638
+ url: "/api/tasks/{id}/recover",
4543
4639
  ...options,
4640
+ headers: {
4641
+ "Content-Type": "application/json",
4642
+ ...options.headers,
4643
+ },
4544
4644
  });
4545
4645
  }
4546
4646
  /**
4547
- * List session-callable registry tools
4647
+ * Reject one approval-gated task
4548
4648
  */
4549
- listSessionTools(options) {
4550
- return (options.client ?? this.client).get({
4649
+ rejectTask(options) {
4650
+ return (options.client ?? this.client).post({
4551
4651
  responseStyle: "data",
4552
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/tools",
4652
+ url: "/api/tasks/{id}/reject",
4553
4653
  ...options,
4554
4654
  });
4555
4655
  }
4556
4656
  /**
4557
- * Search session-callable registry tools
4657
+ * Resume one paused task for future scheduler claims
4558
4658
  */
4559
- searchSessionTools(options) {
4659
+ resumeTask(options) {
4560
4660
  return (options.client ?? this.client).post({
4561
4661
  responseStyle: "data",
4562
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/tools/search",
4662
+ url: "/api/tasks/{id}/resume",
4563
4663
  ...options,
4564
4664
  headers: {
4565
4665
  "Content-Type": "application/json",
@@ -4568,72 +4668,60 @@ export class sessions extends HeyApiClient {
4568
4668
  });
4569
4669
  }
4570
4670
  /**
4571
- * Get a bounded materialized transcript page
4572
- */
4573
- getSessionTranscript(options) {
4574
- return (options.client ?? this.client).get({
4575
- responseStyle: "data",
4576
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/transcript",
4577
- ...options,
4578
- });
4579
- }
4580
- /**
4581
- * Get the full retained operator-message trail with reply previews
4671
+ * List task-run reviews for one task
4582
4672
  */
4583
- getSessionTranscriptOutline(options) {
4673
+ listTaskReviews(options) {
4584
4674
  return (options.client ?? this.client).get({
4585
4675
  responseStyle: "data",
4586
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/transcript/outline",
4676
+ url: "/api/tasks/{id}/reviews",
4587
4677
  ...options,
4588
4678
  });
4589
4679
  }
4590
4680
  /**
4591
- * Search retained transcript messages with bounded literal matches
4681
+ * List runs for one task
4592
4682
  */
4593
- searchSessionTranscript(options) {
4683
+ listTaskRuns(options) {
4594
4684
  return (options.client ?? this.client).get({
4595
4685
  responseStyle: "data",
4596
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/transcript/search",
4686
+ url: "/api/tasks/{id}/runs",
4597
4687
  ...options,
4598
4688
  });
4599
4689
  }
4600
4690
  /**
4601
- * Restore an archived session
4691
+ * Enqueue one task run
4602
4692
  */
4603
- unarchiveSession(options) {
4693
+ enqueueTaskRun(options) {
4604
4694
  return (options.client ?? this.client).post({
4605
4695
  responseStyle: "data",
4606
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/unarchive",
4607
- ...options,
4608
- });
4609
- }
4610
- /**
4611
- * Get aggregated token usage for a session
4612
- */
4613
- getSessionUsage(options) {
4614
- return (options.client ?? this.client).get({
4615
- responseStyle: "data",
4616
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/usage",
4696
+ url: "/api/tasks/{id}/runs",
4617
4697
  ...options,
4698
+ headers: {
4699
+ "Content-Type": "application/json",
4700
+ ...options.headers,
4701
+ },
4618
4702
  });
4619
4703
  }
4620
4704
  /**
4621
- * Get per-turn session usage and native compaction markers
4705
+ * Enqueue designated sibling runs for one task
4622
4706
  */
4623
- getSessionUsageTurns(options) {
4624
- return (options.client ?? this.client).get({
4707
+ fanOutTaskRuns(options) {
4708
+ return (options.client ?? this.client).post({
4625
4709
  responseStyle: "data",
4626
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/usage/turns",
4710
+ url: "/api/tasks/{id}/runs/fan-out",
4627
4711
  ...options,
4712
+ headers: {
4713
+ "Content-Type": "application/json",
4714
+ ...options.headers,
4715
+ },
4628
4716
  });
4629
4717
  }
4630
4718
  /**
4631
- * Wait for a session state
4719
+ * Start one task by enqueueing executable work
4632
4720
  */
4633
- waitForSession(options) {
4721
+ startTask(options) {
4634
4722
  return (options.client ?? this.client).post({
4635
4723
  responseStyle: "data",
4636
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/wait",
4724
+ url: "/api/tasks/{id}/start",
4637
4725
  ...options,
4638
4726
  headers: {
4639
4727
  "Content-Type": "application/json",
@@ -4642,65 +4730,53 @@ export class sessions extends HeyApiClient {
4642
4730
  });
4643
4731
  }
4644
4732
  /**
4645
- * Return an idle session to the workspace root in place
4733
+ * Get one task timeline
4646
4734
  */
4647
- unbindSessionWorktree(options) {
4648
- return (options.client ?? this.client).delete({
4735
+ getTaskTimeline(options) {
4736
+ return (options.client ?? this.client).get({
4649
4737
  responseStyle: "data",
4650
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/worktree",
4738
+ url: "/api/tasks/{id}/timeline",
4651
4739
  ...options,
4652
4740
  });
4653
4741
  }
4654
4742
  /**
4655
- * Bind an idle existing session to a ready worktree in place
4743
+ * Get one task tree live view
4656
4744
  */
4657
- bindSessionWorktree(options) {
4658
- return (options.client ?? this.client).put({
4745
+ getTaskTree(options) {
4746
+ return (options.client ?? this.client).get({
4659
4747
  responseStyle: "data",
4660
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/worktree",
4748
+ url: "/api/tasks/{id}/tree",
4661
4749
  ...options,
4662
- headers: {
4663
- "Content-Type": "application/json",
4664
- ...options.headers,
4665
- },
4666
4750
  });
4667
4751
  }
4668
4752
  /**
4669
- * Fork a live session into a worktree
4753
+ * Archive one task inbox item
4670
4754
  */
4671
- forkSessionToWorktree(options) {
4755
+ archiveTask(options) {
4672
4756
  return (options.client ?? this.client).post({
4673
4757
  responseStyle: "data",
4674
- url: "/api/workspaces/{workspace_id}/sessions/{session_id}/worktree-fork",
4758
+ url: "/api/tasks/{id}/triage/archive",
4675
4759
  ...options,
4676
- headers: {
4677
- "Content-Type": "application/json",
4678
- ...options.headers,
4679
- },
4680
4760
  });
4681
4761
  }
4682
4762
  /**
4683
- * Read one subagent
4763
+ * Dismiss one task inbox item
4684
4764
  */
4685
- getSubagent(options) {
4686
- return (options.client ?? this.client).get({
4765
+ dismissTask(options) {
4766
+ return (options.client ?? this.client).post({
4687
4767
  responseStyle: "data",
4688
- url: "/api/workspaces/{workspace_id}/subagents/{subagent_id}",
4768
+ url: "/api/tasks/{id}/triage/dismiss",
4689
4769
  ...options,
4690
4770
  });
4691
4771
  }
4692
4772
  /**
4693
- * Cancel a delegated subagent
4773
+ * Mark one task inbox item as read
4694
4774
  */
4695
- cancelSubagent(options) {
4775
+ markTaskRead(options) {
4696
4776
  return (options.client ?? this.client).post({
4697
4777
  responseStyle: "data",
4698
- url: "/api/workspaces/{workspace_id}/subagents/{subagent_id}/cancel",
4778
+ url: "/api/tasks/{id}/triage/read",
4699
4779
  ...options,
4700
- headers: {
4701
- "Content-Type": "application/json",
4702
- ...options.headers,
4703
- },
4704
4780
  });
4705
4781
  }
4706
4782
  }
@@ -4841,6 +4917,96 @@ export class workspaces extends HeyApiClient {
4841
4917
  ...options,
4842
4918
  });
4843
4919
  }
4920
+ /**
4921
+ * Read the profile's workspace folders and manual workspace order
4922
+ */
4923
+ getWorkspaceLayout(options) {
4924
+ return (options?.client ?? this.client).get({
4925
+ responseStyle: "data",
4926
+ url: "/api/workspace-folders",
4927
+ ...options,
4928
+ });
4929
+ }
4930
+ /**
4931
+ * Create a root workspace folder
4932
+ */
4933
+ createWorkspaceFolder(options) {
4934
+ return (options.client ?? this.client).post({
4935
+ responseStyle: "data",
4936
+ url: "/api/workspace-folders",
4937
+ ...options,
4938
+ headers: {
4939
+ "Content-Type": "application/json",
4940
+ ...options.headers,
4941
+ },
4942
+ });
4943
+ }
4944
+ /**
4945
+ * Delete a workspace folder; its workspaces return to the root
4946
+ */
4947
+ deleteWorkspaceFolder(options) {
4948
+ return (options.client ?? this.client).delete({
4949
+ responseStyle: "data",
4950
+ url: "/api/workspace-folders/{folder_id}",
4951
+ ...options,
4952
+ });
4953
+ }
4954
+ /**
4955
+ * Rename a workspace folder
4956
+ */
4957
+ renameWorkspaceFolder(options) {
4958
+ return (options.client ?? this.client).patch({
4959
+ responseStyle: "data",
4960
+ url: "/api/workspace-folders/{folder_id}",
4961
+ ...options,
4962
+ headers: {
4963
+ "Content-Type": "application/json",
4964
+ ...options.headers,
4965
+ },
4966
+ });
4967
+ }
4968
+ /**
4969
+ * Set the complete workspace folder order
4970
+ */
4971
+ reorderWorkspaceFolders(options) {
4972
+ return (options.client ?? this.client).put({
4973
+ responseStyle: "data",
4974
+ url: "/api/workspace-order/folders",
4975
+ ...options,
4976
+ headers: {
4977
+ "Content-Type": "application/json",
4978
+ ...options.headers,
4979
+ },
4980
+ });
4981
+ }
4982
+ /**
4983
+ * Move a workspace into a folder or back to the root
4984
+ */
4985
+ moveWorkspace(options) {
4986
+ return (options.client ?? this.client).post({
4987
+ responseStyle: "data",
4988
+ url: "/api/workspace-order/move",
4989
+ ...options,
4990
+ headers: {
4991
+ "Content-Type": "application/json",
4992
+ ...options.headers,
4993
+ },
4994
+ });
4995
+ }
4996
+ /**
4997
+ * Set the manual workspace order in a folder or the root
4998
+ */
4999
+ reorderWorkspaces(options) {
5000
+ return (options.client ?? this.client).put({
5001
+ responseStyle: "data",
5002
+ url: "/api/workspace-order/workspaces",
5003
+ ...options,
5004
+ headers: {
5005
+ "Content-Type": "application/json",
5006
+ ...options.headers,
5007
+ },
5008
+ });
5009
+ }
4844
5010
  /**
4845
5011
  * List active or archived workspaces
4846
5012
  */
@@ -5732,6 +5898,10 @@ export class Compozy extends HeyApiClient {
5732
5898
  get openai() {
5733
5899
  return (this._openai ??= new openai({ client: this.client }));
5734
5900
  }
5901
+ _sessions;
5902
+ get sessions() {
5903
+ return (this._sessions ??= new sessions({ client: this.client }));
5904
+ }
5735
5905
  _profiles;
5736
5906
  get profiles() {
5737
5907
  return (this._profiles ??= new profiles({ client: this.client }));
@@ -5748,10 +5918,6 @@ export class Compozy extends HeyApiClient {
5748
5918
  get tasks() {
5749
5919
  return (this._tasks ??= new tasks({ client: this.client }));
5750
5920
  }
5751
- _sessions;
5752
- get sessions() {
5753
- return (this._sessions ??= new sessions({ client: this.client }));
5754
- }
5755
5921
  _skills;
5756
5922
  get skills() {
5757
5923
  return (this._skills ??= new skills({ client: this.client }));