@qoder-ai/qoder-agent-sdk 1.0.56 → 1.0.58

package/dist/protocol/index.d.ts

@@ -22,7 +22,7 @@ export type { EffectiveMemoryConfig, MemoryConsumptionFile, MemoryConsumptionRes
 export type { EffectiveEvolutionConfig, EffectiveSkillEvolutionConfig, SerializableEvolutionConfig, SerializableSkillEvolutionConfig, SerializableSkillEvolutionGenerationOptions, SkillEvolutionGateInput, SkillEvolutionGateResult, SkillEvolutionMode, SkillEvolutionResult, SkillEvolutionSuggestion, } from './skill-evolution.js';
 export type { PermissionMode, PermissionBehavior, PermissionScope, CanUseToolPermissionKind, CanUseToolPermissionOption, CanUseToolPermissionDetails, PermissionDecisionClassification, PermissionUpdateDestination, PermissionRuleValue, PermissionUpdate, PermissionResult, } from './permissions.js';
 export type { McpStdioServerConfig, McpSSEServerConfig, McpHttpServerConfig, McpSdkServerConfig, McpServerConfigForProcessTransport, McpServerStatus, McpServerStatusConfig, McpSetServersResult, OAuthToken, } from './mcp.js';
-export type { SDKAssistantMessage, SDKToolNonExecutionKind, SDKToolResultMeta, SDKMessageOrigin, SDKSelectedSkill, SDKUserMessage, SDKUserMessageReplay, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKFileAttachment, SDKSystemMessage, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKCommandsChangedMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, SDKToolProgressMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKPlanModeChangedMessage, SDKGoalUpdatedMessage, SDKGoalClearedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKSkillEvolutionMessage, SDKAgentsMdSizeWarningMessage, SDKPermissionDenial, SDKPermissionDeniedMessage, SDKPermissionDeniedReasonType, SDKMessage, } from './messages.js';
+export type { SDKAssistantMessage, SDKToolNonExecutionKind, SDKToolResultMeta, SDKMessageOrigin, SDKSelectedSkill, SDKUserMessage, SDKUserMessageReplay, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKFileAttachment, SDKSystemMessage, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKCommandsChangedMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, SDKToolProgressMessage, SDKHookDiagnosticsMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKPlanModeChangedMessage, SDKGoalUpdatedMessage, SDKGoalClearedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKSkillEvolutionMessage, SDKAgentsMdSizeWarningMessage, SDKPermissionDenial, SDKPermissionDeniedMessage, SDKPermissionDeniedReasonType, SDKMessage, } from './messages.js';
 export type { BaseHookInput, PreToolUseHookInput, PostToolUseHookInput, PostToolUseFailureHookInput, UserPromptSubmitHookInput, SessionStartHookInput, SessionEndHookInput, StopHookInput, StopFailureHookInput, SubagentStartHookInput, SubagentStopHookInput, PreCompactHookInput, PostCompactHookInput, PermissionRequestHookInput, PermissionDeniedHookInput, SetupHookInput, TeammateIdleHookInput, TaskCreatedHookInput, TaskCompletedHookInput, ElicitationHookInput, ElicitationResultHookInput, ConfigChangeHookInput, WorktreeCreateHookInput, WorktreeRemoveHookInput, InstructionsLoadedHookInput, CwdChangedHookInput, FileChangedHookInput, HookInput, PreToolUseHookSpecificOutput, PostToolUseHookSpecificOutput, PostToolUseFailureHookSpecificOutput, UserPromptSubmitHookSpecificOutput, SessionStartHookSpecificOutput, SetupHookSpecificOutput, SubagentStartHookSpecificOutput, PermissionRequestHookSpecificOutput, ElicitationHookSpecificOutput, ElicitationResultHookSpecificOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, WorktreeCreateHookSpecificOutput, SyncHookJSONOutput, AsyncHookJSONOutput, HookJSONOutput, HookEvent, } from './hooks.js';
 export type { AgentMcpServerSpec, AgentDefinition, AgentInfo, AgentMemoryScope, } from './agents.js';
 export { QoderModelPurpose } from './control.js';

package/dist/protocol/messages.d.ts

@@ -169,6 +169,8 @@ export type SDKResultError = {
     modelUsage: Record<string, ModelUsage>;
     permission_denials: SDKPermissionDenial[];
     errors: string[];
+    /** 服务端业务说明，仅做必要脱敏；缺失时省略，与 CLI 展示文案 errors 独立。 */
+    error_message?: string;
     error_code?: number | string;
     terminal_reason?: string | null;
     fast_mode_state?: FastModeState;
@@ -297,6 +299,27 @@ export type SDKCommandLifecycleMessage = {
     uuid: UUID;
     session_id: string;
 };
+/** Existing static configuration diagnostics; no Hook execution is performed.
+ * Delivery is scheduled in the background and may follow the refresh response.
+ * Each message replaces the previous diagnostics. An empty complete result means
+ * no issues were reported by existing checks, not that Hooks can run successfully.
+ */
+export type SDKHookDiagnosticsMessage = {
+    type: 'system';
+    subtype: 'hook_diagnostics';
+    read_status: 'complete' | 'partial' | 'failed';
+    checked_at: string;
+    diagnostics: Array<{
+        code: 'hook_validation_error' | 'settings_load_error' | 'plugin_hook_load_error' | 'hook_reload_error';
+        message: string;
+        event?: string;
+        field?: string;
+        /** Opaque configuration entry reference; changes when the entry changes. */
+        hook_ref?: string;
+    }>;
+    uuid: UUID;
+    session_id: string;
+};
 export type SDKHookStartedMessage = {
     type: 'system';
     subtype: 'hook_started';
@@ -639,4 +662,4 @@ export type SDKToolProgressMessage = {
     total_lines?: number;
     preview_truncated?: boolean;
 };
-export type SDKMessage = SDKToolProgressMessage | SDKAgentsMdSizeWarningMessage | SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKArtifactUpdateMessage | SDKAvailableModelsUpdateMessage | SDKCommandsChangedMessage | SDKPermissionDeniedMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKModelQueueStatusMessage | SDKControlRequestProgressMessage | SDKCommandLifecycleMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKTaskUpdatedMessage | SDKBackgroundTasksChangedMessage | SDKSessionStateChangedMessage | SDKPlanModeChangedMessage | SDKGoalUpdatedMessage | SDKGoalClearedMessage | SDKSessionTitleChangedMessage | SDKFilesPersistedEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage | SDKCloudAgentEventMessage | SDKMemoryGenerationMessage | SDKMemoryConsumptionMessage | SDKSkillEvolutionMessage;
+export type SDKMessage = SDKToolProgressMessage | SDKAgentsMdSizeWarningMessage | SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKArtifactUpdateMessage | SDKAvailableModelsUpdateMessage | SDKCommandsChangedMessage | SDKPermissionDeniedMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKModelQueueStatusMessage | SDKControlRequestProgressMessage | SDKCommandLifecycleMessage | SDKHookDiagnosticsMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKTaskUpdatedMessage | SDKBackgroundTasksChangedMessage | SDKSessionStateChangedMessage | SDKPlanModeChangedMessage | SDKGoalUpdatedMessage | SDKGoalClearedMessage | SDKSessionTitleChangedMessage | SDKFilesPersistedEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage | SDKCloudAgentEventMessage | SDKMemoryGenerationMessage | SDKMemoryConsumptionMessage | SDKSkillEvolutionMessage;

package/dist/runtime-manifest.json

@@ -1,16 +1,16 @@
 {
   "version": 1,
   "brand": "global",
-  "sdkVersion": "1.0.56",
-  "qoderCliVersion": "1.1.78",
+  "sdkVersion": "1.0.58",
+  "qoderCliVersion": "1.1.81",
   "defaultTransport": "worker",
   "workerRuntime": {
     "packaged": false,
     "delivery": "install",
     "source": "qodercli-worker-runtime",
-    "urlTemplate": "https://download.qoder.com/qodercli/releases/1.1.78/qodercli-worker-runtime-{target}.tgz",
+    "urlTemplate": "https://download.qoder.com/qodercli/releases/1.1.81/qodercli-worker-runtime-{target}.tgz",
     "artifactNameTemplate": "qodercli-worker-runtime-{target}.tgz",
-    "sdkVersion": "1.0.56",
-    "qoderCliVersion": "1.1.78"
+    "sdkVersion": "1.0.58",
+    "qoderCliVersion": "1.1.81"
   }
 }

package/dist/types/index.d.ts

@@ -6,12 +6,9 @@ export * from './common.js';
 export * from './messages.js';
 export * from './memory.js';
 export * from './artifacts.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';
-export type { WorkerRuntimeTransportOptions, WorkerTransportOptions, } from '../core/worker-transport.js';
 export type { QueryTransportProvider, Transport, } from '../core/transport.js';
-export type { ElicitationRequest, ElicitationResult, OnElicitation, PromptRequestOption, PromptRequest, PromptResponse, SecurityScanOptions, Options, QueryTransportOptions, SpawnOptions, SpawnedProcess, Query, } from './options.js';
+export type { ElicitationRequest, ElicitationResult, OnElicitation, PromptRequestOption, PromptRequest, PromptResponse, SecurityScanOptions, Options, QueryTransportOptions, Query, } from './options.js';
 export * from './permissions.js';
 export type { HostActionOptions, HostActionParams } from './host-action.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, PermissionDeniedHookInput, InstructionsLoadedHookInput, WorktreeCreateHookInput, WorktreeRemoveHookInput, CwdChangedHookInput, FileChangedHookInput, PreToolUseHookSpecificOutput, PostToolUseHookSpecificOutput, PostToolUseFailureHookSpecificOutput, UserPromptSubmitHookSpecificOutput, SessionStartHookSpecificOutput, SubagentStartHookSpecificOutput, PermissionRequestHookSpecificOutput, WorktreeCreateHookSpecificOutput, CwdChangedHookSpecificOutput, FileChangedHookSpecificOutput, } from './hooks.js';

package/dist/types/messages.d.ts

@@ -9,7 +9,7 @@ import type { SDKMessage as ProtocolSDKMessage, SDKStatusMessage as ProtocolSDKS
 import type { MessageParam, UUID } from './common.js';
 import type { PermissionMode } from './permissions.js';
 import type { SessionKey } from '../session/session-store.js';
-export type { SDKAssistantMessage, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKCommandsChangedMessage, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, SDKToolProgressMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKPlanModeChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKSkillEvolutionMessage, SDKAgentsMdSizeWarningMessage, SDKPermissionDenial, SDKMessageOrigin, SDKSelectedSkill, SDKToolNonExecutionKind, SDKToolResultMeta, } from '../protocol/index.js';
+export type { SDKAssistantMessage, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKCommandsChangedMessage, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, SDKToolProgressMessage, SDKHookDiagnosticsMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKPlanModeChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKSkillEvolutionMessage, SDKAgentsMdSizeWarningMessage, SDKPermissionDenial, SDKMessageOrigin, SDKSelectedSkill, SDKToolNonExecutionKind, SDKToolResultMeta, } from '../protocol/index.js';
 export type SDKUserMessage = {
     type: 'user';
     message: MessageParam;

package/dist/types/options.d.ts

@@ -1,4 +1,4 @@
-import type { Readable, Writable } from 'stream';
+import type { Readable, Writable } from 'node:stream';
 import type { CloseDiagnosticEvent } from './close-diagnostics.js';
 import type { ElicitResult } from '@modelcontextprotocol/sdk/types.js';
 import type { AuthOptions, InternalAuthOptions } from './auth.js';
@@ -9,7 +9,7 @@ import type { HookCallbackMatcher, HookEvent } from './hooks.js';
 import type { McpServerConfig, McpServerStatus, McpSetServersResult, OAuthToken } from './mcp.js';
 import type { SDKMessage, SDKUserMessage } from './messages.js';
 import type { Settings } from './settings.js';
-import type { SDKControlInterruptResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGenerateSessionTitleResponse, AskSideQuestionOptions, SideQuestionResult, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse, SDKControlReloadSkillsResponse, StdoutMessage } from './control.js';
+import type { SDKControlInterruptResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGenerateSessionTitleResponse, AskSideQuestionOptions, SideQuestionResult, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse, SDKControlReloadSkillsResponse } from './control.js';
 import type { ModelPolicyProvider } from './model-policy-provider.js';
 import type { BYOKModelValidationInput, BYOKProviderInfo, ByokConfigCheckResult, ByokConfigInfo, ByokConfigReference, CheckByokConfigInput, CreateByokConfigInput, DeleteByokConfigInput, UpdateByokConfigInput } from './byok.js';
 import type { RewindFilesResult, RewindResult, RewindScope } from './session.js';
@@ -99,9 +99,9 @@ export type Options = {
      * - `{ type: 'jobToken', fetchJobToken }` - Internal first-party host
      *   integration. Prefer the `jobToken(fetchJobToken)` helper in host code.
      *
-     * Required for direct `query()` sessions. A Query using `options.daemon`
-     * inherits authentication configured when the daemon was started and must
-     * omit this field.
+     * Required unless `options.daemon` refers to a daemon that was started with
+     * its own credentials. Every other query starts the process-wide daemon with
+     * these credentials.
      */
     auth?: InternalAuthOptions;
     additionalDirectories?: string[];
@@ -124,13 +124,17 @@ export type Options = {
      */
     experimentalCloudAgent?: CloudAgentOptions;
     /**
-     * Selects the local query transport.
+     * Selects the shared daemon's launch carrier for the first implicit daemon
+     * start.
      *
-     * - omitted: use the transport baked into the installed SDK package.
-     * - `ProcessTransport.default`: spawn qodercli as a child process.
-     * - `WorkerTransport.default`: run qoder-worker-runtime in a Node worker thread.
-     * - `new WorkerTransport({ ... })`: run worker runtime with provider options.
+     * - omitted: the daemon uses the package's `DEFAULT_RUNTIME_TRANSPORT`.
+     * - `ProcessTransport.default`: launch qodercli as a process carrier.
+     * - `WorkerTransport.default`: launch the bundled worker runtime.
+     * - `new WorkerTransport({ ... })`: launch the given worker runtime.
      * - custom `QueryTransportProvider`: provide a fresh transport per query.
+     *
+     * Once the daemon is ready, a query with a different launch mode is rejected
+     * with `DaemonConfigurationConflictError`.
      */
     transport?: QueryTransportOptions;
     agent?: string;
@@ -245,11 +249,6 @@ export type Options = {
      * disable.
      */
     controlRequestTimeoutMs?: number;
-    /**
-     * Grace period in milliseconds before the local transport terminates qodercli
-     * after closing stdin. Defaults to 2000.
-     */
-    closeGraceMs?: number;
     includePartialMessages?: boolean;
     includeHookEvents?: boolean;
     /** Opt in to bounded foreground shell previews via tool_progress on supported daemons. Defaults to off. */
@@ -265,11 +264,10 @@ export type Options = {
     allowedMcpServerNames?: string[];
     model?: string;
     /**
-     * Path to a local Qoder runtime.
+     * Path to the local Qoder CLI entry that the daemon process launches.
      *
-     * Native binaries and ordinary JavaScript CLI entries use ProcessTransport.
-     * Recognized `qoder-worker-runtime*.mjs` entries use WorkerTransport. An
-     * explicit `transport` provider takes precedence over this automatic choice.
+     * Native binaries and JavaScript CLI entries are both supported; a script
+     * entry runs through `executable` (or the SDK host's Node binary).
      */
     pathToQoderCLIExecutable?: string;
     permissionMode?: PermissionMode;
@@ -361,6 +359,11 @@ export type Options = {
      * logging, but is not forwarded to qodercli.
      */
     debugFile?: string;
+    /**
+     * Accepted for compatibility with the former per-query transport. The
+     * shared daemon owns process termination, so this value is ignored.
+     */
+    closeGraceMs?: number;
     spawnQoderCLIProcess?: (options: SpawnOptions) => SpawnedProcess;
 };
 export interface SpawnOptions {
@@ -652,12 +655,4 @@ export interface InternalQuery extends Query {
     reconnectMcpServer(serverName: string): Promise<void>;
     mcpClearAuth(serverName: string): Promise<void>;
     injectMcpToken(serverName: string, token: OAuthToken): Promise<void>;
-}
-export interface Transport {
-    initialize(): Promise<void>;
-    write(data: string): void | Promise<void>;
-    close(): void;
-    isReady(): boolean;
-    readMessages(): AsyncGenerator<StdoutMessage, void, unknown>;
-    endInput(): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qoder-ai/qoder-agent-sdk",
-  "version": "1.0.56",
+  "version": "1.0.58",
   "description": "TypeScript SDK for building Qoder-powered coding agents.",
   "type": "module",
   "main": "dist/index.js",
@@ -50,7 +50,7 @@
   "peerDependencies": {
     "zod": "^3.25.0 || ^4.0.0"
   },
-  "qoderCliVersion": "1.1.78",
+  "qoderCliVersion": "1.1.81",
   "qoderSdkBrand": "global",
   "license": "SEE LICENSE IN LICENSE"
 }