@lotagate/cli 0.1.24 → 0.1.26

package/dist/application/project-intelligence/project-intelligence-constants.d.ts

@@ -0,0 +1,56 @@
+export type ProjectMarker = {
+    readonly name: string;
+    readonly markers: readonly string[];
+    readonly extensions: readonly string[];
+};
+export type FrameworkMarker = {
+    readonly label: string;
+    readonly packages?: readonly string[];
+    readonly files?: readonly string[];
+};
+export declare const CONFIG_FILE_NAMES: readonly ["package.json", "tsconfig.json", "jsconfig.json", "pyproject.toml", "setup.cfg", "setup.py", "requirements.txt", "Pipfile", "Cargo.toml", "go.mod", "pom.xml", "build.gradle", "build.gradle.kts", "Gemfile", "composer.json", "Makefile", "CMakeLists.txt", "Dockerfile", "vitest.config.ts", "vitest.config.js", "jest.config.ts", "jest.config.js", "playwright.config.ts", "playwright.config.js", "pytest.ini", "tox.ini", "eslint.config.mjs", "vite.config.ts", "electron.vite.config.ts", "pnpm-workspace.yaml", "turbo.json"];
+export declare const PROJECT_MARKERS: readonly ProjectMarker[];
+export declare const FRAMEWORK_MARKERS: readonly FrameworkMarker[];
+export declare const PACKAGE_MANAGERS: readonly [readonly ["package-lock.json", "npm"], readonly ["pnpm-lock.yaml", "pnpm"], readonly ["yarn.lock", "Yarn"], readonly ["bun.lockb", "Bun"], readonly ["bun.lock", "Bun"], readonly ["uv.lock", "uv"], readonly ["poetry.lock", "Poetry"], readonly ["Pipfile.lock", "Pipenv"], readonly ["Cargo.lock", "Cargo"], readonly ["go.sum", "Go modules"], readonly ["Gemfile.lock", "Bundler"], readonly ["composer.lock", "Composer"]];
+export declare const SOURCE_ROOT_NAMES: readonly ["src", "app", "lib", "test", "tests", "packages", "apps", "cmd", "internal", "pkg", "crates", "components"];
+export declare const TEST_RUNNER_MARKERS: readonly [{
+    readonly label: "Vitest";
+    readonly packages: readonly ["vitest"];
+    readonly scriptTokens: readonly ["vitest"];
+    readonly files: readonly ["vitest.config.ts", "vitest.config.js"];
+}, {
+    readonly label: "Jest";
+    readonly packages: readonly ["jest"];
+    readonly scriptTokens: readonly ["jest"];
+    readonly files: readonly ["jest.config.ts", "jest.config.js"];
+}, {
+    readonly label: "Playwright";
+    readonly packages: readonly ["@playwright/test"];
+    readonly scriptTokens: readonly ["playwright"];
+    readonly files: readonly ["playwright.config.ts", "playwright.config.js"];
+}, {
+    readonly label: "pytest";
+    readonly packages: readonly [];
+    readonly scriptTokens: readonly ["pytest"];
+    readonly files: readonly ["pytest.ini", "tox.ini"];
+}, {
+    readonly label: "Cargo test";
+    readonly packages: readonly [];
+    readonly scriptTokens: readonly [];
+    readonly files: readonly ["Cargo.toml"];
+}, {
+    readonly label: "Go test";
+    readonly packages: readonly [];
+    readonly scriptTokens: readonly [];
+    readonly files: readonly ["go.mod"];
+}, {
+    readonly label: "Maven test";
+    readonly packages: readonly [];
+    readonly scriptTokens: readonly ["mvn", "maven"];
+    readonly files: readonly ["pom.xml"];
+}, {
+    readonly label: "Gradle test";
+    readonly packages: readonly [];
+    readonly scriptTokens: readonly ["gradle"];
+    readonly files: readonly ["build.gradle", "build.gradle.kts"];
+}];

package/dist/application/project-intelligence/project-intelligence-constants.js

@@ -0,0 +1 @@
+const e=["package.json","tsconfig.json","jsconfig.json","pyproject.toml","setup.cfg","setup.py","requirements.txt","Pipfile","Cargo.toml","go.mod","pom.xml","build.gradle","build.gradle.kts","Gemfile","composer.json","Makefile","CMakeLists.txt","Dockerfile","vitest.config.ts","vitest.config.js","jest.config.ts","jest.config.js","playwright.config.ts","playwright.config.js","pytest.ini","tox.ini","eslint.config.mjs","vite.config.ts","electron.vite.config.ts","pnpm-workspace.yaml","turbo.json"],s=[{name:"TypeScript",markers:["tsconfig.json"],extensions:[".ts",".tsx"]},{name:"JavaScript/JSX",markers:["package.json"],extensions:[".js",".jsx",".mjs",".cjs"]},{name:"Python",markers:["pyproject.toml","setup.py","requirements.txt","Pipfile"],extensions:[".py"]},{name:"Rust",markers:["Cargo.toml"],extensions:[".rs"]},{name:"Go",markers:["go.mod"],extensions:[".go"]},{name:"Java/Kotlin",markers:["pom.xml","build.gradle","build.gradle.kts"],extensions:[".java",".kt",".kts"]},{name:"Ruby",markers:["Gemfile"],extensions:[".rb"]},{name:"PHP",markers:["composer.json"],extensions:[".php"]},{name:"C/C++",markers:["CMakeLists.txt"],extensions:[".c",".h",".cc",".cpp",".cxx",".hpp"]},{name:"C#",markers:[],extensions:[".cs",".csproj",".sln"]}],t=[{label:"React",packages:["react","react-dom"]},{label:"Electron",packages:["electron"]},{label:"Vite",packages:["vite"]},{label:"Next.js",packages:["next"]},{label:"Express",packages:["express"]},{label:"Angular",packages:["@angular/core"]},{label:"Vue",packages:["vue"]},{label:"Svelte",packages:["svelte"]},{label:"Django",files:["manage.py"]},{label:"FastAPI",packages:["fastapi"]},{label:"Flask",packages:["flask"]},{label:"Rails",files:["bin/rails"]}],a=[["package-lock.json","npm"],["pnpm-lock.yaml","pnpm"],["yarn.lock","Yarn"],["bun.lockb","Bun"],["bun.lock","Bun"],["uv.lock","uv"],["poetry.lock","Poetry"],["Pipfile.lock","Pipenv"],["Cargo.lock","Cargo"],["go.sum","Go modules"],["Gemfile.lock","Bundler"],["composer.lock","Composer"]],o=["src","app","lib","test","tests","packages","apps","cmd","internal","pkg","crates","components"],l=[{label:"Vitest",packages:["vitest"],scriptTokens:["vitest"],files:["vitest.config.ts","vitest.config.js"]},{label:"Jest",packages:["jest"],scriptTokens:["jest"],files:["jest.config.ts","jest.config.js"]},{label:"Playwright",packages:["@playwright/test"],scriptTokens:["playwright"],files:["playwright.config.ts","playwright.config.js"]},{label:"pytest",packages:[],scriptTokens:["pytest"],files:["pytest.ini","tox.ini"]},{label:"Cargo test",packages:[],scriptTokens:[],files:["Cargo.toml"]},{label:"Go test",packages:[],scriptTokens:[],files:["go.mod"]},{label:"Maven test",packages:[],scriptTokens:["mvn","maven"],files:["pom.xml"]},{label:"Gradle test",packages:[],scriptTokens:["gradle"],files:["build.gradle","build.gradle.kts"]}];export{e as CONFIG_FILE_NAMES,t as FRAMEWORK_MARKERS,a as PACKAGE_MANAGERS,s as PROJECT_MARKERS,o as SOURCE_ROOT_NAMES,l as TEST_RUNNER_MARKERS};

package/dist/application/project-intelligence/project-intelligence-service.d.ts

@@ -0,0 +1,14 @@
+export interface ProjectIntelligence {
+    packageManager?: string;
+    runtime?: string;
+    languages: readonly string[];
+    frameworks: readonly string[];
+    scripts: Readonly<Record<string, string>>;
+    testRunners: readonly string[];
+    sourceRoots: readonly string[];
+    configFiles: readonly string[];
+}
+/** Reads bounded repository metadata so the model can choose project-native verification commands. */
+export declare class ProjectIntelligenceService {
+    discover(root: string): Promise<ProjectIntelligence>;
+}

package/dist/application/project-intelligence/project-intelligence-service.js

@@ -0,0 +1 @@
+import f from"node:fs/promises";import c from"node:path";import{CONFIG_FILE_NAMES as h,FRAMEWORK_MARKERS as g,PACKAGE_MANAGERS as R,PROJECT_MARKERS as j,SOURCE_ROOT_NAMES as k,TEST_RUNNER_MARKERS as E}from"./project-intelligence-constants.js";class J{async discover(e){const t=await P(c.join(e,"package.json")),s={...o(t?.dependencies),...o(t?.devDependencies)},a=o(t?.scripts),i=await O(e),r=await A(e),u=_(t);return{...r===void 0?{}:{packageManager:r},...u===void 0?{}:{runtime:u},languages:await b(e,t,i),frameworks:await S(e,s),scripts:a,testRunners:await F(e,s,a),sourceRoots:i,configFiles:await M(e,h)}}}async function S(n,e){const t=[];for(const s of g)(s.packages?.some(a=>e[a]!==void 0)===!0||await l(n,s.files??[]))&&t.push(s.label);return t}async function F(n,e,t){const s=Object.values(t).join(" ").toLowerCase(),a=[];for(const i of E)(i.packages.some(r=>e[r]!==void 0)||i.scriptTokens.some(r=>s.includes(r))||await l(n,i.files))&&a.push(i.label);return a}async function M(n,e){return(await Promise.all(e.map(async t=>await d(c.join(n,t))?t:void 0))).filter(t=>t!==void 0)}async function A(n){for(const[e,t]of R)if(await d(c.join(n,e)))return t}async function O(n){const e=[];for(const t of k)await d(c.join(n,t))&&e.push(t);return e}async function b(n,e,t){const s={...o(e?.dependencies),...o(e?.devDependencies)},a=[],i=await T(n,t);for(const r of j){const u=await l(n,r.markers),p=r.name==="TypeScript"?s.typescript!==void 0:r.name==="JavaScript/JSX"?Object.keys(s).length>0:!1,m=i.some(y=>r.extensions.some(w=>y.toLowerCase().endsWith(w)));(u||p||m)&&a.push(r.name)}return a.length===0?["Unknown"]:a}async function T(n,e){const t=[];for(const s of[".",...e.slice(0,8)])try{const a=await f.readdir(c.join(n,s),{withFileTypes:!0});for(const i of a.slice(0,256))i.isFile()?t.push(i.name):i.isDirectory()&&s!=="."&&t.push(...await N(c.join(n,s,i.name)))}catch{}return t}async function N(n){try{return(await f.readdir(n,{withFileTypes:!0})).slice(0,256).filter(e=>e.isFile()).map(e=>e.name)}catch{return[]}}async function l(n,e){return(await Promise.all(e.map(s=>d(c.join(n,s))))).some(Boolean)}function _(n){const e=n?.engines;return typeof e=="object"&&e!==null&&typeof e.node=="string"?`Node ${e.node}`:void 0}async function P(n){try{const e=JSON.parse(await f.readFile(n,"utf8"));return typeof e=="object"&&e!==null?e:void 0}catch{return}}async function d(n){try{return await f.access(n),!0}catch{return!1}}function o(n){return typeof n!="object"||n===null?{}:Object.fromEntries(Object.entries(n).filter(e=>typeof e[1]=="string"))}export{J as ProjectIntelligenceService};

