@raisindb/client 0.5.7 → 0.5.9

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.
@@ -215,6 +215,15 @@ declare enum RequestType {
215
215
  FlowCancel = "flow_cancel",
216
216
  FlowSubscribeEvents = "flow_subscribe_events",
217
217
  FlowUnsubscribeEvents = "flow_unsubscribe_events",
218
+ AgentRunCreate = "agent_run_create",
219
+ AgentRunGet = "agent_run_get",
220
+ AgentRunBySubject = "agent_run_by_subject",
221
+ AgentRunList = "agent_run_list",
222
+ AgentRunEvents = "agent_run_events",
223
+ AgentRunSubscribe = "agent_run_subscribe",
224
+ AgentRunUnsubscribe = "agent_run_unsubscribe",
225
+ AgentRunControl = "agent_run_control",
226
+ AgentRunChildren = "agent_run_children",
218
227
  FunctionInvoke = "function_invoke",
219
228
  FunctionInvokeSync = "function_invoke_sync",
220
229
  ScheduledInvocationCreate = "scheduled_invocation_create",
@@ -3022,6 +3031,617 @@ declare function readTokensFromFragment(hashOrUrl: string): {
3022
3031
  refreshToken: string | null;
3023
3032
  } | null;
3024
3033
 
3034
+ /**
3035
+ * Child runs, the durable mailbox, structured checkpoints and usage
3036
+ * accounting — the wire types of `/api/agent-runs/{repo}/{run}/children…`.
3037
+ *
3038
+ * A child is an ordinary durable run with a typed objective. Its terminal
3039
+ * hand-back lands in the parent's mailbox (and completes any tool or wait
3040
+ * parked on it); nothing polls a transient result.
3041
+ */
3042
+ /** What context a child starts with. */
3043
+ type ChildContext = {
3044
+ mode: 'none';
3045
+ } | {
3046
+ mode: 'recent_turns';
3047
+ turns: number;
3048
+ items?: unknown[];
3049
+ } | {
3050
+ mode: 'snapshot';
3051
+ checkpoint_no?: number;
3052
+ data?: unknown;
3053
+ };
3054
+ /** The typed objective of a child. */
3055
+ interface ChildObjective {
3056
+ title: string;
3057
+ instructions?: string;
3058
+ context?: ChildContext;
3059
+ /** Tool function paths (`*` suffix = prefix); empty = unrestricted. */
3060
+ allowed_tools?: string[];
3061
+ /** Write roots `{workspace, path, ops?}`, narrowed to the parent's grant. */
3062
+ allowed_writes?: Array<{
3063
+ workspace: string;
3064
+ path?: string;
3065
+ ops?: string[];
3066
+ }>;
3067
+ expected_artifacts?: Array<{
3068
+ kind: string;
3069
+ locator?: unknown;
3070
+ description?: string;
3071
+ required?: boolean;
3072
+ }>;
3073
+ acceptance_checks?: Array<{
3074
+ id: string;
3075
+ description?: string;
3076
+ check?: unknown;
3077
+ required?: boolean;
3078
+ }>;
3079
+ hand_back?: {
3080
+ required_fields?: string[];
3081
+ schema?: unknown;
3082
+ description?: string;
3083
+ };
3084
+ }
3085
+ /** Spawn options. */
3086
+ interface SpawnChildOptions {
3087
+ objective: ChildObjective;
3088
+ budgets?: Record<string, unknown>;
3089
+ /** Default `fail`: a child paused on budget would stall its parent. */
3090
+ onExceeded?: 'pause' | 'fail';
3091
+ /** Idempotency key: a retry returns the same child. */
3092
+ spawnKey?: string;
3093
+ subject?: {
3094
+ workspace: string;
3095
+ path: string;
3096
+ node_id?: string;
3097
+ };
3098
+ asAgent?: string;
3099
+ agentRef?: string;
3100
+ input?: unknown;
3101
+ executorConfig?: Record<string, unknown>;
3102
+ /** Server-driven child: its reducer function (any language). */
3103
+ reducer?: {
3104
+ function_path: string;
3105
+ handler?: string;
3106
+ };
3107
+ /** Server-driven child on the parent's own reducer. */
3108
+ inheritReducer?: boolean;
3109
+ branch?: string;
3110
+ }
3111
+ /** The answer to a spawn. */
3112
+ interface SpawnChildResult {
3113
+ child_run_id: string;
3114
+ child_no: number;
3115
+ created: boolean;
3116
+ budgets: Record<string, unknown>;
3117
+ /** Resume key a tool answers `waiting` with to wait for the child. */
3118
+ resume_key: string;
3119
+ }
3120
+ /** What a parent does to a child. */
3121
+ type ChildAction = {
3122
+ action: 'message';
3123
+ message: unknown;
3124
+ } | {
3125
+ action: 'steer';
3126
+ input: unknown;
3127
+ } | {
3128
+ action: 'interrupt';
3129
+ mode?: 'stop' | 'pause';
3130
+ reason?: string;
3131
+ } | {
3132
+ action: 'resume';
3133
+ };
3134
+ /** One mailbox item with its payload (a hand-back envelope or a message). */
3135
+ interface MailboxEntry {
3136
+ item: {
3137
+ mail_no: number;
3138
+ kind: 'completion' | 'message';
3139
+ from_run: string;
3140
+ seq: number;
3141
+ result_key: string;
3142
+ status?: string;
3143
+ };
3144
+ payload: unknown;
3145
+ }
3146
+ /** A structured checkpoint write (compaction). */
3147
+ interface CheckpointOptions {
3148
+ fence?: {
3149
+ owner: string;
3150
+ epoch: number;
3151
+ };
3152
+ /** The in-flight operation doing the compaction (instead of a fence). */
3153
+ operationId?: string;
3154
+ reason?: 'compaction' | 'pause' | 'periodic' | 'before_terminal' | 'domain_requested' | 'delegation';
3155
+ summary?: string;
3156
+ transcriptCutoff?: {
3157
+ workspace: string;
3158
+ path: string;
3159
+ node_id?: string;
3160
+ };
3161
+ /** Objective, constraints, decisions, pending questions, … */
3162
+ state?: unknown;
3163
+ largeRefs?: Array<{
3164
+ key: string;
3165
+ bytes: number;
3166
+ content_type: string;
3167
+ }>;
3168
+ }
3169
+
3170
+ /**
3171
+ * Durable agent runs over HTTP.
3172
+ *
3173
+ * A run is a server-side, crash-safe execution of an agent: a monotonic event
3174
+ * log, a lifecycle (`queued → running → waiting/paused → completed/failed/
3175
+ * stopped`), and atomic, idempotent controls (stop, pause, resume, steer,
3176
+ * approve, answer). Two ways to drive one:
3177
+ *
3178
+ * - **server-driven** — create it with a `reducer` (any function, in any
3179
+ * supported language); the server's job queue drives it and you watch it
3180
+ * with {@link AgentRunsApi.stream};
3181
+ * - **client-driven** — create it without a reducer and drive it yourself with
3182
+ * the lease calls ({@link AgentRunsApi.acquire}, {@link AgentRunsApi.begin},
3183
+ * {@link AgentRunsApi.finish}, ...). Your operations are still durable and
3184
+ * fenced, and anyone authorized can still stop or steer the run.
3185
+ */
3186
+
3187
+ /** Where a run lives, what it is about, and what it runs as. */
3188
+ interface CreateAgentRunOptions {
3189
+ /** What the run is about (one live run per subject). */
3190
+ subject: {
3191
+ workspace: string;
3192
+ path: string;
3193
+ node_id?: string | null;
3194
+ };
3195
+ /** Branch (default "main"). */
3196
+ branch?: string;
3197
+ /** Opaque agent reference, e.g. an agent node path. */
3198
+ agentRef?: string;
3199
+ /** Idempotency key for the create (a retried create returns the same run). */
3200
+ createKey?: string;
3201
+ /** Limits; exceeding one pauses (default) or fails the run. */
3202
+ budgets?: Record<string, unknown>;
3203
+ /** Input, delivered to the reducer as `run_started.data.input`. */
3204
+ input?: unknown;
3205
+ /** Server-driven: the reducer function. Omit for a client-driven run. */
3206
+ reducer?: {
3207
+ function_path: string;
3208
+ handler?: string;
3209
+ };
3210
+ /** Opaque executor configuration (e.g. `model_turn_function`). */
3211
+ executorConfig?: Record<string, unknown>;
3212
+ /** A secret whose holder may control the run. */
3213
+ controlCapability?: string;
3214
+ /** Run as this agent (`"ws:/path"` or `"/path"`), on your behalf. */
3215
+ asAgent?: string;
3216
+ }
3217
+ /** The answer to a create. */
3218
+ interface CreateAgentRunResult {
3219
+ run_id: string;
3220
+ /** False when the subject's live run (or the create key's run) came back. */
3221
+ created: boolean;
3222
+ status: AgentRunStatus;
3223
+ }
3224
+ type AgentRunStatus = 'queued' | 'running' | 'waiting' | 'paused' | 'cancelling' | 'completed' | 'failed' | 'stopped';
3225
+ /** A run as a reader sees it. */
3226
+ interface AgentRunView {
3227
+ run: Record<string, unknown> & {
3228
+ run_id: string;
3229
+ last_seq: number;
3230
+ };
3231
+ status: AgentRunStatus;
3232
+ /** The plan to display, already overridden by the run status. */
3233
+ projection: {
3234
+ items?: Array<{
3235
+ key: string;
3236
+ title: string;
3237
+ status: string;
3238
+ }>;
3239
+ summary?: string;
3240
+ } | null;
3241
+ }
3242
+ /** One durable event (`seq` is contiguous from 1). */
3243
+ interface AgentRunEvent {
3244
+ run_id: string;
3245
+ seq: number;
3246
+ at_ms: number;
3247
+ turn?: number | null;
3248
+ op_id?: string | null;
3249
+ kind: {
3250
+ type: string;
3251
+ [key: string]: unknown;
3252
+ };
3253
+ }
3254
+ /** The answer to a control. */
3255
+ type AgentRunControlAck = {
3256
+ ack: 'applied';
3257
+ seq: number;
3258
+ } | {
3259
+ ack: 'duplicate';
3260
+ original_seq: number;
3261
+ } | {
3262
+ ack: 'rejected';
3263
+ reason: string;
3264
+ seq: number;
3265
+ };
3266
+ /** A control command, as the server's contract spells it. */
3267
+ type AgentRunCommand = {
3268
+ command: 'stop';
3269
+ reason?: string;
3270
+ } | {
3271
+ command: 'pause';
3272
+ } | {
3273
+ command: 'resume';
3274
+ budget_increase?: Record<string, unknown>;
3275
+ accept_reducer_change?: boolean;
3276
+ } | {
3277
+ command: 'steer';
3278
+ input: unknown;
3279
+ } | {
3280
+ command: 'approve';
3281
+ request_id: string;
3282
+ decision: {
3283
+ decision: 'approve';
3284
+ } | {
3285
+ decision: 'reject';
3286
+ reason?: string;
3287
+ };
3288
+ subject_digest: string;
3289
+ } | {
3290
+ command: 'provide_input';
3291
+ request_id: string;
3292
+ value: unknown;
3293
+ };
3294
+ /** A lease held by a client driver; present it on every driver call. */
3295
+ interface AgentRunFence {
3296
+ owner: string;
3297
+ epoch: number;
3298
+ }
3299
+ /** Begin an operation (client-driven runs). */
3300
+ interface BeginOperationOptions {
3301
+ kind: 'model_turn' | 'tool_call' | 'compaction' | string;
3302
+ input?: unknown;
3303
+ replay_safe?: boolean;
3304
+ non_interruptible?: boolean;
3305
+ for_call_id?: string;
3306
+ answers?: string[];
3307
+ }
3308
+ /** Finish an operation (client-driven runs). */
3309
+ interface FinishOperationOptions {
3310
+ outcome: 'succeeded' | 'waiting' | 'retryable' | 'blocked' | 'failed' | 'cancelled';
3311
+ payload?: unknown;
3312
+ tool_calls?: string[];
3313
+ usage?: {
3314
+ input_tokens: number;
3315
+ output_tokens: number;
3316
+ };
3317
+ resume_key?: string;
3318
+ }
3319
+ /** How the API reaches the server (supplied by the HTTP client). */
3320
+ interface AgentRunsTransport {
3321
+ request<T>(method: string, path: string, body?: unknown): Promise<T>;
3322
+ /** Absolute URL for `path`. */
3323
+ url(path: string): string;
3324
+ /** Headers for a raw fetch (auth, tenant). */
3325
+ headers(): Record<string, string>;
3326
+ fetch: typeof fetch;
3327
+ }
3328
+ /** What a run is about: `{workspace, path, node_id?}` or `"workspace:/path"`. */
3329
+ type AgentRunSubject = {
3330
+ workspace: string;
3331
+ path?: string;
3332
+ node_id?: string | null;
3333
+ } | string;
3334
+ /** `"ws:/path"` → `{workspace, path}`. */
3335
+ declare function subjectOf(subject: AgentRunSubject): {
3336
+ workspace: string;
3337
+ path?: string;
3338
+ node_id?: string | null;
3339
+ };
3340
+ /** A fresh control id (controls are idempotent per id; retry with the SAME id). */
3341
+ declare function newControlId(prefix?: string): string;
3342
+ declare class AgentRunsApi {
3343
+ private repository;
3344
+ private transport;
3345
+ constructor(repository: string, transport: AgentRunsTransport);
3346
+ private base;
3347
+ /** Create a run, or get back the subject's live run. */
3348
+ create(options: CreateAgentRunOptions): Promise<CreateAgentRunResult>;
3349
+ /** Every run about `subject` you may see, newest (the live one) first. */
3350
+ bySubject(subject: AgentRunSubject, limit?: number): Promise<AgentRunView[]>;
3351
+ /** Read a run (record + effective projection). */
3352
+ get(runId: string): Promise<AgentRunView>;
3353
+ /** Your runs in one status (default "running"). */
3354
+ list(status?: AgentRunStatus, limit?: number): Promise<AgentRunView[]>;
3355
+ /** Durable events after `afterSeq` (gap-free; page with the last seq). */
3356
+ events(runId: string, afterSeq?: number, limit?: number): Promise<AgentRunEvent[]>;
3357
+ /** Any control. Retrying with the same `controlId` is a no-op. */
3358
+ control(runId: string, command: AgentRunCommand, controlId?: string, capability?: string): Promise<AgentRunControlAck>;
3359
+ stop(runId: string, reason?: string, controlId?: string): Promise<AgentRunControlAck>;
3360
+ pause(runId: string, controlId?: string): Promise<AgentRunControlAck>;
3361
+ resume(runId: string, controlId?: string): Promise<AgentRunControlAck>;
3362
+ /** Queue input for the run's next safe boundary. */
3363
+ steer(runId: string, input: unknown, controlId?: string): Promise<AgentRunControlAck>;
3364
+ /** Decide an approval request; the digest ties it to one changeset. */
3365
+ approve(runId: string, requestId: string, subjectDigest: string, reject?: {
3366
+ reason?: string;
3367
+ }, controlId?: string): Promise<AgentRunControlAck>;
3368
+ /** Answer an input request. */
3369
+ answer(runId: string, requestId: string, value: unknown, controlId?: string): Promise<AgentRunControlAck>;
3370
+ /**
3371
+ * Stream the run's events: replay after `afterSeq`, then live. Ends after
3372
+ * the run's terminal event. Resume after a disconnect with the last `seq`.
3373
+ */
3374
+ stream(runId: string, afterSeq?: number, signal?: AbortSignal): AsyncGenerator<AgentRunEvent>;
3375
+ /** Take the lease of a queued client-driven run. */
3376
+ acquire(runId: string): Promise<AgentRunFence>;
3377
+ renew(runId: string, fence: AgentRunFence): Promise<AgentRunStatus>;
3378
+ release(runId: string, fence: AgentRunFence): Promise<AgentRunStatus>;
3379
+ /** Begin an operation; returns the active operation (its `op_id`). */
3380
+ begin(runId: string, fence: AgentRunFence, op: BeginOperationOptions): Promise<{
3381
+ op_id: string;
3382
+ } & Record<string, unknown>>;
3383
+ /** Record an operation's result. */
3384
+ finish(runId: string, fence: AgentRunFence, opId: string, result: FinishOperationOptions): Promise<AgentRunStatus>;
3385
+ /** Open approval/input requests and wait (`kind: "approval" | "input"`). */
3386
+ wait(runId: string, fence: AgentRunFence, requests: Array<Record<string, unknown>>): Promise<AgentRunStatus>;
3387
+ /** End a client-driven run. */
3388
+ complete(runId: string, fence: AgentRunFence, status: 'completed' | 'failed', outcome: {
3389
+ kind: string;
3390
+ code?: string;
3391
+ message?: string;
3392
+ detail?: unknown;
3393
+ }): Promise<AgentRunStatus>;
3394
+ /** Spawn a child with a typed objective; its budgets come out of this run's. */
3395
+ spawnChild(runId: string, options: SpawnChildOptions): Promise<SpawnChildResult>;
3396
+ /** Every child of a run: the parent's link plus the child's live status. */
3397
+ children(runId: string): Promise<Array<{
3398
+ link: Record<string, unknown>;
3399
+ status?: AgentRunStatus;
3400
+ usage?: unknown;
3401
+ }>>;
3402
+ /** Inspect one child: record, events after `afterSeq`, usage, checkpoint. */
3403
+ inspectChild(runId: string, childId: string, afterSeq?: number, limit?: number): Promise<Record<string, unknown>>;
3404
+ /** Message, steer, interrupt or resume a child (idempotent per `controlId`). */
3405
+ controlChild(runId: string, childId: string, action: ChildAction, controlId?: string): Promise<AgentRunControlAck>;
3406
+ messageChild(runId: string, childId: string, message: unknown, controlId?: string): Promise<AgentRunControlAck>;
3407
+ steerChild(runId: string, childId: string, input: unknown, controlId?: string): Promise<AgentRunControlAck>;
3408
+ interruptChild(runId: string, childId: string, reason?: string, mode?: 'stop' | 'pause', controlId?: string): Promise<AgentRunControlAck>;
3409
+ /** A client-driven parent waits (under its lease) for a child's hand-back. */
3410
+ waitChild(runId: string, childId: string, fence: AgentRunFence, expiresAtMs?: number): Promise<AgentRunStatus>;
3411
+ /** Unacknowledged mailbox items (hand-backs and child messages). */
3412
+ mailbox(runId: string): Promise<MailboxEntry[]>;
3413
+ /** Acknowledge mailbox items up to `upTo`. */
3414
+ ackMailbox(runId: string, upTo: number): Promise<{
3415
+ remaining: number;
3416
+ }>;
3417
+ /** A child posts a message to its parent's mailbox (idempotent per id). */
3418
+ postToParent(runId: string, messageId: string, message: unknown): Promise<{
3419
+ mail_no: number;
3420
+ }>;
3421
+ /** Write a structured checkpoint (compaction keeps state, not prose). */
3422
+ checkpoint(runId: string, options: CheckpointOptions): Promise<Record<string, unknown>>;
3423
+ /** Read a checkpoint (default: latest) with its structured state. */
3424
+ readCheckpoint(runId: string, checkpointNo?: number): Promise<{
3425
+ checkpoint: Record<string, unknown>;
3426
+ state: unknown;
3427
+ }>;
3428
+ /** Usage accounting: own, children, reserved, spare. */
3429
+ usage(runId: string): Promise<Record<string, unknown>>;
3430
+ }
3431
+
3432
+ /**
3433
+ * The node-development surface over HTTP: RaisinDB's hierarchy as a
3434
+ * structured workspace a client — or an agent — can develop in safely.
3435
+ *
3436
+ * - **Locators** name a node as `{repository, branch, workspace, path,
3437
+ * node_id, revision}`; the id is identity across moves, the revision is
3438
+ * what you saw.
3439
+ * - **Roots** bound every call: a path outside them (including a `..` climb)
3440
+ * is refused, and a root can restrict the operations allowed inside it.
3441
+ * - **Changesets** are atomic: {@link NodeDevApi.dryRun} plans,
3442
+ * {@link NodeDevApi.propose} stores a reviewable record with a digest,
3443
+ * {@link NodeDevApi.commit} applies it (optionally bound to the approved
3444
+ * digest), and {@link NodeDevApi.apply} does both. A stale
3445
+ * `expected_revision` comes back as a `conflict` result — nothing is
3446
+ * written — and an `idempotency_key` makes a retry return the first receipt.
3447
+ * - **Branches** are worktrees: fork, diff, merge (conflicts reported, never
3448
+ * guessed), discard.
3449
+ */
3450
+ /** A subtree of one workspace, and the operations allowed inside it. */
3451
+ interface WorkRoot {
3452
+ workspace: string;
3453
+ /** Absolute subtree path (default `/`). */
3454
+ path?: string;
3455
+ /** Allowed operations (default: all). */
3456
+ ops?: Array<'read' | 'create' | 'update' | 'delete' | 'move' | 'copy'>;
3457
+ }
3458
+ /** A node revision under a named scheme. */
3459
+ interface NodeRevision {
3460
+ value: string;
3461
+ alg: string;
3462
+ }
3463
+ /** A canonical locator. */
3464
+ interface NodeLocator {
3465
+ repository: string;
3466
+ branch: string;
3467
+ workspace: string;
3468
+ path: string;
3469
+ node_id?: string;
3470
+ revision?: NodeRevision;
3471
+ }
3472
+ /** A path (relative to the first root, or absolute), or `{ path?, node_id?, workspace? }`. */
3473
+ type NodeTarget = string | {
3474
+ workspace?: string;
3475
+ path?: string;
3476
+ node_id?: string;
3477
+ };
3478
+ /** One changeset operation. */
3479
+ type ChangeOp = {
3480
+ op: 'create';
3481
+ path: string;
3482
+ node_type: string;
3483
+ workspace?: string;
3484
+ archetype?: string;
3485
+ properties?: Record<string, unknown>;
3486
+ } | {
3487
+ op: 'patch';
3488
+ target: NodeTarget;
3489
+ expected_revision?: string | NodeRevision;
3490
+ set?: Record<string, unknown>;
3491
+ unset?: string[];
3492
+ archetype?: string;
3493
+ } | {
3494
+ op: 'move';
3495
+ target: NodeTarget;
3496
+ to_parent: NodeTarget;
3497
+ new_name?: string;
3498
+ expected_revision?: string | NodeRevision;
3499
+ } | {
3500
+ op: 'rename';
3501
+ target: NodeTarget;
3502
+ new_name: string;
3503
+ expected_revision?: string | NodeRevision;
3504
+ } | {
3505
+ op: 'copy';
3506
+ source: NodeTarget;
3507
+ to_parent: NodeTarget;
3508
+ new_name?: string;
3509
+ } | {
3510
+ op: 'delete';
3511
+ target: NodeTarget;
3512
+ expected_revision?: string | NodeRevision;
3513
+ recursive?: boolean;
3514
+ };
3515
+ /** Fields every call accepts. */
3516
+ interface NodeDevCommon {
3517
+ /** The working roots (or `workspace` for a whole workspace). */
3518
+ roots?: WorkRoot[];
3519
+ workspace?: string;
3520
+ /** Branch (default `main`). */
3521
+ branch?: string;
3522
+ /** Return a `raisin.tool-result/1` envelope instead of the typed result. */
3523
+ envelope?: boolean;
3524
+ }
3525
+ /** A changeset request. */
3526
+ interface ChangesetOptions extends NodeDevCommon {
3527
+ ops: ChangeOp[];
3528
+ idempotencyKey?: string;
3529
+ message?: string;
3530
+ /** Index of the op whose node is the primary artifact. */
3531
+ primary?: number;
3532
+ /** Artifact kind reported in tool results. */
3533
+ kind?: string;
3534
+ }
3535
+ /** Why an op cannot commit as reviewed. */
3536
+ interface NodeDevConflict {
3537
+ index: number;
3538
+ code: string;
3539
+ message: string;
3540
+ expected?: string;
3541
+ actual?: NodeLocator;
3542
+ }
3543
+ /** One op's committed effect. */
3544
+ interface OpReceipt {
3545
+ index: number;
3546
+ action: 'created' | 'updated' | 'moved' | 'copied' | 'deleted';
3547
+ old?: NodeLocator;
3548
+ new?: NodeLocator;
3549
+ changed_properties?: string[];
3550
+ created_descendants?: NodeLocator[];
3551
+ deleted_descendants?: NodeLocator[];
3552
+ moved_descendants?: Array<{
3553
+ from_path: string;
3554
+ to: NodeLocator;
3555
+ }>;
3556
+ rewritten_references?: Array<{
3557
+ workspace: string;
3558
+ node_id: string;
3559
+ path?: string;
3560
+ property: string;
3561
+ target_id: string;
3562
+ }>;
3563
+ }
3564
+ /** Exactly what committed. */
3565
+ interface Receipt {
3566
+ changeset_id: string;
3567
+ repository: string;
3568
+ branch: string;
3569
+ committed_revision?: string;
3570
+ ops: OpReceipt[];
3571
+ replayed: boolean;
3572
+ }
3573
+ /** The outcome of a commit or apply. */
3574
+ type CommitOutcome = {
3575
+ result: 'committed';
3576
+ receipt: Receipt;
3577
+ } | {
3578
+ result: 'conflict';
3579
+ changeset_id: string;
3580
+ conflicts: NodeDevConflict[];
3581
+ digest: string;
3582
+ };
3583
+ /** How requests reach the server (the HTTP client provides it). */
3584
+ interface NodeDevTransport {
3585
+ request<T>(method: string, path: string, body?: unknown): Promise<T>;
3586
+ }
3587
+ /** The node-development surface of one repository. */
3588
+ declare class NodeDevApi {
3589
+ private readonly repository;
3590
+ private readonly transport;
3591
+ constructor(repository: string, transport: NodeDevTransport);
3592
+ /** Call any method by name (the typed helpers below all use this). */
3593
+ call<T = unknown>(method: string, request: Record<string, unknown>): Promise<T>;
3594
+ private changeset;
3595
+ stat(target: NodeTarget, o?: NodeDevCommon): Promise<unknown>;
3596
+ read(target: NodeTarget, o?: NodeDevCommon & {
3597
+ keys?: string[];
3598
+ }): Promise<unknown>;
3599
+ list(target?: NodeTarget, o?: NodeDevCommon & {
3600
+ limit?: number;
3601
+ }): Promise<unknown>;
3602
+ diff(target: NodeTarget, from: {
3603
+ branch?: string;
3604
+ revision?: string;
3605
+ }, to: {
3606
+ branch?: string;
3607
+ revision?: string;
3608
+ }, o?: NodeDevCommon): Promise<unknown>;
3609
+ /** Changes inside the roots after `since` (a cursor from a previous call). */
3610
+ watch(since?: string, o?: NodeDevCommon & {
3611
+ limit?: number;
3612
+ }): Promise<{
3613
+ changes: unknown[];
3614
+ cursor?: string;
3615
+ }>;
3616
+ dryRun(o: ChangesetOptions): Promise<unknown>;
3617
+ propose(o: ChangesetOptions): Promise<{
3618
+ changeset: {
3619
+ changeset_id: string;
3620
+ plan: {
3621
+ digest: string;
3622
+ };
3623
+ };
3624
+ created: boolean;
3625
+ }>;
3626
+ getChangeset(changesetId: string, o?: NodeDevCommon): Promise<unknown>;
3627
+ listChangesets(o?: NodeDevCommon & {
3628
+ status?: 'proposed' | 'committed' | 'discarded';
3629
+ limit?: number;
3630
+ }): Promise<unknown>;
3631
+ /** Commit; pass the reviewed digest to bind the commit to that approval. */
3632
+ commit(changesetId: string, expectedDigest?: string, o?: NodeDevCommon): Promise<CommitOutcome>;
3633
+ discard(changesetId: string, o?: NodeDevCommon): Promise<unknown>;
3634
+ /** Propose and commit in one call. */
3635
+ apply(o: ChangesetOptions): Promise<CommitOutcome>;
3636
+ forkBranch(name: string, o?: NodeDevCommon): Promise<unknown>;
3637
+ diffBranch(base?: string, o?: NodeDevCommon): Promise<unknown>;
3638
+ mergeBranch(target: string, o?: NodeDevCommon & {
3639
+ dryRun?: boolean;
3640
+ message?: string;
3641
+ }): Promise<unknown>;
3642
+ discardBranch(o?: NodeDevCommon): Promise<unknown>;
3643
+ }
3644
+
3025
3645
  /**
3026
3646
  * RaisinDB HTTP client for server-side rendering (SSR)
3027
3647
  *
@@ -3484,6 +4104,17 @@ declare class RaisinHttpClient extends EventEmitter {
3484
4104
  * @param input - Input data passed to the function
3485
4105
  * @returns Execution ID and job ID for tracking
3486
4106
  */
4107
+ /**
4108
+ * Durable agent runs of `repository`: create, read, control, stream, and
4109
+ * drive them directly (see {@link AgentRunsApi}).
4110
+ */
4111
+ agentRuns(repository: string): AgentRunsApi;
4112
+ /**
4113
+ * The node-development surface of `repository`: typed reads, atomic
4114
+ * changesets with review and idempotency, branch worktrees (see
4115
+ * {@link NodeDevApi}).
4116
+ */
4117
+ nodeDev(repository: string): NodeDevApi;
3487
4118
  invokeFunction(repository: string, functionName: string, input?: Record<string, unknown>, options?: FunctionInvokeOptions): Promise<FunctionInvokeResponse>;
3488
4119
  /**
3489
4120
  * Invoke a server-side function synchronously.
@@ -3597,6 +4228,10 @@ declare class HttpDatabase {
3597
4228
  /**
3598
4229
  * Get FunctionsApi for invoking server-side functions via HTTP
3599
4230
  */
4231
+ /** Durable agent runs of this repository. */
4232
+ agentRuns(): AgentRunsApi;
4233
+ /** The node-development surface of this repository. */
4234
+ nodeDev(): NodeDevApi;
3600
4235
  functions(): HttpFunctionsApi;
3601
4236
  /**
3602
4237
  * The retrieval implementation behind {@link search} and {@link ask}.
@@ -4656,6 +5291,101 @@ declare class FlowsApi {
4656
5291
  }>;
4657
5292
  }
4658
5293
 
5294
+ /**
5295
+ * Durable agent runs over the WebSocket connection you already hold.
5296
+ *
5297
+ * The same contract as {@link AgentRunsApi} (HTTP), without a second
5298
+ * transport: find the run of a conversation, follow it live, control it and
5299
+ * read its children. `subscribe` is gap-free and resumable — it replays the
5300
+ * durable log after `afterSeq`, then follows it, delivering every event once
5301
+ * and in `seq` order even across a reconnect (pass the last `seq` you saw).
5302
+ *
5303
+ * ```ts
5304
+ * const runs = db.runs();
5305
+ * const [live] = await runs.bySubject('ai:/agents/builder/inbox/chats/c1');
5306
+ * const sub = await runs.subscribe(live.run.run_id, { afterSeq: 0 });
5307
+ * for await (const ev of sub) console.log(ev.seq, ev.kind.type);
5308
+ * await runs.stop(live.run.run_id, 'user asked');
5309
+ * ```
5310
+ */
5311
+
5312
+ type SendRequest = (payload: unknown, requestType: string, context?: RequestContext) => Promise<unknown>;
5313
+ /** A child as its parent lists it. */
5314
+ interface AgentRunChildView {
5315
+ link: Record<string, unknown> & {
5316
+ run_id: string;
5317
+ child_no: number;
5318
+ };
5319
+ status: AgentRunStatus | null;
5320
+ usage: Record<string, unknown> | null;
5321
+ }
5322
+ /** Options of {@link AgentRunsWsApi.subscribe}. */
5323
+ interface AgentRunSubscribeOptions {
5324
+ /** Replay events after this seq (0 = from the start). */
5325
+ afterSeq?: number;
5326
+ /** Called for every event, in seq order (in addition to iteration). */
5327
+ onEvent?: (event: AgentRunEvent) => void;
5328
+ /** Called once when the run ended and its log is complete. */
5329
+ onEnd?: (lastSeq: number) => void;
5330
+ /** Stop following. */
5331
+ signal?: AbortSignal;
5332
+ }
5333
+ /** A live subscription: iterate it, or use the callbacks. */
5334
+ interface AgentRunSubscription extends AsyncIterable<AgentRunEvent> {
5335
+ /** The last seq delivered (resume from it after a reconnect). */
5336
+ readonly lastSeq: number;
5337
+ /** Resolves when the run ended or the subscription was closed. */
5338
+ readonly done: Promise<void>;
5339
+ /** Stop following. */
5340
+ unsubscribe(): Promise<void>;
5341
+ }
5342
+ declare class AgentRunsWsApi {
5343
+ private context;
5344
+ private sendRequest;
5345
+ private eventHandler;
5346
+ constructor(context: RequestContext, sendRequest: SendRequest, eventHandler: EventHandler);
5347
+ private call;
5348
+ /** Create a run, or get back the subject's live run. */
5349
+ create(options: CreateAgentRunOptions): Promise<CreateAgentRunResult>;
5350
+ /** Read a run (record + effective projection). */
5351
+ get(runId: string): Promise<AgentRunView>;
5352
+ /**
5353
+ * Every run about `subject` (a conversation, a document) you may see,
5354
+ * newest first — the live run, if there is one, comes first.
5355
+ */
5356
+ bySubject(subject: AgentRunSubject, limit?: number): Promise<AgentRunView[]>;
5357
+ /** The newest run of `subject`, or null. */
5358
+ latest(subject: AgentRunSubject): Promise<AgentRunView | null>;
5359
+ /** Your runs in one status (default "running"). */
5360
+ list(status?: AgentRunStatus, limit?: number): Promise<AgentRunView[]>;
5361
+ /** Durable events after `afterSeq`. */
5362
+ events(runId: string, afterSeq?: number, limit?: number): Promise<AgentRunEvent[]>;
5363
+ /** The children a run spawned, with their current status. */
5364
+ children(runId: string): Promise<AgentRunChildView[]>;
5365
+ /** Any control. Retrying with the same `controlId` is a no-op. */
5366
+ control(runId: string, command: AgentRunCommand, controlId?: string, capability?: string): Promise<AgentRunControlAck>;
5367
+ stop(runId: string, reason?: string, controlId?: string): Promise<AgentRunControlAck>;
5368
+ pause(runId: string, controlId?: string): Promise<AgentRunControlAck>;
5369
+ resume(runId: string, controlId?: string): Promise<AgentRunControlAck>;
5370
+ /** Queue input for the run's next safe boundary. */
5371
+ steer(runId: string, input: unknown, controlId?: string): Promise<AgentRunControlAck>;
5372
+ /** Decide an approval request; the digest ties it to one changeset. */
5373
+ approve(runId: string, requestId: string, subjectDigest: string, reject?: {
5374
+ reason?: string;
5375
+ }, controlId?: string): Promise<AgentRunControlAck>;
5376
+ /** Answer an input request. */
5377
+ answer(runId: string, requestId: string, value: unknown, controlId?: string): Promise<AgentRunControlAck>;
5378
+ /**
5379
+ * Follow a run: replay after `afterSeq`, then live, until the run ends.
5380
+ *
5381
+ * Events that reach the socket before the subscription is known here are
5382
+ * not lost: the durable log is read once the listener is in place, live
5383
+ * events are held until that read is merged, and every seq is delivered
5384
+ * exactly once, in order.
5385
+ */
5386
+ subscribe(runId: string, options?: AgentRunSubscribeOptions): Promise<AgentRunSubscription>;
5387
+ }
5388
+
4659
5389
  /**
4660
5390
  * Chat types for the RaisinDB JS SDK.
4661
5391
  *
@@ -6037,6 +6767,7 @@ declare class Database {
6037
6767
  private getSignAssetUrl?;
6038
6768
  private httpOptions?;
6039
6769
  private _flowsApi?;
6770
+ private _runsApi?;
6040
6771
  private _functionsApi?;
6041
6772
  private _conversationManager?;
6042
6773
  private _flowClient?;
@@ -6141,6 +6872,11 @@ declare class Database {
6141
6872
  * Get FlowsApi for running flows via WebSocket
6142
6873
  */
6143
6874
  flows(): FlowsApi;
6875
+ /**
6876
+ * Durable agent runs over this WebSocket connection: find a subject's run,
6877
+ * follow it live (gap-free, resumable), control it, list its children.
6878
+ */
6879
+ runs(): AgentRunsWsApi;
6144
6880
  /**
6145
6881
  * Get FunctionsApi for invoking server-side functions via WebSocket
6146
6882
  */
@@ -7459,4 +8195,4 @@ declare class ConversationListStore {
7459
8195
  private notify;
7460
8196
  }
7461
8197
 
7462
- export { type CurrentUser$1 as $, AuthManager as A, type BatchUpload as B, ConnectionState as C, Database as D, type EventMessage as E, type FlowClientOptions as F, type SearchOptions as G, type HttpClientOptions as H, type IdentityUser as I, type SearchPassage as J, type ClientMode as K, type CurrentUser as L, type UserNode as M, type Node as N, type AuthEvent as O, type PlanProjection as P, type AuthStateChange as Q, RaisinClient as R, type SubscriptionFilters as S, type ToolCallInfo as T, UploadErrorCode as U, type AuthStateChangeCallback as V, type WorkspaceScope as W, type UserChangeEvent as X, type UserChangeCallback as Y, HttpDatabase as Z, HttpWorkspaceClient as _, type ConversationStoreSnapshot as a, type AuditQueryPayload as a$, type UserNode$1 as a0, type SignAssetOptions as a1, type SignedAssetUrl as a2, type DatabaseHttpOptions as a3, WorkspaceClient as a4, WorkspaceManager as a5, type WorkspaceCreateOptions as a6, type WorkspaceUpdateOptions as a7, NodeOperations as a8, type NodeCreateOptions as a9, createSqlHandler as aA, EventHandler as aB, EventSubscriptions as aC, type EventCallback as aD, type Subscription as aE, Connection as aF, type ConnectionOptions as aG, MemoryTokenStorage as aH, LocalStorageTokenStorage as aI, type TokenStorage as aJ, type IdentityAuthResponse as aK, type IdentityAuthError as aL, type RequestEnvelope as aM, type ResponseEnvelope as aN, type NodeEventPayload as aO, type RequestContext as aP, type ErrorInfo as aQ, type ResponseMetadata as aR, type IncomingRelation as aS, type NodeRelationships as aT, type NodeCreatePayload as aU, type NodeCreateDeepPayload as aV, type NodeUpdatePayload as aW, type NodeDeletePayload as aX, type NodeGetPayload as aY, type NodeHistoryPayload as aZ, type RevisionEntry as a_, type NodeCreateDeepOptions as aa, type NodeUpdateOptions as ab, type NodeQueryOptions as ac, Transaction as ad, type TransactionOptions as ae, NodeTypes as af, Archetypes as ag, ElementTypes as ah, Branches as ai, type BranchDiff as aj, type BranchDivergence as ak, type CrossBranchCopySummary as al, type CrossBranchNodeChange as am, type NodeDiffInfo as an, Tags as ao, SchedulerApi as ap, type ListInvocationsFilter as aq, type ScheduleInvocationOptions as ar, type ScheduledInvocation as as, type ScheduledInvocationRef as at, type ScheduledInvocationTargetKind as au, HttpNodeTypes as av, HttpArchetypes as aw, HttpElementTypes as ax, type SchemaCommit as ay, SqlQuery as az, type ChatMessage as b, Uploader as b$, type AuditLogEntry as b0, type NodeQueryPayload as b1, type RelationAddPayload as b2, type RelationRemovePayload as b3, type RelationsGetPayload as b4, type SqlQueryPayload as b5, type SqlResult as b6, type Workspace as b7, type WorkspaceCreatePayload as b8, type WorkspaceGetPayload as b9, type LoggerConfig as bA, type UploadStatus as bB, type UploadOptions as bC, type UploadProgress as bD, type UploadResult as bE, type Upload as bF, type CreateUploadRequest as bG, type CreateUploadResponse as bH, type ChunkUploadResponse as bI, type UploadStatusResponse as bJ, type CompleteUploadRequest as bK, type CompleteUploadResponse as bL, type BatchFileProgress as bM, UploadError as bN, DEFAULT_CHUNK_SIZE as bO, DEFAULT_MAX_RETRIES as bP, DEFAULT_RETRY_BASE_DELAY as bQ, DEFAULT_RETRY_MAX_DELAY as bR, DEFAULT_NODE_TYPE as bS, DEFAULT_BRANCH as bT, DEFAULT_BATCH_CONCURRENCY as bU, BrowserFileSource as bV, NodeFileSource as bW, createFileSource as bX, getContentType as bY, calculateChunkCount as bZ, getChunkRange as b_, type WorkspaceDeletePayload as ba, type WorkspaceUpdatePayload as bb, type SubscribePayload as bc, type UnsubscribePayload as bd, type SubscriptionResponse as be, type AuthenticatePayload as bf, type AuthenticateResponse as bg, type RefreshTokenPayload as bh, type TransactionBeginPayload as bi, type TransactionBeginResponse as bj, type TransactionCommitPayload as bk, type TransactionCommitResponse as bl, type TransactionRollbackPayload as bm, RequestType as bn, ResponseStatus as bo, encodeMessage as bp, decodeMessage as bq, isEventMessage as br, isResponseEnvelope as bs, ReconnectManager as bt, LogLevel as bu, logger as bv, configureLogger as bw, setLogLevel as bx, getLogLevel as by, getLoggerConfig as bz, ConversationStore as c, type AiErrorBehavior as c$, UploadManager as c0, FlowClient as c1, type FlowRunResult as c2, type FlowCollectResult as c3, FunctionsApi as c4, HttpFunctionsApi as c5, IdentityAuthApi as c6, readTokensFromFragment as c7, type IdentityAuthResult as c8, type IdentityAuthTransport as c9, type StepFailedEvent as cA, type FlowWaitingEvent as cB, type FlowResumedEvent as cC, type FlowCompletedEvent as cD, type FlowFailedEvent as cE, type TextChunkEvent as cF, type ToolCallStartedEvent as cG, type ToolCallCompletedEvent as cH, type ThoughtChunkEvent as cI, type ConversationCreatedEvent as cJ, type MessageSavedEvent as cK, type LogEvent as cL, isTerminalEvent as cM, type RaisinReference as cN, type ContainerType as cO, type StepErrorBehavior as cP, type FlowErrorStrategy as cQ, type RetryConfig as cR, type RetryStrategy as cS, type HumanTaskType as cT, type CanonicalTaskType as cU, type TaskOption as cV, type HandoffTarget as cW, type ChatTerminationMode as cX, type ChatTerminationConfig as cY, type ChatStepConfig as cZ, type AiToolMode as c_, type IdentityInfo as ca, type IdentityMe as cb, type MagicLinkSent as cc, type MagicLinkOptions as cd, type AuthProviders as ce, type FunctionInvokeOptions as cf, type FunctionInvokeResponse as cg, type FunctionInvokeSyncResponse as ch, McpClient as ci, type McpTransport as cj, type McpFrameStream as ck, type McpJsonRpcFrame as cl, type McpToolDescriptor as cm, type McpContentBlock as cn, type McpCallToolResult as co, type McpResourceContents as cp, type McpReadResourceResult as cq, type McpResourceUpdate as cr, type McpResourceSubscription as cs, type FlowRunResponse as ct, type FlowInstanceStatus as cu, type FlowInstanceStatusResponse as cv, type FlowMetrics as cw, type StepStartedEvent as cx, type StepCompletedEvent as cy, type StepUsage as cz, type ConversationListItem as d, type AiContainerConfig as d0, type FlowDefinitionNodeBase as d1, type FlowStepProperties as d2, type FlowDefinitionStep as d3, type ContainerRule as d4, type FanOutConfig as d5, type MergeStrategy as d6, type FlowDefinitionContainer as d7, type LoopConfig as d8, type FlowDefinitionNode as d9, type ChatToolCallCompletedEvent as dA, type ChatThoughtChunkEvent as dB, type ToolCallRecord as dC, type MessageChild as dD, type PlanTask as dE, type ChatConversationCreatedEvent as dF, type ChatMessageSavedEvent as dG, type ChatMessageDeliveredEvent as dH, type ChatLogEvent as dI, ConversationManager as dJ, DEFAULT_SEND_MESSAGE_INACTIVITY_TIMEOUT_MS as dK, type ListConversationsOptions as dL, type CreateConversationOptions as dM, type SendMessageOptions as dN, type ConversationSubscription as dO, type PlanActionReceipt as dP, type PlanActionOptions as dQ, type ConversationManagerOptions as dR, projectPlansFromMessages as dS, type FlowDefinition as da, type InboxTask as db, type InboxTaskStatus as dc, type TaskCompletionResult as dd, RETRY_STRATEGIES as de, getRefDisplayName as df, getRefPath as dg, isFlowDefinitionStep as dh, isFlowDefinitionContainer as di, InboxApi as dj, type InboxApiOptions as dk, type ListTasksOptions as dl, type ListTasksResponse as dm, type ChatEvent as dn, type Conversation as dp, type ConversationType as dq, type ConversationStatus as dr, type MessageBody as ds, type ChatTextChunkEvent as dt, type ChatAssistantMessageEvent as du, type ChatWaitingEvent as dv, type ChatCompletedEvent as dw, type ChatFailedEvent as dx, type ChatDoneEvent as dy, type ChatToolCallStartedEvent as dz, ConversationListStore as e, type ConversationStoreOptions as f, type ConversationListStoreOptions as g, type ConversationListSnapshot as h, FlowsApi as i, type FlowExecutionEvent as j, type PlanProjectionTask as k, type PropertyValue as l, type RelationRef as m, type ClientOptions as n, type Credentials as o, RaisinHttpClient as p, type RetryOptions as q, type UploaderConfig as r, type FileSource as s, type BatchUploadOptions as t, type BatchUploadResult as u, type BatchProgress as v, type ReconnectOptions as w, type Answer as x, type AskOptions as y, type Citation as z };
8198
+ export { type CurrentUser$1 as $, AuthManager as A, type BatchUpload as B, ConnectionState as C, Database as D, type EventMessage as E, type FlowClientOptions as F, type SearchOptions as G, type HttpClientOptions as H, type IdentityUser as I, type SearchPassage as J, type ClientMode as K, type CurrentUser as L, type UserNode as M, type Node as N, type AuthEvent as O, type PlanProjection as P, type AuthStateChange as Q, RaisinClient as R, type SubscriptionFilters as S, type ToolCallInfo as T, UploadErrorCode as U, type AuthStateChangeCallback as V, type WorkspaceScope as W, type UserChangeEvent as X, type UserChangeCallback as Y, HttpDatabase as Z, HttpWorkspaceClient as _, type ConversationStoreSnapshot as a, type CreateAgentRunResult as a$, type UserNode$1 as a0, type SignAssetOptions as a1, type SignedAssetUrl as a2, type DatabaseHttpOptions as a3, WorkspaceClient as a4, WorkspaceManager as a5, type WorkspaceCreateOptions as a6, type WorkspaceUpdateOptions as a7, NodeOperations as a8, type NodeCreateOptions as a9, type CheckpointOptions as aA, type MailboxEntry as aB, type SpawnChildOptions as aC, type SpawnChildResult as aD, NodeDevApi as aE, type ChangeOp as aF, type ChangesetOptions as aG, type CommitOutcome as aH, type NodeDevCommon as aI, type NodeDevConflict as aJ, type NodeDevTransport as aK, type NodeLocator as aL, type NodeRevision as aM, type NodeTarget as aN, type OpReceipt as aO, type Receipt as aP, type WorkRoot as aQ, type AgentRunCommand as aR, type AgentRunControlAck as aS, type AgentRunEvent as aT, type AgentRunFence as aU, type AgentRunStatus as aV, type AgentRunSubject as aW, type AgentRunView as aX, type AgentRunsTransport as aY, type BeginOperationOptions as aZ, type CreateAgentRunOptions as a_, type NodeCreateDeepOptions as aa, type NodeUpdateOptions as ab, type NodeQueryOptions as ac, Transaction as ad, type TransactionOptions as ae, NodeTypes as af, Archetypes as ag, ElementTypes as ah, Branches as ai, type BranchDiff as aj, type BranchDivergence as ak, type CrossBranchCopySummary as al, type CrossBranchNodeChange as am, type NodeDiffInfo as an, Tags as ao, SchedulerApi as ap, AgentRunsApi as aq, newControlId as ar, subjectOf as as, AgentRunsWsApi as at, type AgentRunChildView as au, type AgentRunSubscribeOptions as av, type AgentRunSubscription as aw, type ChildAction as ax, type ChildContext as ay, type ChildObjective as az, type ChatMessage as b, ResponseStatus as b$, type FinishOperationOptions as b0, type ListInvocationsFilter as b1, type ScheduleInvocationOptions as b2, type ScheduledInvocation as b3, type ScheduledInvocationRef as b4, type ScheduledInvocationTargetKind as b5, HttpNodeTypes as b6, HttpArchetypes as b7, HttpElementTypes as b8, type SchemaCommit as b9, type NodeHistoryPayload as bA, type RevisionEntry as bB, type AuditQueryPayload as bC, type AuditLogEntry as bD, type NodeQueryPayload as bE, type RelationAddPayload as bF, type RelationRemovePayload as bG, type RelationsGetPayload as bH, type SqlQueryPayload as bI, type SqlResult as bJ, type Workspace as bK, type WorkspaceCreatePayload as bL, type WorkspaceGetPayload as bM, type WorkspaceDeletePayload as bN, type WorkspaceUpdatePayload as bO, type SubscribePayload as bP, type UnsubscribePayload as bQ, type SubscriptionResponse as bR, type AuthenticatePayload as bS, type AuthenticateResponse as bT, type RefreshTokenPayload as bU, type TransactionBeginPayload as bV, type TransactionBeginResponse as bW, type TransactionCommitPayload as bX, type TransactionCommitResponse as bY, type TransactionRollbackPayload as bZ, RequestType as b_, SqlQuery as ba, createSqlHandler as bb, EventHandler as bc, EventSubscriptions as bd, type EventCallback as be, type Subscription as bf, Connection as bg, type ConnectionOptions as bh, MemoryTokenStorage as bi, LocalStorageTokenStorage as bj, type TokenStorage as bk, type IdentityAuthResponse as bl, type IdentityAuthError as bm, type RequestEnvelope as bn, type ResponseEnvelope as bo, type NodeEventPayload as bp, type RequestContext as bq, type ErrorInfo as br, type ResponseMetadata as bs, type IncomingRelation as bt, type NodeRelationships as bu, type NodeCreatePayload as bv, type NodeCreateDeepPayload as bw, type NodeUpdatePayload as bx, type NodeDeletePayload as by, type NodeGetPayload as bz, ConversationStore as c, type McpCallToolResult as c$, encodeMessage as c0, decodeMessage as c1, isEventMessage as c2, isResponseEnvelope as c3, ReconnectManager as c4, LogLevel as c5, logger as c6, configureLogger as c7, setLogLevel as c8, getLogLevel as c9, calculateChunkCount as cA, getChunkRange as cB, Uploader as cC, UploadManager as cD, FlowClient as cE, type FlowRunResult as cF, type FlowCollectResult as cG, FunctionsApi as cH, HttpFunctionsApi as cI, IdentityAuthApi as cJ, readTokensFromFragment as cK, type IdentityAuthResult as cL, type IdentityAuthTransport as cM, type IdentityInfo as cN, type IdentityMe as cO, type MagicLinkSent as cP, type MagicLinkOptions as cQ, type AuthProviders as cR, type FunctionInvokeOptions as cS, type FunctionInvokeResponse as cT, type FunctionInvokeSyncResponse as cU, McpClient as cV, type McpTransport as cW, type McpFrameStream as cX, type McpJsonRpcFrame as cY, type McpToolDescriptor as cZ, type McpContentBlock as c_, getLoggerConfig as ca, type LoggerConfig as cb, type UploadStatus as cc, type UploadOptions as cd, type UploadProgress as ce, type UploadResult as cf, type Upload as cg, type CreateUploadRequest as ch, type CreateUploadResponse as ci, type ChunkUploadResponse as cj, type UploadStatusResponse as ck, type CompleteUploadRequest as cl, type CompleteUploadResponse as cm, type BatchFileProgress as cn, UploadError as co, DEFAULT_CHUNK_SIZE as cp, DEFAULT_MAX_RETRIES as cq, DEFAULT_RETRY_BASE_DELAY as cr, DEFAULT_RETRY_MAX_DELAY as cs, DEFAULT_NODE_TYPE as ct, DEFAULT_BRANCH as cu, DEFAULT_BATCH_CONCURRENCY as cv, BrowserFileSource as cw, NodeFileSource as cx, createFileSource as cy, getContentType as cz, type ConversationListItem as d, type ChatEvent as d$, type McpResourceContents as d0, type McpReadResourceResult as d1, type McpResourceUpdate as d2, type McpResourceSubscription as d3, type FlowRunResponse as d4, type FlowInstanceStatus as d5, type FlowInstanceStatusResponse as d6, type FlowMetrics as d7, type StepStartedEvent as d8, type StepCompletedEvent as d9, type ChatTerminationConfig as dA, type ChatStepConfig as dB, type AiToolMode as dC, type AiErrorBehavior as dD, type AiContainerConfig as dE, type FlowDefinitionNodeBase as dF, type FlowStepProperties as dG, type FlowDefinitionStep as dH, type ContainerRule as dI, type FanOutConfig as dJ, type MergeStrategy as dK, type FlowDefinitionContainer as dL, type LoopConfig as dM, type FlowDefinitionNode as dN, type FlowDefinition as dO, type InboxTask as dP, type InboxTaskStatus as dQ, type TaskCompletionResult as dR, RETRY_STRATEGIES as dS, getRefDisplayName as dT, getRefPath as dU, isFlowDefinitionStep as dV, isFlowDefinitionContainer as dW, InboxApi as dX, type InboxApiOptions as dY, type ListTasksOptions as dZ, type ListTasksResponse as d_, type StepUsage as da, type StepFailedEvent as db, type FlowWaitingEvent as dc, type FlowResumedEvent as dd, type FlowCompletedEvent as de, type FlowFailedEvent as df, type TextChunkEvent as dg, type ToolCallStartedEvent as dh, type ToolCallCompletedEvent as di, type ThoughtChunkEvent as dj, type ConversationCreatedEvent as dk, type MessageSavedEvent as dl, type LogEvent as dm, isTerminalEvent as dn, type RaisinReference as dp, type ContainerType as dq, type StepErrorBehavior as dr, type FlowErrorStrategy as ds, type RetryConfig as dt, type RetryStrategy as du, type HumanTaskType as dv, type CanonicalTaskType as dw, type TaskOption as dx, type HandoffTarget as dy, type ChatTerminationMode as dz, ConversationListStore as e, type Conversation as e0, type ConversationType as e1, type ConversationStatus as e2, type MessageBody as e3, type ChatTextChunkEvent as e4, type ChatAssistantMessageEvent as e5, type ChatWaitingEvent as e6, type ChatCompletedEvent as e7, type ChatFailedEvent as e8, type ChatDoneEvent as e9, type ChatToolCallStartedEvent as ea, type ChatToolCallCompletedEvent as eb, type ChatThoughtChunkEvent as ec, type ToolCallRecord as ed, type MessageChild as ee, type PlanTask as ef, type ChatConversationCreatedEvent as eg, type ChatMessageSavedEvent as eh, type ChatMessageDeliveredEvent as ei, type ChatLogEvent as ej, ConversationManager as ek, DEFAULT_SEND_MESSAGE_INACTIVITY_TIMEOUT_MS as el, type ListConversationsOptions as em, type CreateConversationOptions as en, type SendMessageOptions as eo, type ConversationSubscription as ep, type PlanActionReceipt as eq, type PlanActionOptions as er, type ConversationManagerOptions as es, projectPlansFromMessages as et, type ConversationStoreOptions as f, type ConversationListStoreOptions as g, type ConversationListSnapshot as h, FlowsApi as i, type FlowExecutionEvent as j, type PlanProjectionTask as k, type PropertyValue as l, type RelationRef as m, type ClientOptions as n, type Credentials as o, RaisinHttpClient as p, type RetryOptions as q, type UploaderConfig as r, type FileSource as s, type BatchUploadOptions as t, type BatchUploadResult as u, type BatchProgress as v, type ReconnectOptions as w, type Answer as x, type AskOptions as y, type Citation as z };