@openagentpack/sdk 0.3.0 → 0.3.1-beta-85cd4b6-20260727

package/dist/index.d.ts

@@ -142,6 +142,8 @@ interface AgentDecl {
     skills?: AgentSkillDecl[];
     vault?: string;
     memory_stores?: string[];
+    /** Resources mounted into every managed session created for this agent. */
+    resources?: SessionResourceDecl[];
     multiagent?: MultiagentDecl;
     metadata?: Record<string, string>;
     /** Provider-specific remote materialization. Omitted means the existing managed Agent resource. */
@@ -170,6 +172,8 @@ interface AgentSkillRefDecl {
 }
 interface AgentToolsDecl {
     builtin: string[];
+    /** Permission inherited by every enabled builtin without an explicit override. */
+    default_permission?: "allow" | "ask";
     mcp?: AgentMcpToolkitDecl[];
     permissions?: Record<string, "allow" | "ask">;
 }
@@ -210,6 +214,12 @@ interface DeploymentDecl {
     environment_variables?: string;
 }
 type DeploymentResourceDecl = DeploymentFileResource | DeploymentMemoryStoreResource | DeploymentGithubRepoResource;
+/** Provider-neutral resources that can be attached directly when a session is created. */
+interface SessionGithubRepoResourceDecl extends Omit<DeploymentGithubRepoResource, "authorization_token"> {
+    /** Required for private repositories; interpolate this value from an environment variable. */
+    authorization_token: string;
+}
+type SessionResourceDecl = SessionGithubRepoResourceDecl;
 interface DeploymentFileResource {
     type: "file";
     file_id?: string;
@@ -390,9 +400,22 @@ interface SessionFileResource {
     file_id: string;
     mount_path: string;
 }
+interface SessionGithubRepositoryResource {
+    type: "github_repository";
+    url: string;
+    checkout?: {
+        branch?: string;
+        commit?: string;
+    };
+    mount_path?: string;
+    authorization_token: string;
+}
+type SessionResource = SessionGithubRepositoryResource;
 interface CommonSessionBindings {
     /** Uploaded files to mount in the session sandbox. */
     files?: SessionFileResource[];
+    /** Provider-neutral resources to mount when the session is created. */
+    resources?: SessionResource[];
     title?: string;
     metadata?: Record<string, string>;
 }
@@ -722,6 +745,19 @@ interface ProviderAdapter {
     downloadAllSkillFiles?(): Promise<Map<string, SkillFile[]>>;
 }
 
+declare class ApiError extends Error {
+    readonly statusCode: number;
+    readonly responseBody: string;
+    constructor(statusCode: number, responseBody: string, prefix: string);
+    static isNotFound(err: unknown): boolean;
+}
+declare class ConflictError extends ApiError {
+}
+
+type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+/** Install the fetch implementation used by all provider clients; pass undefined to reset. */
+declare function setDefaultFetch(fetchImpl: FetchLike | undefined): void;
+
 interface IStateManager {
     getResource(address: ResourceAddress): ResourceState | undefined;
     setResource(resource: ResourceState): void;
@@ -1248,6 +1284,8 @@ interface SessionCreateOptions {
         fileId: string;
         mountPath: string;
     }[];
+    /** Explicit resources override the resources declared on the agent. */
+    resources?: SessionResourceDecl[];
     title?: string;
     provider?: string;
     metadata?: Record<string, string>;
@@ -1359,12 +1397,16 @@ declare function streamSessionEvents(ctx: ProjectRuntimeContext, sessionId: stri
 interface MountedFile {
     mount_path: string;
 }
+/** Resolve the provider path used for a mounted Git repository. */
+declare function resolveRepositoryMountPath(provider: string, resource: SessionGithubRepositoryResource): string;
 /** Prepend the file-mount hint to a prompt. Returns the prompt unchanged when there are no files. */
 declare function prependFileHint(prompt: string, files: MountedFile[] | undefined, provider: string): string;
 /** 将 prompt 内 ⟦file:mountPath⟧ 占位符替换为 provider 感知的真实 sandbox 路径 */
 declare function rewriteFileMentions(prompt: string, provider: string): string;
 /** 发送给 provider 前统一处理：先替换 mention 占位符，再 prepend 文件 hint */
 declare function preparePromptForProvider(prompt: string, files: MountedFile[] | undefined, provider: string): string;
+/** Prepare only the first user message for a newly created Session. */
+declare function prepareInitialSessionPrompt(prompt: string, bindings: SessionBindings, provider: string): string;
 
 /**
  * Resolve a provider's config block from environment variables (actual values, not
@@ -1432,4 +1474,4 @@ declare class LocalFileStateBackend implements StateBackend {
 /** Normalize a skill zip and extract its entries to SkillFile[]. */
 declare function extractSkillZipFiles(raw: Buffer): Promise<SkillFile[]>;
 
-export { AGENTS_CONFIG_PROVIDERS, AGENTS_PROVIDER_FIELDS, type AgentBuildInput, AgentDefinition, type AgentMcpBuildInput, type AgentSkillBuildInput, AgentSyncRun, AgentWithReadiness, type BackendRuntimeInput, type BatchCreateMemoryInput, type BatchCreateMemoryResult, CloudAgent, CloudEnvironment, CloudVault, type CollectedSessionEvents, type CreateMemoryInput, type CreateMemoryStoreInput, type DeploymentListFilter, type DeploymentListResult, type DestroyResourceResult, type DestructivePolicy, Diagnostic, 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, preparePromptForProvider, prependFileHint, providerConfigPath, readProjectRuntime, redactMemoryVersion, resolveActiveProvider, resolveProjectConfig, resolveProjectConfigFromObject, resolveProviderConfigFromEnv, resolveSessionProvider, resolveSyncProvider, rewriteFileMentions, runDeploymentForContext, sendSessionMessagePolling, sendSessionMessageStreaming, startSessionRun, startSessionRunPolling, streamSessionEvents, syncAgentResourcesWithStateBackend, syncProjectResourcesWithStateBackend, syncProviderResourcesFromContext, syncProviderResourcesFromEnv, updateMemory, updateMemoryStore, uploadFile, validateProjectConfig, writeProjectRuntime };
+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 };