@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
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../../src/tool-descriptor.ts"],
4
+ "sourcesContent": ["import * as z from 'zod';\nimport { jsonSchemaSchema } from \"./json.mjs\";\n\n// An MCP tool as a server lists it: what `tools/list` answers and what a\n// sandbox's hosted servers report in their catalogs. Tolerant of hints this\n// package does not know, since servers send them.\nexport const toolDescriptorSchema = z.object({\n name: z.string().min(1),\n description: z.string(),\n inputSchema: jsonSchemaSchema,\n outputSchema: jsonSchemaSchema.optional(),\n annotations: z\n .object({\n title: z.string().optional(),\n readOnlyHint: z.boolean().optional(),\n destructiveHint: z.boolean().optional(),\n idempotentHint: z.boolean().optional(),\n openWorldHint: z.boolean().optional(),\n })\n .optional(),\n});\n\nexport type ToolDescriptorIface = z.infer<typeof toolDescriptorSchema>;\nexport type ToolAnnotationsIface = NonNullable<ToolDescriptorIface['annotations']>;\n"],
5
+ "mappings": "AAAA,YAAY,OAAO;AACnB,SAAS,wBAAwB;AAK1B,MAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EACtB,aAAa,EAAE,OAAO;AAAA,EACtB,aAAa;AAAA,EACb,cAAc,iBAAiB,SAAS;AAAA,EACxC,aAAa,EACV,OAAO;AAAA,IACN,OAAO,EAAE,OAAO,EAAE,SAAS;AAAA,IAC3B,cAAc,EAAE,QAAQ,EAAE,SAAS;AAAA,IACnC,iBAAiB,EAAE,QAAQ,EAAE,SAAS;AAAA,IACtC,gBAAgB,EAAE,QAAQ,EAAE,SAAS;AAAA,IACrC,eAAe,EAAE,QAAQ,EAAE,SAAS;AAAA,EACtC,CAAC,EACA,SAAS;AACd,CAAC;",
6
+ "names": []
7
+ }
@@ -1,11 +1,11 @@
1
- import { ToolApproval, type HttpMcpServerBindingIface } from "./manifest.mjs";
1
+ import * as z from 'zod';
2
+ import { ToolApprovalMode, type integrationToolPolicySchema } from "./document.mjs";
2
3
  export declare const TOOL_PATTERN_WILDCARD = "*";
3
4
  export declare const isToolPattern: (key: string) => boolean;
4
5
  export declare const toolPatternMatches: (pattern: string, name: string) => boolean;
5
- export declare const resolveToolApprovalKey: (approvals: Readonly<Record<string, ToolApproval>>, name: string) => string | undefined;
6
+ export declare const resolveToolApprovalKey: (approvals: Readonly<Record<string, ToolApprovalMode>>, name: string) => string | undefined;
6
7
  export declare const isToolDenied: (deny: readonly string[] | undefined, name: string) => boolean;
7
- type ConnectionPolicyIface = Pick<HttpMcpServerBindingIface, 'approvals' | 'deny'>;
8
- export declare const isToolExposed: (binding: ConnectionPolicyIface, name: string) => boolean;
9
- export declare const isToolLoaded: (binding: Pick<HttpMcpServerBindingIface, "load">, name: string) => boolean;
10
- export declare const toolApprovalOf: (binding: ConnectionPolicyIface, name: string) => ToolApproval;
11
- export {};
8
+ export type IntegrationToolPolicyIface = z.input<typeof integrationToolPolicySchema>;
9
+ export declare const isToolAllowedByName: (policy: IntegrationToolPolicyIface | undefined, name: string) => boolean;
10
+ export declare const isToolLoaded: (policy: IntegrationToolPolicyIface | undefined, name: string) => boolean;
11
+ export declare const toolApprovalOf: (approvals: Readonly<Record<string, ToolApprovalMode>> | undefined, name: string) => ToolApprovalMode;
@@ -1,4 +1,5 @@
1
- import { ToolApproval } from "./manifest.mjs";
1
+ import * as z from "zod";
2
+ import { ToolApprovalMode } from "./document.mjs";
2
3
  const TOOL_PATTERN_WILDCARD = "*";
3
4
  const isToolPattern = (key) => key.includes(TOOL_PATTERN_WILDCARD);
4
5
  const toolPatternMatches = (pattern, name) => {
@@ -39,23 +40,23 @@ const resolveToolApprovalKey = (approvals, name) => {
39
40
  const specificity = literalLength(key) - literalLength(best);
40
41
  if (specificity > 0) best = key;
41
42
  if (specificity !== 0) continue;
42
- const stricter = approvals[key] === ToolApproval.Ask && approvals[best] !== ToolApproval.Ask;
43
- const looser = approvals[key] !== ToolApproval.Ask && approvals[best] === ToolApproval.Ask;
43
+ const stricter = approvals[key] === ToolApprovalMode.Ask && approvals[best] !== ToolApprovalMode.Ask;
44
+ const looser = approvals[key] !== ToolApprovalMode.Ask && approvals[best] === ToolApprovalMode.Ask;
44
45
  if (stricter || !looser && key < best) best = key;
45
46
  }
46
47
  return best;
47
48
  };
48
49
  const isToolDenied = (deny, name) => deny?.some((pattern) => toolPatternMatches(pattern, name)) === true;
