@openagentpack/sdk 0.2.0-beta.0 → 0.3.0-beta-e537ab3-20260722

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-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-CObCawiI.js';
-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-CObCawiI.js';
+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';
+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';
 import { P as ProviderFileInfo } from './file-URqwlxLf.js';
 import 'zod';
 
@@ -18,17 +18,33 @@ interface ProjectConfig {
     memory_stores?: Record<string, MemoryStoreDecl>;
     skills?: Record<string, SkillDecl>;
     files?: Record<string, FileDecl>;
+    identities?: Record<string, IdentityDecl>;
     agents?: Record<string, AgentDecl>;
+    channels?: Record<string, ChannelDecl>;
     deployments?: Record<string, DeploymentDecl>;
 }
 interface DefaultsConfig {
     provider?: string;
-    session?: {
-        qoder?: {
-            /** Existing Qoder Forward Identity used only as the CLI/session runtime default. */
-            identity_id?: string;
-        };
-    };
+    /** Logical name of the default declared Identity used by identity-aware resources and runtimes. */
+    identity?: string;
+}
+type IdentityDecl = ManagedIdentityDecl | ExternalIdentityDecl;
+interface ManagedIdentityDecl {
+    provider?: ProviderName;
+    external_id: string;
+    name?: string;
+    enabled?: boolean;
+    metadata?: Record<string, string>;
+    identity_id?: never;
+}
+interface ExternalIdentityDecl {
+    provider?: ProviderName;
+    /** Pre-existing provider Identity id. External references are never mutated or deleted. */
+    identity_id: string;
+    external_id?: never;
+    name?: never;
+    enabled?: never;
+    metadata?: never;
 }
 interface EnvironmentDecl {
     name?: string;
@@ -87,6 +103,7 @@ interface CredentialDecl {
 interface MemoryStoreDecl {
     description: string;
     provider?: ProviderName;
+    metadata?: Record<string, string>;
     entries?: MemoryEntryDecl[];
 }
 interface MemoryEntryDecl {
@@ -125,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. */
@@ -133,6 +152,18 @@ interface AgentDecl {
 interface AgentDeliveryDecl {
     type: "managed" | "forward";
 }
+interface ChannelDecl {
+    provider?: ProviderName;
+    /** Logical Agent name. The provider adapter resolves its materialized remote resource. */
+    agent: string;
+    /** Logical Identity name. Falls back to defaults.identity. */
+    identity?: string;
+    type: string;
+    name?: string;
+    enabled?: boolean;
+    credentials?: Record<string, string>;
+    options?: Record<string, unknown>;
+}
 type AgentSkillDecl = string | AgentSkillRefDecl;
 interface AgentSkillRefDecl {
     type: "official" | "custom";
@@ -141,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">;
 }
@@ -177,8 +210,16 @@ interface DeploymentDecl {
     description?: string;
     provider?: ProviderName;
     metadata?: Record<string, string>;
+    /** Qoder-only deployment-level variables copied into each created session. */
+    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;
@@ -229,13 +270,152 @@ interface ResolvedProjectConfig extends ProjectConfig {
     _resolved: true;
 }
 
+type MemoryMetadata = Record<string, string>;
+interface MemoryStoreInfo {
+    id: string;
+    type: "memory_store";
+    name: string;
+    description: string;
+    metadata: MemoryMetadata;
+    status?: "active" | "archived" | string;
+    entry_count?: number;
+    total_size?: number;
+    session_count?: number;
+    created_by?: MemoryActor;
+    created_at: string;
+    updated_at: string;
+    archived_at?: string | null;
+}
+interface MemoryInfo {
+    id: string;
+    type: "memory";
+    memory_store_id: string;
+    path: string;
+    content?: string | null;
+    content_size_bytes: number;
+    content_sha256: string;
+    version?: number;
+    memory_version_id?: string;
+    metadata: MemoryMetadata;
+    created_by?: MemoryActor;
+    created_at: string;
+    updated_at: string;
+}
+interface MemoryPrefixInfo {
+    type: "memory_prefix";
+    path: string;
+}
+type MemoryListItem = MemoryInfo | MemoryPrefixInfo;
+type MemoryVersionOperation = "created" | "updated" | "modified" | "deleted";
+interface MemoryActor {
+    type: string;
+    api_key_id?: string;
+    session_id?: string;
+    user_id?: string;
+}
+interface MemoryVersionInfo {
+    id: string;
+    type: "memory_version";
+    memory_store_id: string;
+    memory_id: string;
+    path?: string | null;
+    content?: string | null;
+    content_size_bytes?: number | null;
+    content_sha256?: string | null;
+    operation: MemoryVersionOperation;
+    version?: number;
+    redacted?: boolean;
+    redacted_at?: string | null;
+    created_by?: MemoryActor;
+    created_at: string;
+}
+interface MemoryPage<T> {
+    data: T[];
+    has_more: boolean;
+    next_cursor?: string;
+}
+interface MemoryProviderCapabilities {
+    archive_store: boolean;
+    batch_create: boolean;
+    versions: boolean;
+    optimistic_concurrency: boolean;
+    memory_metadata: boolean;
+}
+interface MemoryStoreListOptions {
+    limit?: number;
+    cursor?: string;
+    include_archived?: boolean;
+}
+interface MemoryListOptions {
+    limit?: number;
+    cursor?: string;
+    prefix?: string;
+    depth?: number;
+    view?: "basic" | "full";
+}
+interface MemoryVersionListOptions {
+    limit?: number;
+    cursor?: string;
+    memory_id?: string;
+    view?: "basic" | "full";
+}
+interface CreateMemoryStoreInput {
+    name: string;
+    description?: string;
+    metadata?: MemoryMetadata;
+}
+interface UpdateMemoryStoreInput {
+    name?: string;
+    description?: string;
+    metadata?: MemoryMetadata;
+}
+interface CreateMemoryInput {
+    path: string;
+    content: string;
+    metadata?: MemoryMetadata;
+}
+interface BatchCreateMemoryInput {
+    items: CreateMemoryInput[];
+    on_conflict?: "overwrite" | "fail";
+}
+interface BatchCreateMemoryResultItem {
+    path: string;
+    memory?: MemoryInfo;
+    error?: {
+        type: string;
+        message: string;
+    };
+}
+interface BatchCreateMemoryResult {
+    results: BatchCreateMemoryResultItem[];
+}
+interface UpdateMemoryInput {
+    path?: string;
+    content?: string;
+    metadata?: MemoryMetadata;
+    expected_content_sha256?: string;
+}
+
 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>;
 }
@@ -385,6 +565,10 @@ interface ResolvedDeploymentRefs {
     vault_ids: string[];
     memory_store_ids: Record<string, string>;
 }
+interface ResolvedChannelRefs {
+    identity_id: string;
+    agent_id: string;
+}
 interface DeploymentContext {
     id: string | null;
     name: string;
@@ -415,6 +599,20 @@ interface DeploymentInfo$1 {
     };
     attributes?: Record<string, unknown>;
 }
+interface DeploymentListFilter {
+    agent_id?: string;
+    status?: "active" | "paused";
+    include_archived?: boolean;
+    limit?: number;
+    page?: string;
+    created_at_gte?: string;
+    created_at_lte?: string;
+}
+interface DeploymentListResult {
+    deployments: DeploymentInfo$1[];
+    has_more: boolean;
+    next_page?: string;
+}
 interface ProviderAdapter {
     readonly name: string;
     /**
@@ -422,6 +620,7 @@ interface ProviderAdapter {
      * resume after. true → send-then-stream with `afterId`; false → connect-before-send.
      */
     readonly eventResume: boolean;
+    readonly memoryCapabilities?: MemoryProviderCapabilities;
     validate(): Promise<void>;
     /**
      * Locate a remote resource. When `id` is provided, the resource is verified
@@ -464,13 +663,35 @@ interface ProviderAdapter {
     updateTemplate?(id: string, name: string, decl: AgentDecl, refs: ResolvedTemplateRefs): Promise<RemoteResource>;
     /** Remove the template from desired state. Qoder implements this as a soft archive. */
     archiveTemplate?(id: string): Promise<void>;
+    createIdentity?(name: string, decl: IdentityDecl): Promise<RemoteResource>;
+    updateIdentity?(id: string, name: string, decl: IdentityDecl): Promise<RemoteResource>;
+    deleteIdentity?(id: string): Promise<void>;
+    createChannel?(name: string, decl: ChannelDecl, refs: ResolvedChannelRefs): Promise<RemoteResource>;
+    updateChannel?(id: string, name: string, decl: ChannelDecl, refs: ResolvedChannelRefs): Promise<RemoteResource>;
+    deleteChannel?(id: string): Promise<void>;
     createMemoryStore?(name: string, decl: MemoryStoreDecl): Promise<RemoteResource>;
     deleteMemoryStore?(id: string): Promise<void>;
+    listMemoryStores?(options?: MemoryStoreListOptions): Promise<MemoryPage<MemoryStoreInfo>>;
+    getMemoryStore?(id: string): Promise<MemoryStoreInfo>;
+    updateMemoryStore?(id: string, input: UpdateMemoryStoreInput): Promise<MemoryStoreInfo>;
+    archiveMemoryStore?(id: string): Promise<MemoryStoreInfo>;
+    createMemory?(storeId: string, input: CreateMemoryInput): Promise<MemoryInfo>;
+    batchCreateMemories?(storeId: string, input: BatchCreateMemoryInput): Promise<BatchCreateMemoryResult>;
+    listMemories?(storeId: string, options?: MemoryListOptions): Promise<MemoryPage<MemoryListItem>>;
+    getMemory?(storeId: string, memoryId: string): Promise<MemoryInfo>;
+    updateMemory?(storeId: string, memoryId: string, input: UpdateMemoryInput): Promise<MemoryInfo>;
+    deleteMemory?(storeId: string, memoryId: string, expectedContentSha256?: string): Promise<void>;
+    listMemoryVersions?(storeId: string, options?: MemoryVersionListOptions): Promise<MemoryPage<MemoryVersionInfo>>;
+    getMemoryVersion?(storeId: string, versionId: string): Promise<MemoryVersionInfo>;
+    redactMemoryVersion?(storeId: string, versionId: string): Promise<MemoryVersionInfo>;
     createDeployment(name: string, decl: DeploymentDecl, refs: ResolvedDeploymentRefs, basePath: string): Promise<RemoteResource>;
     updateDeployment(id: string, name: string, decl: DeploymentDecl, refs: ResolvedDeploymentRefs, basePath: string): Promise<RemoteResource>;
     deleteDeployment(id: string): Promise<void>;
     runDeployment(ctx: DeploymentContext): Promise<DeploymentRunResult$1>;
     getDeployment(ctx: DeploymentContext): Promise<DeploymentInfo$1>;
+    listDeployments?(filter?: DeploymentListFilter): Promise<DeploymentListResult>;
+    pauseDeployment?(ctx: DeploymentContext): Promise<DeploymentInfo$1>;
+    unpauseDeployment?(ctx: DeploymentContext): Promise<DeploymentInfo$1>;
     uploadFile(filePath: string, options?: {
         name?: string;
         purpose?: string;
@@ -777,6 +998,9 @@ declare function migrateConfig(opts: MigrateOptions): Promise<MigrateResult>;
 interface DeploymentRunAdapter {
     runDeployment(ctx: DeploymentContext): Promise<DeploymentRunResult$1>;
     getDeployment(ctx: DeploymentContext): Promise<DeploymentInfo$1>;
+    listDeployments?(filter?: DeploymentListFilter): Promise<DeploymentListResult>;
+    pauseDeployment?(ctx: DeploymentContext): Promise<DeploymentInfo$1>;
+    unpauseDeployment?(ctx: DeploymentContext): Promise<DeploymentInfo$1>;
 }
 
 interface DeploymentSummary {
@@ -827,9 +1051,11 @@ interface DeploymentRun {
     provider: string;
     result: DeploymentRunResult;
 }
+declare function listRemoteDeploymentsForContext(ctx: ProjectRuntimeContext, provider: string, filter?: DeploymentListFilter): Promise<DeploymentListResult>;
 declare function listDeploymentsForContext(ctx: ProjectRuntimeContext, providerFilter?: string): DeploymentSummary[];
 declare function getDeploymentDetailsForContext(ctx: ProjectRuntimeContext, name: string, adapter?: Pick<DeploymentRunAdapter, "getDeployment">, resolvedProvider?: string): Promise<DeploymentDetail>;
 declare function runDeploymentForContext(ctx: ProjectRuntimeContext, name: string, adapter?: Pick<DeploymentRunAdapter, "runDeployment">, resolvedProvider?: string): Promise<DeploymentRun>;
+declare function pauseDeploymentForContext(ctx: ProjectRuntimeContext, name: string, paused: boolean, resolvedProvider?: string): Promise<DeploymentInfo$1>;
 declare function getDeploymentRuntimeProviderForContext(ctx: ProjectRuntimeContext, name: string, overrideProvider?: string): string;
 
 type DestroyResourceStatus = "success" | "failed" | "blocked" | "skipped";
@@ -890,6 +1116,23 @@ interface ModelListAdapter {
 declare function listProviderModelsForContext(providers: ReadonlyMap<string, ModelListAdapter>, providerFilter?: string): Promise<ProviderModelListing[]>;
 declare function listProviderNames(): string[];
 
+declare function listMemoryStores(providers: ReadonlyMap<string, ProviderAdapter>, provider: string, options?: MemoryStoreListOptions): Promise<MemoryPage<MemoryStoreInfo>>;
+declare function getMemoryProviderCapabilities(providers: ReadonlyMap<string, ProviderAdapter>, provider: string): MemoryProviderCapabilities;
+declare function createMemoryStore(providers: ReadonlyMap<string, ProviderAdapter>, provider: string, input: CreateMemoryStoreInput): Promise<MemoryStoreInfo>;
+declare function deleteMemoryStore(providers: ReadonlyMap<string, ProviderAdapter>, provider: string, id: string): Promise<void>;
+declare function getMemoryStore(providers: ReadonlyMap<string, ProviderAdapter>, provider: string, id: string): Promise<MemoryStoreInfo>;
+declare function updateMemoryStore(providers: ReadonlyMap<string, ProviderAdapter>, provider: string, id: string, input: UpdateMemoryStoreInput): Promise<MemoryStoreInfo>;
+declare function archiveMemoryStore(providers: ReadonlyMap<string, ProviderAdapter>, provider: string, id: string): Promise<MemoryStoreInfo>;
+declare function createMemory(providers: ReadonlyMap<string, ProviderAdapter>, provider: string, storeId: string, input: CreateMemoryInput): Promise<MemoryInfo>;
+declare function batchCreateMemories(providers: ReadonlyMap<string, ProviderAdapter>, provider: string, storeId: string, input: BatchCreateMemoryInput): Promise<BatchCreateMemoryResult>;
+declare function listMemories(providers: ReadonlyMap<string, ProviderAdapter>, provider: string, storeId: string, options?: MemoryListOptions): Promise<MemoryPage<MemoryListItem>>;
+declare function getMemory(providers: ReadonlyMap<string, ProviderAdapter>, provider: string, storeId: string, memoryId: string): Promise<MemoryInfo>;
+declare function updateMemory(providers: ReadonlyMap<string, ProviderAdapter>, provider: string, storeId: string, memoryId: string, input: UpdateMemoryInput): Promise<MemoryInfo>;
+declare function deleteMemory(providers: ReadonlyMap<string, ProviderAdapter>, provider: string, storeId: string, memoryId: string, expected?: string): Promise<void>;
+declare function listMemoryVersions(providers: ReadonlyMap<string, ProviderAdapter>, provider: string, storeId: string, options?: MemoryVersionListOptions): Promise<MemoryPage<MemoryVersionInfo>>;
+declare function getMemoryVersion(providers: ReadonlyMap<string, ProviderAdapter>, provider: string, storeId: string, versionId: string): Promise<MemoryVersionInfo>;
+declare function redactMemoryVersion(providers: ReadonlyMap<string, ProviderAdapter>, provider: string, storeId: string, versionId: string): Promise<MemoryVersionInfo>;
+
 interface AgentSkillBuildInput {
     kind: "official" | "custom";
     /** Skill code/id for official skills. */
@@ -1000,7 +1243,7 @@ declare function listAgentsWithReadiness(ctx: ProjectRuntimeContext, options?: {
 declare function syncAgentResourcesWithStateBackend(input: BackendRuntimeInput, agentId: string, options?: AgentResourceSyncOptions): Promise<AgentSyncRun>;
 
 interface SessionCreateOptions {
-    /** Explicit Qoder Forward Identity id. Overrides defaults.session.qoder.identity_id. */
+    /** Explicit provider Identity id. Overrides the declared defaults.identity reference. */
     identityId?: string;
     environment?: string;
     /**
@@ -1028,6 +1271,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>;
@@ -1139,12 +1384,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
@@ -1212,4 +1461,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, CloudAgent, CloudEnvironment, CloudVault, type CollectedSessionEvents, type DestroyResourceResult, type DestructivePolicy, Diagnostic, type IStateManager, type LoadedProjectConfig, LocalFileStateBackend, 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, UserError, type ValidateProjectConfigOptions, applyProviderConfigToEnv, archiveCloudAgent, areRuntimeCredentialsReady, bootstrapRuntimeCredentials, bootstrapRuntimeCredentialsSync, buildAgentDecl, collectConfigReferences, createCloudEnvironment, createCloudVault, createProjectRuntime, createSessionForAgent, createSkillFromFileId, decideDestructive, deleteCloudEnvironment, deleteCloudVault, deleteFile, deleteSession, deleteSkill, destroyPlannedProjectResources, executePlannedProject, extractSkillZipFiles, getAgent, getDeploymentDetailsForContext, getDeploymentRuntimeProviderForContext, getFileDownloadUrl, getFileInfo, getSession, getSkillInfo, importResource, isTerminalSessionStatus, listAgentsWithReadiness, listCloudAgents, listCloudEnvironments, listCloudVaults, listDeploymentsForContext, listFiles, listProviderModelsForContext, listProviderNames, listSessionEvents, listSessionSummaries, listSkills, loadDotEnv, loadProviderConfigIntoEnv, loadProviderConfigIntoEnvSync, migrateConfig, parseStateAddress, planDestroyProjectContext, planProjectContext, preparePromptForProvider, prependFileHint, providerConfigPath, readProjectRuntime, resolveActiveProvider, resolveProjectConfig, resolveProjectConfigFromObject, resolveProviderConfigFromEnv, resolveSessionProvider, resolveSyncProvider, rewriteFileMentions, runDeploymentForContext, sendSessionMessagePolling, sendSessionMessageStreaming, startSessionRun, startSessionRunPolling, streamSessionEvents, syncAgentResourcesWithStateBackend, syncProjectResourcesWithStateBackend, syncProviderResourcesFromContext, syncProviderResourcesFromEnv, uploadFile, validateProjectConfig, writeProjectRuntime };
+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, prepareInitialSessionPrompt, preparePromptForProvider, prependFileHint, providerConfigPath, readProjectRuntime, redactMemoryVersion, resolveActiveProvider, resolveProjectConfig, resolveProjectConfigFromObject, resolveProviderConfigFromEnv, resolveRepositoryMountPath, resolveSessionProvider, resolveSyncProvider, rewriteFileMentions, runDeploymentForContext, sendSessionMessagePolling, sendSessionMessageStreaming, startSessionRun, startSessionRunPolling, streamSessionEvents, syncAgentResourcesWithStateBackend, syncProjectResourcesWithStateBackend, syncProviderResourcesFromContext, syncProviderResourcesFromEnv, updateMemory, updateMemoryStore, uploadFile, validateProjectConfig, writeProjectRuntime };