@openagentpack/sdk 0.3.1 → 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 +370 -48
- package/dist/index.js +2486 -632
- package/dist/{session-event-CxLg_XqS.d.ts → session-event-DHLkM9iF.d.ts} +132 -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 {
|
|
@@ -59,6 +59,8 @@ interface EnvironmentConfig {
|
|
|
59
59
|
type: "cloud" | "self_hosted";
|
|
60
60
|
networking?: NetworkingConfig;
|
|
61
61
|
packages?: PackagesConfig;
|
|
62
|
+
/** Shell script executed by supported providers while preparing a sandbox. */
|
|
63
|
+
setup_script?: string;
|
|
62
64
|
}
|
|
63
65
|
interface TunnelDecl {
|
|
64
66
|
name?: string;
|
|
@@ -91,6 +93,7 @@ type CredentialType = "static_bearer" | "environment_variable";
|
|
|
91
93
|
interface CredentialDecl {
|
|
92
94
|
name: string;
|
|
93
95
|
type: CredentialType;
|
|
96
|
+
metadata?: Record<string, string>;
|
|
94
97
|
mcp_server_url?: string;
|
|
95
98
|
access_token?: string;
|
|
96
99
|
protocol?: "sse" | "streamable_http";
|
|
@@ -141,25 +144,45 @@ interface AgentDecl {
|
|
|
141
144
|
mcp_servers?: McpServerDecl[];
|
|
142
145
|
skills?: AgentSkillDecl[];
|
|
143
146
|
vault?: string;
|
|
147
|
+
/** File declarations inherited by a Qoder Forward Template. */
|
|
148
|
+
files?: string[];
|
|
144
149
|
memory_stores?: string[];
|
|
150
|
+
/** Desired display metadata for Qoder Forward's system-managed writable Store. */
|
|
151
|
+
default_memory_store?: DefaultMemoryStoreDecl;
|
|
145
152
|
/** Resources mounted into every managed session created for this agent. */
|
|
146
153
|
resources?: SessionResourceDecl[];
|
|
147
154
|
multiagent?: MultiagentDecl;
|
|
148
155
|
metadata?: Record<string, string>;
|
|
156
|
+
/** Qoder runtime environment variables. Forward delivery stores these as Template defaults. */
|
|
157
|
+
environment_variables?: Record<string, string>;
|
|
158
|
+
/** Provider-side tools the Agent Harness operates itself. Qoder Forward delivery only. */
|
|
159
|
+
managed_tool_config?: ManagedToolConfigDecl;
|
|
149
160
|
/** Provider-specific remote materialization. Omitted means the existing managed Agent resource. */
|
|
150
161
|
delivery?: Record<ProviderName, AgentDeliveryDecl>;
|
|
151
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
|
+
}
|
|
152
173
|
interface AgentDeliveryDecl {
|
|
153
174
|
type: "managed" | "forward";
|
|
154
175
|
}
|
|
155
176
|
interface ChannelDecl {
|
|
156
177
|
provider?: ProviderName;
|
|
157
|
-
/** Logical Agent name. The provider adapter resolves its materialized remote resource. */
|
|
158
|
-
agent
|
|
159
|
-
/** 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. */
|
|
160
181
|
identity?: string;
|
|
161
182
|
type: string;
|
|
162
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";
|
|
163
186
|
enabled?: boolean;
|
|
164
187
|
credentials?: Record<string, string>;
|
|
165
188
|
options?: Record<string, unknown>;
|
|
@@ -198,6 +221,7 @@ interface MultiagentDecl {
|
|
|
198
221
|
agents: string[];
|
|
199
222
|
}
|
|
200
223
|
interface DeploymentDecl {
|
|
224
|
+
name?: string;
|
|
201
225
|
agent: string;
|
|
202
226
|
agent_version?: number;
|
|
203
227
|
environment?: string;
|
|
@@ -270,6 +294,111 @@ interface ResolvedProjectConfig extends ProjectConfig {
|
|
|
270
294
|
_resolved: true;
|
|
271
295
|
}
|
|
272
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
|
+
|
|
273
402
|
type MemoryMetadata = Record<string, string>;
|
|
274
403
|
interface MemoryStoreInfo {
|
|
275
404
|
id: string;
|
|
@@ -418,6 +547,8 @@ interface CommonSessionBindings {
|
|
|
418
547
|
resources?: SessionResource[];
|
|
419
548
|
title?: string;
|
|
420
549
|
metadata?: Record<string, string>;
|
|
550
|
+
/** Provider-neutral representation; Qoder maps it to each Session API's wire shape. */
|
|
551
|
+
environment_variables?: Record<string, string>;
|
|
421
552
|
}
|
|
422
553
|
interface ManagedSessionBindings extends CommonSessionBindings {
|
|
423
554
|
/** Omitted for backward compatibility; omitted always means managed. */
|
|
@@ -454,6 +585,9 @@ interface ProviderSessionInfo {
|
|
|
454
585
|
}
|
|
455
586
|
interface SessionFilter {
|
|
456
587
|
agent_id?: string;
|
|
588
|
+
statuses?: string[];
|
|
589
|
+
created_at_gte?: string;
|
|
590
|
+
created_at_lte?: string;
|
|
457
591
|
limit?: number;
|
|
458
592
|
page?: string;
|
|
459
593
|
}
|
|
@@ -468,17 +602,6 @@ interface SkillFile {
|
|
|
468
602
|
content: Buffer;
|
|
469
603
|
}
|
|
470
604
|
|
|
471
|
-
interface ProviderSkillInfo {
|
|
472
|
-
id: string;
|
|
473
|
-
name: string;
|
|
474
|
-
description?: string;
|
|
475
|
-
source: "custom" | "official";
|
|
476
|
-
status: "checking" | "active" | "rejected" | "deleted";
|
|
477
|
-
latest_version?: string;
|
|
478
|
-
created_at?: string;
|
|
479
|
-
updated_at?: string;
|
|
480
|
-
}
|
|
481
|
-
|
|
482
605
|
interface ResourceState {
|
|
483
606
|
address: ResourceAddress;
|
|
484
607
|
remote_id: string | null;
|
|
@@ -487,6 +610,8 @@ interface ResourceState {
|
|
|
487
610
|
* referenced by this project. It must never be deleted remotely.
|
|
488
611
|
*/
|
|
489
612
|
externally_managed?: boolean;
|
|
613
|
+
/** Provider API domain that owns the remote resource (currently relevant to Qoder). */
|
|
614
|
+
api_mode?: "managed" | "forward" | "auto";
|
|
490
615
|
version?: number;
|
|
491
616
|
/**
|
|
492
617
|
* Backward-compatible alias for desired_hash. Kept while older state files
|
|
@@ -498,6 +623,8 @@ interface ResourceState {
|
|
|
498
623
|
desired_readiness_baseline?: ResourceReadinessBaseline;
|
|
499
624
|
remote_hash?: string;
|
|
500
625
|
remote_snapshot?: unknown;
|
|
626
|
+
/** Non-reversible declaration fingerprint used to infer safe logical renames. */
|
|
627
|
+
replacement_fingerprint?: string;
|
|
501
628
|
drift_paths?: string[];
|
|
502
629
|
drift_status?: "in_sync" | "drifted" | "missing" | "unchecked";
|
|
503
630
|
}
|
|
@@ -508,6 +635,15 @@ interface ResourceReadinessBaseline {
|
|
|
508
635
|
}
|
|
509
636
|
interface StateFile {
|
|
510
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;
|
|
511
647
|
}
|
|
512
648
|
|
|
513
649
|
interface RemoteResource {
|
|
@@ -515,6 +651,7 @@ interface RemoteResource {
|
|
|
515
651
|
type: string;
|
|
516
652
|
version?: number;
|
|
517
653
|
}
|
|
654
|
+
type ProviderResourceMode = "managed" | "forward" | "auto";
|
|
518
655
|
interface ModelInfo {
|
|
519
656
|
id: string;
|
|
520
657
|
display_name: string;
|
|
@@ -555,6 +692,11 @@ interface ResolvedTemplateRefs extends ResolvedAgentRefs {
|
|
|
555
692
|
/** Qoder BYOC private-network route used by Forward Templates. */
|
|
556
693
|
tunnel_id?: string;
|
|
557
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[];
|
|
558
700
|
}
|
|
559
701
|
interface ResolvedDeploymentRefs {
|
|
560
702
|
agent_id: string;
|
|
@@ -566,8 +708,12 @@ interface ResolvedDeploymentRefs {
|
|
|
566
708
|
memory_store_ids: Record<string, string>;
|
|
567
709
|
}
|
|
568
710
|
interface ResolvedChannelRefs {
|
|
569
|
-
identity_id
|
|
570
|
-
agent_id
|
|
711
|
+
identity_id?: string;
|
|
712
|
+
agent_id?: string;
|
|
713
|
+
}
|
|
714
|
+
interface DefaultMemoryStoreReconcileResult {
|
|
715
|
+
status: "updated" | "unchanged" | "pending";
|
|
716
|
+
memory_store_id?: string;
|
|
571
717
|
}
|
|
572
718
|
interface DeploymentContext {
|
|
573
719
|
id: string | null;
|
|
@@ -601,6 +747,8 @@ interface DeploymentInfo$1 {
|
|
|
601
747
|
}
|
|
602
748
|
interface DeploymentListFilter {
|
|
603
749
|
agent_id?: string;
|
|
750
|
+
/** Bailian server-side fuzzy match against deployment id or name. */
|
|
751
|
+
keyword?: string;
|
|
604
752
|
status?: "active" | "paused";
|
|
605
753
|
include_archived?: boolean;
|
|
606
754
|
limit?: number;
|
|
@@ -628,17 +776,25 @@ interface ProviderAdapter {
|
|
|
628
776
|
* ambiguity of name matching when names are not unique. Without `id`, falls
|
|
629
777
|
* back to listing and matching by `name` (used by conflict adoption).
|
|
630
778
|
*/
|
|
631
|
-
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>;
|
|
632
780
|
listAgents?(filter?: {
|
|
633
781
|
prefix?: string;
|
|
634
782
|
limit?: number;
|
|
635
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>;
|
|
636
788
|
listEnvironments?(filter?: {
|
|
637
789
|
limit?: number;
|
|
638
790
|
}): Promise<CloudEnvironment[]>;
|
|
791
|
+
listEnvironmentResources?(options?: EnvironmentListOptions): Promise<EnvironmentPage>;
|
|
792
|
+
getRemoteEnvironment?(id: string): Promise<CloudEnvironment>;
|
|
639
793
|
listVaults?(filter?: {
|
|
640
794
|
limit?: number;
|
|
641
795
|
}): Promise<CloudVault[]>;
|
|
796
|
+
listVaultResources?(options?: VaultListOptions): Promise<VaultPage>;
|
|
797
|
+
getRemoteVault?(id: string): Promise<CloudVault>;
|
|
642
798
|
getDriftSupport?(type: ResourceType): DriftSupport;
|
|
643
799
|
readComparableResource?(type: ResourceType, id: string | null, name: string): Promise<ComparableRemoteResource | null>;
|
|
644
800
|
normalizeDesiredResource?(type: ResourceType, name: string, decl: unknown): unknown | null;
|
|
@@ -648,60 +804,71 @@ interface ProviderAdapter {
|
|
|
648
804
|
* values that the provider does not return are emitted as `${ENV}` placeholders.
|
|
649
805
|
*/
|
|
650
806
|
exportResources?(type: ResourceType): Promise<ExportedResource[]>;
|
|
651
|
-
createEnvironment(name: string, decl: EnvironmentDecl): Promise<RemoteResource>;
|
|
652
|
-
updateEnvironment(id: string, name: string, decl: EnvironmentDecl): Promise<RemoteResource>;
|
|
653
|
-
deleteEnvironment(id: string, cascade?: boolean): Promise<void>;
|
|
654
|
-
createVault(name: string, decl: VaultDecl): Promise<RemoteResource>;
|
|
655
|
-
deleteVault(id: string): Promise<void>;
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
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>;
|
|
659
817
|
createAgent(name: string, decl: AgentDecl, refs: ResolvedAgentRefs): Promise<RemoteResource>;
|
|
660
818
|
updateAgent(id: string, name: string, decl: AgentDecl, refs: ResolvedAgentRefs): Promise<RemoteResource>;
|
|
661
819
|
deleteAgent(id: string): Promise<void>;
|
|
662
820
|
createTemplate?(name: string, decl: AgentDecl, refs: ResolvedTemplateRefs): Promise<RemoteResource>;
|
|
663
821
|
updateTemplate?(id: string, name: string, decl: AgentDecl, refs: ResolvedTemplateRefs): Promise<RemoteResource>;
|
|
664
822
|
/** Remove the template from desired state. Qoder implements this as a soft archive. */
|
|
665
|
-
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>;
|
|
666
827
|
createIdentity?(name: string, decl: IdentityDecl): Promise<RemoteResource>;
|
|
667
828
|
updateIdentity?(id: string, name: string, decl: IdentityDecl): Promise<RemoteResource>;
|
|
668
829
|
deleteIdentity?(id: string): Promise<void>;
|
|
669
830
|
createChannel?(name: string, decl: ChannelDecl, refs: ResolvedChannelRefs): Promise<RemoteResource>;
|
|
670
831
|
updateChannel?(id: string, name: string, decl: ChannelDecl, refs: ResolvedChannelRefs): Promise<RemoteResource>;
|
|
671
832
|
deleteChannel?(id: string): Promise<void>;
|
|
672
|
-
createMemoryStore?(name: string, decl: MemoryStoreDecl): Promise<RemoteResource>;
|
|
673
|
-
deleteMemoryStore?(id: string): Promise<void>;
|
|
833
|
+
createMemoryStore?(name: string, decl: MemoryStoreDecl, mode?: ProviderResourceMode): Promise<RemoteResource>;
|
|
834
|
+
deleteMemoryStore?(id: string, mode?: ProviderResourceMode): Promise<void>;
|
|
674
835
|
listMemoryStores?(options?: MemoryStoreListOptions): Promise<MemoryPage<MemoryStoreInfo>>;
|
|
675
836
|
getMemoryStore?(id: string): Promise<MemoryStoreInfo>;
|
|
676
|
-
updateMemoryStore?(id: string, input: UpdateMemoryStoreInput): Promise<MemoryStoreInfo>;
|
|
837
|
+
updateMemoryStore?(id: string, input: UpdateMemoryStoreInput, mode?: ProviderResourceMode): Promise<MemoryStoreInfo>;
|
|
677
838
|
archiveMemoryStore?(id: string): Promise<MemoryStoreInfo>;
|
|
678
|
-
createMemory?(storeId: string, input: CreateMemoryInput): Promise<MemoryInfo>;
|
|
839
|
+
createMemory?(storeId: string, input: CreateMemoryInput, mode?: ProviderResourceMode): Promise<MemoryInfo>;
|
|
679
840
|
batchCreateMemories?(storeId: string, input: BatchCreateMemoryInput): Promise<BatchCreateMemoryResult>;
|
|
680
|
-
listMemories?(storeId: string, options?: MemoryListOptions): Promise<MemoryPage<MemoryListItem>>;
|
|
841
|
+
listMemories?(storeId: string, options?: MemoryListOptions, mode?: ProviderResourceMode): Promise<MemoryPage<MemoryListItem>>;
|
|
681
842
|
getMemory?(storeId: string, memoryId: string): Promise<MemoryInfo>;
|
|
682
|
-
updateMemory?(storeId: string, memoryId: string, input: UpdateMemoryInput): Promise<MemoryInfo>;
|
|
843
|
+
updateMemory?(storeId: string, memoryId: string, input: UpdateMemoryInput, mode?: ProviderResourceMode): Promise<MemoryInfo>;
|
|
683
844
|
deleteMemory?(storeId: string, memoryId: string, expectedContentSha256?: string): Promise<void>;
|
|
684
845
|
listMemoryVersions?(storeId: string, options?: MemoryVersionListOptions): Promise<MemoryPage<MemoryVersionInfo>>;
|
|
685
846
|
getMemoryVersion?(storeId: string, versionId: string): Promise<MemoryVersionInfo>;
|
|
686
847
|
redactMemoryVersion?(storeId: string, versionId: string): Promise<MemoryVersionInfo>;
|
|
687
848
|
createDeployment(name: string, decl: DeploymentDecl, refs: ResolvedDeploymentRefs, basePath: string): Promise<RemoteResource>;
|
|
688
|
-
updateDeployment(id: string, name: string, decl: DeploymentDecl, refs: ResolvedDeploymentRefs, basePath: string): Promise<RemoteResource>;
|
|
849
|
+
updateDeployment(id: string, name: string, decl: DeploymentDecl, refs: ResolvedDeploymentRefs, basePath: string, preparedFiles?: ReadonlyMap<string, string>): Promise<RemoteResource>;
|
|
689
850
|
deleteDeployment(id: string): Promise<void>;
|
|
690
851
|
runDeployment(ctx: DeploymentContext): Promise<DeploymentRunResult$1>;
|
|
691
852
|
getDeployment(ctx: DeploymentContext): Promise<DeploymentInfo$1>;
|
|
692
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>;
|
|
693
860
|
pauseDeployment?(ctx: DeploymentContext): Promise<DeploymentInfo$1>;
|
|
694
861
|
unpauseDeployment?(ctx: DeploymentContext): Promise<DeploymentInfo$1>;
|
|
695
862
|
uploadFile(filePath: string, options?: {
|
|
696
863
|
name?: string;
|
|
697
864
|
purpose?: string;
|
|
698
|
-
}): Promise<ProviderFileInfo>;
|
|
865
|
+
}, mode?: ProviderResourceMode): Promise<ProviderFileInfo>;
|
|
699
866
|
/** Upload from in-memory content (no filesystem), for server contexts that receive bytes directly (e.g. webui browser uploads). */
|
|
700
867
|
uploadFileContent(content: Uint8Array, filename: string, options?: {
|
|
701
868
|
mimeType?: string;
|
|
702
869
|
purpose?: string;
|
|
703
870
|
}): Promise<ProviderFileInfo>;
|
|
704
|
-
deleteFile(id: string): Promise<void>;
|
|
871
|
+
deleteFile(id: string, mode?: ProviderResourceMode): Promise<void>;
|
|
705
872
|
/** Fetch a single file's metadata (incl. scan `status`); used to gate session binding on availability. */
|
|
706
873
|
getFileInfo?(id: string): Promise<ProviderFileInfo>;
|
|
707
874
|
/**
|
|
@@ -715,14 +882,20 @@ interface ProviderAdapter {
|
|
|
715
882
|
}>;
|
|
716
883
|
/** List workspace user-uploaded files (newest first). Optional — only providers with a list API implement it. */
|
|
717
884
|
listFiles?(): Promise<ProviderFileInfo[]>;
|
|
885
|
+
listFileResources?(options?: FileListOptions): Promise<FilePage>;
|
|
886
|
+
downloadFileContent?(id: string): Promise<Uint8Array>;
|
|
718
887
|
/**
|
|
719
888
|
* List skills (newest first). `source` selects the catalog: "custom" (workspace-uploaded, the
|
|
720
889
|
* default) or "official" (the provider's built-in catalog). Optional — only providers with a
|
|
721
890
|
* list API implement it.
|
|
722
891
|
*/
|
|
723
892
|
listSkills?(source?: "custom" | "official"): Promise<ProviderSkillInfo[]>;
|
|
893
|
+
listSkillResources?(options?: SkillListOptions): Promise<SkillPage>;
|
|
724
894
|
/** Fetch a single skill's metadata (incl. scan `status`); used to poll create → active. */
|
|
725
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>;
|
|
726
899
|
/**
|
|
727
900
|
* Create a skill from an already-uploaded zip's file_id and return immediately with the
|
|
728
901
|
* initial (usually `checking`) status. NON-blocking — unlike `createSkill`, it does NOT wait
|
|
@@ -732,8 +905,11 @@ interface ProviderAdapter {
|
|
|
732
905
|
createSession(bindings: SessionBindings): Promise<ProviderSessionInfo>;
|
|
733
906
|
listSessions(filter?: SessionFilter): Promise<SessionListResult>;
|
|
734
907
|
getSession(id: string): Promise<ProviderSessionInfo>;
|
|
908
|
+
updateSession?(id: string, input: SessionUpdateInput): Promise<ProviderSessionInfo>;
|
|
909
|
+
archiveSession?(id: string): Promise<ProviderSessionInfo>;
|
|
735
910
|
deleteSession(id: string): Promise<void>;
|
|
736
911
|
sendSessionMessage(sessionId: string, message: string): Promise<string | undefined>;
|
|
912
|
+
sendSessionEvents?(sessionId: string, events: SessionEventInput[]): Promise<SessionEventSendResult>;
|
|
737
913
|
streamSessionEvents(sessionId: string, options?: EventStreamOptions): AsyncIterable<ProviderSessionEvent>;
|
|
738
914
|
listSessionEvents(sessionId: string, options?: EventListOptions): Promise<ProviderSessionEventList>;
|
|
739
915
|
listModels?(): Promise<ModelInfo[]>;
|
|
@@ -880,11 +1056,18 @@ type RuntimeFeedbackSink = (event: RuntimeFeedbackEvent) => void;
|
|
|
880
1056
|
|
|
881
1057
|
interface ResourceRuntimeOptions extends DestructiveDecisionOptions {
|
|
882
1058
|
provider?: string;
|
|
1059
|
+
scope?: ResourcePlanScope;
|
|
1060
|
+
mode?: ResourceSyncMode;
|
|
883
1061
|
refresh?: boolean;
|
|
884
1062
|
refreshOnly?: boolean;
|
|
885
1063
|
quiet?: boolean;
|
|
886
1064
|
onFeedback?: RuntimeFeedbackSink;
|
|
887
1065
|
}
|
|
1066
|
+
type ResourceSyncMode = "reconcile" | "create-only";
|
|
1067
|
+
interface ResourcePlanScope {
|
|
1068
|
+
roots: ResourceAddress[];
|
|
1069
|
+
includeDependencies?: boolean;
|
|
1070
|
+
}
|
|
888
1071
|
interface ResourceRefreshResult {
|
|
889
1072
|
removed: ResourceState[];
|
|
890
1073
|
errors: Array<{
|
|
@@ -907,6 +1090,8 @@ interface ResourcePlanResult {
|
|
|
907
1090
|
refreshResult?: ResourceRefreshResult;
|
|
908
1091
|
targetProviders?: string[];
|
|
909
1092
|
destructiveActions: PlannedAction[];
|
|
1093
|
+
selectedAddresses?: ResourceAddress[];
|
|
1094
|
+
mode?: ResourceSyncMode;
|
|
910
1095
|
}
|
|
911
1096
|
type DestructivePolicy = "block" | "prompt" | "force";
|
|
912
1097
|
interface DestructiveDecisionOptions {
|
|
@@ -917,6 +1102,7 @@ interface ResourceSyncRun {
|
|
|
917
1102
|
planned: ResourcePlanResult;
|
|
918
1103
|
execution?: ResourceExecutionResult;
|
|
919
1104
|
}
|
|
1105
|
+
declare function planProjectWithStateBackend(input: BackendRuntimeInput, options?: ResourceRuntimeOptions): Promise<ResourcePlanResult>;
|
|
920
1106
|
declare function syncProjectResourcesWithStateBackend(input: BackendRuntimeInput, options?: ResourceRuntimeOptions): Promise<ResourceSyncRun>;
|
|
921
1107
|
declare function importResource(ctx: ProjectRuntimeContext, address: ResourceAddress, remoteId: string, options?: {
|
|
922
1108
|
resourceVersion?: number;
|
|
@@ -1071,6 +1257,105 @@ declare function runDeploymentForContext(ctx: ProjectRuntimeContext, name: strin
|
|
|
1071
1257
|
declare function pauseDeploymentForContext(ctx: ProjectRuntimeContext, name: string, paused: boolean, resolvedProvider?: string): Promise<DeploymentInfo$1>;
|
|
1072
1258
|
declare function getDeploymentRuntimeProviderForContext(ctx: ProjectRuntimeContext, name: string, overrideProvider?: string): string;
|
|
1073
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
|
+
|
|
1074
1359
|
type DestroyResourceStatus = "success" | "failed" | "blocked" | "skipped";
|
|
1075
1360
|
type DestroyResourceResultReason = "destroyed" | "reference_removed" | "already_gone" | "cascade_required" | "provider_missing" | "failed" | "skipped";
|
|
1076
1361
|
interface DestroyResourceResult {
|
|
@@ -1082,17 +1367,34 @@ interface DestroyResourceResult {
|
|
|
1082
1367
|
}
|
|
1083
1368
|
interface DestroyPlanResult {
|
|
1084
1369
|
resources: ResourceState[];
|
|
1370
|
+
defaultMemoryStores: DestroyDefaultMemoryStorePlan[];
|
|
1085
1371
|
executionContext: ProjectRuntimeContext;
|
|
1086
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
|
+
}
|
|
1087
1386
|
interface DestroyProjectOptions {
|
|
1088
1387
|
cascade?: boolean;
|
|
1089
1388
|
onFeedback?: RuntimeFeedbackSink;
|
|
1090
1389
|
onResourceStart?: (resource: ResourceState) => void;
|
|
1091
1390
|
onResourceResult?: (result: DestroyResourceResult) => void;
|
|
1092
1391
|
onCascadeRequired?: (result: DestroyResourceResult) => boolean | Promise<boolean>;
|
|
1392
|
+
/** Override bounded cleanup backoff, primarily for deterministic tests. */
|
|
1393
|
+
defaultMemoryStoreRetryDelaysMs?: number[];
|
|
1093
1394
|
}
|
|
1094
1395
|
interface DestroyProjectResult extends DestroyPlanResult {
|
|
1095
1396
|
results: DestroyResourceResult[];
|
|
1397
|
+
defaultMemoryStoreResults: DestroyDefaultMemoryStoreResult[];
|
|
1096
1398
|
destroyed: number;
|
|
1097
1399
|
partial: boolean;
|
|
1098
1400
|
}
|
|
@@ -1167,6 +1469,7 @@ interface AgentMcpBuildInput {
|
|
|
1167
1469
|
}>;
|
|
1168
1470
|
}
|
|
1169
1471
|
interface AgentBuildInput {
|
|
1472
|
+
name?: string;
|
|
1170
1473
|
description?: string;
|
|
1171
1474
|
model?: AgentDecl["model"];
|
|
1172
1475
|
instructions?: string;
|
|
@@ -1190,10 +1493,20 @@ interface BuiltAgent {
|
|
|
1190
1493
|
*/
|
|
1191
1494
|
declare function buildAgentDecl(base: AgentDecl | undefined, input: AgentBuildInput): BuiltAgent;
|
|
1192
1495
|
|
|
1496
|
+
interface AgentResourcePlan {
|
|
1497
|
+
agentId: string;
|
|
1498
|
+
provider: string;
|
|
1499
|
+
actions: PlannedAction[];
|
|
1500
|
+
diagnostics: Diagnostic[];
|
|
1501
|
+
destructiveActions: PlannedAction[];
|
|
1502
|
+
planned: ResourcePlanResult;
|
|
1503
|
+
}
|
|
1193
1504
|
interface AgentResourcePlanOptions {
|
|
1194
1505
|
refresh?: boolean;
|
|
1195
1506
|
quiet?: boolean;
|
|
1507
|
+
mode?: AgentResourceSyncMode;
|
|
1196
1508
|
}
|
|
1509
|
+
type AgentResourceSyncMode = ResourceSyncMode;
|
|
1197
1510
|
interface AgentResourceSyncOptions extends AgentResourcePlanOptions {
|
|
1198
1511
|
policy?: DestructivePolicy;
|
|
1199
1512
|
confirm?: (actions: PlannedAction[]) => boolean | Promise<boolean>;
|
|
@@ -1253,6 +1566,8 @@ declare function getAgent(ctx: ProjectRuntimeContext, agentId: string): AgentDef
|
|
|
1253
1566
|
declare function listAgentsWithReadiness(ctx: ProjectRuntimeContext, options?: {
|
|
1254
1567
|
refresh?: boolean;
|
|
1255
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>;
|
|
1256
1571
|
declare function syncAgentResourcesWithStateBackend(input: BackendRuntimeInput, agentId: string, options?: AgentResourceSyncOptions): Promise<AgentSyncRun>;
|
|
1257
1572
|
|
|
1258
1573
|
interface SessionCreateOptions {
|
|
@@ -1289,6 +1604,8 @@ interface SessionCreateOptions {
|
|
|
1289
1604
|
title?: string;
|
|
1290
1605
|
provider?: string;
|
|
1291
1606
|
metadata?: Record<string, string>;
|
|
1607
|
+
/** Session-level environment variables. Currently supported by Qoder. */
|
|
1608
|
+
environmentVariables?: Record<string, string>;
|
|
1292
1609
|
}
|
|
1293
1610
|
declare function resolveSessionProvider(agentName: string, config: ProjectConfig, overrideProvider?: string): string;
|
|
1294
1611
|
|
|
@@ -1342,12 +1659,7 @@ declare function listSessionSummaries(ctx: ProjectRuntimeContext, options?: Sess
|
|
|
1342
1659
|
}): Promise<SessionSummaryList>;
|
|
1343
1660
|
declare function getSession(ctx: ProjectRuntimeContext, sessionId: string, provider?: string): Promise<ProviderSessionInfo>;
|
|
1344
1661
|
declare function deleteSession(ctx: ProjectRuntimeContext, sessionId: string, provider?: string): Promise<void>;
|
|
1345
|
-
declare function listSessionEvents(ctx: ProjectRuntimeContext, sessionId: string, options?: SessionRuntimeTarget &
|
|
1346
|
-
limit?: number;
|
|
1347
|
-
order?: string;
|
|
1348
|
-
page_token?: string;
|
|
1349
|
-
page?: string;
|
|
1350
|
-
}): Promise<ProviderSessionEventList>;
|
|
1662
|
+
declare function listSessionEvents(ctx: ProjectRuntimeContext, sessionId: string, options?: SessionRuntimeTarget & EventListOptions): Promise<ProviderSessionEventList>;
|
|
1351
1663
|
/**
|
|
1352
1664
|
* Upload a file's raw bytes to the resolved provider's Files API and return its metadata.
|
|
1353
1665
|
* Content-based (no filesystem) so server contexts can forward browser uploads directly.
|
|
@@ -1387,9 +1699,9 @@ declare function createSkillFromFileId(ctx: ProjectRuntimeContext, fileId: strin
|
|
|
1387
1699
|
/** Delete a custom skill by id from the resolved provider's Skills API. */
|
|
1388
1700
|
declare function deleteSkill(ctx: ProjectRuntimeContext, id: string, options?: SessionRuntimeTarget): Promise<void>;
|
|
1389
1701
|
/**
|
|
1390
|
-
* Subscribe to a session's
|
|
1391
|
-
*
|
|
1392
|
-
*
|
|
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.
|
|
1393
1705
|
*/
|
|
1394
1706
|
declare function streamSessionEvents(ctx: ProjectRuntimeContext, sessionId: string, options?: SessionRuntimeTarget & EventStreamOptions): AsyncIterable<ProviderSessionEvent>;
|
|
1395
1707
|
|
|
@@ -1474,4 +1786,14 @@ declare class LocalFileStateBackend implements StateBackend {
|
|
|
1474
1786
|
/** Normalize a skill zip and extract its entries to SkillFile[]. */
|
|
1475
1787
|
declare function extractSkillZipFiles(raw: Buffer): Promise<SkillFile[]>;
|
|
1476
1788
|
|
|
1477
|
-
|
|
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 };
|