@codingame/monaco-vscode-api 36.2.7 → 37.1.0

package/vscode/src/vs/platform/agentHost/common/state/sessionState.js

@@ -1,18 +1,301 @@
 
+import { distinct } from '../../../../base/common/arrays.js';
 import { encodeBase64, VSBuffer, decodeBase64 } from '../../../../base/common/buffer.js';
 import { hasKey } from '../../../../base/common/types.js';
 import { URI } from '../../../../base/common/uri.js';
+import { isAgentWorkspaceContinuationMessage } from '../meta/agentWorkspaceContinuationMeta.js';
+import { readLegacyTurnError } from './legacyProtocolCompatibility.js';
 export { PolicyState } from './protocol/channels-root/state.js';
 export { CustomizationLoadStatus, CustomizationType, SessionLifecycle, SessionStatus } from './protocol/channels-session/state.js';
-import { ToolResultContentType } from './protocol/channels-chat/state.js';
-export { ChatInputAnswerState, ChatInputAnswerValueKind, ChatInputQuestionKind, ChatInputResponseKind, ChatOriginKind, MessageAttachmentKind, MessageKind, PendingMessageKind, ResponsePartKind, ChatInputAnswerState as SessionInputAnswerState, ChatInputAnswerValueKind as SessionInputAnswerValueKind, ChatInputQuestionKind as SessionInputQuestionKind, ChatInputResponseKind as SessionInputResponseKind, ToolCallCancellationReason, ToolCallConfirmationReason, ToolCallContributorKind, ToolCallStatus, TurnState } from './protocol/channels-chat/state.js';
+import { ResponsePartKind, MessageKind, ToolResultContentType, ChatInteractivity, TurnState } from './protocol/channels-chat/state.js';
+export { ChatInputAnswerState, ChatInputAnswerValueKind, ChatInputQuestionKind, ChatInputResponseKind, ChatOriginKind, MessageAttachmentKind, PendingMessageKind, ToolCallCancellationReason, ToolCallConfirmationReason, ToolCallContributorKind, ToolCallRiskAssessmentKind, ToolCallRiskAssessmentStatus, ToolCallStatus } from './protocol/channels-chat/state.js';
 import './protocol/channels-terminal/state.js';
 export { ChangesetOperationScope, ChangesetOperationStatus, ChangesetStatus } from './protocol/channels-changeset/state.js';
 import './protocol/channels-resource-watch/state.js';
+import './protocol/channels-automation/state.js';
+import './protocol/channels-automation-run/state.js';
 import './protocol/common/commands.js';
 import './protocol/channels-session/commands.js';
+import './protocol/channels-chat/commands.js';
 export { ChangesetOperationTargetKind } from './protocol/channels-changeset/commands.js';
 