49
- const isToolExposed = (binding, name) => !isToolDenied(binding.deny, name) && (binding.approvals == null || resolveToolApprovalKey(binding.approvals, name) != null);
50
- const isToolLoaded = (binding, name) => binding.load == null || binding.load.some((pattern) => toolPatternMatches(pattern, name));
51
- const toolApprovalOf = (binding, name) => {
52
- const key = binding.approvals == null ? void 0 : resolveToolApprovalKey(binding.approvals, name);
53
- return key == null ? ToolApproval.Allow : binding.approvals?.[key] ?? ToolApproval.Allow;
50
+ const isToolAllowedByName = (policy, name) => !isToolDenied(policy?.deny, name) && (policy?.allow == null || policy.allow.some((pattern) => toolPatternMatches(pattern, name)));
51
+ const isToolLoaded = (policy, name) => policy?.load == null || policy.load.some((pattern) => toolPatternMatches(pattern, name));
52
+ const toolApprovalOf = (approvals, name) => {
53
+ const key = approvals == null ? void 0 : resolveToolApprovalKey(approvals, name);
54
+ return key == null ? ToolApprovalMode.Allow : approvals?.[key] ?? ToolApprovalMode.Allow;
54
55
  };
55
56
  export {
56
57
  TOOL_PATTERN_WILDCARD,
58
+ isToolAllowedByName,
57
59
  isToolDenied,
58
- isToolExposed,
59
60
  isToolLoaded,
60
61
  isToolPattern,
61
62
  resolveToolApprovalKey,
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../src/tool-patterns.ts"],
4
- "sourcesContent": ["import { ToolApproval, type HttpMcpServerBindingIface } from \"./manifest.mjs\";\n\n// Tool-name patterns for an HTTP MCP connection's `approvals`, `deny` and\n// `inputApprovals` keys. `*` matches any run of characters, including none;\n// every other character matches itself. MCP tool names are letters, digits,\n// `_`, `-` and `.`, so `*` never collides with a real name. Hosts resolve\n// connection policy through these helpers so every host applies one rule.\n\nexport const TOOL_PATTERN_WILDCARD = '*';\n\nexport const isToolPattern = (key: string): boolean => key.includes(TOOL_PATTERN_WILDCARD);\n\n// Wildcard matching with a single backtrack point: linear in practice for `*` globs.\nexport const toolPatternMatches = (pattern: string, name: string): boolean => {\n let patternIndex = 0;\n let nameIndex = 0;\n let starIndex = -1;\n let resumeIndex = 0;\n while (nameIndex < name.length) {\n const char = pattern[patternIndex];\n if (char === TOOL_PATTERN_WILDCARD) {\n starIndex = patternIndex;\n resumeIndex = nameIndex;\n patternIndex += 1;\n } else if (char != null && char === name[nameIndex]) {\n patternIndex += 1;\n nameIndex += 1;\n } else if (starIndex !== -1) {\n patternIndex = starIndex + 1;\n resumeIndex += 1;\n nameIndex = resumeIndex;\n } else {\n return false;\n }\n }\n while (pattern[patternIndex] === TOOL_PATTERN_WILDCARD) patternIndex += 1;\n return patternIndex === pattern.length;\n};\n\nconst literalLength = (pattern: string): number =>\n pattern.length - pattern.split(TOOL_PATTERN_WILDCARD).length + 1;\n\n// The approvals key that governs `name`: the exact key, else the matching\n// pattern with the most literal characters. Equally specific patterns resolve\n// to the stricter policy (Ask), then lexically, so the result never depends on\n// key order. Undefined when no key matches.\nexport const resolveToolApprovalKey = (\n approvals: Readonly<Record<string, ToolApproval>>,\n name: string,\n): string | undefined => {\n if (Object.hasOwn(approvals, name)) return name;\n let best: string | undefined;\n for (const key of Object.keys(approvals)) {\n if (!isToolPattern(key) || !toolPatternMatches(key, name)) continue;\n if (best == null) {\n best = key;\n continue;\n }\n const specificity = literalLength(key) - literalLength(best);\n if (specificity > 0) best = key;\n if (specificity !== 0) continue;\n const stricter = approvals[key] === ToolApproval.Ask && approvals[best] !== ToolApproval.Ask;\n const looser = approvals[key] !== ToolApproval.Ask && approvals[best] === ToolApproval.Ask;\n if (stricter || (!looser && key < best)) best = key;\n }\n return best;\n};\n\nexport const isToolDenied = (deny: readonly string[] | undefined, name: string): boolean =>\n deny?.some((pattern) => toolPatternMatches(pattern, name)) === true;\n\ntype ConnectionPolicyIface = Pick<HttpMcpServerBindingIface, 'approvals' | 'deny'>;\n\n// Whether the connection exposes `name` at all. Null approvals expose every\n// listed tool; `deny` wins over any approvals key.\nexport const isToolExposed = (binding: ConnectionPolicyIface, name: string): boolean =>\n !isToolDenied(binding.deny, name) &&\n (binding.approvals == null || resolveToolApprovalKey(binding.approvals, name) != null);\n\n// Whether the harness lists an exposed tool up front (`load` names or\n// patterns); hosts keep the others reachable through search. Callers check\n// exposure first.\nexport const isToolLoaded = (\n binding: Pick<HttpMcpServerBindingIface, 'load'>,\n name: string,\n): boolean =>\n binding.load == null || binding.load.some((pattern) => toolPatternMatches(pattern, name));\n\n// The connection's approval for an exposed tool; Allow when nothing matches.\nexport const toolApprovalOf = (binding: ConnectionPolicyIface, name: string): ToolApproval => {\n const key =\n binding.approvals == null ? undefined : resolveToolApprovalKey(binding.approvals, name);\n return key == null ? ToolApproval.Allow : (binding.approvals?.[key] ?? ToolApproval.Allow);\n};\n"],
5
- "mappings": "AAAA,SAAS,oBAAoD;AAQtD,MAAM,wBAAwB;AAE9B,MAAM,gBAAgB,CAAC,QAAyB,IAAI,SAAS,qBAAqB;AAGlF,MAAM,qBAAqB,CAAC,SAAiB,SAA0B;AAC5E,MAAI,eAAe;AACnB,MAAI,YAAY;AAChB,MAAI,YAAY;AAChB,MAAI,cAAc;AAClB,SAAO,YAAY,KAAK,QAAQ;AAC9B,UAAM,OAAO,QAAQ,YAAY;AACjC,QAAI,SAAS,uBAAuB;AAClC,kBAAY;AACZ,oBAAc;AACd,sBAAgB;AAAA,IAClB,WAAW,QAAQ,QAAQ,SAAS,KAAK,SAAS,GAAG;AACnD,sBAAgB;AAChB,mBAAa;AAAA,IACf,WAAW,cAAc,IAAI;AAC3B,qBAAe,YAAY;AAC3B,qBAAe;AACf,kBAAY;AAAA,IACd,OAAO;AACL,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO,QAAQ,YAAY,MAAM,sBAAuB,iBAAgB;AACxE,SAAO,iBAAiB,QAAQ;AAClC;AAEA,MAAM,gBAAgB,CAAC,YACrB,QAAQ,SAAS,QAAQ,MAAM,qBAAqB,EAAE,SAAS;AAM1D,MAAM,yBAAyB,CACpC,WACA,SACuB;AACvB,MAAI,OAAO,OAAO,WAAW,IAAI,EAAG,QAAO;AAC3C,MAAI;AACJ,aAAW,OAAO,OAAO,KAAK,SAAS,GAAG;AACxC,QAAI,CAAC,cAAc,GAAG,KAAK,CAAC,mBAAmB,KAAK,IAAI,EAAG;AAC3D,QAAI,QAAQ,MAAM;AAChB,aAAO;AACP;AAAA,IACF;AACA,UAAM,cAAc,cAAc,GAAG,IAAI,cAAc,IAAI;AAC3D,QAAI,cAAc,EAAG,QAAO;AAC5B,QAAI,gBAAgB,EAAG;AACvB,UAAM,WAAW,UAAU,GAAG,MAAM,aAAa,OAAO,UAAU,IAAI,MAAM,aAAa;AACzF,UAAM,SAAS,UAAU,GAAG,MAAM,aAAa,OAAO,UAAU,IAAI,MAAM,aAAa;AACvF,QAAI,YAAa,CAAC,UAAU,MAAM,KAAO,QAAO;AAAA,EAClD;AACA,SAAO;AACT;AAEO,MAAM,eAAe,CAAC,MAAqC,SAChE,MAAM,KAAK,CAAC,YAAY,mBAAmB,SAAS,IAAI,CAAC,MAAM;AAM1D,MAAM,gBAAgB,CAAC,SAAgC,SAC5D,CAAC,aAAa,QAAQ,MAAM,IAAI,MAC/B,QAAQ,aAAa,QAAQ,uBAAuB,QAAQ,WAAW,IAAI,KAAK;AAK5E,MAAM,eAAe,CAC1B,SACA,SAEA,QAAQ,QAAQ,QAAQ,QAAQ,KAAK,KAAK,CAAC,YAAY,mBAAmB,SAAS,IAAI,CAAC;AAGnF,MAAM,iBAAiB,CAAC,SAAgC,SAA+B;AAC5F,QAAM,MACJ,QAAQ,aAAa,OAAO,SAAY,uBAAuB,QAAQ,WAAW,IAAI;AACxF,SAAO,OAAO,OAAO,aAAa,QAAS,QAAQ,YAAY,GAAG,KAAK,aAAa;AACtF;",
4
+ "sourcesContent": ["import * as z from 'zod';\nimport { ToolApprovalMode, type integrationToolPolicySchema } from \"./document.mjs\";\n\n// Tool-name patterns for an integration slot's `tools.allow`, `tools.deny`,\n// `tools.load` and `approvals` keys. `*` matches any run of characters, including none;\n// every other character matches itself. MCP tool names are letters, digits,\n// `_`, `-` and `.`, so `*` never collides with a real name. Hosts resolve\n// integration policy through these helpers so every host applies one rule.\n\nexport const TOOL_PATTERN_WILDCARD = '*';\n\nexport const isToolPattern = (key: string): boolean => key.includes(TOOL_PATTERN_WILDCARD);\n\n// Wildcard matching with a single backtrack point: linear in practice for `*` globs.\nexport const toolPatternMatches = (pattern: string, name: string): boolean => {\n let patternIndex = 0;\n let nameIndex = 0;\n let starIndex = -1;\n let resumeIndex = 0;\n while (nameIndex < name.length) {\n const char = pattern[patternIndex];\n if (char === TOOL_PATTERN_WILDCARD) {\n starIndex = patternIndex;\n resumeIndex = nameIndex;\n patternIndex += 1;\n } else if (char != null && char === name[nameIndex]) {\n patternIndex += 1;\n nameIndex += 1;\n } else if (starIndex !== -1) {\n patternIndex = starIndex + 1;\n resumeIndex += 1;\n nameIndex = resumeIndex;\n } else {\n return false;\n }\n }\n while (pattern[patternIndex] === TOOL_PATTERN_WILDCARD) patternIndex += 1;\n return patternIndex === pattern.length;\n};\n\nconst literalLength = (pattern: string): number =>\n pattern.length - pattern.split(TOOL_PATTERN_WILDCARD).length + 1;\n\n// The approvals key that governs `name`: the exact key, else the matching\n// pattern with the most literal characters. Equally specific patterns resolve\n// to the stricter policy (Ask), then lexically, so the result never depends on\n// key order. Undefined when no key matches.\nexport const resolveToolApprovalKey = (\n approvals: Readonly<Record<string, ToolApprovalMode>>,\n name: string,\n): string | undefined => {\n if (Object.hasOwn(approvals, name)) return name;\n let best: string | undefined;\n for (const key of Object.keys(approvals)) {\n if (!isToolPattern(key) || !toolPatternMatches(key, name)) continue;\n if (best == null) {\n best = key;\n continue;\n }\n const specificity = literalLength(key) - literalLength(best);\n if (specificity > 0) best = key;\n if (specificity !== 0) continue;\n const stricter =\n approvals[key] === ToolApprovalMode.Ask && approvals[best] !== ToolApprovalMode.Ask;\n const looser =\n approvals[key] !== ToolApprovalMode.Ask && approvals[best] === ToolApprovalMode.Ask;\n if (stricter || (!looser && key < best)) best = key;\n }\n return best;\n};\n\nexport const isToolDenied = (deny: readonly string[] | undefined, name: string): boolean =>\n deny?.some((pattern) => toolPatternMatches(pattern, name)) === true;\n\nexport type IntegrationToolPolicyIface = z.input<typeof integrationToolPolicySchema>;\n\n// Whether the slot's policy lets `name` through by name. Absent `allow` lets\n// every listed tool through; `deny` wins over `allow`. Annotation selectors\n// (./tool-annotations.ts) widen and narrow this.\nexport const isToolAllowedByName = (\n policy: IntegrationToolPolicyIface | undefined,\n name: string,\n): boolean =>\n !isToolDenied(policy?.deny, name) &&\n (policy?.allow == null || policy.allow.some((pattern) => toolPatternMatches(pattern, name)));\n\n// Whether the harness lists an exposed tool up front (`load` names or\n// patterns); hosts keep the others reachable through search. Callers check\n// exposure first.\nexport const isToolLoaded = (\n policy: IntegrationToolPolicyIface | undefined,\n name: string,\n): boolean =>\n policy?.load == null || policy.load.some((pattern) => toolPatternMatches(pattern, name));\n\n// The slot's approval for an exposed tool; Allow when nothing matches.\nexport const toolApprovalOf = (\n approvals: Readonly<Record<string, ToolApprovalMode>> | undefined,\n name: string,\n): ToolApprovalMode => {\n const key = approvals == null ? undefined : resolveToolApprovalKey(approvals, name);\n return key == null ? ToolApprovalMode.Allow : (approvals?.[key] ?? ToolApprovalMode.Allow);\n};\n"],
5
+ "mappings": "AAAA,YAAY,OAAO;AACnB,SAAS,wBAA0D;AAQ5D,MAAM,wBAAwB;AAE9B,MAAM,gBAAgB,CAAC,QAAyB,IAAI,SAAS,qBAAqB;AAGlF,MAAM,qBAAqB,CAAC,SAAiB,SAA0B;AAC5E,MAAI,eAAe;AACnB,MAAI,YAAY;AAChB,MAAI,YAAY;AAChB,MAAI,cAAc;AAClB,SAAO,YAAY,KAAK,QAAQ;AAC9B,UAAM,OAAO,QAAQ,YAAY;AACjC,QAAI,SAAS,uBAAuB;AAClC,kBAAY;AACZ,oBAAc;AACd,sBAAgB;AAAA,IAClB,WAAW,QAAQ,QAAQ,SAAS,KAAK,SAAS,GAAG;AACnD,sBAAgB;AAChB,mBAAa;AAAA,IACf,WAAW,cAAc,IAAI;AAC3B,qBAAe,YAAY;AAC3B,qBAAe;AACf,kBAAY;AAAA,IACd,OAAO;AACL,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO,QAAQ,YAAY,MAAM,sBAAuB,iBAAgB;AACxE,SAAO,iBAAiB,QAAQ;AAClC;AAEA,MAAM,gBAAgB,CAAC,YACrB,QAAQ,SAAS,QAAQ,MAAM,qBAAqB,EAAE,SAAS;AAM1D,MAAM,yBAAyB,CACpC,WACA,SACuB;AACvB,MAAI,OAAO,OAAO,WAAW,IAAI,EAAG,QAAO;AAC3C,MAAI;AACJ,aAAW,OAAO,OAAO,KAAK,SAAS,GAAG;AACxC,QAAI,CAAC,cAAc,GAAG,KAAK,CAAC,mBAAmB,KAAK,IAAI,EAAG;AAC3D,QAAI,QAAQ,MAAM;AAChB,aAAO;AACP;AAAA,IACF;AACA,UAAM,cAAc,cAAc,GAAG,IAAI,cAAc,IAAI;AAC3D,QAAI,cAAc,EAAG,QAAO;AAC5B,QAAI,gBAAgB,EAAG;AACvB,UAAM,WACJ,UAAU,GAAG,MAAM,iBAAiB,OAAO,UAAU,IAAI,MAAM,iBAAiB;AAClF,UAAM,SACJ,UAAU,GAAG,MAAM,iBAAiB,OAAO,UAAU,IAAI,MAAM,iBAAiB;AAClF,QAAI,YAAa,CAAC,UAAU,MAAM,KAAO,QAAO;AAAA,EAClD;AACA,SAAO;AACT;AAEO,MAAM,eAAe,CAAC,MAAqC,SAChE,MAAM,KAAK,CAAC,YAAY,mBAAmB,SAAS,IAAI,CAAC,MAAM;AAO1D,MAAM,sBAAsB,CACjC,QACA,SAEA,CAAC,aAAa,QAAQ,MAAM,IAAI,MAC/B,QAAQ,SAAS,QAAQ,OAAO,MAAM,KAAK,CAAC,YAAY,mBAAmB,SAAS,IAAI,CAAC;AAKrF,MAAM,eAAe,CAC1B,QACA,SAEA,QAAQ,QAAQ,QAAQ,OAAO,KAAK,KAAK,CAAC,YAAY,mBAAmB,SAAS,IAAI,CAAC;AAGlF,MAAM,iBAAiB,CAC5B,WACA,SACqB;AACrB,QAAM,MAAM,aAAa,OAAO,SAAY,uBAAuB,WAAW,IAAI;AAClF,SAAO,OAAO,OAAO,iBAAiB,QAAS,YAAY,GAAG,KAAK,iBAAiB;AACtF;",
6
6
  "names": []
7
7
  }
package/package.json CHANGED
@@ -1,16 +1,15 @@
1
1
  {
2
2
  "name": "@finalai/agent-provider",
3
- "version": "0.9.0",
3
+ "version": "0.11.0",
4
4
  "private": false,
5
- "description": "Provider contracts for the agent stack: harnesses, sandboxes (handle, wire, MCP projection), channels, credential policies, and the conformance kit.",
5
+ "description": "Provider contracts for the agent stack: the agent document, requirements and inference, harnesses, sandboxes (handle, wire, grants, setups, MCP projection), the code host, channels, and the conformance kit.",
6
6
  "license": "Apache-2.0",
7
7
  "files": [
8
8
  "dist",
9
9
  "README.md",
10
10
  "LICENSE",
11
11
  "NOTICE",
12
- "HOSTING.md",
13
- "THIRD_PARTY_NOTICES.md"
12
+ "HOSTING.md"
14
13
  ],
15
14
  "type": "module",
16
15
  "sideEffects": false,
@@ -25,6 +24,26 @@
25
24
  "import": "./dist/modules/harness.mjs",
26
25
  "default": "./dist/modules/harness.mjs"
27
26
  },
27
+ "./harness-definition": {
28
+ "types": "./dist/modules/harness-definition.d.mts",
29
+ "import": "./dist/modules/harness-definition.mjs",
30
+ "default": "./dist/modules/harness-definition.mjs"
31
+ },
32
+ "./harness-configuration": {
33
+ "types": "./dist/modules/harness-configuration.d.mts",
34
+ "import": "./dist/modules/harness-configuration.mjs",
35
+ "default": "./dist/modules/harness-configuration.mjs"
36
+ },
37
+ "./harness-start": {
38
+ "types": "./dist/modules/harness-start.d.mts",
39
+ "import": "./dist/modules/harness-start.mjs",
40
+ "default": "./dist/modules/harness-start.mjs"
41
+ },
42
+ "./harness-provider": {
43
+ "types": "./dist/modules/harness-provider.d.mts",
44
+ "import": "./dist/modules/harness-provider.mjs",
45
+ "default": "./dist/modules/harness-provider.mjs"
46
+ },
28
47
  "./credential-routes": {
29
48
  "types": "./dist/modules/credential-routes.d.mts",
30
49
  "import": "./dist/modules/credential-routes.mjs",
@@ -35,11 +54,6 @@
35
54
  "import": "./dist/modules/channel.mjs",
36
55
  "default": "./dist/modules/channel.mjs"
37
56
  },
38
- "./credentials": {
39
- "types": "./dist/modules/credentials.d.mts",
40
- "import": "./dist/modules/credentials.mjs",
41
- "default": "./dist/modules/credentials.mjs"
42
- },
43
57
  "./schemas": {
44
58
  "types": "./dist/modules/schemas.d.mts",
45
59
  "import": "./dist/modules/schemas.mjs",
@@ -55,6 +69,16 @@
55
69
  "import": "./dist/modules/sandbox/wire.mjs",
56
70
  "default": "./dist/modules/sandbox/wire.mjs"
57
71
  },
72
+ "./sandbox/remote": {
73
+ "types": "./dist/modules/sandbox/remote/index.d.mts",
74
+ "import": "./dist/modules/sandbox/remote/index.mjs",
75
+ "default": "./dist/modules/sandbox/remote/index.mjs"
76
+ },
77
+ "./identity": {
78
+ "types": "./dist/modules/identity.d.mts",
79
+ "import": "./dist/modules/identity.mjs",
80
+ "default": "./dist/modules/identity.mjs"
81
+ },
58
82
  "./sandbox/client": {
59
83
  "types": "./dist/modules/sandbox/client.d.mts",
60
84
  "import": "./dist/modules/sandbox/client.mjs",
@@ -85,11 +109,6 @@
85
109
  "import": "./dist/modules/sandbox/workspace-root.mjs",
86
110
  "default": "./dist/modules/sandbox/workspace-root.mjs"
87
111
  },
88
- "./sandbox/open-scope-node": {
89
- "types": "./dist/modules/sandbox/open-scope-node.d.mts",
90
- "import": "./dist/modules/sandbox/open-scope-node.mjs",
91
- "default": "./dist/modules/sandbox/open-scope-node.mjs"
92
- },
93
112
  "./conformance": {
94
113
  "types": "./dist/modules/conformance/index.d.mts",
95
114
  "import": "./dist/modules/conformance/index.mjs",
@@ -100,6 +119,11 @@
100
119
  "import": "./dist/modules/conformance/scripted-model/index.mjs",
101
120
  "default": "./dist/modules/conformance/scripted-model/index.mjs"
102
121
  },
122
+ "./conformance/stdio": {
123
+ "types": "./dist/modules/conformance/stdio.d.mts",
124
+ "import": "./dist/modules/conformance/stdio.mjs",
125
+ "default": "./dist/modules/conformance/stdio.mjs"
126
+ },
103
127
  "./json": {
104
128
  "types": "./dist/modules/json.d.mts",
105
129
  "import": "./dist/modules/json.mjs",
@@ -111,21 +135,6 @@
111
135
  "import": "./dist/modules/mcp-content.mjs",
112
136
  "default": "./dist/modules/mcp-content.mjs"
113
137
  },
114
- "./provider-ref": {
115
- "types": "./dist/modules/provider-ref.d.mts",
116
- "import": "./dist/modules/provider-ref.mjs",
117
- "default": "./dist/modules/provider-ref.mjs"
118
- },
119
- "./manifest": {
120
- "types": "./dist/modules/manifest.d.mts",
121
- "import": "./dist/modules/manifest.mjs",
122
- "default": "./dist/modules/manifest.mjs"
123
- },
124
- "./dynamic": {
125
- "types": "./dist/modules/dynamic.d.mts",
126
- "import": "./dist/modules/dynamic.mjs",
127
- "default": "./dist/modules/dynamic.mjs"
128
- },
129
138
  "./semantic-events": {
130
139
  "types": "./dist/modules/semantic-events.d.mts",
131
140
  "import": "./dist/modules/semantic-events.mjs",
@@ -141,11 +150,6 @@
141
150
  "import": "./dist/modules/sandbox/snapshots.mjs",
142
151
  "default": "./dist/modules/sandbox/snapshots.mjs"
143
152
  },
144
- "./sandbox/open-scope": {
145
- "types": "./dist/modules/sandbox/open-scope.d.mts",
146
- "import": "./dist/modules/sandbox/open-scope.mjs",
147
- "default": "./dist/modules/sandbox/open-scope.mjs"
148
- },
149
153
  "./sandbox/frame-channel": {
150
154
  "types": "./dist/modules/sandbox/frame-channel.d.mts",
151
155
  "import": "./dist/modules/sandbox/frame-channel.mjs",
@@ -171,15 +175,55 @@
171
175
  "import": "./dist/modules/local-channel-socket.mjs",
172
176
  "default": "./dist/modules/local-channel-socket.mjs"
173
177
  },
174
- "./room-surface": {
175
- "types": "./dist/modules/room-surface.d.mts",
176
- "import": "./dist/modules/room-surface.mjs",
177
- "default": "./dist/modules/room-surface.mjs"
178
- },
179
178
  "./local-channel-context": {
180
179
  "types": "./dist/modules/local-channel-context.d.mts",
181
180
  "import": "./dist/modules/local-channel-context.mjs",
182
181
  "default": "./dist/modules/local-channel-context.mjs"
182
+ },
183
+ "./document": {
184
+ "types": "./dist/modules/document.d.mts",
185
+ "import": "./dist/modules/document.mjs",
186
+ "default": "./dist/modules/document.mjs"
187
+ },
188
+ "./inference": {
189
+ "types": "./dist/modules/inference.d.mts",
190
+ "import": "./dist/modules/inference.mjs",
191
+ "default": "./dist/modules/inference.mjs"
192
+ },
193
+ "./canonical-json": {
194
+ "types": "./dist/modules/canonical-json.d.mts",
195
+ "import": "./dist/modules/canonical-json.mjs",
196
+ "default": "./dist/modules/canonical-json.mjs"
197
+ },
198
+ "./harness-requirements": {
199
+ "types": "./dist/modules/harness-requirements.d.mts",
200
+ "import": "./dist/modules/harness-requirements.mjs",
201
+ "default": "./dist/modules/harness-requirements.mjs"
202
+ },
203
+ "./requirements-check": {
204
+ "types": "./dist/modules/requirements-check.d.mts",
205
+ "import": "./dist/modules/requirements-check.mjs",
206
+ "default": "./dist/modules/requirements-check.mjs"
207
+ },
208
+ "./tool-descriptor": {
209
+ "types": "./dist/modules/tool-descriptor.d.mts",
210
+ "import": "./dist/modules/tool-descriptor.mjs",
211
+ "default": "./dist/modules/tool-descriptor.mjs"
212
+ },
213
+ "./sandbox/grant": {
214
+ "types": "./dist/modules/sandbox/grant.d.mts",
215
+ "import": "./dist/modules/sandbox/grant.mjs",
216
+ "default": "./dist/modules/sandbox/grant.mjs"
217
+ },
218
+ "./sandbox/setup": {
219
+ "types": "./dist/modules/sandbox/setup/index.d.mts",
220
+ "import": "./dist/modules/sandbox/setup/index.mjs",
221
+ "default": "./dist/modules/sandbox/setup/index.mjs"
222
+ },
223
+ "./code-host": {
224
+ "types": "./dist/modules/code-host/index.d.mts",
225
+ "import": "./dist/modules/code-host/index.mjs",
226
+ "default": "./dist/modules/code-host/index.mjs"
183
227
  }
184
228
  },
