@dotcraft/sdk 0.8.9 → 0.9.1

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.
@@ -395,9 +395,11 @@ export interface AppBindingRequestedNotification {
395
395
  }
396
396
  export interface AppBindingToolCapability {
397
397
  annotations?: JsonValue;
398
+ description?: string;
398
399
  inputSchema?: JsonValue;
399
- name?: string;
400
- namespace?: string;
400
+ namespaceDescription?: string | null;
401
+ outputSchema?: JsonValue;
402
+ sourceToolName?: string;
401
403
  ui?: AppBindingUiCapability | null;
402
404
  visibility?: string[];
403
405
  [key: string]: unknown;
@@ -672,58 +674,6 @@ export interface ApprovalShellDetails {
672
674
  remembersExactCommand: boolean;
673
675
  [key: string]: unknown;
674
676
  }
675
- export interface AuthOpenAiAuthorizeUrlNotification {
676
- callbackPort?: number;
677
- url?: string;
678
- [key: string]: unknown;
679
- }
680
- export interface AuthOpenAiLoginParams {
681
- openBrowser?: boolean | null;
682
- providerId?: string | null;
683
- [key: string]: unknown;
684
- }
685
- export interface AuthOpenAiLogoutParams {
686
- providerId?: string | null;
687
- [key: string]: unknown;
688
- }
689
- export interface AuthOpenAiStatusParams {
690
- includeToken?: boolean;
691
- refreshToken?: boolean;
692
- [key: string]: unknown;
693
- }
694
- export interface AuthOpenAiStatusResult {
695
- accessTokenExpiresAt?: string | null;
696
- accountId?: string | null;
697
- authToken?: string;
698
- email?: string | null;
699
- lastRefresh?: string | null;
700
- loggedIn?: boolean;
701
- planType?: string | null;
702
- providerId?: string | null;
703
- [key: string]: unknown;
704
- }
705
- export interface AuthOpenAiUsageCredits {
706
- balance?: string | null;
707
- hasCredits?: boolean;
708
- unlimited?: boolean;
709
- [key: string]: unknown;
710
- }
711
- export interface AuthOpenAiUsageResult {
712
- available?: boolean;
713
- credits?: AuthOpenAiUsageCredits | null;
714
- fetchedAt?: string | null;
715
- limitReachedKind?: string | null;
716
- planType?: string | null;
717
- primary?: AuthOpenAiUsageWindow | null;
718
- secondary?: AuthOpenAiUsageWindow | null;
719
- [key: string]: unknown;
720
- }
721
- export interface AuthOpenAiUsageWindow {
722
- resetAt?: string;
723
- usedPercent?: number;
724
- windowSeconds?: number;
725
- [key: string]: unknown;
726
- }
727
677
  export interface AutomationCreateParams {
728
678
  automation: AutomationInput;
729
679
  [key: string]: unknown;
@@ -774,6 +724,8 @@ export interface AutomationListResult {
774
724
  }
775
725
  export interface AutomationOrigin {
776
726
  channel: string;
727
+ chatKind?: string | null;
728
+ chatLabel?: string | null;
777
729
  deliveryTarget?: string | null;
778
730
  groupId?: string | null;
779
731
  userId: string;
@@ -894,8 +846,8 @@ export interface BrowserUseCapability {
894
846
  export interface ChannelAdapterCapability {
895
847
  channelName: string;
896
848
  channelTools?: ChannelToolDescriptor[] | null;
897
- deliveryCapabilities?: ChannelDeliveryCapabilities | null;
898
- deliverySupport?: boolean | null;
849
+ deliveryCapabilities: ChannelDeliveryCapabilities;
850
+ displayName: string;
899
851
  [key: string]: unknown;
900
852
  }
901
853
  export interface ChannelBindingAcceptParams {
@@ -924,9 +876,16 @@ export interface ChannelBoundBy {
924
876
  platformUserId?: string;
925
877
  [key: string]: unknown;
926
878
  }
879
+ export interface ChannelChat {
880
+ kind: string;
881
+ label?: string | null;
882
+ membership: string;
883
+ [key: string]: unknown;
884
+ }
927
885
  export interface ChannelDeliveryCapabilities {
928
886
  media?: ChannelMediaCapabilitySet | null;
929
- structuredDelivery?: boolean | null;
887
+ targets: ChannelTargetCapability;
888
+ text: ChannelTextCapability;
930
889
  [key: string]: unknown;
931
890
  }
932
891
  export interface ChannelInfo {
@@ -995,6 +954,15 @@ export interface ChannelTarget {
995
954
  displayName?: string | null;
996
955
  [key: string]: unknown;
997
956
  }
957
+ export interface ChannelTargetCapability {
958
+ direct: string;
959
+ group: boolean;
960
+ [key: string]: unknown;
961
+ }
962
+ export interface ChannelTextCapability {
963
+ format: string;
964
+ [key: string]: unknown;
965
+ }
998
966
  export interface ChannelToolApprovalDescriptor {
999
967
  kind: string;
1000
968
  operation?: string | null;
@@ -1029,6 +997,7 @@ export interface ClientCapabilities {
1029
997
  mcpElicitation?: boolean | null;
1030
998
  nodeRepl?: NodeReplCapability | null;
1031
999
  optOutNotificationMethods?: string[] | null;
1000
+ remoteHost?: boolean | null;
1032
1001
  requestUserInputSupport?: boolean | null;
1033
1002
  streamingSupport?: boolean | null;
1034
1003
  toolExecutionLifecycle?: boolean | null;
@@ -1041,6 +1010,11 @@ export interface ClientInfo {
1041
1010
  version: string;
1042
1011
  [key: string]: unknown;
1043
1012
  }
1013
+ export interface CommandChoice {
1014
+ command?: string;
1015
+ label?: string;
1016
+ [key: string]: unknown;
1017
+ }
1044
1018
  export interface CommandExecParams {
1045
1019
  command: string[];
1046
1020
  cwd?: string;
@@ -1063,13 +1037,11 @@ export interface CommandExecuteParams {
1063
1037
  [key: string]: unknown;
1064
1038
  }
1065
1039
  export interface CommandExecuteResult {
1066
- archivedThreadIds?: string[] | null;
1067
- createdLazily?: boolean | null;
1040
+ choices?: CommandChoice[] | null;
1068
1041
  expandedPrompt?: string | null;
1069
1042
  handled?: boolean;
1070
1043
  isMarkdown?: boolean;
1071
1044
  message?: string | null;
1072
- sessionReset?: boolean;
1073
1045
  thread?: SessionThread | null;
1074
1046
  [key: string]: unknown;
1075
1047
  }
@@ -1368,6 +1340,7 @@ export interface ErrorPayload {
1368
1340
  [key: string]: unknown;
1369
1341
  }
1370
1342
  export interface ExtChannelSendParams {
1343
+ deliveryId?: string;
1371
1344
  message?: ChannelOutboundMessage;
1372
1345
  metadata?: JsonValue;
1373
1346
  target?: string;
@@ -1838,6 +1811,7 @@ export interface MarketplaceFailure {
1838
1811
  export interface MarketplaceInfo {
1839
1812
  displayName?: string | null;
1840
1813
  lastUpdated?: string | null;
1814
+ marketplacePath?: string | null;
1841
1815
  name?: string;
1842
1816
  pluginIds?: string[];
1843
1817
  ref?: string | null;
@@ -2632,6 +2606,124 @@ export interface ProfileInsightsResult {
2632
2606
  totalThreads?: number;
2633
2607
  [key: string]: unknown;
2634
2608
  }
2609
+ export interface ProviderAuthChoice {
2610
+ id: string;
2611
+ label: string;
2612
+ [key: string]: unknown;
2613
+ }
2614
+ export interface ProviderAuthEvent {
2615
+ kind: string;
2616
+ message?: string | null;
2617
+ url?: string | null;
2618
+ userCode?: string | null;
2619
+ [key: string]: unknown;
2620
+ }
2621
+ export interface ProviderAuthInputParams {
2622
+ loginId: string;
2623
+ promptId: string;
2624
+ value: string;
2625
+ [key: string]: unknown;
2626
+ }
2627
+ export interface ProviderAuthInstanceParams {
2628
+ providerId: string;
2629
+ [key: string]: unknown;
2630
+ }
2631
+ export interface ProviderAuthLoginParams {
2632
+ method?: string | null;
2633
+ providerId: string;
2634
+ [key: string]: unknown;
2635
+ }
2636
+ export interface ProviderAuthLoginState {
2637
+ authentication?: ProviderAuthStatusResult | null;
2638
+ errorCode?: string | null;
2639
+ errorMessage?: string | null;
2640
+ event?: ProviderAuthEvent | null;
2641
+ loginId: string;
2642
+ prompt?: ProviderAuthPrompt | null;
2643
+ promptId?: string | null;
2644
+ providerId: string;
2645
+ revision: number;
2646
+ status: string;
2647
+ [key: string]: unknown;
2648
+ }
2649
+ export interface ProviderAuthOperationParams {
2650
+ loginId: string;
2651
+ [key: string]: unknown;
2652
+ }
2653
+ export interface ProviderAuthPrompt {
2654
+ choices?: ProviderAuthChoice[] | null;
2655
+ kind: string;
2656
+ message: string;
2657
+ [key: string]: unknown;
2658
+ }
2659
+ export interface ProviderAuthStatusParams {
2660
+ includeToken?: boolean;
2661
+ providerId: string;
2662
+ refreshToken?: boolean;
2663
+ [key: string]: unknown;
2664
+ }
2665
+ export interface ProviderAuthStatusResult {
2666
+ accountId?: string | null;
2667
+ authToken?: string | null;
2668
+ displayName?: string | null;
2669
+ email?: string | null;
2670
+ failureCode?: string | null;
2671
+ failureMessage?: string | null;
2672
+ isAuthenticated: boolean;
2673
+ planType?: string | null;
2674
+ [key: string]: unknown;
2675
+ }
2676
+ export interface ProviderAuthUsageCredits {
2677
+ balance?: string | null;
2678
+ hasCredits: boolean;
2679
+ unlimited: boolean;
2680
+ [key: string]: unknown;
2681
+ }
2682
+ export interface ProviderAuthUsageResult {
2683
+ available: boolean;
2684
+ credits?: ProviderAuthUsageCredits | null;
2685
+ fetchedAt?: string | null;
2686
+ limitReachedKind?: string | null;
2687
+ planType?: string | null;
2688
+ primary?: ProviderAuthUsageWindow | null;
2689
+ secondary?: ProviderAuthUsageWindow | null;
2690
+ [key: string]: unknown;
2691
+ }
2692
+ export interface ProviderAuthUsageUpdatedNotification {
2693
+ available: boolean;
2694
+ credits?: ProviderAuthUsageCredits | null;
2695
+ fetchedAt?: string | null;
2696
+ limitReachedKind?: string | null;
2697
+ planType?: string | null;
2698
+ primary?: ProviderAuthUsageWindow | null;
2699
+ providerId: string;
2700
+ secondary?: ProviderAuthUsageWindow | null;
2701
+ [key: string]: unknown;
2702
+ }
2703
+ export interface ProviderAuthUsageWindow {
2704
+ resetAt: string;
2705
+ usedPercent: number;
2706
+ windowSeconds: number;
2707
+ [key: string]: unknown;
2708
+ }
2709
+ export interface ProviderAuthenticationMethodInfo {
2710
+ displayName: string;
2711
+ id: string;
2712
+ kind: string;
2713
+ [key: string]: unknown;
2714
+ }
2715
+ export interface ProviderBackendInfo {
2716
+ authenticationMethods: ProviderAuthenticationMethodInfo[];
2717
+ defaultProtocol: string;
2718
+ displayName: string;
2719
+ id: string;
2720
+ protocols: string[];
2721
+ [key: string]: unknown;
2722
+ }
2723
+ export interface ProviderBackendListResult {
2724
+ backends: ProviderBackendInfo[];
2725
+ [key: string]: unknown;
2726
+ }
2635
2727
  export interface ProviderCapabilities {
2636
2728
  cachedInputUsageReporting?: boolean;
2637
2729
  extendedThinking?: boolean;
@@ -2646,34 +2738,11 @@ export interface ProviderCapabilities {
2646
2738
  toolChoiceControls?: boolean;
2647
2739
  [key: string]: unknown;
2648
2740
  }
2649
- export interface ProviderCreateParams {
2650
- apiKey?: string;
2651
- authMethod?: string | null;
2652
- displayName?: string;
2653
- endPoint?: string;
2654
- id?: string;
2655
- maxOutputTokens?: number | null;
2656
- networkTimeoutSeconds?: number | null;
2657
- protocol?: string;
2658
- streamIdleTimeoutMs?: number | null;
2659
- streamMaxRetries?: number | null;
2660
- supportsImageGeneration?: boolean | null;
2661
- [key: string]: unknown;
2662
- }
2663
- export interface ProviderDeleteParams {
2664
- id?: string;
2665
- [key: string]: unknown;
2666
- }
2667
- export interface ProviderDeleteResult {
2668
- deleted?: boolean;
2669
- [key: string]: unknown;
2670
- }
2671
2741
  export interface ProviderInfo {
2672
2742
  apiKey?: string | null;
2673
2743
  authMethod?: string;
2744
+ backendId?: string;
2674
2745
  capabilities?: ProviderCapabilities;
2675
- chatGptAccountId?: string | null;
2676
- chatGptPlanType?: string | null;
2677
2746
  displayName?: string;
2678
2747
  endPoint?: string;
2679
2748
  hasApiKey?: boolean;
@@ -2686,6 +2755,7 @@ export interface ProviderInfo {
2686
2755
  streamIdleTimeoutMs?: number | null;
2687
2756
  streamMaxRetries?: number | null;
2688
2757
  supportsImageGeneration?: boolean;
2758
+ webSearchBackend?: string;
2689
2759
  [key: string]: unknown;
2690
2760
  }
2691
2761
  export interface ProviderListParams {
@@ -2696,10 +2766,6 @@ export interface ProviderListResult {
2696
2766
  providers?: ProviderInfo[];
2697
2767
  [key: string]: unknown;
2698
2768
  }
2699
- export interface ProviderMutationResult {
2700
- provider?: ProviderInfo;
2701
- [key: string]: unknown;
2702
- }
2703
2769
  export interface ProviderTestParams {
2704
2770
  apiKey?: string | null;
2705
2771
  endPoint?: string | null;
@@ -2720,24 +2786,9 @@ export interface ProviderTestResult {
2720
2786
  success?: boolean;
2721
2787
  [key: string]: unknown;
2722
2788
  }
2723
- export interface ProviderUpdateParams {
2724
- apiKey?: string | null;
2725
- authMethod?: string | null;
2726
- displayName?: string | null;
2727
- endPoint?: string | null;
2728
- id?: string;
2729
- maxOutputTokens?: number | null;
2730
- networkTimeoutSeconds?: number | null;
2731
- protocol?: string | null;
2732
- streamIdleTimeoutMs?: number | null;
2733
- streamMaxRetries?: number | null;
2734
- supportsImageGeneration?: boolean | null;
2735
- [key: string]: unknown;
2736
- }
2737
2789
  export interface QueuedTurnInput {
2738
2790
  clientUserMessageId?: string | null;
2739
2791
  createdAt: string;
2740
- deliveryBindingId?: string | null;
2741
2792
  displayText: string;
2742
2793
  id: string;
2743
2794
  materializedInputParts: InputPart[];
@@ -2875,6 +2926,7 @@ export interface RuntimeDynamicToolNamespace {
2875
2926
  [key: string]: unknown;
2876
2927
  }
2877
2928
  export interface SenderContext {
2929
+ directTarget?: string | null;
2878
2930
  groupId?: string | null;
2879
2931
  senderId: string;
2880
2932
  senderName: string;
@@ -2886,8 +2938,6 @@ export interface ServerCapabilities {
2886
2938
  appBindingVersion?: number;
2887
2939
  appThreadInputEnqueue?: boolean;
2888
2940
  approvalFlow?: boolean;
2889
- authOpenAiOAuth?: boolean;
2890
- authOpenAiUsage?: boolean;
2891
2941
  automations?: boolean;
2892
2942
  backgroundTerminals?: boolean;
2893
2943
  channelStatus?: boolean;
@@ -2993,6 +3043,7 @@ export interface SessionThread {
2993
3043
  effectiveWorkspacePath: string;
2994
3044
  ephemeral: boolean;
2995
3045
  forkedFromId?: string | null;
3046
+ gitInfo?: ThreadGitInfo | null;
2996
3047
  goal?: ThreadGoal | null;
2997
3048
  historyMode: string;
2998
3049
  id: string;
@@ -3396,18 +3447,12 @@ export interface SubAgentProgressNotification {
3396
3447
  [key: string]: unknown;
3397
3448
  }
3398
3449
  export interface SubAgentSettings {
3399
- defaultWaitTimeoutMs?: number;
3400
3450
  externalCliSessionResumeEnabled?: boolean;
3401
- maxWaitTimeoutMs?: number;
3402
- minWaitTimeoutMs?: number;
3403
3451
  providerPreferences?: Record<string, ModelPreference> | null;
3404
3452
  [key: string]: unknown;
3405
3453
  }
3406
3454
  export interface SubAgentSettingsUpdateParams {
3407
- defaultWaitTimeoutMs?: number | null;
3408
3455
  externalCliSessionResumeEnabled?: boolean | null;
3409
- maxWaitTimeoutMs?: number | null;
3410
- minWaitTimeoutMs?: number | null;
3411
3456
  providerPreferences?: Record<string, ModelPreference> | null;
3412
3457
  [key: string]: unknown;
3413
3458
  }
@@ -3725,6 +3770,11 @@ export interface ThreadForkResult {
3725
3770
  thread?: SessionThread;
3726
3771
  [key: string]: unknown;
3727
3772
  }
3773
+ export interface ThreadGitInfo {
3774
+ branch?: string;
3775
+ originUrl?: string;
3776
+ [key: string]: unknown;
3777
+ }
3728
3778
  export interface ThreadGoal {
3729
3779
  createdAt: number;
3730
3780
  objective: string;
@@ -3919,6 +3969,7 @@ export interface ThreadRenamedNotification {
3919
3969
  }
3920
3970
  export interface ThreadResumeParams {
3921
3971
  additionalContext?: Record<string, RuntimeAdditionalContextEntry> | null;
3972
+ chat?: ChannelChat | null;
3922
3973
  cwd?: string | null;
3923
3974
  dynamicTools?: RuntimeDynamicToolDeclaration[] | null;
3924
3975
  runtimeWorkspaceRoots?: string[] | null;
@@ -4004,6 +4055,7 @@ export interface ThreadSpawnEdge {
4004
4055
  }
4005
4056
  export interface ThreadStartParams {
4006
4057
  additionalContext?: Record<string, RuntimeAdditionalContextEntry> | null;
4058
+ chat?: ChannelChat | null;
4007
4059
  config?: ThreadConfiguration | null;
4008
4060
  cwd?: string | null;
4009
4061
  displayName?: string | null;
@@ -4037,6 +4089,7 @@ export interface ThreadSummary {
4037
4089
  displayName?: string | null;
4038
4090
  ephemeral?: boolean | null;
4039
4091
  forkedFromId?: string | null;
4092
+ gitInfo?: ThreadGitInfo;
4040
4093
  goal?: ThreadGoal | null;
4041
4094
  id: string;
4042
4095
  lastActiveAt?: string | null;
@@ -4054,6 +4107,18 @@ export interface ThreadSummary {
4054
4107
  worktree?: ThreadWorktreeInfo | null;
4055
4108
  [key: string]: unknown;
4056
4109
  }
4110
+ export interface ThreadTokenUsage {
4111
+ last?: TokenUsageBreakdown;
4112
+ modelContextWindow?: number | null;
4113
+ total?: TokenUsageBreakdown;
4114
+ [key: string]: unknown;
4115
+ }
4116
+ export interface ThreadTokenUsageUpdatedNotification {
4117
+ threadId?: string;
4118
+ tokenUsage?: ThreadTokenUsage;
4119
+ turnId?: string;
4120
+ [key: string]: unknown;
4121
+ }
4057
4122
  export interface ThreadToolPolicy {
4058
4123
  agentControl?: string | null;
4059
4124
  allow?: string[] | null;
@@ -4138,6 +4203,15 @@ export interface ThreadWorktreeStatus {
4138
4203
  worktree?: ThreadWorktreeInfo;
4139
4204
  [key: string]: unknown;
4140
4205
  }
4206
+ export interface TokenUsageBreakdown {
4207
+ cacheWriteInputTokens?: number;
4208
+ cachedInputTokens?: number;
4209
+ inputTokens?: number;
4210
+ outputTokens?: number;
4211
+ reasoningOutputTokens?: number;
4212
+ totalTokens?: number;
4213
+ [key: string]: unknown;
4214
+ }
4141
4215
  export interface TokenUsageInfo {
4142
4216
  cacheHitRate?: number;
4143
4217
  cacheWriteInputTokens?: number;
@@ -4533,7 +4607,6 @@ export interface UserMessagePayload {
4533
4607
  channelContext?: string | null;
4534
4608
  channelName?: string | null;
4535
4609
  clientUserMessageId?: string | null;
4536
- deliveryBindingId?: string | null;
4537
4610
  deliveryMode?: string | null;
4538
4611
  groupId?: string | null;
4539
4612
  images?: UserMessageImage[] | null;
@@ -4600,6 +4673,25 @@ export interface VisualizationWidgetStateUpdatedNotification {
4600
4673
  widgetState: VisualizationWidgetState | null;
4601
4674
  [key: string]: unknown;
4602
4675
  }
4676
+ export interface WebSearchAction {
4677
+ pattern?: string | null;
4678
+ queries?: string[] | null;
4679
+ query?: string | null;
4680
+ type: string;
4681
+ url?: string | null;
4682
+ [key: string]: unknown;
4683
+ }
4684
+ export interface WebSearchPayload {
4685
+ action: WebSearchAction | null;
4686
+ arguments?: JsonValue;
4687
+ callId: string;
4688
+ errorMessage?: string | null;
4689
+ output?: string | null;
4690
+ query: string;
4691
+ results: JsonValue[] | null;
4692
+ status: string;
4693
+ [key: string]: unknown;
4694
+ }
4603
4695
  export interface WelcomeSuggestionItem {
4604
4696
  prompt?: string;
4605
4697
  reason?: string;