@openagentpack/sdk 0.3.2 → 0.4.0-beta-2472720-20260827

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