1
>
/*---------------------------------------------------------------------------------------------
session.ts
2
>
* Copyright (c) Microsoft Corporation. All rights reserved.
3
>
* Licensed under the MIT License. See License.txt in the project root for license information.
4
>
*--------------------------------------------------------------------------------------------*/
5
>
6
>
import { CancellationToken } from '../../../../base/common/cancellation.js';
7
>
import { IMarkdownString } from '../../../../base/common/htmlContent.js';
8
>
import { IObservable, IReader } from '../../../../base/common/observable.js';
9
>
import { isEqual } from '../../../../base/common/resources.js';
10
>
import { ThemeIcon } from '../../../../base/common/themables.js';
11
>
import { URI } from '../../../../base/common/uri.js';
12
>
import { localize } from '../../../../nls.js';
13
>
import { IChatSessionFileChange, IChatSessionFileChange2, isIChatSessionFileChange2 } from '../../../../workbench/contrib/chat/common/chatSessionsService.js';
14
>
15
>
export interface ISessionType {
16
>
/** Unique identifier (e.g., 'copilot-cli', 'copilot-cloud', 'claude-code'). */
17
>
readonly id: string;
18
>
/** Display label (e.g., 'Copilot CLI', 'Cloud'). */
19
>
readonly label: string;
20
>
/** Icon for this session type. */
21
>
readonly icon: ThemeIcon;
22
>
/** Whether new sessions of this type support Worktree isolation and base-branch selection. */
23
>
readonly supportsWorktreeConfiguration?: boolean;
24
>
/**
25
>
* The workbench chat session type (contribution id) this session type maps
26
>
* to, when it differs from {@link id}. Agent-host providers use a bare agent
27
>
* provider name as {@link id} (e.g. `claude`) but register their chat session
28
>
* contribution and models under `agent-host-<provider>`, so they set this to
29
>
* bridge the two (e.g. for entitlement/model availability lookups). Defaults
30
>
* to {@link id} when omitted.
31
>
*/
32
>
readonly chatSessionType?: string;
33
>
}
34
>
35
>
export const GITHUB_REMOTE_FILE_SCHEME = 'github-remote-file';
36
>
37
>
/**
38
>
* Status of an agent session as reported by the sessions provider.
39
>
*/
40
>
export const enum SessionStatus {
41
>
/** Session has not been sent yet (new/untitled). */
42
>
Untitled = 0,
43
>
/** Agent is actively working. */
44
>
InProgress = 1,
45
>
/** Agent is waiting for user input. */
46
>
NeedsInput = 2,
47
>
/** Session has completed successfully. */
48
>
Completed = 3,
49
>
/** Session encountered an error. */
50
>
Error = 4,
51
>
}
52
>
53
>
/** Whether a session still has active work, including work blocked on user input. */
54
>
export function isActiveSessionStatus(status: SessionStatus): boolean {
55
return status === SessionStatus.InProgress || status === SessionStatus.NeedsInput;
56
}
58
>
/**
59
>
* Provider-agnostic interactivity of a chat within a session. Mirrors the agent
60
>
* host protocol's notion of chat interactivity but is decoupled from it so that
61
>
* non-agent-host providers can report it too.
62
>
*
63
>
* Supports the agent-team pattern where a lead chat is fully interactive while
64
>
* worker chats are read-only (visible for observability) or hidden (internal
65
>
* implementation detail).
66
>
*/
67
>
export const enum ChatInteractivity {
68
>
/** The user can send messages to the chat (default when unspecified). */
69
>
Full = 'full',
70
>
/** The chat is visible but read-only — the user can watch but not send messages. */
71
>
ReadOnly = 'read-only',
72
>
/** The chat is an internal worker that should not be shown in the UI at all. */
73
>
Hidden = 'hidden',
74
>
}
75
>
76
>
/**
77
>
* The effective interactivity of a chat given its session's archived state.
78
>
*
79
>
* An archived session is read-only: its interactive chats must hide their
80
>
* composer. `Hidden` chats are internal workers filtered out of the UI, so they
81
>
* stay hidden — archiving only downgrades `Full` chats to `ReadOnly`. When not
82
>
* archived, the chat keeps its own interactivity.
83
>
*/
84
>
export function effectiveChatInteractivity(isArchived: boolean, interactivity: ChatInteractivity): ChatInteractivity {
85
if (interactivity === ChatInteractivity.Hidden) {
86
return ChatInteractivity.Hidden;