acpx 0.15.1 → 0.17.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -0
- package/dist/agent-registry-DU6mhZBL.js +785 -0
- package/dist/agent-registry-DU6mhZBL.js.map +1 -0
- package/dist/agent-registry.d.ts +70 -0
- package/dist/agent-registry.d.ts.map +1 -0
- package/dist/agent-registry.js +2 -0
- package/dist/{cli-BHAT_D3V.js → cli-CiyfEC7L.js} +7 -14
- package/dist/cli-CiyfEC7L.js.map +1 -0
- package/dist/cli.d.ts +1 -1
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +160 -349
- package/dist/cli.js.map +1 -1
- package/dist/{client-Cvz6msGc.d.ts → client-C6NUFqr-.d.ts} +21 -13
- package/dist/client-C6NUFqr-.d.ts.map +1 -0
- package/dist/{flows-BOI1XkMp.js → flows-CTOdIk-m.js} +208 -279
- package/dist/flows-CTOdIk-m.js.map +1 -0
- package/dist/flows.d.ts +6 -17
- package/dist/flows.d.ts.map +1 -1
- package/dist/flows.js +1 -1
- package/dist/{flags-BHcZWTov.js → invocation-options-DbCcOAzM.js} +83 -58
- package/dist/invocation-options-DbCcOAzM.js.map +1 -0
- package/dist/ipc-D3akHMEq.js +3350 -0
- package/dist/ipc-D3akHMEq.js.map +1 -0
- package/dist/output-BPPjvJTI.js +980 -0
- package/dist/output-BPPjvJTI.js.map +1 -0
- package/dist/{live-checkpoint-sB7dFOYR.js → queue-owner-runtime--IbbndGz.js} +5359 -4574
- package/dist/queue-owner-runtime--IbbndGz.js.map +1 -0
- package/dist/runtime.d.ts +197 -27
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +864 -409
- package/dist/runtime.js.map +1 -1
- package/dist/{session-options-DyIGRNfu.d.ts → session-options-Dp6mzNSy.d.ts} +8 -6
- package/dist/session-options-Dp6mzNSy.d.ts.map +1 -0
- package/dist/session-watch--UX5dh00.js +76 -0
- package/dist/session-watch--UX5dh00.js.map +1 -0
- package/dist/watch-BbBxO-kb.js +32 -0
- package/dist/watch-BbBxO-kb.js.map +1 -0
- package/package.json +27 -25
- package/skills/acpx/SKILL.md +24 -19
- package/dist/cli-BHAT_D3V.js.map +0 -1
- package/dist/client-Cvz6msGc.d.ts.map +0 -1
- package/dist/flags-BHcZWTov.js.map +0 -1
- package/dist/flows-BOI1XkMp.js.map +0 -1
- package/dist/live-checkpoint-sB7dFOYR.js.map +0 -1
- package/dist/output-8-D6Gd4Z.js +0 -4714
- package/dist/output-8-D6Gd4Z.js.map +0 -1
- package/dist/session-options-DyIGRNfu.d.ts.map +0 -1
package/dist/runtime.d.ts
CHANGED
|
@@ -1,15 +1,42 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { a as
|
|
3
|
-
import
|
|
1
|
+
import { AcpAgentInspection, AcpAgentInspectionOptions, AcpAgentRegistry, AcpInspectableAgentRegistry, DEFAULT_AGENT_NAME, createAgentRegistry } from "./agent-registry.js";
|
|
2
|
+
import { C as PermissionPolicy, S as PermissionMode, T as SessionRecord, _ as AcpProcessSpawnFailure, a as AcpElicitationHandler, b as McpServer$1, c as AcpElicitationResponse, d as AcpPermissionHandler, f as AcpPermissionRequest, g as AcpProcessLifecycle, h as AcpProcessLaunchScope, i as AcpElicitationContext, l as AcpJsonRpcMessage, m as AcpProcessLaunch, n as SystemPromptOption, o as AcpElicitationMode, p as AcpProcessExit, s as AcpElicitationRequest, t as SessionAgentOptions, u as AcpPermissionDecision, v as AcpProcessStarted, x as NonInteractivePermissionPolicy, y as AuthPolicy } from "./session-options-Dp6mzNSy.js";
|
|
3
|
+
import { a as RequestedModelUnsupportedErrorCode, c as AcpControlAuthority, i as RequestedModelUnsupportedError, n as REQUESTED_MODEL_UNSUPPORTED_ERROR_CODE, o as RequestedModelUnsupportedReason, r as REQUESTED_MODEL_UNSUPPORTED_REASONS, s as isRequestedModelUnsupportedError, t as AcpClient } from "./client-C6NUFqr-.js";
|
|
4
|
+
import { z } from "zod";
|
|
4
5
|
import { SetSessionConfigOptionResponse, ToolCallContent, ToolCallLocation, ToolKind } from "@agentclientprotocol/sdk";
|
|
5
|
-
//#region src/
|
|
6
|
-
|
|
6
|
+
//#region src/session/journal.d.ts
|
|
7
|
+
type SessionWatchResult = {
|
|
8
|
+
status: "completed" | "cancelled";
|
|
9
|
+
stopReason?: string;
|
|
10
|
+
_meta?: Record<string, unknown> | null;
|
|
11
|
+
} | {
|
|
12
|
+
status: "failed";
|
|
13
|
+
error: {
|
|
14
|
+
message: string;
|
|
15
|
+
code?: string;
|
|
16
|
+
detailCode?: string;
|
|
17
|
+
retryable?: boolean;
|
|
18
|
+
};
|
|
19
|
+
};
|
|
20
|
+
type SessionWatchEvent = {
|
|
21
|
+
cursor: string;
|
|
22
|
+
} & ({
|
|
23
|
+
type: "message";
|
|
24
|
+
requestId: string | null;
|
|
25
|
+
message: AcpJsonRpcMessage;
|
|
26
|
+
} | {
|
|
27
|
+
type: "turn_started";
|
|
28
|
+
requestId: string;
|
|
29
|
+
} | {
|
|
30
|
+
type: "turn_result";
|
|
31
|
+
requestId: string;
|
|
32
|
+
result: SessionWatchResult;
|
|
33
|
+
});
|
|
7
34
|
//#endregion
|
|
8
35
|
//#region src/runtime/public/contract.d.ts
|
|
9
36
|
type AcpRuntimePromptMode = "prompt" | "steer";
|
|
10
37
|
type AcpRuntimeSessionMode = "persistent" | "oneshot";
|
|
11
38
|
type AcpSessionUpdateTag = "agent_message_chunk" | "agent_thought_chunk" | "tool_call" | "tool_call_update" | "usage_update" | "available_commands_update" | "current_mode_update" | "config_option_update" | "session_info_update" | "plan" | (string & {});
|
|
12
|
-
type AcpRuntimeControl = "session/set_mode" | "session/set_config_option" | "session/status";
|
|
39
|
+
type AcpRuntimeControl = "session/set_mode" | "session/set_model" | "session/set_config_option" | "session/status";
|
|
13
40
|
type AcpRuntimeHandle = {
|
|
14
41
|
sessionKey: string;
|
|
15
42
|
backend: string;
|
|
@@ -31,7 +58,7 @@ type AcpRuntimeEnsureInput = {
|
|
|
31
58
|
* on the underlying `session/new` request, and persisted onto the new
|
|
32
59
|
* record. Ignored when an existing persistent session is reused — system
|
|
33
60
|
* prompts are fixed at `newSession` time, so changing them requires a
|
|
34
|
-
* different sessionKey or
|
|
61
|
+
* different sessionKey or prepareFreshSession on the prior record first.
|
|
35
62
|
*/
|
|
36
63
|
sessionOptions?: SessionAgentOptions;
|
|
37
64
|
};
|
|
@@ -51,6 +78,8 @@ type AcpRuntimeTurnInput = {
|
|
|
51
78
|
requestId: string;
|
|
52
79
|
timeoutMs?: number;
|
|
53
80
|
signal?: AbortSignal;
|
|
81
|
+
/** Overrides the runtime permission callback for this prompt turn. */
|
|
82
|
+
onPermissionRequest?: AcpPermissionHandler;
|
|
54
83
|
/** Handles ACP elicitation requests owned by this prompt turn. */
|
|
55
84
|
onElicitation?: AcpElicitationHandler;
|
|
56
85
|
};
|
|
@@ -61,6 +90,11 @@ type AcpRuntimeCapabilities = {
|
|
|
61
90
|
type AcpRuntimeSessionModels = {
|
|
62
91
|
currentModelId?: string;
|
|
63
92
|
availableModelIds: string[];
|
|
93
|
+
/** Native display names, when retained by the session snapshot. */
|
|
94
|
+
availableModels?: Array<{
|
|
95
|
+
modelId: string;
|
|
96
|
+
name: string;
|
|
97
|
+
}>;
|
|
64
98
|
};
|
|
65
99
|
/**
|
|
66
100
|
* Cumulative session cost as reported by the agent. Mirrors ACP's
|
|
@@ -96,6 +130,15 @@ type AcpRuntimeAvailableCommand = {
|
|
|
96
130
|
/** True/false when ACP advertised whether this command has an input schema. */
|
|
97
131
|
hasInput?: boolean;
|
|
98
132
|
};
|
|
133
|
+
/**
|
|
134
|
+
* An entry in an ACP plan snapshot. Each update replaces the previous list.
|
|
135
|
+
* Priority is omitted unless the agent advertises a valid value.
|
|
136
|
+
*/
|
|
137
|
+
type AcpRuntimePlanEntry = {
|
|
138
|
+
content: string;
|
|
139
|
+
status: "pending" | "in_progress" | "completed";
|
|
140
|
+
priority?: "high" | "medium" | "low";
|
|
141
|
+
};
|
|
99
142
|
/**
|
|
100
143
|
* Session-level usage roll-up surfaced through `getStatus()`. The
|
|
101
144
|
* reducer persists the breakdowns onto the session record; this type
|
|
@@ -109,6 +152,8 @@ type AcpRuntimeSessionUsage = {
|
|
|
109
152
|
perRequest?: Record<string, AcpRuntimeUsageBreakdown>;
|
|
110
153
|
};
|
|
111
154
|
type AcpRuntimeStatus = {
|
|
155
|
+
/** Most recent host request id admitted for a prompt on this session. */
|
|
156
|
+
lastRequestId?: string;
|
|
112
157
|
summary?: string;
|
|
113
158
|
acpxRecordId?: string;
|
|
114
159
|
backendSessionId?: string;
|
|
@@ -186,6 +231,11 @@ type AcpRuntimeEvent = {
|
|
|
186
231
|
* non-null `input` schema.
|
|
187
232
|
*/
|
|
188
233
|
availableCommands?: AcpRuntimeAvailableCommand[];
|
|
234
|
+
/**
|
|
235
|
+
* Normalized entries on `plan` events; malformed entries are skipped.
|
|
236
|
+
* Replace the displayed plan when present, including clearing it for [].
|
|
237
|
+
*/
|
|
238
|
+
entries?: AcpRuntimePlanEntry[];
|
|
189
239
|
} | {
|
|
190
240
|
type: "tool_call";
|
|
191
241
|
text: string;
|
|
@@ -256,6 +306,19 @@ interface AcpRuntimeTurn {
|
|
|
256
306
|
}): Promise<void>;
|
|
257
307
|
}
|
|
258
308
|
interface AcpRuntime {
|
|
309
|
+
/** Passively replays and follows recorded turns when the backend supports a shared journal. */
|
|
310
|
+
watchSession?(input: {
|
|
311
|
+
handle: AcpRuntimeHandle;
|
|
312
|
+
cursor?: string;
|
|
313
|
+
signal?: AbortSignal;
|
|
314
|
+
}): AsyncIterable<SessionWatchEvent>;
|
|
315
|
+
/** Stops owned connections and joins admitted work; stored sessions remain resumable. */
|
|
316
|
+
shutdown?(): Promise<void>;
|
|
317
|
+
/** Finds a persistent session handle without starting or reconnecting an agent. */
|
|
318
|
+
findSession?(input: {
|
|
319
|
+
sessionKey: string;
|
|
320
|
+
agent: string;
|
|
321
|
+
}): Promise<AcpRuntimeHandle | undefined>;
|
|
259
322
|
ensureSession(input: AcpRuntimeEnsureInput): Promise<AcpRuntimeHandle>;
|
|
260
323
|
startTurn(input: AcpRuntimeTurnInput): AcpRuntimeTurn;
|
|
261
324
|
/**
|
|
@@ -271,11 +334,16 @@ interface AcpRuntime {
|
|
|
271
334
|
handle: AcpRuntimeHandle;
|
|
272
335
|
signal?: AbortSignal;
|
|
273
336
|
}): Promise<AcpRuntimeStatus>;
|
|
274
|
-
|
|
337
|
+
/** Authority gates dispatch; an issued control still settles its response and saved state. */
|
|
338
|
+
setMode?(input: AcpControlAuthority & {
|
|
275
339
|
handle: AcpRuntimeHandle;
|
|
276
340
|
mode: string;
|
|
277
341
|
}): Promise<void>;
|
|
278
|
-
|
|
342
|
+
setModel?(input: AcpControlAuthority & {
|
|
343
|
+
handle: AcpRuntimeHandle;
|
|
344
|
+
model: string;
|
|
345
|
+
}): Promise<void>;
|
|
346
|
+
setConfigOption?(input: AcpControlAuthority & {
|
|
279
347
|
handle: AcpRuntimeHandle;
|
|
280
348
|
key: string;
|
|
281
349
|
value: string;
|
|
@@ -285,6 +353,10 @@ interface AcpRuntime {
|
|
|
285
353
|
handle: AcpRuntimeHandle;
|
|
286
354
|
reason?: string;
|
|
287
355
|
}): Promise<void>;
|
|
356
|
+
/** Locally closes the session and persists fresh creation on the next ensure without resumeSessionId. */
|
|
357
|
+
prepareFreshSession?(input: {
|
|
358
|
+
handle: AcpRuntimeHandle;
|
|
359
|
+
}): Promise<void>;
|
|
288
360
|
close(input: {
|
|
289
361
|
handle: AcpRuntimeHandle;
|
|
290
362
|
reason: string;
|
|
@@ -296,17 +368,24 @@ interface AcpSessionStore {
|
|
|
296
368
|
load(sessionId: string): Promise<AcpSessionRecord | undefined>;
|
|
297
369
|
save(record: AcpSessionRecord): Promise<void>;
|
|
298
370
|
}
|
|
299
|
-
interface AcpAgentRegistry {
|
|
300
|
-
resolve(agentName: string): string | string[];
|
|
301
|
-
list(): string[];
|
|
302
|
-
}
|
|
303
371
|
type AcpRuntimeOptions = {
|
|
304
372
|
cwd: string;
|
|
305
373
|
/** Trusted child-only environment, snapshotted at construction and never persisted. */
|
|
306
374
|
agentProcessEnv?: Record<string, string>;
|
|
307
375
|
sessionStore: AcpSessionStore;
|
|
308
376
|
agentRegistry: AcpAgentRegistry;
|
|
309
|
-
|
|
377
|
+
/**
|
|
378
|
+
* Servers for new and reconnected session clients. A resolver runs at connection
|
|
379
|
+
* creation with the session's stored identity; its result is never persisted.
|
|
380
|
+
* Retained connections keep their original servers. Initialization-only health
|
|
381
|
+
* probes do not call the resolver.
|
|
382
|
+
*/
|
|
383
|
+
mcpServers?: McpServer$1[] | ((session: {
|
|
384
|
+
sessionKey: string;
|
|
385
|
+
cwd: string;
|
|
386
|
+
agentCommand: string;
|
|
387
|
+
agentArgv?: string[];
|
|
388
|
+
}) => McpServer$1[]);
|
|
310
389
|
permissionMode: PermissionMode;
|
|
311
390
|
nonInteractivePermissions?: NonInteractivePermissionPolicy;
|
|
312
391
|
permissionPolicy?: PermissionPolicy;
|
|
@@ -317,14 +396,19 @@ type AcpRuntimeOptions = {
|
|
|
317
396
|
elicitationModes?: readonly AcpElicitationMode[];
|
|
318
397
|
/** Optional lifecycle observer for ACP agent processes owned by this runtime. */
|
|
319
398
|
processLifecycle?: AcpProcessLifecycle;
|
|
320
|
-
onPermissionRequest?:
|
|
321
|
-
signal: AbortSignal;
|
|
322
|
-
}) => Promise<AcpPermissionDecision | undefined>;
|
|
399
|
+
onPermissionRequest?: AcpPermissionHandler;
|
|
323
400
|
};
|
|
324
401
|
type AcpFileSessionStoreOptions = {
|
|
325
402
|
stateDir: string;
|
|
326
403
|
};
|
|
327
404
|
//#endregion
|
|
405
|
+
//#region src/runtime/public/probe.d.ts
|
|
406
|
+
type RuntimeHealthReport = {
|
|
407
|
+
ok: boolean;
|
|
408
|
+
message: string;
|
|
409
|
+
details?: string[];
|
|
410
|
+
};
|
|
411
|
+
//#endregion
|
|
328
412
|
//#region src/runtime/engine/manager.d.ts
|
|
329
413
|
type AcpRuntimeManagerDeps = {
|
|
330
414
|
clientFactory?: (options: ConstructorParameters<typeof AcpClient>[0]) => AcpClient;
|
|
@@ -342,12 +426,26 @@ declare class AcpRuntimeManager {
|
|
|
342
426
|
private readonly deps;
|
|
343
427
|
private readonly activeControllers;
|
|
344
428
|
private readonly retainedSessionOwners;
|
|
429
|
+
private readonly retiringSessionOwners;
|
|
345
430
|
private readonly pendingOneShotRecordIds;
|
|
346
431
|
private readonly ensureSessionLocks;
|
|
347
432
|
private readonly runtimeOperationLocks;
|
|
433
|
+
private readonly sessionTasks;
|
|
348
434
|
private readonly closingActiveRecords;
|
|
435
|
+
private readonly liveClients;
|
|
436
|
+
private readonly pendingTasks;
|
|
437
|
+
private shuttingDown;
|
|
438
|
+
private shutdownTask?;
|
|
349
439
|
constructor(options: AcpRuntimeOptions, deps?: AcpRuntimeManagerDeps);
|
|
350
440
|
private createClient;
|
|
441
|
+
probe(): Promise<RuntimeHealthReport>;
|
|
442
|
+
private assertOpen;
|
|
443
|
+
shutdown(): Promise<void>;
|
|
444
|
+
private shutdownOwnedClients;
|
|
445
|
+
private trackTask;
|
|
446
|
+
private queueSessionTask;
|
|
447
|
+
private cancelSessionTasks;
|
|
448
|
+
private closeClient;
|
|
351
449
|
private createSessionOwner;
|
|
352
450
|
private routeOwnedSessionUpdate;
|
|
353
451
|
private routeOwnedClientOperation;
|
|
@@ -358,9 +456,11 @@ declare class AcpRuntimeManager {
|
|
|
358
456
|
private readRetainedSessionOwner;
|
|
359
457
|
private closeRetainedSessionOwner;
|
|
360
458
|
private stopSessionOwner;
|
|
459
|
+
private retrySessionCleanup;
|
|
361
460
|
private refreshClosedState;
|
|
362
461
|
private retainPersistentSessionOwnerAfterTurn;
|
|
363
462
|
private canRetainPersistentSessionOwner;
|
|
463
|
+
private resolveMcpServers;
|
|
364
464
|
private withRuntimeControlSession;
|
|
365
465
|
private refreshOwnedRecordLifecycle;
|
|
366
466
|
ensureSession(input: RuntimeEnsureInput): Promise<SessionRecord>;
|
|
@@ -368,6 +468,7 @@ declare class AcpRuntimeManager {
|
|
|
368
468
|
private withManagerLock;
|
|
369
469
|
private ensureSessionWithOwnership;
|
|
370
470
|
private loadExistingRuntimeSession;
|
|
471
|
+
findSession(sessionKey: string): Promise<SessionRecord | undefined>;
|
|
371
472
|
private canReuseRuntimeSession;
|
|
372
473
|
private reuseRuntimeSession;
|
|
373
474
|
private closeConflictingPersistentSession;
|
|
@@ -384,6 +485,7 @@ declare class AcpRuntimeManager {
|
|
|
384
485
|
timeoutMs?: number;
|
|
385
486
|
signal?: AbortSignal;
|
|
386
487
|
onElicitation?: AcpElicitationHandler;
|
|
488
|
+
onPermissionRequest?: AcpPermissionHandler;
|
|
387
489
|
}): AcpRuntimeTurn;
|
|
388
490
|
private closeRetainedOneShotHandle;
|
|
389
491
|
private runRuntimeTurnTask;
|
|
@@ -407,7 +509,6 @@ declare class AcpRuntimeManager {
|
|
|
407
509
|
private connectRuntimeTurnClient;
|
|
408
510
|
private publishRuntimeTurnController;
|
|
409
511
|
private resolveRuntimeTurnReady;
|
|
410
|
-
private emitRuntimeTurnLoadStatus;
|
|
411
512
|
private cancelRuntimeTurnBeforePrompt;
|
|
412
513
|
private applyPendingRuntimeTurnCancel;
|
|
413
514
|
private saveCompletedRuntimeTurn;
|
|
@@ -427,21 +528,27 @@ declare class AcpRuntimeManager {
|
|
|
427
528
|
timeoutMs?: number;
|
|
428
529
|
signal?: AbortSignal;
|
|
429
530
|
onElicitation?: AcpElicitationHandler;
|
|
531
|
+
onPermissionRequest?: AcpPermissionHandler;
|
|
430
532
|
}): AsyncIterable<AcpRuntimeEvent>;
|
|
431
533
|
getStatus(handle: AcpRuntimeHandle): Promise<AcpRuntimeStatus>;
|
|
432
|
-
|
|
534
|
+
private readStatus;
|
|
535
|
+
setMode(handle: AcpRuntimeHandle, mode: string, sessionMode?: "persistent" | "oneshot", authority?: AcpControlAuthority): Promise<void>;
|
|
433
536
|
private setModeWithOwnership;
|
|
434
|
-
|
|
537
|
+
setModel(handle: AcpRuntimeHandle, model: string, sessionMode?: "persistent" | "oneshot", authority?: AcpControlAuthority): Promise<void>;
|
|
538
|
+
private setModelWithOwnership;
|
|
539
|
+
setConfigOption(handle: AcpRuntimeHandle, key: string, value: string, sessionMode?: "persistent" | "oneshot", authority?: AcpControlAuthority): Promise<SetSessionConfigOptionResponse>;
|
|
435
540
|
private setConfigOptionWithOwnership;
|
|
436
541
|
cancel(handle: AcpRuntimeHandle): Promise<void>;
|
|
542
|
+
prepareFreshSession(handle: AcpRuntimeHandle): Promise<void>;
|
|
437
543
|
close(handle: AcpRuntimeHandle, options?: {
|
|
438
544
|
discardPersistentState?: boolean;
|
|
439
545
|
}): Promise<void>;
|
|
546
|
+
private closeRuntimeSession;
|
|
440
547
|
private resolveRuntimeRecordForClose;
|
|
441
548
|
private markActiveRuntimeRecordClosing;
|
|
442
549
|
private closeRuntimeRecordOwnership;
|
|
443
550
|
private closeBackendSession;
|
|
444
|
-
private
|
|
551
|
+
private finalizeSessionConnection;
|
|
445
552
|
private acquireBackendCloseConnection;
|
|
446
553
|
private requestBackendSessionClose;
|
|
447
554
|
private handleBackendSessionCloseError;
|
|
@@ -478,6 +585,56 @@ type AcpxHandleState = {
|
|
|
478
585
|
export declare function encodeAcpxRuntimeHandleState(state: AcpxHandleState): string;
|
|
479
586
|
export declare function decodeAcpxRuntimeHandleState(runtimeSessionName: string): AcpxHandleState | null;
|
|
480
587
|
//#endregion
|
|
588
|
+
//#region src/runtime/shared.d.ts
|
|
589
|
+
type SharedAcpRuntimeOptions = {
|
|
590
|
+
cwd: string;
|
|
591
|
+
agentRegistry?: AcpAgentRegistry;
|
|
592
|
+
permissionMode: PermissionMode;
|
|
593
|
+
nonInteractivePermissions?: NonInteractivePermissionPolicy;
|
|
594
|
+
permissionPolicy?: PermissionPolicy;
|
|
595
|
+
authCredentials?: Record<string, string>;
|
|
596
|
+
authPolicy?: AuthPolicy;
|
|
597
|
+
timeoutMs?: number;
|
|
598
|
+
ttlMs?: number;
|
|
599
|
+
};
|
|
600
|
+
/** A client of the CLI's local session owner. Shutdown detaches this client. */
|
|
601
|
+
export declare class SharedAcpRuntime {
|
|
602
|
+
private readonly registry;
|
|
603
|
+
private readonly options;
|
|
604
|
+
private readonly disconnect;
|
|
605
|
+
private readonly pending;
|
|
606
|
+
constructor(options: SharedAcpRuntimeOptions);
|
|
607
|
+
private assertOpen;
|
|
608
|
+
private track;
|
|
609
|
+
private sessionOptions;
|
|
610
|
+
findSession(input: {
|
|
611
|
+
sessionKey: string;
|
|
612
|
+
agent: string;
|
|
613
|
+
cwd?: string;
|
|
614
|
+
}): Promise<AcpRuntimeHandle | undefined>;
|
|
615
|
+
ensureSession(input: AcpRuntimeEnsureInput): Promise<AcpRuntimeHandle>;
|
|
616
|
+
startTurn(input: AcpRuntimeTurnInput): AcpRuntimeTurn;
|
|
617
|
+
runTurn(input: AcpRuntimeTurnInput): AsyncGenerator<AcpRuntimeEvent, void, any>;
|
|
618
|
+
getStatus(input: {
|
|
619
|
+
handle: AcpRuntimeHandle;
|
|
620
|
+
}): Promise<AcpRuntimeStatus>;
|
|
621
|
+
watchSession(input: {
|
|
622
|
+
handle: AcpRuntimeHandle;
|
|
623
|
+
cursor?: string;
|
|
624
|
+
signal?: AbortSignal;
|
|
625
|
+
}): AsyncIterable<SessionWatchEvent>;
|
|
626
|
+
cancel(input: {
|
|
627
|
+
handle: AcpRuntimeHandle;
|
|
628
|
+
reason?: string;
|
|
629
|
+
}): Promise<void>;
|
|
630
|
+
close(input: {
|
|
631
|
+
handle: AcpRuntimeHandle;
|
|
632
|
+
reason: string;
|
|
633
|
+
}): Promise<void>;
|
|
634
|
+
shutdown(): Promise<void>;
|
|
635
|
+
}
|
|
636
|
+
export declare function createSharedAcpRuntime(options: SharedAcpRuntimeOptions): SharedAcpRuntime;
|
|
637
|
+
//#endregion
|
|
481
638
|
//#region src/runtime.d.ts
|
|
482
639
|
export declare const ACPX_BACKEND_ID = "acpx";
|
|
483
640
|
type AcpxRuntimeLike = AcpRuntime & {
|
|
@@ -485,13 +642,12 @@ type AcpxRuntimeLike = AcpRuntime & {
|
|
|
485
642
|
isHealthy(): boolean;
|
|
486
643
|
doctor(): Promise<AcpRuntimeDoctorReport>;
|
|
487
644
|
};
|
|
488
|
-
export declare function createAgentRegistry(params?: {
|
|
489
|
-
overrides?: Record<string, string | string[]>;
|
|
490
|
-
}): AcpAgentRegistry;
|
|
491
645
|
export declare class AcpxRuntime implements AcpxRuntimeLike {
|
|
492
646
|
private readonly options;
|
|
493
647
|
private readonly testOptions?;
|
|
494
648
|
private healthy;
|
|
649
|
+
private shutdownTask?;
|
|
650
|
+
private readonly probeTasks;
|
|
495
651
|
private manager;
|
|
496
652
|
private managerPromise;
|
|
497
653
|
constructor(options: AcpRuntimeOptions, testOptions?: {
|
|
@@ -505,7 +661,13 @@ export declare class AcpxRuntime implements AcpxRuntimeLike {
|
|
|
505
661
|
isHealthy(): boolean;
|
|
506
662
|
probeAvailability(): Promise<void>;
|
|
507
663
|
doctor(): Promise<AcpRuntimeDoctorReport>;
|
|
664
|
+
private resolveSessionIdentity;
|
|
665
|
+
findSession(input: {
|
|
666
|
+
sessionKey: string;
|
|
667
|
+
agent: string;
|
|
668
|
+
}): Promise<AcpRuntimeHandle | undefined>;
|
|
508
669
|
ensureSession(input: AcpRuntimeEnsureInput): Promise<AcpRuntimeHandle>;
|
|
670
|
+
private createSessionHandle;
|
|
509
671
|
startTurn(input: AcpRuntimeTurnInput): {
|
|
510
672
|
requestId: string;
|
|
511
673
|
readonly promptStarted: Promise<void>;
|
|
@@ -528,11 +690,15 @@ export declare class AcpxRuntime implements AcpxRuntimeLike {
|
|
|
528
690
|
handle: AcpRuntimeHandle;
|
|
529
691
|
signal?: AbortSignal;
|
|
530
692
|
}): Promise<AcpRuntimeStatus>;
|
|
531
|
-
setMode(input: {
|
|
693
|
+
setMode(input: AcpControlAuthority & {
|
|
532
694
|
handle: AcpRuntimeHandle;
|
|
533
695
|
mode: string;
|
|
534
696
|
}): Promise<void>;
|
|
535
|
-
|
|
697
|
+
setModel(input: AcpControlAuthority & {
|
|
698
|
+
handle: AcpRuntimeHandle;
|
|
699
|
+
model: string;
|
|
700
|
+
}): Promise<void>;
|
|
701
|
+
setConfigOption(input: AcpControlAuthority & {
|
|
536
702
|
handle: AcpRuntimeHandle;
|
|
537
703
|
key: string;
|
|
538
704
|
value: string;
|
|
@@ -541,11 +707,15 @@ export declare class AcpxRuntime implements AcpxRuntimeLike {
|
|
|
541
707
|
handle: AcpRuntimeHandle;
|
|
542
708
|
reason?: string;
|
|
543
709
|
}): Promise<void>;
|
|
710
|
+
prepareFreshSession(input: {
|
|
711
|
+
handle: AcpRuntimeHandle;
|
|
712
|
+
}): Promise<void>;
|
|
544
713
|
close(input: {
|
|
545
714
|
handle: AcpRuntimeHandle;
|
|
546
715
|
reason: string;
|
|
547
716
|
discardPersistentState?: boolean;
|
|
548
717
|
}): Promise<void>;
|
|
718
|
+
shutdown(): Promise<void>;
|
|
549
719
|
private getManager;
|
|
550
720
|
private runProbe;
|
|
551
721
|
private resolveManagerHandle;
|
|
@@ -556,5 +726,5 @@ export declare function createRuntimeStore(options: {
|
|
|
556
726
|
stateDir: string;
|
|
557
727
|
}): AcpSessionStore;
|
|
558
728
|
//#endregion
|
|
559
|
-
export { type AcpAgentRegistry, type AcpElicitationContext, type AcpElicitationHandler, type AcpElicitationMode, type AcpElicitationRequest, type AcpElicitationResponse, type AcpFileSessionStoreOptions, type AcpPermissionDecision, type AcpPermissionRequest, type AcpProcessExit, type AcpProcessLaunch, type AcpProcessLaunchScope, type AcpProcessLifecycle, type AcpProcessSpawnFailure, type AcpProcessStarted, type AcpRuntime, type AcpRuntimeAvailableCommand, type AcpRuntimeCapabilities, type AcpRuntimeDoctorReport, type AcpRuntimeEnsureInput, type AcpRuntimeErrorCode, type AcpRuntimeEvent, type AcpRuntimeHandle, type AcpRuntimeOptions, type AcpRuntimePromptMode, type AcpRuntimeSessionMode, type AcpRuntimeSessionModels, type AcpRuntimeSessionUsage, type AcpRuntimeStatus, type AcpRuntimeTurn, type AcpRuntimeTurnAttachment, type AcpRuntimeTurnInput, type AcpRuntimeTurnResult, type AcpRuntimeTurnResultError, type AcpRuntimeUsageBreakdown, type AcpRuntimeUsageCost, type AcpSessionRecord, type AcpSessionStore, type AcpSessionUpdateTag, type AcpTextDeltaOriginMeta, type PermissionPolicy, REQUESTED_MODEL_UNSUPPORTED_ERROR_CODE, REQUESTED_MODEL_UNSUPPORTED_REASONS, RequestedModelUnsupportedError, type RequestedModelUnsupportedErrorCode, type RequestedModelUnsupportedReason, type SessionAgentOptions, type SystemPromptOption, isRequestedModelUnsupportedError };
|
|
729
|
+
export { type AcpAgentInspection, type AcpAgentInspectionOptions, type AcpAgentRegistry, type AcpElicitationContext, type AcpElicitationHandler, type AcpElicitationMode, type AcpElicitationRequest, type AcpElicitationResponse, type AcpFileSessionStoreOptions, type AcpInspectableAgentRegistry, type AcpPermissionDecision, type AcpPermissionHandler, type AcpPermissionRequest, type AcpProcessExit, type AcpProcessLaunch, type AcpProcessLaunchScope, type AcpProcessLifecycle, type AcpProcessSpawnFailure, type AcpProcessStarted, type AcpRuntime, type AcpRuntimeAvailableCommand, type AcpRuntimeCapabilities, type AcpRuntimeDoctorReport, type AcpRuntimeEnsureInput, type AcpRuntimeErrorCode, type AcpRuntimeEvent, type AcpRuntimeHandle, type AcpRuntimeOptions, type AcpRuntimePlanEntry, type AcpRuntimePromptMode, type AcpRuntimeSessionMode, type AcpRuntimeSessionModels, type AcpRuntimeSessionUsage, type AcpRuntimeStatus, type AcpRuntimeTurn, type AcpRuntimeTurnAttachment, type AcpRuntimeTurnInput, type AcpRuntimeTurnResult, type AcpRuntimeTurnResultError, type AcpRuntimeUsageBreakdown, type AcpRuntimeUsageCost, type AcpSessionRecord, type AcpSessionStore, type AcpSessionUpdateTag, type AcpTextDeltaOriginMeta, DEFAULT_AGENT_NAME, type PermissionPolicy, REQUESTED_MODEL_UNSUPPORTED_ERROR_CODE, REQUESTED_MODEL_UNSUPPORTED_REASONS, RequestedModelUnsupportedError, type RequestedModelUnsupportedErrorCode, type RequestedModelUnsupportedReason, type SessionAgentOptions, type SessionWatchEvent, type SessionWatchResult, type SharedAcpRuntimeOptions, type SystemPromptOption, createAgentRegistry, isRequestedModelUnsupportedError };
|
|
560
730
|
//# sourceMappingURL=runtime.d.ts.map
|
package/dist/runtime.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"runtime.d.ts","names":[],"sources":["../src/
|
|
1
|
+
{"version":3,"file":"runtime.d.ts","names":[],"sources":["../src/session/journal.ts","../src/runtime/public/contract.ts","../src/runtime/public/probe.ts","../src/runtime/engine/manager.ts","../src/runtime/public/file-session-store.ts","../src/runtime/public/errors.ts","../src/runtime/public/shared.ts","../src/runtime/public/handle-state.ts","../src/runtime/shared.ts","../src/runtime.ts"],"mappings":"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"}
|