185
229
  "publishConfig": {
@@ -188,11 +232,12 @@
188
232
  },
189
233
  "dependencies": {
190
234
  "@agentclientprotocol/sdk": "1.8.0",
191
- "@finalai/acp-session": "0.1.11",
192
- "@finalai/agent-protocol": "0.8.0",
235
+ "@finalai/acp-session": "0.3.0",
236
+ "@finalai/agent-protocol": "0.10.0",
193
237
  "@modelcontextprotocol/client": "^2.1.0",
194
238
  "@modelcontextprotocol/core": "^2.1.0",
195
239
  "@modelcontextprotocol/server": "^2.1.0",
240
+ "json-schema-library": "11.6.5",
196
241
  "re2js": "2.8.6",
197
242
  "zod": "4.6.6"
198
243
  },
@@ -1,206 +0,0 @@
1
- import * as z from 'zod';
2
- import { DynamicEvent } from "./dynamic.mjs";
3
- export declare enum CredentialPayer {
4
- AgentOwner = "agent-owner",
5
- Organization = "organization",
6
- PromptingUser = "prompting-user",
7
- ConversationOwner = "conversation-owner"
8
- }
9
- export declare enum CredentialOwner {
10
- Payer = "payer",
11
- Organization = "organization"
12
- }
13
- export declare enum CredentialNodeKind {
14
- Subscription = "subscription",
15
- ApiKey = "api-key",
16
- Platform = "platform",
17
- HarnessOwned = "harness-owned",
18
- Custom = "custom"
19
- }
20
- export declare enum InferenceCredentialKind {
21
- Subscription = "subscription",
22
- ApiKey = "api-key",
23
- Platform = "platform",
24
- HarnessOwned = "harness-owned"
25
- }
26
- export declare enum CredentialDelivery {
27
- PerRequest = "per-request",
28
- AtOpen = "at-open"
29
- }
30
- export declare const KNOWN_INFERENCE_VENDORS: readonly ["openai", "anthropic", "openrouter", "google", "bedrock"];
31
- export declare const subscriptionNodeSchema: z.ZodObject<{
32
- kind: z.ZodLiteral<CredentialNodeKind.Subscription>;
33
- owner: z.ZodEnum<typeof CredentialOwner>;
34
- vendor: z.ZodOptional<z.ZodString>;
35
- pin: z.ZodOptional<z.ZodString>;
36
- }, z.core.$strip>;
37
- export declare const apiKeyOwnerNodeSchema: z.ZodObject<{
38
- pin: z.ZodOptional<z.ZodString>;
39
- kind: z.ZodLiteral<CredentialNodeKind.ApiKey>;
40
- owner: z.ZodEnum<typeof CredentialOwner>;
41
- vendor: z.ZodOptional<z.ZodString>;
42
- }, z.core.$strip>;
43
- export declare const apiKeySecretNodeSchema: z.ZodObject<{
44
- kind: z.ZodLiteral<CredentialNodeKind.ApiKey>;
45
- secret: z.ZodString;
46
- baseUrl: z.ZodOptional<z.ZodString>;
47
- vendor: z.ZodOptional<z.ZodString>;
48
- }, z.core.$strip>;
49
- export declare const platformNodeSchema: z.ZodObject<{
50
- kind: z.ZodLiteral<CredentialNodeKind.Platform>;
51
- budget: z.ZodOptional<z.ZodString>;
52
- }, z.core.$strip>;
53
- export declare const harnessNodeSchema: z.ZodObject<{
54
- kind: z.ZodLiteral<CredentialNodeKind.HarnessOwned>;
55
- }, z.core.$strip>;
56
- export declare const customNodeSchema: z.ZodObject<{
57
- kind: z.ZodLiteral<CredentialNodeKind.Custom>;
58
- resolver: z.ZodString;
59
- events: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof DynamicEvent>>>;
60
- }, z.core.$strip>;
61
- export declare const credentialNodeSchema: z.ZodUnion<readonly [z.ZodObject<{
62
- kind: z.ZodLiteral<CredentialNodeKind.Subscription>;
63
- owner: z.ZodEnum<typeof CredentialOwner>;
64
- vendor: z.ZodOptional<z.ZodString>;
65
- pin: z.ZodOptional<z.ZodString>;
66
- }, z.core.$strip>, z.ZodObject<{
67
- kind: z.ZodLiteral<CredentialNodeKind.ApiKey>;
68
- secret: z.ZodString;
69
- baseUrl: z.ZodOptional<z.ZodString>;
70
- vendor: z.ZodOptional<z.ZodString>;
71
- }, z.core.$strip>, z.ZodObject<{
72
- pin: z.ZodOptional<z.ZodString>;
73
- kind: z.ZodLiteral<CredentialNodeKind.ApiKey>;
74
- owner: z.ZodEnum<typeof CredentialOwner>;
75
- vendor: z.ZodOptional<z.ZodString>;
76
- }, z.core.$strip>, z.ZodObject<{
77
- kind: z.ZodLiteral<CredentialNodeKind.Platform>;
78
- budget: z.ZodOptional<z.ZodString>;
79
- }, z.core.$strip>, z.ZodObject<{
80
- kind: z.ZodLiteral<CredentialNodeKind.HarnessOwned>;
81
- }, z.core.$strip>, z.ZodObject<{
82
- kind: z.ZodLiteral<CredentialNodeKind.Custom>;
83
- resolver: z.ZodString;
84
- events: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof DynamicEvent>>>;
85
- }, z.core.$strip>]>;
86
- export declare const credentialPolicySchema: z.ZodObject<{
87
- payer: z.ZodEnum<typeof CredentialPayer>;
88
- tryInOrder: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
89
- kind: z.ZodLiteral<CredentialNodeKind.Subscription>;
90
- owner: z.ZodEnum<typeof CredentialOwner>;
91
- vendor: z.ZodOptional<z.ZodString>;
92
- pin: z.ZodOptional<z.ZodString>;
93
- }, z.core.$strip>, z.ZodObject<{
94
- kind: z.ZodLiteral<CredentialNodeKind.ApiKey>;
95
- secret: z.ZodString;
96
- baseUrl: z.ZodOptional<z.ZodString>;
97
- vendor: z.ZodOptional<z.ZodString>;
98
- }, z.core.$strip>, z.ZodObject<{
99
- pin: z.ZodOptional<z.ZodString>;
100
- kind: z.ZodLiteral<CredentialNodeKind.ApiKey>;
101
- owner: z.ZodEnum<typeof CredentialOwner>;
102
- vendor: z.ZodOptional<z.ZodString>;
103
- }, z.core.$strip>, z.ZodObject<{
104
- kind: z.ZodLiteral<CredentialNodeKind.Platform>;
105
- budget: z.ZodOptional<z.ZodString>;
106
- }, z.core.$strip>, z.ZodObject<{
107
- kind: z.ZodLiteral<CredentialNodeKind.HarnessOwned>;
108
- }, z.core.$strip>, z.ZodObject<{
109
- kind: z.ZodLiteral<CredentialNodeKind.Custom>;
110
- resolver: z.ZodString;
111
- events: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof DynamicEvent>>>;
112
- }, z.core.$strip>]>>;
113
- }, z.core.$strip>;
114
- export type SubscriptionNodeIface = z.infer<typeof subscriptionNodeSchema>;
115
- export type ApiKeyOwnerNodeIface = z.infer<typeof apiKeyOwnerNodeSchema>;
116
- export type ApiKeySecretNodeIface = z.infer<typeof apiKeySecretNodeSchema>;
117
- export type PlatformNodeIface = z.infer<typeof platformNodeSchema>;
118
- export type HarnessOwnedNodeIface = z.infer<typeof harnessNodeSchema>;
119
- export type CustomNodeIface = z.infer<typeof customNodeSchema>;
120
- export type CredentialNode = z.infer<typeof credentialNodeSchema>;
121
- export type CredentialPolicyIface = z.infer<typeof credentialPolicySchema>;
122
- export declare const customResolverResultSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodObject<{
123
- kind: z.ZodLiteral<CredentialNodeKind.Subscription>;
124
- owner: z.ZodEnum<typeof CredentialOwner>;
125
- vendor: z.ZodOptional<z.ZodString>;
126
- pin: z.ZodOptional<z.ZodString>;
127
- }, z.core.$strip>, z.ZodObject<{
128
- kind: z.ZodLiteral<CredentialNodeKind.ApiKey>;
129
- secret: z.ZodString;
130
- baseUrl: z.ZodOptional<z.ZodString>;
131
- vendor: z.ZodOptional<z.ZodString>;
132
- }, z.core.$strip>, z.ZodObject<{
133
- pin: z.ZodOptional<z.ZodString>;
134
- kind: z.ZodLiteral<CredentialNodeKind.ApiKey>;
135
- owner: z.ZodEnum<typeof CredentialOwner>;
136
- vendor: z.ZodOptional<z.ZodString>;
137
- }, z.core.$strip>, z.ZodObject<{
138
- kind: z.ZodLiteral<CredentialNodeKind.Platform>;
139
- budget: z.ZodOptional<z.ZodString>;
140
- }, z.core.$strip>, z.ZodObject<{
141
- kind: z.ZodLiteral<CredentialNodeKind.HarnessOwned>;
142
- }, z.core.$strip>, z.ZodObject<{
143
- kind: z.ZodLiteral<CredentialNodeKind.Custom>;
144
- resolver: z.ZodString;
145
- events: z.ZodDefault<z.ZodArray<z.ZodEnum<typeof DynamicEvent>>>;
146
- }, z.core.$strip>]>, z.ZodObject<{
147
- kind: z.ZodLiteral<CredentialNodeKind.ApiKey>;
148
- value: z.ZodString;
149
- vendor: z.ZodOptional<z.ZodString>;
150
- baseUrl: z.ZodOptional<z.ZodString>;
151
- }, z.core.$strip>]>;
152
- export type CustomResolverResult = z.infer<typeof customResolverResultSchema>;
153
- interface SubscriptionArgsIface {
154
- owner: CredentialOwner | `${CredentialOwner}`;
155
- vendor?: string;
156
- pin?: string;
157
- }
158
- interface ApiKeyOwnerArgsIface {
159
- pin?: string;
160
- owner: CredentialOwner | `${CredentialOwner}`;
161
- vendor?: string;
162
- }
163
- interface ApiKeySecretArgsIface {
164
- secret: string;
165
- baseUrl?: string;
166
- vendor?: string;
167
- }
168
- interface ChainArgsIface {
169
- payer: CredentialPayer | `${CredentialPayer}`;
170
- tryInOrder: CredentialNode[];
171
- }
172
- interface CustomResolverRefIface {
173
- resolverExport: string;
174
- events?: DynamicEvent[];
175
- }
176
- export declare const credentials: {
177
- chain: (args: ChainArgsIface) => CredentialPolicyIface;
178
- subscription: (args: SubscriptionArgsIface) => SubscriptionNodeIface;
179
- apiKey: (args: ApiKeyOwnerArgsIface | ApiKeySecretArgsIface) => CredentialNode;
180
- platform: (args?: {
181
- budget?: string;
182
- }) => PlatformNodeIface;
183
- harness: () => HarnessOwnedNodeIface;
184
- custom: (ref: CustomResolverRefIface) => CustomNodeIface;
185
- };
186
- export declare const defaultPersonalCredentialPolicy: () => CredentialPolicyIface;
187
- export declare const defaultOrganizationCredentialPolicy: () => CredentialPolicyIface;
188
- export declare const inferenceKindOfNode: (node: CredentialNode) => InferenceCredentialKind | null;
189
- export declare enum CredentialFailureReason {
190
- SubscriptionNotConnected = "subscription_not_connected",
191
- UsageExhausted = "usage_exhausted",
192
- BudgetExceeded = "budget_exceeded",
193
- CredentialInvalid = "credential_invalid",
194
- HarnessIncompatible = "harness_incompatible"
195
- }
196
- export declare enum CredentialFallbackReason {
197
- Archived = "archived",
198
- Invalid = "invalid",
199
- VendorMismatch = "vendor_mismatch",
200
- Exhausted = "exhausted",
201
- NotGranted = "not_granted",
202
- OverBudget = "over_budget",
203
- KindUnsupported = "kind_unsupported",
204
- Missing = "missing"
205
- }
206
- export {};