@qoder-ai/qoder-agent-sdk 1.0.20 → 1.0.22

package/README.md

@@ -47,19 +47,24 @@ 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
-does not need to host a copy of the archive. The presence of `dist/_worker` is
-used as an integrity check after installation, not as the mode selector.
-
-The packaged Worker runtime is built as a self-contained universal profile by
-default. Runtime assets such as native keychain bindings, PTY bindings, image
-processing bindings, devtools support, and ripgrep binaries are carried by the
-SDK package instead of by the host product.
+runtime and the URL template for qodercli Worker runtime artifacts. At
+installation time, the SDK resolves exactly one artifact for its own brand,
+the current operating system, and the current architecture. It does not fall
+back to the universal artifact. The SDK package itself does not need to host a
+copy of the archive. The presence of `dist/_worker` is used as an integrity
+check after installation, not as the mode selector.
+
+The installed Worker runtime is self-contained. Platform packages include the
+matching native keychain, PTY, image-processing, and ripgrep assets. Linux
+packages retain both glibc and musl image-processing bindings. OpenHarmony does
+not have an install-delivered platform artifact and must use an explicitly
+supplied runtime source.
 
 If your environment blocks install scripts or network downloads, skip postinstall
 runtime downloads:
@@ -70,14 +75,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

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/process-transport.d.ts

@@ -69,6 +69,8 @@ export interface ProcessTransportOptions {
     sessionId?: string;
     continue?: boolean;
     resume?: string;
+    resumeSessionAt?: string;
+    resumeDropsTurn?: string;
     forkSession?: boolean;
     persistSession?: boolean;
     maxTurns?: number;

package/dist/core/runtime-launch-options.d.ts

@@ -28,6 +28,8 @@ export interface RuntimeLaunchOptions {
     sessionId?: string;
     continue?: boolean;
     resume?: string;
+    resumeSessionAt?: string;
+    resumeDropsTurn?: string;
     forkSession?: boolean;
     persistSession?: boolean;
     maxTurns?: number;

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,8 +69,8 @@ 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, UnsupportedCliCapabilityError, } from './core/errors.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, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKPermissionDenial, } from './types/messages.js';
+export type { SDKMessage, SDKAssistantMessage, SDKToolNonExecutionKind, SDKToolResultMeta, 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';
@@ -97,7 +100,7 @@ export type { HookEvent, HookPermissionDecision, HookCallback, HookCallbackMatch
 export type { McpStdioServerConfig, McpSSEServerConfig, McpHttpServerConfig, McpSdkServerConfig, McpSdkServerConfigWithInstance, McpServerConfig, McpServerToolPolicy, McpServerConfigForProcessTransport, McpServerStatus, McpServerStatusConfig, } from './types/mcp.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, ResolvedSettings, ResolvedSettingsSource, } from './types/settings.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, SDKControlStopTaskRequest, SDKControlBackgroundTasksRequest, SDKControlBackgroundTasksResponse, } from './types/control.js';