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

package/dist/protocol/control.d.ts

@@ -231,6 +231,16 @@ export type SDKControlGetModelPolicyResponse = {
      * the supplied API key instead of the default upstream.
      */
     custom_model?: CustomModel;
+    /**
+     * Optional routing scene label the CLI forwards as the inference request
+     * body `task_id`.
+     */
+    task_id?: string;
+    /**
+     * Optional business sub-task label the CLI forwards as `business.sub_task`
+     * on the inference request (billing/analytics).
+     */
+    sub_task?: string;
 };
 export type SDKControlSetMaxThinkingTokensRequest = {
     type: 'set_max_thinking_tokens';
@@ -514,93 +524,57 @@ export type SDKControlInitializeResponse = {
     capabilities?: string[];
 };
 export type SDKControlGetContextUsageResponse = {
+    model: string;
+    /** Whether optional token-count fields are available in this response. */
+    tokenCountsAvailable: boolean;
+    contextWindow: {
+        /** Context occupancy as a percentage from 0 to 100. */
+        usedPercentage: number;
+        usedTokens?: number;
+        sizeTokens?: number;
+    };
+    /** Local estimates in the same order and category model as `/context`. */
     categories: Array<{
-        name: string;
-        tokens: number;
-        color: string;
-        isDeferred?: boolean;
-    }>;
-    totalTokens: number;
-    maxTokens: number;
-    rawMaxTokens: number;
-    percentage: number;
-    gridRows: Array<Array<{
-        color: string;
-        isFilled: boolean;
-        categoryName: string;
-        tokens: number;
+        type: 'system_prompt' | 'system_tools' | 'skills' | 'messages' | 'other' | 'free_space' | 'auto_compact';
         percentage: number;
-        squareFullness: number;
-    }>>;
-    model: string;
-    memoryFiles: Array<{
-        path: string;
-        type: string;
-        tokens: number;
-    }>;
-    mcpTools: Array<{
-        name: string;
-        serverName: string;
-        tokens: number;
-        isLoaded?: boolean;
+        tokens?: number;
     }>;
-    deferredBuiltinTools?: Array<{
-        name: string;
-        tokens: number;
-        isLoaded: boolean;
-    }>;
-    systemTools?: Array<{
-        name: string;
-        tokens: number;
-    }>;
-    systemPromptSections?: Array<{
-        name: string;
-        tokens: number;
-    }>;
-    agents: Array<{
-        agentType: string;
-        source: string;
-        tokens: number;
-    }>;
-    slashCommands?: {
-        totalCommands: number;
-        includedCommands: number;
-        tokens: number;
+    autoCompact: {
+        enabled: boolean;
+        thresholdPercentage: number;
+        thresholdTokens?: number;
     };
-    skills?: {
-        totalSkills: number;
-        includedSkills: number;
-        tokens: number;
-        skillFrontmatter: Array<{
+    skills: {
+        count: number;
+        /** Aggregate skill frontmatter as a percentage of the full context. */
+        percentageOfContext: number;
+        tokens?: number;
+        items: Array<{
             name: string;
-            source: string;
-            tokens: number;
+            source: 'project' | 'user' | 'built-in' | 'plugin';
+            /** This skill's frontmatter as a percentage of the full context. */
+            percentageOfContext: number;
+            tokens?: number;
         }>;
     };
-    autoCompactThreshold?: number;
-    isAutoCompactEnabled: boolean;
-    messageBreakdown?: {
-        toolCallTokens: number;
-        toolResultTokens: number;
-        attachmentTokens: number;
-        assistantMessageTokens: number;
-        userMessageTokens: number;
-        toolCallsByType: Array<{
-            name: string;
-            callTokens: number;
-            resultTokens: number;
-        }>;
-        attachmentsByType: Array<{
-            name: string;
-            tokens: number;
-        }>;
+    duplicateFileReads: Array<{
+        path: string;
+        count: number;
+        wastedTokens?: number;
+    }>;
+    session: {
+        messageCount: number;
+        promptCount: number;
+        toolCalls: {
+            total: number;
+            succeeded: number;
+            failed: number;
+        };
+        linesChanged: {
+            added: number;
+            removed: number;
+        };
     };
-    apiUsage: {
-        input_tokens: number;
-        output_tokens: number;
-        cache_creation_input_tokens: number;
-        cache_read_input_tokens: number;
-    } | null;
 };
 export type SDKControlReloadPluginsResponse = {
     commands: SlashCommand[];

package/dist/protocol/index.d.ts

@@ -19,7 +19,7 @@ export type { AICodeTrackingLaunchOptions, QoderAgentLaunchOptions, QoderCliFlag
 export { buildQoderCliFlagSettings, buildQoderCliFlagSettingsArgs, } from './launch.js';
 export type { PermissionMode, PermissionBehavior, 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, SDKUserMessage, SDKUserMessageReplay, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKFileAttachment, SDKSystemMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKPermissionDenial, SDKPermissionDeniedMessage, SDKPermissionDeniedReasonType, SDKMessage, } from './messages.js';
+export type { SDKAssistantMessage, SDKToolNonExecutionKind, SDKToolResultMeta, SDKUserMessage, SDKUserMessageReplay, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKFileAttachment, SDKSystemMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, 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/index.js

@@ -1 +1 @@
-var r="1.2.0";function i(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function n(e={}){let t={...e.settings??{}},o=e.aiCodeTracking?.installGitCommitHook;if(o!==void 0){let s=t.aiCodeTracking;t.aiCodeTracking={...i(s)?s:{},installGitCommitHook:o}}return t}function l(e={}){let t=n(e);return Object.keys(t).length===0?[]:["--settings",JSON.stringify(t)]}var p={Main:"main",Plan:"plan",Task:"task",Compact:"compact",Title:"title",Suggestion:"suggestion",Generate:"generate",HookPrompt:"hook_prompt",Subagent:"subagent",WebFetch:"web_fetch",ImageGen:"image_gen",Compression:"compression",Utility:"utility"};export{p as QoderModelPurpose,r as WIRE_PROTOCOL_VERSION,n as buildQoderCliFlagSettings,l as buildQoderCliFlagSettingsArgs};
+var r="1.2.0";function i(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function n(e={}){let t={...e.settings??{}},o=e.aiCodeTracking?.installGitCommitHook;if(o!==void 0){let s=t.aiCodeTracking;t.aiCodeTracking={...i(s)?s:{},installGitCommitHook:o}}return t}function p(e={}){let t=n(e);return Object.keys(t).length===0?[]:["--settings",JSON.stringify(t)]}var l={Main:"main",Plan:"plan",Task:"task",Compact:"compact",Title:"title",Suggestion:"suggestion",Generate:"generate",HookPrompt:"hook_prompt",Subagent:"subagent",WebFetch:"web_fetch",ImageGen:"image_gen",Compression:"compression",Utility:"utility"};export{l as QoderModelPurpose,r as WIRE_PROTOCOL_VERSION,n as buildQoderCliFlagSettings,p as buildQoderCliFlagSettingsArgs};

package/dist/protocol/messages.d.ts

@@ -17,6 +17,13 @@ export type SDKAssistantMessage = {
     type: 'assistant';
     message: BetaMessage;
     parent_tool_use_id: string | null;
+    /**
+     * Present when qodercli synthesized this Assistant message from an API
+     * failure rather than a model response. Embedded hosts can use the marker to
+     * avoid rendering duplicate error text when the terminal Result already
+     * provides a structured error surface.
+     */
+    isApiErrorMessage?: true;
     /** Qoder model request ID, present only when explicitly enabled in the CLI. */
     request_id?: string;
     error?: SDKAssistantMessageError;
@@ -28,6 +35,16 @@ export type SDKAssistantMessage = {
     uuid: UUID;
     session_id: string;
 };
+export type SDKToolNonExecutionKind = 'user-rejected' | 'permission-rule' | 'automode-blocked' | 'automode-unavailable' | 'automode-parsing-error' | 'interrupted' | 'cancelled';
+/**
+ * Display-only metadata for a tool result whose tool did not run to
+ * completion. This wrapper-level field is never part of the model message.
+ */
+export type SDKToolResultMeta = {
+    id: string;
+    non_execution_kind: SDKToolNonExecutionKind;
+    user_feedback?: string;
+};
 export type SDKUserMessage = {
     type: 'user';
     message: MessageParam;
@@ -35,6 +52,7 @@ export type SDKUserMessage = {
     file_attachments?: SDKFileAttachment[];
     isSynthetic?: boolean;
     tool_use_result?: unknown;
+    tool_result_meta?: SDKToolResultMeta[];
     /**
      * Delivery priority. `next` is the default; `now` interrupts the active
      * turn, while `later` waits for the session to become idle.
@@ -57,6 +75,7 @@ export type SDKUserMessageReplay = {
     file_attachments?: SDKFileAttachment[];
     isSynthetic?: boolean;
     tool_use_result?: unknown;
+    tool_result_meta?: SDKToolResultMeta[];
     /**
      * Delivery priority. `next` is the default; `now` interrupts the active
      * turn, while `later` waits for the session to become idle.

package/dist/query/index.d.ts

@@ -4,5 +4,7 @@
  * This is the main entry point for the Qoder Agent SDK query functionality.
  */
 export { query } from './query.js';
+export { startup } from './startup.js';
+export type { StartupParams, WarmQuery } from './startup.js';
 export { QueryRunner } from './query-runner.js';
 export { generateRequestId, createControlRequest, createControlResponse, createControlErrorResponse, isControlResponse, isControlRequest, isControlCancelRequest, isKeepAlive, isStreamlinedText, isStreamlinedToolUseSummary, isPostTurnSummary, isResultMessage, } from './control-protocol.js';

package/dist/query/startup.d.ts

@@ -0,0 +1,11 @@
+import type { Options, Query } from '../types/options.js';
+import type { SDKUserMessage } from '../types/messages.js';
+export interface WarmQuery extends AsyncDisposable {
+    query(prompt: string | AsyncIterable<SDKUserMessage>): Query;
+    close(): void;
+}
+export interface StartupParams {
+    options?: Options;
+    initializeTimeoutMs?: number;
+}
+export declare function startup(params?: StartupParams): Promise<WarmQuery>;

package/dist/runtime-manifest.json

@@ -1,16 +1,16 @@
 {
   "version": 1,
   "brand": "global",
-  "sdkVersion": "1.0.20",
-  "qoderCliVersion": "1.1.18",
+  "sdkVersion": "1.0.22",
+  "qoderCliVersion": "1.1.22",
   "defaultTransport": "worker",
   "workerRuntime": {
     "packaged": false,
     "delivery": "install",
     "source": "qodercli-worker-runtime",
-    "url": "https://download.qoder.com/qodercli/releases/1.1.18/qodercli-worker-runtime-universal.tgz",
-    "artifactName": "qodercli-worker-runtime-universal.tgz",
-    "sdkVersion": "1.0.20",
-    "qoderCliVersion": "1.1.18"
+    "urlTemplate": "https://download.qoder.com/qodercli/releases/1.1.22/qodercli-worker-runtime-{target}.tgz",
+    "artifactNameTemplate": "qodercli-worker-runtime-{target}.tgz",
+    "sdkVersion": "1.0.22",
+    "qoderCliVersion": "1.1.22"
   }
 }

package/dist/settings/resolve-settings.d.ts

@@ -0,0 +1,2 @@
+import type { ResolveSettingsOptions, ResolvedSettings } from '../types/settings.js';
+export declare function resolveSettings(options?: ResolveSettingsOptions): Promise<ResolvedSettings>;

package/dist/types/messages.d.ts

@@ -9,13 +9,15 @@ 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, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKAPIRetryMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKPermissionDenial, } from '../protocol/index.js';
+export type { SDKAssistantMessage, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKAPIRetryMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKPermissionDenial, SDKToolNonExecutionKind, SDKToolResultMeta, } from '../protocol/index.js';
 export type SDKUserMessage = {
     type: 'user';
     message: MessageParam;
     parent_tool_use_id: string | null;
     isSynthetic?: boolean;
     tool_use_result?: unknown;
+    /** CLI-stamped display metadata for tool results that did not execute. */
+    tool_result_meta?: import('../protocol/index.js').SDKToolResultMeta[];
     /**
      * Delivery priority. `next` is the default; `now` interrupts the active
      * turn, while `later` waits for the session to become idle.

package/dist/types/model-policy-provider.d.ts

@@ -48,6 +48,16 @@ export interface ModelPolicyResult {
     });
     /** Optional per-request model policy parameters (contextWindow, reasoningEffort). */
     parameters?: Record<string, unknown>;
+    /**
+     * Optional routing scene label sent as the inference request body `task_id`.
+     * The server selects models by it; internal CLI tasks keep their own values.
+     */
+    taskId?: string;
+    /**
+     * Optional business sub-task label sent as `business.sub_task` on the
+     * inference request, used for billing/analytics. Not involved in routing.
+     */
+    subTask?: string;
 }
 /**
  * Host-registered callback for pull-mode model selection.

package/dist/types/options.d.ts

@@ -141,6 +141,25 @@ export type Options = {
     enableFileCheckpointing?: boolean;
     toolConfig?: ToolConfig;
     forkSession?: boolean;
+    /**
+     * When resuming, load the conversation chain only through this entry UUID.
+     * Use with `resume`; when combined with `forkSession`, the new session starts
+     * from this historical point while retaining its file checkpoint history.
+     * The UUID may identify any persisted chain entry, not only an assistant
+     * message. Use the last entry belonging to the turn that must be kept.
+     */
+    resumeSessionAt?: string;
+    /**
+     * With `resumeSessionAt`, declares the prompt UUID of the turn intended to be
+     * discarded. The CLI refuses the truncation if the discarded range contains
+     * unrelated work such as a queued prompt or task notification.
+     *
+     * A refusal is returned as an execution error whose message starts with
+     * `Resume rejected by --resume-drops-turn:`. Treat it as a deterministic
+     * stale-view conflict: resume without truncation to recover the new evidence
+     * instead of retrying the same request.
+     */
+    resumeDropsTurn?: string;
     hooks?: Partial<Record<HookEvent, HookCallbackMatcher[]>>;
     onElicitation?: OnElicitation;
     /**

package/dist/types/plugins.d.ts

@@ -48,4 +48,56 @@ export type UninstallPluginResult = {
     pluginId: string;
     fullyRemoved: boolean;
     reverseDependents: string[];
+};
+export type PluginValidationSeverity = 'error' | 'warning';
+export type PluginValidationPhase = 'target' | 'manifest' | 'component' | 'load-simulation' | 'installability';
+export type PluginValidationPosition = {
+    line: number;
+    character: number;
+};
+export type PluginValidationLocation = {
+    path: string;
+    jsonPointer?: string;
+    range?: {
+        start: PluginValidationPosition;
+        end: PluginValidationPosition;
+    };
+};
+export type PluginValidationDiagnostic = {
+    severity: PluginValidationSeverity;
+    code: string;
+    message: string;
+    phase: PluginValidationPhase;
+    location?: PluginValidationLocation;
+    suggestion?: string;
+};
+export type PluginValidationReport = {
+    schemaVersion: 1;
+    validator: {
+        name: 'qodercli';
+        version: string;
+    };
+    valid: boolean;
+    target: {
+        inputPath: string;
+        resolvedPath: string;
+        manifestPath?: string;
+    };
+    plugin?: {
+        name: string;
+        version?: string;
+        displayName?: string;
+    };
+    diagnostics: PluginValidationDiagnostic[];
+    summary: {
+        errorCount: number;
+        warningCount: number;
+        componentCount: number;
+    };
+    resources?: PluginResources;
+};
+export type ValidatePluginOptions = {
+    cliPath?: string;
+    env?: Record<string, string>;
+    signal?: AbortSignal;
 };

package/dist/types/session.d.ts

@@ -1,3 +1,4 @@
+import type { SDKToolResultMeta } from '../protocol/messages.js';
 export type SDKSessionInfo = {
     /** Unique session identifier (UUID). */
     sessionId: string;
@@ -31,6 +32,10 @@ export type SessionMessage = {
      * messages, depth-one subagents, and transcripts without this metadata.
      */
     parent_agent_id: string | null;
+    /** Present when qodercli persisted an Assistant synthesized from an API failure. */
+    isApiErrorMessage?: true;
+    /** CLI-stamped display metadata for tool results that did not execute. */
+    tool_result_meta?: SDKToolResultMeta[];
     /**
      * ISO 8601 timestamp of when this transcript entry was written to the
      * jsonl file. Mirrors the on-disk `timestamp` field. Optional because

package/dist/types/settings.d.ts

@@ -1,4 +1,5 @@
 import type { PermissionMode } from './permissions.js';
+import type { SettingSource } from './options.js';
 /**
  * Settings fields with a verified qodercli execution path.
  *
@@ -42,13 +43,25 @@ export interface Settings {
     }>;
     [k: string]: unknown;
 }
+export type ResolvedSettingSource = SettingSource;
 export type ResolvedSettingsSource = {
-    source: 'user' | 'project' | 'local' | 'managed' | 'flag' | string;
+    source: ResolvedSettingSource;
     settings: Settings;
     path?: string;
 };
+export type SettingsProvenanceEntry = {
+    source: ResolvedSettingSource;
+    path?: string;
+};
+export type ResolveSettingsOptions = {
+    /** Directory used to resolve project and local settings. */
+    cwd?: string;
+    /** Filesystem settings sources to load. Omit for all sources; pass [] for none. */
+    settingSources?: SettingSource[];
+};
 export type ResolvedSettings = {
     effective: Settings;
+    provenance: Record<string, SettingsProvenanceEntry>;
     sources: ResolvedSettingsSource[];
 };
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qoder-ai/qoder-agent-sdk",
-  "version": "1.0.20",
+  "version": "1.0.22",
   "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.18",
+  "qoderCliVersion": "1.1.22",
   "qoderSdkBrand": "global",
   "license": "SEE LICENSE IN LICENSE"
 }