hyperbrane 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (137) hide show
  1. package/README.md +12 -2
  2. package/dist/agent/agentService.d.ts +1 -0
  3. package/dist/agent/agentService.js +16 -1
  4. package/dist/agent/agentStorage.d.ts +2 -0
  5. package/dist/agent/agentStorage.js +4 -2
  6. package/dist/agent/api.d.ts +51 -27
  7. package/dist/agent/client.d.ts +3 -0
  8. package/dist/agent/client.js +5 -0
  9. package/dist/agent/hostTranscript.d.ts +13 -0
  10. package/dist/agent/hostTranscript.js +190 -0
  11. package/dist/agent/session/backend.d.ts +80 -0
  12. package/dist/agent/session/backend.js +1 -0
  13. package/dist/agent/session/claude/home.d.ts +2 -0
  14. package/dist/agent/session/claude/home.js +4 -0
  15. package/dist/agent/session/claude/transcript.d.ts +13 -0
  16. package/dist/agent/session/claude/transcript.js +29 -0
  17. package/dist/agent/session/client.d.ts +5 -1
  18. package/dist/agent/session/codex/home.d.ts +2 -0
  19. package/dist/agent/session/codex/home.js +4 -0
  20. package/dist/agent/session/codex/messages.d.ts +30 -0
  21. package/dist/agent/session/codex/messages.js +135 -0
  22. package/dist/agent/session/codex/transcript.d.ts +12 -0
  23. package/dist/agent/session/codex/transcript.js +22 -0
  24. package/dist/agent/session/fileTranscript.d.ts +92 -0
  25. package/dist/agent/session/fileTranscript.js +454 -0
  26. package/dist/agent/session/sdkMessages.d.ts +15 -0
  27. package/dist/agent/session/sdkMessages.js +28 -0
  28. package/dist/agent/session/sessionStorage.d.ts +4 -0
  29. package/dist/agent/session/sessionStorage.js +13 -2
  30. package/dist/agent/session/sharedConnection.d.ts +1 -0
  31. package/dist/agent/session/storedTranscripts.d.ts +13 -0
  32. package/dist/agent/session/storedTranscripts.js +8 -0
  33. package/dist/agent/session/worker/protocol.d.ts +1 -0
  34. package/dist/agent/session/worker/workerParams.d.ts +11 -0
  35. package/dist/agent/session/worker/workerParams.js +162 -0
  36. package/dist/agent/vendor-types/codex/app-server/AbsolutePathBuf.d.ts +10 -0
  37. package/dist/agent/vendor-types/codex/app-server/AbsolutePathBuf.js +2 -0
  38. package/dist/agent/vendor-types/codex/app-server/FunctionCallOutputBody.d.ts +2 -0
  39. package/dist/agent/vendor-types/codex/app-server/FunctionCallOutputBody.js +2 -0
  40. package/dist/agent/vendor-types/codex/app-server/FunctionCallOutputContentItem.d.ts +22 -0
  41. package/dist/agent/vendor-types/codex/app-server/FunctionCallOutputContentItem.js +2 -0
  42. package/dist/agent/vendor-types/codex/app-server/ImageDetail.d.ts +1 -0
  43. package/dist/agent/vendor-types/codex/app-server/ImageDetail.js +2 -0
  44. package/dist/agent/vendor-types/codex/app-server/ImageGenerationFailure.d.ts +5 -0
  45. package/dist/agent/vendor-types/codex/app-server/ImageGenerationFailure.js +2 -0
  46. package/dist/agent/vendor-types/codex/app-server/ImageGenerationItem.d.ts +11 -0
  47. package/dist/agent/vendor-types/codex/app-server/ImageGenerationItem.js +2 -0
  48. package/dist/agent/vendor-types/codex/app-server/LegacyAppPathString.d.ts +23 -0
  49. package/dist/agent/vendor-types/codex/app-server/LegacyAppPathString.js +2 -0
  50. package/dist/agent/vendor-types/codex/app-server/MessagePhase.d.ts +7 -0
  51. package/dist/agent/vendor-types/codex/app-server/MessagePhase.js +2 -0
  52. package/dist/agent/vendor-types/codex/app-server/ReasoningEffort.d.ts +4 -0
  53. package/dist/agent/vendor-types/codex/app-server/ReasoningEffort.js +2 -0
  54. package/dist/agent/vendor-types/codex/app-server/SleepItem.d.ts +7 -0
  55. package/dist/agent/vendor-types/codex/app-server/SleepItem.js +2 -0
  56. package/dist/agent/vendor-types/codex/app-server/WebSearchItem.d.ts +14 -0
  57. package/dist/agent/vendor-types/codex/app-server/WebSearchItem.js +2 -0
  58. package/dist/agent/vendor-types/codex/app-server/serde_json/JsonValue.d.ts +3 -0
  59. package/dist/agent/vendor-types/codex/app-server/serde_json/JsonValue.js +2 -0
  60. package/dist/agent/vendor-types/codex/app-server/v2/AgentMessageDelivery.d.ts +1 -0
  61. package/dist/agent/vendor-types/codex/app-server/v2/AgentMessageDelivery.js +2 -0
  62. package/dist/agent/vendor-types/codex/app-server/v2/AsyncUserInputQuestion.d.ts +4 -0
  63. package/dist/agent/vendor-types/codex/app-server/v2/AsyncUserInputQuestion.js +2 -0
  64. package/dist/agent/vendor-types/codex/app-server/v2/ByteRange.d.ts +4 -0
  65. package/dist/agent/vendor-types/codex/app-server/v2/ByteRange.js +2 -0
  66. package/dist/agent/vendor-types/codex/app-server/v2/CollabAgentState.d.ts +5 -0
  67. package/dist/agent/vendor-types/codex/app-server/v2/CollabAgentState.js +2 -0
  68. package/dist/agent/vendor-types/codex/app-server/v2/CollabAgentStatus.d.ts +1 -0
  69. package/dist/agent/vendor-types/codex/app-server/v2/CollabAgentStatus.js +2 -0
  70. package/dist/agent/vendor-types/codex/app-server/v2/CollabAgentTool.d.ts +1 -0
  71. package/dist/agent/vendor-types/codex/app-server/v2/CollabAgentTool.js +2 -0
  72. package/dist/agent/vendor-types/codex/app-server/v2/CollabAgentToolCallStatus.d.ts +1 -0
  73. package/dist/agent/vendor-types/codex/app-server/v2/CollabAgentToolCallStatus.js +2 -0
  74. package/dist/agent/vendor-types/codex/app-server/v2/CommandAction.d.ts +19 -0
  75. package/dist/agent/vendor-types/codex/app-server/v2/CommandAction.js +2 -0
  76. package/dist/agent/vendor-types/codex/app-server/v2/CommandExecutionSource.d.ts +1 -0
  77. package/dist/agent/vendor-types/codex/app-server/v2/CommandExecutionSource.js +2 -0
  78. package/dist/agent/vendor-types/codex/app-server/v2/CommandExecutionStatus.d.ts +1 -0
  79. package/dist/agent/vendor-types/codex/app-server/v2/CommandExecutionStatus.js +2 -0
  80. package/dist/agent/vendor-types/codex/app-server/v2/DynamicToolCallOutputContentItem.d.ts +10 -0
  81. package/dist/agent/vendor-types/codex/app-server/v2/DynamicToolCallOutputContentItem.js +2 -0
  82. package/dist/agent/vendor-types/codex/app-server/v2/DynamicToolCallStatus.d.ts +1 -0
  83. package/dist/agent/vendor-types/codex/app-server/v2/DynamicToolCallStatus.js +2 -0
  84. package/dist/agent/vendor-types/codex/app-server/v2/FileUpdateChange.d.ts +6 -0
  85. package/dist/agent/vendor-types/codex/app-server/v2/FileUpdateChange.js +2 -0
  86. package/dist/agent/vendor-types/codex/app-server/v2/HookPromptFragment.d.ts +4 -0
  87. package/dist/agent/vendor-types/codex/app-server/v2/HookPromptFragment.js +2 -0
  88. package/dist/agent/vendor-types/codex/app-server/v2/McpAppDisplayMode.d.ts +1 -0
  89. package/dist/agent/vendor-types/codex/app-server/v2/McpAppDisplayMode.js +2 -0
  90. package/dist/agent/vendor-types/codex/app-server/v2/McpAppUi.d.ts +8 -0
  91. package/dist/agent/vendor-types/codex/app-server/v2/McpAppUi.js +2 -0
  92. package/dist/agent/vendor-types/codex/app-server/v2/McpToolCallAppContext.d.ts +7 -0
  93. package/dist/agent/vendor-types/codex/app-server/v2/McpToolCallAppContext.js +2 -0
  94. package/dist/agent/vendor-types/codex/app-server/v2/McpToolCallError.d.ts +3 -0
  95. package/dist/agent/vendor-types/codex/app-server/v2/McpToolCallError.js +2 -0
  96. package/dist/agent/vendor-types/codex/app-server/v2/McpToolCallResult.d.ts +6 -0
  97. package/dist/agent/vendor-types/codex/app-server/v2/McpToolCallResult.js +2 -0
  98. package/dist/agent/vendor-types/codex/app-server/v2/McpToolCallStatus.d.ts +1 -0
  99. package/dist/agent/vendor-types/codex/app-server/v2/McpToolCallStatus.js +2 -0
  100. package/dist/agent/vendor-types/codex/app-server/v2/MemoryCitation.d.ts +5 -0
  101. package/dist/agent/vendor-types/codex/app-server/v2/MemoryCitation.js +2 -0
  102. package/dist/agent/vendor-types/codex/app-server/v2/MemoryCitationEntry.d.ts +6 -0
  103. package/dist/agent/vendor-types/codex/app-server/v2/MemoryCitationEntry.js +2 -0
  104. package/dist/agent/vendor-types/codex/app-server/v2/PatchApplyStatus.d.ts +1 -0
  105. package/dist/agent/vendor-types/codex/app-server/v2/PatchApplyStatus.js +2 -0
  106. package/dist/agent/vendor-types/codex/app-server/v2/PatchChangeKind.d.ts +8 -0
  107. package/dist/agent/vendor-types/codex/app-server/v2/PatchChangeKind.js +2 -0
  108. package/dist/agent/vendor-types/codex/app-server/v2/SubAgentActivityKind.d.ts +1 -0
  109. package/dist/agent/vendor-types/codex/app-server/v2/SubAgentActivityKind.js +2 -0
  110. package/dist/agent/vendor-types/codex/app-server/v2/TextElement.d.ts +11 -0
  111. package/dist/agent/vendor-types/codex/app-server/v2/TextElement.js +2 -0
  112. package/dist/agent/vendor-types/codex/app-server/v2/ThreadItem.d.ts +215 -0
  113. package/dist/agent/vendor-types/codex/app-server/v2/ThreadItem.js +2 -0
  114. package/dist/agent/vendor-types/codex/app-server/v2/UserInput.d.ts +35 -0
  115. package/dist/agent/vendor-types/codex/app-server/v2/UserInput.js +2 -0
  116. package/dist/agent/vendor-types/codex/app-server/v2/WebSearchAction.d.ts +14 -0
  117. package/dist/agent/vendor-types/codex/app-server/v2/WebSearchAction.js +2 -0
  118. package/dist/agent/workerBundle.generated.js +1 -1
  119. package/dist/cli/agent.js +17 -4
  120. package/dist/cli/services.d.ts +6 -5
  121. package/dist/dimension/api.d.ts +5 -4
  122. package/dist/dimension/paths.d.ts +4 -0
  123. package/dist/dimension/paths.js +10 -2
  124. package/dist/dimension/service.d.ts +1 -0
  125. package/dist/dimension/storage.js +3 -2
  126. package/dist/index.d.ts +1 -3
  127. package/dist/index.js +4 -5
  128. package/dist/lib/docker.d.ts +1 -0
  129. package/dist/portal-gateway/api.d.ts +6 -5
  130. package/dist/portal-gateway/gatewayService.d.ts +1 -0
  131. package/dist/portal-gateway/portalService.d.ts +2 -0
  132. package/dist/sandbox/api.d.ts +49 -21
  133. package/dist/sandbox/boatService.js +11 -3
  134. package/dist/sandbox/containerService.js +10 -3
  135. package/dist/sandbox/localService.js +20 -2
  136. package/dist/sandbox/sshService.js +37 -4
  137. package/package.json +25 -8
