@wildo-ai/external-connectors-models 1.1.2 → 1.1.4
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.
- package/dist/esm/.native.tsbuildinfo +1 -0
- package/dist/esm/companion-exports.d.ts.map +1 -1
- package/dist/esm/core/commons.external-connectors-models.schemas.d.ts +45 -7
- package/dist/esm/core/commons.external-connectors-models.schemas.d.ts.map +1 -1
- package/dist/esm/core/commons.external-connectors-models.schemas.js +42 -5
- package/dist/esm/core/commons.external-connectors-models.schemas.js.map +1 -1
- package/dist/esm/core/operation-classification.external-connectors-models.schemas.d.ts +13 -0
- package/dist/esm/core/operation-classification.external-connectors-models.schemas.d.ts.map +1 -0
- package/dist/esm/core/operation-classification.external-connectors-models.schemas.js +14 -0
- package/dist/esm/core/operation-classification.external-connectors-models.schemas.js.map +1 -0
- package/dist/esm/core/protocols.external-connectors-models.schemas.d.ts +0 -25
- package/dist/esm/core/protocols.external-connectors-models.schemas.d.ts.map +1 -1
- package/dist/esm/core/protocols.external-connectors-models.schemas.js.map +1 -1
- package/dist/esm/core/security.external-connectors-models.schemas.d.ts +132 -2
- package/dist/esm/core/security.external-connectors-models.schemas.d.ts.map +1 -1
- package/dist/esm/core/security.external-connectors-models.schemas.js +164 -0
- package/dist/esm/core/security.external-connectors-models.schemas.js.map +1 -1
- package/dist/esm/index.d.ts +3 -9
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +6 -10
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/protocols/agent-client-protocol.external-connectors-models.schemas.d.ts +251 -4
- package/dist/esm/protocols/agent-client-protocol.external-connectors-models.schemas.d.ts.map +1 -1
- package/dist/esm/protocols/agent-client-protocol.external-connectors-models.schemas.js +307 -2
- package/dist/esm/protocols/agent-client-protocol.external-connectors-models.schemas.js.map +1 -1
- package/dist/esm/protocols/billing.standard-interface.schemas.d.ts +154 -0
- package/dist/esm/protocols/billing.standard-interface.schemas.d.ts.map +1 -1
- package/dist/esm/protocols/billing.standard-interface.schemas.js +49 -0
- package/dist/esm/protocols/billing.standard-interface.schemas.js.map +1 -1
- package/dist/esm/protocols/document-extraction.external-connectors-models.schemas.d.ts +72 -0
- package/dist/esm/protocols/document-extraction.external-connectors-models.schemas.d.ts.map +1 -1
- package/dist/esm/protocols/document-extraction.external-connectors-models.schemas.js +77 -2
- package/dist/esm/protocols/document-extraction.external-connectors-models.schemas.js.map +1 -1
- package/dist/esm/protocols/email.external-connectors-models.schemas.d.ts +1 -1
- package/dist/esm/protocols/email.external-connectors-models.schemas.d.ts.map +1 -1
- package/dist/esm/protocols/email.standard-interface.schemas.d.ts.map +1 -1
- package/dist/esm/protocols/embeddings.external-connectors-models.schemas.d.ts.map +1 -1
- package/dist/esm/protocols/frontend.external-connectors-models.schemas.d.ts.map +1 -1
- package/dist/esm/{features/hooks.external-connectors-models.schemas.d.ts → protocols/hooks-capability.external-connectors-models.schemas.d.ts} +1 -1
- package/dist/esm/protocols/hooks-capability.external-connectors-models.schemas.d.ts.map +1 -0
- package/dist/esm/{features/hooks.external-connectors-models.schemas.js → protocols/hooks-capability.external-connectors-models.schemas.js} +1 -1
- package/dist/esm/protocols/hooks-capability.external-connectors-models.schemas.js.map +1 -0
- package/dist/esm/protocols/hooks.external-connectors-models.schemas.d.ts.map +1 -1
- package/dist/esm/protocols/image.external-connectors-models.schemas.d.ts.map +1 -1
- package/dist/esm/protocols/llm.external-connectors-models.schemas.d.ts +36 -19
- package/dist/esm/protocols/llm.external-connectors-models.schemas.d.ts.map +1 -1
- package/dist/esm/protocols/llm.external-connectors-models.schemas.js +90 -28
- package/dist/esm/protocols/llm.external-connectors-models.schemas.js.map +1 -1
- package/dist/esm/protocols/oauth2.external-connectors-models.schemas.d.ts +2 -2
- package/dist/esm/protocols/oauth2.external-connectors-models.schemas.d.ts.map +1 -1
- package/dist/esm/protocols/rest-api.external-connectors-models.schemas.d.ts +1 -89
- package/dist/esm/protocols/rest-api.external-connectors-models.schemas.d.ts.map +1 -1
- package/dist/esm/protocols/rest-api.external-connectors-models.schemas.js +1 -83
- package/dist/esm/protocols/rest-api.external-connectors-models.schemas.js.map +1 -1
- package/dist/esm/protocols/rest-operations.external-connectors-models.schemas.d.ts +370 -0
- package/dist/esm/protocols/rest-operations.external-connectors-models.schemas.d.ts.map +1 -0
- package/dist/esm/protocols/rest-operations.external-connectors-models.schemas.js +89 -0
- package/dist/esm/protocols/rest-operations.external-connectors-models.schemas.js.map +1 -0
- package/dist/esm/protocols/sms.external-connectors-models.schemas.d.ts.map +1 -1
- package/dist/esm/protocols/sms.standard-interface.schemas.d.ts +66 -6
- package/dist/esm/protocols/sms.standard-interface.schemas.d.ts.map +1 -1
- package/dist/esm/protocols/sms.standard-interface.schemas.js +71 -1
- package/dist/esm/protocols/sms.standard-interface.schemas.js.map +1 -1
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +2 -2
- package/dist/esm/features/core.external-connectors-models.schemas.d.ts +0 -63
- package/dist/esm/features/core.external-connectors-models.schemas.d.ts.map +0 -1
- package/dist/esm/features/core.external-connectors-models.schemas.js +0 -101
- package/dist/esm/features/core.external-connectors-models.schemas.js.map +0 -1
- package/dist/esm/features/email.external-connectors-models.schemas.d.ts +0 -181
- package/dist/esm/features/email.external-connectors-models.schemas.d.ts.map +0 -1
- package/dist/esm/features/email.external-connectors-models.schemas.js +0 -34
- package/dist/esm/features/email.external-connectors-models.schemas.js.map +0 -1
- package/dist/esm/features/hooks.external-connectors-models.schemas.d.ts.map +0 -1
- package/dist/esm/features/hooks.external-connectors-models.schemas.js.map +0 -1
- package/dist/esm/features/sms.external-connectors-models.schemas.d.ts +0 -21
- package/dist/esm/features/sms.external-connectors-models.schemas.d.ts.map +0 -1
- package/dist/esm/features/sms.external-connectors-models.schemas.js +0 -8
- package/dist/esm/features/sms.external-connectors-models.schemas.js.map +0 -1
- package/dist/esm/protocols/a2a.external-connectors-models.schemas.d.ts +0 -57
- package/dist/esm/protocols/a2a.external-connectors-models.schemas.d.ts.map +0 -1
- package/dist/esm/protocols/a2a.external-connectors-models.schemas.js +0 -73
- package/dist/esm/protocols/a2a.external-connectors-models.schemas.js.map +0 -1
- package/dist/esm/protocols/git.external-connectors-models.schemas.d.ts +0 -14
- package/dist/esm/protocols/git.external-connectors-models.schemas.d.ts.map +0 -1
- package/dist/esm/protocols/git.external-connectors-models.schemas.js +0 -9
- package/dist/esm/protocols/git.external-connectors-models.schemas.js.map +0 -1
- package/dist/esm/protocols/grpc.external-connectors-models.schemas.d.ts +0 -14
- package/dist/esm/protocols/grpc.external-connectors-models.schemas.d.ts.map +0 -1
- package/dist/esm/protocols/grpc.external-connectors-models.schemas.js +0 -9
- package/dist/esm/protocols/grpc.external-connectors-models.schemas.js.map +0 -1
- package/dist/esm/protocols/mcp.external-connectors-models.schemas.d.ts +0 -60
- package/dist/esm/protocols/mcp.external-connectors-models.schemas.d.ts.map +0 -1
- package/dist/esm/protocols/mcp.external-connectors-models.schemas.js +0 -35
- package/dist/esm/protocols/mcp.external-connectors-models.schemas.js.map +0 -1
- package/dist/esm/protocols/saml.external-connectors-models.schemas.d.ts +0 -135
- package/dist/esm/protocols/saml.external-connectors-models.schemas.d.ts.map +0 -1
- package/dist/esm/protocols/saml.external-connectors-models.schemas.js +0 -9
- package/dist/esm/protocols/saml.external-connectors-models.schemas.js.map +0 -1
|
@@ -63,10 +63,19 @@ export declare enum AgentClientProtocol_WorkingDirectoryPolicy {
|
|
|
63
63
|
* what lets an application say "no session started from this profile may ever
|
|
64
64
|
* skip the permission gate" independently of what any individual run requests.
|
|
65
65
|
*
|
|
66
|
-
* Ordering is meaningful and increasing: PROMPT_ALWAYS <
|
|
66
|
+
* Ordering is meaningful and increasing over all FIVE members: PROMPT_ALWAYS <
|
|
67
|
+
* AUTO_ACCEPT_READS < AUTO_ACCEPT_EDITS < AUTO_ACCEPT_READS_AND_EDITS <
|
|
67
68
|
* UNRESTRICTED. Compare through {@link agentClientProtocolPermissionCeilingRank}
|
|
68
69
|
* rather than by string, so the ordering has one definition.
|
|
70
|
+
*
|
|
71
|
+
* Read that order as a CLAMP — how much is pre-approved without a human — and never
|
|
72
|
+
* as containment. The ceilings are kind-SETS and are deliberately not nested:
|
|
73
|
+
* AUTO_ACCEPT_EDITS outranks AUTO_ACCEPT_READS and still refuses `fetch`, which is
|
|
74
|
+
* exactly why AUTO_ACCEPT_READS_AND_EDITS had to be added rather than being implied
|
|
75
|
+
* by the higher rank. Each member's own docstring states the set it admits, and the
|
|
76
|
+
* rank function carries the full argument for why containment is the wrong reading.
|
|
69
77
|
*/
|
|
78
|
+
/** @wildo_source:part:start acp.permission-ceiling facet:layer:config facet:audience:app-developer */
|
|
70
79
|
export declare enum AgentClientProtocol_PermissionCeiling {
|
|
71
80
|
/**
|
|
72
81
|
* Every permission request the agent raises must be answered by the client.
|
|
@@ -131,9 +140,36 @@ export declare enum AgentClientProtocol_PermissionCeiling {
|
|
|
131
140
|
* can fetch anything and write only its evidence directory.
|
|
132
141
|
*/
|
|
133
142
|
AUTO_ACCEPT_READS_AND_EDITS = "auto_accept_reads_and_edits",
|
|
134
|
-
/**
|
|
143
|
+
/**
|
|
144
|
+
* No permission gate: every tool kind is pre-approved, `execute` and the unclassified `other`
|
|
145
|
+
* included. Reserve for a disposable or isolated workspace.
|
|
146
|
+
*
|
|
147
|
+
* **This member also removes the task's mutation scope for shell commands, and that is a property
|
|
148
|
+
* of shell commands rather than of this value.** The scope predicate runs AFTER the ceiling and
|
|
149
|
+
* denies any location the task did not authorise even here — so declared file EDITS stay confined.
|
|
150
|
+
* But it decides on the `locations` a permission request carries, and a shell command carries
|
|
151
|
+
* NONE, because what a command writes is not derivable from the command string. Every ceiling
|
|
152
|
+
* below this one refuses `execute` outright, so the empty-location case never reaches the
|
|
153
|
+
* predicate; under this one it does, and `locations.some(...)` over an empty array is vacuously
|
|
154
|
+
* satisfied. A mutating command therefore reaches the workspace inside a complete, well-formed
|
|
155
|
+
* permission record showing it was allowed.
|
|
156
|
+
*
|
|
157
|
+
* Not closable by deriving a scope from the command: any parse is defeated by `sh -c "$CMD"` or a
|
|
158
|
+
* redirect through a substituted path, and an invented scope that can be walked around is worse
|
|
159
|
+
* than a stated absence. So the residual exposure under this member is exactly "shell commands are
|
|
160
|
+
* unbounded", the answer to it is git plus the post-run change set, and the companion WARNS on
|
|
161
|
+
* every run whose mutation followed a permitted act that declared no location — which is how it
|
|
162
|
+
* stops being invisible. Author this member to state that plainly; do not author it expecting the
|
|
163
|
+
* mutation scope to hold for commands.
|
|
164
|
+
*
|
|
165
|
+
* Note this is a DIFFERENT hole from an agent that never asks (see
|
|
166
|
+
* {@link AgentClientProtocol_PermissionEscalationBehaviour}): that one costs you both guards for
|
|
167
|
+
* every act, and dispatch refuses a narrower ceiling against such an agent. This one costs you the
|
|
168
|
+
* scope guard for one act kind, against a fully compliant agent.
|
|
169
|
+
*/
|
|
135
170
|
UNRESTRICTED = "unrestricted"
|
|
136
171
|
}
|
|
172
|
+
/** @wildo_source:part:end acp.permission-ceiling */
|
|
137
173
|
/**
|
|
138
174
|
* Increasing rank for {@link AgentClientProtocol_PermissionCeiling}; the single ordering definition.
|
|
139
175
|
*
|
|
@@ -154,6 +190,95 @@ export declare enum AgentClientProtocol_PermissionCeiling {
|
|
|
154
190
|
* the read direction should mean.
|
|
155
191
|
*/
|
|
156
192
|
export declare function agentClientProtocolPermissionCeilingRank(ceiling: AgentClientProtocol_PermissionCeiling): number;
|
|
193
|
+
/**
|
|
194
|
+
* Whether THIS agent raises `session/request_permission` before it mutates —
|
|
195
|
+
* the one property that decides whether Wildo's in-flight guards can fire at all.
|
|
196
|
+
*
|
|
197
|
+
* # Why a permission ceiling needs this to mean anything
|
|
198
|
+
*
|
|
199
|
+
* Both of Wildo's in-flight controls are enforced in the CLIENT's ANSWER to a
|
|
200
|
+
* permission request: {@link AgentClientProtocol_PermissionCeiling} decides the
|
|
201
|
+
* tool KIND, and the dispatch's location predicate decides the PATHS. Neither is
|
|
202
|
+
* a sandbox, an interposed filesystem, or a syscall filter — they are answers.
|
|
203
|
+
* So an agent that writes without asking is bound by neither, and the ceiling
|
|
204
|
+
* an application authored is a LABEL rather than a guarantee.
|
|
205
|
+
*
|
|
206
|
+
* That is not hypothetical and it is not a fault in the agents. MEASURED with
|
|
207
|
+
* `wildo acp probe`:
|
|
208
|
+
*
|
|
209
|
+
* - Codex (`@agentclientprotocol/codex-acp`, 2026-09-06) raises nothing before
|
|
210
|
+
* an in-workspace write in ANY of its three modes, including with an explicit
|
|
211
|
+
* `approval_policy = "untrusted"`. Its safety model is a SANDBOX, so an
|
|
212
|
+
* in-workspace write is safe by ITS construction and there is nothing to ask
|
|
213
|
+
* about. A different architecture, not a defect.
|
|
214
|
+
* - OpenCode (1.18.27, 2026-09-04/05) does the same under its DEFAULT
|
|
215
|
+
* configuration, and escalates correctly when pointed at a permission
|
|
216
|
+
* configuration file. So for that agent the answer is conditional on
|
|
217
|
+
* something the HOST supplies.
|
|
218
|
+
* - Claude's adapter (`@agentclientprotocol/claude-agent-acp` 0.73.0) raises,
|
|
219
|
+
* and both guards fire.
|
|
220
|
+
*
|
|
221
|
+
* # Why it is DECLARED rather than inferred, and why it is required
|
|
222
|
+
*
|
|
223
|
+
* It cannot be inferred before a run: an agent that never asks and an agent that
|
|
224
|
+
* had nothing to ask about are indistinguishable from an empty decision list, and
|
|
225
|
+
* by the time the list is empty the workspace has already been mutated. The
|
|
226
|
+
* post-run change set remains the authoritative account of what a run touched —
|
|
227
|
+
* this declaration is what lets the framework say, BEFORE the run, whether that
|
|
228
|
+
* change set is the only account there will be.
|
|
229
|
+
*
|
|
230
|
+
* The provider declares it because the provider is the party that ran the probe.
|
|
231
|
+
* It is REQUIRED on the runtime contract for the same reason `modelDelivery` is:
|
|
232
|
+
* this lane has now shipped three safety-relevant fields that were authored,
|
|
233
|
+
* documented and read by nothing (`hostConfigurationInheritance`, the model
|
|
234
|
+
* channel, the provider's inherited environment). An author who cannot ship the
|
|
235
|
+
* gap is better than one who discovers it on a dispatched run.
|
|
236
|
+
*
|
|
237
|
+
* It is a CLAIM, never an alibi. The companion still judges each completed run
|
|
238
|
+
* from that run's OWN permission decisions and change set, so an agent whose
|
|
239
|
+
* behaviour changes between versions cannot keep a stale, reassuring declaration.
|
|
240
|
+
*/
|
|
241
|
+
/** @wildo_source:part:start acp.permission-escalation facet:layer:config facet:audience:app-developer */
|
|
242
|
+
export declare enum AgentClientProtocol_PermissionEscalationBehaviour {
|
|
243
|
+
/**
|
|
244
|
+
* The agent escalates before mutating, so the ceiling and the mutation scope
|
|
245
|
+
* are both enforceable in flight. The only value under which a ceiling
|
|
246
|
+
* narrower than UNRESTRICTED means what it says.
|
|
247
|
+
*/
|
|
248
|
+
RAISES_BEFORE_MUTATION = "raises_before_mutation",
|
|
249
|
+
/**
|
|
250
|
+
* The agent escalates ONLY when the host points it at a permission
|
|
251
|
+
* configuration it does not adopt by default.
|
|
252
|
+
*
|
|
253
|
+
* The configuration is therefore not hardening — it is the condition under
|
|
254
|
+
* which the agent may be dispatched with a gate at all, and the variable that
|
|
255
|
+
* carries the pointer is named on the contract so the dispatch can CHECK that
|
|
256
|
+
* a profile supplies it instead of trusting a docstring that says it must.
|
|
257
|
+
*/
|
|
258
|
+
RAISES_ONLY_UNDER_HOST_CONFIGURATION = "raises_only_under_host_configuration",
|
|
259
|
+
/**
|
|
260
|
+
* The agent never escalates before mutating, under any configuration this
|
|
261
|
+
* framework can supply. Its own safety model is elsewhere (a sandbox), and
|
|
262
|
+
* Wildo's in-flight guards are inert for it by construction — the post-run
|
|
263
|
+
* change set is the only account of what it touched.
|
|
264
|
+
*/
|
|
265
|
+
NEVER_RAISES = "never_raises"
|
|
266
|
+
}
|
|
267
|
+
/** @wildo_source:part:end acp.permission-escalation */
|
|
268
|
+
/**
|
|
269
|
+
* Can Wildo's in-flight permission ceiling and mutation-scope predicate fire for
|
|
270
|
+
* this agent, as it will actually be started?
|
|
271
|
+
*
|
|
272
|
+
* The single definition of that question, so the dispatch's refusal, the run's
|
|
273
|
+
* recorded metadata and any operator-facing report cannot disagree about it.
|
|
274
|
+
*
|
|
275
|
+
* `escalationConfigurationSupplied` answers only the conditional member: it is
|
|
276
|
+
* whether the composed child environment will actually carry the pointer the
|
|
277
|
+
* contract names. Deliberately a parameter rather than something this function
|
|
278
|
+
* reads, because the environment is composed by the dispatch and a predicate
|
|
279
|
+
* that guessed at it would be a second, quieter answer.
|
|
280
|
+
*/
|
|
281
|
+
export declare function agentClientProtocolInFlightGuardsCanFire(behaviour: AgentClientProtocol_PermissionEscalationBehaviour, escalationConfigurationSupplied: boolean): boolean;
|
|
157
282
|
/**
|
|
158
283
|
* How much of the HOST MACHINE's agent configuration a session inherits.
|
|
159
284
|
*
|
|
@@ -170,6 +295,7 @@ export declare function agentClientProtocolPermissionCeilingRank(ceiling: AgentC
|
|
|
170
295
|
* application teaches the agent to use its framework. What it should not
|
|
171
296
|
* silently absorb is whoever happens to be logged in.
|
|
172
297
|
*/
|
|
298
|
+
/** @wildo_source:part:start acp.host-configuration-inheritance facet:layer:config facet:audience:app-developer */
|
|
173
299
|
export declare enum AgentClientProtocol_HostConfigurationInheritance {
|
|
174
300
|
/** No filesystem-sourced agent configuration. The prompt is the whole instruction. */
|
|
175
301
|
ISOLATED = "isolated",
|
|
@@ -187,12 +313,55 @@ export declare enum AgentClientProtocol_HostConfigurationInheritance {
|
|
|
187
313
|
*/
|
|
188
314
|
HOST_INHERITED = "host_inherited"
|
|
189
315
|
}
|
|
316
|
+
/** @wildo_source:part:end acp.host-configuration-inheritance */
|
|
317
|
+
/** @wildo_source:part:start acp.execution-profile facet:layer:config facet:audience:app-developer */
|
|
318
|
+
/**
|
|
319
|
+
* WHERE a coding run's content actually goes, per MODEL (issue #308, join 2).
|
|
320
|
+
*
|
|
321
|
+
* An ACP coding session sends the composed task prompt, retrieved context and — through the agent's
|
|
322
|
+
* own file reads — the application's SOURCE CODE to the selected model vendor. For an application
|
|
323
|
+
* built with Wildo that can include the customer's domain model, schemas, seed data shapes and
|
|
324
|
+
* business rules. So the destination is a processor-register fact, not a runtime detail.
|
|
325
|
+
*
|
|
326
|
+
* ## Why this is per MODEL and not per provider
|
|
327
|
+
*
|
|
328
|
+
* A generalist agent routes to several vendors, so its OWN legal identity is not the identity of the
|
|
329
|
+
* vendor a given run reaches: OpenCode is a binary on the host, and the same profile can send code to
|
|
330
|
+
* Anthropic or to OpenAI depending on one model id. A per-provider declaration structurally cannot
|
|
331
|
+
* express that — it would name the agent's publisher as the recipient of code the publisher never
|
|
332
|
+
* receives, which is false in the direction a reader cannot check.
|
|
333
|
+
*
|
|
334
|
+
* ## Why it lives on the EXECUTION PROFILE
|
|
335
|
+
*
|
|
336
|
+
* The profile is already where an application authors the policy it owns, and the model is selected at
|
|
337
|
+
* dispatch time against that profile. The competing home — `providerComplianceChoices`, where every
|
|
338
|
+
* other compliance answer lives — cannot carry it: that surface is keyed by provider ref and has one
|
|
339
|
+
* entry per provider, which is exactly the shape that cannot say "per model".
|
|
340
|
+
*
|
|
341
|
+
* `ApplicationProviderComplianceChoice` warns against putting a compliance answer somewhere "nothing
|
|
342
|
+
* can read it without knowing the provider", and `providerConfigurations` is genuinely an opaque
|
|
343
|
+
* `Record<string, unknown>` bag. That objection is answered rather than ignored:
|
|
344
|
+
* {@link readCodingModelDestinations} is the named reader, exported beside this schema, and the
|
|
345
|
+
* compliance renderer calls it instead of reaching into the bag and guessing a shape. The hazard the
|
|
346
|
+
* warning names is a fact nobody can FIND; a named reader is what removes it.
|
|
347
|
+
*/
|
|
348
|
+
export declare const AgentClientProtocol_ModelDestinationSchema: z.ZodObject<{
|
|
349
|
+
vendorLegalEntityName: z.ZodString;
|
|
350
|
+
processingRegions: z.ZodArray<z.ZodString>;
|
|
351
|
+
gateway: z.ZodOptional<z.ZodObject<{
|
|
352
|
+
legalEntityName: z.ZodString;
|
|
353
|
+
processingRegions: z.ZodArray<z.ZodString>;
|
|
354
|
+
}, z.core.$strip>>;
|
|
355
|
+
}, z.core.$strict>;
|
|
356
|
+
export type AgentClientProtocol_ModelDestination = z.infer<typeof AgentClientProtocol_ModelDestinationSchema>;
|
|
357
|
+
/** @wildo_source:part:end acp.execution-profile */
|
|
190
358
|
/**
|
|
191
359
|
* One authored way to start an ACP agent.
|
|
192
360
|
*
|
|
193
361
|
* Mirrors the shape a provider's execution profiles have always had: the
|
|
194
362
|
* spawnable command plus the policy that decides whether it may run at all.
|
|
195
363
|
*/
|
|
364
|
+
/** @wildo_source:part:start acp.execution-profile facet:layer:config facet:audience:app-developer */
|
|
196
365
|
export declare const AgentClientProtocol_ExecutionProfileSchema: z.ZodObject<{
|
|
197
366
|
runnerHost: z.ZodDefault<z.ZodEnum<typeof AgentClientProtocol_RunnerHost>>;
|
|
198
367
|
command: z.ZodOptional<z.ZodString>;
|
|
@@ -211,9 +380,18 @@ export declare const AgentClientProtocol_ExecutionProfileSchema: z.ZodObject<{
|
|
|
211
380
|
maxAutoContinuations: z.ZodDefault<z.ZodNumber>;
|
|
212
381
|
awaitingInputTtlMs: z.ZodDefault<z.ZodNumber>;
|
|
213
382
|
maximumRecordedEventBytes: z.ZodOptional<z.ZodNumber>;
|
|
383
|
+
modelDestinations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
|
|
384
|
+
vendorLegalEntityName: z.ZodString;
|
|
385
|
+
processingRegions: z.ZodArray<z.ZodString>;
|
|
386
|
+
gateway: z.ZodOptional<z.ZodObject<{
|
|
387
|
+
legalEntityName: z.ZodString;
|
|
388
|
+
processingRegions: z.ZodArray<z.ZodString>;
|
|
389
|
+
}, z.core.$strip>>;
|
|
390
|
+
}, z.core.$strict>>>;
|
|
214
391
|
sessionMetaExtensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
215
392
|
}, z.core.$strict>;
|
|
216
393
|
export type AgentClientProtocol_ExecutionProfile = z.infer<typeof AgentClientProtocol_ExecutionProfileSchema>;
|
|
394
|
+
/** @wildo_source:part:end acp.execution-profile */
|
|
217
395
|
/**
|
|
218
396
|
* Transport capability metadata for an ACP-speaking provider.
|
|
219
397
|
*
|
|
@@ -290,10 +468,10 @@ export declare const AgentClientProtocol_ProfileSchema: z.ZodObject<{
|
|
|
290
468
|
extraAuthParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
291
469
|
extraTokenParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
292
470
|
tokenFormat: z.ZodDefault<z.ZodEnum<{
|
|
293
|
-
|
|
471
|
+
custom: "custom";
|
|
294
472
|
bearer: "bearer";
|
|
473
|
+
token: "token";
|
|
295
474
|
oauth: "oauth";
|
|
296
|
-
custom: "custom";
|
|
297
475
|
}>>;
|
|
298
476
|
customTokenPrefix: z.ZodOptional<z.ZodString>;
|
|
299
477
|
}, z.core.$strip>, z.ZodObject<{
|
|
@@ -369,6 +547,14 @@ export declare const AgentClientProtocol_ConfigurationSchema: z.ZodObject<{
|
|
|
369
547
|
maxAutoContinuations: z.ZodDefault<z.ZodNumber>;
|
|
370
548
|
awaitingInputTtlMs: z.ZodDefault<z.ZodNumber>;
|
|
371
549
|
maximumRecordedEventBytes: z.ZodOptional<z.ZodNumber>;
|
|
550
|
+
modelDestinations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
|
|
551
|
+
vendorLegalEntityName: z.ZodString;
|
|
552
|
+
processingRegions: z.ZodArray<z.ZodString>;
|
|
553
|
+
gateway: z.ZodOptional<z.ZodObject<{
|
|
554
|
+
legalEntityName: z.ZodString;
|
|
555
|
+
processingRegions: z.ZodArray<z.ZodString>;
|
|
556
|
+
}, z.core.$strip>>;
|
|
557
|
+
}, z.core.$strict>>>;
|
|
372
558
|
sessionMetaExtensions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
373
559
|
}, z.core.$strict>>;
|
|
374
560
|
}, z.core.$strip>;
|
|
@@ -548,6 +734,8 @@ export declare const AgentClientProtocol_ExecutionTransportMetadataSchema: z.Zod
|
|
|
548
734
|
agentName: z.ZodOptional<z.ZodString>;
|
|
549
735
|
agentVersion: z.ZodOptional<z.ZodString>;
|
|
550
736
|
sessionModeId: z.ZodOptional<z.ZodString>;
|
|
737
|
+
permissionEscalation: z.ZodOptional<z.ZodEnum<typeof AgentClientProtocol_PermissionEscalationBehaviour>>;
|
|
738
|
+
inFlightPermissionGuardsCanFire: z.ZodOptional<z.ZodBoolean>;
|
|
551
739
|
sessionId: z.ZodOptional<z.ZodString>;
|
|
552
740
|
}, z.core.$strip>;
|
|
553
741
|
export type AgentClientProtocol_ExecutionTransportMetadata = z.infer<typeof AgentClientProtocol_ExecutionTransportMetadataSchema>;
|
|
@@ -579,6 +767,8 @@ export declare const CodingAgent_OperationContext_BaseSchema: z.ZodObject<{
|
|
|
579
767
|
agentName: z.ZodOptional<z.ZodString>;
|
|
580
768
|
agentVersion: z.ZodOptional<z.ZodString>;
|
|
581
769
|
sessionModeId: z.ZodOptional<z.ZodString>;
|
|
770
|
+
permissionEscalation: z.ZodOptional<z.ZodEnum<typeof AgentClientProtocol_PermissionEscalationBehaviour>>;
|
|
771
|
+
inFlightPermissionGuardsCanFire: z.ZodOptional<z.ZodBoolean>;
|
|
582
772
|
sessionId: z.ZodOptional<z.ZodString>;
|
|
583
773
|
}, z.core.$strip>>;
|
|
584
774
|
}, z.core.$strip>;
|
|
@@ -655,4 +845,61 @@ export declare const CodingAgent_RunTaskOutputSchema: z.ZodObject<{
|
|
|
655
845
|
}, z.core.$strict>>;
|
|
656
846
|
}, z.core.$strip>;
|
|
657
847
|
export type CodingAgent_RunTaskOutput = z.infer<typeof CodingAgent_RunTaskOutputSchema>;
|
|
848
|
+
/**
|
|
849
|
+
* One declared coding destination, joined to the provider and profile that declare it.
|
|
850
|
+
*
|
|
851
|
+
* Flat rather than nested because every consumer so far wants to enumerate destinations, not walk a
|
|
852
|
+
* tree — and a nested shape makes "which provider declares nothing" a hole a caller has to notice
|
|
853
|
+
* rather than a row it is handed. {@link CodingModelDestinationReading} carries both.
|
|
854
|
+
*/
|
|
855
|
+
export interface CodingModelDestinationEntry {
|
|
856
|
+
readonly providerRef: string;
|
|
857
|
+
readonly executionProfileRef: string;
|
|
858
|
+
readonly model: string;
|
|
859
|
+
readonly destination: AgentClientProtocol_ModelDestination;
|
|
860
|
+
}
|
|
861
|
+
/** What {@link readCodingModelDestinations} found, including what it found MISSING. */
|
|
862
|
+
export interface CodingModelDestinationReading {
|
|
863
|
+
/** Every declared destination, sorted by provider, profile then model. */
|
|
864
|
+
readonly destinations: readonly CodingModelDestinationEntry[];
|
|
865
|
+
/**
|
|
866
|
+
* Profiles that can run a coding agent and declare NO destination at all.
|
|
867
|
+
*
|
|
868
|
+
* Reported as its own list rather than as an absence, because this is the gap a compliance brief
|
|
869
|
+
* must name: a run through such a profile sends source code somewhere the register cannot describe.
|
|
870
|
+
*/
|
|
871
|
+
readonly profilesWithoutDestinations: readonly {
|
|
872
|
+
readonly providerRef: string;
|
|
873
|
+
readonly executionProfileRef: string;
|
|
874
|
+
}[];
|
|
875
|
+
}
|
|
876
|
+
/**
|
|
877
|
+
* Read per-model coding destinations out of an application's provider configurations.
|
|
878
|
+
*
|
|
879
|
+
* ## Why this function exists at all
|
|
880
|
+
*
|
|
881
|
+
* `providerConfigurations` is `Record<string, Record<string, unknown>>` — genuinely opaque, and
|
|
882
|
+
* `ApplicationProviderComplianceChoice` warns for that reason that "a compliance answer must not live
|
|
883
|
+
* somewhere nothing can read it without knowing the provider". The destination has to live there
|
|
884
|
+
* anyway (it is per MODEL, and no per-provider surface can hold it), so the objection is answered by
|
|
885
|
+
* making the reader NAMED and exported beside the schema instead of leaving each consumer to reach in
|
|
886
|
+
* and guess a shape. A compliance renderer calls this; it never parses the bag.
|
|
887
|
+
*
|
|
888
|
+
* ## What it does with malformed input
|
|
889
|
+
*
|
|
890
|
+
* SKIPS it, silently, and this is deliberate rather than lax. The function's job is to report what an
|
|
891
|
+
* application declared, and it is called from a compliance BRIEF — a lane that must not fail because
|
|
892
|
+
* one provider's opaque configuration has an unexpected shape. A profile whose destinations do not
|
|
893
|
+
* parse contributes nothing and therefore surfaces in `profilesWithoutDestinations`, which is the
|
|
894
|
+
* honest reading: nothing usable was declared.
|
|
895
|
+
*
|
|
896
|
+
* Nothing is lost by that leniency, because a malformed profile is ALREADY refused where it matters:
|
|
897
|
+
* `getAgentClientProtocolExecutionProfile` parses every profile through
|
|
898
|
+
* {@link AgentClientProtocol_ExecutionProfileSchema} when a run resolves one, and throws
|
|
899
|
+
* `ErrorType.CONFIGURATION` naming the provider and profile. So a bad destination fails the CODING RUN
|
|
900
|
+
* loudly, with an author present, while the compliance brief still reports the other twenty providers.
|
|
901
|
+
* Two surfaces, two correct answers — and note that the profile schema is `.strict()`, so before
|
|
902
|
+
* `modelDestinations` existed as a declared field an application COULD NOT have authored it at all.
|
|
903
|
+
*/
|
|
904
|
+
export declare function readCodingModelDestinations(providerConfigurations: Readonly<Record<string, unknown>>): CodingModelDestinationReading;
|
|
658
905
|
//# sourceMappingURL=agent-client-protocol.external-connectors-models.schemas.d.ts.map
|
package/dist/esm/protocols/agent-client-protocol.external-connectors-models.schemas.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-client-protocol.external-connectors-models.schemas.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"agent-client-protocol.external-connectors-models.schemas.d.ts","sourceRoot":"","sources":["../../../src/protocols/agent-client-protocol.external-connectors-models.schemas.ts"],"names":[],"mappings":"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"}
|