@openagentpack/sdk 0.3.2 → 0.4.0-beta-2472720-20260827
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{chunk-GAAU67HX.js → chunk-6PDVAFLK.js} +13 -0
- package/dist/{file-URqwlxLf.d.ts → file-Cj5-Vx27.d.ts} +5 -0
- package/dist/file-lifecycle.d.ts +1 -1
- package/dist/index.d.ts +359 -47
- package/dist/index.js +1982 -511
- package/dist/{session-event-mzuENtyH.d.ts → session-event-DHLkM9iF.d.ts} +20 -8
- package/dist/session-events.d.ts +1 -1
- package/dist/session-events.js +2 -1
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import {
|
|
2
|
-
export { i as ActionType, j as ActionTypeSchema, k as AgentDefinitionSchema, l as AgentDriftSeverity, m as AgentDriftSeveritySchema, n as AgentModel, o as AgentModelSchema, p as AgentReadiness, q as AgentReadinessSchema, r as AgentReadinessStatus, s as AgentReadinessStatusSchema, t as AgentRecoveryAction, u as AgentRecoveryActionSchema, v as AgentSkillRef, w as AgentSkillRefSchema, x as AgentSyncResult, y as AgentSyncResultSchema, z as AgentSyncRunSchema, B as AgentSyncStatus, F as AgentSyncStatusSchema, G as AgentWithReadinessSchema, H as CloudAgentSchema, I as CloudEnvironmentSchema, J as CloudVaultSchema, K as CreateSessionRequest, L as CreateSessionRequestSchema, M as CreateSessionResponse, N as CreateSessionResponseSchema, O as DiagnosticSchema, Q as DiagnosticSeverity, S as DiagnosticSeveritySchema, T as DriftKind, U as DriftKindSchema, V as GetSessionRequest, W as GetSessionRequestSchema, X as KNOWN_SESSION_EVENT_TYPES, Y as KnownSessionEventType, Z as ListCloudAgentsResponse, _ as ListCloudAgentsResponseSchema, $ as ListCloudEnvironmentsResponse, a0 as ListCloudEnvironmentsResponseSchema, a1 as ListSessionEventsRequest, a2 as ListSessionEventsRequestSchema, a3 as ListSessionEventsResponse, a4 as ListSessionEventsResponseSchema, a5 as ListSessionsRequest, a6 as ListSessionsRequestSchema, a7 as ListSessionsResponse, a8 as ListSessionsResponseSchema, a9 as PlanReadinessImpact, aa as PlanReadinessImpactSchema, ab as PlannedActionSchema, ac as ResourceAddressSchema, ad as ResourceTypeSchema, ae as SendEventRequest, af as SendEventRequestSchema, ag as SendEventResponse, ah as SendEventResponseSchema, ai as Session, aj as SessionAgent, ak as SessionAgentSchema, al as SessionContentBlock, am as SessionContentBlockSchema, an as SessionEvent, ao as SessionEventSchema, ap as SessionEventType, aq as SessionEventTypeName, ar as SessionEventTypeSchema, as as SessionSchema } from './session-event-
|
|
3
|
-
import { P as ProviderFileInfo } from './file-
|
|
1
|
+
import { C as CloudAgent, a as CloudEnvironment, b as CloudVault, R as ResourceAddress, c as ResourceType, E as EventStreamOptions, P as ProviderSessionEvent, d as EventListOptions, e as ProviderSessionEventList, f as PlannedAction, D as Diagnostic, A as AgentDefinition, g as AgentWithReadiness, h as AgentSyncRun } from './session-event-DHLkM9iF.js';
|
|
2
|
+
export { i as ActionType, j as ActionTypeSchema, k as AgentDefinitionSchema, l as AgentDriftSeverity, m as AgentDriftSeveritySchema, n as AgentModel, o as AgentModelSchema, p as AgentReadiness, q as AgentReadinessSchema, r as AgentReadinessStatus, s as AgentReadinessStatusSchema, t as AgentRecoveryAction, u as AgentRecoveryActionSchema, v as AgentSkillRef, w as AgentSkillRefSchema, x as AgentSyncResult, y as AgentSyncResultSchema, z as AgentSyncRunSchema, B as AgentSyncStatus, F as AgentSyncStatusSchema, G as AgentWithReadinessSchema, H as CloudAgentSchema, I as CloudEnvironmentSchema, J as CloudVaultSchema, K as CreateSessionRequest, L as CreateSessionRequestSchema, M as CreateSessionResponse, N as CreateSessionResponseSchema, O as DiagnosticSchema, Q as DiagnosticSeverity, S as DiagnosticSeveritySchema, T as DriftKind, U as DriftKindSchema, V as GetSessionRequest, W as GetSessionRequestSchema, X as KNOWN_SESSION_EVENT_TYPES, Y as KnownSessionEventType, Z as ListCloudAgentsResponse, _ as ListCloudAgentsResponseSchema, $ as ListCloudEnvironmentsResponse, a0 as ListCloudEnvironmentsResponseSchema, a1 as ListSessionEventsRequest, a2 as ListSessionEventsRequestSchema, a3 as ListSessionEventsResponse, a4 as ListSessionEventsResponseSchema, a5 as ListSessionsRequest, a6 as ListSessionsRequestSchema, a7 as ListSessionsResponse, a8 as ListSessionsResponseSchema, a9 as PlanReadinessImpact, aa as PlanReadinessImpactSchema, ab as PlannedActionSchema, ac as ResourceAddressSchema, ad as ResourceTypeSchema, ae as SendEventRequest, af as SendEventRequestSchema, ag as SendEventResponse, ah as SendEventResponseSchema, ai as Session, aj as SessionAgent, ak as SessionAgentSchema, al as SessionContentBlock, am as SessionContentBlockSchema, an as SessionEvent, ao as SessionEventSchema, ap as SessionEventType, aq as SessionEventTypeName, ar as SessionEventTypeSchema, as as SessionSchema } from './session-event-DHLkM9iF.js';
|
|
3
|
+
import { P as ProviderFileInfo } from './file-Cj5-Vx27.js';
|
|
4
4
|
import 'zod';
|
|
5
5
|
|
|
6
6
|
declare class UserError extends Error {
|
|
@@ -93,6 +93,7 @@ type CredentialType = "static_bearer" | "environment_variable";
|
|
|
93
93
|
interface CredentialDecl {
|
|
94
94
|
name: string;
|
|
95
95
|
type: CredentialType;
|
|
96
|
+
metadata?: Record<string, string>;
|
|
96
97
|
mcp_server_url?: string;
|
|
97
98
|
access_token?: string;
|
|
98
99
|
protocol?: "sse" | "streamable_http";
|
|
@@ -143,27 +144,45 @@ interface AgentDecl {
|
|
|
143
144
|
mcp_servers?: McpServerDecl[];
|
|
144
145
|
skills?: AgentSkillDecl[];
|
|
145
146
|
vault?: string;
|
|
147
|
+
/** File declarations inherited by a Qoder Forward Template. */
|
|
148
|
+
files?: string[];
|
|
146
149
|
memory_stores?: string[];
|
|
150
|
+
/** Desired display metadata for Qoder Forward's system-managed writable Store. */
|
|
151
|
+
default_memory_store?: DefaultMemoryStoreDecl;
|
|
147
152
|
/** Resources mounted into every managed session created for this agent. */
|
|
148
153
|
resources?: SessionResourceDecl[];
|
|
149
154
|
multiagent?: MultiagentDecl;
|
|
150
155
|
metadata?: Record<string, string>;
|
|
151
156
|
/** Qoder runtime environment variables. Forward delivery stores these as Template defaults. */
|
|
152
157
|
environment_variables?: Record<string, string>;
|
|
158
|
+
/** Provider-side tools the Agent Harness operates itself. Qoder Forward delivery only. */
|
|
159
|
+
managed_tool_config?: ManagedToolConfigDecl;
|
|
153
160
|
/** Provider-specific remote materialization. Omitted means the existing managed Agent resource. */
|
|
154
161
|
delivery?: Record<ProviderName, AgentDeliveryDecl>;
|
|
155
162
|
}
|
|
163
|
+
interface DefaultMemoryStoreDecl {
|
|
164
|
+
name: string;
|
|
165
|
+
description?: string;
|
|
166
|
+
/** Permanently delete the system-managed Store during destroy. Defaults to false. */
|
|
167
|
+
delete_on_destroy?: boolean;
|
|
168
|
+
}
|
|
169
|
+
interface ManagedToolConfigDecl {
|
|
170
|
+
/** Replaces the provider's enabled managed-tool set; an empty array disables all of them. */
|
|
171
|
+
enabled_tools: string[];
|
|
172
|
+
}
|
|
156
173
|
interface AgentDeliveryDecl {
|
|
157
174
|
type: "managed" | "forward";
|
|
158
175
|
}
|
|
159
176
|
interface ChannelDecl {
|
|
160
177
|
provider?: ProviderName;
|
|
161
|
-
/** Logical Agent name. The provider adapter resolves its materialized remote resource. */
|
|
162
|
-
agent
|
|
163
|
-
/** Logical Identity name. Falls back to defaults.identity. */
|
|
178
|
+
/** Logical Agent name. The provider adapter resolves its materialized remote resource. Required for `fixed` mode; ignored for `pairing` mode. */
|
|
179
|
+
agent?: string;
|
|
180
|
+
/** Logical Identity name. Falls back to defaults.identity. Required for `fixed` mode; ignored for `pairing` mode. */
|
|
164
181
|
identity?: string;
|
|
165
182
|
type: string;
|
|
166
183
|
name?: string;
|
|
184
|
+
/** Identity resolution mode. `fixed` binds the channel to one Identity/Template; `pairing` creates a transport-only channel used by Schedules/Sinks. Defaults to `fixed`. */
|
|
185
|
+
mode?: "fixed" | "pairing";
|
|
167
186
|
enabled?: boolean;
|
|
168
187
|
credentials?: Record<string, string>;
|
|
169
188
|
options?: Record<string, unknown>;
|
|
@@ -202,6 +221,7 @@ interface MultiagentDecl {
|
|
|
202
221
|
agents: string[];
|
|
203
222
|
}
|
|
204
223
|
interface DeploymentDecl {
|
|
224
|
+
name?: string;
|
|
205
225
|
agent: string;
|
|
206
226
|
agent_version?: number;
|
|
207
227
|
environment?: string;
|
|
@@ -274,6 +294,111 @@ interface ResolvedProjectConfig extends ProjectConfig {
|
|
|
274
294
|
_resolved: true;
|
|
275
295
|
}
|
|
276
296
|
|
|
297
|
+
interface ProviderSkillInfo {
|
|
298
|
+
id: string;
|
|
299
|
+
name: string;
|
|
300
|
+
description?: string;
|
|
301
|
+
source: "custom" | "official";
|
|
302
|
+
status: "checking" | "active" | "rejected" | "deleted";
|
|
303
|
+
latest_version?: string;
|
|
304
|
+
created_at?: string;
|
|
305
|
+
updated_at?: string;
|
|
306
|
+
attributes?: Record<string, unknown>;
|
|
307
|
+
}
|
|
308
|
+
|
|
309
|
+
interface CursorPage<T> {
|
|
310
|
+
data: T[];
|
|
311
|
+
has_more: boolean;
|
|
312
|
+
next_page?: string;
|
|
313
|
+
}
|
|
314
|
+
interface CursorListOptions {
|
|
315
|
+
limit?: number;
|
|
316
|
+
page?: string;
|
|
317
|
+
}
|
|
318
|
+
interface AgentListOptions extends CursorListOptions {
|
|
319
|
+
include_archived?: boolean;
|
|
320
|
+
}
|
|
321
|
+
type AgentVersionListOptions = CursorListOptions;
|
|
322
|
+
type AgentPage = CursorPage<CloudAgent>;
|
|
323
|
+
interface EnvironmentListOptions extends CursorListOptions {
|
|
324
|
+
include_archived?: boolean;
|
|
325
|
+
}
|
|
326
|
+
type EnvironmentPage = CursorPage<CloudEnvironment>;
|
|
327
|
+
interface VaultListOptions extends CursorListOptions {
|
|
328
|
+
include_archived?: boolean;
|
|
329
|
+
}
|
|
330
|
+
type VaultPage = CursorPage<CloudVault>;
|
|
331
|
+
interface VaultCredentialInfo {
|
|
332
|
+
id: string;
|
|
333
|
+
display_name: string;
|
|
334
|
+
auth_type: string;
|
|
335
|
+
secret_name?: string;
|
|
336
|
+
networking_type?: string;
|
|
337
|
+
metadata?: Record<string, string>;
|
|
338
|
+
}
|
|
339
|
+
interface SkillListOptions extends CursorListOptions {
|
|
340
|
+
source?: "custom" | "official";
|
|
341
|
+
}
|
|
342
|
+
interface SkillVersionInfo {
|
|
343
|
+
id?: string;
|
|
344
|
+
skill_id: string;
|
|
345
|
+
type: string;
|
|
346
|
+
name?: string;
|
|
347
|
+
description?: string;
|
|
348
|
+
version: string;
|
|
349
|
+
status?: string;
|
|
350
|
+
created_at?: string;
|
|
351
|
+
updated_at?: string;
|
|
352
|
+
additional_properties?: Record<string, unknown>;
|
|
353
|
+
attributes: Record<string, unknown>;
|
|
354
|
+
}
|
|
355
|
+
type SkillVersionListOptions = CursorListOptions;
|
|
356
|
+
type SkillVersionPage = CursorPage<SkillVersionInfo>;
|
|
357
|
+
interface SkillDownloadInfo {
|
|
358
|
+
skill_id: string;
|
|
359
|
+
version: string;
|
|
360
|
+
file_url: string;
|
|
361
|
+
}
|
|
362
|
+
type SkillPage = CursorPage<ProviderSkillInfo>;
|
|
363
|
+
interface FileListOptions extends CursorListOptions {
|
|
364
|
+
scope_id?: string;
|
|
365
|
+
}
|
|
366
|
+
type FilePage = CursorPage<ProviderFileInfo>;
|
|
367
|
+
interface SessionUpdateInput {
|
|
368
|
+
title?: string;
|
|
369
|
+
metadata?: Record<string, string>;
|
|
370
|
+
}
|
|
371
|
+
/** Raw AgentStudio message/event input. Provider adapters preserve the wire shape. */
|
|
372
|
+
type SessionEventInput = Record<string, unknown>;
|
|
373
|
+
interface SessionEventSendResult {
|
|
374
|
+
event_ids: string[];
|
|
375
|
+
attributes: Record<string, unknown>;
|
|
376
|
+
}
|
|
377
|
+
interface DeploymentRunInfo {
|
|
378
|
+
id: string;
|
|
379
|
+
deployment_id?: string;
|
|
380
|
+
session_id?: string | null;
|
|
381
|
+
status?: string;
|
|
382
|
+
error?: {
|
|
383
|
+
type?: string;
|
|
384
|
+
message?: string;
|
|
385
|
+
};
|
|
386
|
+
created_at?: string;
|
|
387
|
+
updated_at?: string;
|
|
388
|
+
attributes: Record<string, unknown>;
|
|
389
|
+
}
|
|
390
|
+
type DeploymentRunPage = CursorPage<DeploymentRunInfo>;
|
|
391
|
+
type ManagedAgentOperationAuth = "api_key" | "none";
|
|
392
|
+
interface ManagedAgentOperationCapability {
|
|
393
|
+
supported: boolean;
|
|
394
|
+
auth: ManagedAgentOperationAuth | null;
|
|
395
|
+
reason?: string;
|
|
396
|
+
}
|
|
397
|
+
interface ManagedAgentProviderCapabilities {
|
|
398
|
+
provider: string;
|
|
399
|
+
operations: Record<string, ManagedAgentOperationCapability>;
|
|
400
|
+
}
|
|
401
|
+
|
|
277
402
|
type MemoryMetadata = Record<string, string>;
|
|
278
403
|
interface MemoryStoreInfo {
|
|
279
404
|
id: string;
|
|
@@ -460,6 +585,9 @@ interface ProviderSessionInfo {
|
|
|
460
585
|
}
|
|
461
586
|
interface SessionFilter {
|
|
462
587
|
agent_id?: string;
|
|
588
|
+
statuses?: string[];
|
|
589
|
+
created_at_gte?: string;
|
|
590
|
+
created_at_lte?: string;
|
|
463
591
|
limit?: number;
|
|
464
592
|
page?: string;
|
|
465
593
|
}
|
|
@@ -474,17 +602,6 @@ interface SkillFile {
|
|
|
474
602
|
content: Buffer;
|
|
475
603
|
}
|
|
476
604
|
|
|
477
|
-
interface ProviderSkillInfo {
|
|
478
|
-
id: string;
|
|
479
|
-
name: string;
|
|
480
|
-
description?: string;
|
|
481
|
-
source: "custom" | "official";
|
|
482
|
-
status: "checking" | "active" | "rejected" | "deleted";
|
|
483
|
-
latest_version?: string;
|
|
484
|
-
created_at?: string;
|
|
485
|
-
updated_at?: string;
|
|
486
|
-
}
|
|
487
|
-
|
|
488
605
|
interface ResourceState {
|
|
489
606
|
address: ResourceAddress;
|
|
490
607
|
remote_id: string | null;
|
|
@@ -493,6 +610,8 @@ interface ResourceState {
|
|
|
493
610
|
* referenced by this project. It must never be deleted remotely.
|
|
494
611
|
*/
|
|
495
612
|
externally_managed?: boolean;
|
|
613
|
+
/** Provider API domain that owns the remote resource (currently relevant to Qoder). */
|
|
614
|
+
api_mode?: "managed" | "forward" | "auto";
|
|
496
615
|
version?: number;
|
|
497
616
|
/**
|
|
498
617
|
* Backward-compatible alias for desired_hash. Kept while older state files
|
|
@@ -516,6 +635,15 @@ interface ResourceReadinessBaseline {
|
|
|
516
635
|
}
|
|
517
636
|
interface StateFile {
|
|
518
637
|
resources: ResourceState[];
|
|
638
|
+
pending_default_memory_store_cleanups?: PendingDefaultMemoryStoreCleanup[];
|
|
639
|
+
}
|
|
640
|
+
interface PendingDefaultMemoryStoreCleanup {
|
|
641
|
+
agent_name: string;
|
|
642
|
+
provider: string;
|
|
643
|
+
remote_id: string;
|
|
644
|
+
identity_id?: string;
|
|
645
|
+
template_id?: string;
|
|
646
|
+
last_error?: string;
|
|
519
647
|
}
|
|
520
648
|
|
|
521
649
|
interface RemoteResource {
|
|
@@ -523,6 +651,7 @@ interface RemoteResource {
|
|
|
523
651
|
type: string;
|
|
524
652
|
version?: number;
|
|
525
653
|
}
|
|
654
|
+
type ProviderResourceMode = "managed" | "forward" | "auto";
|
|
526
655
|
interface ModelInfo {
|
|
527
656
|
id: string;
|
|
528
657
|
display_name: string;
|
|
@@ -563,6 +692,11 @@ interface ResolvedTemplateRefs extends ResolvedAgentRefs {
|
|
|
563
692
|
/** Qoder BYOC private-network route used by Forward Templates. */
|
|
564
693
|
tunnel_id?: string;
|
|
565
694
|
vault_ids: string[];
|
|
695
|
+
file_ids?: string[];
|
|
696
|
+
identity_id?: string;
|
|
697
|
+
memory_store_ids?: string[];
|
|
698
|
+
/** Forward Store ids owned by this project and therefore safe to detach during reconciliation. */
|
|
699
|
+
owned_memory_store_ids?: string[];
|
|
566
700
|
}
|
|
567
701
|
interface ResolvedDeploymentRefs {
|
|
568
702
|
agent_id: string;
|
|
@@ -574,8 +708,12 @@ interface ResolvedDeploymentRefs {
|
|
|
574
708
|
memory_store_ids: Record<string, string>;
|
|
575
709
|
}
|
|
576
710
|
interface ResolvedChannelRefs {
|
|
577
|
-
identity_id
|
|
578
|
-
agent_id
|
|
711
|
+
identity_id?: string;
|
|
712
|
+
agent_id?: string;
|
|
713
|
+
}
|
|
714
|
+
interface DefaultMemoryStoreReconcileResult {
|
|
715
|
+
status: "updated" | "unchanged" | "pending";
|
|
716
|
+
memory_store_id?: string;
|
|
579
717
|
}
|
|
580
718
|
interface DeploymentContext {
|
|
581
719
|
id: string | null;
|
|
@@ -609,6 +747,8 @@ interface DeploymentInfo$1 {
|
|
|
609
747
|
}
|
|
610
748
|
interface DeploymentListFilter {
|
|
611
749
|
agent_id?: string;
|
|
750
|
+
/** Bailian server-side fuzzy match against deployment id or name. */
|
|
751
|
+
keyword?: string;
|
|
612
752
|
status?: "active" | "paused";
|
|
613
753
|
include_archived?: boolean;
|
|
614
754
|
limit?: number;
|
|
@@ -636,17 +776,25 @@ interface ProviderAdapter {
|
|
|
636
776
|
* ambiguity of name matching when names are not unique. Without `id`, falls
|
|
637
777
|
* back to listing and matching by `name` (used by conflict adoption).
|
|
638
778
|
*/
|
|
639
|
-
findResource(type: ResourceType, name: string, id?: string | null): Promise<RemoteResource | null>;
|
|
779
|
+
findResource(type: ResourceType, name: string, id?: string | null, mode?: ProviderResourceMode): Promise<RemoteResource | null>;
|
|
640
780
|
listAgents?(filter?: {
|
|
641
781
|
prefix?: string;
|
|
642
782
|
limit?: number;
|
|
643
783
|
}): Promise<CloudAgent[]>;
|
|
784
|
+
/** Cursor-preserving API listing used by command surfaces. */
|
|
785
|
+
listAgentResources?(options?: AgentListOptions): Promise<AgentPage>;
|
|
786
|
+
getRemoteAgent?(id: string, version?: number): Promise<CloudAgent>;
|
|
787
|
+
listAgentVersions?(id: string, options?: AgentVersionListOptions): Promise<AgentPage>;
|
|
644
788
|
listEnvironments?(filter?: {
|
|
645
789
|
limit?: number;
|
|
646
790
|
}): Promise<CloudEnvironment[]>;
|
|
791
|
+
listEnvironmentResources?(options?: EnvironmentListOptions): Promise<EnvironmentPage>;
|
|
792
|
+
getRemoteEnvironment?(id: string): Promise<CloudEnvironment>;
|
|
647
793
|
listVaults?(filter?: {
|
|
648
794
|
limit?: number;
|
|
649
795
|
}): Promise<CloudVault[]>;
|
|
796
|
+
listVaultResources?(options?: VaultListOptions): Promise<VaultPage>;
|
|
797
|
+
getRemoteVault?(id: string): Promise<CloudVault>;
|
|
650
798
|
getDriftSupport?(type: ResourceType): DriftSupport;
|
|
651
799
|
readComparableResource?(type: ResourceType, id: string | null, name: string): Promise<ComparableRemoteResource | null>;
|
|
652
800
|
normalizeDesiredResource?(type: ResourceType, name: string, decl: unknown): unknown | null;
|
|
@@ -656,38 +804,43 @@ interface ProviderAdapter {
|
|
|
656
804
|
* values that the provider does not return are emitted as `${ENV}` placeholders.
|
|
657
805
|
*/
|
|
658
806
|
exportResources?(type: ResourceType): Promise<ExportedResource[]>;
|
|
659
|
-
createEnvironment(name: string, decl: EnvironmentDecl): Promise<RemoteResource>;
|
|
660
|
-
updateEnvironment(id: string, name: string, decl: EnvironmentDecl): Promise<RemoteResource>;
|
|
661
|
-
deleteEnvironment(id: string, cascade?: boolean): Promise<void>;
|
|
662
|
-
createVault(name: string, decl: VaultDecl): Promise<RemoteResource>;
|
|
663
|
-
deleteVault(id: string): Promise<void>;
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
807
|
+
createEnvironment(name: string, decl: EnvironmentDecl, mode?: ProviderResourceMode): Promise<RemoteResource>;
|
|
808
|
+
updateEnvironment(id: string, name: string, decl: EnvironmentDecl, mode?: ProviderResourceMode): Promise<RemoteResource>;
|
|
809
|
+
deleteEnvironment(id: string, cascade?: boolean, mode?: ProviderResourceMode): Promise<void>;
|
|
810
|
+
createVault(name: string, decl: VaultDecl, mode?: ProviderResourceMode): Promise<RemoteResource>;
|
|
811
|
+
deleteVault(id: string, mode?: ProviderResourceMode): Promise<void>;
|
|
812
|
+
createCredential?(vaultId: string, credential: CredentialDecl): Promise<RemoteResource>;
|
|
813
|
+
listCredentials?(vaultId: string): Promise<VaultCredentialInfo[]>;
|
|
814
|
+
createSkill(name: string, decl: SkillDecl, files: SkillFile[], mode?: ProviderResourceMode): Promise<RemoteResource>;
|
|
815
|
+
updateSkill(id: string, name: string, decl: SkillDecl, files: SkillFile[], mode?: ProviderResourceMode): Promise<RemoteResource>;
|
|
816
|
+
deleteSkill(id: string, mode?: ProviderResourceMode): Promise<void>;
|
|
667
817
|
createAgent(name: string, decl: AgentDecl, refs: ResolvedAgentRefs): Promise<RemoteResource>;
|
|
668
818
|
updateAgent(id: string, name: string, decl: AgentDecl, refs: ResolvedAgentRefs): Promise<RemoteResource>;
|
|
669
819
|
deleteAgent(id: string): Promise<void>;
|
|
670
820
|
createTemplate?(name: string, decl: AgentDecl, refs: ResolvedTemplateRefs): Promise<RemoteResource>;
|
|
671
821
|
updateTemplate?(id: string, name: string, decl: AgentDecl, refs: ResolvedTemplateRefs): Promise<RemoteResource>;
|
|
672
822
|
/** Remove the template from desired state. Qoder implements this as a soft archive. */
|
|
673
|
-
archiveTemplate?(id: string): Promise<void>;
|
|
823
|
+
archiveTemplate?(id: string, ownedMemoryStoreIds?: string[]): Promise<void>;
|
|
824
|
+
reconcileDefaultMemoryStore?(identityId: string, templateId: string, desired: DefaultMemoryStoreDecl): Promise<DefaultMemoryStoreReconcileResult>;
|
|
825
|
+
findDefaultMemoryStoreId?(identityId: string, templateId: string): Promise<string | null>;
|
|
826
|
+
deleteDefaultMemoryStore?(id: string): Promise<void>;
|
|
674
827
|
createIdentity?(name: string, decl: IdentityDecl): Promise<RemoteResource>;
|
|
675
828
|
updateIdentity?(id: string, name: string, decl: IdentityDecl): Promise<RemoteResource>;
|
|
676
829
|
deleteIdentity?(id: string): Promise<void>;
|
|
677
830
|
createChannel?(name: string, decl: ChannelDecl, refs: ResolvedChannelRefs): Promise<RemoteResource>;
|
|
678
831
|
updateChannel?(id: string, name: string, decl: ChannelDecl, refs: ResolvedChannelRefs): Promise<RemoteResource>;
|
|
679
832
|
deleteChannel?(id: string): Promise<void>;
|
|
680
|
-
createMemoryStore?(name: string, decl: MemoryStoreDecl): Promise<RemoteResource>;
|
|
681
|
-
deleteMemoryStore?(id: string): Promise<void>;
|
|
833
|
+
createMemoryStore?(name: string, decl: MemoryStoreDecl, mode?: ProviderResourceMode): Promise<RemoteResource>;
|
|
834
|
+
deleteMemoryStore?(id: string, mode?: ProviderResourceMode): Promise<void>;
|
|
682
835
|
listMemoryStores?(options?: MemoryStoreListOptions): Promise<MemoryPage<MemoryStoreInfo>>;
|
|
683
836
|
getMemoryStore?(id: string): Promise<MemoryStoreInfo>;
|
|
684
|
-
updateMemoryStore?(id: string, input: UpdateMemoryStoreInput): Promise<MemoryStoreInfo>;
|
|
837
|
+
updateMemoryStore?(id: string, input: UpdateMemoryStoreInput, mode?: ProviderResourceMode): Promise<MemoryStoreInfo>;
|
|
685
838
|
archiveMemoryStore?(id: string): Promise<MemoryStoreInfo>;
|
|
686
|
-
createMemory?(storeId: string, input: CreateMemoryInput): Promise<MemoryInfo>;
|
|
839
|
+
createMemory?(storeId: string, input: CreateMemoryInput, mode?: ProviderResourceMode): Promise<MemoryInfo>;
|
|
687
840
|
batchCreateMemories?(storeId: string, input: BatchCreateMemoryInput): Promise<BatchCreateMemoryResult>;
|
|
688
|
-
listMemories?(storeId: string, options?: MemoryListOptions): Promise<MemoryPage<MemoryListItem>>;
|
|
841
|
+
listMemories?(storeId: string, options?: MemoryListOptions, mode?: ProviderResourceMode): Promise<MemoryPage<MemoryListItem>>;
|
|
689
842
|
getMemory?(storeId: string, memoryId: string): Promise<MemoryInfo>;
|
|
690
|
-
updateMemory?(storeId: string, memoryId: string, input: UpdateMemoryInput): Promise<MemoryInfo>;
|
|
843
|
+
updateMemory?(storeId: string, memoryId: string, input: UpdateMemoryInput, mode?: ProviderResourceMode): Promise<MemoryInfo>;
|
|
691
844
|
deleteMemory?(storeId: string, memoryId: string, expectedContentSha256?: string): Promise<void>;
|
|
692
845
|
listMemoryVersions?(storeId: string, options?: MemoryVersionListOptions): Promise<MemoryPage<MemoryVersionInfo>>;
|
|
693
846
|
getMemoryVersion?(storeId: string, versionId: string): Promise<MemoryVersionInfo>;
|
|
@@ -698,18 +851,24 @@ interface ProviderAdapter {
|
|
|
698
851
|
runDeployment(ctx: DeploymentContext): Promise<DeploymentRunResult$1>;
|
|
699
852
|
getDeployment(ctx: DeploymentContext): Promise<DeploymentInfo$1>;
|
|
700
853
|
listDeployments?(filter?: DeploymentListFilter): Promise<DeploymentListResult>;
|
|
854
|
+
getDeploymentById?(id: string): Promise<DeploymentInfo$1>;
|
|
855
|
+
runDeploymentById?(id: string): Promise<DeploymentRunResult$1>;
|
|
856
|
+
pauseDeploymentById?(id: string): Promise<DeploymentInfo$1>;
|
|
857
|
+
unpauseDeploymentById?(id: string): Promise<DeploymentInfo$1>;
|
|
858
|
+
listDeploymentRuns?(deploymentId: string, options?: CursorListOptions): Promise<DeploymentRunPage>;
|
|
859
|
+
getDeploymentRun?(runId: string): Promise<DeploymentRunInfo>;
|
|
701
860
|
pauseDeployment?(ctx: DeploymentContext): Promise<DeploymentInfo$1>;
|
|
702
861
|
unpauseDeployment?(ctx: DeploymentContext): Promise<DeploymentInfo$1>;
|
|
703
862
|
uploadFile(filePath: string, options?: {
|
|
704
863
|
name?: string;
|
|
705
864
|
purpose?: string;
|
|
706
|
-
}): Promise<ProviderFileInfo>;
|
|
865
|
+
}, mode?: ProviderResourceMode): Promise<ProviderFileInfo>;
|
|
707
866
|
/** Upload from in-memory content (no filesystem), for server contexts that receive bytes directly (e.g. webui browser uploads). */
|
|
708
867
|
uploadFileContent(content: Uint8Array, filename: string, options?: {
|
|
709
868
|
mimeType?: string;
|
|
710
869
|
purpose?: string;
|
|
711
870
|
}): Promise<ProviderFileInfo>;
|
|
712
|
-
deleteFile(id: string): Promise<void>;
|
|
871
|
+
deleteFile(id: string, mode?: ProviderResourceMode): Promise<void>;
|
|
713
872
|
/** Fetch a single file's metadata (incl. scan `status`); used to gate session binding on availability. */
|
|
714
873
|
getFileInfo?(id: string): Promise<ProviderFileInfo>;
|
|
715
874
|
/**
|
|
@@ -723,14 +882,20 @@ interface ProviderAdapter {
|
|
|
723
882
|
}>;
|
|
724
883
|
/** List workspace user-uploaded files (newest first). Optional — only providers with a list API implement it. */
|
|
725
884
|
listFiles?(): Promise<ProviderFileInfo[]>;
|
|
885
|
+
listFileResources?(options?: FileListOptions): Promise<FilePage>;
|
|
886
|
+
downloadFileContent?(id: string): Promise<Uint8Array>;
|
|
726
887
|
/**
|
|
727
888
|
* List skills (newest first). `source` selects the catalog: "custom" (workspace-uploaded, the
|
|
728
889
|
* default) or "official" (the provider's built-in catalog). Optional — only providers with a
|
|
729
890
|
* list API implement it.
|
|
730
891
|
*/
|
|
731
892
|
listSkills?(source?: "custom" | "official"): Promise<ProviderSkillInfo[]>;
|
|
893
|
+
listSkillResources?(options?: SkillListOptions): Promise<SkillPage>;
|
|
732
894
|
/** Fetch a single skill's metadata (incl. scan `status`); used to poll create → active. */
|
|
733
895
|
getSkillInfo?(id: string): Promise<ProviderSkillInfo>;
|
|
896
|
+
listSkillVersions?(id: string, options?: SkillVersionListOptions): Promise<SkillVersionPage>;
|
|
897
|
+
getSkillVersion?(id: string, version: string): Promise<SkillVersionInfo>;
|
|
898
|
+
getSkillDownloadInfo?(id: string, version: string): Promise<SkillDownloadInfo>;
|
|
734
899
|
/**
|
|
735
900
|
* Create a skill from an already-uploaded zip's file_id and return immediately with the
|
|
736
901
|
* initial (usually `checking`) status. NON-blocking — unlike `createSkill`, it does NOT wait
|
|
@@ -740,8 +905,11 @@ interface ProviderAdapter {
|
|
|
740
905
|
createSession(bindings: SessionBindings): Promise<ProviderSessionInfo>;
|
|
741
906
|
listSessions(filter?: SessionFilter): Promise<SessionListResult>;
|
|
742
907
|
getSession(id: string): Promise<ProviderSessionInfo>;
|
|
908
|
+
updateSession?(id: string, input: SessionUpdateInput): Promise<ProviderSessionInfo>;
|
|
909
|
+
archiveSession?(id: string): Promise<ProviderSessionInfo>;
|
|
743
910
|
deleteSession(id: string): Promise<void>;
|
|
744
911
|
sendSessionMessage(sessionId: string, message: string): Promise<string | undefined>;
|
|
912
|
+
sendSessionEvents?(sessionId: string, events: SessionEventInput[]): Promise<SessionEventSendResult>;
|
|
745
913
|
streamSessionEvents(sessionId: string, options?: EventStreamOptions): AsyncIterable<ProviderSessionEvent>;
|
|
746
914
|
listSessionEvents(sessionId: string, options?: EventListOptions): Promise<ProviderSessionEventList>;
|
|
747
915
|
listModels?(): Promise<ModelInfo[]>;
|
|
@@ -888,11 +1056,18 @@ type RuntimeFeedbackSink = (event: RuntimeFeedbackEvent) => void;
|
|
|
888
1056
|
|
|
889
1057
|
interface ResourceRuntimeOptions extends DestructiveDecisionOptions {
|
|
890
1058
|
provider?: string;
|
|
1059
|
+
scope?: ResourcePlanScope;
|
|
1060
|
+
mode?: ResourceSyncMode;
|
|
891
1061
|
refresh?: boolean;
|
|
892
1062
|
refreshOnly?: boolean;
|
|
893
1063
|
quiet?: boolean;
|
|
894
1064
|
onFeedback?: RuntimeFeedbackSink;
|
|
895
1065
|
}
|
|
1066
|
+
type ResourceSyncMode = "reconcile" | "create-only";
|
|
1067
|
+
interface ResourcePlanScope {
|
|
1068
|
+
roots: ResourceAddress[];
|
|
1069
|
+
includeDependencies?: boolean;
|
|
1070
|
+
}
|
|
896
1071
|
interface ResourceRefreshResult {
|
|
897
1072
|
removed: ResourceState[];
|
|
898
1073
|
errors: Array<{
|
|
@@ -915,6 +1090,8 @@ interface ResourcePlanResult {
|
|
|
915
1090
|
refreshResult?: ResourceRefreshResult;
|
|
916
1091
|
targetProviders?: string[];
|
|
917
1092
|
destructiveActions: PlannedAction[];
|
|
1093
|
+
selectedAddresses?: ResourceAddress[];
|
|
1094
|
+
mode?: ResourceSyncMode;
|
|
918
1095
|
}
|
|
919
1096
|
type DestructivePolicy = "block" | "prompt" | "force";
|
|
920
1097
|
interface DestructiveDecisionOptions {
|
|
@@ -925,6 +1102,7 @@ interface ResourceSyncRun {
|
|
|
925
1102
|
planned: ResourcePlanResult;
|
|
926
1103
|
execution?: ResourceExecutionResult;
|
|
927
1104
|
}
|
|
1105
|
+
declare function planProjectWithStateBackend(input: BackendRuntimeInput, options?: ResourceRuntimeOptions): Promise<ResourcePlanResult>;
|
|
928
1106
|
declare function syncProjectResourcesWithStateBackend(input: BackendRuntimeInput, options?: ResourceRuntimeOptions): Promise<ResourceSyncRun>;
|
|
929
1107
|
declare function importResource(ctx: ProjectRuntimeContext, address: ResourceAddress, remoteId: string, options?: {
|
|
930
1108
|
resourceVersion?: number;
|
|
@@ -1079,6 +1257,105 @@ declare function runDeploymentForContext(ctx: ProjectRuntimeContext, name: strin
|
|
|
1079
1257
|
declare function pauseDeploymentForContext(ctx: ProjectRuntimeContext, name: string, paused: boolean, resolvedProvider?: string): Promise<DeploymentInfo$1>;
|
|
1080
1258
|
declare function getDeploymentRuntimeProviderForContext(ctx: ProjectRuntimeContext, name: string, overrideProvider?: string): string;
|
|
1081
1259
|
|
|
1260
|
+
interface ManagedApiTarget {
|
|
1261
|
+
provider?: string;
|
|
1262
|
+
}
|
|
1263
|
+
declare function listRemoteAgents(ctx: ProjectRuntimeContext, options?: ManagedApiTarget & AgentListOptions): Promise<AgentPage>;
|
|
1264
|
+
declare function getRemoteAgent(ctx: ProjectRuntimeContext, id: string, options?: ManagedApiTarget & {
|
|
1265
|
+
version?: number;
|
|
1266
|
+
}): Promise<{
|
|
1267
|
+
id: string;
|
|
1268
|
+
name?: string | undefined;
|
|
1269
|
+
description?: string | null | undefined;
|
|
1270
|
+
model?: unknown;
|
|
1271
|
+
system?: string | undefined;
|
|
1272
|
+
tools?: unknown;
|
|
1273
|
+
skills?: unknown;
|
|
1274
|
+
mcp_servers?: unknown;
|
|
1275
|
+
metadata?: Record<string, string> | undefined;
|
|
1276
|
+
version?: number | undefined;
|
|
1277
|
+
type?: string | undefined;
|
|
1278
|
+
workspace_id?: string | undefined;
|
|
1279
|
+
created_at?: string | undefined;
|
|
1280
|
+
updated_at?: string | undefined;
|
|
1281
|
+
archived_at?: string | null | undefined;
|
|
1282
|
+
attributes?: Record<string, unknown> | undefined;
|
|
1283
|
+
}>;
|
|
1284
|
+
declare function listRemoteAgentVersions(ctx: ProjectRuntimeContext, id: string, options?: ManagedApiTarget & AgentVersionListOptions): Promise<AgentPage>;
|
|
1285
|
+
declare function listRemoteEnvironments(ctx: ProjectRuntimeContext, options?: ManagedApiTarget & EnvironmentListOptions): Promise<EnvironmentPage>;
|
|
1286
|
+
declare function getRemoteEnvironment(ctx: ProjectRuntimeContext, id: string, options?: ManagedApiTarget): Promise<{
|
|
1287
|
+
id: string;
|
|
1288
|
+
name?: string | undefined;
|
|
1289
|
+
description?: string | null | undefined;
|
|
1290
|
+
config?: unknown;
|
|
1291
|
+
metadata?: Record<string, string> | undefined;
|
|
1292
|
+
scope?: string | undefined;
|
|
1293
|
+
version?: number | undefined;
|
|
1294
|
+
type?: string | undefined;
|
|
1295
|
+
workspace_id?: string | undefined;
|
|
1296
|
+
created_at?: string | undefined;
|
|
1297
|
+
updated_at?: string | undefined;
|
|
1298
|
+
archived_at?: string | null | undefined;
|
|
1299
|
+
attributes?: Record<string, unknown> | undefined;
|
|
1300
|
+
}>;
|
|
1301
|
+
declare function listRemoteVaults(ctx: ProjectRuntimeContext, options?: ManagedApiTarget & VaultListOptions): Promise<VaultPage>;
|
|
1302
|
+
declare function getRemoteVault(ctx: ProjectRuntimeContext, id: string, options?: ManagedApiTarget): Promise<{
|
|
1303
|
+
id: string;
|
|
1304
|
+
display_name?: string | undefined;
|
|
1305
|
+
metadata?: Record<string, string> | undefined;
|
|
1306
|
+
type?: string | undefined;
|
|
1307
|
+
created_at?: string | null | undefined;
|
|
1308
|
+
updated_at?: string | null | undefined;
|
|
1309
|
+
archived_at?: string | null | undefined;
|
|
1310
|
+
attributes?: Record<string, unknown> | undefined;
|
|
1311
|
+
}>;
|
|
1312
|
+
declare function listRemoteSkills(ctx: ProjectRuntimeContext, options?: ManagedApiTarget & SkillListOptions): Promise<SkillPage>;
|
|
1313
|
+
declare function getRemoteSkill(ctx: ProjectRuntimeContext, id: string, options?: ManagedApiTarget): Promise<ProviderSkillInfo>;
|
|
1314
|
+
declare function listRemoteSkillVersions(ctx: ProjectRuntimeContext, id: string, options?: ManagedApiTarget & SkillVersionListOptions): Promise<SkillVersionPage>;
|
|
1315
|
+
declare function getRemoteSkillVersion(ctx: ProjectRuntimeContext, id: string, version: string, options?: ManagedApiTarget): Promise<SkillVersionInfo>;
|
|
1316
|
+
declare function getRemoteSkillDownloadInfo(ctx: ProjectRuntimeContext, id: string, version: string, options?: ManagedApiTarget): Promise<SkillDownloadInfo>;
|
|
1317
|
+
declare function downloadRemoteSkill(ctx: ProjectRuntimeContext, id: string, version: string, options?: ManagedApiTarget): Promise<Uint8Array>;
|
|
1318
|
+
declare function listRemoteFiles(ctx: ProjectRuntimeContext, options?: ManagedApiTarget & FileListOptions): Promise<FilePage>;
|
|
1319
|
+
declare function downloadRemoteFile(ctx: ProjectRuntimeContext, id: string, options?: ManagedApiTarget): Promise<Uint8Array>;
|
|
1320
|
+
declare function updateRemoteSession(ctx: ProjectRuntimeContext, id: string, input: SessionUpdateInput, options?: ManagedApiTarget): Promise<ProviderSessionInfo>;
|
|
1321
|
+
declare function archiveRemoteSession(ctx: ProjectRuntimeContext, id: string, options?: ManagedApiTarget): Promise<ProviderSessionInfo>;
|
|
1322
|
+
declare function sendRemoteSessionEvents(ctx: ProjectRuntimeContext, id: string, events: SessionEventInput[], options?: ManagedApiTarget): Promise<SessionEventSendResult>;
|
|
1323
|
+
declare function listRemoteDeployments(ctx: ProjectRuntimeContext, options?: ManagedApiTarget & DeploymentListFilter): Promise<DeploymentListResult>;
|
|
1324
|
+
declare function getRemoteDeployment(ctx: ProjectRuntimeContext, id: string, options?: ManagedApiTarget): Promise<DeploymentInfo$1>;
|
|
1325
|
+
declare function runRemoteDeployment(ctx: ProjectRuntimeContext, id: string, options?: ManagedApiTarget): Promise<DeploymentRunResult$1>;
|
|
1326
|
+
declare function setRemoteDeploymentPaused(ctx: ProjectRuntimeContext, id: string, paused: boolean, options?: ManagedApiTarget): Promise<DeploymentInfo$1>;
|
|
1327
|
+
declare function listRemoteDeploymentRuns(ctx: ProjectRuntimeContext, deploymentId: string, options?: ManagedApiTarget & {
|
|
1328
|
+
limit?: number;
|
|
1329
|
+
page?: string;
|
|
1330
|
+
}): Promise<DeploymentRunPage>;
|
|
1331
|
+
declare function getRemoteDeploymentRun(ctx: ProjectRuntimeContext, runId: string, options?: ManagedApiTarget): Promise<DeploymentRunInfo>;
|
|
1332
|
+
declare function getManagedAgentProviderCapabilities(provider: string): ManagedAgentProviderCapabilities;
|
|
1333
|
+
|
|
1334
|
+
interface VaultCredentialCreateOptions {
|
|
1335
|
+
provider?: string;
|
|
1336
|
+
refresh?: boolean;
|
|
1337
|
+
quiet?: boolean;
|
|
1338
|
+
/** Set false only for an offline preview; create always requires the remote duplicate check. */
|
|
1339
|
+
checkRemote?: boolean;
|
|
1340
|
+
}
|
|
1341
|
+
interface VaultCredentialCreatePlan {
|
|
1342
|
+
provider: string;
|
|
1343
|
+
vault: string;
|
|
1344
|
+
vaultRemoteId: string;
|
|
1345
|
+
credential: string;
|
|
1346
|
+
remoteChecked: boolean;
|
|
1347
|
+
reuseRemote: boolean;
|
|
1348
|
+
remoteCredentialId?: string;
|
|
1349
|
+
}
|
|
1350
|
+
interface VaultCredentialCreateResult extends VaultCredentialCreatePlan {
|
|
1351
|
+
credentialId: string;
|
|
1352
|
+
adopted: boolean;
|
|
1353
|
+
}
|
|
1354
|
+
declare function planVaultCredentialCreate(ctx: ProjectRuntimeContext, vaultName: string, credentialName: string, options?: VaultCredentialCreateOptions): Promise<VaultCredentialCreatePlan>;
|
|
1355
|
+
declare function planVaultCredentialCreateWithStateBackend(input: BackendRuntimeInput, vaultName: string, credentialName: string, options?: VaultCredentialCreateOptions): Promise<VaultCredentialCreatePlan>;
|
|
1356
|
+
declare function createVaultCredential(ctx: ProjectRuntimeContext, vaultName: string, credentialName: string, options?: VaultCredentialCreateOptions): Promise<VaultCredentialCreateResult>;
|
|
1357
|
+
declare function createVaultCredentialWithStateBackend(input: BackendRuntimeInput, vaultName: string, credentialName: string, options?: VaultCredentialCreateOptions): Promise<VaultCredentialCreateResult>;
|
|
1358
|
+
|
|
1082
1359
|
type DestroyResourceStatus = "success" | "failed" | "blocked" | "skipped";
|
|
1083
1360
|
type DestroyResourceResultReason = "destroyed" | "reference_removed" | "already_gone" | "cascade_required" | "provider_missing" | "failed" | "skipped";
|
|
1084
1361
|
interface DestroyResourceResult {
|
|
@@ -1090,17 +1367,34 @@ interface DestroyResourceResult {
|
|
|
1090
1367
|
}
|
|
1091
1368
|
interface DestroyPlanResult {
|
|
1092
1369
|
resources: ResourceState[];
|
|
1370
|
+
defaultMemoryStores: DestroyDefaultMemoryStorePlan[];
|
|
1093
1371
|
executionContext: ProjectRuntimeContext;
|
|
1094
1372
|
}
|
|
1373
|
+
interface DestroyDefaultMemoryStorePlan {
|
|
1374
|
+
agentName: string;
|
|
1375
|
+
provider: string;
|
|
1376
|
+
identityId: string | null;
|
|
1377
|
+
templateId: string | null;
|
|
1378
|
+
deleteOnDestroy: boolean;
|
|
1379
|
+
memoryStoreId?: string;
|
|
1380
|
+
}
|
|
1381
|
+
interface DestroyDefaultMemoryStoreResult extends DestroyDefaultMemoryStorePlan {
|
|
1382
|
+
status: "retained" | "deleted" | "already_gone" | "failed";
|
|
1383
|
+
memoryStoreId?: string;
|
|
1384
|
+
error?: string;
|
|
1385
|
+
}
|
|
1095
1386
|
interface DestroyProjectOptions {
|
|
1096
1387
|
cascade?: boolean;
|
|
1097
1388
|
onFeedback?: RuntimeFeedbackSink;
|
|
1098
1389
|
onResourceStart?: (resource: ResourceState) => void;
|
|
1099
1390
|
onResourceResult?: (result: DestroyResourceResult) => void;
|
|
1100
1391
|
onCascadeRequired?: (result: DestroyResourceResult) => boolean | Promise<boolean>;
|
|
1392
|
+
/** Override bounded cleanup backoff, primarily for deterministic tests. */
|
|
1393
|
+
defaultMemoryStoreRetryDelaysMs?: number[];
|
|
1101
1394
|
}
|
|
1102
1395
|
interface DestroyProjectResult extends DestroyPlanResult {
|
|
1103
1396
|
results: DestroyResourceResult[];
|
|
1397
|
+
defaultMemoryStoreResults: DestroyDefaultMemoryStoreResult[];
|
|
1104
1398
|
destroyed: number;
|
|
1105
1399
|
partial: boolean;
|
|
1106
1400
|
}
|
|
@@ -1175,6 +1469,7 @@ interface AgentMcpBuildInput {
|
|
|
1175
1469
|
}>;
|
|
1176
1470
|
}
|
|
1177
1471
|
interface AgentBuildInput {
|
|
1472
|
+
name?: string;
|
|
1178
1473
|
description?: string;
|
|
1179
1474
|
model?: AgentDecl["model"];
|
|
1180
1475
|
instructions?: string;
|
|
@@ -1198,10 +1493,20 @@ interface BuiltAgent {
|
|
|
1198
1493
|
*/
|
|
1199
1494
|
declare function buildAgentDecl(base: AgentDecl | undefined, input: AgentBuildInput): BuiltAgent;
|
|
1200
1495
|
|
|
1496
|
+
interface AgentResourcePlan {
|
|
1497
|
+
agentId: string;
|
|
1498
|
+
provider: string;
|
|
1499
|
+
actions: PlannedAction[];
|
|
1500
|
+
diagnostics: Diagnostic[];
|
|
1501
|
+
destructiveActions: PlannedAction[];
|
|
1502
|
+
planned: ResourcePlanResult;
|
|
1503
|
+
}
|
|
1201
1504
|
interface AgentResourcePlanOptions {
|
|
1202
1505
|
refresh?: boolean;
|
|
1203
1506
|
quiet?: boolean;
|
|
1507
|
+
mode?: AgentResourceSyncMode;
|
|
1204
1508
|
}
|
|
1509
|
+
type AgentResourceSyncMode = ResourceSyncMode;
|
|
1205
1510
|
interface AgentResourceSyncOptions extends AgentResourcePlanOptions {
|
|
1206
1511
|
policy?: DestructivePolicy;
|
|
1207
1512
|
confirm?: (actions: PlannedAction[]) => boolean | Promise<boolean>;
|
|
@@ -1261,6 +1566,8 @@ declare function getAgent(ctx: ProjectRuntimeContext, agentId: string): AgentDef
|
|
|
1261
1566
|
declare function listAgentsWithReadiness(ctx: ProjectRuntimeContext, options?: {
|
|
1262
1567
|
refresh?: boolean;
|
|
1263
1568
|
}): Promise<AgentWithReadiness[]>;
|
|
1569
|
+
declare function planAgentResources(ctx: ProjectRuntimeContext, agentId: string, options?: AgentResourcePlanOptions): Promise<AgentResourcePlan>;
|
|
1570
|
+
declare function planAgentResourcesWithStateBackend(input: BackendRuntimeInput, agentId: string, options?: AgentResourcePlanOptions): Promise<AgentResourcePlan>;
|
|
1264
1571
|
declare function syncAgentResourcesWithStateBackend(input: BackendRuntimeInput, agentId: string, options?: AgentResourceSyncOptions): Promise<AgentSyncRun>;
|
|
1265
1572
|
|
|
1266
1573
|
interface SessionCreateOptions {
|
|
@@ -1352,12 +1659,7 @@ declare function listSessionSummaries(ctx: ProjectRuntimeContext, options?: Sess
|
|
|
1352
1659
|
}): Promise<SessionSummaryList>;
|
|
1353
1660
|
declare function getSession(ctx: ProjectRuntimeContext, sessionId: string, provider?: string): Promise<ProviderSessionInfo>;
|
|
1354
1661
|
declare function deleteSession(ctx: ProjectRuntimeContext, sessionId: string, provider?: string): Promise<void>;
|
|
1355
|
-
declare function listSessionEvents(ctx: ProjectRuntimeContext, sessionId: string, options?: SessionRuntimeTarget &
|
|
1356
|
-
limit?: number;
|
|
1357
|
-
order?: string;
|
|
1358
|
-
page_token?: string;
|
|
1359
|
-
page?: string;
|
|
1360
|
-
}): Promise<ProviderSessionEventList>;
|
|
1662
|
+
declare function listSessionEvents(ctx: ProjectRuntimeContext, sessionId: string, options?: SessionRuntimeTarget & EventListOptions): Promise<ProviderSessionEventList>;
|
|
1361
1663
|
/**
|
|
1362
1664
|
* Upload a file's raw bytes to the resolved provider's Files API and return its metadata.
|
|
1363
1665
|
* Content-based (no filesystem) so server contexts can forward browser uploads directly.
|
|
@@ -1397,9 +1699,9 @@ declare function createSkillFromFileId(ctx: ProjectRuntimeContext, fileId: strin
|
|
|
1397
1699
|
/** Delete a custom skill by id from the resolved provider's Skills API. */
|
|
1398
1700
|
declare function deleteSkill(ctx: ProjectRuntimeContext, id: string, options?: SessionRuntimeTarget): Promise<void>;
|
|
1399
1701
|
/**
|
|
1400
|
-
* Subscribe to a session's
|
|
1401
|
-
*
|
|
1402
|
-
*
|
|
1702
|
+
* Subscribe to a session's event stream by id. Providers with native cursor support receive
|
|
1703
|
+
* `after_id` directly; providers without it resume by replaying paginated history and polling
|
|
1704
|
+
* for new events with event-id de-duplication.
|
|
1403
1705
|
*/
|
|
1404
1706
|
declare function streamSessionEvents(ctx: ProjectRuntimeContext, sessionId: string, options?: SessionRuntimeTarget & EventStreamOptions): AsyncIterable<ProviderSessionEvent>;
|
|
1405
1707
|
|
|
@@ -1484,4 +1786,14 @@ declare class LocalFileStateBackend implements StateBackend {
|
|
|
1484
1786
|
/** Normalize a skill zip and extract its entries to SkillFile[]. */
|
|
1485
1787
|
declare function extractSkillZipFiles(raw: Buffer): Promise<SkillFile[]>;
|
|
1486
1788
|
|
|
1487
|
-
|
|
1789
|
+
interface SkillSourceInspection {
|
|
1790
|
+
name: string;
|
|
1791
|
+
sourcePath: string;
|
|
1792
|
+
files: SkillFile[];
|
|
1793
|
+
}
|
|
1794
|
+
/** Inspect and normalize a local Skill directory, zip, or single SKILL.md. */
|
|
1795
|
+
declare function inspectSkillSource(source: string, options?: {
|
|
1796
|
+
basePath?: string;
|
|
1797
|
+
}): Promise<SkillSourceInspection>;
|
|
1798
|
+
|
|
1799
|
+
export { AGENTS_CONFIG_PROVIDERS, AGENTS_PROVIDER_FIELDS, type AgentBuildInput, AgentDefinition, type AgentListOptions, type AgentMcpBuildInput, type AgentPage, type AgentResourcePlan, type AgentResourcePlanOptions, type AgentResourceSyncMode, type AgentResourceSyncOptions, type AgentSkillBuildInput, AgentSyncRun, type AgentVersionListOptions, AgentWithReadiness, ApiError, type BackendRuntimeInput, type BatchCreateMemoryInput, type BatchCreateMemoryResult, CloudAgent, CloudEnvironment, CloudVault, type CollectedSessionEvents, ConflictError, type CreateMemoryInput, type CreateMemoryStoreInput, type CredentialDecl, type CursorListOptions, type CursorPage, type DeploymentDecl, type DeploymentInfo$1 as DeploymentInfo, type DeploymentListFilter, type DeploymentListResult, type DeploymentRunInfo, type DeploymentRunPage, type DeploymentRunResult$1 as DeploymentRunResult, type DestroyDefaultMemoryStoreResult, type DestroyResourceResult, type DestructivePolicy, Diagnostic, type EnvironmentDecl, type EnvironmentListOptions, type EnvironmentPage, EventListOptions, EventStreamOptions, type FetchLike, type FileListOptions, type FilePage, type IStateManager, type LoadedProjectConfig, LocalFileStateBackend, type ManagedAgentOperationAuth, type ManagedAgentOperationCapability, type ManagedAgentProviderCapabilities, type ManagedApiTarget, type MemoryInfo, type MemoryListItem, type MemoryListOptions, type MemoryPage, type MemoryPrefixInfo, type MemoryProviderCapabilities, type MemoryStoreInfo, type MemoryStoreListOptions, type MemoryVersionInfo, type MemoryVersionListOptions, type MigrateOptions, type MigrateResult, PlannedAction, type ProjectConfig, type ProjectRuntimeContext, type ProviderConfig, type ProviderConfigProvider, ProviderFileInfo, ProviderSessionEvent, ProviderSessionEventList, type ProviderSessionInfo, type ProviderSkillInfo, type ResolvedProjectConfig, type ResourceActionResult, ResourceAddress, type ResourceExecutionResult, type ResourcePlanResult, type ResourcePlanScope, type ResourceRefreshResult, type ResourceRuntimeOptions, type ResourceState, type ResourceSyncMode, type ResourceSyncRun, ResourceType, type RuntimeFeedbackEvent, type RuntimeFeedbackSink, type SecretPlaceholder, type SessionEventInput, type SessionEventSendResult, type SessionFilter, type SessionListResult, type SessionUpdateInput, type SkillDecl, type SkillDownloadInfo, type SkillFile, type SkillListOptions, type SkillPage, type SkillSourceInspection, type SkillVersionInfo, type SkillVersionListOptions, type SkillVersionPage, StateManager, type StateScope, type SyncProjectOptions, type SyncProjectResult, type UpdateMemoryInput, type UpdateMemoryStoreInput, UserError, type ValidateProjectConfigOptions, type VaultCredentialCreateOptions, type VaultCredentialCreatePlan, type VaultCredentialCreateResult, type VaultCredentialInfo, type VaultDecl, type VaultListOptions, type VaultPage, applyProviderConfigToEnv, archiveCloudAgent, archiveMemoryStore, archiveRemoteSession, areRuntimeCredentialsReady, batchCreateMemories, bootstrapRuntimeCredentials, bootstrapRuntimeCredentialsSync, buildAgentDecl, collectConfigReferences, createCloudEnvironment, createCloudVault, createMemory, createMemoryStore, createProjectRuntime, createSessionForAgent, createSkillFromFileId, createVaultCredential, createVaultCredentialWithStateBackend, decideDestructive, deleteCloudEnvironment, deleteCloudVault, deleteFile, deleteMemory, deleteMemoryStore, deleteSession, deleteSkill, destroyPlannedProjectResources, downloadRemoteFile, downloadRemoteSkill, executePlannedProject, extractSkillZipFiles, getAgent, getDeploymentDetailsForContext, getDeploymentRuntimeProviderForContext, getFileDownloadUrl, getFileInfo, getManagedAgentProviderCapabilities, getMemory, getMemoryProviderCapabilities, getMemoryStore, getMemoryVersion, getRemoteAgent, getRemoteDeployment, getRemoteDeploymentRun, getRemoteEnvironment, getRemoteSkill, getRemoteSkillDownloadInfo, getRemoteSkillVersion, getRemoteVault, getSession, getSkillInfo, importResource, inspectSkillSource, isTerminalSessionStatus, listAgentsWithReadiness, listCloudAgents, listCloudEnvironments, listCloudVaults, listDeploymentsForContext, listFiles, listMemories, listMemoryStores, listMemoryVersions, listProviderModelsForContext, listProviderNames, listRemoteAgentVersions, listRemoteAgents, listRemoteDeploymentRuns, listRemoteDeployments, listRemoteDeploymentsForContext, listRemoteEnvironments, listRemoteFiles, listRemoteSkillVersions, listRemoteSkills, listRemoteVaults, listSessionEvents, listSessionSummaries, listSkills, loadDotEnv, loadProviderConfigIntoEnv, loadProviderConfigIntoEnvSync, migrateConfig, parseStateAddress, pauseDeploymentForContext, planAgentResources, planAgentResourcesWithStateBackend, planDestroyProjectContext, planProjectContext, planProjectWithStateBackend, planVaultCredentialCreate, planVaultCredentialCreateWithStateBackend, prepareInitialSessionPrompt, preparePromptForProvider, prependFileHint, providerConfigPath, readProjectRuntime, redactMemoryVersion, resolveActiveProvider, resolveProjectConfig, resolveProjectConfigFromObject, resolveProviderConfigFromEnv, resolveRepositoryMountPath, resolveSessionProvider, resolveSyncProvider, rewriteFileMentions, runDeploymentForContext, runRemoteDeployment, sendRemoteSessionEvents, sendSessionMessagePolling, sendSessionMessageStreaming, setDefaultFetch, setRemoteDeploymentPaused, startSessionRun, startSessionRunPolling, streamSessionEvents, syncAgentResourcesWithStateBackend, syncProjectResourcesWithStateBackend, syncProviderResourcesFromContext, syncProviderResourcesFromEnv, updateMemory, updateMemoryStore, updateRemoteSession, uploadFile, validateProjectConfig, writeProjectRuntime };
|