+function getErrorResponsePart(turn) {
+    if (!turn) {
+        return undefined;
+    }
+    const part = turn.responseParts.at(-1);
+    return part?.kind === ResponsePartKind.Error ? part : undefined;
+}
+const AHP_AUTOMATIONS_SCHEME = "ahp-automations";
+const AUTOMATION_CATALOG_URI = `${AHP_AUTOMATIONS_SCHEME}://`;
+function isAhpAutomationCatalogChannel(uri) {
+    if (uri === AUTOMATION_CATALOG_URI) {
+        return true;
+    }
+    try {
+        return URI.parse(uri).scheme === AHP_AUTOMATIONS_SCHEME;
+    } catch {
+        return false;
+    }
+}
+function isAhpAutomationRunChannel(uri) {
+    try {
+        return URI.parse(uri).scheme === "ahp-automation-run";
+    } catch {
+        return false;
+    }
+}
+const MESSAGE_HIDDEN_FROM_TRANSCRIPT_META_KEY = "vscode.chat.hiddenFromTranscript";
+const MESSAGE_HIDDEN_FROM_TRANSCRIPT_PREFIX = "<!-- vscode-hidden-from-transcript -->\n";
+const MESSAGE_REQUEST_HIDDEN_FROM_TRANSCRIPT_META_KEY = "vscode.chat.requestHiddenFromTranscript";
+const MESSAGE_REQUEST_HIDDEN_FROM_TRANSCRIPT_PREFIX = "<!-- vscode-request-hidden-from-transcript -->\n";
+const MESSAGE_SYSTEM_INITIATED_LABEL_META_KEY = "vscode.chat.systemInitiatedLabel";
+function readMessageMeta(message) {
+    const meta = message._meta;
+    const systemInitiatedLabel = meta?.[MESSAGE_SYSTEM_INITIATED_LABEL_META_KEY];
+    const hiddenFromTranscript = meta?.[MESSAGE_HIDDEN_FROM_TRANSCRIPT_META_KEY] === true || message.text.startsWith(MESSAGE_HIDDEN_FROM_TRANSCRIPT_PREFIX);
+    return {
+        hiddenFromTranscript,
+        requestHiddenFromTranscript: meta?.[MESSAGE_REQUEST_HIDDEN_FROM_TRANSCRIPT_META_KEY] === true || message.text.startsWith(MESSAGE_REQUEST_HIDDEN_FROM_TRANSCRIPT_PREFIX),
+        systemInitiatedLabel: typeof systemInitiatedLabel === "string" ? systemInitiatedLabel : undefined
+    };
+}
+function isMessageHiddenFromTranscript(message) {
+    return readMessageMeta(message).hiddenFromTranscript;
+}
+function isMessageRequestHiddenFromTranscript(message) {
+    return readMessageMeta(message).requestHiddenFromTranscript;
+}
+function readMessageSystemInitiatedLabel(message) {
+    return readMessageMeta(message).systemInitiatedLabel;
+}
+function withMessageHiddenFromTranscript(message, hidden) {
+    if (!hidden) {
+        return message;
+    }
+    return {
+        ...message,
+        text: message.text.startsWith(MESSAGE_HIDDEN_FROM_TRANSCRIPT_PREFIX) ? message.text : MESSAGE_HIDDEN_FROM_TRANSCRIPT_PREFIX + message.text,
+        _meta: {
+            ...message._meta,
+            [MESSAGE_HIDDEN_FROM_TRANSCRIPT_META_KEY]: true
+        }
+    };
+}
+function isHostNoticeTurn(turn) {
+    return turn.message.origin.kind === MessageKind.SystemNotification && (isMessageHiddenFromTranscript(turn.message) || isMessageRequestHiddenFromTranscript(turn.message)) && !isAgentWorkspaceContinuationMessage(turn.message);
+}
+function readAccountQuotaSnapshot(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const raw = value;
+    const snapshot = {};
+    if (typeof raw["isUnlimitedEntitlement"] === "boolean") {
+        snapshot.isUnlimitedEntitlement = raw["isUnlimitedEntitlement"];
+    }
+    if (typeof raw["entitlementRequests"] === "number") {
+        snapshot.entitlementRequests = raw["entitlementRequests"];
+    }
+    if (typeof raw["usedRequests"] === "number") {
+        snapshot.usedRequests = raw["usedRequests"];
+    }
+    if (typeof raw["remainingPercentage"] === "number") {
+        snapshot.remainingPercentage = raw["remainingPercentage"];
+    }
+    if (typeof raw["overage"] === "number") {
+        snapshot.overage = raw["overage"];
+    }
+    if (typeof raw["overageAllowedWithExhaustedQuota"] === "boolean") {
+        snapshot.overageAllowedWithExhaustedQuota = raw["overageAllowedWithExhaustedQuota"];
+    }
+    if (typeof raw["resetDate"] === "string") {
+        snapshot.resetDate = raw["resetDate"];
+    }
+    if (typeof raw["tokenBasedBilling"] === "boolean") {
+        snapshot.tokenBasedBilling = raw["tokenBasedBilling"];
+    }
+    if (typeof raw["overageEntitlement"] === "number") {
+        snapshot.overageEntitlement = raw["overageEntitlement"];
+    }
+    return snapshot;
+}
+function readUsageInfoMeta(usage) {
+    const meta = usage?._meta;
+    if (!meta) {
+        return {};
+    }
+    const result = {};
+    if (typeof meta["cost"] === "number") {
+        result.cost = meta["cost"];
+    }
+    const autoModeResolved = readAutoModeResolvedInfo(meta["autoModeResolved"]);
+    if (autoModeResolved) {
+        result.autoModeResolved = autoModeResolved;
+    }
+    const copilotUsage = meta["copilotUsage"];
+    if (copilotUsage && typeof copilotUsage === "object" && !Array.isArray(copilotUsage)) {
+        const rawUsage = copilotUsage;
+        const usage = {};
+        if (typeof rawUsage["totalNanoAiu"] === "number") {
+            usage.totalNanoAiu = rawUsage["totalNanoAiu"];
+        }
+        if (typeof rawUsage["sessionTotalNanoAiu"] === "number") {
+            usage.sessionTotalNanoAiu = rawUsage["sessionTotalNanoAiu"];
+        }
+        result.copilotUsage = usage;
+    }
+    const quotaSnapshots = meta["quotaSnapshots"];
+    if (quotaSnapshots && typeof quotaSnapshots === "object" && !Array.isArray(quotaSnapshots)) {
+        const snapshots = {};
+        for (const [quotaType, value] of Object.entries(quotaSnapshots)) {
+            snapshots[quotaType] = readAccountQuotaSnapshot(value);
+        }
+        result.quotaSnapshots = snapshots;
+    }
+    const contextAttribution = readContextAttribution(meta["contextAttribution"]);
+    if (contextAttribution) {
+        result.contextAttribution = contextAttribution;
+    }
+    const turnTokenTotals = readTurnTokenTotals(meta["turnTokenTotals"]);
+    if (turnTokenTotals) {
+        result.turnTokenTotals = turnTokenTotals;
+    }
+    const directTurnTokenTotals = readTurnTokenTotals(meta["directTurnTokenTotals"]);
+    if (directTurnTokenTotals) {
+        result.directTurnTokenTotals = directTurnTokenTotals;
+    }
+    const directCopilotUsage = meta["directCopilotUsage"];
+    if (directCopilotUsage && typeof directCopilotUsage === "object" && !Array.isArray(directCopilotUsage)) {
+        const totalNanoAiu = directCopilotUsage["totalNanoAiu"];
+        if (typeof totalNanoAiu === "number") {
+            result.directCopilotUsage = {
+                totalNanoAiu
+            };
+        }
+    }
+    return result;
+}
+function readTurnTokenTotals(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const totals = [];
+    for (const item of value) {
+        if (!item || typeof item !== "object" || Array.isArray(item)) {
+            continue;
+        }
+        const raw = item;
+        if (typeof raw["model"] !== "string" || !raw["model"] || !isTokenCount(raw["inputTokens"]) || !isTokenCount(raw["cachedTokens"]) || !isTokenCount(raw["outputTokens"])) {
+            continue;
+        }
+        totals.push({
+            model: raw["model"],
+            inputTokens: raw["inputTokens"],
+            cachedTokens: raw["cachedTokens"],
+            outputTokens: raw["outputTokens"]
+        });
+    }
+    return totals.length > 0 ? totals : undefined;
+}
+function isTokenCount(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function hasReportedUsage(usage) {
+    if (!usage) {
+        return false;
+    }
+    if (typeof usage.inputTokens === "number" || typeof usage.outputTokens === "number") {
+        return true;
+    }
+    const meta = readUsageInfoMeta(usage);
+    return (
+        (typeof meta.copilotUsage?.totalNanoAiu === "number" && meta.copilotUsage.totalNanoAiu >= 0) || (typeof meta.copilotUsage?.sessionTotalNanoAiu === "number" && meta.copilotUsage.sessionTotalNanoAiu >= 0) || (typeof meta.cost === "number" && meta.cost >= 0)
+    );
+}
+function readAutoModeResolvedInfo(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const raw = value;
+    if (typeof raw["chosenModel"] !== "string") {
+        return undefined;
+    }
+    const result = {
+        chosenModel: raw["chosenModel"]
+    };
+    const reasoningBucket = raw["reasoningBucket"];
+    if (reasoningBucket === "low" || reasoningBucket === "medium" || reasoningBucket === "high") {
+        result.reasoningBucket = reasoningBucket;
+    }
+    const categoryScores = raw["categoryScores"];
+    if (categoryScores && typeof categoryScores === "object" && !Array.isArray(categoryScores)) {
+        const scores = {};
+        for (const [category, score] of Object.entries(categoryScores)) {
+            if (typeof score === "number") {
+                scores[category] = score;
+            }
+        }
+        result.categoryScores = scores;
+    }
+    if (typeof raw["predictedLabel"] === "string") {
+        result.predictedLabel = raw["predictedLabel"];
+    }
+    if (typeof raw["confidence"] === "number") {
+        result.confidence = raw["confidence"];
+    }
+    if (Array.isArray(raw["candidateModels"]) && raw["candidateModels"].every(candidate => typeof candidate === "string")) {
+        result.candidateModels = raw["candidateModels"];
+    }
+    return result;
+}
+function readContextAttribution(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const raw = value;
+    if (typeof raw["totalTokens"] !== "number" || !Array.isArray(raw["entries"])) {
+        return undefined;
+    }
+    const entries = [];
+    for (const item of raw["entries"]) {
+        if (!item || typeof item !== "object" || Array.isArray(item)) {
+            continue;
+        }
+        const entry = item;
+        if (typeof entry["kind"] !== "string" || typeof entry["id"] !== "string" || typeof entry["label"] !== "string" || typeof entry["tokens"] !== "number") {
+            continue;
+        }
+        entries.push({
+            kind: entry["kind"],
+            id: entry["id"],
+            label: entry["label"],
+            tokens: entry["tokens"],
+            parentId: typeof entry["parentId"] === "string" ? entry["parentId"] : undefined,
+            attributes: entry["attributes"] && typeof entry["attributes"] === "object" && !Array.isArray(entry["attributes"]) ? filterStringAttributes(entry["attributes"]) : undefined
+        });
+    }
+    const compactionsRaw = raw["compactions"];
+    const compactions = compactionsRaw && typeof compactionsRaw === "object" && !Array.isArray(compactionsRaw) && typeof compactionsRaw["count"] === "number" ? {
+        count: compactionsRaw["count"]
+    } : {
+        count: 0
+    };
+    return {
+        totalTokens: raw["totalTokens"],
+        entries,
+        compactions
+    };
+}
+function filterStringAttributes(raw) {
+    const result = {};
+    for (const [key, value] of Object.entries(raw)) {
+        if (typeof value === "string" || value === undefined) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
 var FileEditKind;
 (function(FileEditKind) {
     FileEditKind["Edit"] = "edit";
@@ -37,6 +320,26 @@ function customizationId(uri, range) {
         return uri;
     }
 }
+function getToolOutputText(result) {
+    if (!result.content || result.content.length === 0) {
+        return undefined;
+    }
+    const textParts = [];
+    for (const c of result.content) {
+        if (hasKey(c, {
+            type: true
+        }) && c.type === ToolResultContentType.Text) {
+            textParts.push(c);
+        }
+    }
+    if (textParts.length === 0) {
+        return undefined;
+    }
+    return ( textParts.map(p => p.text)).join("\n");
+}
+function getInlineToolInput(toolInput) {
+    return typeof toolInput === "string" ? toolInput : undefined;
+}
 function getToolFileEdits(result) {
     if (!result.content || result.content.length === 0) {
         return [];
@@ -51,6 +354,38 @@ function getToolFileEdits(result) {
     }
     return edits;
 }
+function getToolSubagentContent(result) {
+    if (!result.content || result.content.length === 0) {
+        return undefined;
+    }
+    for (const c of result.content) {
+        if (hasKey(c, {
+            type: true
+        }) && c.type === ToolResultContentType.Subagent) {
+            return c;
+        }
+    }
+    return undefined;
+}
+function effectiveChatInteractivity(interactivity, sessionArchived) {
+    if (interactivity === ChatInteractivity.Hidden) {
+        return ChatInteractivity.Hidden;
+    }
+    if (sessionArchived) {
+        return ChatInteractivity.ReadOnly;
+    }
+    return interactivity ?? ChatInteractivity.Full;
+}
+function isChatReadOnly(interactivity, sessionArchived) {
+    return effectiveChatInteractivity(interactivity, sessionArchived) === ChatInteractivity.ReadOnly;
+}
+function getTurnError(turn) {
+    if (turn?.state !== TurnState.Error) {
+        return undefined;
+    }
+    const part = turn.responseParts[turn.responseParts.length - 1];
+    return part?.kind === ResponsePartKind.Error ? part.error : readLegacyTurnError(turn);
+}
 var StateComponents;
 (function(StateComponents) {
     StateComponents[StateComponents["Root"] = 0] = "Root";
@@ -59,6 +394,8 @@ var StateComponents;
     StateComponents[StateComponents["Terminal"] = 3] = "Terminal";
     StateComponents[StateComponents["Changeset"] = 4] = "Changeset";
     StateComponents[StateComponents["Annotations"] = 5] = "Annotations";
+    StateComponents[StateComponents["AutomationCatalog"] = 6] = "AutomationCatalog";
+    StateComponents[StateComponents["AutomationRun"] = 7] = "AutomationRun";
 })(StateComponents || (StateComponents = {}));
 const AHP_CHAT_SCHEME = "ahp-chat";
 const DEFAULT_CHAT_ID = "default";
@@ -71,6 +408,10 @@ function buildDefaultChatUri(sessionUri) {
     return buildChatUri(sessionUri, DEFAULT_CHAT_ID);
 }
 const SUBAGENT_CHAT_ID = "subagent";
+function isSubagentChatUri(uri) {
+    const parsed = typeof uri === "string" ? URI.parse(uri) : uri;
+    return parsed.scheme === AHP_CHAT_SCHEME && parsed.authority === SUBAGENT_CHAT_ID;
+}
 function buildSubagentChatUri(sessionUri, toolCallId) {
     const session = typeof sessionUri === "string" ? sessionUri : ( sessionUri.toString());
     const encoded = encodeBase64(VSBuffer.fromString(session), false, true);
@@ -120,5 +461,199 @@ function parseRequiredSessionUriFromChatUri(uri) {
     }
     return session;
 }
+function isDefaultChatUri(uri) {
+    return parseChatUri(uri)?.chatId === DEFAULT_CHAT_ID;
+}
+function getSessionChatResource(state, chatId) {
+    return chatId === DEFAULT_CHAT_ID ? state.defaultChat ?? state.chats.find(chat => isDefaultChatUri(chat.resource))?.resource : state.chats.find(chat => parseChatUri(chat.resource)?.chatId === chatId)?.resource;
+}
+function isAhpChatChannel(uri) {
+    try {
+        return URI.parse(uri).scheme === AHP_CHAT_SCHEME;
+    } catch {
+        return false;
+    }
+}
+function mergeSessionWithDefaultChat(session, chat) {
+    return {
+        ...session,
+        workingDirectories: chat?.workingDirectories ?? session.workingDirectories,
+        turns: chat?.turns ?? [],
+        activeTurn: chat?.activeTurn,
+        steeringMessage: chat?.steeringMessage,
+        queuedMessages: chat?.queuedMessages,
+        draft: chat?.draft
+    };
+}
+const SESSION_META_GITHUB_KEY = "github";
+const SESSION_META_PROMPT_CACHE_KEY = "vscode.promptCache";
+const SESSION_META_MULTI_ROOT_KEY = "multiRoot";
+const MAX_WORKSPACE_FILE_LENGTH = 4096;
+function readSessionMultiRootMetadata(meta) {
+    return validateSessionMultiRootMetadata(meta?.[SESSION_META_MULTI_ROOT_KEY]);
+}
+function withSessionMultiRootMetadata(meta, multiRoot) {
+    const next = {
+        ...meta
+    };
+    if (multiRoot) {
+        next[SESSION_META_MULTI_ROOT_KEY] = multiRoot;
+    } else {
+        delete next[SESSION_META_MULTI_ROOT_KEY];
+    }
+    return ( Object.keys(next)).length > 0 ? next : undefined;
+}
+function validateSessionMultiRootMetadata(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const raw = value;
+    if (typeof raw.workspaceFile !== "string" || raw.workspaceFile.length === 0 || raw.workspaceFile.length > MAX_WORKSPACE_FILE_LENGTH) {
+        return undefined;
+    }
+    try {
+        if (!URI.parse(raw.workspaceFile, true).scheme) {
+            return undefined;
+        }
+    } catch {
+        return undefined;
+    }
+    return {
+        workspaceFile: raw.workspaceFile
+    };
+}
+function readSessionPromptCacheState(meta) {
+    const value = meta?.[SESSION_META_PROMPT_CACHE_KEY];
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const raw = value;
+    return typeof raw["modelId"] === "string" && typeof raw["cacheExpiresAt"] === "string" ? {
+        modelId: raw["modelId"],
+        cacheExpiresAt: raw["cacheExpiresAt"]
+    } : undefined;
+}
+const SESSION_META_FOLDER_PICKER_KEY = "vscode.folderPicker";
+function readSessionFolderPickerDecision(meta) {
+    return validateSessionFolderPickerDecision(meta?.[SESSION_META_FOLDER_PICKER_KEY]);
+}
+function validateSessionFolderPickerDecision(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const raw = value;
+    if (typeof raw["hidden"] !== "boolean") {
+        return undefined;
+    }
+    const primary = raw["primary"];
+    if (primary !== undefined && (typeof primary !== "string" || primary.length === 0 || raw["hidden"] !== true)) {
+        return undefined;
+    }
+    return primary !== undefined ? {
+        hidden: true,
+        primary
+    } : {
+        hidden: raw["hidden"]
+    };
+}
+function withSessionFolderPickerDecision(meta, decision) {
+    const next = {
+        ...meta
+    };
+    if (decision) {
+        next[SESSION_META_FOLDER_PICKER_KEY] = decision.primary !== undefined ? {
+            hidden: decision.hidden,
+            primary: decision.primary
+        } : {
+            hidden: decision.hidden
+        };
+    } else {
+        delete next[SESSION_META_FOLDER_PICKER_KEY];
+    }
+    return ( Object.keys(next)).length > 0 ? next : undefined;
+}
+var SessionSourceControlOutcome;
+(function(SessionSourceControlOutcome) {
+    SessionSourceControlOutcome["Merge"] = "merge";
+    SessionSourceControlOutcome["PullRequest"] = "pullRequest";
+})(SessionSourceControlOutcome || (SessionSourceControlOutcome = {}));
+function getSessionRelatedPullRequestUrls(gitHubState) {
+    const pullRequestUrls = gitHubState?.pullRequestUrls ?? [];
+    const initialPullRequestUrls = gitHubState?.initialPullRequestUrls;
+    const initialUrls = ( new Set(initialPullRequestUrls?.map(url => url.toLowerCase()) ?? []));
+    const associatedUrls = ( new Set(
+        gitHubState?.associatedPullRequestUrls?.map(url => url.toLowerCase()) ?? []
+    ));
+    return pullRequestUrls.filter(url => !( initialUrls.has(url.toLowerCase())) || ( associatedUrls.has(url.toLowerCase())));
+}
+const MAX_SESSION_PULL_REQUEST_REFERENCES = 10;
+function getSessionPullRequestUrlKey(url) {
+    return url.trim().replace(/\/+$/, "").toLowerCase();
+}
+function normalizeSessionPullRequestUrls(urls) {
+    const normalizedUrls = ( urls.map(url => {
+        const match = /^https:\/\/(?<host>[^/]+)\/(?<owner>[^/]+)\/(?<repo>[^/]+)\/pull\/(?<number>\d+)\/?$/.exec(url);
+        const groups = match?.groups;
+        return groups ? `https://${groups["host"].toLowerCase()}/${groups["owner"]}/${groups["repo"]}/pull/${groups["number"]}` : url;
+    }));
+    return distinct(normalizedUrls, getSessionPullRequestUrlKey).slice(0, MAX_SESSION_PULL_REQUEST_REFERENCES);
+}
+function readSessionGitHubState(meta) {
+    const value = meta?.[SESSION_META_GITHUB_KEY];
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const raw = value;
+    const result = {};
+    if (typeof raw["owner"] === "string") {
+        result.owner = raw["owner"];
+    }
+    if (typeof raw["repo"] === "string") {
+        result.repo = raw["repo"];
+    }
+    const pullRequestUrls = Array.isArray(raw["pullRequestUrls"]) ? raw["pullRequestUrls"].filter(url => typeof url === "string") : typeof raw["pullRequestUrl"] === "string" ? [raw["pullRequestUrl"]] : [];
+    if (pullRequestUrls.length > 0) {
+        result.pullRequestUrls = normalizeSessionPullRequestUrls(pullRequestUrls);
+    }
+    if (Array.isArray(raw["initialPullRequestUrls"])) {
+        result.initialPullRequestUrls = normalizeSessionPullRequestUrls(raw["initialPullRequestUrls"].filter(url => typeof url === "string"));
+    }
+    if (Array.isArray(raw["associatedPullRequestUrls"])) {
+        const associatedPullRequestUrls = normalizeSessionPullRequestUrls(raw["associatedPullRequestUrls"].filter(url => typeof url === "string"));
+        if (associatedPullRequestUrls.length > 0) {
+            result.associatedPullRequestUrls = associatedPullRequestUrls;
+        }
+    }
+    if (raw["pullRequestState"] === "open" || raw["pullRequestState"] === "closed" || raw["pullRequestState"] === "merged") {
+        result.pullRequestState = raw["pullRequestState"];
+    }
+    if (typeof raw["pullRequestStateUrl"] === "string") {
+        result.pullRequestStateUrl = raw["pullRequestStateUrl"];
+    }
+    if (typeof raw["pullRequestBranchName"] === "string") {
+        result.pullRequestBranchName = raw["pullRequestBranchName"];
+    }
+    return result;
+}
+const SESSION_META_WORKSPACELESS_KEY = "workspaceless";
+function readSessionWorkspaceless(meta) {
+    return meta?.[SESSION_META_WORKSPACELESS_KEY] === true;
+}
+const SESSION_META_EHCLI_ADOPTABLE_KEY = "ehcliAdoptable";
+function readSessionEhcliAdoptable(meta) {
+    return meta?.[SESSION_META_EHCLI_ADOPTABLE_KEY] === true;
+}
+const SESSION_META_EHCLI_ADOPTED_KEY = "ehcliAdopted";
+function readSessionEhcliAdopted(meta) {
+    return meta?.[SESSION_META_EHCLI_ADOPTED_KEY] === true;
+}
+const SESSION_META_EHCLI_LAST_TURN_KEY = "ehcliLastMigratedTurn";
+function readSessionEhcliLastMigratedTurn(meta) {
+    const value = meta?.[SESSION_META_EHCLI_LAST_TURN_KEY];
+    return typeof value === "string" && value ? value : undefined;
+}
+function readSessionMatchesByProjectRoot(meta) {
+    return readSessionEhcliAdoptable(meta) || readSessionEhcliAdopted(meta);
+}
 
-export { AHP_CHAT_SCHEME, AHP_ROOT_SCHEME, DEFAULT_CHAT_ID, FileEditKind, ROOT_STATE_URI, StateComponents, ToolResultContentType, buildChatUri, buildDefaultChatUri, buildSubagentChatUri, customizationId, getToolFileEdits, isAhpRootChannel, parseChatUri, parseDefaultChatUri, parseRequiredSessionUriFromChatUri };
+export { AHP_AUTOMATIONS_SCHEME, AHP_CHAT_SCHEME, AHP_ROOT_SCHEME, AUTOMATION_CATALOG_URI, ChatInteractivity, DEFAULT_CHAT_ID, FileEditKind, MAX_SESSION_PULL_REQUEST_REFERENCES, MessageKind, ROOT_STATE_URI, ResponsePartKind, SESSION_META_EHCLI_ADOPTABLE_KEY, SESSION_META_EHCLI_ADOPTED_KEY, SESSION_META_EHCLI_LAST_TURN_KEY, SESSION_META_FOLDER_PICKER_KEY, SESSION_META_GITHUB_KEY, SESSION_META_MULTI_ROOT_KEY, SESSION_META_PROMPT_CACHE_KEY, SESSION_META_WORKSPACELESS_KEY, SessionSourceControlOutcome, StateComponents, ToolResultContentType, TurnState, buildChatUri, buildDefaultChatUri, buildSubagentChatUri, customizationId, effectiveChatInteractivity, getErrorResponsePart, getInlineToolInput, getSessionChatResource, getSessionPullRequestUrlKey, getSessionRelatedPullRequestUrls, getToolFileEdits, getToolOutputText, getToolSubagentContent, getTurnError, hasReportedUsage, isAhpAutomationCatalogChannel, isAhpAutomationRunChannel, isAhpChatChannel, isAhpRootChannel, isChatReadOnly, isDefaultChatUri, isHostNoticeTurn, isMessageHiddenFromTranscript, isMessageRequestHiddenFromTranscript, isSubagentChatUri, mergeSessionWithDefaultChat, parseChatUri, parseDefaultChatUri, parseRequiredSessionUriFromChatUri, readMessageSystemInitiatedLabel, readSessionEhcliAdoptable, readSessionEhcliAdopted, readSessionEhcliLastMigratedTurn, readSessionFolderPickerDecision, readSessionGitHubState, readSessionMatchesByProjectRoot, readSessionMultiRootMetadata, readSessionPromptCacheState, readSessionWorkspaceless, readUsageInfoMeta, withMessageHiddenFromTranscript, withSessionFolderPickerDecision, withSessionMultiRootMetadata };

package/vscode/src/vs/platform/agentHost/common/state/sessionTransport.d.ts

@@ -0,0 +1,57 @@
+import { Event } from "../../../../base/common/event.js";
+import { IDisposable } from "../../../../base/common/lifecycle.js";
+import type { AgentHostClientConnectionKind, AgentHostTransportKind } from "../agentHostTelemetry.js";
+import type { ProtocolMessage, AhpServerNotification, JsonRpcNotification, JsonRpcParseErrorResponse, JsonRpcResponse, JsonRpcRequest } from "./sessionProtocol.js";
+/** Machine-readable reasons a transport cannot be reconnected. */
+export declare enum AgentHostTransportFailureReason {
+    Unknown = "unknown",
+    HostNotRunning = "hostNotRunning"
+}
+/** Signals that reconnecting the transport cannot recover the connection. */
+export declare class NonReconnectableTransportError extends Error {
+    readonly reason: AgentHostTransportFailureReason;
+    constructor(message: string, reason?: AgentHostTransportFailureReason);
+}
+/**
+ * A bidirectional transport for protocol messages. Implementations handle
+ * serialization, framing, and connection management.
+ */
+export interface IProtocolTransport extends IDisposable {
+    /** Physical transport accepted by the agent host. */
+    readonly transportKind?: AgentHostTransportKind;
+    /** Route used by a VS Code client to reach the agent host. */
+    readonly clientConnectionKind?: AgentHostClientConnectionKind;
+    /** Fires when a message is received from the remote end. */
+    readonly onMessage: Event<ProtocolMessage>;
+    /** Fires when the transport connection closes. */
+    readonly onClose: Event<void>;
+    /**
+     * Send a message to the remote end.
+     *
+     * Accepts:
+     * - `ProtocolMessage` — fully-typed client↔server messages.
+     * - `AhpServerNotification` — server→client notifications.
+     * - `JsonRpcResponse` — dynamically-constructed success/error responses.
+     */
+    send(message: ProtocolMessage | AhpServerNotification | JsonRpcNotification | JsonRpcParseErrorResponse | JsonRpcResponse | JsonRpcRequest): void;
+}
+/**
+ * A client-side transport that requires an explicit connection step
+ * before messages can be exchanged.
+ */
+export interface IClientTransport extends IProtocolTransport {
+    /** Establish the underlying connection (e.g. open a WebSocket). */
+    connect(): Promise<void>;
+}
+/** Type guard for transports that require an explicit connection step. */
+export declare function isClientTransport(transport: IProtocolTransport): transport is IClientTransport;
+/**
+ * Server-side transport that accepts multiple client connections.
+ * Each connected client gets its own {@link IProtocolTransport}.
+ */
+export interface IProtocolServer extends IDisposable {
+    /** Fires when a new client connects. */
+    readonly onConnection: Event<IProtocolTransport>;
+    /** The port or address the server is listening on. */
+    readonly address: string | undefined;
+}

package/vscode/src/vs/platform/agentHost/common/state/sessionTransport.js

@@ -0,0 +1,18 @@
+
+
+var AgentHostTransportFailureReason;
+(function (AgentHostTransportFailureReason) {
+    AgentHostTransportFailureReason["Unknown"] = "unknown";
+    AgentHostTransportFailureReason["HostNotRunning"] = "hostNotRunning";
+})(AgentHostTransportFailureReason || (AgentHostTransportFailureReason = {}));
+class NonReconnectableTransportError extends Error {
+    constructor(message, reason = AgentHostTransportFailureReason.Unknown) {
+        super(message);
+        this.reason = reason;
+    }
+}
+function isClientTransport(transport) {
+    return typeof transport.connect === 'function';
+}
+
+export { AgentHostTransportFailureReason, NonReconnectableTransportError, isClientTransport };