@finalai/agent-provider 0.9.0 → 0.11.0

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 (206) hide show
  1. package/HOSTING.md +334 -245
  2. package/README.md +106 -20
  3. package/dist/modules/canonical-json.d.mts +4 -0
  4. package/dist/modules/canonical-json.mjs +33 -0
  5. package/dist/modules/canonical-json.mjs.map +7 -0
  6. package/dist/modules/channel.d.mts +51 -15
  7. package/dist/modules/channel.mjs +1 -0
  8. package/dist/modules/channel.mjs.map +2 -2
  9. package/dist/modules/code-host/host.d.mts +10 -0
  10. package/dist/modules/code-host/host.mjs +88 -0
  11. package/dist/modules/code-host/host.mjs.map +7 -0
  12. package/dist/modules/code-host/in-process.d.mts +24 -0
  13. package/dist/modules/code-host/in-process.mjs +89 -0
  14. package/dist/modules/code-host/in-process.mjs.map +7 -0
  15. package/dist/modules/code-host/index.d.mts +4 -0
  16. package/dist/modules/code-host/index.mjs +5 -0
  17. package/dist/modules/code-host/index.mjs.map +7 -0
  18. package/dist/modules/code-host/serverless.d.mts +63 -0
  19. package/dist/modules/code-host/serverless.mjs +27 -0
  20. package/dist/modules/code-host/serverless.mjs.map +7 -0
  21. package/dist/modules/code-host/types.d.mts +152 -0
  22. package/dist/modules/code-host/types.mjs +85 -0
  23. package/dist/modules/code-host/types.mjs.map +7 -0
  24. package/dist/modules/conformance/agent.mjs +72 -6
  25. package/dist/modules/conformance/agent.mjs.map +2 -2
  26. package/dist/modules/conformance/harness-kit.d.mts +9 -2
  27. package/dist/modules/conformance/harness-kit.mjs +224 -63
  28. package/dist/modules/conformance/harness-kit.mjs.map +3 -3
  29. package/dist/modules/conformance/local-harness.d.mts +1 -4
  30. package/dist/modules/conformance/local-harness.mjs +21 -22
  31. package/dist/modules/conformance/local-harness.mjs.map +2 -2
  32. package/dist/modules/conformance/protocol.d.mts +1 -0
  33. package/dist/modules/conformance/protocol.mjs +2 -0
  34. package/dist/modules/conformance/protocol.mjs.map +2 -2
  35. package/dist/modules/conformance/sandbox-kit.d.mts +12 -4
  36. package/dist/modules/conformance/sandbox-kit.mjs +189 -103
  37. package/dist/modules/conformance/sandbox-kit.mjs.map +2 -2
  38. package/dist/modules/conformance/scripted-model/chat-completions.mjs +1 -0
  39. package/dist/modules/conformance/scripted-model/chat-completions.mjs.map +2 -2
  40. package/dist/modules/conformance/scripted-model/directives.d.mts +3 -0
  41. package/dist/modules/conformance/scripted-model/directives.mjs +26 -10
  42. package/dist/modules/conformance/scripted-model/directives.mjs.map +2 -2
  43. package/dist/modules/conformance/scripted-model/messages.mjs +1 -0
  44. package/dist/modules/conformance/scripted-model/messages.mjs.map +2 -2
  45. package/dist/modules/conformance/scripted-model/responses.mjs +2 -0
  46. package/dist/modules/conformance/scripted-model/responses.mjs.map +2 -2
  47. package/dist/modules/conformance/stdio.d.mts +21 -0
  48. package/dist/modules/conformance/stdio.mjs +158 -0
  49. package/dist/modules/conformance/stdio.mjs.map +7 -0
  50. package/dist/modules/credential-routes.d.mts +3 -3
  51. package/dist/modules/credential-routes.mjs +2 -2
  52. package/dist/modules/credential-routes.mjs.map +2 -2
  53. package/dist/modules/document.d.mts +358 -0
  54. package/dist/modules/document.mjs +193 -0
  55. package/dist/modules/document.mjs.map +7 -0
  56. package/dist/modules/harness-configuration.d.mts +16 -0
  57. package/dist/modules/harness-configuration.mjs +83 -0
  58. package/dist/modules/harness-configuration.mjs.map +7 -0
  59. package/dist/modules/harness-definition.d.mts +280 -0
  60. package/dist/modules/harness-definition.mjs +430 -0
  61. package/dist/modules/harness-definition.mjs.map +7 -0
  62. package/dist/modules/harness-provider.d.mts +197 -0
  63. package/dist/modules/harness-provider.mjs +108 -0
  64. package/dist/modules/harness-provider.mjs.map +7 -0
  65. package/dist/modules/harness-requirements.d.mts +19 -0
  66. package/dist/modules/harness-requirements.mjs +40 -0
  67. package/dist/modules/harness-requirements.mjs.map +7 -0
  68. package/dist/modules/harness-start.d.mts +33 -0
  69. package/dist/modules/harness-start.mjs +107 -0
  70. package/dist/modules/harness-start.mjs.map +7 -0
  71. package/dist/modules/harness.d.mts +84 -109
  72. package/dist/modules/harness.mjs +56 -111
  73. package/dist/modules/harness.mjs.map +3 -3
  74. package/dist/modules/identity.d.mts +1 -0
  75. package/dist/modules/identity.mjs +2 -0
  76. package/dist/modules/identity.mjs.map +7 -0
  77. package/dist/modules/index.d.mts +12 -7
  78. package/dist/modules/index.mjs +12 -7
  79. package/dist/modules/index.mjs.map +2 -2
  80. package/dist/modules/inference.d.mts +35 -0
  81. package/dist/modules/inference.mjs +74 -0
  82. package/dist/modules/inference.mjs.map +7 -0
  83. package/dist/modules/local-channel-context.d.mts +1 -1
  84. package/dist/modules/local-channel-context.mjs +1 -1
  85. package/dist/modules/local-channel-context.mjs.map +2 -2
  86. package/dist/modules/requirements-check.d.mts +30 -0
  87. package/dist/modules/requirements-check.mjs +164 -0
  88. package/dist/modules/requirements-check.mjs.map +7 -0
  89. package/dist/modules/sandbox/client.d.mts +3 -0
  90. package/dist/modules/sandbox/client.mjs +101 -18
  91. package/dist/modules/sandbox/client.mjs.map +2 -2
  92. package/dist/modules/sandbox/grant.d.mts +78 -0
  93. package/dist/modules/sandbox/grant.mjs +134 -0
  94. package/dist/modules/sandbox/grant.mjs.map +7 -0
  95. package/dist/modules/sandbox/index.d.mts +3 -3
  96. package/dist/modules/sandbox/index.mjs +4 -5
  97. package/dist/modules/sandbox/index.mjs.map +2 -2
  98. package/dist/modules/sandbox/mcp-hosted.d.mts +1 -1
  99. package/dist/modules/sandbox/mcp-hosted.mjs +4 -7
  100. package/dist/modules/sandbox/mcp-hosted.mjs.map +2 -2
  101. package/dist/modules/sandbox/mcp.d.mts +4 -2
  102. package/dist/modules/sandbox/mcp.mjs +14 -7
  103. package/dist/modules/sandbox/mcp.mjs.map +2 -2
  104. package/dist/modules/sandbox/memory-sandbox.d.mts +2 -1
  105. package/dist/modules/sandbox/memory-sandbox.mjs +71 -41
  106. package/dist/modules/sandbox/memory-sandbox.mjs.map +2 -2
  107. package/dist/modules/sandbox/networking.d.mts +7 -7
  108. package/dist/modules/sandbox/networking.mjs +16 -9
  109. package/dist/modules/sandbox/networking.mjs.map +2 -2
  110. package/dist/modules/sandbox/remote/adapter.d.mts +30 -0
  111. package/dist/modules/sandbox/remote/adapter.mjs +381 -0
  112. package/dist/modules/sandbox/remote/adapter.mjs.map +7 -0
  113. package/dist/modules/sandbox/remote/body.d.mts +1 -0
  114. package/dist/modules/sandbox/remote/body.mjs +27 -0
  115. package/dist/modules/sandbox/remote/body.mjs.map +7 -0
  116. package/dist/modules/sandbox/remote/errors.d.mts +10 -0
  117. package/dist/modules/sandbox/remote/errors.mjs +62 -0
  118. package/dist/modules/sandbox/remote/errors.mjs.map +7 -0
  119. package/dist/modules/sandbox/remote/index.d.mts +5 -0
  120. package/dist/modules/sandbox/remote/index.mjs +6 -0
  121. package/dist/modules/sandbox/remote/index.mjs.map +7 -0
  122. package/dist/modules/sandbox/remote/ndjson.d.mts +6 -0
  123. package/dist/modules/sandbox/remote/ndjson.mjs +80 -0
  124. package/dist/modules/sandbox/remote/ndjson.mjs.map +7 -0
  125. package/dist/modules/sandbox/remote/platform-api.d.mts +8 -0
  126. package/dist/modules/sandbox/remote/platform-api.mjs +15 -0
  127. package/dist/modules/sandbox/remote/platform-api.mjs.map +7 -0
  128. package/dist/modules/sandbox/remote/preamble.d.mts +7 -0
  129. package/dist/modules/sandbox/remote/preamble.mjs +51 -0
  130. package/dist/modules/sandbox/remote/preamble.mjs.map +7 -0
  131. package/dist/modules/sandbox/remote/serve.d.mts +34 -0
  132. package/dist/modules/sandbox/remote/serve.mjs +520 -0
  133. package/dist/modules/sandbox/remote/serve.mjs.map +7 -0
  134. package/dist/modules/sandbox/remote/testing.d.mts +34 -0
  135. package/dist/modules/sandbox/remote/testing.mjs +275 -0
  136. package/dist/modules/sandbox/remote/testing.mjs.map +7 -0
  137. package/dist/modules/sandbox/seeds.d.mts +2 -2
  138. package/dist/modules/sandbox/seeds.mjs +2 -2
  139. package/dist/modules/sandbox/seeds.mjs.map +2 -2
  140. package/dist/modules/sandbox/server.d.mts +4 -6
  141. package/dist/modules/sandbox/server.mjs +93 -49
  142. package/dist/modules/sandbox/server.mjs.map +2 -2
  143. package/dist/modules/sandbox/setup/apply.d.mts +40 -0
  144. package/dist/modules/sandbox/setup/apply.mjs +190 -0
  145. package/dist/modules/sandbox/setup/apply.mjs.map +7 -0
  146. package/dist/modules/sandbox/setup/describe.d.mts +10 -0
  147. package/dist/modules/sandbox/setup/describe.mjs +62 -0
  148. package/dist/modules/sandbox/setup/describe.mjs.map +7 -0
  149. package/dist/modules/sandbox/setup/index.d.mts +6 -0
  150. package/dist/modules/sandbox/setup/index.mjs +17 -0
  151. package/dist/modules/sandbox/setup/index.mjs.map +7 -0
  152. package/dist/modules/sandbox/setup/paths.d.mts +8 -0
  153. package/dist/modules/sandbox/setup/paths.mjs +18 -0
  154. package/dist/modules/sandbox/setup/paths.mjs.map +7 -0
  155. package/dist/modules/sandbox/setup/schema.d.mts +43 -0
  156. package/dist/modules/sandbox/setup/schema.mjs +58 -0
  157. package/dist/modules/sandbox/setup/schema.mjs.map +7 -0
  158. package/dist/modules/sandbox/tool-policy.d.mts +1 -1
  159. package/dist/modules/sandbox/tool-policy.mjs +1 -1
  160. package/dist/modules/sandbox/tool-policy.mjs.map +2 -2
  161. package/dist/modules/sandbox/types.d.mts +117 -142
  162. package/dist/modules/sandbox/types.mjs +47 -57
  163. package/dist/modules/sandbox/types.mjs.map +3 -3
  164. package/dist/modules/sandbox/wire.d.mts +93 -6
  165. package/dist/modules/sandbox/wire.mjs +61 -38
  166. package/dist/modules/sandbox/wire.mjs.map +2 -2
  167. package/dist/modules/schemas.d.mts +5 -76
  168. package/dist/modules/schemas.mjs +18 -85
  169. package/dist/modules/schemas.mjs.map +2 -2
  170. package/dist/modules/tool-annotations.d.mts +15 -6
  171. package/dist/modules/tool-annotations.mjs +9 -3
  172. package/dist/modules/tool-annotations.mjs.map +2 -2
  173. package/dist/modules/tool-descriptor.d.mts +16 -0
  174. package/dist/modules/tool-descriptor.mjs +19 -0
  175. package/dist/modules/tool-descriptor.mjs.map +7 -0
  176. package/dist/modules/tool-patterns.d.mts +7 -7
  177. package/dist/modules/tool-patterns.mjs +10 -9
  178. package/dist/modules/tool-patterns.mjs.map +2 -2
  179. package/package.json +86 -41
  180. package/dist/modules/credentials.d.mts +0 -206
  181. package/dist/modules/credentials.mjs +0 -207
  182. package/dist/modules/credentials.mjs.map +0 -7
  183. package/dist/modules/dynamic.d.mts +0 -40
  184. package/dist/modules/dynamic.mjs +0 -79
  185. package/dist/modules/dynamic.mjs.map +0 -7
  186. package/dist/modules/hosted-bindings.d.mts +0 -15
  187. package/dist/modules/hosted-bindings.mjs +0 -21
  188. package/dist/modules/hosted-bindings.mjs.map +0 -7
  189. package/dist/modules/manifest.d.mts +0 -791
  190. package/dist/modules/manifest.mjs +0 -322
  191. package/dist/modules/manifest.mjs.map +0 -7
  192. package/dist/modules/provider-ref.d.mts +0 -29
  193. package/dist/modules/provider-ref.mjs +0 -55
  194. package/dist/modules/provider-ref.mjs.map +0 -7
  195. package/dist/modules/room-surface.d.mts +0 -355
  196. package/dist/modules/room-surface.mjs +0 -156
  197. package/dist/modules/room-surface.mjs.map +0 -7
  198. package/dist/modules/sandbox/open-scope-node.d.mts +0 -4
  199. package/dist/modules/sandbox/open-scope-node.mjs +0 -19
  200. package/dist/modules/sandbox/open-scope-node.mjs.map +0 -7
  201. package/dist/modules/sandbox/open-scope.d.mts +0 -16
  202. package/dist/modules/sandbox/open-scope.mjs +0 -66
  203. package/dist/modules/sandbox/open-scope.mjs.map +0 -7
  204. package/dist/modules/sandbox/workspace-identity.d.mts +0 -5
  205. package/dist/modules/sandbox/workspace-identity.mjs +0 -14
  206. package/dist/modules/sandbox/workspace-identity.mjs.map +0 -7
