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

package/README.md

@@ -6,6 +6,8 @@ The SDK starts `qodercli` for you, streams agent messages back to Node.js, and
 lets your application configure tools, permissions, working directories, MCP
 servers, hooks, and interactive sessions.
 
+For compression billing messages, see [压缩费用消息接口](doc/compact-usage.md).
+
 ## Installation
 
 ```bash
@@ -56,6 +58,22 @@ the CLI process, such as `pathToQoderCLIExecutable`, `executable`,
 shared daemon instead. Because the daemon is shared, every query in one process
 must pass compatible daemon-level options.
 
+`options.extraHeaders` accepts a `Record<string, string>` for the first Qoder
+main-model request of the first queryable input and its network retries. Later
+tool continuations, subagents, and queries do not inherit these headers. Existing
+built-in headers take precedence. Use a paired CLI build with `extra_headers`
+support. For example, after the host obtains the user's paid-usage confirmation:
+
+```ts
+query({
+  prompt,
+  options: {
+    ...options,
+    extraHeaders: { "Cosy-Paid-Confirmed": "true" },
+  },
+});
+```
+
 If your environment blocks install scripts or network downloads, skip postinstall
 runtime downloads:
 
@@ -189,6 +207,11 @@ for await (const message of q) {
 }
 ```
 
+## Business Attribution
+
+For Qoder integrations, set product on the daemon and type on each query.
+See the [short integration guide](doc/business-context.md).
+
 ## Code Security
 
 Built-in code security is disabled by default in SDK sessions. Enable only the

package/dist/core/process-transport.d.ts