package/dist/application/protocol/browser-host-tool-executor.d.ts

@@ -0,0 +1,51 @@
+import type { ToolDefinition } from '@lotagate/sdk';
+import type { ToolAuthorizationDecision, ToolApprovalRequest, ToolExecutionContext, ToolExecutor, ToolInfo, ToolResult } from '@lotagate/agent-sdk';
+import type { ToolActivityObserver } from '../../ports/tool-activity.js';
+export interface BrowserHostRequest {
+    version: 1;
+    type: 'host.request';
+    requestId: string;
+    tool: 'browser';
+    sessionId: string;
+    runId: string;
+    action: string;
+    params: Record<string, unknown>;
+    executionBoundary: 'sandbox' | 'host';
+    hostFallback: 'ask' | 'deny' | 'allow';
+    projectRoot?: string;
+    executionCwd?: string;
+    executionWorkspaceId?: string;
+}
+export interface BrowserHostResponse {
+    version: 1;
+    type: 'host.response';
+    requestId: string;
+    tool: 'browser';
+    ok: boolean;
+    environmentId?: string;
+    result?: unknown;
+    error?: {
+        code: string;
+        category: string;
+        message: string;
+        retryable: boolean;
+    };
+    executionBoundary?: 'sandbox' | 'host';
+    fallbackReason?: string;
+}
+export type BrowserHostInvoker = (request: BrowserHostRequest, signal?: AbortSignal) => Promise<BrowserHostResponse>;
+export declare function browserToolDefinitions(): readonly ToolDefinition[];
+export declare class BrowserHostToolExecutor implements ToolExecutor {
+    private readonly options;
+    constructor(options: {
+        request: BrowserHostInvoker;
+        executionBoundary: 'sandbox' | 'host';
+        hostFallback: 'ask' | 'deny' | 'allow';
+        onFallbackApproval?: (request: ToolApprovalRequest, reason: string) => boolean | ToolAuthorizationDecision | Promise<boolean | ToolAuthorizationDecision>;
+        onActivity?: ToolActivityObserver;
+    });
+    listTools(): readonly ToolDefinition[];
+    getToolInfo(toolName: string): ToolInfo | undefined;
+    execute(toolName: string, input: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+    private request;
+}

package/dist/application/protocol/browser-host-tool-executor.js

@@ -0,0 +1,2 @@
+import{randomUUID as k}from"node:crypto";import{imageContentBlockFromDataUrl as v,omitImageData as I}from"./tool-image-content.js";import{READ_ONLY_BROWSER_TOOLS as O}from"../security/tool-policy-registry.js";const f=[e("browser.navigate","Open an HTTP(S) URL in the agent browser.",{url:o("Destination URL."),tabId:o("Optional browser tab id.")},["url"]),e("browser.newTab","Open a new blank tab in the agent browser.",{},[]),e("browser.closeTab","Close the active browser tab.",{tabId:o("Optional browser tab id.")},[]),e("browser.selectTab","Make a browser tab active.",{tabId:o("Browser tab id.")},["tabId"]),e("browser.inspect","Inspect the current page DOM summary, text, headings, links, and visible interactive elements.",{tabId:o("Optional browser tab id.")},[]),e("browser.inspectElement","Inspect a page element including its DOM, attributes, bounds, and computed CSS.",{target:i(),tabId:o("Optional browser tab id.")},["target"]),e("browser.extractTable","Extract a bounded HTML table from the current page.",{target:i(),maxRows:l("Maximum number of data rows to return.")},["target"]),e("browser.drag","Drag one visible page target onto another.",{from:i(),to:i()},["from","to"]),e("browser.listFrames","List frames embedded in the current browser page.",{tabId:o("Optional browser tab id.")},[]),e("browser.console","Read recent browser console messages and page errors.",{tabId:o("Optional browser tab id."),limit:l("Maximum number of entries to return.")},[]),e("browser.network","Read recent browser network requests, HTTP failures, and request errors.",{tabId:o("Optional browser tab id."),limit:l("Maximum number of entries to return.")},[]),e("browser.accessibility","Inspect the page accessibility tree without exposing control values.",{tabId:o("Optional browser tab id.")},[]),e("browser.setViewport","Emulate a responsive browser viewport for the current tab.",{width:l("Viewport width in CSS pixels."),height:l("Viewport height in CSS pixels."),mobile:d("Whether to emulate a mobile layout."),deviceScaleFactor:l("Optional device scale factor.")},["width","height"]),e("browser.resetViewport","Reset the browser tab to its normal viewport.",{tabId:o("Optional browser tab id.")},[]),e("browser.screenshot","Capture the current browser tab as evidence.",{tabId:o("Optional browser tab id.")},[]),e("browser.click","Click a visible page element using an accessibility target, text, CSS selector, or coordinates.",{target:i()},["target"]),e("browser.focus","Focus a visible page field or control.",{target:i()},["target"]),e("browser.clear","Clear a visible editable page field.",{target:i()},["target"]),e("browser.hover","Move the browser pointer over a visible page element.",{target:i()},["target"]),e("browser.check","Check or uncheck a checkbox or radio input.",{target:i(),checked:d("Whether the control should be checked.")},["target","checked"]),e("browser.select","Select an option in a native HTML select control.",{target:i(),value:o("Option value or visible label.")},["target","value"]),e("browser.readField","Read a visible non-password form field value.",{target:i()},["target"]),e("browser.type","Enter text into a visible page field.",{target:i(),value:o("Text to enter.")},["target","value"]),e("browser.upload","Upload a workspace file through a visible file input.",{target:i(),path:o("Workspace-relative or absolute file path.")},["target","path"]),e("browser.download","Download an HTTP(S) resource to the Desktop downloads folder.",{url:o("HTTP(S) resource URL."),tabId:o("Optional browser tab id.")},["url"]),e("browser.exportPdf","Export the current browser page to a workspace PDF file.",{outputPath:o("Workspace-relative or absolute output path."),overwrite:d("Whether an existing output file may be replaced."),printBackground:d("Whether CSS backgrounds should be printed."),landscape:d("Whether to use landscape orientation."),pageSize:h(["A4","Letter"],"PDF paper size.")},["outputPath"]),e("browser.dialog","Read or respond to the active alert, confirm, or prompt dialog.",{action:h(["read","accept","dismiss"],"Dialog operation."),promptText:o("Optional text for a prompt dialog."),tabId:o("Optional browser tab id.")},["action"]),e("browser.press","Press a keyboard key in the current browser tab.",{key:o("Key name, for example Enter or Tab."),modifiers:S("Optional modifiers: Alt, Control, Shift, or Meta."),tabId:o("Optional browser tab id.")},["key"]),e("browser.scroll","Scroll the current browser tab.",{deltaX:l("Horizontal scroll amount."),deltaY:l("Vertical scroll amount."),tabId:o("Optional browser tab id.")},[]),e("browser.back","Navigate the current browser tab back.",{tabId:o("Optional browser tab id.")},[]),e("browser.forward","Navigate the current browser tab forward.",{tabId:o("Optional browser tab id.")},[]),e("browser.reload","Reload the current browser tab.",{tabId:o("Optional browser tab id.")},[]),e("browser.waitFor","Wait until a URL, text fragment, or CSS selector appears.",{condition:x(),timeoutMs:l("Maximum wait time in milliseconds.")},["condition"]),e("browser.tabs","List tabs in the agent browser session.",{},[])];function R(){return f}class U{options;constructor(r){this.options=r}listTools(){return R()}getToolInfo(r){if(!f.some(n=>g(n)===r))return;const s=O.has(r);return{toolName:r,source:"custom",executorId:"desktop-browser-host",metadata:{risk:s?"read":"unknown"}}}async execute(r,s,n){if(!f.some(a=>g(a)===r))return{content:`Unknown browser tool: ${r}`,isError:!0};const b=this.options.onActivity?.start({key:`${n.runId}:${r}`,toolName:r,source:"browser",label:E(r,s)});try{let a=await this.options.request(this.request(r,s,n),n.signal);if(!a.ok&&a.error?.code==="SANDBOX_FALLBACK_REQUIRED"&&this.options.hostFallback==="ask"){const p=this.getToolInfo(r),c=await this.options.onFallbackApproval?.({toolName:r,input:s,context:n,...p===void 0?{}:{toolInfo:p}},a.error.message)??!1;if(typeof c=="boolean"?c:c.decision==="allow")a=await this.options.request({...this.request(r,s,n),executionBoundary:"host",hostFallback:"deny"},n.signal);else if(typeof c!="boolean"&&c.decision==="redirect")return b?.complete(!0,{userRedirect:!0}),{content:c.message,isError:!0,metadata:{code:"USER_REDIRECTED_ACTION",boundary:this.options.executionBoundary}}}if(!a.ok){const p=a.error?.message??"Desktop rejected the browser action.";return b?.complete(!0),{content:p,isError:!0,metadata:{code:a.error?.code??"BROWSER_HOST_ERROR",retryable:a.error?.retryable??!1}}}const u=r==="browser.screenshot"&&B(a.result)?a.result:void 0,w=u===void 0?void 0:v(u.dataUrl);if(u!==void 0&&u.dataUrl!==void 0&&w===void 0)throw new Error("Desktop returned an invalid browser screenshot payload.");const m=r==="browser.screenshot"?I(a.result,"dataUrl"):a.result,y=T(m,n.maxResultBytes);return b?.complete(!1),{content:y,isError:!1,...w===void 0?{}:{contentBlocks:[w]},metadata:{browser:!0,boundary:a.executionBoundary??this.options.executionBoundary,...a.environmentId===void 0?{}:{environmentId:a.environmentId},...a.fallbackReason===void 0?{}:{fallbackReason:a.fallbackReason}}}}catch(a){return b?.complete(!0),{content:a instanceof Error?a.message:"Browser host request failed.",isError:!0}}}request(r,s,n){return{version:1,type:"host.request",requestId:k(),tool:"browser",sessionId:n.sessionId,runId:n.runId,action:r,params:s,executionBoundary:this.options.executionBoundary,hostFallback:this.options.hostFallback,...n.workspaceRoot===void 0?{}:{projectRoot:n.workspaceRoot},...n.cwd===void 0?{}:{executionCwd:n.cwd},...typeof n.metadata?.executionWorkspaceId=="string"?{executionWorkspaceId:n.metadata.executionWorkspaceId}:{}}}}function e(t,r,s,n){return{type:"function",function:{name:t,description:r,parameters:{type:"object",properties:s,required:n,additionalProperties:!1}}}}function o(t){return{type:"string",description:t}}function l(t){return{type:"number",description:t}}function d(t){return{type:"boolean",description:t}}function h(t,r){return{type:"string",enum:[...t],description:r}}function S(t){return{type:"array",items:{type:"string"},description:t}}function i(){return{type:"object",properties:{type:{type:"string",enum:["accessibility","text","css","coordinates"]},role:{type:"string"},name:{type:"string"},value:{type:"string"},selector:{type:"string"},x:{type:"number"},y:{type:"number"}},required:["type"],additionalProperties:!1}}function x(){return{type:"object",properties:{type:{type:"string",enum:["selector","text","url"]},value:{type:"string"}},required:["type","value"],additionalProperties:!1}}function g(t){return"function"in t?t.function.name:void 0}function T(t,r){const s=JSON.stringify(t??null);return Buffer.byteLength(s,"utf8")<=r?s:`${s.slice(0,Math.max(0,r-12))}
+[truncated]`}function E(t,r){return t==="browser.navigate"?`Open ${typeof r.url=="string"?r.url:"URL"}`:t==="browser.type"?"Enter text in browser":t==="browser.click"?"Click page element":t.replace(/^browser\./u,"Browser ")}function B(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}export{U as BrowserHostToolExecutor,R as browserToolDefinitions};

package/dist/application/protocol/computer-host-tool-executor.d.ts

@@ -0,0 +1,45 @@
+import type { ToolDefinition } from '@lotagate/sdk';
+import type { ToolExecutionContext, ToolExecutor, ToolInfo, ToolResult } from '@lotagate/agent-sdk';
+import type { ToolActivityObserver } from '../../ports/tool-activity.js';
+export type ComputerHostTool = 'computer';
+export interface ComputerHostRequest {
+    version: 1;
+    type: 'host.request';
+    requestId: string;
+    tool: ComputerHostTool;
+    sessionId: string;
+    runId: string;
+    action: string;
+    params: Record<string, unknown>;
+    executionBoundary: 'host';
+    hostFallback: 'deny';
+}
+export interface ComputerHostResponse {
+    version: 1;
+    type: 'host.response';
+    requestId: string;
+    tool: ComputerHostTool;
+    ok: boolean;
+    result?: unknown;
+    error?: {
+        code: string;
+        category: string;
+        message: string;
+        retryable: boolean;
+    };
+}
+export type ComputerHostInvoker = (request: ComputerHostRequest, signal?: AbortSignal) => Promise<ComputerHostResponse>;
+export declare function computerToolDefinitions(): readonly ToolDefinition[];
+export declare function computerToolDefinitionsForOperations(operations: readonly string[]): readonly ToolDefinition[];
+export declare class ComputerHostToolExecutor implements ToolExecutor {
+    private readonly options;
+    private readonly definitions;
+    constructor(options: {
+        request: ComputerHostInvoker;
+        operations?: readonly string[];
+        onActivity?: ToolActivityObserver;
+    });
+    listTools(): readonly ToolDefinition[];
+    getToolInfo(toolName: string): ToolInfo | undefined;
+    execute(toolName: string, input: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}

package/dist/application/protocol/computer-host-tool-executor.js

@@ -0,0 +1,2 @@
+import{randomUUID as g}from"node:crypto";import{imageContentBlockFromResult as h,omitImageData as y}from"./tool-image-content.js";import{READ_ONLY_COMPUTER_TOOLS as x}from"../security/tool-policy-registry.js";const s=[t("computer.listWindows","List visible desktop application windows that can be targeted.",{includeMinimized:w("Whether minimized windows should be included.")},[]),t("computer.inspect","Inspect accessible UI elements of a target desktop application window.",{windowId:e("Target window id."),query:v(),maxDepth:i("Maximum UI tree depth.")},["windowId"]),t("computer.screenshot","Capture the target application window or screen for visual verification.",{windowId:e("Target window id."),region:f()},["windowId"]),t("computer.readText","Read text or the current value from an inspected UI element.",{windowId:e("Target window id."),elementId:e("Element id from computer.inspect."),scope:c(["value","document","selection"],"Text source to read.")},["windowId","elementId"]),t("computer.readSelection","Read selected items from a selection control.",{windowId:e("Target window id."),elementId:e("Selection control element id.")},["windowId","elementId"]),t("computer.readGrid","Read a bounded rectangular region from a grid control.",{windowId:e("Target window id."),elementId:e("Element id from computer.inspect."),rowStart:i("Zero-based first row."),rowCount:i("Maximum rows to read."),columnStart:i("Zero-based first column."),columnCount:i("Maximum columns to read.")},["windowId","elementId"]),t("computer.recognizeText","Recognize visible text in an application screenshot.",{windowId:e("Target window id."),region:f(),language:e("Optional BCP-47 OCR language tag.")},["windowId"]),t("computer.focus","Bring an application window or inspected element to the foreground.",{windowId:e("Target window id."),elementId:e("Optional element id from computer.inspect.")},["windowId"]),t("computer.click","Click a visible target window element or validated point.",{windowId:e("Target window id."),elementId:e("Optional element id from computer.inspect."),point:m(),button:c(["left","right","middle"],"Mouse button."),clickCount:i("Number of clicks, one or two.")},["windowId"]),t("computer.type","Type text into the focused application control.",{windowId:e("Target window id."),text:e("Text to type."),elementId:e("Optional editable element id from computer.inspect.")},["windowId","text"]),t("computer.keypress","Press a keyboard key with optional modifiers in the target window.",{windowId:e("Target window id."),key:e("Key name, for example Enter or Tab."),modifiers:T("Optional modifiers: Alt, Control, Shift, or Meta.")},["windowId","key"]),t("computer.scroll","Scroll the target application.",{windowId:e("Target window id."),deltaX:i("Horizontal scroll amount."),deltaY:i("Vertical scroll amount."),point:m()},["windowId"]),t("computer.drag","Drag from one validated point or element to another within a target window.",{windowId:e("Target window id."),from:I(),to:I(),durationMs:i("Drag duration in milliseconds.")},["windowId","from","to"]),t("computer.selectText","Select an occurrence of text in an inspected text control.",{windowId:e("Target window id."),elementId:e("Text control element id."),text:e("Text to select."),occurrence:i("One-based occurrence to select.")},["windowId","elementId","text"]),t("computer.listDisplays","List connected displays and their work areas.",{},[]),t("computer.launch","Launch an allowlisted desktop application by app id.",{appId:e("Registered application id.")},["appId"]),t("computer.wait","Wait for a target window, UI element, text, or idle state.",{windowId:e("Optional target window id."),condition:c(["window","element","text","idle"],"Condition to wait for."),elementId:e("Optional element id."),text:e("Optional text to find."),timeoutMs:i("Maximum wait time in milliseconds."),idleMs:i("Minimum system idle time for the idle condition.")},["condition","timeoutMs"]),t("computer.move","Move the pointer to a target point or element, including hover interactions.",{windowId:e("Target window id."),elementId:e("Optional element id from computer.inspect."),point:m(),durationMs:i("Movement duration in milliseconds.")},["windowId"]),t("computer.setValue","Set the value of an editable or range UI Automation control.",{windowId:e("Target window id."),elementId:e("Element id from computer.inspect."),value:e("New control value.")},["windowId","elementId","value"]),t("computer.invoke","Invoke the default action of an inspected button or menu item.",{windowId:e("Target window id."),elementId:e("Element id from computer.inspect.")},["windowId","elementId"]),t("computer.select","Set the selection state of an inspected selectable UI element.",{windowId:e("Target window id."),elementId:e("Element id from computer.inspect."),mode:c(["replace","add","remove"],"Selection operation.")},["windowId","elementId"]),t("computer.setToggleState","Set an inspected toggle or checkbox to a specific state.",{windowId:e("Target window id."),elementId:e("Element id from computer.inspect."),state:c(["on","off","indeterminate"],"Desired toggle state.")},["windowId","elementId","state"]),t("computer.setExpandedState","Expand or collapse an inspected tree, menu, or group control.",{windowId:e("Target window id."),elementId:e("Element id from computer.inspect."),expanded:w("Whether the element should be expanded.")},["windowId","elementId","expanded"]),t("computer.scrollIntoView","Scroll an inspected element into the visible area of its container.",{windowId:e("Target window id."),elementId:e("Element id from computer.inspect.")},["windowId","elementId"]),t("computer.setWindowState","Set the target window visual state and optionally its screen bounds.",{windowId:e("Target window id."),state:c(["normal","minimized","maximized"],"Desired window state."),bounds:S()},["windowId","state"]),t("computer.closeWindow","Request a normal close of the target application window.",{windowId:e("Target window id.")},["windowId"]),t("computer.readClipboard","Read the current text clipboard contents.",{},[]),t("computer.writeClipboard","Replace the text clipboard contents.",{text:e("Text to place on the clipboard.")},["text"]),t("computer.waitForState","Wait until an inspected UI element exposes the requested property value.",{windowId:e("Target window id."),elementId:e("Element id from computer.inspect."),property:c(["name","value","isEnabled","isOffscreen","toggleState","expandCollapseState","selectionState"],"UI property to observe."),expected:e("Expected property value."),timeoutMs:i("Maximum wait time in milliseconds."),intervalMs:i("Polling interval in milliseconds.")},["windowId","elementId","property","expected","timeoutMs"]),t("computer.manageFileDialog","Set, confirm, or cancel a standard file dialog.",{windowId:e("File dialog window id."),action:c(["setPath","confirm","cancel"],"File dialog operation."),path:e("File path to enter when using setPath or confirm.")},["windowId","action"])];function R(){return s}function b(n){if(n.includes("*"))return s;const o=new Set(n);return s.filter(a=>{const r=u(a);return r!==void 0&&o.has(r)})}class U{options;definitions;constructor(o){this.options=o,this.definitions=o.operations===void 0?s:b(o.operations)}listTools(){return this.definitions}getToolInfo(o){if(!this.definitions.some(r=>u(r)===o))return;const a=x.has(o);return{toolName:o,source:"custom",executorId:"desktop-computer-host",metadata:{risk:a?"read":"unknown"}}}async execute(o,a,r){if(!this.definitions.some(d=>u(d)===o))return{content:`Computer capability is unavailable for ${o}.`,isError:!0,metadata:{code:"COMPUTER_CAPABILITY_UNAVAILABLE"}};const l=this.options.onActivity?.start({key:`${r.runId}:${o}`,toolName:o,source:"computer",label:E(o)});try{const d=await this.options.request({version:1,type:"host.request",requestId:g(),tool:"computer",sessionId:r.sessionId,runId:r.runId,action:o,params:a,executionBoundary:"host",hostFallback:"deny"},r.signal);if(!d.ok)return l?.complete(!0),{content:d.error?.message??"Desktop rejected the computer action.",isError:!0,metadata:{code:d.error?.code??"COMPUTER_HOST_ERROR",retryable:d.error?.retryable??!1}};l?.complete(!1);const p=o==="computer.screenshot"?h(d.result):void 0;return{content:O(p===void 0?d.result:y(d.result,"dataBase64"),r.maxResultBytes),isError:!1,...p===void 0?{}:{contentBlocks:[p]},metadata:{computer:!0}}}catch(d){return l?.complete(!0),{content:d instanceof Error?d.message:"Computer host request failed.",isError:!0}}}}function t(n,o,a,r){return{type:"function",function:{name:n,description:o,parameters:{type:"object",properties:a,required:r,additionalProperties:!1}}}}function e(n){return{type:"string",description:n}}function i(n){return{type:"number",description:n}}function w(n){return{type:"boolean",description:n}}function c(n,o){return{type:"string",enum:[...n],description:o}}function T(n){return{type:"array",items:{type:"string"},description:n}}function v(){return{type:"object",properties:{role:e("Exact UI Automation control type."),name:e("Case-insensitive text contained in the element name."),text:e("Case-insensitive text contained in the element name or help text.")},additionalProperties:!1,description:"Optional role, name, or text filter."}}function f(){return{type:"object",properties:{x:{type:"number",description:"Left offset within the window."},y:{type:"number",description:"Top offset within the window."},width:{type:"number",description:"Region width."},height:{type:"number",description:"Region height."}},required:["x","y","width","height"],additionalProperties:!1,description:"Optional region within the target window."}}function S(){return{type:"object",properties:{x:i("Screen left coordinate."),y:i("Screen top coordinate."),width:i("Window width."),height:i("Window height.")},required:["x","y","width","height"],additionalProperties:!1,description:"Optional screen bounds."}}function m(){return{type:"object",properties:{x:{type:"number"},y:{type:"number"}},required:["x","y"],additionalProperties:!1}}function I(){return{type:"object",properties:{elementId:{type:"string"},x:{type:"number"},y:{type:"number"}},additionalProperties:!1}}function u(n){return"function"in n?n.function.name:void 0}function O(n,o){const a=JSON.stringify(n??null);return Buffer.byteLength(a,"utf8")<=o?a:`${a.slice(0,Math.max(0,o-12))}
+[truncated]`}function E(n){return n.replace(/^computer\./u,"Computer ")}export{U as ComputerHostToolExecutor,R as computerToolDefinitions,b as computerToolDefinitionsForOperations};

package/dist/application/protocol/desktop-agent-command.d.ts

@@ -0,0 +1,9 @@
+import type { Readable, Writable } from 'node:stream';
+import type { CliRuntime } from '../../bootstrap/runtime-factory.js';
+export { DESKTOP_PROTOCOL_VERSION } from './desktop-agent-contracts.js';
+/**
+ * Local JSONL bridge for the Desktop application. It is deliberately kept in
+ * the CLI application layer: Desktop reuses CLI policy and runtime, while the
+ * public SDK packages remain independent libraries.
+ */
+export declare function runDesktopAgentCommand(runtime: CliRuntime, cwd: string, input: Readable, output: Writable, signal?: AbortSignal): Promise<number>;

package/dist/application/protocol/desktop-agent-command.js

@@ -0,0 +1,3 @@
+import{randomUUID as K}from"node:crypto";import{AuthenticationService as T}from"../auth/authentication-service.js";import{createLotaGateClient as L}from"../../infrastructure/sdk/lotagate-client-factory.js";import{loadExecutionConfig as P}from"../config/execution-config.js";import{prepareCliAgent as V,warmMcpRuntime as Y}from"../agent/cli-agent-execution-service.js";import{createContextManagement as it}from"../agent/context-compaction.js";import{persistContextCompaction as nt}from"../agent/context-compaction-persistence.js";import{CliAgentSessionStoreRegistry as rt}from"../agent/agent-session-store-registry.js";import{AgentRunTracker as ct}from"../agent/agent-run-tracker.js";import{formatContinuationCheckpoint as dt}from"../agent/continuation-checkpoint.js";import{CliTurnEventProjector as mt}from"../orchestration/cli-turn-event-projector.js";import{persistCliTurnEvent as pt}from"../orchestration/cli-turn-persistence.js";import{createTurnId as lt,recordTurnCompletion as ht,recordTurnFailure as ut,recordTurnStart as ft}from"../session/session-turn-lifecycle.js";import{ProjectSessionAccess as $}from"../session/project-session-access.js";import{permissionRuleForRequest as wt}from"../security/workspace-permission-policy.js";import{agentLimitNotice as gt,classifyAgentLimit as yt}from"../agent/agent-limit.js";import{CliError as g}from"../../domain/errors/cli-error.js";import{CLI_ERROR_CODES as y}from"../../domain/errors/error-codes.js";import{readLinesBounded as Et}from"./jsonl-protocol.js";import{RESOURCE_LIMITS as Q}from"../../domain/runtime/resource-limits.js";import{getDesktopCommandCatalog as kt}from"./desktop-command-catalog.js";import{COMMAND_REGISTRY as X}from"../commands/command-runtime.js";import{executeDesktopCommand as bt}from"./desktop-command-executor.js";import{DesktopAttachmentStore as It}from"./desktop-attachment-store.js";import{SubagentJobRegistry as vt}from"../orchestration/cli-subagent-service.js";import{subagentDesktopPayload as St}from"./desktop-orchestration-events.js";import{DesktopIntentEventWriter as Tt}from"./desktop-intent-event-writer.js";import{resolveModelContextWindow as xt}from"../model/model-context-window.js";import{ContextUsageService as Ct}from"../agent/context-usage-service.js";import{isCliAgentPreparationMutation as Mt}from"../agent/cli-agent-preparation-cache.js";import{JsonLineWriter as Nt}from"./json-line-writer.js";import{desktopApprovalMode as Pt,sessionResult as Z,toDesktopError as b}from"./desktop-protocol-helpers.js";import{DesktopApprovalBroker as Rt}from"./desktop-approval-broker.js";import{SessionExecutionWorkspaceService as Dt}from"../workspace/session-execution-workspace.js";import{buildUserMessage as At}from"../../infrastructure/clipboard/image-normalizer.js";import{isBrowserHostResponse as Bt,isComputerHostResponse as Ot,isDesktopHostResponse as Lt,parseDesktopRequest as _t}from"./desktop-agent-request-parser.js";import{desktopMcpEvent as q}from"./desktop-mcp-events.js";import{DesktopExtensionService as jt}from"./desktop-extension-service.js";import{DesktopExtensionRequestHandler as Ht}from"./desktop-extension-request-handler.js";import{DesktopHostBridge as Wt}from"./desktop-host-bridge.js";import{normalizeDesktopHostCapabilities as Ut}from"./desktop-host-capabilities.js";import{loadModelCatalog as tt}from"../model/model-catalog-service.js";import{SdkMediaGatewayClient as Gt}from"../../infrastructure/sdk/sdk-media-gateway-client.js";import{artifactIdsData as _,resolveSpeechModel as Ft}from"./desktop-agent-helpers.js";import{DESKTOP_PROTOCOL_VERSION as R,DESKTOP_SPEECH_MAX_BYTES as zt,DESKTOP_SPEECH_SYNTHESIS_TIMEOUT_MS as Jt,TITLE_GENERATION_TIMEOUT_MS as Kt}from"./desktop-agent-contracts.js";import{createIsolatedGuestPlatform as Vt}from"../../infrastructure/platform/host-platform.js";import{evaluateGatewayRequestBudget as Yt}from"../../domain/runtime/gateway-request-budget.js";import{DESKTOP_PROTOCOL_VERSION as Ke}from"./desktop-agent-contracts.js";async function Fe(j,t,e,s,o){return new $t(j,t,s).run(e,o)}class $t{runtime;cwd;writer;turns=new Map;activeTurnBySession=new Map;subagentJobs=new vt;sessionStores=new rt(Q.desktopSessionStoreMaxEntries);turnContexts=new Map;attachments=new It;approvalBroker=new Rt((t,e)=>this.writeEvent(t,e));commands=new Map;speechRequests=new Map;hostBridge;extensions=new jt;extensionRequests;intentEvents;executionWorkspaces;browserHostEnabled=!1;computerHostEnabled=!1;desktopHostEnabled=!1;hostCapabilities;stopping=!1;constructor(t,e,s){this.runtime=t,this.cwd=e,this.writer=new Nt(s),this.executionWorkspaces=t.executionWorkspaces??new Dt(t.paths.globalConfigDir,t.platform),this.hostBridge=new Wt(this.writer,()=>this.stopping),this.extensionRequests=new Ht(this.extensions,(o,a)=>this.respond(o,a),this.cwd),this.intentEvents=new Tt({writeEvent:(o,a)=>this.writeEvent(o,a),log:(o,a)=>this.logInfo(o,a)})}async run(t,e){let s=0;const o=()=>{this.stopping=!0;for(const a of this.turns.values())a.controller.abort(e?.reason);for(const a of this.commands.values())a.controller.abort(e?.reason);for(const a of this.speechRequests.values())a.abort(e?.reason);t.destroy()};e?.addEventListener("abort",o,{once:!0});try{for await(const a of Et(t,Q.desktopJsonlLineBytes)){if(a.trim().length===0)continue;let r;try{r=JSON.parse(a)}catch(m){s+=1,await this.writeError("unknown","protocol",b(m));continue}if(Bt(r)){this.hostBridge.resolveBrowser(r);continue}if(Lt(r)){this.hostBridge.resolveDesktop(r);continue}if(Ot(r)){this.hostBridge.resolveComputer(r);continue}let c;try{c=_t(r)}catch(m){s+=1,await this.writeError("unknown","protocol",b(m));continue}try{await this.handle(c)}catch(m){this.runtime.logger.error("CLI Desktop request failed.",{method:c.method,requestId:c.id,reason:m instanceof Error?m.message:String(m)}),s+=1,await this.writeError(c.id,c.method,b(m))}if(this.stopping)break}}catch(a){s+=1,await this.writeError("unknown","protocol",b(a))}finally{e?.removeEventListener("abort",o);for(const a of this.turns.values())a.controller.abort();await Promise.allSettled([...this.turns.values()].map(a=>a.operation));for(const a of this.commands.values())a.controller.abort();await Promise.allSettled([...this.commands.values()].map(a=>a.operation));for(const a of this.speechRequests.values())a.abort();await this.subagentJobs.close(),this.sessionStores.clear(),this.approvalBroker.close(),this.hostBridge.close(),this.attachments.clear(),await this.writer.flush(),this.writer.close()}return s===0?0:1}async handle(t){switch(t.method){case"initialize":return this.browserHostEnabled=t.params.browserHost===!0,this.computerHostEnabled=t.params.computerHost===!0,this.desktopHostEnabled=t.params.executionBroker===!0,this.hostCapabilities=Ut(t.params.hostCapabilities),this.respond(t,{protocol:"lotagate.desktop",version:R,capabilities:["sessions","streaming","tool-approval","project-trust","models","auth","commands","image-attachments","file-attachments","execution-context","tool-allowlist","approval-reviews","lifecycle-controls",...this.desktopHostEnabled?["execution-broker"]:[],"intent-runtime","host-evidence","conversational-progress","local-memory-commands","extensions","speech-synthesis",...this.browserHostEnabled?["browser-host"]:[],...this.computerHostEnabled?["computer-host"]:[]]});case"session.create":return this.createSession(t);case"title.generate":return this.generateTitle(t);case"session.list":return this.listSessions(t);case"session.resume":return this.resumeSession(t);case"extension.listPublicPlugins":case"extension.resolvePublicPluginSource":case"extension.readPublicPluginContribution":case"extension.readDetail":case"extension.readPluginIcon":return this.extensionRequests.handle(t);case"attachment.begin":return this.attachments.begin({id:t.params.attachmentId,...t.params.sessionId===void 0?{}:{sessionId:t.params.sessionId},name:t.params.name,mimeType:t.params.mimeType,sizeBytes:t.params.sizeBytes,...t.params.storageName===void 0?{}:{storageName:t.params.storageName}}),this.respond(t,{accepted:!0,attachmentId:t.params.attachmentId});case"attachment.chunk":return this.attachments.appendChunk(t.params.attachmentId,t.params.index,t.params.dataBase64),this.respond(t,{accepted:!0,attachmentId:t.params.attachmentId,index:t.params.index});case"attachment.complete":{const e=this.attachments.complete(t.params.attachmentId);if(e.sessionId.length===0)return this.respond(t,{accepted:!0,attachmentId:t.params.attachmentId});const s=await this.runtime.sessionStore.saveAttachment(e.sessionId,e.attachment,e.bytes);return this.attachments.replace(t.params.attachmentId,{...e,attachment:s}),this.respond(t,{accepted:!0,attachmentId:t.params.attachmentId,storagePath:s.storagePath})}case"attachment.delete":{this.attachments.delete(t.params.attachmentId,t.params.sessionId);const e=await this.runtime.sessionStore.deleteAttachment(t.params.sessionId,t.params.attachmentId);return this.respond(t,{accepted:!0,attachmentId:t.params.attachmentId,deleted:e})}case"turn.start":return this.startTurn(t);case"turn.cancel":return this.cancelTurn(t);case"approval.respond":return this.respondApproval(t);case"trust.respond":return this.respondTrust(t);case"model.list":return this.listModels(t);case"auth.status":return this.authStatus(t);case"speech.synthesize":return this.synthesizeSpeech(t);case"command.list":return this.listCommands(t);case"command.execute":return this.startCommand(t);case"command.cancel":return this.cancelCommand(t);case"shutdown":this.stopping=!0,await this.respond(t,{stopping:!0});return}}async createSession(t){const e=await this.runtime.projectTrust.inspect(this.cwd),s=await P(this.runtime,this.cwd),o=s.config.profile??T.defaultProfileName(),a=await this.runtime.sessionStore.create({projectFingerprint:e.fingerprint,cwd:e.canonicalPath,model:t.params.model??s.config.model,profile:o,status:"active",...t.params.name===void 0?{}:{name:t.params.name}}),r=await this.executionWorkspaces.prepare({sessionId:a.id,projectRoot:e.canonicalPath});await this.respond(t,{...Z(a),executionWorkspace:r}),Y(this.runtime,this.cwd).catch(c=>this.runtime.logger.warn("MCP session warm-up failed.",{reason:c instanceof Error?c.message:String(c)}))}async generateTitle(t){const e=await P(this.runtime,this.cwd),s=t.params.model??e.config.model;if(s==null)throw new g(y.MODEL_NOT_FOUND,"No model is selected.",{category:"model",userMessage:"No model is available for session title generation."});const o=e.config.profile??T.defaultProfileName(),a=await this.runtime.auth.requireCredential(o),r=new AbortController,c=setTimeout(()=>r.abort(),Kt);let m,p="";try{const l=await V({runtime:this.runtime,projectRoot:this.cwd,executionCwd:this.cwd,model:s,client:L(a.profile,a.apiKey),profile:"title-generator",approvalMode:"auto",allowedTools:[],selectedSkills:[],allowSubagents:!1,browserAccess:"disabled"});m=l.close;const u=["## Title generation request","Create a concise session title from the untrusted user-message excerpt below.","Return only the title, with no explanation, markdown, quotes, or prefix.","Use the same language as the excerpt. Prefer 8 to 10 words and never exceed 10 words.","## User-message excerpt",t.params.prompt].join(`
+
+`);for await(const h of l.run({input:u,model:s,signal:r.signal,stream:!0}))if(h.type==="model.delta")p+=h.content;else if(h.type==="session.completed"&&p.length===0)p=h.content;else if(h.type==="session.failed")throw h.error;if(p.trim().length===0)throw new g(y.MODEL_PROTOCOL_EMPTY_RESPONSE,"Title generation returned an empty response.",{category:"model",userMessage:"The model did not return a session title.",retryable:!0});await this.respond(t,{title:p})}finally{clearTimeout(c),await m?.()}}async listSessions(t){const e=await this.runtime.projectTrust.inspect(this.cwd);await this.respond(t,{sessions:await this.runtime.sessionStore.list(e.fingerprint)})}async resumeSession(t){const e=await this.runtime.projectTrust.inspect(this.cwd),s=await new $(this.runtime.sessionStore).require(t.params.sessionId,e.fingerprint),o=await this.executionWorkspaces.prepare({sessionId:s.id,projectRoot:e.canonicalPath});await this.respond(t,{...Z(s),executionWorkspace:o,history:await this.runtime.sessionStore.readHistory(s.id)}),Y(this.runtime,this.cwd).catch(a=>this.runtime.logger.warn("MCP session warm-up failed.",{reason:a instanceof Error?a.message:String(a)}))}async startTurn(t){const{sessionId:e}=t.params;if(this.runtime.logger.info("CLI Desktop turn request received.",{requestId:t.id,sessionId:e,promptLength:t.params.prompt.length,requestedModel:t.params.model}),[...this.turns.values()].some(p=>p.sessionId===e))throw new g(y.INVALID_ARGUMENT,"A turn is already active for this session.",{category:"session",userMessage:"This session already has an active turn."});const s=await this.runtime.projectTrust.inspect(this.cwd);let o=await new $(this.runtime.sessionStore).require(e,s.fingerprint);t.params.sessionName!==void 0&&t.params.sessionName.trim()!==o.name&&(o=await this.runtime.sessionStore.rename(e,t.params.sessionName));const a=await this.executionWorkspaces.acquireTurn(e);let r=!1;const c=async()=>{r||(r=!0,await a())};let m=!1;try{const p=await this.executionWorkspaces.prepare({sessionId:e,projectRoot:s.canonicalPath}),l=this.attachments.take(t.params.attachmentIds??[],e),u=lt(),h=new AbortController;this.turnContexts.set(u,{...p,...t.params.taskId===void 0?{}:{taskId:t.params.taskId}}),this.activeTurnBySession.set(e,u);const x=this.executeTurn(t,o,s,p,u,h,l,c).catch(async C=>{await this.writeEvent(h.signal.aborted?"turn.cancelled":"turn.failed",{turnId:u,sessionId:e,...h.signal.aborted?{}:{error:b(C)}})}).finally(()=>{this.turns.delete(u),this.turnContexts.delete(u),this.activeTurnBySession.get(e)===u&&this.activeTurnBySession.delete(e),this.sessionStores.prune(this.activeTurnBySession.keys())});this.turns.set(u,{sessionId:e,controller:h,operation:x}),m=!0,await this.respond(t,{accepted:!0,turnId:u,sessionId:e})}finally{m||await c()}}async executeTurn(t,e,s,o,a,r,c,m){try{await this.executeTurnBody(t,e,s,o,a,r,c)}finally{await m()}}async executeTurnBody(t,e,s,o,a,r,c){const m=await P(this.runtime,this.cwd);if(!await this.runtime.projectTrust.isTrusted(s)){const n=K();if(await this.writeEvent("trust.requested",{trustRequestId:n,sessionId:e.id,path:s.canonicalPath}),!await this.approvalBroker.waitForTrust(n,r.signal))throw new g(y.PROJECT_TRUST_REQUIRED,"Project trust was not granted.",{category:"project",userMessage:"Trust this project in the Desktop application before running tools."});await this.runtime.projectTrust.grant(s),this.runtime.agentPreparation?.clear(s.canonicalPath),await this.runtime.workspaceSettings.ensureInitialized(s.canonicalPath)}const l=t.params.model??e.model??m.config.model;if(l==null)throw new g(y.MODEL_NOT_FOUND,"No model is selected.",{category:"model",userMessage:"Select a model before starting a turn."});const u=t.params.reasoningEffort??m.config.effort;this.runtime.logger.info("CLI Desktop turn model resolved.",{sessionId:e.id,turnId:a,requestedModel:t.params.model,sessionModel:e.model,resolvedModel:l});const h=e.profile??m.config.profile??T.defaultProfileName(),x=await this.runtime.auth.requireCredential(h),C=L(x.profile,x.apiKey),H=await xt(this.runtime,l,h),D=new ct,A=this.sessionStores.getOrCreate(e.id,this.activeTurnBySession.keys()),M=new Set,et=new Ct(this.runtime,s.canonicalPath),W=async()=>{try{const n=await et.buildForProject({sessionId:e.id,model:l,profileName:h,pluginNames:[],pendingAttachments:0,agentSessionStore:A});await this.writeEvent("usage.updated",{turnId:a,sessionId:e.id,model:l,...n.contextWindow===void 0?{}:{contextWindow:n.contextWindow},usage:{promptTokens:n.usedTokens,estimated:!0}})}catch(n){this.runtime.logger.warn("Desktop context usage update failed.",{sessionId:e.id,turnId:a,reason:n instanceof Error?n.message:String(n)})}},v=[],S=[];for(const n of c){const f=n.attachment.storagePath===void 0?await this.runtime.sessionStore.saveAttachment(e.id,n.attachment,n.bytes):n.attachment;S.push({...n,attachment:f})}await ft(this.runtime.sessionStore,e.id,a,t.params.prompt,S.map(n=>n.attachment.id)),await this.runtime.sessionStore.updateStatus(e.id,"active"),await this.writeEvent("turn.started",{turnId:a,sessionId:e.id,model:l});const at={onSubagentLifecycle:n=>this.writeEvent(`subagent.${n.type}`,St(n,a),{delivery:"best-effort"})},st={start:n=>{if(n.source!=="shell"&&n.source!=="computer"&&n.source!=="custom"&&n.toolName!=="filesystem.read"&&n.toolName!=="filesystem.write"&&n.toolName!=="filesystem.exists")return;const f={turnId:a,sessionId:e.id,actionId:n.key,toolName:n.toolName,displayName:n.label,...n.source==="shell"?{command:n.label}:{},kind:n.source??"tool",source:n.source},E=(w,I)=>{this.writeEvent(w,I,{delivery:"best-effort"}).catch(k=>this.runtime.logger.warn("Desktop tool activity event failed.",{event:w,reason:k instanceof Error?k.message:String(k)}))};return E("tool.activity.started",{...f,status:"running"}),{complete:(w,I)=>E("tool.activity.completed",{...f,...I??{},status:w?"failed":"completed",isError:w})}}};let B,O=!1;const U=setTimeout(()=>r.abort(),t.params.execution.timeoutMs);try{const n=t.params.execution,f=await V({runtime:this.runtime,projectRoot:s.canonicalPath,executionCwd:o.executionCwd,executionWorkspaceId:o.id,model:l,client:C,reasoningEffort:u,profile:"interactive-trusted",approvalMode:Pt(n.permissionPolicy),...n.allowedTools===void 0?{}:{allowedTools:n.allowedTools},...t.params.skills===void 0?{}:{selectedSkills:t.params.skills},browserAccess:n.browserAccess,subagentLifecycle:at,subagentJobs:this.subagentJobs,...this.browserHostEnabled?{browserHost:(i,d)=>this.hostBridge.requestBrowser(i,d)}:{},...this.desktopHostEnabled?{desktopHost:((i,d)=>this.hostBridge.requestDesktop(i,d))}:{},...this.computerHostEnabled?{computerHost:((i,d)=>this.hostBridge.requestComputer(i,d))}:{},onArtifacts:i=>{for(const d of i)M.add(d.id)},...this.hostCapabilities===void 0?{}:{hostCapabilities:this.hostCapabilities},executionBoundary:n.isolation,executionPlatform:n.isolation==="sandbox"?Vt():this.runtime.platform,browserExecution:n.browserExecution,hostFallback:n.hostFallback,...this.browserHostEnabled||this.desktopHostEnabled?{onExecutionFallbackApproval:(i,d)=>this.approvalBroker.waitForApproval(i,e.id,a,r.signal,"host",d)}:{},toolActivity:st,onIntentLifecycle:i=>this.intentEvents.write(i,e.id,a),contextManagement:it({client:C,model:l,...H===void 0?{}:{contextWindow:H},onCompactionStart:()=>this.writeEvent("context.compacting",{turnId:a,sessionId:e.id}),onSummaryFailure:i=>this.runtime.logger.warn("Context summarization failed; using fallback summary.",{reason:i instanceof Error?i.message:String(i)}),continuationContext:()=>dt({snapshot:D.snapshot()})}),agentSessionStore:A,prompt:(i,d)=>this.approvalBroker.waitForApproval(i,e.id,a,d??r.signal,n.isolation),rememberApproval:i=>this.runtime.workspaceSettings.rememberAllow(s.canonicalPath,wt(i.toolName,i.input)),audit:async i=>{const d={toolName:i.toolName,stage:i.stage,sessionId:i.sessionId,runId:i.runId,decision:i.decision,reason:i.reason,...i.source===void 0?{}:{source:i.source},...i.executorId===void 0?{}:{executorId:i.executorId},...i.ruleId===void 0?{}:{ruleId:i.ruleId},...i.skillName===void 0?{}:{skillName:i.skillName},...i.riskCategory===void 0?{}:{riskCategory:i.riskCategory}};this.runtime.logger.info("Tool authorization decision.",d),await this.runtime.sessionStore.appendEvent({type:"tool.approval",timestamp:new Date().toISOString(),sessionId:e.id,turnId:a,data:d})},onModelComplete:i=>{D.observeModel(i),i.usage!==void 0&&this.writeEvent("usage.updated",{turnId:a,sessionId:e.id,model:l,usage:i.usage},{delivery:"best-effort"}).catch(d=>this.runtime.logger.warn("Desktop usage event failed.",{reason:d instanceof Error?d.message:String(d)}))},onWrite:i=>{this.writeEvent("file.changed",{turnId:a,sessionId:e.id,change:i},{delivery:"best-effort"}).catch(d=>this.runtime.logger.warn("Desktop file event failed.",{reason:d instanceof Error?d.message:String(d)}))},mcpLifecycle:i=>this.writeMcpRuntimeEvent(i,e.id,a)});B=f.close;const E=new mt,w=await f.buildInput(t.params.prompt),I=await this.runtime.sessionStore.readHistory(e.id);A.hydrate(e.id,I.transcript,I.events,w.input);const k=Yt(w.input,S.map(({attachment:i,bytes:d})=>({byteLength:d.byteLength,mimeType:i.mimeType,name:i.name})));if(!k.isWithinLimit)throw new g(y.ATTACHMENT_TOO_LARGE,"The prompt and attachments exceed the Gateway JSON body limit.",{category:"attachment",userMessage:`The prompt and attachments exceed the ${k.limitBytes/1e6} MB decimal Gateway JSON limit. Remove an attachment or shorten the prompt and retry.`,details:{kind:"gateway-json-body",maxBytes:k.limitBytes,projectedBytes:k.projectedBytes}});const G=S.length===0?void 0:At(w.input,S),F=G?.content===null?void 0:G?.content,ot=await f.agent.initialize();for(const i of ot)(i.type==="mcp.server.status"||i.type==="mcp.tool.catalog.updated")&&await this.writeMcpEvent(i,e.id,a);for await(const i of f.run({input:w.input,userInput:w.userInput,...w.workspaceContext===void 0?{}:{workspaceContext:w.workspaceContext},...F===void 0?{}:{inputContent:F},model:l,sessionId:e.id,stream:!0,signal:r.signal,metadata:{taskId:t.params.taskId,turnId:a}})){D.observe(i),(i.type==="mcp.server.status"||i.type==="mcp.tool.catalog.updated")&&await this.writeMcpEvent(i,e.id,a),i.type==="context.compacted"&&(await nt(this.runtime,f,e.id,i.metrics,a),await W());const d=E.observe(i);for(const N of d)await this.emitProjected(N,e.id,a,v,M);if(i.type==="session.failed"){const N=yt(i.error);if(N===void 0)throw i.error;const z=gt(N);v.push(z);const J=`${a}:final`;await this.writeEvent("assistant.delta",{turnId:a,sessionId:e.id,segmentId:J,iteration:0,content:z}),await this.writeEvent("assistant.segment.completed",{turnId:a,sessionId:e.id,segmentId:J,iteration:0,phase:"final",..._(M)});break}}if(v.join("").trim().length===0)throw new g(y.MODEL_PROTOCOL_EMPTY_RESPONSE,"Agent completed without a final text response.",{category:"model",userMessage:"The model completed without a final text response.",retryable:!0});await this.executionWorkspaces.apply(e.id),O=!0,await ht(this.runtime.sessionStore,e.id,a,v.join("")),await this.runtime.sessionStore.updateStatus(e.id,"completed"),await W(),await this.writeEvent("turn.completed",{turnId:a,sessionId:e.id,content:v.join(""),..._(M)})}catch(n){if(!O)try{const E=await this.executionWorkspaces.apply(e.id);O=!0,E.appliedPaths.length>0&&this.runtime.logger.info("Applied session workspace changes after turn failure.",{sessionId:e.id,turnId:a,appliedPaths:E.appliedPaths})}catch(E){this.runtime.logger.error("Failed to apply session workspace changes after turn failure.",{sessionId:e.id,turnId:a,reason:E instanceof Error?E.message:String(E)})}const f=r.signal.aborted;throw await ut(this.runtime.sessionStore,e.id,a,n,f),await this.runtime.sessionStore.updateStatus(e.id,f?"cancelled":"failed"),n}finally{if(this.intentEvents.clear(a),U!==void 0&&clearTimeout(U),B!==void 0)try{await B()}catch(n){this.runtime.logger.warn("Desktop agent cleanup failed.",{reason:n instanceof Error?n.message:String(n)})}await this.executionWorkspaces.markReady(e.id)}}async emitProjected(t,e,s,o,a){t.type==="assistant.delta"?(o.push(t.content),await this.writeEvent("assistant.delta",{turnId:s,sessionId:e,segmentId:t.segmentId,iteration:t.iteration,content:t.content})):t.type==="assistant.replaced"?(o.splice(0,o.length,t.content),await this.writeEvent("assistant.replaced",{turnId:s,sessionId:e,segmentId:t.segmentId,iteration:t.iteration,content:t.content})):t.type==="assistant.segment.completed"?await this.writeEvent("assistant.segment.completed",{turnId:s,sessionId:e,segmentId:t.segmentId,iteration:t.iteration,phase:t.phase,...t.phase==="final"?_(a):{}}):t.type==="action.started"?await this.writeEvent("tool.started",{turnId:s,sessionId:e,actionId:t.actionId,toolName:t.toolName,displayName:t.displayName,kind:t.kind,...t.source===void 0?{}:{source:t.source}}):t.type==="action.completed"?await this.writeEvent("tool.completed",{turnId:s,sessionId:e,actionId:t.actionId,toolName:t.toolName,displayName:t.displayName,kind:t.kind,status:t.status,isError:t.isError}):t.type==="context.compacted"&&await this.writeEvent("context.compacted",{turnId:s,sessionId:e}),await pt(this.runtime.sessionStore,e,t,{turnId:s})}async writeMcpEvent(t,e,s){const o=q(t,e,s);await this.writeEvent(o.name,o.data)}async writeMcpRuntimeEvent(t,e,s){const o=q(t,e,s);await this.writeEvent(o.name,o.data)}async cancelTurn(t){const e=this.turns.get(t.params.turnId);if(e===void 0)throw new g(y.INVALID_ARGUMENT,"Turn is not active.",{category:"session",userMessage:"The requested turn is not active."});e.controller.abort(),await this.respond(t,{cancelled:!0,turnId:t.params.turnId}),await e.operation.catch(s=>this.runtime.logger.warn("Cancelled Desktop turn cleanup reported an error.",{turnId:t.params.turnId,reason:s instanceof Error?s.message:String(s)}))}async respondApproval(t){const e=t.params.decision==="redirect"?{decision:"redirect",message:t.params.message}:{decision:t.params.decision};if(!this.approvalBroker.respondApproval(t.params.approvalId,e))throw new g(y.INVALID_ARGUMENT,"Approval request is no longer active.",{category:"arguments",userMessage:"This approval request is no longer active."});await this.respond(t,{accepted:!0})}async respondTrust(t){if(!this.approvalBroker.respondTrust(t.params.trustRequestId,t.params.trusted))throw new g(y.INVALID_ARGUMENT,"Trust request is no longer active.",{category:"arguments",userMessage:"This trust request is no longer active."});await this.respond(t,{accepted:!0})}async listModels(t){const e=await tt(this.runtime,this.cwd);await this.respond(t,{models:e.data})}async authStatus(t){const s=(await this.runtime.configLoader.load(this.cwd,{includeProject:!1})).config.profile??T.defaultProfileName(),o=await this.runtime.credentialStore.get(s);await this.respond(t,{authenticated:o!==void 0,profile:s,...o===void 0?{}:{baseUrl:o.profile.baseUrl,credentialRef:o.profile.credentialRef}})}async synthesizeSpeech(t){const s=(await P(this.runtime,this.cwd)).config.profile??T.defaultProfileName(),o=await this.runtime.auth.requireCredential(s),a=await tt(this.runtime,this.cwd),r=Ft(t.params.model,a.data),c=new AbortController;this.speechRequests.set(t.id,c);const m=setTimeout(()=>c.abort(new Error("Desktop speech synthesis timed out.")),Jt);try{const p=await new Gt(L(o.profile,o.apiKey)).createSpeech({model:r,input:t.params.input,voice:t.params.voice,responseFormat:t.params.responseFormat??"mp3"},{signal:c.signal});if(p.bytes.byteLength===0||p.bytes.byteLength>zt)throw new g(y.MEDIA_RESPONSE_TOO_LARGE,"Generated speech exceeds the Desktop playback limit.",{category:"media",userMessage:"The generated speech is too large to play in the Desktop app."});await this.respond(t,{contentType:p.contentType??"audio/mpeg",bytesBase64:Buffer.from(p.bytes).toString("base64")})}finally{clearTimeout(m),this.speechRequests.get(t.id)===c&&this.speechRequests.delete(t.id)}}async listCommands(t){await this.respond(t,kt())}async startCommand(t){const s=X.get(t.params.actionId)?.desktop?.mutationKey;if(s!==void 0&&(this.turns.size>0||[...this.commands.values()].some(p=>p.mutationKey===s)))throw new g(y.INVALID_ARGUMENT,`Desktop command conflicts with an active ${s} operation.`,{category:"command",userMessage:"Wait for the active operation to finish before changing this resource."});const o=K(),a=new AbortController,r=typeof t.params.options.scope=="string"?t.params.options.scope:void 0;this.logInfo("CLI Desktop command started.",{commandId:o,actionId:t.params.actionId,...r===void 0?{}:{scope:r}});const c=Promise.resolve().then(()=>this.executeCommand(t,o,a)).catch(async p=>{if(a.signal.aborted){this.logWarn("CLI Desktop command cancelled.",{commandId:o,actionId:t.params.actionId}),await this.writeEvent("command.cancelled",{commandId:o,actionId:t.params.actionId});return}this.logError("CLI Desktop command failed.",{commandId:o,actionId:t.params.actionId,code:b(p).code}),await this.writeEvent("command.failed",{commandId:o,actionId:t.params.actionId,error:b(p)})}).finally(()=>this.commands.delete(o));this.commands.set(o,{controller:a,operation:c,...s===void 0?{}:{mutationKey:s}});const m={accepted:!0,commandId:o,actionId:t.params.actionId};await this.respond(t,m)}async executeCommand(t,e,s){await this.writeEvent("command.started",{commandId:e,actionId:t.params.actionId});const o=await bt({runtime:this.runtime,cwd:this.cwd,invocation:t.params,signal:s.signal,output:{write:(a,r)=>this.writeEvent("command.output",{commandId:e,actionId:t.params.actionId,content:a,...r===void 0?{}:{structured:r}})},activity:{started:(a,r)=>this.writeEvent("command.activity.started",{commandId:e,actionId:t.params.actionId,key:a,label:r}),completed:(a,r)=>this.writeEvent("command.activity.completed",{commandId:e,actionId:t.params.actionId,key:a,isError:r})},onActivityError:a=>this.runtime.logger.warn("Desktop command activity event failed.",{commandId:e,reason:a instanceof Error?a.message:String(a)})});if(o===0&&t.params.actionId==="session.delete"){const a=t.params.positionals[1];a!==void 0&&(await this.subagentJobs.closeSession(a),this.sessionStores.delete(a))}o===0&&Mt(t.params.actionId,X.get(t.params.actionId)?.desktop?.mutationKey)&&this.runtime.agentPreparation?.clear(),await this.writeEvent("command.completed",{commandId:e,actionId:t.params.actionId,exitCode:o,success:o===0}),this.logInfo("CLI Desktop command completed.",{commandId:e,actionId:t.params.actionId,exitCode:o,success:o===0})}logInfo(t,e){this.runtime.logger?.info(t,e)}logWarn(t,e){this.runtime.logger?.warn(t,e)}logError(t,e){this.runtime.logger?.error(t,e)}async cancelCommand(t){const e=this.commands.get(t.params.commandId);if(e===void 0)throw new g(y.INVALID_ARGUMENT,"Command is not active.",{category:"command",userMessage:"The requested command is not active."});e.controller.abort(),await this.respond(t,{accepted:!0,commandId:t.params.commandId})}async respond(t,e){await this.writer.write({version:R,id:t.id,type:"response",method:t.method,ok:!0,result:e})}async writeError(t,e,s){await this.writer.write({version:R,id:t,type:"response",method:e,ok:!1,error:s})}async writeEvent(t,e,s={}){const o=typeof e.turnId=="string"?e.turnId:void 0,a=o===void 0?void 0:this.turnContexts.get(o),r=a===void 0?{}:{projectRoot:a.projectRoot,executionCwd:a.executionCwd,executionWorkspaceId:a.id,...a.taskId===void 0?{}:{taskId:a.taskId}};await this.writer.write({version:R,type:"event",scope:typeof e.sessionId=="string"?"session":"control",event:t,data:{...r,...e}},s)}}export{Ke as DESKTOP_PROTOCOL_VERSION,Fe as runDesktopAgentCommand};

package/dist/application/protocol/desktop-agent-contracts.d.ts

@@ -0,0 +1,34 @@
+import type { DesktopHostWireMessage } from './desktop-host-bridge.js';
+export declare const DESKTOP_PROTOCOL_VERSION: 1;
+export declare const TITLE_GENERATION_TIMEOUT_MS = 25000;
+export declare const DESKTOP_SPEECH_SYNTHESIS_TIMEOUT_MS = 60000;
+export declare const DESKTOP_SPEECH_MAX_BYTES = 2500000;
+export type DesktopResponse = {
+    version: 1;
+    id: string;
+    type: 'response';
+    method: string;
+    ok: true;
+    result?: unknown;
+} | {
+    version: 1;
+    id: string;
+    type: 'response';
+    method: string;
+    ok: false;
+    error: DesktopError;
+};
+export type DesktopEvent = {
+    version: 1;
+    type: 'event';
+    scope: 'session' | 'control';
+    event: string;
+    data: Record<string, unknown>;
+};
+export type DesktopError = {
+    code: string;
+    category: string;
+    message: string;
+    retryable: boolean;
+};
+export type DesktopWireMessage = DesktopResponse | DesktopEvent | DesktopHostWireMessage;

package/dist/application/protocol/desktop-agent-contracts.js

@@ -0,0 +1 @@
+const _=1,E=25e3,T=6e4,S=25e5;export{_ as DESKTOP_PROTOCOL_VERSION,S as DESKTOP_SPEECH_MAX_BYTES,T as DESKTOP_SPEECH_SYNTHESIS_TIMEOUT_MS,E as TITLE_GENERATION_TIMEOUT_MS};

package/dist/application/protocol/desktop-agent-helpers.d.ts

@@ -0,0 +1,5 @@
+export declare function artifactIdsData(artifactIds: ReadonlySet<string>): Record<string, unknown>;
+export declare function resolveSpeechModel(requested: string | undefined, models: readonly {
+    id: string;
+    [key: string]: unknown;
+}[]): string;

package/dist/application/protocol/desktop-agent-helpers.js

@@ -0,0 +1 @@
+import{CliError as i}from"../../domain/errors/cli-error.js";import{CLI_ERROR_CODES as a}from"../../domain/errors/error-codes.js";function d(e){return e.size===0?{}:{artifactIds:[...e]}}function s(e,n){if(e!==void 0){const o=n.find(r=>r.id===e);if(o===void 0)throw new i(a.MODEL_NOT_FOUND,`Speech model is not available: ${e}`,{category:"model",userMessage:`Speech model is not available: ${e}.`});if(o.model_category!==void 0&&o.model_category!=="speech")throw new i(a.MODEL_NOT_FOUND,`Model is not a speech model: ${e}`,{category:"model",userMessage:`Model ${e} cannot synthesize speech.`});return e}const l=n.find(o=>o.model_category==="speech")?.id;if(l!==void 0)return l;throw new i(a.MODEL_NOT_FOUND,"No speech model is available.",{category:"model",userMessage:"No speech model is available for Live Chat."})}export{d as artifactIdsData,s as resolveSpeechModel};

package/dist/application/protocol/desktop-agent-request-parser.d.ts

@@ -0,0 +1,211 @@
+import type { DesktopCommandInvocation } from './desktop-command-contract.js';
+import { type DesktopExecutionPolicy } from './desktop-execution-policy.js';
+import type { BrowserHostResponse } from './browser-host-tool-executor.js';
+import type { DesktopHostExecutionResponse } from './desktop-host-tool-executor.js';
+import type { ComputerHostResponse } from './computer-host-tool-executor.js';
+type DesktopApprovalRequestDecision = {
+    approvalId: string;
+    decision: 'allow' | 'deny';
+} | {
+    approvalId: string;
+    decision: 'redirect';
+    message: string;
+};
+export type DesktopRequest = {
+    version: 1;
+    id: string;
+    method: 'initialize';
+    params: Record<string, unknown>;
+} | {
+    version: 1;
+    id: string;
+    method: 'session.create';
+    params: {
+        model?: string;
+        name?: string;
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'session.list';
+    params: Record<string, unknown>;
+} | {
+    version: 1;
+    id: string;
+    method: 'session.resume';
+    params: {
+        sessionId: string;
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'extension.listPublicPlugins';
+    params: {
+        root: string;
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'extension.resolvePublicPluginSource';
+    params: {
+        root: string;
+        name: string;
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'extension.readPublicPluginContribution';
+    params: {
+        root: string;
+        pluginName: string;
+        kind: 'skill' | 'mcp' | 'hook';
+        sourceName: string;
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'extension.readDetail';
+    params: {
+        kind: 'hook' | 'skill' | 'plugin' | 'mcp';
+        name: string;
+        scope?: 'user' | 'project' | 'plugin' | 'builtin';
+        pluginName?: string;
+        pluginScope?: 'user' | 'project';
+        sourceName?: string;
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'extension.readPluginIcon';
+    params: {
+        name: string;
+        scope: 'user' | 'project';
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'title.generate';
+    params: {
+        prompt: string;
+        model?: string;
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'speech.synthesize';
+    params: {
+        input: string;
+        voice: string;
+        model?: string;
+        responseFormat?: 'mp3' | 'opus' | 'aac' | 'flac' | 'wav' | 'pcm';
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'attachment.begin';
+    params: {
+        attachmentId: string;
+        sessionId?: string;
+        name: string;
+        mimeType: string;
+        sizeBytes: number;
+        storageName?: string;
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'attachment.chunk';
+    params: {
+        attachmentId: string;
+        index: number;
+        dataBase64: string;
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'attachment.complete';
+    params: {
+        attachmentId: string;
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'attachment.delete';
+    params: {
+        sessionId: string;
+        attachmentId: string;
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'turn.start';
+    params: {
+        sessionId: string;
+        prompt: string;
+        model?: string;
+        reasoningEffort?: string;
+        runId?: string;
+        taskId?: string;
+        sessionName?: string;
+        attachmentIds?: string[];
+        skills?: string[];
+        execution: DesktopExecutionPolicy;
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'turn.cancel';
+    params: {
+        turnId: string;
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'approval.respond';
+    params: DesktopApprovalRequestDecision;
+} | {
+    version: 1;
+    id: string;
+    method: 'trust.respond';
+    params: {
+        trustRequestId: string;
+        trusted: boolean;
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'model.list';
+    params: Record<string, unknown>;
+} | {
+    version: 1;
+    id: string;
+    method: 'auth.status';
+    params: Record<string, unknown>;
+} | {
+    version: 1;
+    id: string;
+    method: 'command.list';
+    params: Record<string, unknown>;
+} | {
+    version: 1;
+    id: string;
+    method: 'command.execute';
+    params: DesktopCommandInvocation;
+} | {
+    version: 1;
+    id: string;
+    method: 'command.cancel';
+    params: {
+        commandId: string;
+    };
+} | {
+    version: 1;
+    id: string;
+    method: 'shutdown';
+    params: Record<string, unknown>;
+};
+export declare function parseDesktopRequest(value: unknown): DesktopRequest;
+export declare function isBrowserHostResponse(value: unknown): value is BrowserHostResponse;
+export declare function isDesktopHostResponse(value: unknown): value is DesktopHostExecutionResponse;
+export declare function isComputerHostResponse(value: unknown): value is ComputerHostResponse;
+export {};

package/dist/application/protocol/desktop-agent-request-parser.js

@@ -0,0 +1 @@
+import{parseDesktopExecutionPolicy as y}from"./desktop-execution-policy.js";import{RESOURCE_LIMITS as i}from"../../domain/runtime/resource-limits.js";import{GATEWAY_MEDIA_LIMITS as h}from"../../domain/media/gateway-media-contract.js";function F(n){if(!a(n)||n.version!==1||!c(n.id)||!a(n.params)||typeof n.method!="string")throw o("Invalid Desktop protocol request.");const e=n.id,t=n.method,r=n.params;if(t==="initialize"||t==="session.list"||t==="model.list"||t==="auth.status"||t==="command.list"||t==="shutdown")return{version:1,id:e,method:t,params:r};if(t==="session.create")return{version:1,id:e,method:t,params:{...u(r,"model"),...u(r,"name")}};if(t==="session.resume")return{version:1,id:e,method:t,params:{sessionId:s(r,"sessionId")}};if(t==="extension.listPublicPlugins")return{version:1,id:e,method:t,params:{root:m(r,"root")}};if(t==="extension.resolvePublicPluginSource")return{version:1,id:e,method:t,params:{root:m(r,"root"),name:l(r,"name","public plugin")}};if(t==="extension.readPublicPluginContribution")return{version:1,id:e,method:t,params:{root:m(r,"root"),pluginName:l(r,"pluginName","plugin"),kind:b(r),sourceName:l(r,"sourceName","extension")}};if(t==="extension.readDetail")return{version:1,id:e,method:t,params:x(r)};if(t==="extension.readPluginIcon")return{version:1,id:e,method:t,params:{name:l(r,"name","plugin"),scope:B(r,"scope")}};if(t==="title.generate")return{version:1,id:e,method:t,params:{prompt:I(r),...u(r,"model")}};if(t==="speech.synthesize")return{version:1,id:e,method:t,params:{input:q(r),voice:k(r),...u(r,"model"),...S(r)}};if(t==="attachment.begin")return{version:1,id:e,method:t,params:{attachmentId:s(r,"attachmentId"),...N(r,"sessionId"),name:j(r),mimeType:$(r),sizeBytes:E(r),...L(r)}};if(t==="attachment.chunk")return{version:1,id:e,method:t,params:{attachmentId:s(r,"attachmentId"),index:R(r),dataBase64:D(r)}};if(t==="attachment.complete")return{version:1,id:e,method:t,params:{attachmentId:s(r,"attachmentId")}};if(t==="attachment.delete")return{version:1,id:e,method:t,params:{sessionId:s(r,"sessionId"),attachmentId:s(r,"attachmentId")}};if(t==="turn.start")return{version:1,id:e,method:t,params:{sessionId:s(r,"sessionId"),prompt:I(r),...u(r,"model"),...u(r,"reasoningEffort"),...u(r,"runId"),...u(r,"taskId"),...u(r,"sessionName"),...C(r),...K(r),execution:M(r)}};if(t==="turn.cancel")return{version:1,id:e,method:t,params:{turnId:s(r,"turnId")}};if(t==="approval.respond")return{version:1,id:e,method:t,params:P(r)};if(t==="trust.respond")return{version:1,id:e,method:t,params:{trustRequestId:s(r,"trustRequestId"),trusted:z(r,"trusted")}};if(t==="command.execute")return{version:1,id:e,method:t,params:v(r)};if(t==="command.cancel")return{version:1,id:e,method:t,params:{commandId:s(r,"commandId")}};throw o("Unsupported Desktop protocol method.")}function H(n){return!a(n)||n.version!==1||n.type!=="host.response"||n.tool!=="browser"||!c(n.requestId)||typeof n.ok!="boolean"?!1:n.error===void 0||a(n.error)}function O(n){return!a(n)||n.version!==1||n.type!=="host.response"||!["filesystem","shell","git","artifact"].includes(String(n.tool))||!c(n.requestId)||typeof n.ok!="boolean"?!1:n.error===void 0||a(n.error)}function U(n){return!a(n)||n.version!==1||n.type!=="host.response"||n.tool!=="computer"||!c(n.requestId)||typeof n.ok!="boolean"?!1:n.error===void 0||a(n.error)}function v(n){const e=s(n,"actionId"),t=n.positionals;if(!Array.isArray(t)||t.some(f=>typeof f!="string"||Buffer.byteLength(f,"utf8")>i.jsonlPromptBytes))throw o("Invalid command positionals.");const r=n.options;if(!a(r)||Object.entries(r).some(([f,p])=>!c(f)||typeof p!="string"&&typeof p!="boolean"||typeof p=="string"&&Buffer.byteLength(p,"utf8")>i.jsonlPromptBytes))throw o("Invalid command options.");const d=n.secrets;if(d===void 0)return{actionId:e,positionals:t,options:r};if(e!=="auth.login.direct"||!a(d)||Object.keys(d).some(f=>f!=="apiKey")||typeof d.apiKey!="string"||d.apiKey.length===0||Buffer.byteLength(d.apiKey,"utf8")>i.jsonlPromptBytes)throw o("Invalid command secrets.");return{actionId:e,positionals:t,options:r,secrets:{apiKey:d.apiKey}}}function s(n,e){const t=n[e];if(!c(t))throw o(`Invalid ${e}.`);return t}function m(n,e){const t=n[e];if(typeof t!="string"||t.trim().length===0||t.includes("\0")||Buffer.byteLength(t,"utf8")>i.jsonlPathBytes)throw o(`Invalid ${e}.`);return t}function l(n,e,t){const r=n[e];if(typeof r!="string"||!/^[a-z0-9][a-z0-9-]{0,63}$/u.test(r))throw o(`Invalid ${t} name.`);return r}function w(n,e){const t=n[e];if(typeof t!="string"||t.length===0||t.length>256||t.includes("\0")||!/^[a-z0-9][a-z0-9:_-]*$/u.test(t))throw o("Invalid extension name.");return t}function b(n){const e=n.kind;if(e!=="skill"&&e!=="mcp"&&e!=="hook")throw o("Invalid extension kind.");return e}function B(n,e){const t=n[e];if(t!=="user"&&t!=="project")throw o(`Invalid ${e}.`);return t}function x(n){const e=n.kind;if(e!=="hook"&&e!=="skill"&&e!=="plugin"&&e!=="mcp")throw o("Invalid extension kind.");const t=n.scope;if(t!==void 0&&t!=="user"&&t!=="project"&&t!=="plugin"&&t!=="builtin")throw o("Invalid extension scope.");const r=w(n,"name");return{kind:e,name:r,...t===void 0?{}:{scope:t},...g(n,"pluginName"),...A(n,"pluginScope"),...g(n,"sourceName")}}function g(n,e){const t=n[e];if(t===void 0)return{};if(typeof t!="string"||!/^[a-z0-9][a-z0-9-]{0,63}$/u.test(t))throw o(`Invalid ${e}.`);return{[e]:t}}function A(n,e){const t=n[e];if(t===void 0)return{};if(t!=="user"&&t!=="project")throw o(`Invalid ${e}.`);return{[e]:t}}function I(n){const e=n.prompt;if(typeof e!="string"||e.trim().length===0||Buffer.byteLength(e,"utf8")>i.jsonlPromptBytes)throw o("Invalid prompt.");return e}function q(n){const e=n.input;if(typeof e!="string"||e.trim().length===0||[...e].length>h.speechInputCharacters)throw o("Invalid speech input.");return e}function k(n){const e=n.voice;if(typeof e!="string"||e.trim().length===0||[...e].length>h.speechVoiceCharacters)throw o("Invalid speech voice.");return e}function S(n){const e=n.responseFormat;if(e===void 0)return{};if(e!=="mp3"&&e!=="opus"&&e!=="aac"&&e!=="flac"&&e!=="wav"&&e!=="pcm")throw o("Invalid speech response format.");return{responseFormat:e}}function z(n,e){if(typeof n[e]!="boolean")throw o(`Invalid ${e}.`);return n[e]}function P(n){const e=s(n,"approvalId"),t=n.decision;if(t!=="allow"&&t!=="deny"&&t!=="redirect")throw o("Invalid approval decision.");const r=n.message;if(r!==void 0&&(typeof r!="string"||r.trim().length===0||Buffer.byteLength(r,"utf8")>i.jsonlPromptBytes))throw o("Invalid approval message.");if(t==="redirect"&&r===void 0)throw o("Approval redirect requires a message.");if(t!=="redirect"&&r!==void 0)throw o("Approval message is only valid for redirect decisions.");return t==="redirect"?{approvalId:e,decision:t,message:r}:{approvalId:e,decision:t}}function u(n,e){const t=n[e];if(t===void 0)return{};if(typeof t!="string"||t.length===0||Buffer.byteLength(t,"utf8")>i.jsonlIdBytes)throw o(`Invalid ${e}.`);return{[e]:t}}function N(n,e){const t=n[e];if(t===void 0)return{};if(!c(t))throw o(`Invalid ${e}.`);return{[e]:t}}function j(n){const e=n.name;if(typeof e!="string"||e.length===0||e.length>200||e.includes("\0"))throw o("Invalid attachment name.");return e}function $(n){const e=n.mimeType;if(typeof e!="string"||!/^[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]*\/[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]*$/u.test(e)||Buffer.byteLength(e,"utf8")>i.jsonlIdBytes)throw o("Invalid attachment MIME type.");return e}function E(n){const e=n.sizeBytes;if(typeof e!="number"||!Number.isSafeInteger(e)||e<=0||e>i.maxAttachmentBytes)throw o("Invalid attachment size.");return e}function L(n){const e=n.storageName;if(e===void 0)return{};if(typeof e!="string"||e.length===0||e.length>200||e.includes("\0")||/[\\/]/u.test(e))throw o("Invalid attachment storage name.");return{storageName:e}}function R(n){const e=n.index;if(typeof e!="number"||!Number.isSafeInteger(e)||e<0)throw o("Invalid attachment chunk index.");return e}function D(n){const e=n.dataBase64;if(typeof e!="string"||e.length===0||Buffer.byteLength(e,"utf8")>Math.ceil(i.desktopAttachmentChunkBytes/3)*4+4)throw o("Invalid attachment chunk.");return e}function C(n){const e=n.attachmentIds;if(e===void 0)return{};if(!Array.isArray(e)||e.length>i.pendingAttachments||e.some(t=>!c(t))||new Set(e).size!==e.length)throw o("Invalid attachment ids.");return{attachmentIds:e}}function K(n){const e=n.skills;if(e===void 0)return{};if(!Array.isArray(e)||e.length>32||e.some(t=>!c(t))||new Set(e).size!==e.length)throw o("Invalid skills.");return{skills:e}}function M(n){return y(n.execution)}function c(n){return typeof n=="string"&&n.length>0&&Buffer.byteLength(n,"utf8")<=i.jsonlIdBytes}function a(n){return typeof n=="object"&&n!==null&&!Array.isArray(n)}function o(n){return new Error(n)}export{H as isBrowserHostResponse,U as isComputerHostResponse,O as isDesktopHostResponse,F as parseDesktopRequest};