@qoder-ai/qoder-agent-sdk 1.0.23 → 1.0.25
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +24 -0
- package/dist/core/brand.d.ts +10 -0
- package/dist/core/constants.d.ts +5 -4
- package/dist/core/process-transport.d.ts +7 -1
- package/dist/core/runtime-command.d.ts +14 -0
- package/dist/core/runtime-launch-options.d.ts +4 -1
- package/dist/core/security-scan-options.d.ts +7 -0
- package/dist/core/worker-runtime-launch.d.ts +16 -0
- package/dist/core/worker-runtime-path.d.ts +2 -0
- package/dist/core/worker-transport.d.ts +3 -3
- package/dist/global/plugins.d.ts +3 -9
- package/dist/index.d.ts +5 -4
- package/dist/index.js +30 -30
- package/dist/memory/memory-options.d.ts +7 -0
- package/dist/protocol/control.d.ts +95 -1
- package/dist/protocol/index.d.ts +3 -2
- package/dist/protocol/index.js +1 -1
- package/dist/protocol/launch.d.ts +4 -0
- package/dist/protocol/memory.d.ts +137 -0
- package/dist/protocol/messages.d.ts +70 -1
- package/dist/query/query-runner.d.ts +39 -2
- package/dist/runtime-manifest.json +5 -5
- package/dist/types/control.d.ts +1 -1
- package/dist/types/index.d.ts +2 -1
- package/dist/types/memory.d.ts +74 -0
- package/dist/types/messages.d.ts +2 -1
- package/dist/types/options.d.ts +75 -1
- package/dist/types/plugins.d.ts +12 -0
- package/dist/types/session.d.ts +6 -0
- package/package.json +2 -2
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { MemoryOptions, MemoryRuntimeCallbacks } from '../types/memory.js';
|
|
2
|
+
import type { SerializableMemoryConfig } from '../protocol/memory.js';
|
|
3
|
+
export type PreparedMemoryOptions = {
|
|
4
|
+
config?: SerializableMemoryConfig;
|
|
5
|
+
callbacks?: MemoryRuntimeCallbacks;
|
|
6
|
+
};
|
|
7
|
+
export declare function prepareMemoryOptions(memory: MemoryOptions | undefined): PreparedMemoryOptions;
|
|
@@ -20,6 +20,7 @@ import type { AgentDefinition, AgentInfo } from './agents.js';
|
|
|
20
20
|
import type { AccountInfo, FastModeState, ModelInfo, SessionCreditsUsage, SlashCommand, SdkPluginConfig, UsageInfo } from './common.js';
|
|
21
21
|
import type { PluginDetails } from '../types/plugins.js';
|
|
22
22
|
import type { ModelPromptPatches } from './model-prompt-patches.js';
|
|
23
|
+
import type { EffectiveMemoryConfig, MemoryGenerationGateInput, SerializableMemoryConfig } from './memory.js';
|
|
23
24
|
export type SDKControlRequest = {
|
|
24
25
|
type: 'control_request';
|
|
25
26
|
request_id: string;
|
|
@@ -113,6 +114,7 @@ export type SDKControlInitializeRequest = {
|
|
|
113
114
|
supportsCatalogReadyInitialize?: boolean;
|
|
114
115
|
initializeTimeoutMs?: number;
|
|
115
116
|
agentProgressSummaries?: boolean;
|
|
117
|
+
memory?: SerializableMemoryConfig;
|
|
116
118
|
hooks?: Partial<Record<HookEvent, Array<{
|
|
117
119
|
hookCallbackIds: string[];
|
|
118
120
|
timeout?: number;
|
|
@@ -126,6 +128,17 @@ export type SDKControlInitializeRequest = {
|
|
|
126
128
|
*/
|
|
127
129
|
scene?: string;
|
|
128
130
|
};
|
|
131
|
+
export type SDKControlMemoryShouldGenerateRequest = {
|
|
132
|
+
type: 'memory_should_generate';
|
|
133
|
+
callbackId: string;
|
|
134
|
+
input: MemoryGenerationGateInput;
|
|
135
|
+
};
|
|
136
|
+
export type SDKControlFlushMemoryRequest = {
|
|
137
|
+
type: 'flush_memory';
|
|
138
|
+
};
|
|
139
|
+
export type SDKControlRefreshMemoryRequest = {
|
|
140
|
+
type: 'refresh_memory';
|
|
141
|
+
};
|
|
129
142
|
export type SDKControlSetPermissionModeRequest = {
|
|
130
143
|
type: 'set_permission_mode';
|
|
131
144
|
mode: PermissionMode;
|
|
@@ -146,6 +159,45 @@ export type SDKControlGenerateSessionTitleRequest = {
|
|
|
146
159
|
export type SDKControlGenerateSessionTitleResponse = {
|
|
147
160
|
title: string | null;
|
|
148
161
|
};
|
|
162
|
+
/** One completed side-question exchange that may be reused as local context. */
|
|
163
|
+
export type SideQuestionHistoryEntry = {
|
|
164
|
+
question: string;
|
|
165
|
+
response: string;
|
|
166
|
+
/** Optional notice explaining that a fallback model produced the response. */
|
|
167
|
+
fallback_notice?: string;
|
|
168
|
+
};
|
|
169
|
+
/** Options for a side question that does not interrupt the main agent turn. */
|
|
170
|
+
export type AskSideQuestionOptions = {
|
|
171
|
+
/** Cancels only this side question. The main agent turn continues running. */
|
|
172
|
+
signal?: AbortSignal;
|
|
173
|
+
/** Previous side-question exchanges to include as local context. */
|
|
174
|
+
history?: readonly SideQuestionHistoryEntry[];
|
|
175
|
+
};
|
|
176
|
+
export type SideQuestionRefusalFallback = {
|
|
177
|
+
originalModel: string;
|
|
178
|
+
fallbackModel: string;
|
|
179
|
+
content: string;
|
|
180
|
+
};
|
|
181
|
+
/** Public result returned by {@link Query.askSideQuestion}. */
|
|
182
|
+
export type SideQuestionResult = {
|
|
183
|
+
response: string;
|
|
184
|
+
synthetic: boolean;
|
|
185
|
+
refusalFallback?: SideQuestionRefusalFallback;
|
|
186
|
+
};
|
|
187
|
+
export type SDKControlSideQuestionRequest = {
|
|
188
|
+
subtype: 'side_question';
|
|
189
|
+
question: string;
|
|
190
|
+
history?: SideQuestionHistoryEntry[];
|
|
191
|
+
};
|
|
192
|
+
export type SDKControlSideQuestionResponse = {
|
|
193
|
+
response: string | null;
|
|
194
|
+
synthetic?: boolean;
|
|
195
|
+
refusal_fallback?: {
|
|
196
|
+
original_model: string;
|
|
197
|
+
fallback_model: string;
|
|
198
|
+
content: string;
|
|
199
|
+
};
|
|
200
|
+
};
|
|
149
201
|
export type SDKControlAddDirectoriesRequest = {
|
|
150
202
|
type: 'add_directories';
|
|
151
203
|
directories: string[];
|
|
@@ -506,7 +558,48 @@ export type SDKControlBackgroundTasksResponse = {
|
|
|
506
558
|
/** Present for a targeted tool use. Bulk backgrounding may omit the body. */
|
|
507
559
|
backgrounded?: boolean;
|
|
508
560
|
};
|
|
509
|
-
|
|
561
|
+
/** Lifecycle status of a goal (aligned with the CLI goal state machine). */
|
|
562
|
+
export type SDKGoalStatus = 'active' | 'paused' | 'blocked' | 'usage_limited' | 'budget_limited' | 'complete';
|
|
563
|
+
/** Structured snapshot of the current goal. */
|
|
564
|
+
export type SDKGoalSnapshot = {
|
|
565
|
+
id: string;
|
|
566
|
+
objective: string;
|
|
567
|
+
status: SDKGoalStatus;
|
|
568
|
+
turns_used: number;
|
|
569
|
+
max_turns?: number;
|
|
570
|
+
time_used_seconds: number;
|
|
571
|
+
credits_budget?: number;
|
|
572
|
+
credits_used?: number;
|
|
573
|
+
created_at: number;
|
|
574
|
+
updated_at: number;
|
|
575
|
+
};
|
|
576
|
+
/**
|
|
577
|
+
* Create, redirect, transition, or re-budget the session goal. Omitted fields
|
|
578
|
+
* are left unchanged; `credits_budget: null` explicitly clears the budget.
|
|
579
|
+
* Setting `status: 'active'` while the session is idle starts the goal loop.
|
|
580
|
+
*/
|
|
581
|
+
export type SDKControlSetGoalRequest = {
|
|
582
|
+
subtype: 'set_goal';
|
|
583
|
+
objective?: string;
|
|
584
|
+
status?: SDKGoalStatus;
|
|
585
|
+
credits_budget?: number | null;
|
|
586
|
+
};
|
|
587
|
+
export type SDKControlSetGoalResponse = {
|
|
588
|
+
goal: SDKGoalSnapshot | null;
|
|
589
|
+
};
|
|
590
|
+
export type SDKControlGetGoalRequest = {
|
|
591
|
+
subtype: 'get_goal';
|
|
592
|
+
};
|
|
593
|
+
export type SDKControlGetGoalResponse = {
|
|
594
|
+
goal: SDKGoalSnapshot | null;
|
|
595
|
+
};
|
|
596
|
+
export type SDKControlClearGoalRequest = {
|
|
597
|
+
subtype: 'clear_goal';
|
|
598
|
+
};
|
|
599
|
+
export type SDKControlClearGoalResponse = {
|
|
600
|
+
cleared: boolean;
|
|
601
|
+
};
|
|
602
|
+
export type SDKControlRequestInner = SDKControlInterruptRequest | SDKControlPermissionRequest | SDKControlInitializeRequest | SDKControlSetPermissionModeRequest | SDKControlSetModelRequest | SDKControlSetProxyRequest | SDKControlGenerateSessionTitleRequest | SDKControlSideQuestionRequest | SDKControlAddDirectoriesRequest | SDKControlSetMaxThinkingTokensRequest | SDKControlMcpStatusRequest | SDKControlGetContextUsageRequest | SDKControlGetUsageInfoRequest | SDKControlGetModelPolicyRequest | SDKControlAccountInfoRequest | SDKHookCallbackRequest | SDKControlMcpMessageRequest | SDKControlRewindFilesRequest | SDKControlRewindRequest | SDKControlCancelAsyncMessageRequest | SDKControlSeedReadStateRequest | SDKControlMcpSetServersRequest | SDKControlReloadPluginsRequest | SDKControlMcpReconnectRequest | SDKControlMcpToggleRequest | SDKControlApplyFlagSettingsRequest | SDKControlGetSettingsRequest | SDKControlElicitationRequest | SDKControlEndSessionRequest | SDKControlChannelEnableRequest | SDKControlMcpInjectTokenRequest | SDKControlMcpAuthenticateRequest | SDKControlMcpOAuthCallbackUrlRequest | SDKControlMcpClearAuthRequest | SDKControlGetByokConfigRequest | SDKControlValidateByokModelRequest | SDKControlListPluginsRequest | SDKControlStopTaskRequest | SDKControlBackgroundTasksRequest | SDKControlMemoryShouldGenerateRequest | SDKControlFlushMemoryRequest | SDKControlRefreshMemoryRequest | SDKControlSetGoalRequest | SDKControlGetGoalRequest | SDKControlClearGoalRequest;
|
|
510
603
|
export type SDKControlInitializeResponse = {
|
|
511
604
|
commands: SlashCommand[];
|
|
512
605
|
agents: AgentInfo[];
|
|
@@ -522,6 +615,7 @@ export type SDKControlInitializeResponse = {
|
|
|
522
615
|
fast_mode_state?: FastModeState;
|
|
523
616
|
/** Optional features implemented by the connected CLI control channel. */
|
|
524
617
|
capabilities?: string[];
|
|
618
|
+
memory?: EffectiveMemoryConfig;
|
|
525
619
|
};
|
|
526
620
|
export type SDKControlGetContextUsageResponse = {
|
|
527
621
|
model: string;
|
package/dist/protocol/index.d.ts
CHANGED
|
@@ -17,10 +17,11 @@ export type { ModelPromptPatch, ModelPromptPatches, } from './model-prompt-patch
|
|
|
17
17
|
export type { UUID, BetaMessage, BetaRawMessageStreamEvent, BetaUsage, BetaStopReason, MessageParam, NonNullableUsage, 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, PluginInfo, ModelUsage, SlashCommand, ToolConfig, SdkPluginConfig, } from './common.js';
|
|
18
18
|
export type { AICodeTrackingLaunchOptions, QoderAgentLaunchOptions, QoderCliFlagSettings, } from './launch.js';
|
|
19
19
|
export { buildQoderCliFlagSettings, buildQoderCliFlagSettingsArgs, } from './launch.js';
|
|
20
|
+
export type { EffectiveMemoryConfig, MemoryConsumptionFile, MemoryConsumptionResult, MemoryGenerationFailedFile, MemoryGenerationGateInput, MemoryGenerationGateResult, MemoryGenerationResult, MemoryMode, MemoryRoot, MemoryRootAccess, SerializableMemoryConfig, SerializableMemoryConsumptionOptions, SerializableMemoryGenerationOptions, } from './memory.js';
|
|
20
21
|
export type { PermissionMode, PermissionBehavior, PermissionDecisionClassification, PermissionUpdateDestination, PermissionRuleValue, PermissionUpdate, PermissionResult, } from './permissions.js';
|
|
21
22
|
export type { McpStdioServerConfig, McpSSEServerConfig, McpHttpServerConfig, McpSdkServerConfig, McpServerConfigForProcessTransport, McpServerStatus, McpServerStatusConfig, McpSetServersResult, OAuthToken, } from './mcp.js';
|
|
22
|
-
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';
|
|
23
|
+
export type { SDKAssistantMessage, SDKToolNonExecutionKind, SDKToolResultMeta, SDKUserMessage, SDKUserMessageReplay, SDKResultSuccess, SDKResultError, SDKResultMessage, SDKFileAttachment, SDKSystemMessage, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKGoalUpdatedMessage, SDKGoalClearedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKPermissionDenial, SDKPermissionDeniedMessage, SDKPermissionDeniedReasonType, SDKMessage, } from './messages.js';
|
|
23
24
|
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';
|
|
24
25
|
export type { AgentMcpServerSpec, AgentDefinition, AgentInfo, AgentMemoryScope, } from './agents.js';
|
|
25
26
|
export { QoderModelPurpose } from './control.js';
|
|
26
|
-
export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, SDKControlInterruptRequest, SDKControlInterruptResponse, SDKControlPermissionRequest, SDKControlInitializeRequest, SDKControlSetPermissionModeRequest, SDKControlSetModelRequest, SDKControlGenerateSessionTitleRequest, SDKControlGenerateSessionTitleResponse, SDKControlAddDirectoriesRequest, SDKControlAddDirectoriesResponse, SDKControlGetModelPolicyRequest, SDKControlGetModelPolicyResponse, SDKControlSetMaxThinkingTokensRequest, SDKControlMcpStatusRequest, SDKControlGetContextUsageRequest, SDKControlGetUsageInfoRequest, SDKControlGetUsageInfoResponse, SDKControlAccountInfoRequest, SDKHookCallbackRequest, SDKControlMcpMessageRequest, SDKControlRewindFilesRequest, SDKControlRewindRequest, SDKControlCancelAsyncMessageRequest, SDKControlSeedReadStateRequest, SDKControlMcpSetServersRequest, SDKControlReloadPluginsRequest, SDKControlMcpReconnectRequest, SDKControlMcpToggleRequest, SDKControlApplyFlagSettingsRequest, SDKControlGetSettingsRequest, SDKControlElicitationRequest, SDKControlEndSessionRequest, SDKControlChannelEnableRequest, SDKControlMcpInjectTokenRequest, SDKControlMcpAuthenticateRequest, SDKControlMcpOAuthCallbackUrlRequest, SDKControlMcpClearAuthRequest, SDKControlRequestInner, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlReloadPluginsResponse, SDKControlMcpStatusResponse, SDKControlMcpSetServersResponse, SDKControlMcpAuthenticateResponse, SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, BYOKModelValidationInput, BYOKProviderInfo, BYOKFieldInfo, BYOKModelTypeInfo, BYOKModelInfo, CustomModel, SDKControlListPluginsRequest, SDKControlListPluginsResponse, SDKControlStopTaskRequest, SDKControlBackgroundTasksRequest, SDKControlBackgroundTasksResponse, SDKKeepAliveMessage, StdoutMessage, ControlMcpServerConfig, } from './control.js';
|
|
27
|
+
export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, SDKControlInterruptRequest, SDKControlInterruptResponse, SDKControlPermissionRequest, SDKControlInitializeRequest, SDKControlSetPermissionModeRequest, SDKControlSetModelRequest, SDKControlGenerateSessionTitleRequest, SDKControlGenerateSessionTitleResponse, SideQuestionHistoryEntry, AskSideQuestionOptions, SideQuestionRefusalFallback, SideQuestionResult, SDKControlSideQuestionRequest, SDKControlSideQuestionResponse, SDKControlAddDirectoriesRequest, SDKControlAddDirectoriesResponse, SDKControlGetModelPolicyRequest, SDKControlGetModelPolicyResponse, SDKControlSetMaxThinkingTokensRequest, SDKControlMcpStatusRequest, SDKControlGetContextUsageRequest, SDKControlGetUsageInfoRequest, SDKControlGetUsageInfoResponse, SDKControlAccountInfoRequest, SDKHookCallbackRequest, SDKControlMcpMessageRequest, SDKControlRewindFilesRequest, SDKControlRewindRequest, SDKControlCancelAsyncMessageRequest, SDKControlSeedReadStateRequest, SDKControlMcpSetServersRequest, SDKControlReloadPluginsRequest, SDKControlMcpReconnectRequest, SDKControlMcpToggleRequest, SDKControlApplyFlagSettingsRequest, SDKControlGetSettingsRequest, SDKControlElicitationRequest, SDKControlEndSessionRequest, SDKControlChannelEnableRequest, SDKControlMcpInjectTokenRequest, SDKControlMcpAuthenticateRequest, SDKControlMcpOAuthCallbackUrlRequest, SDKControlMcpClearAuthRequest, SDKGoalStatus, SDKGoalSnapshot, SDKControlSetGoalRequest, SDKControlSetGoalResponse, SDKControlGetGoalRequest, SDKControlGetGoalResponse, SDKControlClearGoalRequest, SDKControlClearGoalResponse, SDKControlRequestInner, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlReloadPluginsResponse, SDKControlMcpStatusResponse, SDKControlMcpSetServersResponse, SDKControlMcpAuthenticateResponse, SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, BYOKModelValidationInput, BYOKProviderInfo, BYOKFieldInfo, BYOKModelTypeInfo, BYOKModelInfo, CustomModel, SDKControlListPluginsRequest, SDKControlListPluginsResponse, SDKControlStopTaskRequest, SDKControlBackgroundTasksRequest, SDKControlBackgroundTasksResponse, SDKControlMemoryShouldGenerateRequest, SDKControlFlushMemoryRequest, SDKControlRefreshMemoryRequest, SDKKeepAliveMessage, StdoutMessage, ControlMcpServerConfig, } from './control.js';
|
package/dist/protocol/index.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
var
|
|
1
|
+
var a="1.2.0";var r=["l1StaticCheck","l2LightweightScan","l3DeepScan"];function i(e){if(e===null||typeof e!="object"||Array.isArray(e))throw new TypeError("securityScan must be an object.");let t=new Set(r),s=Object.keys(e).filter(o=>!t.has(o));if(s.length>0)throw new TypeError(`securityScan contains unknown option${s.length===1?"":"s"}: ${s.join(", ")}.`);for(let o of r){let n=e[o];if(n!==void 0&&typeof n!="boolean")throw new TypeError(`securityScan.${o} must be a boolean.`)}return{l1StaticCheck:e.l1StaticCheck??!1,l2LightweightScan:e.l2LightweightScan??!1,l3DeepScan:e.l3DeepScan??!1}}function p(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function l(e={}){let t={...e.settings??{}},s=e.aiCodeTracking?.installGitCommitHook;if(s!==void 0){let o=t.aiCodeTracking;t.aiCodeTracking={...p(o)?o:{},installGitCommitHook:s}}return e.securityScan!==void 0&&(t.securityScan=i(e.securityScan)),t}function u(e={}){let t=l(e);return Object.keys(t).length===0?[]:["--settings",JSON.stringify(t)]}var S={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{S as QoderModelPurpose,a as WIRE_PROTOCOL_VERSION,l as buildQoderCliFlagSettings,u as buildQoderCliFlagSettingsArgs};
|
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
* Copyright 2026 Google LLC
|
|
4
4
|
* SPDX-License-Identifier: Apache-2.0
|
|
5
5
|
*/
|
|
6
|
+
import type { SecurityScanOptions } from '../types/options.js';
|
|
6
7
|
/**
|
|
7
8
|
* Startup-only AI code tracking options exposed by the Agent SDK.
|
|
8
9
|
*
|
|
@@ -21,6 +22,7 @@ export type AICodeTrackingLaunchOptions = {
|
|
|
21
22
|
};
|
|
22
23
|
export type QoderCliFlagSettings = Record<string, unknown> & {
|
|
23
24
|
aiCodeTracking?: Record<string, unknown> & AICodeTrackingLaunchOptions;
|
|
25
|
+
securityScan?: Required<SecurityScanOptions>;
|
|
24
26
|
};
|
|
25
27
|
export type QoderAgentLaunchOptions = {
|
|
26
28
|
/**
|
|
@@ -31,6 +33,8 @@ export type QoderAgentLaunchOptions = {
|
|
|
31
33
|
* SDK-facing convenience options for AI code statistics.
|
|
32
34
|
*/
|
|
33
35
|
aiCodeTracking?: AICodeTrackingLaunchOptions;
|
|
36
|
+
/** SDK-native code security capabilities. Omitted switches are disabled. */
|
|
37
|
+
securityScan?: SecurityScanOptions;
|
|
34
38
|
};
|
|
35
39
|
/**
|
|
36
40
|
* Merge SDK launch options into a single qodercli flag-settings object.
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
import type { NonNullableUsage } from './common.js';
|
|
2
|
+
/** Native delegates behavior to CLI defaults; custom applies partial SDK overrides. */
|
|
3
|
+
export type MemoryMode = 'native' | 'custom';
|
|
4
|
+
export type MemoryRootAccess = 'read' | 'read-write';
|
|
5
|
+
export type MemoryRoot = {
|
|
6
|
+
/** Stable caller-defined identifier used in prompts, initialization, and generation results. */
|
|
7
|
+
id: string;
|
|
8
|
+
/** Directory path on the machine running qodercli. */
|
|
9
|
+
path: string;
|
|
10
|
+
/** Root access granted to memory agents. Defaults to "read-write". */
|
|
11
|
+
access?: MemoryRootAccess;
|
|
12
|
+
/** Relative index path inside this root. Omit when every file, including MEMORY.md, is content. */
|
|
13
|
+
indexFile?: string;
|
|
14
|
+
};
|
|
15
|
+
export type MemoryGenerationGateInput = {
|
|
16
|
+
/** Current CLI session identifier. */
|
|
17
|
+
sessionId: string;
|
|
18
|
+
/** Current model request identifier, when available. */
|
|
19
|
+
requestId?: string;
|
|
20
|
+
/** Current logical turn request-set identifier, when available. */
|
|
21
|
+
requestSetId?: string;
|
|
22
|
+
/** One-based SDK memory TurnComplete sequence number. */
|
|
23
|
+
turnIndex: number;
|
|
24
|
+
/** Current CLI working directory. */
|
|
25
|
+
cwd: string;
|
|
26
|
+
/** User prompt for the completed turn. */
|
|
27
|
+
prompt: string;
|
|
28
|
+
/** Final assistant response for the completed turn. */
|
|
29
|
+
response: string;
|
|
30
|
+
};
|
|
31
|
+
export type MemoryGenerationGateResult = {
|
|
32
|
+
/** True starts generation; false emits a skipped result. */
|
|
33
|
+
run: boolean;
|
|
34
|
+
/** Optional product-readable decision reason. */
|
|
35
|
+
reason?: string;
|
|
36
|
+
};
|
|
37
|
+
export type SerializableMemoryGenerationOptions = {
|
|
38
|
+
/** Defaults to true. */
|
|
39
|
+
enabled?: boolean;
|
|
40
|
+
roots?: MemoryRoot[];
|
|
41
|
+
prompt?: string;
|
|
42
|
+
turnComplete?: {
|
|
43
|
+
/** Defaults to true when generation is enabled. */
|
|
44
|
+
enabled?: boolean;
|
|
45
|
+
/** SDK process callback identifier used by the CLI control protocol. */
|
|
46
|
+
shouldGenerateCallbackId?: string;
|
|
47
|
+
/** Callback timeout in milliseconds. */
|
|
48
|
+
timeoutMs?: number;
|
|
49
|
+
/** Error/timeout result mapping for the product gate. */
|
|
50
|
+
onGateError?: 'skip' | 'report_failed';
|
|
51
|
+
};
|
|
52
|
+
};
|
|
53
|
+
export type MemoryConsumptionFile = {
|
|
54
|
+
/** Stable caller-defined identifier used as the injected section name and in results. */
|
|
55
|
+
id: string;
|
|
56
|
+
/** File path on the machine running qodercli. */
|
|
57
|
+
path: string;
|
|
58
|
+
/** Defaults to false. A read failure aborts only when this is true and failureMode is "fail_query". */
|
|
59
|
+
required?: boolean;
|
|
60
|
+
};
|
|
61
|
+
export type SerializableMemoryConsumptionOptions = {
|
|
62
|
+
/** Defaults to true. */
|
|
63
|
+
enabled?: boolean;
|
|
64
|
+
files?: MemoryConsumptionFile[];
|
|
65
|
+
maxTokens?: number;
|
|
66
|
+
overflow?: 'truncate' | 'fail_query';
|
|
67
|
+
failureMode?: 'best_effort' | 'fail_query';
|
|
68
|
+
};
|
|
69
|
+
type SerializableMemoryConfigBase = {
|
|
70
|
+
/** Marks this memory configuration as originating from the Agent SDK. */
|
|
71
|
+
requester: 'sdk';
|
|
72
|
+
/** Query-level PROJECT-scope override. Omit to use the SDK native default (`true`). */
|
|
73
|
+
projectScope?: boolean;
|
|
74
|
+
/** Query-level USER-scope override. Omit to use the SDK native default (`true`). */
|
|
75
|
+
userScope?: boolean;
|
|
76
|
+
};
|
|
77
|
+
export type SerializableMemoryConfig = SerializableMemoryConfigBase & ({
|
|
78
|
+
mode: 'native';
|
|
79
|
+
generation?: never;
|
|
80
|
+
consumption?: never;
|
|
81
|
+
} | {
|
|
82
|
+
mode: 'custom';
|
|
83
|
+
generation?: SerializableMemoryGenerationOptions;
|
|
84
|
+
consumption?: SerializableMemoryConsumptionOptions;
|
|
85
|
+
});
|
|
86
|
+
export type EffectiveMemoryConfig = {
|
|
87
|
+
enabled: boolean;
|
|
88
|
+
requester: 'sdk';
|
|
89
|
+
mode?: MemoryMode;
|
|
90
|
+
generationEnabled: boolean;
|
|
91
|
+
turnCompleteEnabled: boolean;
|
|
92
|
+
consumptionEnabled: boolean;
|
|
93
|
+
roots: Array<{
|
|
94
|
+
id: string;
|
|
95
|
+
access: MemoryRootAccess;
|
|
96
|
+
}>;
|
|
97
|
+
};
|
|
98
|
+
export type MemoryGenerationFailedFile = {
|
|
99
|
+
rootId: string;
|
|
100
|
+
path: string;
|
|
101
|
+
error?: string;
|
|
102
|
+
};
|
|
103
|
+
export type MemoryGenerationResult = {
|
|
104
|
+
/** saved means every written file succeeded; partial means at least one file succeeded and one failed. */
|
|
105
|
+
status: 'saved' | 'partial' | 'no_change' | 'skipped' | 'failed';
|
|
106
|
+
attemptId: string;
|
|
107
|
+
/** Human-readable diagnostic detail. */
|
|
108
|
+
reason?: string;
|
|
109
|
+
origin: 'main_session' | 'turn_complete' | 'dream';
|
|
110
|
+
sourceRequestIds?: string[];
|
|
111
|
+
modelRequestIds?: string[];
|
|
112
|
+
writtenFiles: Array<{
|
|
113
|
+
rootId: string;
|
|
114
|
+
path: string;
|
|
115
|
+
}>;
|
|
116
|
+
/** Files that were not written successfully after the attempt completed. */
|
|
117
|
+
failedFiles: MemoryGenerationFailedFile[];
|
|
118
|
+
/** True when a native or explicitly declared custom index file changed. */
|
|
119
|
+
indexUpdated?: boolean;
|
|
120
|
+
/** True when at least one non-index memory content file changed. */
|
|
121
|
+
contentUpdated?: boolean;
|
|
122
|
+
durationMs: number;
|
|
123
|
+
usage?: NonNullableUsage;
|
|
124
|
+
/** Missing server-side credits remain undefined; callers must not infer them. */
|
|
125
|
+
credits?: number;
|
|
126
|
+
};
|
|
127
|
+
export type MemoryConsumptionResult = {
|
|
128
|
+
status: 'success' | 'partial' | 'failed';
|
|
129
|
+
files: Array<{
|
|
130
|
+
id: string;
|
|
131
|
+
path: string;
|
|
132
|
+
status: 'loaded' | 'missing' | 'failed' | 'truncated';
|
|
133
|
+
/** Human-readable diagnostic detail. */
|
|
134
|
+
error?: string;
|
|
135
|
+
}>;
|
|
136
|
+
};
|
|
137
|
+
export {};
|
|
@@ -13,6 +13,8 @@
|
|
|
13
13
|
*/
|
|
14
14
|
import type { BetaMessage, BetaRawMessageStreamEvent, MessageParam, UUID, SDKAssistantMessageError, FastModeState, ApiKeySource, ModelUsage, NonNullableUsage, PluginInfo, SDKStatus } from './common.js';
|
|
15
15
|
import type { PermissionMode } from './permissions.js';
|
|
16
|
+
import type { MemoryConsumptionResult, MemoryGenerationResult } from './memory.js';
|
|
17
|
+
import type { SDKGoalSnapshot } from './control.js';
|
|
16
18
|
export type SDKAssistantMessage = {
|
|
17
19
|
type: 'assistant';
|
|
18
20
|
message: BetaMessage;
|
|
@@ -49,6 +51,7 @@ export type SDKUserMessage = {
|
|
|
49
51
|
type: 'user';
|
|
50
52
|
message: MessageParam;
|
|
51
53
|
parent_tool_use_id: string | null;
|
|
54
|
+
custom_context?: Record<string, string>;
|
|
52
55
|
file_attachments?: SDKFileAttachment[];
|
|
53
56
|
isSynthetic?: boolean;
|
|
54
57
|
tool_use_result?: unknown;
|
|
@@ -218,6 +221,36 @@ export type SDKAPIRetryMessage = {
|
|
|
218
221
|
uuid: UUID;
|
|
219
222
|
session_id: string;
|
|
220
223
|
};
|
|
224
|
+
/** Model capacity queue progress emitted while qodercli waits and retries. */
|
|
225
|
+
export type SDKModelQueueStatusMessage = {
|
|
226
|
+
type: 'system';
|
|
227
|
+
subtype: 'model_queue_status';
|
|
228
|
+
status: 'queued' | 'ready';
|
|
229
|
+
request_id: string;
|
|
230
|
+
request_set_id: string;
|
|
231
|
+
model_key: string;
|
|
232
|
+
queue_type?: string;
|
|
233
|
+
queue_count?: number;
|
|
234
|
+
wait_time_ms?: number;
|
|
235
|
+
queue_wait_elapsed_ms?: number;
|
|
236
|
+
queue_max_wait_ms?: number;
|
|
237
|
+
service_available?: boolean;
|
|
238
|
+
uuid: UUID;
|
|
239
|
+
session_id: string;
|
|
240
|
+
};
|
|
241
|
+
/** Progress emitted for an SDK-initiated side question. */
|
|
242
|
+
export type SDKControlRequestProgressMessage = {
|
|
243
|
+
type: 'system';
|
|
244
|
+
subtype: 'control_request_progress';
|
|
245
|
+
request_id: string;
|
|
246
|
+
status: 'started' | 'api_retry';
|
|
247
|
+
attempt?: number;
|
|
248
|
+
max_retries?: number;
|
|
249
|
+
retry_delay_ms?: number;
|
|
250
|
+
error_status?: number | null;
|
|
251
|
+
uuid: UUID;
|
|
252
|
+
session_id: string;
|
|
253
|
+
};
|
|
221
254
|
export type SDKHookStartedMessage = {
|
|
222
255
|
type: 'system';
|
|
223
256
|
subtype: 'hook_started';
|
|
@@ -332,6 +365,28 @@ export type SDKBackgroundTasksChangedMessage = {
|
|
|
332
365
|
uuid: UUID;
|
|
333
366
|
session_id: string;
|
|
334
367
|
};
|
|
368
|
+
/**
|
|
369
|
+
* Goal state changed (created / redirected / transitioned / budget update).
|
|
370
|
+
* Requires the CLI `goal_v1` capability.
|
|
371
|
+
*/
|
|
372
|
+
export type SDKGoalUpdatedMessage = {
|
|
373
|
+
type: 'system';
|
|
374
|
+
subtype: 'goal_updated';
|
|
375
|
+
goal: SDKGoalSnapshot;
|
|
376
|
+
/** Why the goal changed, e.g. 'safety-limit' or 'blocked'. */
|
|
377
|
+
reason?: string;
|
|
378
|
+
uuid: UUID;
|
|
379
|
+
session_id: string;
|
|
380
|
+
};
|
|
381
|
+
/** Goal was cleared. Requires the CLI `goal_v1` capability. */
|
|
382
|
+
export type SDKGoalClearedMessage = {
|
|
383
|
+
type: 'system';
|
|
384
|
+
subtype: 'goal_cleared';
|
|
385
|
+
goal_id: string;
|
|
386
|
+
reason?: string;
|
|
387
|
+
uuid: UUID;
|
|
388
|
+
session_id: string;
|
|
389
|
+
};
|
|
335
390
|
export type SDKSessionStateChangedMessage = {
|
|
336
391
|
type: 'system';
|
|
337
392
|
subtype: 'session_state_changed';
|
|
@@ -389,6 +444,20 @@ export type SDKCloudAgentEventMessage = {
|
|
|
389
444
|
uuid: UUID;
|
|
390
445
|
session_id: string;
|
|
391
446
|
};
|
|
447
|
+
export type SDKMemoryGenerationMessage = {
|
|
448
|
+
type: 'system';
|
|
449
|
+
subtype: 'memory_generation';
|
|
450
|
+
result: MemoryGenerationResult;
|
|
451
|
+
uuid: UUID;
|
|
452
|
+
session_id: string;
|
|
453
|
+
};
|
|
454
|
+
export type SDKMemoryConsumptionMessage = {
|
|
455
|
+
type: 'system';
|
|
456
|
+
subtype: 'memory_consumption';
|
|
457
|
+
result: MemoryConsumptionResult;
|
|
458
|
+
uuid: UUID;
|
|
459
|
+
session_id: string;
|
|
460
|
+
};
|
|
392
461
|
export type SDKPermissionDenial = {
|
|
393
462
|
tool_name: string;
|
|
394
463
|
tool_use_id: string;
|
|
@@ -410,4 +479,4 @@ export type SDKPermissionDeniedMessage = {
|
|
|
410
479
|
decision_reason_type?: SDKPermissionDeniedReasonType;
|
|
411
480
|
decision_reason?: string;
|
|
412
481
|
};
|
|
413
|
-
export type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPermissionDeniedMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKTaskUpdatedMessage | SDKBackgroundTasksChangedMessage | SDKSessionStateChangedMessage | SDKSessionTitleChangedMessage | SDKFilesPersistedEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage | SDKCloudAgentEventMessage;
|
|
482
|
+
export type SDKMessage = SDKAssistantMessage | SDKUserMessage | SDKUserMessageReplay | SDKResultMessage | SDKSystemMessage | SDKPermissionDeniedMessage | SDKPartialAssistantMessage | SDKCompactBoundaryMessage | SDKStatusMessage | SDKAPIRetryMessage | SDKModelQueueStatusMessage | SDKControlRequestProgressMessage | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKTaskNotificationMessage | SDKTaskStartedMessage | SDKTaskProgressMessage | SDKTaskUpdatedMessage | SDKBackgroundTasksChangedMessage | SDKSessionStateChangedMessage | SDKGoalUpdatedMessage | SDKGoalClearedMessage | SDKSessionTitleChangedMessage | SDKFilesPersistedEvent | SDKElicitationCompleteMessage | SDKPromptSuggestionMessage | SDKCloudAgentEventMessage | SDKMemoryGenerationMessage | SDKMemoryConsumptionMessage;
|
|
@@ -26,7 +26,7 @@ import type { Transport } from '../core/transport.js';
|
|
|
26
26
|
import type { SDKMessage, SDKUserMessage } from '../types/messages.js';
|
|
27
27
|
import type { InternalQuery, OnElicitation } from '../types/options.js';
|
|
28
28
|
import type { FetchJobToken, FetchServiceAccountToken } from '../types/auth.js';
|
|
29
|
-
import type { SDKControlInterruptResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGenerateSessionTitleResponse, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse } from '../types/control.js';
|
|
29
|
+
import type { SDKGoalSnapshot, SDKGoalStatus, SDKControlInterruptResponse, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlGenerateSessionTitleResponse, AskSideQuestionOptions, SideQuestionResult, SDKControlAddDirectoriesResponse, SDKControlReloadPluginsResponse } from '../types/control.js';
|
|
30
30
|
import type { PermissionMode, CanUseTool } from '../types/permissions.js';
|
|
31
31
|
import type { HookCallbackMatcher } from '../types/hooks.js';
|
|
32
32
|
import type { HookEvent as InternalHookEvent } from '../protocol/index.js';
|
|
@@ -40,6 +40,7 @@ import type { SessionStore, SessionStoreFlush } from '../session/session-store.j
|
|
|
40
40
|
import type { PluginDetails } from '../types/plugins.js';
|
|
41
41
|
import type { ModelInfo, SlashCommand, AccountInfo, UsageInfo } from '../types/common.js';
|
|
42
42
|
import type { ModelPolicyProvider } from '../types/model-policy-provider.js';
|
|
43
|
+
import type { MemoryRuntimeCallbacks, SerializableMemoryConfig } from '../types/memory.js';
|
|
43
44
|
import type { BYOKModelValidationInput, BYOKProviderInfo } from '../types/byok.js';
|
|
44
45
|
/** Init config passed to the initialize control request. */
|
|
45
46
|
type InitConfig = {
|
|
@@ -50,10 +51,15 @@ type InitConfig = {
|
|
|
50
51
|
skills?: string[];
|
|
51
52
|
promptSuggestions?: boolean;
|
|
52
53
|
enableFileCheckpointing?: boolean;
|
|
54
|
+
memory?: SerializableMemoryConfig;
|
|
55
|
+
customContext?: Record<string, string>;
|
|
53
56
|
};
|
|
54
57
|
export declare class QueryRunner implements InternalQuery {
|
|
58
|
+
private static readonly CUSTOM_CONTEXT_CAPABILITY;
|
|
55
59
|
private static readonly INITIALIZE_TIMEOUT_MS;
|
|
56
60
|
private static readonly BACKGROUND_TASKS_CAPABILITY;
|
|
61
|
+
private static readonly SIDE_QUESTION_CAPABILITY;
|
|
62
|
+
private static readonly GOAL_CAPABILITY;
|
|
57
63
|
private readonly transport;
|
|
58
64
|
private readonly inputStream;
|
|
59
65
|
private readonly pendingRequests;
|
|
@@ -78,6 +84,7 @@ export declare class QueryRunner implements InternalQuery {
|
|
|
78
84
|
private readonly resolveModel?;
|
|
79
85
|
private readonly resolveModelTimeoutMs;
|
|
80
86
|
private readonly transcriptMirrorBatcher?;
|
|
87
|
+
private readonly memoryCallbacks?;
|
|
81
88
|
private initResponse?;
|
|
82
89
|
private initializationPromise?;
|
|
83
90
|
private resultMessage?;
|
|
@@ -86,9 +93,13 @@ export declare class QueryRunner implements InternalQuery {
|
|
|
86
93
|
private authExpiredFired;
|
|
87
94
|
private protocolHandshakeValidated;
|
|
88
95
|
private cliCapabilities?;
|
|
96
|
+
private customContextCapabilityWarningEmitted;
|
|
89
97
|
private firstResultReceived;
|
|
90
98
|
private firstResultReceivedResolve?;
|
|
91
|
-
|
|
99
|
+
private memoryFlushPromise?;
|
|
100
|
+
private memoryEndInputPromise?;
|
|
101
|
+
private closePromise?;
|
|
102
|
+
constructor(transport: Transport, isSingleTurn: boolean, canUseTool?: CanUseTool, hooks?: Partial<Record<InternalHookEvent, HookCallbackMatcher[]>>, abortController?: AbortController, sdkMcpServers?: Map<string, McpServer>, initConfig?: InitConfig, onElicitation?: OnElicitation, diagnostics?: DiagnosticsSink, onAuthExpired?: () => void, controlRequestTimeoutMs?: number, sdkMcpTransports?: Map<string, SdkMcpTransport>, pendingMcpResponses?: Map<string, PendingMcpResponse>, fetchJobToken?: FetchJobToken, resolveModel?: ModelPolicyProvider, resolveModelTimeoutMs?: number, sessionStore?: SessionStore, sessionStoreFlush?: SessionStoreFlush, sdkMcpToolOverrides?: Record<string, Record<string, McpToolRuntimeOverride>>, fetchServiceAccountToken?: FetchServiceAccountToken, memoryCallbacks?: MemoryRuntimeCallbacks);
|
|
92
103
|
private getRecord;
|
|
93
104
|
private normalizeLogPreview;
|
|
94
105
|
private extractMessagePreview;
|
|
@@ -111,6 +122,9 @@ export declare class QueryRunner implements InternalQuery {
|
|
|
111
122
|
*/
|
|
112
123
|
private readMessages;
|
|
113
124
|
private notifyAuthExpiredIfNeeded;
|
|
125
|
+
private dispatchMemoryCallbacks;
|
|
126
|
+
private flushMemoryBeforeEndInput;
|
|
127
|
+
private performFlushMemoryBeforeEndInput;
|
|
114
128
|
/**
|
|
115
129
|
* Send a control request to the CLI and wait for the response.
|
|
116
130
|
*
|
|
@@ -208,6 +222,23 @@ export declare class QueryRunner implements InternalQuery {
|
|
|
208
222
|
stopTask(taskId: string): Promise<void>;
|
|
209
223
|
/** Move one or all eligible foreground tasks into the background. */
|
|
210
224
|
backgroundTasks(toolUseId?: string): Promise<boolean>;
|
|
225
|
+
/**
|
|
226
|
+
* Create, redirect, transition, or re-budget the session goal.
|
|
227
|
+
*
|
|
228
|
+
* Omitted fields are left unchanged; `creditsBudget: null` explicitly
|
|
229
|
+
* clears the credits budget. Setting `status: 'active'` while the session
|
|
230
|
+
* is idle starts the goal loop. Returns the goal snapshot after the change
|
|
231
|
+
* (null only if no goal exists afterwards).
|
|
232
|
+
*/
|
|
233
|
+
setGoal(params: {
|
|
234
|
+
objective?: string;
|
|
235
|
+
status?: SDKGoalStatus;
|
|
236
|
+
creditsBudget?: number | null;
|
|
237
|
+
}): Promise<SDKGoalSnapshot | null>;
|
|
238
|
+
/** Read the current goal, or null when the session has none. */
|
|
239
|
+
getGoal(): Promise<SDKGoalSnapshot | null>;
|
|
240
|
+
/** Clear the session goal. Returns whether a goal was actually cleared. */
|
|
241
|
+
clearGoal(): Promise<boolean>;
|
|
211
242
|
private requireCliCapability;
|
|
212
243
|
/**
|
|
213
244
|
* Set the permission mode.
|
|
@@ -225,6 +256,7 @@ export declare class QueryRunner implements InternalQuery {
|
|
|
225
256
|
generateSessionTitle(description: string, options?: {
|
|
226
257
|
persist?: boolean;
|
|
227
258
|
}): Promise<SDKControlGenerateSessionTitleResponse['title']>;
|
|
259
|
+
askSideQuestion(question: string, options?: AskSideQuestionOptions): Promise<SideQuestionResult | null>;
|
|
228
260
|
/**
|
|
229
261
|
* Add directories to the running session workspace.
|
|
230
262
|
*/
|
|
@@ -306,6 +338,10 @@ export declare class QueryRunner implements InternalQuery {
|
|
|
306
338
|
* Seed read state for a file.
|
|
307
339
|
*/
|
|
308
340
|
seedReadState(path: string, mtime: number): Promise<void>;
|
|
341
|
+
flushMemory(): Promise<void>;
|
|
342
|
+
private performMemoryFlush;
|
|
343
|
+
refreshMemory(): Promise<void>;
|
|
344
|
+
private requireSdkMemoryEnabled;
|
|
309
345
|
/**
|
|
310
346
|
* Reconnect an MCP server.
|
|
311
347
|
*/
|
|
@@ -366,6 +402,7 @@ export declare class QueryRunner implements InternalQuery {
|
|
|
366
402
|
* consumer queue that no more messages will arrive.
|
|
367
403
|
*/
|
|
368
404
|
close(): Promise<void>;
|
|
405
|
+
private performClose;
|
|
369
406
|
/**
|
|
370
407
|
* Async dispose support.
|
|
371
408
|
*
|
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 1,
|
|
3
3
|
"brand": "global",
|
|
4
|
-
"sdkVersion": "1.0.
|
|
5
|
-
"qoderCliVersion": "1.1.
|
|
4
|
+
"sdkVersion": "1.0.25",
|
|
5
|
+
"qoderCliVersion": "1.1.26",
|
|
6
6
|
"defaultTransport": "worker",
|
|
7
7
|
"workerRuntime": {
|
|
8
8
|
"packaged": false,
|
|
9
9
|
"delivery": "install",
|
|
10
10
|
"source": "qodercli-worker-runtime",
|
|
11
|
-
"urlTemplate": "https://download.qoder.com/qodercli/releases/1.1.
|
|
11
|
+
"urlTemplate": "https://download.qoder.com/qodercli/releases/1.1.26/qodercli-worker-runtime-{target}.tgz",
|
|
12
12
|
"artifactNameTemplate": "qodercli-worker-runtime-{target}.tgz",
|
|
13
|
-
"sdkVersion": "1.0.
|
|
14
|
-
"qoderCliVersion": "1.1.
|
|
13
|
+
"sdkVersion": "1.0.25",
|
|
14
|
+
"qoderCliVersion": "1.1.26"
|
|
15
15
|
}
|
|
16
16
|
}
|
package/dist/types/control.d.ts
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
* shim so existing SDK consumer imports keep working.
|
|
6
6
|
*/
|
|
7
7
|
export type { QoderModelPurpose } from '../protocol/index.js';
|
|
8
|
-
export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, SDKControlInterruptRequest, SDKControlInterruptResponse, SDKControlPermissionRequest, SDKControlInitializeRequest, SDKControlSetPermissionModeRequest, SDKControlSetModelRequest, SDKControlGenerateSessionTitleRequest, SDKControlGenerateSessionTitleResponse, SDKControlAddDirectoriesRequest, SDKControlAddDirectoriesResponse, SDKControlGetModelPolicyRequest, SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, SDKControlSetMaxThinkingTokensRequest, SDKControlMcpStatusRequest, SDKControlGetContextUsageRequest, SDKControlGetUsageInfoRequest, SDKControlGetUsageInfoResponse, SDKControlAccountInfoRequest, SDKHookCallbackRequest, SDKControlMcpMessageRequest, SDKControlRewindFilesRequest, SDKControlRewindRequest, SDKControlCancelAsyncMessageRequest, SDKControlSeedReadStateRequest, SDKControlMcpSetServersRequest, SDKControlReloadPluginsRequest, SDKControlMcpReconnectRequest, SDKControlMcpToggleRequest, SDKControlApplyFlagSettingsRequest, SDKControlGetSettingsRequest, SDKControlElicitationRequest, SDKControlEndSessionRequest, SDKControlChannelEnableRequest, SDKControlMcpInjectTokenRequest, SDKControlMcpAuthenticateRequest, SDKControlMcpOAuthCallbackUrlRequest, SDKControlMcpClearAuthRequest, SDKControlRequestInner, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlReloadPluginsResponse, SDKControlListPluginsRequest, SDKControlListPluginsResponse, SDKControlStopTaskRequest, SDKControlBackgroundTasksRequest, SDKControlBackgroundTasksResponse, SDKControlMcpStatusResponse, SDKControlMcpSetServersResponse, SDKKeepAliveMessage, StdoutMessage, ControlMcpServerConfig, BYOKModelValidationInput, } from '../protocol/index.js';
|
|
8
|
+
export type { SDKControlRequest, SDKControlResponse, SDKControlCancelRequest, SDKControlInterruptRequest, SDKControlInterruptResponse, SDKControlPermissionRequest, SDKControlInitializeRequest, SDKControlSetPermissionModeRequest, SDKControlSetModelRequest, SDKControlSetGoalRequest, SDKControlSetGoalResponse, SDKControlGetGoalRequest, SDKControlGetGoalResponse, SDKControlClearGoalRequest, SDKControlClearGoalResponse, SDKGoalSnapshot, SDKGoalStatus, SDKControlGenerateSessionTitleRequest, SDKControlGenerateSessionTitleResponse, SideQuestionHistoryEntry, AskSideQuestionOptions, SideQuestionRefusalFallback, SideQuestionResult, SDKControlSideQuestionRequest, SDKControlSideQuestionResponse, SDKControlAddDirectoriesRequest, SDKControlAddDirectoriesResponse, SDKControlGetModelPolicyRequest, SDKControlGetByokConfigRequest, SDKControlGetByokConfigResponse, SDKControlValidateByokModelRequest, SDKControlValidateByokModelResponse, SDKControlSetMaxThinkingTokensRequest, SDKControlMcpStatusRequest, SDKControlGetContextUsageRequest, SDKControlGetUsageInfoRequest, SDKControlGetUsageInfoResponse, SDKControlAccountInfoRequest, SDKHookCallbackRequest, SDKControlMcpMessageRequest, SDKControlRewindFilesRequest, SDKControlRewindRequest, SDKControlCancelAsyncMessageRequest, SDKControlSeedReadStateRequest, SDKControlMcpSetServersRequest, SDKControlReloadPluginsRequest, SDKControlMcpReconnectRequest, SDKControlMcpToggleRequest, SDKControlApplyFlagSettingsRequest, SDKControlGetSettingsRequest, SDKControlElicitationRequest, SDKControlEndSessionRequest, SDKControlChannelEnableRequest, SDKControlMcpInjectTokenRequest, SDKControlMcpAuthenticateRequest, SDKControlMcpOAuthCallbackUrlRequest, SDKControlMcpClearAuthRequest, SDKControlRequestInner, SDKControlInitializeResponse, SDKControlGetContextUsageResponse, SDKControlReloadPluginsResponse, SDKControlListPluginsRequest, SDKControlListPluginsResponse, SDKControlStopTaskRequest, SDKControlBackgroundTasksRequest, SDKControlBackgroundTasksResponse, SDKControlMemoryShouldGenerateRequest, SDKControlFlushMemoryRequest, SDKControlRefreshMemoryRequest, SDKControlMcpStatusResponse, SDKControlMcpSetServersResponse, SDKKeepAliveMessage, StdoutMessage, ControlMcpServerConfig, BYOKModelValidationInput, } from '../protocol/index.js';
|
|
9
9
|
/** Wire format for fetch_job_token inbound control request from CLI. */
|
|
10
10
|
export type FetchJobTokenWireRequest = {
|
|
11
11
|
subtype: 'fetch_job_token';
|
package/dist/types/index.d.ts
CHANGED
|
@@ -4,12 +4,13 @@
|
|
|
4
4
|
*/
|
|
5
5
|
export * from './common.js';
|
|
6
6
|
export * from './messages.js';
|
|
7
|
+
export * from './memory.js';
|
|
7
8
|
export type { DefaultRuntimeTransport } from '../core/default-runtime.js';
|
|
8
9
|
export type { QueryTransportCreateOptions, QueryTransportProviderOption, } from '../core/query-transport.js';
|
|
9
10
|
export type { ProcessTransportOptions } from '../core/process-transport.js';
|
|
10
11
|
export type { WorkerRuntimeTransportOptions, WorkerTransportOptions, } from '../core/worker-transport.js';
|
|
11
12
|
export type { QueryTransportProvider, Transport, } from '../core/transport.js';
|
|
12
|
-
export type { ElicitationRequest, ElicitationResult, OnElicitation, PromptRequestOption, PromptRequest, PromptResponse, Options, QueryTransportOptions, SpawnOptions, SpawnedProcess, Query, } from './options.js';
|
|
13
|
+
export type { ElicitationRequest, ElicitationResult, OnElicitation, PromptRequestOption, PromptRequest, PromptResponse, SecurityScanOptions, Options, QueryTransportOptions, SpawnOptions, SpawnedProcess, Query, } from './options.js';
|
|
13
14
|
export * from './permissions.js';
|
|
14
15
|
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 './hooks.js';
|
|
15
16
|
export * from './mcp.js';
|