@nikcli-ai/sdk 1.39.0 → 1.41.0

package/dist/v2/gen/sdk.gen.d.ts

@@ -1,5 +1,5 @@
 import { type Client, type Options as Options2, type TDataShape } from "./client/index.js";
-import type { AgentPartInput, AnalyticsDailyResponses, AnalyticsGlobalResponses, AnalyticsLeaderboardResponses, AnalyticsSessionErrors, AnalyticsSessionResponses, AnalyticsSessionsResponses, AppAgentsResponses, AppLogErrors, AppLogResponses, AppSkillCreateErrors, AppSkillCreateResponses, AppSkillDeleteErrors, AppSkillDeleteResponses, AppSkillsResponses, Auth as Auth7, AuthRemoveErrors, AuthRemoveResponses, AuthSetErrors, AuthSetResponses, CommandListResponses, Config as Config2, ConfigGetResponses, ConfigProvidersResponses, ConfigUpdateErrors, ConfigUpdateResponses, ConnectorsAuthRemoveErrors, ConnectorsAuthRemoveResponses, ConnectorsAuthSetErrors, ConnectorsAuthSetResponses, ConnectorsInvalidateResponses, ConnectorsStatusResponses, DeleteConfigMcpNameResponses, EventSubscribeResponses, EventTuiCommandExecute, EventTuiPromptAppend, EventTuiSessionSelect, EventTuiToastShow, ExperimentalResourceListResponses, ExperimentalWorkspaceAdaptorListResponses, ExperimentalWorkspaceCreateErrors, ExperimentalWorkspaceCreateResponses, ExperimentalWorkspaceListResponses, ExperimentalWorkspaceRemoveErrors, ExperimentalWorkspaceRemoveResponses, ExperimentalWorkspaceRestoreErrors, ExperimentalWorkspaceRestoreResponses, ExperimentalWorkspaceSessionRestoreErrors, ExperimentalWorkspaceSessionRestoreResponses, ExperimentalWorkspaceSessionWarpErrors, ExperimentalWorkspaceSessionWarpResponses, ExperimentalWorkspaceWarpErrors, ExperimentalWorkspaceWarpResponses, FileListResponses, FilePartInput, FilePartSource, FileReadResponses, FileStatusResponses, FileWriteResponses, FindFilesResponses, FindSymbolsResponses, FindTextResponses, FormatterStatusResponses, GetApiShareShareIdDataResponses, GetApiShareShareIdResponses, GetShareShareIdResponses, GetSShareIdResponses, GlobalDisposeResponses, GlobalEventResponses, GlobalHealthResponses, InstanceDisposeResponses, LspStatusResponses, ManagedWorktreeAncestorsErrors, ManagedWorktreeAncestorsResponses, ManagedWorktreeChildrenErrors, ManagedWorktreeChildrenResponses, ManagedWorktreeCreateErrors, ManagedWorktreeCreateInput, ManagedWorktreeCreateResponses, ManagedWorktreeLinkErrors, ManagedWorktreeLinkInput, ManagedWorktreeLinkResponses, ManagedWorktreeListErrors, ManagedWorktreeListResponses, ManagedWorktreeRemoveErrors, ManagedWorktreeRemoveInput, ManagedWorktreeRemoveResponses, McpAddErrors, McpAddResponses, McpAuthAuthenticateErrors, McpAuthAuthenticateResponses, McpAuthCallbackErrors, McpAuthCallbackResponses, McpAuthRemoveErrors, McpAuthRemoveResponses, McpAuthStartErrors, McpAuthStartResponses, McpConnectResponses, McpDisconnectResponses, McpLocalConfig, McpRemoteConfig, McpStatusResponses, McpToggleErrors, McpToggleResponses, MobileAuthTokenCreateResponses, MobileAuthTokenListResponses, MobileAuthTokenRevokeResponses, MobileBootstrapResponses, MobileCommandListResponses, MobileGitBranchesResponses, MobileGitCheckoutErrors, MobileGitCheckoutResponses, MobileGitCommitErrors, MobileGitCommitResponses, MobileGitCommitsResponses, MobileGitDiffResponses, MobileGitDiscardResponses, MobileGithubAuthRemoveResponses, MobileGithubAuthSetErrors, MobileGithubAuthSetResponses, MobileGithubBranchesResponses, MobileGithubDeviceAuthPollInput, MobileGithubImportErrors, MobileGithubImportRequest, MobileGithubImportResponses, MobileGithubImportsResponses, MobileGithubOauthClientIdSetErrors, MobileGithubOauthClientIdSetResponses, MobileGithubOauthDevicePollErrors, MobileGithubOauthDevicePollResponses, MobileGithubOauthDeviceStartErrors, MobileGithubOauthDeviceStartResponses, MobileGithubPublishInput, MobileGithubReposResponses, MobileGithubSessionCleanupErrors, MobileGithubSessionCleanupResponses, MobileGithubSessionCreateErrors, MobileGithubSessionCreateInput, MobileGithubSessionCreateResponses, MobileGithubSessionPublishErrors, MobileGithubSessionPublishResponses, MobileGitPullErrors, MobileGitPullResponses, MobileGitPushErrors, MobileGitPushResponses, MobileGitStageResponses, MobileGitStatusResponses, MobileGitUnstageResponses, MobileMemoryHistoryResponses, MobileMemorySearchResponses, MobileMemoryStashCreateErrors, MobileMemoryStashCreateResponses, MobileMemoryStashDeleteErrors, MobileMemoryStashDeleteResponses, MobileMemoryStashListResponses, MobilePermissionRespondResponses, MobileProjectListResponses, MobilePromptStashCreateInput, MobileQuestionRejectResponses, MobileQuestionRespondResponses, MobileRoutineCreateErrors, MobileRoutineCreateInput, MobileRoutineCreateResponses, MobileRoutineDeleteErrors, MobileRoutineDeleteResponses, MobileRoutineGetErrors, MobileRoutineGetResponses, MobileRoutineListErrors, MobileRoutineListResponses, MobileRoutinePauseErrors, MobileRoutinePauseResponses, MobileRoutineResumeErrors, MobileRoutineResumeResponses, MobileRoutineRunErrors, MobileRoutineRunInput, MobileRoutineRunResponses, MobileRoutineTriggerErrors, MobileRoutineTriggerInput, MobileRoutineTriggerResponses, MobileRoutineUpdateErrors, MobileRoutineUpdateInput, MobileRoutineUpdateResponses, MobileSessionAbortResponses, MobileSessionCommandErrors, MobileSessionCommandInput, MobileSessionCommandListErrors, MobileSessionCommandListResponses, MobileSessionCommandResponses, MobileSessionCreateErrors, MobileSessionCreateInput, MobileSessionCreateResponses, MobileSessionDeleteErrors, MobileSessionDeleteResponses, MobileSessionDetailErrors, MobileSessionDetailResponses, MobileSessionDiffResponses, MobileSessionListResponses, MobileSessionMessageErrors, MobileSessionMessageResponses, MobileSessionRenameResponses, MobileSessionStreamResponses, MobileWorktreeCreateErrors, MobileWorktreeCreateResponses, MobileWorktreeRemoveResponses, MobileWorktreeResetResponses, OutputFormat, Part as Part2, PartDeleteErrors, PartDeleteResponses, PartUpdateErrors, PartUpdateResponses, PatchConfigMcpNameResponses, PatchUserIdResponses, PathGetResponses, PermissionListResponses, PermissionReplyErrors, PermissionReplyResponses, PermissionRespondErrors, PermissionRespondResponses, PermissionRuleset, PostConfigMcpResponses, PostConfigProfilesActivateNameResponses, PostConfigProfilesResponses, PostUserLoginResponses, PostUserRegisterResponses, ProjectCurrentResponses, ProjectListResponses, ProjectUpdateErrors, ProjectUpdateResponses, ProviderApiSetErrors, ProviderApiSetResponses, ProviderAuthRemoveResponses, ProviderAuthResponses, ProviderListResponses, ProviderOauthAuthorizeErrors, ProviderOauthAuthorizeResponses, ProviderOauthCallbackErrors, ProviderOauthCallbackResponses, PtyConnectErrors, PtyConnectResponses, PtyCreateErrors, PtyCreateResponses, PtyGetErrors, PtyGetResponses, PtyListResponses, PtyRemoveErrors, PtyRemoveResponses, PtyUpdateErrors, PtyUpdateResponses, QuestionAnswer, QuestionListResponses, QuestionRejectErrors, QuestionRejectResponses, QuestionReplyErrors, QuestionReplyResponses, SessionAbortErrors, SessionAbortResponses, SessionBackgroundCancelErrors, SessionBackgroundCancelResponses, SessionBackgroundErrors, SessionBackgroundInspectErrors, SessionBackgroundInspectResponses, SessionBackgroundReadErrors, SessionBackgroundReadResponses, SessionBackgroundResponses, SessionChildrenErrors, SessionChildrenResponses, SessionCommandErrors, SessionCommandResponses, SessionCreateErrors, SessionCreateResponses, SessionDeleteErrors, SessionDeleteResponses, SessionDiffResponses, SessionForkResponses, SessionGetErrors, SessionGetResponses, SessionGithub, SessionInitErrors, SessionInitResponses, SessionInstructionsErrors, SessionInstructionsResponses, SessionListResponses, SessionMessageErrors, SessionMessageResponses, SessionMessagesErrors, SessionMessagesResponses, SessionMonitorCancelErrors, SessionMonitorCancelResponses, SessionMonitorErrors, SessionMonitorLogErrors, SessionMonitorLogResponses, SessionMonitorResponses, SessionPromptAsyncErrors, SessionPromptAsyncResponses, SessionPromptErrors, SessionPromptResponses, SessionRevertErrors, SessionRevertResponses, SessionShareErrors, SessionShareResponses, SessionShellErrors, SessionShellResponses, SessionStatusErrors, SessionStatusResponses, SessionSummarizeErrors, SessionSummarizeResponses, SessionTodoErrors, SessionTodoResponses, SessionUnrevertErrors, SessionUnrevertResponses, SessionUnshareErrors, SessionUnshareResponses, SessionUpdateErrors, SessionUpdateResponses, SubtaskPartInput, TextPartInput, ToolIdsErrors, ToolIdsResponses, ToolListErrors, ToolListResponses, TuiAppendPromptErrors, TuiAppendPromptResponses, TuiClearPromptResponses, TuiControlNextResponses, TuiControlResponseResponses, TuiExecuteCommandErrors, TuiExecuteCommandResponses, TuiOpenHelpResponses, TuiOpenModelsResponses, TuiOpenSessionsResponses, TuiOpenThemesResponses, TuiPublishErrors, TuiPublishResponses, TuiSelectSessionErrors, TuiSelectSessionResponses, TuiShowToastResponses, TuiSubmitPromptResponses, VcsApplyErrors, VcsApplyInput, VcsApplyResponses, VcsDiffRawResponses, VcsGetResponses, VcsStatusResponses, WorktreeCreateErrors, WorktreeCreateInput, WorktreeCreateResponses, WorktreeListResponses, WorktreeRemoveErrors, WorktreeRemoveInput, WorktreeRemoveResponses, WorktreeResetErrors, WorktreeResetInput, WorktreeResetResponses } from "./types.gen.js";
+import type { AgentPartInput, AnalyticsDailyResponses, AnalyticsGlobalResponses, AnalyticsLeaderboardResponses, AnalyticsSessionErrors, AnalyticsSessionResponses, AnalyticsSessionsResponses, AppAgentsResponses, AppLogErrors, AppLogResponses, AppSkillCreateErrors, AppSkillCreateResponses, AppSkillDeleteErrors, AppSkillDeleteResponses, AppSkillsResponses, Auth as Auth7, AuthRemoveErrors, AuthRemoveResponses, AuthSetErrors, AuthSetResponses, CommandListResponses, Config as Config2, ConfigGetResponses, ConfigProvidersResponses, ConfigUpdateErrors, ConfigUpdateResponses, ConnectorsAuthRemoveErrors, ConnectorsAuthRemoveResponses, ConnectorsAuthSetErrors, ConnectorsAuthSetResponses, ConnectorsInvalidateResponses, ConnectorsStatusResponses, DeleteConfigMcpNameResponses, EventSubscribeResponses, EventTuiCommandExecute, EventTuiPromptAppend, EventTuiSessionSelect, EventTuiToastShow, ExperimentalResourceListResponses, ExperimentalWorkspaceAdaptorListResponses, ExperimentalWorkspaceCreateErrors, ExperimentalWorkspaceCreateResponses, ExperimentalWorkspaceListResponses, ExperimentalWorkspaceRemoveErrors, ExperimentalWorkspaceRemoveResponses, ExperimentalWorkspaceRestoreErrors, ExperimentalWorkspaceRestoreResponses, ExperimentalWorkspaceSessionRestoreErrors, ExperimentalWorkspaceSessionRestoreResponses, ExperimentalWorkspaceSessionWarpErrors, ExperimentalWorkspaceSessionWarpResponses, ExperimentalWorkspaceWarpErrors, ExperimentalWorkspaceWarpResponses, FileListResponses, FilePartInput, FilePartSource, FileReadResponses, FileStatusResponses, FileWriteResponses, FindFilesResponses, FindSymbolsResponses, FindTextResponses, FormatterStatusResponses, GetApiShareShareIdDataResponses, GetApiShareShareIdResponses, GetShareShareIdResponses, GetSShareIdResponses, GlobalDisposeResponses, GlobalEventResponses, GlobalHealthResponses, InstanceDisposeResponses, LspStatusResponses, ManagedWorktreeAncestorsErrors, ManagedWorktreeAncestorsResponses, ManagedWorktreeChildrenErrors, ManagedWorktreeChildrenResponses, ManagedWorktreeCreateErrors, ManagedWorktreeCreateInput, ManagedWorktreeCreateResponses, ManagedWorktreeLinkErrors, ManagedWorktreeLinkInput, ManagedWorktreeLinkResponses, ManagedWorktreeListErrors, ManagedWorktreeListResponses, ManagedWorktreeRemoveErrors, ManagedWorktreeRemoveInput, ManagedWorktreeRemoveResponses, McpAddErrors, McpAddResponses, McpAuthAuthenticateErrors, McpAuthAuthenticateResponses, McpAuthCallbackErrors, McpAuthCallbackResponses, McpAuthRemoveErrors, McpAuthRemoveResponses, McpAuthStartErrors, McpAuthStartResponses, McpConnectResponses, McpDisconnectResponses, McpLocalConfig, McpRemoteConfig, McpStatusResponses, McpToggleErrors, McpToggleResponses, MobileAuthTokenCreateResponses, MobileAuthTokenListResponses, MobileAuthTokenRevokeResponses, MobileBootstrapResponses, MobileCommandListResponses, MobileGitBranchesResponses, MobileGitCheckoutErrors, MobileGitCheckoutResponses, MobileGitCommitErrors, MobileGitCommitResponses, MobileGitCommitsResponses, MobileGitDiffResponses, MobileGitDiscardResponses, MobileGithubAuthRemoveResponses, MobileGithubAuthSetErrors, MobileGithubAuthSetResponses, MobileGithubBranchesResponses, MobileGithubDeviceAuthPollInput, MobileGithubImportErrors, MobileGithubImportRequest, MobileGithubImportResponses, MobileGithubImportsResponses, MobileGithubOauthClientIdSetErrors, MobileGithubOauthClientIdSetResponses, MobileGithubOauthDevicePollErrors, MobileGithubOauthDevicePollResponses, MobileGithubOauthDeviceStartErrors, MobileGithubOauthDeviceStartResponses, MobileGithubPublishInput, MobileGithubReposResponses, MobileGithubSessionCleanupErrors, MobileGithubSessionCleanupResponses, MobileGithubSessionCreateErrors, MobileGithubSessionCreateInput, MobileGithubSessionCreateResponses, MobileGithubSessionPublishErrors, MobileGithubSessionPublishResponses, MobileGitPullErrors, MobileGitPullResponses, MobileGitPushErrors, MobileGitPushResponses, MobileGitStageResponses, MobileGitStatusResponses, MobileGitUnstageResponses, MobileMemoryHistoryResponses, MobileMemorySearchResponses, MobileMemoryStashCreateErrors, MobileMemoryStashCreateResponses, MobileMemoryStashDeleteErrors, MobileMemoryStashDeleteResponses, MobileMemoryStashListResponses, MobilePermissionRespondResponses, MobileProjectListResponses, MobilePromptStashCreateInput, MobileQuestionRejectResponses, MobileQuestionRespondResponses, MobileRoutineCreateErrors, MobileRoutineCreateInput, MobileRoutineCreateResponses, MobileRoutineDeleteErrors, MobileRoutineDeleteResponses, MobileRoutineGetErrors, MobileRoutineGetResponses, MobileRoutineListErrors, MobileRoutineListResponses, MobileRoutinePauseErrors, MobileRoutinePauseResponses, MobileRoutineResumeErrors, MobileRoutineResumeResponses, MobileRoutineRunErrors, MobileRoutineRunInput, MobileRoutineRunResponses, MobileRoutineTriggerErrors, MobileRoutineTriggerInput, MobileRoutineTriggerResponses, MobileRoutineUpdateErrors, MobileRoutineUpdateInput, MobileRoutineUpdateResponses, MobileSessionAbortResponses, MobileSessionCommandErrors, MobileSessionCommandInput, MobileSessionCommandListErrors, MobileSessionCommandListResponses, MobileSessionCommandResponses, MobileSessionCreateErrors, MobileSessionCreateInput, MobileSessionCreateResponses, MobileSessionDeleteErrors, MobileSessionDeleteResponses, MobileSessionDetailErrors, MobileSessionDetailResponses, MobileSessionDiffResponses, MobileSessionListResponses, MobileSessionMessageErrors, MobileSessionMessageResponses, MobileSessionRenameResponses, MobileSessionStreamResponses, MobileWorktreeCreateErrors, MobileWorktreeCreateResponses, MobileWorktreeRemoveResponses, MobileWorktreeResetResponses, OutputFormat, Part as Part2, PartDeleteErrors, PartDeleteResponses, PartUpdateErrors, PartUpdateResponses, PatchConfigMcpNameResponses, PatchUserIdResponses, PathGetResponses, PermissionListResponses, PermissionReplyErrors, PermissionReplyResponses, PermissionRespondErrors, PermissionRespondResponses, PermissionRuleset, PostConfigMcpResponses, PostConfigProfilesActivateNameResponses, PostConfigProfilesResponses, PostUserLoginResponses, PostUserRegisterResponses, ProjectCurrentResponses, ProjectListResponses, ProjectUpdateErrors, ProjectUpdateResponses, ProviderApiSetErrors, ProviderApiSetResponses, ProviderAuthRemoveResponses, ProviderAuthResponses, ProviderListResponses, ProviderOauthAuthorizeErrors, ProviderOauthAuthorizeResponses, ProviderOauthCallbackErrors, ProviderOauthCallbackResponses, PtyConnectErrors, PtyConnectResponses, PtyCreateErrors, PtyCreateResponses, PtyGetErrors, PtyGetResponses, PtyListResponses, PtyRemoveErrors, PtyRemoveResponses, PtyUpdateErrors, PtyUpdateResponses, QuestionAnswer, QuestionListResponses, QuestionRejectErrors, QuestionRejectResponses, QuestionReplyErrors, QuestionReplyResponses, SessionAbortErrors, SessionAbortResponses, SessionBackgroundCancelErrors, SessionBackgroundCancelResponses, SessionBackgroundErrors, SessionBackgroundInspectErrors, SessionBackgroundInspectResponses, SessionBackgroundReadErrors, SessionBackgroundReadResponses, SessionBackgroundResponses, SessionChildrenErrors, SessionChildrenResponses, SessionCommandErrors, SessionCommandResponses, SessionContextErrors, SessionContextResponses, SessionContextToggleErrors, SessionContextToggleResponses, SessionCreateErrors, SessionCreateResponses, SessionDeleteErrors, SessionDeleteResponses, SessionDiffResponses, SessionForkResponses, SessionGetErrors, SessionGetResponses, SessionGithub, SessionInitErrors, SessionInitResponses, SessionInstructionsErrors, SessionInstructionsResponses, SessionListResponses, SessionMessageErrors, SessionMessageResponses, SessionMessagesErrors, SessionMessagesResponses, SessionMonitorCancelErrors, SessionMonitorCancelResponses, SessionMonitorErrors, SessionMonitorLogErrors, SessionMonitorLogResponses, SessionMonitorResponses, SessionPromptAsyncErrors, SessionPromptAsyncResponses, SessionPromptErrors, SessionPromptResponses, SessionRevertErrors, SessionRevertResponses, SessionShareErrors, SessionShareResponses, SessionShellErrors, SessionShellResponses, SessionStatusErrors, SessionStatusResponses, SessionSummarizeErrors, SessionSummarizeResponses, SessionTodoErrors, SessionTodoResponses, SessionUnrevertErrors, SessionUnrevertResponses, SessionUnshareErrors, SessionUnshareResponses, SessionUpdateErrors, SessionUpdateResponses, SubtaskPartInput, TextPartInput, ToolIdsErrors, ToolIdsResponses, ToolListErrors, ToolListResponses, TuiAppendPromptErrors, TuiAppendPromptResponses, TuiClearPromptResponses, TuiControlNextResponses, TuiControlResponseResponses, TuiExecuteCommandErrors, TuiExecuteCommandResponses, TuiOpenHelpResponses, TuiOpenModelsResponses, TuiOpenSessionsResponses, TuiOpenThemesResponses, TuiPublishErrors, TuiPublishResponses, TuiSelectSessionErrors, TuiSelectSessionResponses, TuiShowToastResponses, TuiSubmitPromptResponses, VcsApplyErrors, VcsApplyInput, VcsApplyResponses, VcsDiffRawResponses, VcsGetResponses, VcsStatusResponses, WorktreeCreateErrors, WorktreeCreateInput, WorktreeCreateResponses, WorktreeListResponses, WorktreeRemoveErrors, WorktreeRemoveInput, WorktreeRemoveResponses, WorktreeResetErrors, WorktreeResetInput, WorktreeResetResponses } from "./types.gen.js";
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = Options2<TData, ThrowOnError> & {
     /**
      * You can provide a client instance returned by `createClient()` instead of
@@ -498,6 +498,10 @@ export declare class Session2 extends HeyApiClient {
         title?: string;
         permission?: PermissionRuleset;
         skills?: Array<string>;
+        disabledInstructions?: Array<string>;
+        disabledTools?: {
+            [key: string]: boolean;
+        };
         github?: SessionGithub;
         workspaceID?: string;
     }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionCreateResponses, SessionCreateErrors, ThrowOnError, "fields">;
@@ -554,6 +558,29 @@ export declare class Session2 extends HeyApiClient {
         directory?: string;
         workspace?: string;
     }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionInstructionsResponses, SessionInstructionsErrors, ThrowOnError, "fields">;
+    /**
+     * Get context usage breakdown
+     *
+     * Compute a per-source breakdown of estimated context tokens (system prompt, environment, instruction files, skills, MCP servers, built-in tools, agents, and conversation) along with the tokens last reported by the provider. Sources tagged togglable can be enabled/disabled to manage context.
+     */
+    context<ThrowOnError extends boolean = false>(parameters: {
+        sessionID: string;
+        directory?: string;
+        workspace?: string;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionContextResponses, SessionContextErrors, ThrowOnError, "fields">;
+    /**
+     * Enable or disable a context source
+     *
+     * Enable or disable a single context source for this session. Supports MCP servers (kind=mcp), active skills (kind=skill), instruction files (kind=instruction), and tools (kind=tool). Returns the recomputed context breakdown.
+     */
+    contextToggle<ThrowOnError extends boolean = false>(parameters: {
+        sessionID: string;
+        directory?: string;
+        workspace?: string;
+        kind?: "mcp" | "skill" | "instruction" | "tool";
+        key?: string;
+        enabled?: boolean;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionContextToggleResponses, SessionContextToggleErrors, ThrowOnError, "fields">;
     /**
      * Get session children
      *

package/dist/v2/gen/sdk.gen.js

@@ -969,6 +969,8 @@ export class Session2 extends HeyApiClient {
                     { in: "body", key: "title" },
                     { in: "body", key: "permission" },
                     { in: "body", key: "skills" },
+                    { in: "body", key: "disabledInstructions" },
+                    { in: "body", key: "disabledTools" },
                     { in: "body", key: "github" },
                     { in: "body", key: "workspaceID" },
                 ],
@@ -1096,6 +1098,56 @@ export class Session2 extends HeyApiClient {
             ...params,
         });
     }
+    /**
+     * Get context usage breakdown
+     *
+     * Compute a per-source breakdown of estimated context tokens (system prompt, environment, instruction files, skills, MCP servers, built-in tools, agents, and conversation) along with the tokens last reported by the provider. Sources tagged togglable can be enabled/disabled to manage context.
+     */
+    context(parameters, options) {
+        const params = buildClientParams([parameters], [
+            {
+                args: [
+                    { in: "path", key: "sessionID" },
+                    { in: "query", key: "directory" },
+                    { in: "query", key: "workspace" },
+                ],
+            },
+        ]);
+        return (options?.client ?? this.client).get({
+            url: "/session/{sessionID}/context",
+            ...options,
+            ...params,
+        });
+    }
+    /**
+     * Enable or disable a context source
+     *
+     * Enable or disable a single context source for this session. Supports MCP servers (kind=mcp), active skills (kind=skill), instruction files (kind=instruction), and tools (kind=tool). Returns the recomputed context breakdown.
+     */
+    contextToggle(parameters, options) {
+        const params = buildClientParams([parameters], [
+            {
+                args: [
+                    { in: "path", key: "sessionID" },
+                    { in: "query", key: "directory" },
+                    { in: "query", key: "workspace" },
+                    { in: "body", key: "kind" },
+                    { in: "body", key: "key" },
+                    { in: "body", key: "enabled" },
+                ],
+            },
+        ]);
+        return (options?.client ?? this.client).post({
+            url: "/session/{sessionID}/context/toggle",
+            ...options,
+            ...params,
+            headers: {
+                "Content-Type": "application/json",
+                ...options?.headers,
+                ...params.headers,
+            },
+        });
+    }
     /**
      * Get session children
      *

package/dist/v2/gen/types.gen.d.ts

@@ -866,6 +866,10 @@ export type Session = {
     };
     permission?: PermissionRuleset;
     skills?: Array<string>;
+    disabledInstructions?: Array<string>;
+    disabledTools?: {
+        [key: string]: boolean;
+    };
     revert?: {
         messageID: string;
         partID?: string;
@@ -4015,6 +4019,10 @@ export type SessionCreateData = {
         title?: string;
         permission?: PermissionRuleset;
         skills?: Array<string>;
+        disabledInstructions?: Array<string>;
+        disabledTools?: {
+            [key: string]: boolean;
+        };
         github?: SessionGithub;
         workspaceID?: string;
     };
@@ -4188,6 +4196,122 @@ export type SessionInstructionsResponses = {
     }>;
 };
 export type SessionInstructionsResponse = SessionInstructionsResponses[keyof SessionInstructionsResponses];
+export type SessionContextData = {
+    body?: never;
+    path: {
+        sessionID: string;
+    };
+    query?: {
+        directory?: string;
+        workspace?: string;
+    };
+    url: "/session/{sessionID}/context";
+};
+export type SessionContextErrors = {
+    /**
+     * Bad request
+     */
+    400: BadRequestError;
+    /**
+     * Not found
+     */
+    404: NotFoundError;
+};
+export type SessionContextError = SessionContextErrors[keyof SessionContextErrors];
+export type SessionContextResponses = {
+    /**
+     * Context usage breakdown
+     */
+    200: {
+        model?: {
+            providerID: string;
+            modelID: string;
+            name: string;
+            contextLimit: number;
+        };
+        reported: {
+            input: number;
+            output: number;
+            reasoning: number;
+            cacheRead: number;
+            cacheWrite: number;
+            total: number;
+        };
+        sources: Array<{
+            id: string;
+            category: "system" | "instructions" | "skills" | "mcp" | "tools" | "agents" | "messages";
+            label: string;
+            detail?: string;
+            tokens: number;
+            enabled: boolean;
+            togglable: boolean;
+            toggleKind?: "mcp" | "skill" | "instruction" | "tool";
+            toggleKey?: string;
+        }>;
+        estimatedTotal: number;
+    };
+};
+export type SessionContextResponse = SessionContextResponses[keyof SessionContextResponses];
+export type SessionContextToggleData = {
+    body?: {
+        kind: "mcp" | "skill" | "instruction" | "tool";
+        key: string;
+        enabled: boolean;
+    };
+    path: {
+        sessionID: string;
+    };
+    query?: {
+        directory?: string;
+        workspace?: string;
+    };
+    url: "/session/{sessionID}/context/toggle";
+};
+export type SessionContextToggleErrors = {
+    /**
+     * Bad request
+     */
+    400: BadRequestError;
+    /**
+     * Not found
+     */
+    404: NotFoundError;
+};
+export type SessionContextToggleError = SessionContextToggleErrors[keyof SessionContextToggleErrors];
+export type SessionContextToggleResponses = {
+    /**
+     * Updated context usage breakdown
+     */
+    200: {
+        model?: {
+            providerID: string;
+            modelID: string;
+            name: string;
+            contextLimit: number;
+        };
+        reported: {
+            input: number;
+            output: number;
+            reasoning: number;
+            cacheRead: number;
+            cacheWrite: number;
+            total: number;
+        };
+        sources: Array<{
+            id: string;
+            category: "system" | "instructions" | "skills" | "mcp" | "tools" | "agents" | "messages";
+            label: string;
+            detail?: string;
+            tokens: number;
+            enabled: boolean;
+            togglable: boolean;
+            toggleKind?: "mcp" | "skill" | "instruction" | "tool";
+            toggleKey?: string;
+        }>;
+        estimatedTotal: number;
+    };
+};
+export type SessionContextToggleResponse = SessionContextToggleResponses[keyof SessionContextToggleResponses];
 export type SessionChildrenData = {
     body?: never;
     path: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@nikcli-ai/sdk",
-  "version": "1.39.0",
+  "version": "1.41.0",
   "type": "module",
   "license": "MIT",
   "scripts": {