@qoder-ai/qoder-agent-sdk 1.0.19 → 1.0.21

package/README.md

@@ -47,9 +47,10 @@ const q = query({
 ```
 
 The worker transport uses the runtime installed at
-`dist/_worker/qoder-worker-runtime.obf.mjs`. You can instead set
-`QODER_WORKER_RUNTIME_PATH` or pass
-`new WorkerTransport({ pathToQoderWorkerRuntime })`.
+`dist/_worker/qoder-worker-runtime.obf.mjs`. To use another Worker runtime,
+pass its path explicitly with
+`new WorkerTransport({ pathToQoderWorkerRuntime })`. Environment variables do
+not override the Worker runtime entry.
 
 The package includes a `dist/runtime-manifest.json` that records the default
 runtime and pins the qodercli Worker runtime archive URL. The SDK package itself
@@ -70,14 +71,15 @@ QODER_SKIP_DOWNLOAD=1 npm install @qoder-ai/qoder-agent-sdk zod
 
 `QODER_SKIP_DOWNLOAD` only affects install-time downloads. It does not change the
 package's default runtime. Then point the process transport at an existing
-`qodercli`, or point the worker transport at an existing runtime:
+`qodercli`:
 
 ```bash
 export QODERCLI_PATH=/absolute/path/to/qodercli
-# or
-export QODER_WORKER_RUNTIME_PATH=/absolute/path/to/qoder-worker-runtime.obf.mjs
 ```
 
+To use an existing Worker runtime, pass its absolute path through
+`new WorkerTransport({ pathToQoderWorkerRuntime })`.
+
 `query()` is the only query entry point and defaults to Worker. Pass
 `transport: ProcessTransport.default`,
 `transport: WorkerTransport.default`, or a custom transport provider when a
@@ -143,7 +145,7 @@ short-lived SATs for qodercli. See the
 [host callback example](examples/service-account-token-demo/demo.mjs) for a
 complete Token exchange and query. To reuse a signed-in developer
 workstation, use `qodercliAuth()`. See the
-[SDK authentication guide](docs/public/en/cli/sdk/authentication.mdx) for
+[SDK authentication guide](docs/public/global/cli/sdk/authentication.mdx) for
 complete setup instructions and security guidance.
 
 ## Quick Start

package/dist/core/brand.d.ts

@@ -6,7 +6,9 @@ export declare const SDK_BRAND_CONFIG: {
     packageName: string;
     cliCommands: readonly ["qoderclicn", "qodercn"];
     configDirName: string;
+    projectConfigDirName: string;
     configDirEnv: string;
+    configDirNameEnv: string;
     cliHomeEnv: string;
     accessTokenEnv: string;
     serviceAccountEnv: string;
@@ -15,7 +17,9 @@ export declare const SDK_BRAND_CONFIG: {
     packageName: string;
     cliCommands: readonly ["qodercli", "qoder"];
     configDirName: string;
+    projectConfigDirName: string;
     configDirEnv: string;
+    configDirNameEnv: string;
     cliHomeEnv: string;
     accessTokenEnv: string;
     serviceAccountEnv: string;

package/dist/core/errors.d.ts

@@ -32,4 +32,12 @@ export declare class ProtocolVersionMismatchError extends Error {
     readonly cliProtocolVersion: string;
     readonly sdkProtocolVersion: string;
     constructor(cliProtocolVersion: string, sdkProtocolVersion: string);
+}
+/**
+ * Thrown when an SDK operation requires a protocol capability that the
+ * running qodercli process did not advertise in its system/init message.
+ */
+export declare class UnsupportedCliCapabilityError extends Error {
+    readonly capability: string;
+    constructor(capability: string);
 }

package/dist/global/plugins.d.ts

@@ -1,4 +1,4 @@
-import type { PluginDetails, InstallPluginResult, UninstallPluginResult } from '../types/plugins.js';
+import type { PluginDetails, InstallPluginResult, PluginValidationReport, ValidatePluginOptions, UninstallPluginResult } from '../types/plugins.js';
 export declare function listPlugins(opts?: {
     orgId?: string;
     cliPath?: string;
@@ -20,4 +20,10 @@ export declare function uninstallPlugin(id: string, opts?: {
     keepData?: boolean;
     cliPath?: string;
     env?: Record<string, string>;
-}): Promise<UninstallPluginResult>;
+}): Promise<UninstallPluginResult>;
+/**
+ * Statically validate a local plugin without creating a session or executing
+ * plugin hooks, MCP servers, or binaries. Invalid plugin content is returned
+ * as a report; transport and CLI capability failures reject the promise.
+ */
+export declare function validatePlugin(path: string, opts?: ValidatePluginOptions): Promise<PluginValidationReport>;

package/dist/index.d.ts

@@ -52,6 +52,9 @@
  * ```
  */
 export { query } from './query/query.js';
+export { startup } from './query/startup.js';
+export type { StartupParams, WarmQuery } from './query/startup.js';
+export { resolveSettings } from './settings/resolve-settings.js';
 export { DEFAULT_RUNTIME_TRANSPORT, } from './core/default-runtime.js';
 export { ProcessTransport, QoderCliProcessError, } from './core/process-transport.js';
 export { hasResolvableQoderWorkerRuntime, QoderWorkerRuntimeError, WorkerTransport, resolveQoderWorkerRuntimePath, } from './core/worker-transport.js';
@@ -66,11 +69,11 @@ export { InMemorySessionStore } from './session/session-store.js';
 export { importSessionToStore } from './session/session-import.js';
 export type { ImportSessionToStoreOptions } from './session/session-import.js';
 export type { SessionKey, SessionStore, SessionStoreEntry, SessionStoreFlush, } from './session/session-store.js';
-export { listPlugins, enablePlugin, disablePlugin, installPlugin, uninstallPlugin } from './global/plugins.js';
-export type { PluginDetails, PluginResources, InstallPluginResult, UninstallPluginResult } from './types/plugins.js';
+export { listPlugins, enablePlugin, disablePlugin, installPlugin, uninstallPlugin, validatePlugin, } from './global/plugins.js';
+export type { PluginDetails, PluginResources, InstallPluginResult, UninstallPluginResult, PluginValidationSeverity, PluginValidationPhase, PluginValidationPosition, PluginValidationLocation, PluginValidationDiagnostic, PluginValidationReport, ValidatePluginOptions, } from './types/plugins.js';
 export { submitFeedback } from './feedback.js';
 export type { SubmitFeedbackParams, SubmitFeedbackOptions, IntegrationMode, } from './feedback.js';
-export { AbortError, ModelPolicyTimeoutError, ProtocolVersionMismatchError, } from './core/errors.js';
+export { AbortError, ModelPolicyTimeoutError, ProtocolVersionMismatchError, UnsupportedCliCapabilityError, } from './core/errors.js';
 export { AuthAccessTokenEnvVarError, AuthServiceAccountEnvVarError, } from './core/runtime-launch-options.js';
 export { WIRE_PROTOCOL_VERSION } from './protocol/version.js';
 export type { ModelPromptPatch, ModelPromptPatches, } from './protocol/model-prompt-patches.js';
@@ -83,7 +86,7 @@ export type { AccessTokenInput, AuthOptions, FetchServiceAccountToken, ServiceAc
  */
 export type { FetchJobToken, JobTokenAuthOptions, JobTokenRequest, JobTokenResult, } from './types/auth.js';
 export type { AccountInfo, UsageAddOnQuotaBucket, UsageInfo, UsageOrgResourcePackage, UsageQuotaBucket, SessionCreditsUsage, ApiKeySource, ExitReason, FastModeState, ConfigScope, SettingSource, SDKAssistantMessageError, SDKStatus, EffortLevel, ThinkingAdaptive, ThinkingEnabled, ThinkingDisabled, ThinkingConfig, ModelInfo, ModelSource, ServerModelJson, ServerModelJsonValue, ModelStrategy, ModelPromotion, LocalizedModelText, ModelContextConfig, ModelContextWindowEntry, ModelEffortEntry, ModelThinkingConfig, ModelThinkingDisabled, ModelThinkingEnabled, ModelUsage, NonNullableUsage, SlashCommand, ToolConfig, SdkPluginConfig, } from './types/common.js';
-export type { SDKMessage, SDKAssistantMessage, SDKUserMessage, SDKUserMessageReplay, SDKResultMessage, SDKResultSuccess, SDKResultError, SDKSystemMessage, SDKSystemInitMessage, SDKSystemMessageSubtype, SDKSystemMessageBySubtype, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKPermissionDeniedMessage, SDKMirrorErrorMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKPermissionDenial, } from './types/messages.js';
+export type { SDKMessage, SDKAssistantMessage, SDKUserMessage, SDKUserMessageReplay, SDKResultMessage, SDKResultSuccess, SDKResultError, SDKSystemMessage, SDKSystemInitMessage, SDKSystemMessageSubtype, SDKSystemMessageBySubtype, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKPermissionDeniedMessage, SDKMirrorErrorMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKPermissionDenial, } from './types/messages.js';
 export type { DefaultRuntimeTransport, } from './core/default-runtime.js';
 export type { QueryTransportCreateOptions, QueryTransportProviderOption, } from './core/query-transport.js';
 export type { ProcessTransportOptions } from './core/process-transport.js';
@@ -95,13 +98,13 @@ export type { SettingSource as SettingSourceFromOptions } from './types/options.
 export type { PermissionMode, PermissionBehavior, PermissionDecisionClassification, PermissionUpdateDestination, PermissionRuleValue, PermissionUpdate, PermissionResult, CanUseToolOptions, } from './types/permissions.js';
 export type { HookEvent, HookPermissionDecision, HookCallback, HookCallbackMatcher, HookInput, HookSpecificOutput, HookJSONOutput, AsyncHookJSONOutput, SyncHookJSONOutput, BaseHookInput, PreToolUseHookInput, PostToolUseHookInput, PostToolUseFailureHookInput, UserPromptSubmitHookInput, SessionStartHookInput, SessionEndHookInput, StopHookInput, SubagentStartHookInput, SubagentStopHookInput, PreCompactHookInput, PostCompactHookInput, PermissionRequestHookInput, InstructionsLoadedHookInput, CwdChangedHookInput, FileChangedHookInput, PreToolUseHookSpecificOutput, PostToolUseHookSpecificOutput, PostToolUseFailureHookSpecificOutput, UserPromptSubmitHookSpecificOutput, SessionStartHookSpecificOutput, SubagentStartHookSpecificOutput, PermissionRequestHookSpecificOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, } from './types/hooks.js';
 export type { McpStdioServerConfig, McpSSEServerConfig, McpHttpServerConfig, McpSdkServerConfig, McpSdkServerConfigWithInstance, McpServerConfig, McpServerToolPolicy, McpServerConfigForProcessTransport, McpServerStatus, McpServerStatusConfig, } from './types/mcp.js';
-export type { AgentDefinition, AgentInfo, AgentMcpServerSpec, } from './types/agents.js';
-export type { SDKSessionInfo, SessionMessage, ListSessionsOptions, GetSessionInfoOptions, GetSessionMessagesOptions, GetSubagentMessagesOptions, ListSubagentsOptions, SessionMutationOptions, ForkSessionOptions, ForkSessionResult, RewindFilesResult, } from './types/session.js';
-export type { Settings, ResolvedSettings, ResolvedSettingsSource, } from './types/settings.js';
+export type { AgentDefinition, AgentInfo, AgentMemoryScope, AgentMcpServerSpec, } from './types/agents.js';
+export type { SDKSessionInfo, SessionMessage, ListSessionsOptions, GetSessionInfoOptions, GetSessionMessagesOptions, GetSubagentMessagesOptions, ListSubagentsOptions, SessionMutationOptions, ForkSessionOptions, ForkSessionResult, RewindFilesResult, RewindScope, RewindStatus, RewindFileFailure, RewindResult, } from './types/session.js';
+export type { Settings, ResolveSettingsOptions, ResolvedSettingSource, ResolvedSettings, ResolvedSettingsSource, SettingsProvenanceEntry, } from './types/settings.js';
 export { filterEscalatingDefaultMode } from './types/settings.js';
 export type { QoderModelPurpose } from './types/control.js';
-export type { SDKControlRequest, SDKControlResponse, SDKControlInterruptResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGetUsageInfoRequest, SDKControlGetUsageInfoResponse, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse, } from './types/control.js';
+export type { SDKControlRequest, SDKControlResponse, SDKControlInterruptResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGetUsageInfoRequest, SDKControlGetUsageInfoResponse, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse, SDKControlStopTaskRequest, SDKControlBackgroundTasksRequest, SDKControlBackgroundTasksResponse, } from './types/control.js';
 export type { SDKControlGetModelPolicyRequest, SDKControlGetModelPolicyResponse, SDKCapabilities, ModelPolicyContext, ModelPolicyResult, ModelPolicyProvider, } from './types/model-policy-provider.js';
 export type { SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, BYOKModelValidationInput, BYOKProviderInfo, BYOKModelTypeInfo, BYOKModelInfo, CustomModel, } from './types/byok.js';
-export type { AgentInput, AgentOutput, BashInput, FileReadInput, FileReadOutput, FileEditInput, FileWriteInput, GlobInput, GrepInput, WebFetchInput, WebSearchInput, AskUserQuestionInput, NotebookEditInput, TaskCreateInput, TaskCreateOutput, TaskGetInput, TaskGetOutput, TaskUpdateInput, TaskUpdateOutput, TaskListInput, TaskListOutput, ExitPlanModeInput, TodoWriteInput, ToolInputSchemas, ToolOutputSchemas, } from './types/tools.js';
+export type { AgentInput, AgentOutput, AgentToolCompletionResult, AgentToolBackgroundLaunchResult, AgentToolTeammateSpawnedResult, BashInput, FileReadInput, FileReadOutput, FileEditInput, FileWriteInput, GlobInput, GrepInput, WebFetchInput, WebSearchInput, AskUserQuestionInput, NotebookEditInput, TaskCreateInput, TaskCreateOutput, TaskGetInput, TaskGetOutput, TaskUpdateInput, TaskUpdateOutput, TaskListInput, TaskListOutput, ExitPlanModeInput, TodoWriteInput, ToolInputSchemas, ToolOutputSchemas, } from './types/tools.js';
 export type { FeedbackResult } from './types/account.js';