@@ -1,39 +1,33 @@
1
1
  import type { McpServer } from '@agentclientprotocol/sdk/experimental/v2';
2
+ import { Capability } from '@finalai/agent-protocol';
3
+ import { InferenceSourceKind, type ResolvedHarnessSettingsIface } from '@finalai/agent-protocol/agent-platform';
4
+ import { RuntimeKind } from '@finalai/agent-protocol';
2
5
  import * as z from 'zod';
3
6
  import { CredentialRoute, type RouteGrantIface } from "./credential-routes.mjs";
4
- import { CredentialDelivery, InferenceCredentialKind } from "./credentials.mjs";
5
- import type { JsonSchema, JsonValue } from "./json.mjs";
6
- import type { HostedBindingsIface } from "./hosted-bindings.mjs";
7
- import { BaseCapability, type ResolvedAgentManifestIface } from "./manifest.mjs";
8
- import { type ProviderRef } from "./provider-ref.mjs";
9
- export declare const PENDING_BUNDLE_EXPORT = "<pending>";
7
+ import type { AgentDocumentIface } from "./document.mjs";
8
+ import type { JsonValue } from "./json.mjs";
9
+ import type { HarnessDefinitionIface } from "./harness-definition.mjs";
10
+ import { type SandboxGrantIface } from "./sandbox/grant.mjs";
11
+ export { HarnessComputeStatus, harnessEnvironmentSchema, harnessSettingsSchema, harnessUrlEnvironmentSchema, isUrlEnvironment, type HarnessEnvironmentIface, type HarnessSettingsIface, type HarnessUrlEnvironmentIface, type ResolvedHarnessSettingsIface, } from '@finalai/agent-protocol/agent-platform';
10
12
  export declare enum AcpTransport {
11
13
  Relay = "relay",
12
14
  Ws = "ws",
13
15
  Http = "http",
14
- Stdio = "stdio"
16
+ Stdio = "stdio",
17
+ Sandbox = "sandbox"
15
18
  }