@@ -0,0 +1,162 @@
1
+ import { AGENT_BACKENDS, AgentInvalidError, } from "../../api.js";
2
+ /**
3
+ * Turns each method's params, as they arrived (JSON), into the protocol's types, or throws an
4
+ * AgentInvalidError saying what's wrong. Keeps only the fields the types have, so nothing unknown
5
+ * reaches the service (or its storage).
6
+ */
7
+ export const WORKER_PARAMS = {
8
+ "worker/health": () => ({}),
9
+ "worker/shutdown": () => ({}),
10
+ "backend/install": (params) => ({ backend: backend(params.backend) }),
11
+ "session/create": (params) => ({ session: session(object(params.session, "session")) }),
12
+ "session/list": () => ({}),
13
+ "session/update": (params) => ({ session: name(params), limits: limits(object(params.limits, "limits")) }),
14
+ "session/stop": (params) => ({ session: name(params) }),
15
+ "session/send": (params) => ({ session: name(params), message: userMessage(params.message) }),
16
+ "session/interrupt": (params) => ({ session: name(params) }),
17
+ "session/status": (params) => ({ session: name(params) }),
18
+ "session/lastUserMessages": (params) => ({ session: name(params) }),
19
+ "session/subscribe": (params) => ({
20
+ session: name(params),
21
+ subscription: text(params.subscription, "subscription"),
22
+ after_id: optional(params.after_id, (value) => text(value, "after_id")),
23
+ }),
24
+ "session/unsubscribe": (params) => ({ subscription: text(params.subscription, "subscription") }),
25
+ "session/transcript": (params) => ({
26
+ session: name(params),
27
+ limit: optional(params.limit, (value) => number(value, "limit")),
28
+ // `cursor`: `before`'s old name.
29
+ before: params.before === undefined ? optional(params.cursor, (value) => text(value, "cursor")) : text(params.before, "before"),
30
+ }),
31
+ "permission/list": (params) => ({ session: name(params) }),
32
+ "permission/respond": (params) => ({
33
+ session: name(params),
34
+ request: text(params.request, "request"),
35
+ result: permissionResult(params.result),
36
+ }),
37
+ "question/list": (params) => ({ session: name(params) }),
38
+ "question/respond": (params) => ({
39
+ session: name(params),
40
+ request: text(params.request, "request"),
41
+ response: questionResponse(params.response),
42
+ }),
43
+ "model/list": (params) => ({ session: name(params) }),
44
+ "model/set": (params) => ({
45
+ session: name(params),
46
+ model: params.model === null ? null : text(params.model, "the model (a model name, or null for the backend's default)"),
47
+ }),
48
+ "task/list": (params) => ({ session: name(params) }),
49
+ "task/stop": (params) => ({ session: name(params), task: text(params.task, "task") }),
50
+ "auth/status": (params) => ({ session: name(params) }),
51
+ "auth/login": (params) => ({
52
+ session: name(params),
53
+ gatewaySignedIn: optional(params.gatewaySignedIn, (value) => boolean(value, "gatewaySignedIn")) ?? false,
54
+ }),
55
+ "auth/code": (params) => ({ session: name(params), code: text(params.code, "the code (the one the sign-in page showed)").trim() }),
56
+ };
57
+ function invalid(message) {
58
+ throw new AgentInvalidError(message);
59
+ }
60
+ function name(params) {
61
+ return text(params.session, "session");
62
+ }
63
+ function object(value, what) {
64
+ if (value === null || typeof value !== "object" || Array.isArray(value))
65
+ invalid(`${what} must be an object`);
66
+ // type-bypass: a non-null, non-array object is a record of its fields.
67
+ return value;
68
+ }
69
+ /** A non-empty string. */
70
+ function text(value, what) {
71
+ if (typeof value !== "string" || value.trim() === "")
72
+ invalid(`${what} must be a non-empty string`);
73
+ return value;
74
+ }
75
+ function number(value, what) {
76
+ if (typeof value !== "number" || !Number.isFinite(value))
77
+ invalid(`${what} must be a number`);
78
+ return value;
79
+ }
80
+ function boolean(value, what) {
81
+ if (typeof value !== "boolean")
82
+ invalid(`${what} must be true or false`);
83
+ return value;
84
+ }
85
+ function optional(value, parse) {
86
+ return value === undefined ? undefined : parse(value);
87
+ }
88
+ function backend(value) {
89
+ const known = AGENT_BACKENDS.find((name) => name === value);
90
+ if (!known)
91
+ invalid(`unknown backend "${String(value)}"; known: ${AGENT_BACKENDS.join(", ")}`);
92
+ return known;
93
+ }
94
+ function memoryLimit(value) {
95
+ const bytes = number(value, "memoryLimit");
96
+ if (!(bytes > 0))
97
+ invalid("memoryLimit must be positive");
98
+ // type-bypass: a positive byte count is what a MemoryLimit is (MemoryLimit() parses the CLI's strings).
99
+ return bytes;
100
+ }
101
+ function cpuLimit(value) {
102
+ const cores = number(value, "cpuLimit");
103
+ if (!(cores > 0))
104
+ invalid("cpuLimit must be positive");
105
+ // type-bypass: a positive core count is what a CPULimit is (CPULimit() parses the CLI's strings).
106
+ return cores;
107
+ }
108
+ function environment(value) {
109
+ const fields = object(value, "env");
110
+ for (const [key, entry] of Object.entries(fields))
111
+ if (typeof entry !== "string")
112
+ invalid(`env.${key} must be a string`);
113
+ // type-bypass: every value was just checked to be a string.
114
+ return fields;
115
+ }
116
+ function session(fields) {
117
+ return {
118
+ name: text(fields.name, "the session's name"),
119
+ backend: backend(fields.backend),
120
+ memoryLimit: memoryLimit(fields.memoryLimit),
121
+ cpuLimit: cpuLimit(fields.cpuLimit),
122
+ cwd: optional(fields.cwd, (value) => text(value, "cwd")),
123
+ env: optional(fields.env, environment),
124
+ };
125
+ }
126
+ function limits(fields) {
127
+ return { memoryLimit: optional(fields.memoryLimit, memoryLimit), cpuLimit: optional(fields.cpuLimit, cpuLimit) };
128
+ }
129
+ function userMessage(value) {
130
+ const fields = object(value, "a message (an SDK user message: {type: \"user\", message})");
131
+ if (fields.type !== "user")
132
+ invalid('a message is an SDK user message: {type: "user", message}');
133
+ const message = object(fields.message, "message.message");
134
+ if (message.role !== "user")
135
+ invalid('message.message.role must be "user"');
136
+ if (typeof message.content !== "string" && !Array.isArray(message.content))
137
+ invalid("message.message.content must be a string or an array of content blocks");
138
+ // type-bypass: the envelope is checked; the content blocks are the CLI's to judge.
139
+ return value;
140
+ }
141
+ function permissionResult(value) {
142
+ const fields = object(value, "result");
143
+ if (fields.behavior === "allow") {
144
+ return { behavior: "allow", updatedInput: optional(fields.updatedInput, (input) => object(input, "updatedInput")) };
145
+ }
146
+ if (fields.behavior === "deny") {
147
+ return {
148
+ behavior: "deny",
149
+ message: typeof fields.message === "string" ? fields.message : invalid("a denial needs a message"),
150
+ interrupt: optional(fields.interrupt, (interrupt) => boolean(interrupt, "interrupt")),
151
+ };
152
+ }
153
+ return invalid('a permission result is {behavior: "allow"} or {behavior: "deny", message}');
154
+ }
155
+ function questionResponse(value) {
156
+ const answers = object(object(value, "response").answers, "a question response's answers ({<question>: <answer>})");
157
+ for (const [question, answer] of Object.entries(answers))
158
+ if (typeof answer !== "string")
159
+ invalid(`the answer to "${question}" must be a string`);
160
+ // type-bypass: every answer was just checked to be a string.
161
+ return { answers: answers };
162
+ }
@@ -0,0 +1,10 @@
1
+ /**
2
+ * A path that is guaranteed to be absolute and normalized (though it is not
3
+ * guaranteed to be canonicalized or exist on the filesystem).
4
+ *
5
+ * IMPORTANT: When deserializing an `AbsolutePathBuf`, a base path must be set
6
+ * using [AbsolutePathBufGuard::new]. If no base path is set, the
7
+ * deserialization will fail unless the path being deserialized is already
8
+ * absolute.
9
+ */
10
+ export type AbsolutePathBuf = string;
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,2 @@
1
+ import type { FunctionCallOutputContentItem } from "./FunctionCallOutputContentItem";
2
+ export type FunctionCallOutputBody = string | Array<FunctionCallOutputContentItem>;
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,22 @@
1
+ import type { ImageDetail } from "./ImageDetail";
2
+ /**
3
+ * Responses API compatible content items that can be returned by a tool call.
4
+ * This is a subset of ContentItem with the types we support as function call outputs.
5
+ */
6
+ export type FunctionCallOutputContentItem = {
7
+ "type": "input_text";
8
+ text: string;
9
+ } | {
10
+ "type": "input_image";
11
+ detail?: ImageDetail;
12
+ } & ({
13
+ image_url: string;
14
+ } | {
15
+ file_id: string;
16
+ }) | {
17
+ "type": "input_audio";
18
+ audio_url: string;
19
+ } | {
20
+ "type": "encrypted_content";
21
+ encrypted_content: string;
22
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1 @@
1
+ export type ImageDetail = "auto" | "low" | "high" | "original";
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,5 @@
1
+ export type ImageGenerationFailure = {
2
+ "type": "usageLimitExceeded";
3
+ limitId: string;
4
+ resetsAt: number | null;
5
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,11 @@
1
+ import type { AbsolutePathBuf } from "./AbsolutePathBuf";
2
+ import type { ImageGenerationFailure } from "./ImageGenerationFailure";
3
+ export type ImageGenerationItem = {
4
+ id: string;
5
+ status: string;
6
+ revisedPrompt: string | null;
7
+ result: string;
8
+ transparentBackground?: boolean;
9
+ failure: ImageGenerationFailure | null;
10
+ savedPath?: AbsolutePathBuf;
11
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,23 @@
1
+ /**
2
+ * A UTF-8 path for preserving raw path compatibility at the app-server API
3
+ * boundary while Codex migrates to [`PathUri`].
4
+ *
5
+ * Supports storing arbitrary strings read from the API and converting to and
6
+ * from [`PathUri`] using an explicitly selected native path convention.
7
+ *
8
+ * When converting from [`PathUri`], "native" refers to the supplied
9
+ * [`PathConvention`], which may be foreign to the operating system running
10
+ * this process. The inner string is private so path-producing code must use a
11
+ * path conversion method instead of bypassing the intended conversion
12
+ * boundary. Non-UTF-8 paths are converted to UTF-8 lossily because this API
13
+ * value is serialized as a JSON string.
14
+ *
15
+ * Deserialization and [`Self::from_string`] accept any UTF-8 string without
16
+ * interpreting or validating it. Use [`Self::from_string`] when a caller
17
+ * already owns legacy app-server path text and needs to preserve its wire
18
+ * spelling; use [`Self::from_path`], [`Self::from_abs_path`], or
19
+ * [`Self::from_path_uri`] when converting an actual path value. Relative
20
+ * path text remains valid until an operation such as [`Self::to_path_uri`]
21
+ * requires an absolute path.
22
+ */
23
+ export type LegacyAppPathString = string;
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Classifies an assistant message as interim commentary or final answer text.
3
+ *
4
+ * Providers do not emit this consistently, so callers must treat `None` as
5
+ * "phase unknown" and keep compatibility behavior for legacy models.
6
+ */
7
+ export type MessagePhase = "commentary" | "final_answer";
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,4 @@
1
+ /**
2
+ * See https://platform.openai.com/docs/guides/reasoning?api-mode=responses#get-started-with-reasoning
3
+ */
4
+ export type ReasoningEffort = string;
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Display item emitted by the interruptible `clock.sleep` tool.
3
+ */
4
+ export type SleepItem = {
5
+ id: string;
6
+ durationMs: number;
7
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,14 @@
1
+ import type { JsonValue } from "./serde_json/JsonValue";
2
+ import type { WebSearchAction } from "./v2/WebSearchAction";
3
+ export type WebSearchItem = {
4
+ id: string;
5
+ query: string;
6
+ action: WebSearchAction | null;
7
+ /**
8
+ * Structured search results returned out-of-band by standalone web search.
9
+ *
10
+ * These stay as opaque JSON at the extension/app-server boundary so new
11
+ * result fields and result types can pass through without a Codex release.
12
+ */
13
+ results: Array<JsonValue> | null;
14
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,3 @@
1
+ export type JsonValue = number | string | boolean | Array<JsonValue> | {
2
+ [key in string]?: JsonValue;
3
+ } | null;
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1 @@
1
+ export type AgentMessageDelivery = "async";
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,4 @@
1
+ export type AsyncUserInputQuestion = {
2
+ title: string;
3
+ options: Array<string> | null;
4
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,4 @@
1
+ export type ByteRange = {
2
+ start: number;
3
+ end: number;
4
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,5 @@
1
+ import type { CollabAgentStatus } from "./CollabAgentStatus";
2
+ export type CollabAgentState = {
3
+ status: CollabAgentStatus;
4
+ message: string | null;
5
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1 @@
1
+ export type CollabAgentStatus = "pendingInit" | "running" | "interrupted" | "completed" | "errored" | "shutdown" | "notFound";
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1 @@
1
+ export type CollabAgentTool = "spawnAgent" | "sendInput" | "resumeAgent" | "wait" | "closeAgent" | "sendMessage" | "followupTask" | "interruptAgent" | "listAgents";
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1 @@
1
+ export type CollabAgentToolCallStatus = "inProgress" | "completed" | "failed" | "interrupted";
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,19 @@
1
+ import type { LegacyAppPathString } from "../LegacyAppPathString";
2
+ export type CommandAction = {
3
+ "type": "read";
4
+ command: string;
5
+ name: string;
6
+ path: LegacyAppPathString;
7
+ } | {
8
+ "type": "listFiles";
9
+ command: string;
10
+ path: string | null;
11
+ } | {
12
+ "type": "search";
13
+ command: string;
14
+ query: string | null;
15
+ path: string | null;
16
+ } | {
17
+ "type": "unknown";
18
+ command: string;
19
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1 @@
1
+ export type CommandExecutionSource = "agent" | "userShell" | "unifiedExecStartup" | "unifiedExecInteraction";
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1 @@
1
+ export type CommandExecutionStatus = "inProgress" | "completed" | "failed" | "declined";
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,10 @@
1
+ export type DynamicToolCallOutputContentItem = {
2
+ "type": "inputText";
3
+ text: string;
4
+ } | {
5
+ "type": "inputImage";
6
+ imageUrl: string;
7
+ } | {
8
+ "type": "inputAudio";
9
+ audioUrl: string;
10
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1 @@
1
+ export type DynamicToolCallStatus = "inProgress" | "completed" | "failed";
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,6 @@
1
+ import type { PatchChangeKind } from "./PatchChangeKind";
2
+ export type FileUpdateChange = {
3
+ path: string;
4
+ kind: PatchChangeKind;
5
+ diff: string;
6
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,4 @@
1
+ export type HookPromptFragment = {
2
+ text: string;
3
+ hookRunId: string;
4
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1 @@
1
+ export type McpAppDisplayMode = "inline" | "fullscreen";
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,8 @@
1
+ import type { McpAppDisplayMode } from "./McpAppDisplayMode";
2
+ /**
3
+ * UI resource and display preference for model invocations, captured from the tool descriptor.
4
+ */
5
+ export type McpAppUi = {
6
+ resourceUri: string;
7
+ preferredModelDisplayMode: McpAppDisplayMode;
8
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,7 @@
1
+ export type McpToolCallAppContext = {
2
+ connectorId: string;
3
+ linkId: string | null;
4
+ resourceUri: string | null;
5
+ appName: string | null;
6
+ actionName: string | null;
7
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,3 @@
1
+ export type McpToolCallError = {
2
+ message: string;
3
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,6 @@
1
+ import type { JsonValue } from "../serde_json/JsonValue";
2
+ export type McpToolCallResult = {
3
+ content: Array<JsonValue>;
4
+ structuredContent: JsonValue | null;
5
+ _meta: JsonValue | null;
6
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1 @@
1
+ export type McpToolCallStatus = "inProgress" | "completed" | "failed";
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,5 @@
1
+ import type { MemoryCitationEntry } from "./MemoryCitationEntry";
2
+ export type MemoryCitation = {
3
+ entries: Array<MemoryCitationEntry>;
4
+ threadIds: Array<string>;
5
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,6 @@
1
+ export type MemoryCitationEntry = {
2
+ path: string;
3
+ lineStart: number;
4
+ lineEnd: number;
5
+ note: string;
6
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1 @@
1
+ export type PatchApplyStatus = "inProgress" | "completed" | "failed" | "declined";
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,8 @@
1
+ export type PatchChangeKind = {
2
+ "type": "add";
3
+ } | {
4
+ "type": "delete";
5
+ } | {
6
+ "type": "update";
7
+ move_path: string | null;
8
+ };
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1 @@
1
+ export type SubAgentActivityKind = "started" | "interacted" | "interrupted" | "completed";
@@ -0,0 +1,2 @@
1
+ // GENERATED CODE! DO NOT MODIFY BY HAND!
2
+ export {};
@@ -0,0 +1,11 @@
1
+ import type { ByteRange } from "./ByteRange";
2
+ export type TextElement = {
3
+ /**
4
+ * Byte range in the parent `text` buffer that this element occupies.
5
+ */
6
+ byteRange: ByteRange;
7
+ /**
8
+ * Optional human-readable placeholder for the element, displayed in the UI.
9
+ */
10
+ placeholder: string | null;
11
+ };