@agimon-ai/doompi-computer-use 0.0.1-alpha.2 → 0.0.1-alpha.21

package/dist/src/services/webComputerUseChannel/index.mjs

@@ -0,0 +1,250 @@
+import { API_BASE_PATH, COMPUTER_USE_ROUTES, computerUseChannelType } from "../../types/computerUseApi.mjs";
+import { MissingComputerUseApiError, computerUseSessionApiError } from "../webComputerUseAvailability/index.mjs";
+import { randomUUID } from "node:crypto";
+//#region src/services/webComputerUseChannel/index.ts
+/** Computer use runs on the DoomPi Desktop host, so every other client declines it. */
+const DESKTOP_UNAVAILABLE = "DoomPi Desktop computer use is unavailable.";
+function record(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function command(value) {
+	const input = record(value);
+	return input?.action === "status" || input?.action === "targets" || input?.action === "stop" || input?.action === "artifacts" ? { action: input.action } : void 0;
+}
+async function responseJson(response) {
+	const value = await response.json();
+	if (!response.ok) throw computerUseSessionApiError(response.status, value);
+	return value;
+}
+function sessionState(value) {
+	const input = record(value);
+	if (typeof input?.sessionId !== "string" || typeof input.revision !== "number" || typeof input.wake !== "number" || ![
+		"inactive",
+		"awaiting_confirmation",
+		"activating",
+		"active",
+		"stopping",
+		"failed"
+	].includes(input.phase)) return void 0;
+	return input;
+}
+function createComputerUseChannel() {
+	let receiveCommand;
+	return {
+		frameType: computerUseChannelType,
+		lifecycle: "hub",
+		start(host) {
+			const scopes = /* @__PURE__ */ new Map();
+			const latest = /* @__PURE__ */ new Map();
+			const targets = /* @__PURE__ */ new Map();
+			const grants = /* @__PURE__ */ new Map();
+			const subscriptions = /* @__PURE__ */ new Map();
+			const processing = /* @__PURE__ */ new Set();
+			let activeSessionId;
+			let closed = false;
+			const sessionRequest = async (scope, path, method = "GET", value) => host.requestSessionApi(scope, {
+				basePath: API_BASE_PATH,
+				path,
+				method,
+				...value === void 0 ? {} : { body: JSON.stringify(value) }
+			});
+			const publish = (scope, state) => {
+				if (state.phase === "active" || state.phase === "activating" || state.phase === "stopping") activeSessionId = scope.sessionId;
+				else if (activeSessionId === scope.sessionId) {
+					activeSessionId = void 0;
+					grants.delete(scope.sessionId);
+				}
+				const payload = {
+					state,
+					targets: targets.get(scope.sessionId) ?? [],
+					...activeSessionId !== void 0 && activeSessionId !== scope.sessionId ? { busy: true } : {}
+				};
+				latest.set(scope.sessionId, payload);
+				host.publish(scope.sessionId, payload);
+			};
+			const refresh = async (scope) => {
+				const state = sessionState(await responseJson(await sessionRequest(scope, COMPUTER_USE_ROUTES.hubState)));
+				if (state === void 0) throw new Error("Computer-use API returned an invalid session state.");
+				publish(scope, state);
+				return state;
+			};
+			const completePending = async (scope, pending) => {
+				if (!host.computerUse?.available) throw new Error(DESKTOP_UNAVAILABLE);
+				try {
+					const result = await host.computerUse.request(scope, {
+						operation: pending.operation,
+						payload: pending.operation === "act" ? {
+							grantId: pending.grantId,
+							sequence: pending.sequence,
+							action: pending.payload
+						} : { grantId: pending.grantId }
+					});
+					await responseJson(await sessionRequest(scope, COMPUTER_USE_ROUTES.hubComplete, "POST", {
+						id: pending.id,
+						result
+					}));
+				} catch (error) {
+					await responseJson(await sessionRequest(scope, COMPUTER_USE_ROUTES.hubComplete, "POST", {
+						id: pending.id,
+						error: error instanceof Error ? error.message : String(error)
+					}));
+				}
+			};
+			const stopSession = async (scope) => {
+				const authorization = await responseJson(await sessionRequest(scope, COMPUTER_USE_ROUTES.hubAuthorization));
+				let artifact;
+				if (authorization !== null && host.computerUse?.available) try {
+					artifact = await host.computerUse.request(scope, {
+						operation: "stop",
+						payload: { grantId: authorization.grantId }
+					});
+				} catch (error) {
+					const message = error instanceof Error ? error.message : String(error);
+					artifact = {
+						artifactId: randomUUID(),
+						status: "failed",
+						failure: {
+							code: "recording_failed",
+							message: message.slice(0, 512)
+						}
+					};
+					host.onNotice(`computer-use Desktop stop was already unavailable (${message})`);
+				}
+				await responseJson(await sessionRequest(scope, COMPUTER_USE_ROUTES.hubStop, "POST", { artifact }));
+				grants.delete(scope.sessionId);
+				if (activeSessionId === scope.sessionId) activeSessionId = void 0;
+			};
+			const processScope = async (scope, announced) => {
+				if (closed || processing.has(scope.sessionId)) return;
+				processing.add(scope.sessionId);
+				try {
+					const state = announced ?? await refresh(scope);
+					if (state.phase === "active") {
+						if (!grants.has(scope.sessionId)) {
+							const authorization = await responseJson(await sessionRequest(scope, COMPUTER_USE_ROUTES.hubAuthorization));
+							if (authorization !== null) grants.set(scope.sessionId, authorization.grantId);
+						}
+						const expired = typeof state.expiresAt === "number" && state.expiresAt <= Date.now();
+						let owned = false;
+						if (!expired && host.computerUse?.available) try {
+							owned = record(await host.computerUse.request(scope, { operation: "status" }))?.ownedBySession === true;
+						} catch {
+							owned = true;
+						}
+						if (expired || !owned) {
+							await stopSession(scope);
+							await refresh(scope);
+							return;
+						}
+					}
+					if (state.phase === "awaiting_confirmation" && (activeSessionId === void 0 || activeSessionId === scope.sessionId)) {
+						const activation = await responseJson(await sessionRequest(scope, COMPUTER_USE_ROUTES.hubActivation));
+						if (activation !== null && !host.computerUse?.available) {
+							await responseJson(await sessionRequest(scope, COMPUTER_USE_ROUTES.hubStop, "POST", { error: DESKTOP_UNAVAILABLE }));
+							await refresh(scope);
+							return;
+						}
+						if (activation !== null && host.computerUse?.available) {
+							activeSessionId = scope.sessionId;
+							try {
+								const hostResult = await host.computerUse.request(scope, {
+									operation: "activate",
+									payload: activation
+								});
+								await responseJson(await sessionRequest(scope, COMPUTER_USE_ROUTES.hubStop, "POST", { host: hostResult }));
+								const grantId = record(hostResult)?.grantId;
+								if (typeof grantId === "string") grants.set(scope.sessionId, grantId);
+							} catch (error) {
+								activeSessionId = void 0;
+								await responseJson(await sessionRequest(scope, COMPUTER_USE_ROUTES.hubStop, "POST", { error: error instanceof Error ? error.message : String(error) }));
+							}
+							await refresh(scope);
+						}
+					}
+					if (state.phase === "stopping") {
+						await stopSession(scope);
+						await refresh(scope);
+					}
+					const pending = await responseJson(await sessionRequest(scope, COMPUTER_USE_ROUTES.hubNext));
+					if (pending !== null) await completePending(scope, pending);
+				} catch (error) {
+					if (error instanceof MissingComputerUseApiError) latest.delete(scope.sessionId);
+					else host.onNotice(`computer-use state handling failed for ${scope.sessionId} (${error instanceof Error ? error.message : String(error)})`);
+				} finally {
+					processing.delete(scope.sessionId);
+				}
+			};
+			const onState = (scope, payload) => {
+				const state = sessionState(payload);
+				if (state === void 0 || state.sessionId !== scope.sessionId) return;
+				publish(scope, state);
+				processScope(scope, state);
+			};
+			receiveCommand = (scope, payload) => {
+				const parsed = command(payload);
+				if (parsed === void 0) return;
+				(async () => {
+					try {
+						if (parsed.action === "targets") {
+							const result = host.computerUse?.available ? await host.computerUse.request(scope, { operation: "targets" }) : [];
+							targets.set(scope.sessionId, Array.isArray(result) ? result.filter((item) => record(item) !== void 0) : []);
+						} else if (parsed.action === "stop") await stopSession(scope);
+						await refresh(scope);
+						processScope(scope);
+					} catch (error) {
+						if (error instanceof MissingComputerUseApiError) latest.delete(scope.sessionId);
+						else host.onNotice(`computer-use command failed for ${scope.sessionId} (${error instanceof Error ? error.message : String(error)})`);
+					}
+				})();
+			};
+			return {
+				payloadFor: (scope) => latest.get(scope.sessionId),
+				sessionAdded(scope) {
+					scopes.set(scope.sessionId, scope);
+					const unsubscribe = host.directEvents.subscribe(computerUseChannelType, scope.sessionId, (payload) => onState(scope, payload), { replayLatest: true });
+					subscriptions.set(scope.sessionId, unsubscribe);
+					processScope(scope);
+				},
+				sessionRemoved(sessionId) {
+					const scope = scopes.get(sessionId);
+					const grantId = grants.get(sessionId);
+					subscriptions.get(sessionId)?.();
+					subscriptions.delete(sessionId);
+					if (scope !== void 0 && grantId !== void 0 && host.computerUse?.available) host.computerUse.request(scope, {
+						operation: "stop",
+						payload: { grantId }
+					}).catch((error) => host.onNotice(`computer-use session cleanup failed (${error instanceof Error ? error.message : String(error)})`));
+					scopes.delete(sessionId);
+					latest.delete(sessionId);
+					targets.delete(sessionId);
+					grants.delete(sessionId);
+					processing.delete(sessionId);
+					if (activeSessionId === sessionId) activeSessionId = void 0;
+				},
+				close() {
+					closed = true;
+					for (const unsubscribe of subscriptions.values()) unsubscribe();
+					subscriptions.clear();
+					if (host.computerUse?.available) for (const [sessionId, grantId] of grants) {
+						const scope = scopes.get(sessionId);
+						if (scope !== void 0) host.computerUse.request(scope, {
+							operation: "stop",
+							payload: { grantId }
+						}).catch(() => void 0);
+					}
+					scopes.clear();
+					latest.clear();
+					targets.clear();
+					grants.clear();
+				}
+			};
+		},
+		receive(scope, payload) {
+			receiveCommand?.(scope, payload);
+		}
+	};
+}
+//#endregion
+export { computerUseChannelType, createComputerUseChannel };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/webComputerUseChannel/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/webComputerUseChannel/index.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { DoomHubChannelSource, DoomHubSessionScope, DoomHubChannel } from '@agimon-ai/doompi-core/hub-channel';\n\nimport { computerUseSessionApiError, MissingComputerUseApiError } from '../../services/webComputerUseAvailability';\nimport {\n  API_BASE_PATH,\n  computerUseChannelType,\n  COMPUTER_USE_ROUTES,\n  type ComputerUseActivationRequest,\n  type ComputerUseBrokerRequest,\n  type ComputerUseBrowserCommand,\n  type ComputerUseChannelPayload,\n  type ComputerUseSessionView,\n} from '../../types/computerUseApi';\nexport { computerUseChannelType };\n\n/** Computer use runs on the DoomPi Desktop host, so every other client declines it. */\nconst DESKTOP_UNAVAILABLE = 'DoomPi Desktop computer use is unavailable.';\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\nfunction command(value: unknown): ComputerUseBrowserCommand | undefined {\n  const input = record(value);\n  return input?.action === 'status' ||\n    input?.action === 'targets' ||\n    input?.action === 'stop' ||\n    input?.action === 'artifacts'\n    ? { action: input.action }\n    : undefined;\n}\n\nasync function responseJson(response: Response): Promise<unknown> {\n  const value = await response.json();\n  if (!response.ok) throw computerUseSessionApiError(response.status, value);\n  return value;\n}\n\nfunction sessionState(value: unknown): ComputerUseSessionView | undefined {\n  const input = record(value);\n  if (\n    typeof input?.sessionId !== 'string' ||\n    typeof input.revision !== 'number' ||\n    typeof input.wake !== 'number' ||\n    !['inactive', 'awaiting_confirmation', 'activating', 'active', 'stopping', 'failed'].includes(input.phase as string)\n  )\n    return undefined;\n  return input as unknown as ComputerUseSessionView;\n}\n\nexport function createComputerUseChannel(): DoomHubChannel {\n  let receiveCommand: ((scope: DoomHubSessionScope, payload: unknown) => void) | undefined;\n  return {\n    frameType: computerUseChannelType,\n    lifecycle: 'hub',\n    start(host) {\n      const scopes = new Map<string, DoomHubSessionScope>();\n      const latest = new Map<string, ComputerUseChannelPayload>();\n      const targets = new Map<string, readonly Record<string, unknown>[]>();\n      const grants = new Map<string, string>();\n      const subscriptions = new Map<string, () => void>();\n      const processing = new Set<string>();\n      let activeSessionId: string | undefined;\n      let closed = false;\n\n      const sessionRequest = async (scope: DoomHubSessionScope, path: string, method = 'GET', value?: unknown) =>\n        host.requestSessionApi(scope, {\n          basePath: API_BASE_PATH,\n          path,\n          method,\n          ...(value === undefined ? {} : { body: JSON.stringify(value) }),\n        });\n\n      const publish = (scope: DoomHubSessionScope, state: ComputerUseSessionView): void => {\n        if (state.phase === 'active' || state.phase === 'activating' || state.phase === 'stopping') {\n          activeSessionId = scope.sessionId;\n        } else if (activeSessionId === scope.sessionId) {\n          activeSessionId = undefined;\n          grants.delete(scope.sessionId);\n        }\n        const payload: ComputerUseChannelPayload = {\n          state,\n          targets: targets.get(scope.sessionId) ?? [],\n          ...(activeSessionId !== undefined && activeSessionId !== scope.sessionId ? { busy: true } : {}),\n        };\n        latest.set(scope.sessionId, payload);\n        host.publish(scope.sessionId, payload);\n      };\n\n      const refresh = async (scope: DoomHubSessionScope): Promise<ComputerUseSessionView> => {\n        const state = sessionState(await responseJson(await sessionRequest(scope, COMPUTER_USE_ROUTES.hubState)));\n        if (state === undefined) throw new Error('Computer-use API returned an invalid session state.');\n        publish(scope, state);\n        return state;\n      };\n\n      const completePending = async (scope: DoomHubSessionScope, pending: ComputerUseBrokerRequest): Promise<void> => {\n        if (!host.computerUse?.available) throw new Error(DESKTOP_UNAVAILABLE);\n        try {\n          const result = await host.computerUse.request(scope, {\n            operation: pending.operation,\n            payload:\n              pending.operation === 'act'\n                ? { grantId: pending.grantId, sequence: pending.sequence, action: pending.payload }\n                : { grantId: pending.grantId },\n          });\n          await responseJson(\n            await sessionRequest(scope, COMPUTER_USE_ROUTES.hubComplete, 'POST', { id: pending.id, result }),\n          );\n        } catch (error) {\n          await responseJson(\n            await sessionRequest(scope, COMPUTER_USE_ROUTES.hubComplete, 'POST', {\n              id: pending.id,\n              error: error instanceof Error ? error.message : String(error),\n            }),\n          );\n        }\n      };\n\n      const stopSession = async (scope: DoomHubSessionScope): Promise<void> => {\n        const authorization = (await responseJson(\n          await sessionRequest(scope, COMPUTER_USE_ROUTES.hubAuthorization),\n        )) as { grantId: string } | null;\n        let artifact: unknown;\n        if (authorization !== null && host.computerUse?.available) {\n          try {\n            artifact = await host.computerUse.request(scope, {\n              operation: 'stop',\n              payload: { grantId: authorization.grantId },\n            });\n          } catch (error) {\n            const message = error instanceof Error ? error.message : String(error);\n            artifact = {\n              artifactId: randomUUID(),\n              status: 'failed',\n              failure: { code: 'recording_failed', message: message.slice(0, 512) },\n            };\n            host.onNotice(`computer-use Desktop stop was already unavailable (${message})`);\n          }\n        }\n        await responseJson(await sessionRequest(scope, COMPUTER_USE_ROUTES.hubStop, 'POST', { artifact }));\n        grants.delete(scope.sessionId);\n        if (activeSessionId === scope.sessionId) activeSessionId = undefined;\n      };\n\n      const processScope = async (scope: DoomHubSessionScope, announced?: ComputerUseSessionView): Promise<void> => {\n        if (closed || processing.has(scope.sessionId)) return;\n        processing.add(scope.sessionId);\n        try {\n          const state = announced ?? (await refresh(scope));\n          if (state.phase === 'active') {\n            if (!grants.has(scope.sessionId)) {\n              const authorization = (await responseJson(\n                await sessionRequest(scope, COMPUTER_USE_ROUTES.hubAuthorization),\n              )) as { grantId: string } | null;\n              if (authorization !== null) grants.set(scope.sessionId, authorization.grantId);\n            }\n            const expired = typeof state.expiresAt === 'number' && state.expiresAt <= Date.now();\n            let owned = false;\n            if (!expired && host.computerUse?.available) {\n              try {\n                const hostStatus = record(await host.computerUse.request(scope, { operation: 'status' }));\n                owned = hostStatus?.ownedBySession === true;\n              } catch {\n                owned = true;\n              }\n            }\n            if (expired || !owned) {\n              await stopSession(scope);\n              await refresh(scope);\n              return;\n            }\n          }\n          if (\n            state.phase === 'awaiting_confirmation' &&\n            (activeSessionId === undefined || activeSessionId === scope.sessionId)\n          ) {\n            const activation = (await responseJson(\n              await sessionRequest(scope, COMPUTER_USE_ROUTES.hubActivation),\n            )) as ComputerUseActivationRequest | null;\n            if (activation !== null && !host.computerUse?.available) {\n              // No desktop host: decline through the API's own failure path so the browser\n              // shows why, instead of leaving the request pending or raising a server error.\n              await responseJson(\n                await sessionRequest(scope, COMPUTER_USE_ROUTES.hubStop, 'POST', { error: DESKTOP_UNAVAILABLE }),\n              );\n              await refresh(scope);\n              return;\n            }\n            if (activation !== null && host.computerUse?.available) {\n              activeSessionId = scope.sessionId;\n              try {\n                const hostResult = await host.computerUse.request(scope, {\n                  operation: 'activate',\n                  payload: activation,\n                });\n                await responseJson(\n                  await sessionRequest(scope, COMPUTER_USE_ROUTES.hubStop, 'POST', { host: hostResult }),\n                );\n                const grantId = record(hostResult)?.grantId;\n                if (typeof grantId === 'string') grants.set(scope.sessionId, grantId);\n              } catch (error) {\n                activeSessionId = undefined;\n                await responseJson(\n                  await sessionRequest(scope, COMPUTER_USE_ROUTES.hubStop, 'POST', {\n                    error: error instanceof Error ? error.message : String(error),\n                  }),\n                );\n              }\n              await refresh(scope);\n            }\n          }\n          if (state.phase === 'stopping') {\n            await stopSession(scope);\n            await refresh(scope);\n          }\n          const pending = (await responseJson(\n            await sessionRequest(scope, COMPUTER_USE_ROUTES.hubNext),\n          )) as ComputerUseBrokerRequest | null;\n          if (pending !== null) await completePending(scope, pending);\n        } catch (error) {\n          if (error instanceof MissingComputerUseApiError) {\n            latest.delete(scope.sessionId);\n          } else {\n            host.onNotice(\n              `computer-use state handling failed for ${scope.sessionId} (${error instanceof Error ? error.message : String(error)})`,\n            );\n          }\n        } finally {\n          processing.delete(scope.sessionId);\n        }\n      };\n\n      const onState = (scope: DoomHubSessionScope, payload: unknown): void => {\n        const state = sessionState(payload);\n        if (state === undefined || state.sessionId !== scope.sessionId) return;\n        publish(scope, state);\n        void processScope(scope, state);\n      };\n\n      receiveCommand = (scope, payload) => {\n        const parsed = command(payload);\n        if (parsed === undefined) return;\n        void (async () => {\n          try {\n            if (parsed.action === 'targets') {\n              // Without a desktop host there is nothing to capture, so the browser sees an\n              // empty target list rather than an error it cannot act on.\n              const result = host.computerUse?.available\n                ? await host.computerUse.request(scope, { operation: 'targets' })\n                : [];\n              targets.set(\n                scope.sessionId,\n                Array.isArray(result)\n                  ? result.filter((item): item is Record<string, unknown> => record(item) !== undefined)\n                  : [],\n              );\n            } else if (parsed.action === 'stop') {\n              await stopSession(scope);\n            }\n            await refresh(scope);\n            void processScope(scope);\n          } catch (error) {\n            if (error instanceof MissingComputerUseApiError) {\n              latest.delete(scope.sessionId);\n            } else {\n              host.onNotice(\n                `computer-use command failed for ${scope.sessionId} (${error instanceof Error ? error.message : String(error)})`,\n              );\n            }\n          }\n        })();\n      };\n\n      const source: DoomHubChannelSource = {\n        payloadFor: (scope) => latest.get(scope.sessionId),\n        sessionAdded(scope) {\n          scopes.set(scope.sessionId, scope);\n          const unsubscribe = host.directEvents.subscribe(\n            computerUseChannelType,\n            scope.sessionId,\n            (payload) => onState(scope, payload),\n            { replayLatest: true },\n          );\n          subscriptions.set(scope.sessionId, unsubscribe);\n          void processScope(scope);\n        },\n        sessionRemoved(sessionId) {\n          const scope = scopes.get(sessionId);\n          const grantId = grants.get(sessionId);\n          subscriptions.get(sessionId)?.();\n          subscriptions.delete(sessionId);\n          if (scope !== undefined && grantId !== undefined && host.computerUse?.available) {\n            void host.computerUse\n              .request(scope, { operation: 'stop', payload: { grantId } })\n              .catch((error: unknown) =>\n                host.onNotice(\n                  `computer-use session cleanup failed (${error instanceof Error ? error.message : String(error)})`,\n                ),\n              );\n          }\n          scopes.delete(sessionId);\n          latest.delete(sessionId);\n          targets.delete(sessionId);\n          grants.delete(sessionId);\n          processing.delete(sessionId);\n          if (activeSessionId === sessionId) activeSessionId = undefined;\n        },\n        close() {\n          closed = true;\n          for (const unsubscribe of subscriptions.values()) unsubscribe();\n          subscriptions.clear();\n          if (host.computerUse?.available) {\n            for (const [sessionId, grantId] of grants) {\n              const scope = scopes.get(sessionId);\n              if (scope !== undefined)\n                void host.computerUse\n                  .request(scope, { operation: 'stop', payload: { grantId } })\n                  .catch(() => undefined);\n            }\n          }\n          scopes.clear();\n          latest.clear();\n          targets.clear();\n          grants.clear();\n        },\n      };\n      return source;\n    },\n    receive(scope, payload) {\n      receiveCommand?.(scope, payload);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/types/apiRoutes.cjs

@@ -0,0 +1,84 @@
+const require_computerUseApi = require("./computerUseApi.cjs");
+let _agimon_ai_doompi_core_web = require("@agimon-ai/doompi-core/web");
+//#region src/types/apiRoutes.ts
+/**
+* This package's routes, as data.
+*
+* No scope and no base path: the build reads both off
+* `src/extensions/workspaces/sessions/(backend)/api/computer-use/`, so the
+* mount is stated once, by the folder that creates it.
+*
+* The paths come from `COMPUTER_USE_ROUTES` rather than being written out
+* again. That table already addressed the broker from the hub channel and from
+* the broker's own dispatcher, and a second copy here is exactly the
+* disagreement this file exists to prevent. The dispatcher now reads this
+* table, so the page, the broker and the hub all resolve one set of strings.
+*
+* Only `activate` is reachable from a browser. The `/agent/` and `/hub/` routes
+* each demand a host-issued bearer token and answer 404 without one; they are
+* declared here because they are this API's surface, not because a page calls
+* them.
+*/
+var apiRoutes_default = (0, _agimon_ai_doompi_core_web.defineApiRoutes)({
+	activate: {
+		method: "POST",
+		path: require_computerUseApi.COMPUTER_USE_ROUTES.activate,
+		response: (0, _agimon_ai_doompi_core_web.apiResponse)()
+	},
+	agentState: {
+		method: "GET",
+		path: require_computerUseApi.COMPUTER_USE_ROUTES.agentState,
+		response: (0, _agimon_ai_doompi_core_web.apiResponse)()
+	},
+	/** Answers whatever the admitted Desktop provider returned, which is runtime-defined JSON. */
+	agentObserve: {
+		method: "POST",
+		path: require_computerUseApi.COMPUTER_USE_ROUTES.agentObserve,
+		response: (0, _agimon_ai_doompi_core_web.apiResponse)()
+	},
+	agentAction: {
+		method: "POST",
+		path: require_computerUseApi.COMPUTER_USE_ROUTES.agentAction,
+		response: (0, _agimon_ai_doompi_core_web.apiResponse)()
+	},
+	agentStop: {
+		method: "POST",
+		path: require_computerUseApi.COMPUTER_USE_ROUTES.agentStop,
+		response: (0, _agimon_ai_doompi_core_web.apiResponse)()
+	},
+	hubState: {
+		method: "GET",
+		path: require_computerUseApi.COMPUTER_USE_ROUTES.hubState,
+		response: (0, _agimon_ai_doompi_core_web.apiResponse)()
+	},
+	/** Null until a reader has confirmed one; reading it moves the session to `activating`. */
+	hubActivation: {
+		method: "GET",
+		path: require_computerUseApi.COMPUTER_USE_ROUTES.hubActivation,
+		response: (0, _agimon_ai_doompi_core_web.apiResponse)()
+	},
+	hubAuthorization: {
+		method: "GET",
+		path: require_computerUseApi.COMPUTER_USE_ROUTES.hubAuthorization,
+		response: (0, _agimon_ai_doompi_core_web.apiResponse)()
+	},
+	hubNext: {
+		method: "GET",
+		path: require_computerUseApi.COMPUTER_USE_ROUTES.hubNext,
+		response: (0, _agimon_ai_doompi_core_web.apiResponse)()
+	},
+	hubComplete: {
+		method: "POST",
+		path: require_computerUseApi.COMPUTER_USE_ROUTES.hubComplete,
+		response: (0, _agimon_ai_doompi_core_web.apiResponse)()
+	},
+	hubStop: {
+		method: "POST",
+		path: require_computerUseApi.COMPUTER_USE_ROUTES.hubStop,
+		response: (0, _agimon_ai_doompi_core_web.apiResponse)()
+	}
+});
+//#endregion
+exports.default = apiRoutes_default;
+
+//# sourceMappingURL=apiRoutes.cjs.map

package/dist/src/types/apiRoutes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiRoutes.cjs","names":["defineApiRoutes","COMPUTER_USE_ROUTES","apiResponse"],"sources":["../../../src/types/apiRoutes.ts"],"sourcesContent":["import { apiResponse, defineApiRoutes } from '@agimon-ai/doompi-core/web';\n\nimport {\n  COMPUTER_USE_ROUTES,\n  type ComputerUseActivationRequest,\n  type ComputerUseBrokerRequest,\n  type ComputerUseSessionView,\n} from './computerUseApi';\n\n/**\n * This package's routes, as data.\n *\n * No scope and no base path: the build reads both off\n * `src/extensions/workspaces/sessions/(backend)/api/computer-use/`, so the\n * mount is stated once, by the folder that creates it.\n *\n * The paths come from `COMPUTER_USE_ROUTES` rather than being written out\n * again. That table already addressed the broker from the hub channel and from\n * the broker's own dispatcher, and a second copy here is exactly the\n * disagreement this file exists to prevent. The dispatcher now reads this\n * table, so the page, the broker and the hub all resolve one set of strings.\n *\n * Only `activate` is reachable from a browser. The `/agent/` and `/hub/` routes\n * each demand a host-issued bearer token and answer 404 without one; they are\n * declared here because they are this API's surface, not because a page calls\n * them.\n */\nexport default defineApiRoutes({\n  activate: {\n    method: 'POST',\n    path: COMPUTER_USE_ROUTES.activate,\n    response: apiResponse<ComputerUseSessionView>(),\n  },\n  agentState: {\n    method: 'GET',\n    path: COMPUTER_USE_ROUTES.agentState,\n    response: apiResponse<ComputerUseSessionView>(),\n  },\n  /** Answers whatever the admitted Desktop provider returned, which is runtime-defined JSON. */\n  agentObserve: {\n    method: 'POST',\n    path: COMPUTER_USE_ROUTES.agentObserve,\n    response: apiResponse<unknown>(),\n  },\n  agentAction: {\n    method: 'POST',\n    path: COMPUTER_USE_ROUTES.agentAction,\n    response: apiResponse<unknown>(),\n  },\n  agentStop: {\n    method: 'POST',\n    path: COMPUTER_USE_ROUTES.agentStop,\n    response: apiResponse<ComputerUseSessionView>(),\n  },\n  hubState: {\n    method: 'GET',\n    path: COMPUTER_USE_ROUTES.hubState,\n    response: apiResponse<ComputerUseSessionView>(),\n  },\n  /** Null until a reader has confirmed one; reading it moves the session to `activating`. */\n  hubActivation: {\n    method: 'GET',\n    path: COMPUTER_USE_ROUTES.hubActivation,\n    response: apiResponse<ComputerUseActivationRequest | null>(),\n  },\n  hubAuthorization: {\n    method: 'GET',\n    path: COMPUTER_USE_ROUTES.hubAuthorization,\n    response: apiResponse<{ readonly grantId: string; readonly expiresAt?: number } | null>(),\n  },\n  hubNext: {\n    method: 'GET',\n    path: COMPUTER_USE_ROUTES.hubNext,\n    response: apiResponse<ComputerUseBrokerRequest | null>(),\n  },\n  hubComplete: {\n    method: 'POST',\n    path: COMPUTER_USE_ROUTES.hubComplete,\n    response: apiResponse<ComputerUseSessionView>(),\n  },\n  hubStop: {\n    method: 'POST',\n    path: COMPUTER_USE_ROUTES.hubStop,\n    response: apiResponse<ComputerUseSessionView>(),\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA2BA,IAAA,qBAAA,GAAeA,2BAAAA,gBAAAA,CAAgB;CAC7B,UAAU;EACR,QAAQ;EACR,MAAMC,uBAAAA,oBAAoB;EAC1B,WAAA,GAAUC,2BAAAA,YAAAA,CAAoC;CAChD;CACA,YAAY;EACV,QAAQ;EACR,MAAMD,uBAAAA,oBAAoB;EAC1B,WAAA,GAAUC,2BAAAA,YAAAA,CAAoC;CAChD;;CAEA,cAAc;EACZ,QAAQ;EACR,MAAMD,uBAAAA,oBAAoB;EAC1B,WAAA,GAAUC,2BAAAA,YAAAA,CAAqB;CACjC;CACA,aAAa;EACX,QAAQ;EACR,MAAMD,uBAAAA,oBAAoB;EAC1B,WAAA,GAAUC,2BAAAA,YAAAA,CAAqB;CACjC;CACA,WAAW;EACT,QAAQ;EACR,MAAMD,uBAAAA,oBAAoB;EAC1B,WAAA,GAAUC,2BAAAA,YAAAA,CAAoC;CAChD;CACA,UAAU;EACR,QAAQ;EACR,MAAMD,uBAAAA,oBAAoB;EAC1B,WAAA,GAAUC,2BAAAA,YAAAA,CAAoC;CAChD;;CAEA,eAAe;EACb,QAAQ;EACR,MAAMD,uBAAAA,oBAAoB;EAC1B,WAAA,GAAUC,2BAAAA,YAAAA,CAAiD;CAC7D;CACA,kBAAkB;EAChB,QAAQ;EACR,MAAMD,uBAAAA,oBAAoB;EAC1B,WAAA,GAAUC,2BAAAA,YAAAA,CAA8E;CAC1F;CACA,SAAS;EACP,QAAQ;EACR,MAAMD,uBAAAA,oBAAoB;EAC1B,WAAA,GAAUC,2BAAAA,YAAAA,CAA6C;CACzD;CACA,aAAa;EACX,QAAQ;EACR,MAAMD,uBAAAA,oBAAoB;EAC1B,WAAA,GAAUC,2BAAAA,YAAAA,CAAoC;CAChD;CACA,SAAS;EACP,QAAQ;EACR,MAAMD,uBAAAA,oBAAoB;EAC1B,WAAA,GAAUC,2BAAAA,YAAAA,CAAoC;CAChD;AACF,CAAC"}

package/dist/src/types/apiRoutes.mjs

@@ -0,0 +1,84 @@
+import { COMPUTER_USE_ROUTES } from "./computerUseApi.mjs";
+import { apiResponse, defineApiRoutes } from "@agimon-ai/doompi-core/web";
+//#region src/types/apiRoutes.ts
+/**
+* This package's routes, as data.
+*
+* No scope and no base path: the build reads both off
+* `src/extensions/workspaces/sessions/(backend)/api/computer-use/`, so the
+* mount is stated once, by the folder that creates it.
+*
+* The paths come from `COMPUTER_USE_ROUTES` rather than being written out
+* again. That table already addressed the broker from the hub channel and from
+* the broker's own dispatcher, and a second copy here is exactly the
+* disagreement this file exists to prevent. The dispatcher now reads this
+* table, so the page, the broker and the hub all resolve one set of strings.
+*
+* Only `activate` is reachable from a browser. The `/agent/` and `/hub/` routes
+* each demand a host-issued bearer token and answer 404 without one; they are
+* declared here because they are this API's surface, not because a page calls
+* them.
+*/
+var apiRoutes_default = defineApiRoutes({
+	activate: {
+		method: "POST",
+		path: COMPUTER_USE_ROUTES.activate,
+		response: apiResponse()
+	},
+	agentState: {
+		method: "GET",
+		path: COMPUTER_USE_ROUTES.agentState,
+		response: apiResponse()
+	},
+	/** Answers whatever the admitted Desktop provider returned, which is runtime-defined JSON. */
+	agentObserve: {
+		method: "POST",
+		path: COMPUTER_USE_ROUTES.agentObserve,
+		response: apiResponse()
+	},
+	agentAction: {
+		method: "POST",
+		path: COMPUTER_USE_ROUTES.agentAction,
+		response: apiResponse()
+	},
+	agentStop: {
+		method: "POST",
+		path: COMPUTER_USE_ROUTES.agentStop,
+		response: apiResponse()
+	},
+	hubState: {
+		method: "GET",
+		path: COMPUTER_USE_ROUTES.hubState,
+		response: apiResponse()
+	},
+	/** Null until a reader has confirmed one; reading it moves the session to `activating`. */
+	hubActivation: {
+		method: "GET",
+		path: COMPUTER_USE_ROUTES.hubActivation,
+		response: apiResponse()
+	},
+	hubAuthorization: {
+		method: "GET",
+		path: COMPUTER_USE_ROUTES.hubAuthorization,
+		response: apiResponse()
+	},
+	hubNext: {
+		method: "GET",
+		path: COMPUTER_USE_ROUTES.hubNext,
+		response: apiResponse()
+	},
+	hubComplete: {
+		method: "POST",
+		path: COMPUTER_USE_ROUTES.hubComplete,
+		response: apiResponse()
+	},
+	hubStop: {
+		method: "POST",
+		path: COMPUTER_USE_ROUTES.hubStop,
+		response: apiResponse()
+	}
+});
+//#endregion
+export { apiRoutes_default as default };
+
+//# sourceMappingURL=apiRoutes.mjs.map

package/dist/src/types/apiRoutes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiRoutes.mjs","names":[],"sources":["../../../src/types/apiRoutes.ts"],"sourcesContent":["import { apiResponse, defineApiRoutes } from '@agimon-ai/doompi-core/web';\n\nimport {\n  COMPUTER_USE_ROUTES,\n  type ComputerUseActivationRequest,\n  type ComputerUseBrokerRequest,\n  type ComputerUseSessionView,\n} from './computerUseApi';\n\n/**\n * This package's routes, as data.\n *\n * No scope and no base path: the build reads both off\n * `src/extensions/workspaces/sessions/(backend)/api/computer-use/`, so the\n * mount is stated once, by the folder that creates it.\n *\n * The paths come from `COMPUTER_USE_ROUTES` rather than being written out\n * again. That table already addressed the broker from the hub channel and from\n * the broker's own dispatcher, and a second copy here is exactly the\n * disagreement this file exists to prevent. The dispatcher now reads this\n * table, so the page, the broker and the hub all resolve one set of strings.\n *\n * Only `activate` is reachable from a browser. The `/agent/` and `/hub/` routes\n * each demand a host-issued bearer token and answer 404 without one; they are\n * declared here because they are this API's surface, not because a page calls\n * them.\n */\nexport default defineApiRoutes({\n  activate: {\n    method: 'POST',\n    path: COMPUTER_USE_ROUTES.activate,\n    response: apiResponse<ComputerUseSessionView>(),\n  },\n  agentState: {\n    method: 'GET',\n    path: COMPUTER_USE_ROUTES.agentState,\n    response: apiResponse<ComputerUseSessionView>(),\n  },\n  /** Answers whatever the admitted Desktop provider returned, which is runtime-defined JSON. */\n  agentObserve: {\n    method: 'POST',\n    path: COMPUTER_USE_ROUTES.agentObserve,\n    response: apiResponse<unknown>(),\n  },\n  agentAction: {\n    method: 'POST',\n    path: COMPUTER_USE_ROUTES.agentAction,\n    response: apiResponse<unknown>(),\n  },\n  agentStop: {\n    method: 'POST',\n    path: COMPUTER_USE_ROUTES.agentStop,\n    response: apiResponse<ComputerUseSessionView>(),\n  },\n  hubState: {\n    method: 'GET',\n    path: COMPUTER_USE_ROUTES.hubState,\n    response: apiResponse<ComputerUseSessionView>(),\n  },\n  /** Null until a reader has confirmed one; reading it moves the session to `activating`. */\n  hubActivation: {\n    method: 'GET',\n    path: COMPUTER_USE_ROUTES.hubActivation,\n    response: apiResponse<ComputerUseActivationRequest | null>(),\n  },\n  hubAuthorization: {\n    method: 'GET',\n    path: COMPUTER_USE_ROUTES.hubAuthorization,\n    response: apiResponse<{ readonly grantId: string; readonly expiresAt?: number } | null>(),\n  },\n  hubNext: {\n    method: 'GET',\n    path: COMPUTER_USE_ROUTES.hubNext,\n    response: apiResponse<ComputerUseBrokerRequest | null>(),\n  },\n  hubComplete: {\n    method: 'POST',\n    path: COMPUTER_USE_ROUTES.hubComplete,\n    response: apiResponse<ComputerUseSessionView>(),\n  },\n  hubStop: {\n    method: 'POST',\n    path: COMPUTER_USE_ROUTES.hubStop,\n    response: apiResponse<ComputerUseSessionView>(),\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA2BA,IAAA,oBAAe,gBAAgB;CAC7B,UAAU;EACR,QAAQ;EACR,MAAM,oBAAoB;EAC1B,UAAU,YAAoC;CAChD;CACA,YAAY;EACV,QAAQ;EACR,MAAM,oBAAoB;EAC1B,UAAU,YAAoC;CAChD;;CAEA,cAAc;EACZ,QAAQ;EACR,MAAM,oBAAoB;EAC1B,UAAU,YAAqB;CACjC;CACA,aAAa;EACX,QAAQ;EACR,MAAM,oBAAoB;EAC1B,UAAU,YAAqB;CACjC;CACA,WAAW;EACT,QAAQ;EACR,MAAM,oBAAoB;EAC1B,UAAU,YAAoC;CAChD;CACA,UAAU;EACR,QAAQ;EACR,MAAM,oBAAoB;EAC1B,UAAU,YAAoC;CAChD;;CAEA,eAAe;EACb,QAAQ;EACR,MAAM,oBAAoB;EAC1B,UAAU,YAAiD;CAC7D;CACA,kBAAkB;EAChB,QAAQ;EACR,MAAM,oBAAoB;EAC1B,UAAU,YAA8E;CAC1F;CACA,SAAS;EACP,QAAQ;EACR,MAAM,oBAAoB;EAC1B,UAAU,YAA6C;CACzD;CACA,aAAa;EACX,QAAQ;EACR,MAAM,oBAAoB;EAC1B,UAAU,YAAoC;CAChD;CACA,SAAS;EACP,QAAQ;EACR,MAAM,oBAAoB;EAC1B,UAAU,YAAoC;CAChD;AACF,CAAC"}

package/dist/src/types/computerScript.d.cts

@@ -0,0 +1,38 @@
+import { ComputerUseAction, ComputerUseObservation } from "./computerUse.cjs";
+import { ComputerUseSessionClient } from "../services/sessionApiClient/index.cjs";
+//#region src/types/computerScript.d.ts
+export interface ComputerScriptProgram {
+  observe(): Promise<ComputerUseObservation>;
+  act(action: ComputerUseAction): Promise<unknown>;
+}
+export interface ComputerScriptLogger {
+  debug(message: string): void;
+  info(message: string): void;
+  warn(message: string): void;
+  error(message: string): void;
+}
+export interface ComputerScriptRunContext {
+  context: {
+    program: ComputerScriptProgram;
+  };
+  input: unknown;
+  logger: ComputerScriptLogger;
+  signal: AbortSignal;
+}
+export type ComputerScriptRun = (options: ComputerScriptRunContext) => Promise<unknown>;
+export interface ComputerScriptExecutionResult {
+  result?: unknown;
+  observation: ComputerUseObservation;
+  logs: readonly string[];
+}
+export interface ComputerScriptExecutor {
+  execute(scriptPath: string, input: unknown, signal?: AbortSignal): Promise<ComputerScriptExecutionResult>;
+}
+export interface ComputerScriptRunnerOptions {
+  readonly client: ComputerUseSessionClient;
+  readonly allowedScriptPaths: readonly string[];
+  readonly timeoutMs?: number;
+  readonly maxOutputBytes?: number;
+}
+//#endregion
+//# sourceMappingURL=computerScript.d.cts.map

package/dist/src/types/computerScript.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computerScript.d.cts","names":[],"sources":["../../../src/types/computerScript.ts"],"mappings":";;;iBAGiB;EACf,WAAW,QAAQ;EACnB,IAAI,QAAQ,oBAAoB;;iBAGjB;EACf,MAAM;EACN,KAAK;EACL,KAAK;EACL,MAAM;;iBAGS;EACf;IAAW,SAAS;;EACpB;EACA,QAAQ;EACR,QAAQ;;YAGE,qBAAqB,SAAS,6BAA6B;iBAEtD;EACf;EACA,aAAa;EACb;;iBAGe;EACf,QAAQ,oBAAoB,gBAAgB,SAAS,cAAc,QAAQ;;iBAG5D;WACN,QAAQ;WACR;WACA;WACA"}

package/dist/src/types/computerScript.d.mts

@@ -0,0 +1,38 @@
+import { ComputerUseAction, ComputerUseObservation } from "./computerUse.mjs";
+import { ComputerUseSessionClient } from "../services/sessionApiClient/index.mjs";
+//#region src/types/computerScript.d.ts
+export interface ComputerScriptProgram {
+  observe(): Promise<ComputerUseObservation>;
+  act(action: ComputerUseAction): Promise<unknown>;
+}
+export interface ComputerScriptLogger {
+  debug(message: string): void;
+  info(message: string): void;
+  warn(message: string): void;
+  error(message: string): void;
+}
+export interface ComputerScriptRunContext {
+  context: {
+    program: ComputerScriptProgram;
+  };
+  input: unknown;
+  logger: ComputerScriptLogger;
+  signal: AbortSignal;
+}
+export type ComputerScriptRun = (options: ComputerScriptRunContext) => Promise<unknown>;
+export interface ComputerScriptExecutionResult {
+  result?: unknown;
+  observation: ComputerUseObservation;
+  logs: readonly string[];
+}
+export interface ComputerScriptExecutor {
+  execute(scriptPath: string, input: unknown, signal?: AbortSignal): Promise<ComputerScriptExecutionResult>;
+}
+export interface ComputerScriptRunnerOptions {
+  readonly client: ComputerUseSessionClient;
+  readonly allowedScriptPaths: readonly string[];
+  readonly timeoutMs?: number;
+  readonly maxOutputBytes?: number;
+}
+//#endregion
+//# sourceMappingURL=computerScript.d.mts.map

package/dist/src/types/computerScript.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computerScript.d.mts","names":[],"sources":["../../../src/types/computerScript.ts"],"mappings":";;;iBAGiB;EACf,WAAW,QAAQ;EACnB,IAAI,QAAQ,oBAAoB;;iBAGjB;EACf,MAAM;EACN,KAAK;EACL,KAAK;EACL,MAAM;;iBAGS;EACf;IAAW,SAAS;;EACpB;EACA,QAAQ;EACR,QAAQ;;YAGE,qBAAqB,SAAS,6BAA6B;iBAEtD;EACf;EACA,aAAa;EACb;;iBAGe;EACf,QAAQ,oBAAoB,gBAAgB,SAAS,cAAc,QAAQ;;iBAG5D;WACN,QAAQ;WACR;WACA;WACA"}

package/dist/{types → src/types}/computerUse.d.cts

@@ -1,34 +1,35 @@
 //#region src/types/computerUse.d.ts
-declare const COMPUTER_USE_PHASES: readonly ['inactive', 'requesting', 'awaiting_confirmation', 'activating', 'active', 'stopping', 'failed'];
-type ComputerUsePhase = (typeof COMPUTER_USE_PHASES)[number];
-interface ComputerUseSessionIdentity {
+export declare const COMPUTER_USE_PHASES: readonly ['inactive', 'requesting', 'awaiting_confirmation', 'activating', 'active', 'stopping', 'failed'];
+export type ComputerUsePhase = (typeof COMPUTER_USE_PHASES)[number];
+export interface ComputerUseSessionIdentity {
   readonly sessionId: string;
   readonly runtimeId: string;
   readonly modeEpoch: string;
 }
-interface ComputerUseTarget {
+export interface ComputerUseTarget {
   readonly bundleId: string;
   readonly applicationName: string;
   readonly processId: number;
   readonly windowId: string;
   readonly windowTitle: string;
 }
-interface ComputerUseGrant {
+export interface ComputerUseGrant {
   readonly runId: string;
   readonly grantId: string;
   readonly hostGeneration: string;
   readonly targetGeneration: string;
   readonly expiresAt: number;
 }
-interface ComputerUseElement {
+export interface ComputerUseElement {
   readonly ref: string;
   readonly role: string;
   readonly label?: string;
+  readonly value?: string;
   readonly enabled: boolean;
   readonly secure: boolean;
   readonly actions: readonly ComputerUseActionKind[];
 }
-interface ComputerUseObservation {
+export interface ComputerUseObservation {
   readonly runId: string;
   readonly snapshotId: string;
   readonly targetGeneration: string;
@@ -41,9 +42,9 @@ interface ComputerUseObservation {
     readonly data: string;
   };
 }
-type ComputerUseActionKind = 'press' | 'set_value' | 'scroll';
-type ComputerUseAction = {
-  readonly kind: 'press';
+export type ComputerUseActionKind = 'press' | 'focus' | 'set_value' | 'scroll';
+export type ComputerUseAction = {
+  readonly kind: 'press' | 'focus';
   readonly snapshotId: string;
   readonly elementRef: string;
 } | {
@@ -58,8 +59,8 @@ type ComputerUseAction = {
   readonly direction: 'up' | 'down' | 'left' | 'right';
   readonly amount: 'line' | 'page';
 };
-type ComputerUseFailureCode = 'busy_in_another_session' | 'desktop_unavailable' | 'permission_required_on_mac' | 'confirmation_denied' | 'confirmation_expired' | 'target_invalid' | 'target_lost' | 'recording_failed' | 'trace_failed' | 'grant_expired' | 'stale_request' | 'outcome_uncertain' | 'internal_error';
-interface ComputerUseState {
+export type ComputerUseFailureCode = 'busy_in_another_session' | 'desktop_unavailable' | 'permission_required_on_mac' | 'confirmation_denied' | 'confirmation_expired' | 'target_invalid' | 'target_lost' | 'recording_failed' | 'trace_failed' | 'grant_expired' | 'stale_request' | 'outcome_uncertain' | 'internal_error';
+export interface ComputerUseState {
   readonly revision: number;
   readonly phase: ComputerUsePhase;
   readonly identity: ComputerUseSessionIdentity;
@@ -71,7 +72,7 @@ interface ComputerUseState {
     readonly message: string;
   };
 }
-type ComputerUseStateEvent = {
+export type ComputerUseStateEvent = {
   readonly type: 'request';
   readonly requestId: string;
   readonly target: ComputerUseTarget;
@@ -100,5 +101,4 @@ type ComputerUseStateEvent = {
   readonly type: 'reset';
 };
 //#endregion
-export { COMPUTER_USE_PHASES, ComputerUseAction, ComputerUseActionKind, ComputerUseElement, ComputerUseFailureCode, ComputerUseGrant, ComputerUseObservation, ComputerUsePhase, ComputerUseSessionIdentity, ComputerUseState, ComputerUseStateEvent, ComputerUseTarget };
 //# sourceMappingURL=computerUse.d.cts.map

package/dist/src/types/computerUse.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computerUse.d.cts","names":[],"sources":["../../../src/types/computerUse.ts"],"mappings":";qBAAa;YAUD,2BAA2B;iBAEtB;WACN;WACA;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA;;iBAGM;WACN;WACA;WACA;WACA;WACA;WACA;WACA,kBAAkB;;iBAGZ;WACN;WACA;WACA;WACA;WACA;WACA;WACA,mBAAmB;WACnB;aACE;aACA;;;YAID;YAEA;WAEG;WACA;WACA;;WAGA;WACA;WACA;WACA;;WAGA;WACA;WACA;WACA;WACA;;YAGH;iBAeK;WACN;WACA,OAAO;WACP,UAAU;WACV;WACA,SAAS;WACT,QAAQ;WACR;aACE,MAAM;aACN;;;YAID;WACG;WAA0B;WAA4B,QAAQ;;WAC9D;WAAqC;;WACrC;WAA0B;;WAC1B;WAAuB;;WACvB;WAA4B;WAA4B,OAAO;;WAC/D;;WACA;;WACA;WAAuB,MAAM;WAAiC;;WAC9D"}