@botiverse/kimi-code-sdk 0.18.0 → 0.19.2-botiverse.0

package/NOTICE.md

@@ -1,5 +1,5 @@
 # NOTICE
 
 @botiverse/kimi-code-sdk is a repackage of the built **@moonshot-ai/kimi-code-sdk** node-sdk
-from [MoonshotAI/kimi-code](https://github.com/MoonshotAI/kimi-code) at `@moonshot-ai/kimi-code@0.18.0`, distributed under upstream's MIT License (see LICENSE). Sibling packages are bundled into `dist`.
+from [MoonshotAI/kimi-code](https://github.com/MoonshotAI/kimi-code) at `@moonshot-ai/kimi-code@0.19.2`, distributed under upstream's MIT License (see LICENSE). Sibling packages are bundled into `dist`.
 Mirror + provenance: https://github.com/botiverse/kimi-code-sdk

package/README.md

@@ -1,6 +1,6 @@
 # @botiverse/kimi-code-sdk
 
-Built repackage of `@moonshot-ai/kimi-code-sdk` (kimi-code @moonshot-ai/kimi-code@0.18.0) for Slock/Botiverse.
+Built repackage of `@moonshot-ai/kimi-code-sdk` (kimi-code @moonshot-ai/kimi-code@0.19.2) for Slock/Botiverse.
 Read-only mirror + release notes: https://github.com/botiverse/kimi-code-sdk
 
 > Not affiliated with Moonshot AI. MIT (see LICENSE).

package/dist/index.d.mts

@@ -61,6 +61,35 @@ declare interface ActivateSkillRpcInput extends SessionIdRpcInput {
     readonly args?: string | undefined;
 }
 
+export declare interface AddAdditionalDirInput {
+    readonly id: string;
+    readonly path: string;
+    readonly persist: boolean;
+}
+
+export declare interface AddAdditionalDirOptions {
+    readonly persist: boolean;
+}
+
+declare interface AddAdditionalDirPayload {
+    readonly path: string;
+    readonly persist: boolean;
+}
+
+export declare interface AddAdditionalDirResult {
+    readonly additionalDirs: readonly string[];
+    readonly projectRoot: string;
+    readonly configPath: string;
+    readonly persisted: boolean;
+}
+
+declare interface AddAdditionalDirResult_2 {
+    readonly additionalDirs: readonly string[];
+    readonly projectRoot: string;
+    readonly configPath: string;
+    readonly persisted: boolean;
+}
+
 declare class Agent {
     readonly type: AgentType;
     private _kaos;
@@ -97,8 +126,11 @@ declare class Agent {
     readonly cron: CronManager | null;
     readonly goal: GoalMode;
     readonly replayBuilder: ReplayBuilder;
+    private additionalDirs;
     constructor(options: AgentOptions);
     setKaos(kaos: Kaos): void;
+    getAdditionalDirs(): readonly string[];
+    setAdditionalDirs(additionalDirs: readonly string[]): void;
     get generate(): typeof generate;
     get llm(): KosongLLM;
     useProfile(profile: ResolvedAgentProfile, context?: PreparedSystemPromptContext): void;
@@ -132,6 +164,7 @@ declare interface AgentAPI {
     unregisterTool: (payload: UnregisterToolPayload) => void;
     setActiveTools: (payload: SetActiveToolsPayload) => void;
     stopBackground: (payload: StopBackgroundPayload) => void;
+    detachBackground: (payload: DetachBackgroundPayload) => BackgroundTaskInfo | undefined;
     clearContext: (payload: EmptyPayload) => void;
     activateSkill: (payload: ActivateSkillPayload) => void;
     startBtw: (payload: EmptyPayload) => string;
@@ -214,6 +247,7 @@ declare interface AgentOptions {
     readonly pluginSessionStarts?: readonly EnabledPluginSessionStart[];
     readonly experimentalFlags?: ExperimentalFlagResolver;
     readonly replay?: ReplayBuilderOptions;
+    readonly additionalDirs?: readonly string[];
 }
 
 declare type AgentRecord = {
@@ -511,19 +545,14 @@ declare class BackgroundManager {
     private readonly scheduledNotificationKeys;
     private readonly deliveredNotificationKeys;
     constructor(agent: Agent, persistence?: BackgroundTaskPersistence | undefined);
-    /**
-     * Fire terminal side effects for a live task. Idempotent: the second
-     * invocation for the same task is a no-op so a lagging `wait()`
-     * resolver or a race between `stop()` and natural exit cannot yield
-     * duplicate notifications/events.
-     */
     private fireTerminalEffects;
     private emitTaskStarted;
     private emitTaskTerminated;
-    private resolveWaiters;
     private assertCanRegister;
-    private activeTaskCount;
-    registerTask(task: BackgroundTask): string;
+    private activeBackgroundAdmissionCount;
+    private startedInBackground;
+    private isDetached;
+    registerTask(task: BackgroundTask, options?: RegisterBackgroundTaskOptions): string;
     /** Get info about a specific task. Falls back to reconcile ghosts. */
     getTask(taskId: string): BackgroundTaskInfo | undefined;
     /**
@@ -534,6 +563,7 @@ declare class BackgroundManager {
      * restart. Active-only mode never shows ghosts (they're terminal).
      */
     list(activeOnly?: boolean, limit?: number): BackgroundTaskInfo[];
+    private shouldListTask;
     /**
      * Return the output snapshot used by TaskOutput.
      *
@@ -546,6 +576,7 @@ declare class BackgroundManager {
     getOutputSnapshot(taskId: string, maxPreviewBytes: number): Promise<BackgroundTaskOutputSnapshot>;
     readOutput(taskId: string, tail?: number): Promise<string>;
     suppressTerminalNotification(taskId: string): Promise<void>;
+    detach(taskId: string): BackgroundTaskInfo | undefined;
     /** Stop a running task. SIGTERM → 5s grace → SIGKILL. */
     stop(taskId: string, reason?: string): Promise<BackgroundTaskInfo | undefined>;
     stopAll(reason?: string): Promise<readonly BackgroundTaskInfo[]>;
@@ -554,6 +585,11 @@ declare class BackgroundManager {
      * Returns immediately if already terminal. Times out after `timeoutMs`.
      */
     wait(taskId: string, timeoutMs?: number): Promise<BackgroundTaskInfo | undefined>;
+    /**
+     * Wait until a foreground task either detaches from the current tool call or
+     * reaches a terminal state. Detached tasks return immediately.
+     */
+    waitForForegroundRelease(taskId: string): Promise<ForegroundTaskReleaseReason | undefined>;
     /**
      * Load persisted task records into the ghost map. Does NOT reconcile
      * (call `reconcile()` after `loadFromDisk()`). Idempotent; subsequent
@@ -574,6 +610,15 @@ declare class BackgroundManager {
      */
     private persistLive;
     private appendOutput;
+    /** Enqueue an `output.log` append, serialized per task. No-op when detached managers omit persistence. */
+    private appendTaskOutput;
+    /**
+     * Begin persisting `output.log` for a task that buffered while foreground.
+     * Flushes the buffered pre-detach output first (in order, ahead of the live
+     * stream) so the on-disk log stays complete, then releases the buffer.
+     * Idempotent.
+     */
+    private startOutputPersist;
     private restoreBackgroundTaskNotifications;
     private notifyBackgroundTask;
     private restoreBackgroundTaskNotification;
@@ -581,7 +626,10 @@ declare class BackgroundManager {
     private fireNotificationHook;
     markDeliveredNotification(origin: BackgroundTaskOrigin): void;
     private isTerminalNotificationSuppressed;
-    private settleTask;
+    private runTaskLifecycle;
+    private signalOutcome;
+    private settlementForOutcome;
+    private finalizeTask;
     private toInfo;
 }
 
@@ -591,6 +639,7 @@ declare interface BackgroundTask {
     readonly description: string;
     readonly timeoutMs?: number;
     start(sink: BackgroundTaskSink): void | Promise<void>;
+    onDetach?(): void;
     forceStop?(): Promise<void>;
     toInfo(base: BackgroundTaskInfoBase): BackgroundTaskInfo;
 }
@@ -601,6 +650,11 @@ declare interface BackgroundTaskInfoBase {
     readonly taskId: string;
     readonly description: string;
     readonly status: BackgroundTaskStatus;
+    /**
+     * `false` means a tool call is still waiting on this task in the
+     * foreground. Omitted legacy records should be treated as detached.
+     */
+    readonly detached?: boolean;
     readonly startedAt: number;
     readonly endedAt: number | null;
     /** Human-readable reason for the terminal status, when available. */
@@ -1033,6 +1087,7 @@ declare class ContextMemory {
     get lastAssistantAt(): number | null;
     appendUserMessage(content: readonly ContentPart[], origin?: PromptOrigin): void;
     appendSystemReminder(content: string, origin: PromptOrigin): void;
+    appendLocalCommandStdout(content: string): void;
     popMatchedMessage(matcher: (origin: PromptOrigin | undefined) => boolean): boolean;
     clear(): void;
     undo(count: number): void;
@@ -1045,6 +1100,7 @@ declare class ContextMemory {
     get messages(): Message[];
     useProjectedHistoryFrom(source: ContextMemory): void;
     finishResume(): void;
+    private closePendingToolResults;
     appendLoopEvent(event: LoopRecordedEvent): void;
     appendMessage(message: ContextMessage): void;
     private flushDeferredMessagesIfToolExchangeClosed;
@@ -1124,6 +1180,7 @@ export declare interface CreateSessionOptions {
     readonly metadata?: JsonObject | undefined;
     readonly kaos?: Kaos | undefined;
     readonly persistenceKaos?: Kaos | undefined;
+    readonly additionalDirs?: readonly string[];
     readonly sessionStartedProperties?: TelemetryProperties;
 }
 
@@ -1135,6 +1192,7 @@ declare interface CreateSessionPayload {
     readonly permission?: PermissionMode_2 | undefined;
     readonly metadata?: JsonObject_2 | undefined;
     readonly mcpServers?: Readonly<Record<string, McpServerConfig>>;
+    readonly additionalDirs?: readonly string[];
     readonly client?: ClientTelemetryInfo | undefined;
 }
 
@@ -1464,6 +1522,10 @@ declare interface CronTask {
 
 export declare const DEFAULT_CATALOG_URL = "https://models.dev/api.json";
 
+declare interface DetachBackgroundPayload {
+    readonly taskId: string;
+}
+
 /** RFC 8628 §3.2 device authorization response. */
 declare interface DeviceAuthorization {
     readonly userCode: string;
@@ -1818,6 +1880,8 @@ export declare type FlagSurface = 'core' | 'tui' | 'both';
 
 export declare function flushDiagnosticLogs(): Promise<boolean>;
 
+declare type ForegroundTaskReleaseReason = 'detached' | 'terminal';
+
 export declare interface ForkSessionInput {
     readonly id: string;
     readonly forkId?: string;
@@ -3303,6 +3367,7 @@ declare class KimiCore implements PromisableMethods<CoreAPI> {
     unregisterTool({ sessionId, ...payload }: SessionAgentPayload<UnregisterToolPayload>): Promise<void>;
     setActiveTools({ sessionId, ...payload }: SessionAgentPayload<SetActiveToolsPayload>): Promise<void>;
     stopBackground({ sessionId, ...payload }: SessionAgentPayload<StopBackgroundPayload>): Promise<void>;
+    detachBackground({ sessionId, ...payload }: SessionAgentPayload<DetachBackgroundPayload>): Promise<BackgroundTaskInfo | undefined>;
     clearContext({ sessionId, ...payload }: SessionAgentPayload<EmptyPayload>): Promise<void>;
     activateSkill({ sessionId, ...payload }: SessionAgentPayload<ActivateSkillPayload>): Promise<void>;
     getBackgroundOutput({ sessionId, ...payload }: SessionAgentPayload<GetBackgroundOutputPayload>): Promise<string>;
@@ -3320,6 +3385,7 @@ declare class KimiCore implements PromisableMethods<CoreAPI> {
     getMcpStartupMetrics({ sessionId, ...payload }: SessionScopedPayload<EmptyPayload>): Promise<McpStartupMetrics>;
     reconnectMcpServer({ sessionId, ...payload }: SessionScopedPayload<ReconnectMcpServerPayload>): Promise<void>;
     generateAgentsMd({ sessionId, ...payload }: SessionScopedPayload<EmptyPayload>): Promise<void>;
+    addAdditionalDir({ sessionId, ...payload }: SessionScopedPayload<AddAdditionalDirPayload>): Promise<AddAdditionalDirResult_2>;
     startBtw({ sessionId, ...payload }: SessionAgentPayload<EmptyPayload>): Promise<string>;
     createGoal({ sessionId, ...payload }: SessionAgentPayload<CreateGoalPayload>): Promise<GoalSnapshot>;
     getGoal({ sessionId, ...payload }: SessionAgentPayload<EmptyPayload>): Promise<GoalToolResult>;
@@ -3341,6 +3407,7 @@ declare class KimiCore implements PromisableMethods<CoreAPI> {
     private mergePluginMcpConfig;
     private withManagedKimiPluginEnv;
     private managedKimiCodeEnvForPlugins;
+    private requireSession;
     private sessionApi;
     private reloadProviderManager;
     private readConfigForWrite;
@@ -4620,7 +4687,7 @@ export declare interface PluginSummary {
     readonly github?: PluginGithubMetadata;
 }
 
-declare type PreparedSystemPromptContext = Pick<SystemPromptContext, 'cwdListing' | 'agentsMd'>;
+declare type PreparedSystemPromptContext = Pick<SystemPromptContext, 'cwdListing' | 'agentsMd' | 'additionalDirsInfo'>;
 
 declare interface PrepareToolExecutionResult extends AuthorizeToolExecutionResult {
     readonly updatedArgs?: unknown;
@@ -4790,6 +4857,18 @@ declare interface ReconnectMcpServerRpcInput extends SessionIdRpcInput {
 
 export declare function redact<T>(value: T): T;
 
+declare interface RegisterBackgroundTaskOptions {
+    /**
+     * When false, the task is tracked by the manager but a foreground tool call
+     * is still waiting for it. It can later be detached through RPC.
+     */
+    readonly detached?: boolean;
+    /** Deadline owned by BackgroundManager. `0` and `undefined` do not arm a timer. */
+    readonly timeoutMs?: number;
+    /** Foreground caller signal. Ignored for tasks created already detached. */
+    readonly signal?: AbortSignal;
+}
+
 declare interface RegisterToolPayload {
     readonly name: string;
     readonly description: string;
@@ -4933,12 +5012,14 @@ export declare interface ResumeSessionInput {
     readonly id: string;
     readonly kaos?: Kaos | undefined;
     readonly persistenceKaos?: Kaos | undefined;
+    readonly additionalDirs?: readonly string[];
     readonly sessionStartedProperties?: TelemetryProperties;
 }
 
 declare interface ResumeSessionPayload {
     readonly sessionId: string;
     readonly mcpServers?: Readonly<Record<string, McpServerConfig>>;
+    readonly additionalDirs?: readonly string[];
 }
 
 declare interface ResumeSessionResult extends SessionSummary_2 {
@@ -5063,6 +5144,7 @@ export declare abstract class SDKRpcClientBase {
     prompt(input: SessionPromptRpcInput): Promise<void>;
     steer(input: SessionPromptRpcInput): Promise<void>;
     generateAgentsMd(input: SessionIdRpcInput): Promise<void>;
+    addAdditionalDir(input: AddAdditionalDirInput): Promise<AddAdditionalDirResult>;
     startBtw(input: SessionIdRpcInput): Promise<string>;
     cancel(input: SessionIdRpcInput): Promise<void>;
     setModel(input: SetSessionModelRpcInput): Promise<SetSessionModelRpcResult>;
@@ -5096,6 +5178,9 @@ export declare abstract class SDKRpcClientBase {
         taskId: string;
         reason?: string;
     }): Promise<void>;
+    detachBackgroundTask(input: SessionIdRpcInput & {
+        taskId: string;
+    }): Promise<BackgroundTaskInfo | undefined>;
     createGoal(input: SessionIdRpcInput & CreateGoalInput): Promise<GoalSnapshot>;
     getGoal(input: SessionIdRpcInput): Promise<GoalToolResult>;
     pauseGoal(input: SessionIdRpcInput): Promise<GoalSnapshot>;
@@ -5191,6 +5276,7 @@ export declare class Session {
     steer(input: string | PromptInput): Promise<void>;
     swarm(input: string | PromptInput): Promise<void>;
     init(): Promise<void>;
+    addAdditionalDir(path: string, options?: AddAdditionalDirOptions): Promise<AddAdditionalDirResult>;
     startBtw(): Promise<string>;
     cancel(): Promise<void>;
     setModel(model: string): Promise<void>;
@@ -5236,6 +5322,11 @@ export declare class Session {
     stopBackgroundTask(taskId: string, options?: {
         reason?: string;
     }): Promise<void>;
+    /**
+     * Detach a running foreground task so the current tool call can return while
+     * the task continues under background-task management.
+     */
+    detachBackgroundTask(taskId: string): Promise<BackgroundTaskInfo | undefined>;
     createGoal(input: CreateGoalInput): Promise<GoalSnapshot>;
     getGoal(): Promise<GoalToolResult>;
     pauseGoal(): Promise<GoalSnapshot>;
@@ -5259,6 +5350,7 @@ export declare class Session {
     }): void;
     private emit;
     private ensureOpen;
+    private requireSummary;
 }
 
 declare class Session_2 {
@@ -5274,12 +5366,19 @@ declare class Session_2 {
     readonly experimentalFlags: ExperimentalFlagResolver;
     private toolKaos;
     private persistenceKaos;
+    private additionalDirs;
     private agentIdCounter;
     private readonly skillsReady;
     metadata: SessionMeta;
     private writeMetadataPromise;
     constructor(options: SessionOptions_2);
     setToolKaos(kaos: Kaos): void;
+    getAdditionalDirs(): readonly string[];
+    setAdditionalDirs(additionalDirs: readonly string[]): Promise<void>;
+    addAdditionalDir(path: string, persist?: boolean): Promise<WorkspaceAdditionalDirsLoadResult & {
+        readonly persisted: boolean;
+    }>;
+    private notifyAdditionalDirAdded;
     /**
      * Kaos used by session-internal bootstrap (AGENTS.md context, cwd listing)
      * and metadata persistence. Always backed by the persistence sink (typically
@@ -5345,6 +5444,7 @@ declare interface SessionAPI extends AgentAPIWithId {
     getMcpStartupMetrics: (payload: EmptyPayload) => McpStartupMetrics;
     reconnectMcpServer: (payload: ReconnectMcpServerPayload) => void;
     generateAgentsMd: (payload: EmptyPayload) => void;
+    addAdditionalDir: (payload: AddAdditionalDirPayload) => AddAdditionalDirResult_2;
 }
 
 declare type SessionAPIWithId = WithSessionId<SessionAPI>;
@@ -5465,6 +5565,7 @@ declare interface SessionOptions_2 {
     readonly pluginSessionStarts?: readonly EnabledPluginSessionStart[];
     readonly appVersion?: string;
     readonly experimentalFlags?: ExperimentalFlagResolver;
+    readonly additionalDirs?: readonly string[];
 }
 
 export declare type SessionPlan = PlanInfo | null;
@@ -5540,6 +5641,7 @@ declare class SessionSubagentHost {
     suspended(event: SubagentSuspendedEvent_2): void;
     startBtw(): Promise<string>;
     cancelAll(reason?: unknown): void;
+    markActiveChildDetached(agentId: string): void;
     getProfileName(agentId: string): Promise<string | undefined>;
     getSwarmItem(agentId: string): string | undefined;
     private resolveProfile;
@@ -5565,6 +5667,7 @@ export declare interface SessionSummary {
     readonly updatedAt: number;
     readonly archived?: boolean | undefined;
     readonly metadata?: JsonObject | undefined;
+    readonly additionalDirs?: readonly string[];
 }
 
 declare interface SessionSummary_2 {
@@ -5577,6 +5680,7 @@ declare interface SessionSummary_2 {
     readonly updatedAt: number;
     readonly archived?: boolean | undefined;
     readonly metadata?: JsonObject_2 | undefined;
+    readonly additionalDirs?: readonly string[];
 }
 
 export declare interface SessionUsage {
@@ -6458,4 +6562,39 @@ declare type WithSessionId<T> = WithExtraPayload<T, {
     readonly sessionId: string;
 }>;
 
-export { }
+declare interface WorkspaceAdditionalDirsLoadResult {
+    readonly projectRoot: string;
+    readonly configPath: string;
+    readonly additionalDirs: readonly string[];
+    readonly warning?: string;
+}
+
+export { }
+
+// Botiverse mirror surface extension — see scripts/repackage-sdk.mjs.
+// Minimal type declaration; runtime implementation is bundled in dist/index.mjs.
+declare class LocalKaos implements Kaos {
+  static create(): Promise<LocalKaos>;
+  readonly name: string;
+  readonly osEnv: Kaos['osEnv'];
+  pathClass(): 'posix' | 'win32';
+  normpath(path: string): string;
+  gethome(): string;
+  getcwd(): string;
+  chdir(path: string): Promise<void>;
+  withCwd(cwd: string): LocalKaos;
+  withEnv(env: Record<string, string>): LocalKaos;
+  stat: Kaos['stat'];
+  iterdir: Kaos['iterdir'];
+  glob: Kaos['glob'];
+  readBytes: Kaos['readBytes'];
+  readText: Kaos['readText'];
+  readLines: Kaos['readLines'];
+  writeBytes: Kaos['writeBytes'];
+  writeText: Kaos['writeText'];
+  mkdir: Kaos['mkdir'];
+  exec: Kaos['exec'];
+  execWithEnv: Kaos['execWithEnv'];
+}
+export { LocalKaos };
+export type { Kaos };