16
19
  export declare enum McpTransportKind {
17
20
  Acp = "acp",
18
21
  Http = "http",
19
22
  Stdio = "stdio"
20
23
  }
21
- export declare enum BaseToolProvision {
22
- Bound = "bound",
23
- HostDisableable = "host-disableable",
24
- HostFixed = "host-fixed"
25
- }
26
24
  export declare enum SandboxWire {
27
25
  HandleRpc = "handle-rpc",
28
26
  Mcp = "mcp"
29
27
  }
30
- export declare enum UserInstructionDelivery {
31
- History = "history",
32
- System = "system"
33
- }
34
- export declare enum HarnessTrustClass {
35
- FirstParty = "first-party",
36
- ThirdParty = "third-party"
28
+ export declare enum CredentialDelivery {
29
+ PerRequest = "per-request",
30
+ AtOpen = "at-open"
37
31
  }
38
32
  export declare enum PromptWhileRunning {
39
33
  Inject = "inject",
@@ -41,53 +35,8 @@ export declare enum PromptWhileRunning {
41
35
  }
42
36
  export declare const DEFAULT_PROMPT_WHILE_RUNNING = PromptWhileRunning.Queue;
43
37
  export declare const DEFAULT_SESSION_SURVIVES_DISCONNECT = false;
44
- export declare const baseToolDeclarationSchema: z.ZodObject<{
45
- provision: z.ZodEnum<typeof BaseToolProvision>;
46
- nativeTools: z.ZodArray<z.ZodString>;
47
- }, z.core.$strip>;
48
- export declare const harnessDescriptionSchema: z.ZodObject<{
49
- configSchema: z.ZodType<import("./json.mjs").JsonObject, unknown, z.core.$ZodTypeInternals<import("./json.mjs").JsonObject, unknown>>;
50
- userInstructionDelivery: z.ZodOptional<z.ZodEnum<typeof UserInstructionDelivery>>;
51
- acp: z.ZodObject<{
52
- transports: z.ZodArray<z.ZodEnum<typeof AcpTransport>>;
53
- mcp: z.ZodArray<z.ZodEnum<typeof McpTransportKind>>;
54
- }, z.core.$strip>;
55
- baseTools: z.ZodRecord<z.ZodEnum<typeof BaseCapability> & z.core.$partial, z.ZodObject<{
56
- provision: z.ZodEnum<typeof BaseToolProvision>;
57
- nativeTools: z.ZodArray<z.ZodString>;
58
- }, z.core.$strip>>;
59
- consumes: z.ZodArray<z.ZodEnum<typeof SandboxWire>>;
60
- inference: z.ZodObject<{
61
- vendors: z.ZodArray<z.ZodString>;
62
- kinds: z.ZodArray<z.ZodEnum<typeof InferenceCredentialKind>>;
63
- delivery: z.ZodEnum<typeof CredentialDelivery>;
64
- }, z.core.$strip>;
65
- trust: z.ZodOptional<z.ZodEnum<typeof HarnessTrustClass>>;
66
- supports: z.ZodObject<{
67
- observe: z.ZodBoolean;
68
- resumeReplay: z.ZodBoolean;
69
- fork: z.ZodBoolean;
70
- authorMeta: z.ZodBoolean;
71
- nativeToolPolicy: z.ZodOptional<z.ZodBoolean>;
72
- deferredToolSearch: z.ZodOptional<z.ZodBoolean>;
73
- }, z.core.$strip>;
74
- promptWhileRunning: z.ZodDefault<z.ZodEnum<typeof PromptWhileRunning>>;
75
- sessionSurvivesDisconnect: z.ZodDefault<z.ZodBoolean>;
76
- }, z.core.$strip>;
77
- export type BaseToolDeclarationIface = z.infer<typeof baseToolDeclarationSchema>;
78
- export type HarnessDescriptionIface = z.infer<typeof harnessDescriptionSchema>;
79
- export declare const deliveredHarnessConfig: (args: {
80
- config: JsonValue;
81
- description: HarnessDescriptionIface;
82
- }) => JsonValue;
83
38
  export declare const harnessSessionRefSchema: z.ZodObject<{
84
- harness: z.ZodDiscriminatedUnion<[z.ZodObject<{
85
- kind: z.ZodLiteral<import("./provider-ref.mjs").ProviderRefKind.Package>;
86
- specifier: z.ZodString;
87
- }, z.core.$strip>, z.ZodObject<{
88
- kind: z.ZodLiteral<import("./provider-ref.mjs").ProviderRefKind.Bundle>;
89
- export: z.ZodString;
90
- }, z.core.$strip>], "kind">;
39
+ harness: z.ZodString;
91
40
  harnessSessionRef: z.ZodString;
92
41
  generation: z.ZodNumber;
93
42
  }, z.core.$strip>;
@@ -107,7 +56,7 @@ export interface CredentialGrantRefreshIface {
107
56
  }
108
57
  export interface AtOpenModelCredentialIface {
109
58
  vendor: string;
110
- kind: InferenceCredentialKind;
59
+ kind: InferenceSourceKind;
111
60
  baseUrl: string | null;
112
61
  apiKey: string | null;
113
62
  subscription: {
@@ -118,7 +67,7 @@ export interface AtOpenModelCredentialIface {
118
67
  }
119
68
  export declare const atOpenModelCredentialSchema: z.ZodObject<{
120
69
  vendor: z.ZodString;
121
- kind: z.ZodEnum<typeof InferenceCredentialKind>;
70
+ kind: z.ZodEnum<typeof InferenceSourceKind>;
122
71
  baseUrl: z.ZodNullable<z.ZodString>;
123
72
  apiKey: z.ZodNullable<z.ZodString>;
124
73
  subscription: z.ZodNullable<z.ZodObject<{
@@ -142,7 +91,7 @@ export declare const credentialGrantSchema: z.ZodObject<{
142
91
  }, z.core.$strip>>;
143
92
  atOpen: z.ZodNullable<z.ZodObject<{
144
93
  vendor: z.ZodString;
145
- kind: z.ZodEnum<typeof InferenceCredentialKind>;
94
+ kind: z.ZodEnum<typeof InferenceSourceKind>;
146
95
  baseUrl: z.ZodNullable<z.ZodString>;
147
96
  apiKey: z.ZodNullable<z.ZodString>;
148
97
  subscription: z.ZodNullable<z.ZodObject<{
@@ -168,12 +117,18 @@ export interface RenewedMcpServerIface {
168
117
  }
169
118
  export interface CredentialRefreshResultIface extends CredentialGrantIface {
170
119
  mcpServers: RenewedMcpServerIface[];
171
- sandboxes: Record<string, SandboxTargetEndpointIface>;
120
+ compute: Partial<Record<Capability, SandboxEndpointIface>>;
172
121
  }
173
- export declare const sandboxTargetEndpointSchema: z.ZodObject<{
174
- target: z.ZodString;
122
+ export declare const sandboxEndpointSchema: z.ZodObject<{
123
+ sandboxId: z.ZodString;
175
124
  bindingId: z.ZodString;
176
- capabilities: z.ZodArray<z.ZodString>;
125
+ grant: z.ZodObject<{
126
+ files: z.ZodOptional<z.ZodEnum<typeof import("@finalai/agent-protocol").FilesAccess>>;
127
+ shell: z.ZodOptional<z.ZodEnum<typeof import("@finalai/agent-protocol").ShellAccess>>;
128
+ computerUse: z.ZodOptional<z.ZodEnum<typeof import("@finalai/agent-protocol").ScreenAccess>>;
129
+ browserUse: z.ZodOptional<z.ZodEnum<typeof import("@finalai/agent-protocol").ScreenAccess>>;
130
+ }, z.core.$strict>;
131
+ features: z.ZodArray<z.ZodString>;
177
132
  rpc: z.ZodNullable<z.ZodObject<{
178
133
  url: z.ZodString;
179
134
  token: z.ZodString;
@@ -202,7 +157,7 @@ export declare const credentialRefreshResultSchema: z.ZodObject<{
202
157
  }, z.core.$strip>>;
203
158
  atOpen: z.ZodNullable<z.ZodObject<{
204
159
  vendor: z.ZodString;
205
- kind: z.ZodEnum<typeof InferenceCredentialKind>;
160
+ kind: z.ZodEnum<typeof InferenceSourceKind>;
206
161
  baseUrl: z.ZodNullable<z.ZodString>;
207
162
  apiKey: z.ZodNullable<z.ZodString>;
208
163
  subscription: z.ZodNullable<z.ZodObject<{
@@ -225,10 +180,16 @@ export declare const credentialRefreshResultSchema: z.ZodObject<{
225
180
  value: z.ZodString;
226
181
  }, z.core.$strip>>;
227
182
  }, z.core.$strip>>>;
228
- sandboxes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
229
- target: z.ZodString;
183
+ compute: z.ZodDefault<z.ZodRecord<z.ZodEnum<typeof Capability> & z.core.$partial, z.ZodObject<{
184
+ sandboxId: z.ZodString;
230
185
  bindingId: z.ZodString;
231
- capabilities: z.ZodArray<z.ZodString>;
186
+ grant: z.ZodObject<{
187
+ files: z.ZodOptional<z.ZodEnum<typeof import("@finalai/agent-protocol").FilesAccess>>;
188
+ shell: z.ZodOptional<z.ZodEnum<typeof import("@finalai/agent-protocol").ShellAccess>>;
189
+ computerUse: z.ZodOptional<z.ZodEnum<typeof import("@finalai/agent-protocol").ScreenAccess>>;
190
+ browserUse: z.ZodOptional<z.ZodEnum<typeof import("@finalai/agent-protocol").ScreenAccess>>;
191
+ }, z.core.$strict>;
192
+ features: z.ZodArray<z.ZodString>;
232
193
  rpc: z.ZodNullable<z.ZodObject<{
233
194
  url: z.ZodString;
234
195
  token: z.ZodString;
@@ -253,10 +214,11 @@ export interface TraceContextIface {
253
214
  traceparent: string | null;
254
215
  tracestate: string | null;
255
216
  }
256
- export interface SandboxTargetEndpointIface {
257
- target: string;
217
+ export interface SandboxEndpointIface {
218
+ sandboxId: string;
258
219
  bindingId: string;
259
- capabilities: string[];
220
+ grant: SandboxGrantIface;
221
+ features: string[];
260
222
  rpc: {
261
223
  url: string;
262
224
  token: string;
@@ -269,11 +231,11 @@ export interface SandboxTargetEndpointIface {
269
231
  } | null;
270
232
  }
271
233
  export interface HarnessSessionContextIface {
272
- bindings?: HostedBindingsIface;
273
234
  sessionId: string;
274
235
  organizationId: string;
275
- definitionId: string;
276
- revisionId: string;
236
+ projectId: string;
237
+ agent: string;
238
+ definitionId: string | null;
277
239
  sessionServiceUrl: string;
278
240
  sessionServiceRegion?: string | null;
279
241
  }
@@ -315,11 +277,10 @@ export interface OpenHarnessSessionArgsIface {
315
277
  acpSessionId: string;
316
278
  };
317
279
  observer?: HarnessObserverIface;
318
- config: JsonValue;
319
- manifest: ResolvedAgentManifestIface;
280
+ document: AgentDocumentIface;
281
+ settings: ResolvedHarnessSettingsIface;
320
282
  mcpServers: McpServer[];
321
- baseTools: Partial<Record<BaseCapability, SandboxTargetEndpointIface>>;
322
- sandboxes: Record<string, SandboxTargetEndpointIface>;
283
+ compute: Partial<Record<Capability, SandboxEndpointIface>>;
323
284
  credentials: CredentialGrantIface;
324
285
  secrets: SecretReaderIface;
325
286
  trace: TraceContextIface;
@@ -328,6 +289,33 @@ export interface ResumeHarnessSessionArgsIface extends OpenHarnessSessionArgsIfa
328
289
  ref: HarnessSessionRefIface;
329
290
  lastSeq: number;
330
291
  }
292
+ export declare const sandboxProcessStartSchema: z.ZodObject<{
293
+ runtime: z.ZodLiteral<RuntimeKind.Process>;
294
+ command: z.ZodString;
295
+ args: z.ZodDefault<z.ZodArray<z.ZodString>>;
296
+ env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
297
+ cwd: z.ZodOptional<z.ZodString>;
298
+ }, z.core.$strict>;
299
+ export declare const sandboxWorkerStartSchema: z.ZodObject<{
300
+ runtime: z.ZodLiteral<RuntimeKind.Worker>;
301
+ program: z.ZodString;
302
+ env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
303
+ input: z.ZodDefault<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
304
+ }, z.core.$strict>;
305
+ export declare const sandboxStartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
306
+ runtime: z.ZodLiteral<RuntimeKind.Process>;
307
+ command: z.ZodString;
308
+ args: z.ZodDefault<z.ZodArray<z.ZodString>>;
309
+ env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
310
+ cwd: z.ZodOptional<z.ZodString>;
311
+ }, z.core.$strict>, z.ZodObject<{
312
+ runtime: z.ZodLiteral<RuntimeKind.Worker>;
313
+ program: z.ZodString;
314
+ env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
315
+ input: z.ZodDefault<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
316
+ }, z.core.$strict>], "runtime">;
317
+ export type SandboxStartIface = z.output<typeof sandboxStartSchema>;
318
+ export type SandboxStartInputIface = z.input<typeof sandboxStartSchema>;
331
319
  export interface HarnessClientTlsIface {
332
320
  cert: string;
333
321
  key: string;
@@ -352,6 +340,11 @@ export type HarnessEndpointIface = {
352
340
  transport: AcpTransport.Relay;
353
341
  channel: string;
354
342
  token: string;
343
+ } | {
344
+ ref: HarnessSessionRefIface;
345
+ transport: AcpTransport.Sandbox;
346
+ sandboxId: string;
347
+ start: SandboxStartIface;
355
348
  } | {
356
349
  ref: HarnessSessionRefIface;
357
350
  transport: AcpTransport.Stdio;
@@ -364,37 +357,19 @@ export interface HarnessHealthIface {
364
357
  detail?: string;
365
358
  checkedAt: string;
366
359
  }
367
- export interface DescribeHarnessArgsIface {
368
- config: JsonValue;
360
+ export interface HarnessCallContextIface {
361
+ settings: ResolvedHarnessSettingsIface;
369
362
  secrets: SecretReaderIface;
370
363
  }
371
364
  export interface HarnessIface {
372
- describe(binding?: DescribeHarnessArgsIface): Promise<HarnessDescriptionIface>;
365
+ definition: HarnessDefinitionIface;
373
366
  open(args: OpenHarnessSessionArgsIface): Promise<HarnessEndpointIface>;
374
367
  resume(args: ResumeHarnessSessionArgsIface): Promise<HarnessEndpointIface>;
375
368
  park(ref: HarnessSessionRefIface): Promise<void>;
376
369
  close(ref: HarnessSessionRefIface, opts?: CloseHarnessSessionOptsIface): Promise<void>;
377
- health(ref: HarnessSessionRefIface, context?: DescribeHarnessArgsIface): Promise<HarnessHealthIface>;
370
+ health(ref: HarnessSessionRefIface, context?: HarnessCallContextIface): Promise<HarnessHealthIface>;
378
371
  }
379
372
  export interface CloseHarnessSessionOptsIface {
380
373
  force?: boolean;
381
- context?: DescribeHarnessArgsIface;
382
- }
383
- export interface HarnessModuleIface<Config> {
384
- ref: ProviderRef;
385
- harness: HarnessIface;
386
- binding: (config: Config) => {
387
- harness: ProviderRef;
388
- config: JsonValue;
389
- };
390
- }
391
- export interface DefinedHarnessBindingIface {
392
- harness: ProviderRef;
393
- config: JsonValue;
394
- definedHarness: true;
395
- }
396
- export interface DefinedHarnessIface<Config> extends HarnessIface {
397
- (config: Config): DefinedHarnessBindingIface;
374
+ context?: HarnessCallContextIface;
398
375
  }
399
- export declare const defineHarness: <Config extends JsonValue = JsonValue>(implementation: HarnessIface) => DefinedHarnessIface<Config>;
400
- export declare const describeConfigSchema: (description: HarnessDescriptionIface) => JsonSchema;
@@ -1,16 +1,25 @@
1
+ import { Capability } from "@finalai/agent-protocol";
2
+ import {
3
+ InferenceSourceKind
4
+ } from "@finalai/agent-protocol/agent-platform";
5
+ import { RuntimeKind } from "@finalai/agent-protocol";
1
6
  import * as z from "zod";
2
7
  import { CredentialRoute, routeGrantSchema } from "./credential-routes.mjs";
3
- import { CredentialDelivery, InferenceCredentialKind } from "./credentials.mjs";
4
- import { jsonObjectSchema, jsonSchemaSchema } from "./json.mjs";
5
- import { BaseCapability, InstructionRole } from "./manifest.mjs";
6
- import { bundleRef, providerRefSchema } from "./provider-ref.mjs";
7
- import { referencedSharedSchemas, SCHEMA_IDS } from "./schemas.mjs";
8
- const PENDING_BUNDLE_EXPORT = "<pending>";
8
+ import { jsonValueSchema } from "./json.mjs";
9
+ import { sandboxGrantSchema } from "./sandbox/grant.mjs";
10
+ import {
11
+ HarnessComputeStatus,
12
+ harnessEnvironmentSchema,
13
+ harnessSettingsSchema,
14
+ harnessUrlEnvironmentSchema,
15
+ isUrlEnvironment
16
+ } from "@finalai/agent-protocol/agent-platform";
9
17
  var AcpTransport = /* @__PURE__ */ ((AcpTransport2) => {
10
18
  AcpTransport2["Relay"] = "relay";
11
19
  AcpTransport2["Ws"] = "ws";
12
20
  AcpTransport2["Http"] = "http";
13
21
  AcpTransport2["Stdio"] = "stdio";
22
+ AcpTransport2["Sandbox"] = "sandbox";
14
23
  return AcpTransport2;
15
24
  })(AcpTransport || {});
16
25
  var McpTransportKind = /* @__PURE__ */ ((McpTransportKind2) => {
@@ -19,27 +28,16 @@ var McpTransportKind = /* @__PURE__ */ ((McpTransportKind2) => {
19
28
  McpTransportKind2["Stdio"] = "stdio";
20
29
  return McpTransportKind2;
21
30
  })(McpTransportKind || {});
22
- var BaseToolProvision = /* @__PURE__ */ ((BaseToolProvision2) => {
23
- BaseToolProvision2["Bound"] = "bound";
24
- BaseToolProvision2["HostDisableable"] = "host-disableable";
25
- BaseToolProvision2["HostFixed"] = "host-fixed";
26
- return BaseToolProvision2;
27
- })(BaseToolProvision || {});
28
31
  var SandboxWire = /* @__PURE__ */ ((SandboxWire2) => {
29
32
  SandboxWire2["HandleRpc"] = "handle-rpc";
30
33
  SandboxWire2["Mcp"] = "mcp";
31
34
  return SandboxWire2;
32
35
  })(SandboxWire || {});
33
- var UserInstructionDelivery = /* @__PURE__ */ ((UserInstructionDelivery2) => {
34
- UserInstructionDelivery2["History"] = "history";
35
- UserInstructionDelivery2["System"] = "system";
36
- return UserInstructionDelivery2;
37
- })(UserInstructionDelivery || {});
38
- var HarnessTrustClass = /* @__PURE__ */ ((HarnessTrustClass2) => {
39
- HarnessTrustClass2["FirstParty"] = "first-party";
40
- HarnessTrustClass2["ThirdParty"] = "third-party";
41
- return HarnessTrustClass2;
42
- })(HarnessTrustClass || {});
36
+ var CredentialDelivery = /* @__PURE__ */ ((CredentialDelivery2) => {
37
+ CredentialDelivery2["PerRequest"] = "per-request";
38
+ CredentialDelivery2["AtOpen"] = "at-open";
39
+ return CredentialDelivery2;
40
+ })(CredentialDelivery || {});
43
41
  var PromptWhileRunning = /* @__PURE__ */ ((PromptWhileRunning2) => {
44
42
  PromptWhileRunning2["Inject"] = "inject";
45
43
  PromptWhileRunning2["Queue"] = "queue";
@@ -47,72 +45,9 @@ var PromptWhileRunning = /* @__PURE__ */ ((PromptWhileRunning2) => {
47
45
  })(PromptWhileRunning || {});
48
46
  const DEFAULT_PROMPT_WHILE_RUNNING = "queue" /* Queue */;
49
47
  const DEFAULT_SESSION_SURVIVES_DISCONNECT = false;
50
- const baseToolDeclarationSchema = z.object({
51
- provision: z.nativeEnum(BaseToolProvision),
52
- nativeTools: z.array(z.string())
53
- });
54
- const harnessDescriptionSchema = z.object({
55
- // Everything configurable about this harness (model, reasoning, credentials,
56
- // permission mode, instructions, skills, cwd, ...). JSON Schema so Build can
57
- // render it; may $ref the shared final://schemas/* fragments.
58
- configSchema: jsonSchemaSchema,
59
- // Absent: user fragments enter history. System-only programs declare their conversion.
60
- userInstructionDelivery: z.nativeEnum(UserInstructionDelivery).optional(),
61
- acp: z.object({
62
- transports: z.array(z.nativeEnum(AcpTransport)).min(1),
63
- mcp: z.array(z.nativeEnum(McpTransportKind))
64
- }),
65
- // A capability missing here is unavailable on this harness.
66
- baseTools: z.partialRecord(z.nativeEnum(BaseCapability), baseToolDeclarationSchema),
67
- consumes: z.array(z.nativeEnum(SandboxWire)),
68
- inference: z.object({
69
- vendors: z.array(z.string()),
70
- kinds: z.array(z.nativeEnum(InferenceCredentialKind)),
71
- delivery: z.nativeEnum(CredentialDelivery)
72
- }),
73
- // Absent: third-party.
74
- trust: z.nativeEnum(HarnessTrustClass).optional(),
75
- supports: z.object({
76
- observe: z.boolean(),
77
- resumeReplay: z.boolean(),
78
- fork: z.boolean(),
79
- // Renders _meta["final.ai"].author itself; otherwise the channel prepends
80
- // the author's name to the text.
81
- authorMeta: z.boolean(),
82
- // Explicit false: native toolPolicy cannot be enforced by this adapter's public surface.
83
- nativeToolPolicy: z.boolean().optional(),
84
- // Defers and searches MCP tools itself (a harness-native tool search): the
85
- // host lists every exposed tool, ignoring connections' `tools.load`, and
86
- // adds no search of its own. Absent: the host lists what `load` (or, without
87
- // it, HOSTING.md's defaults) leaves listed and serves search for the rest.
88
- deferredToolSearch: z.boolean().optional()
89
- }),
90
- promptWhileRunning: z.nativeEnum(PromptWhileRunning).default(DEFAULT_PROMPT_WHILE_RUNNING),
91
- // Keeps the session, its running work and its open requests across a dropped
92
- // connection, buffers updates for replay, and re-raises the open requests
93
- // with the same JSON-RPC ids on the next session/resume. False:
94
- // open turns end `harness_state_lost` after a reconnect.
95
- sessionSurvivesDisconnect: z.boolean().default(DEFAULT_SESSION_SURVIVES_DISCONNECT)
96
- });
97
- const deliveredHarnessConfig = (args) => {
98
- if (args.description.userInstructionDelivery !== "system" /* System */)
99
- return args.config;
100
- const config = jsonObjectSchema.safeParse(args.config);
101
- if (!config.success) return args.config;
102
- const fields = referencedSharedSchemas(args.description.configSchema);
103
- const field = Object.entries(fields).find(([, schema]) => schema === SCHEMA_IDS.instructions)?.[0] ?? "instructions";
104
- const instructions = config.data[field];
105
- if (!Array.isArray(instructions)) return args.config;
106
- return {
107
- ...config.data,
108
- [field]: instructions.map((value) => {
109
- const fragment = jsonObjectSchema.safeParse(value);
110
- return fragment.success && fragment.data["role"] === InstructionRole.User ? { ...fragment.data, role: InstructionRole.System } : value;
111
- })
112
- };
113
- };
114
48
  const harnessSessionRefSchema = z.object({
115
- harness: providerRefSchema,
49
+ // The harness's name, as harness settings name it.
50
+ harness: z.string().min(1),
116
51
  // Opaque to the session service; the harness's own id for the session.
117
52
  harnessSessionRef: z.string().min(1),
118
53
  // Bumped whenever the harness loses state; a mismatch on resume means the
@@ -126,7 +61,7 @@ import {
126
61
  } from "./credential-routes.mjs";
127
62
  const atOpenModelCredentialSchema = z.object({
128
63
  vendor: z.string(),
129
- kind: z.nativeEnum(InferenceCredentialKind),
64
+ kind: z.nativeEnum(InferenceSourceKind),
130
65
  baseUrl: z.string().min(1).nullable(),
131
66
  apiKey: z.string().min(1).nullable(),
132
67
  subscription: z.object({
@@ -152,10 +87,11 @@ const endpointTokenSchema = z.object({
152
87
  token: z.string(),
153
88
  expiresAt: z.string()
154
89
  });
155
- const sandboxTargetEndpointSchema = z.object({
156
- target: z.string().min(1),
90
+ const sandboxEndpointSchema = z.object({
91
+ sandboxId: z.string().min(1),
157
92
  bindingId: z.string().min(1),
158
- capabilities: z.array(z.string()),
93
+ grant: sandboxGrantSchema,
94
+ features: z.array(z.string()),
159
95
  rpc: endpointTokenSchema.nullable(),
160
96
  mcp: endpointTokenSchema.nullable()
161
97
  });
@@ -166,7 +102,7 @@ const renewedMcpServerSchema = z.object({
166
102
  });
167
103
  const credentialRefreshResultSchema = credentialGrantSchema.extend({
168
104
  mcpServers: z.array(renewedMcpServerSchema).default([]),
169
- sandboxes: z.record(z.string(), sandboxTargetEndpointSchema).default({})
105
+ compute: z.partialRecord(z.nativeEnum(Capability), sandboxEndpointSchema).default({})
170
106
  });
171
107
  const grantRefreshFor = (args) => {
172
108
  const grant = args.grants.find((candidate) => candidate.route === CredentialRoute.Model) ?? args.grants[0];
@@ -178,41 +114,50 @@ const grantRefreshFor = (args) => {
178
114
  expiresAt: grant.expiresAt
179
115
  };
180
116
  };
181
- const defineHarness = (implementation) => {
182
- const binding = (config) => ({
183
- harness: bundleRef(PENDING_BUNDLE_EXPORT),
184
- config,
185
- definedHarness: true
186
- });
187
- return Object.assign(binding, implementation);
188
- };
189
- const describeConfigSchema = (description) => description.configSchema;
117
+ const sandboxProcessStartSchema = z.strictObject({
118
+ runtime: z.literal(RuntimeKind.Process),
119
+ command: z.string().min(1),
120
+ args: z.array(z.string()).default([]),
121
+ env: z.record(z.string(), z.string()).default({}),
122
+ cwd: z.string().min(1).optional()
123
+ });
124
+ const sandboxWorkerStartSchema = z.strictObject({
125
+ runtime: z.literal(RuntimeKind.Worker),
126
+ program: z.string().min(1),
127
+ env: z.record(z.string(), z.string()).default({}),
128
+ // Handed to the program when it starts.
129
+ input: jsonValueSchema.default(null)
130
+ });
131
+ const sandboxStartSchema = z.discriminatedUnion("runtime", [
132
+ sandboxProcessStartSchema,
133
+ sandboxWorkerStartSchema
134
+ ]);
190
135
  export {
191
136
  AcpTransport,
192
- BaseToolProvision,
137
+ CredentialDelivery,
193
138
  CredentialRoute2 as CredentialRoute,
194
139
  DEFAULT_PROMPT_WHILE_RUNNING,
195
140
  DEFAULT_SESSION_SURVIVES_DISCONNECT,
196
- HarnessTrustClass,
141
+ HarnessComputeStatus,
197
142
  McpTransportKind,
198
- PENDING_BUNDLE_EXPORT,
199
143
  PromptWhileRunning,
200
144
  SandboxWire,
201
- UserInstructionDelivery,
202
145
  atOpenModelCredentialSchema,
203
- baseToolDeclarationSchema,
204
146
  credentialGrantRefreshSchema,
205
147
  credentialGrantSchema,
206
148
  credentialRefreshRequestSchema,
207
149
  credentialRefreshResultSchema,
208
- defineHarness,
209
- deliveredHarnessConfig,
210
- describeConfigSchema,
211
150
  grantRefreshFor,
212
- harnessDescriptionSchema,
151
+ harnessEnvironmentSchema,
213
152
  harnessSessionRefSchema,
153
+ harnessSettingsSchema,
154
+ harnessUrlEnvironmentSchema,
155
+ isUrlEnvironment,
214
156
  renewedMcpServerSchema,
215
157
  routeGrantSchema2 as routeGrantSchema,
216
- sandboxTargetEndpointSchema
158
+ sandboxEndpointSchema,
159
+ sandboxProcessStartSchema,
160
+ sandboxStartSchema,
161
+ sandboxWorkerStartSchema
217
162
  };
218
163
  //# sourceMappingURL=harness.mjs.map