@@ -18,6 +18,9 @@ type ToolsOption = string[] | {
     preset: 'qodercli';
 };
 export interface ProcessTransportOptions {
+    business?: {
+        type: string;
+    };
     /** Path to the Qoder CLI executable (binary or script) */
     pathToQoderCLIExecutable?: string;
     /** Override executable name (node, bun, deno) for script entry points */

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

@@ -18,6 +18,9 @@ type ToolsOption = string[] | {
     preset: 'qodercli';
 };
 export interface RuntimeLaunchOptions {
+    business?: {
+        type: string;
+    };
     cwd?: string;
     env?: Record<string, string | undefined>;
     proxy?: string;

package/dist/daemon/daemon-connection.d.ts

@@ -17,12 +17,6 @@ export declare const SESSION_STORE_FORK_BARRIER_CAPABILITY = "session_store_fork
  */
 export declare const DAEMON_HEARTBEAT_TIMEOUT_MS = 120000;
 export declare const DAEMON_KEEP_ALIVE_CAPABILITY = "daemon_keep_alive_v1";
-/**
- * daemon 会话 close 改成「关信道即回包、后台排干 teardown」的能力位（CLI 仓镜像）。
- * 会话 initialize 回包声明它时，QueryRunner.close 不再隐式等 memory / evolution
- * flush；旧 CLI 不声明则保持原有等待语义（版本错配保护）。
- */
-export declare const DAEMON_ASYNC_SESSION_TEARDOWN_CAPABILITY = "daemon_async_session_teardown_v1";
 export interface DaemonConnectionOptions {
     input: Writable;
     output: Readable;
@@ -52,6 +46,9 @@ export interface DaemonConnectionOptions {
     heartbeatTimeoutMs?: number;
 }
 export interface DaemonInitializeOptions {
+    business?: {
+        product: string;
+    };
     /** Advertised in addition to the capability this SDK cannot work without. */
     capabilities?: readonly string[];
     timeoutMs?: number;

package/dist/daemon/daemon-session-transport.d.ts

@@ -4,6 +4,9 @@ import type { DaemonWireSessionMessage } from './protocol.js';
 import type { DaemonConnection, DaemonSessionIdClaim } from './daemon-connection.js';
 import type { DiagnosticsSink } from '../core/sdk-diagnostics.js';
 export type DaemonSessionTransportOptions = {
+    business?: {
+        type: string;
+    };
     workerArgs: string[];
     cwd?: string;
     configDir?: string;

package/dist/daemon/global-daemon.d.ts

@@ -3,6 +3,10 @@ import type { QueryTransportProvider } from '../core/transport.js';
 import type { DaemonQueryTransportOptions } from '../core/query-transport.js';
 import { type Daemon } from './start-daemon.js';
 export interface InitDaemonOptions {
+    /** daemon 全局产品身份；初始化后不能由 Query 覆盖。 */
+    business?: {
+        product: string;
+    };
     auth: InternalAuthOptions;
     pathToQoderCLIExecutable?: string;
     /** 语义同 `StartDaemonOptions.executable`。 */

package/dist/daemon/protocol.d.ts

@@ -106,6 +106,9 @@ export type DaemonWireSessionMessage = JsonObject & {
 };
 export type DaemonProtocolFrame = DaemonControlRequestFrame | DaemonControlResponseFrame | DaemonSessionUpdatedStatusEventFrame | KeepAliveFrame | DaemonProtocolErrorFrame | DaemonWireSessionMessage;
 export type InitializeDaemonParams = {
+    business?: {
+        product: string;
+    };
     daemon_protocol_version: typeof DAEMON_PROTOCOL_VERSION;
     sdk_version: string;
     capabilities: string[];
@@ -136,6 +139,9 @@ export type InitializeDaemonResult = {
     capabilities: string[];
 };
 export type OpenSessionParams = {
+    business?: {
+        type: string;
+    };
     worker_args: string[];
     cwd?: string;
     config_dir?: string;

package/dist/daemon/start-daemon.d.ts

@@ -16,6 +16,10 @@ export interface DaemonSessionInfo {
     updatedAt: string;
 }
 export interface StartDaemonOptions {
+    /** daemon 全局产品身份；不同产品使用不同 daemon。 */
+    business?: {
+        product: string;
+    };
     /**
      * Credentials for the daemon's own account plane and its in-process Sessions.
      *

package/dist/index.d.ts

@@ -96,7 +96,7 @@ export type { AccessTokenInput, AuthOptions, FetchServiceAccountToken, ServiceAc
  */
 export type { FetchJobToken, JobTokenAuthOptions, JobTokenRequest, JobTokenResult, } from './types/auth.js';
 export type { Base64ImageSource, UrlImageSource, URLImageSource, ImageSource, ImageContentBlock, ImageBlockParam, ContentBlock, MessageParam, 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, SDKToolNonExecutionKind, SDKToolResultMeta, SDKMessageOrigin, SDKSelectedSkill, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKCommandsChangedMessage, SDKUserMessage, SDKUserMessageReplay, SDKResultMessage, SDKResultSuccess, SDKResultError, SDKSystemMessage, SDKSystemInitMessage, SDKSystemMessageSubtype, SDKSystemMessageBySubtype, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, SDKToolProgressMessage, SDKHookDiagnosticsMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKPermissionDeniedMessage, SDKMirrorErrorMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKPlanModeChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKSkillEvolutionMessage, SDKAgentsMdSizeWarningMessage, SDKPermissionDenial, } from './types/messages.js';
+export type { SDKMessage, SDKAssistantMessage, SDKHostToolUseMessage, SDKHostToolResultMessage, SDKCodeModeHostResult, SDKToolNonExecutionKind, SDKToolResultMeta, SDKMessageOrigin, SDKSelectedSkill, SDKArtifactInfo, SDKArtifactUpdateMessage, SDKAvailableModelsUpdateMessage, SDKCommandsChangedMessage, SDKUserMessage, SDKUserMessageReplay, SDKResultMessage, SDKResultSuccess, SDKResultError, SDKSystemMessage, SDKSystemInitMessage, SDKSystemMessageSubtype, SDKSystemMessageBySubtype, SDKPartialAssistantMessage, SDKCompactBoundaryMessage, SDKStatusMessage, SDKAPIRetryMessage, SDKModelQueueStatusMessage, SDKControlRequestProgressMessage, SDKCommandLifecycleMessage, SDKToolProgressMessage, SDKHookDiagnosticsMessage, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKPermissionDeniedMessage, SDKMirrorErrorMessage, SDKTaskNotificationMessage, SDKTaskStartedMessage, SDKTaskProgressMessage, SDKTaskUpdatedMessage, SDKBackgroundTasksChangedMessage, SDKSessionStateChangedMessage, SDKPlanModeChangedMessage, SDKSessionTitleChangedMessage, SDKFilesPersistedEvent, SDKElicitationCompleteMessage, SDKPromptSuggestionMessage, SDKCloudAgentEventMessage, SDKMemoryGenerationMessage, SDKMemoryConsumptionMessage, SDKSkillEvolutionMessage, SDKAgentsMdSizeWarningMessage, SDKPermissionDenial, } from './types/messages.js';
 export type { DefaultRuntimeTransport, } from './core/default-runtime.js';
 export type { ProcessTransportOptions } from './core/process-transport.js';
 export type { WorkerRuntimeTransportOptions, WorkerTransportOptions, } from './core/worker-transport.js';