@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/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
- import { R as ResourceAddress, a as ResourceType, C as CloudAgent, b as CloudEnvironment, c as CloudVault, 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-CxLg_XqS.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-CxLg_XqS.js';
3
- import { P as ProviderFileInfo } from './file-URqwlxLf.js';
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: string;
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: string;
570
- agent_id: string;
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
- createSkill(name: string, decl: SkillDecl, files: SkillFile[]): Promise<RemoteResource>;
657
- updateSkill(id: string, name: string, decl: SkillDecl, files: SkillFile[]): Promise<RemoteResource>;
658
- deleteSkill(id: string): Promise<void>;
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 live event stream by id (native SSE). The underlying provider
1391
- * stream pushes only post-connect events, so callers that need full history must replay it
1392
- * via listSessionEvents and de-dupe by ProviderSessionEvent.id.
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
- export { AGENTS_CONFIG_PROVIDERS, AGENTS_PROVIDER_FIELDS, type AgentBuildInput, AgentDefinition, type AgentMcpBuildInput, type AgentSkillBuildInput, AgentSyncRun, AgentWithReadiness, ApiError, type BackendRuntimeInput, type BatchCreateMemoryInput, type BatchCreateMemoryResult, CloudAgent, CloudEnvironment, CloudVault, type CollectedSessionEvents, ConflictError, type CreateMemoryInput, type CreateMemoryStoreInput, type DeploymentListFilter, type DeploymentListResult, type DestroyResourceResult, type DestructivePolicy, Diagnostic, type FetchLike, type IStateManager, type LoadedProjectConfig, LocalFileStateBackend, 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 ProjectRuntimeContext, type ProviderConfig, type ProviderConfigProvider, ProviderFileInfo, ProviderSessionEvent, type ProviderSessionInfo, type ProviderSkillInfo, type ResolvedProjectConfig, type ResourceActionResult, ResourceAddress, type ResourceExecutionResult, type ResourcePlanResult, type ResourceRefreshResult, type ResourceRuntimeOptions, type ResourceState, type ResourceSyncRun, ResourceType, type RuntimeFeedbackEvent, type RuntimeFeedbackSink, type SecretPlaceholder, type SkillFile, StateManager, type StateScope, type SyncProjectOptions, type SyncProjectResult, type UpdateMemoryInput, type UpdateMemoryStoreInput, UserError, type ValidateProjectConfigOptions, applyProviderConfigToEnv, archiveCloudAgent, archiveMemoryStore, areRuntimeCredentialsReady, batchCreateMemories, bootstrapRuntimeCredentials, bootstrapRuntimeCredentialsSync, buildAgentDecl, collectConfigReferences, createCloudEnvironment, createCloudVault, createMemory, createMemoryStore, createProjectRuntime, createSessionForAgent, createSkillFromFileId, decideDestructive, deleteCloudEnvironment, deleteCloudVault, deleteFile, deleteMemory, deleteMemoryStore, deleteSession, deleteSkill, destroyPlannedProjectResources, executePlannedProject, extractSkillZipFiles, getAgent, getDeploymentDetailsForContext, getDeploymentRuntimeProviderForContext, getFileDownloadUrl, getFileInfo, getMemory, getMemoryProviderCapabilities, getMemoryStore, getMemoryVersion, getSession, getSkillInfo, importResource, isTerminalSessionStatus, listAgentsWithReadiness, listCloudAgents, listCloudEnvironments, listCloudVaults, listDeploymentsForContext, listFiles, listMemories, listMemoryStores, listMemoryVersions, listProviderModelsForContext, listProviderNames, listRemoteDeploymentsForContext, listSessionEvents, listSessionSummaries, listSkills, loadDotEnv, loadProviderConfigIntoEnv, loadProviderConfigIntoEnvSync, migrateConfig, parseStateAddress, pauseDeploymentForContext, planDestroyProjectContext, planProjectContext, prepareInitialSessionPrompt, preparePromptForProvider, prependFileHint, providerConfigPath, readProjectRuntime, redactMemoryVersion, resolveActiveProvider, resolveProjectConfig, resolveProjectConfigFromObject, resolveProviderConfigFromEnv, resolveRepositoryMountPath, resolveSessionProvider, resolveSyncProvider, rewriteFileMentions, runDeploymentForContext, sendSessionMessagePolling, sendSessionMessageStreaming, setDefaultFetch, startSessionRun, startSessionRunPolling, streamSessionEvents, syncAgentResourcesWithStateBackend, syncProjectResourcesWithStateBackend, syncProviderResourcesFromContext, syncProviderResourcesFromEnv, updateMemory, updateMemoryStore, uploadFile, validateProjectConfig, writeProjectRuntime };
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 };