@uppercut-labs/agent-native 0.0.0-stage → 1.1.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 (187) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +164 -2
  3. package/agent/agent-prompt-short.md +1 -0
  4. package/agent/agent-prompt.md +26 -0
  5. package/bin/agent-native-site.mjs +269 -0
  6. package/bin/discover-routes.mjs +162 -0
  7. package/bin/verify-publication.mjs +317 -0
  8. package/dist/adapters/zod.d.ts +4 -0
  9. package/dist/adapters/zod.d.ts.map +1 -0
  10. package/dist/adapters/zod.js +20 -0
  11. package/dist/adapters/zod.js.map +1 -0
  12. package/dist/astro.d.ts +13 -0
  13. package/dist/astro.d.ts.map +1 -0
  14. package/dist/astro.js +41 -0
  15. package/dist/astro.js.map +1 -0
  16. package/dist/auth.d.ts +52 -0
  17. package/dist/auth.d.ts.map +1 -0
  18. package/dist/auth.js +128 -0
  19. package/dist/auth.js.map +1 -0
  20. package/dist/browser.d.ts +47 -0
  21. package/dist/browser.d.ts.map +1 -0
  22. package/dist/browser.js +219 -0
  23. package/dist/browser.js.map +1 -0
  24. package/dist/cli.d.ts +80 -0
  25. package/dist/cli.d.ts.map +1 -0
  26. package/dist/cli.js +484 -0
  27. package/dist/cli.js.map +1 -0
  28. package/dist/core/assert-never.d.ts +2 -0
  29. package/dist/core/assert-never.d.ts.map +1 -0
  30. package/dist/core/assert-never.js +5 -0
  31. package/dist/core/assert-never.js.map +1 -0
  32. package/dist/core/binding-internal.d.ts +10 -0
  33. package/dist/core/binding-internal.d.ts.map +1 -0
  34. package/dist/core/binding-internal.js +15 -0
  35. package/dist/core/binding-internal.js.map +1 -0
  36. package/dist/core/composition.d.ts +119 -0
  37. package/dist/core/composition.d.ts.map +1 -0
  38. package/dist/core/composition.js +545 -0
  39. package/dist/core/composition.js.map +1 -0
  40. package/dist/core/contracts.d.ts +55 -0
  41. package/dist/core/contracts.d.ts.map +1 -0
  42. package/dist/core/contracts.js +271 -0
  43. package/dist/core/contracts.js.map +1 -0
  44. package/dist/core/diagnostics.d.ts +14 -0
  45. package/dist/core/diagnostics.d.ts.map +1 -0
  46. package/dist/core/diagnostics.js +29 -0
  47. package/dist/core/diagnostics.js.map +1 -0
  48. package/dist/core/executor.d.ts +52 -0
  49. package/dist/core/executor.d.ts.map +1 -0
  50. package/dist/core/executor.js +98 -0
  51. package/dist/core/executor.js.map +1 -0
  52. package/dist/core/registry.d.ts +37 -0
  53. package/dist/core/registry.d.ts.map +1 -0
  54. package/dist/core/registry.js +75 -0
  55. package/dist/core/registry.js.map +1 -0
  56. package/dist/core/schema.d.ts +9 -0
  57. package/dist/core/schema.d.ts.map +1 -0
  58. package/dist/core/schema.js +36 -0
  59. package/dist/core/schema.js.map +1 -0
  60. package/dist/discovery.d.ts +16 -0
  61. package/dist/discovery.d.ts.map +1 -0
  62. package/dist/discovery.js +23 -0
  63. package/dist/discovery.js.map +1 -0
  64. package/dist/doctor.d.ts +200 -0
  65. package/dist/doctor.d.ts.map +1 -0
  66. package/dist/doctor.js +287 -0
  67. package/dist/doctor.js.map +1 -0
  68. package/dist/harness-codex.d.ts +17 -0
  69. package/dist/harness-codex.d.ts.map +1 -0
  70. package/dist/harness-codex.js +485 -0
  71. package/dist/harness-codex.js.map +1 -0
  72. package/dist/harness-mcp-bridge.d.ts +14 -0
  73. package/dist/harness-mcp-bridge.d.ts.map +1 -0
  74. package/dist/harness-mcp-bridge.js +159 -0
  75. package/dist/harness-mcp-bridge.js.map +1 -0
  76. package/dist/harness.d.ts +72 -0
  77. package/dist/harness.d.ts.map +1 -0
  78. package/dist/harness.js +101 -0
  79. package/dist/harness.js.map +1 -0
  80. package/dist/http.d.ts +20 -0
  81. package/dist/http.d.ts.map +1 -0
  82. package/dist/http.js +537 -0
  83. package/dist/http.js.map +1 -0
  84. package/dist/index.d.ts +16 -0
  85. package/dist/index.d.ts.map +1 -0
  86. package/dist/index.js +8 -0
  87. package/dist/index.js.map +1 -0
  88. package/dist/init.d.ts +73 -0
  89. package/dist/init.d.ts.map +1 -0
  90. package/dist/init.js +1039 -0
  91. package/dist/init.js.map +1 -0
  92. package/dist/mcp-apps.d.ts +9 -0
  93. package/dist/mcp-apps.d.ts.map +1 -0
  94. package/dist/mcp-apps.js +171 -0
  95. package/dist/mcp-apps.js.map +1 -0
  96. package/dist/mcp-core.d.ts +64 -0
  97. package/dist/mcp-core.d.ts.map +1 -0
  98. package/dist/mcp-core.js +358 -0
  99. package/dist/mcp-core.js.map +1 -0
  100. package/dist/mcp.d.ts +3 -0
  101. package/dist/mcp.d.ts.map +1 -0
  102. package/dist/mcp.js +2 -0
  103. package/dist/mcp.js.map +1 -0
  104. package/dist/next-browser.d.ts +14 -0
  105. package/dist/next-browser.d.ts.map +1 -0
  106. package/dist/next-browser.js +14 -0
  107. package/dist/next-browser.js.map +1 -0
  108. package/dist/next.d.ts +24 -0
  109. package/dist/next.d.ts.map +1 -0
  110. package/dist/next.js +28 -0
  111. package/dist/next.js.map +1 -0
  112. package/dist/package-version.d.ts +2 -0
  113. package/dist/package-version.d.ts.map +1 -0
  114. package/dist/package-version.js +3 -0
  115. package/dist/package-version.js.map +1 -0
  116. package/dist/publication.d.ts +115 -0
  117. package/dist/publication.d.ts.map +1 -0
  118. package/dist/publication.js +441 -0
  119. package/dist/publication.js.map +1 -0
  120. package/dist/registry.d.ts +3 -0
  121. package/dist/registry.d.ts.map +1 -0
  122. package/dist/registry.js +2 -0
  123. package/dist/registry.js.map +1 -0
  124. package/docs/adopt-existing-site.md +189 -0
  125. package/docs/browser.md +70 -0
  126. package/docs/capabilities-and-bindings.md +141 -0
  127. package/docs/cli.md +88 -0
  128. package/docs/compatibility.md +32 -0
  129. package/docs/composition-and-versioning.md +113 -0
  130. package/docs/doctor-and-troubleshooting.md +58 -0
  131. package/docs/evidence/GHSA-ch52-4w7c-c8xp-2026-10-03.md +17 -0
  132. package/docs/evidence/GHSA-ch52-4w7c-c8xp-2026-10-10.md +30 -0
  133. package/docs/evidence/GHSA-ch52-4w7c-c8xp-2026-10-12.md +10 -0
  134. package/docs/evidence/UAN-002-house-style-review.md +29 -0
  135. package/docs/evidence/UAN-007-astro.md +43 -0
  136. package/docs/evidence/UAN-008-worker-sidecar.md +56 -0
  137. package/docs/evidence/UAN-009-init.md +43 -0
  138. package/docs/evidence/UAN-010-auth.md +17 -0
  139. package/docs/evidence/UAN-011-discovery.md +18 -0
  140. package/docs/evidence/UAN-012-mcp-apps.md +14 -0
  141. package/docs/evidence/UAN-013-astro-on-demand.md +47 -0
  142. package/docs/evidence/UAN-014-next.md +57 -0
  143. package/docs/evidence/UAN-015-node-hono.md +69 -0
  144. package/docs/evidence/UAN-016-composition.md +52 -0
  145. package/docs/evidence/UAN-017-version-migrations.md +50 -0
  146. package/docs/evidence/UAN-018-surface-overrides.md +30 -0
  147. package/docs/evidence/UAN-019-doctor.md +19 -0
  148. package/docs/evidence/UAN-020-negative-security-fixtures.md +61 -0
  149. package/docs/evidence/UAN-020-operational-failure-safety.md +49 -0
  150. package/docs/evidence/UAN-021-docs-coverage.md +30 -0
  151. package/docs/evidence/UAN-022-cross-platform-license-notices.md +39 -0
  152. package/docs/evidence/UAN-022-overhead-license-audit.md +233 -0
  153. package/docs/evidence/UAN-022-package-portability.md +54 -0
  154. package/docs/evidence/UAN-023-commercial-agent-hosts.md +36 -0
  155. package/docs/evidence/UAN-023-inspector-host-probe.md +37 -0
  156. package/docs/evidence/UAN-023-inspector-web-and-astro-adoption.md +44 -0
  157. package/docs/evidence/UAN-023-native-webmcp-chrome.md +44 -0
  158. package/docs/evidence/UAN-024-release-readiness-2026-10-10.md +33 -0
  159. package/docs/evidence/UAN-024-release-readiness.md +41 -0
  160. package/docs/evidence/codex-harness.md +56 -0
  161. package/docs/evidence/gate-2-domain-expansion.md +35 -0
  162. package/docs/evidence/recovery-and-selection-recipes-2026-10-15.md +63 -0
  163. package/docs/for-agents.md +50 -0
  164. package/docs/frameworks.md +62 -0
  165. package/docs/getting-started.md +109 -0
  166. package/docs/harness-codex.md +117 -0
  167. package/docs/harness-mcp-bridge.md +30 -0
  168. package/docs/http.md +80 -0
  169. package/docs/installation.md +95 -0
  170. package/docs/mcp-apps.md +57 -0
  171. package/docs/mcp.md +178 -0
  172. package/docs/next.md +73 -0
  173. package/docs/permissions-and-discovery.md +58 -0
  174. package/docs/programmatic-harness.md +88 -0
  175. package/docs/readability-frameworks.md +18 -0
  176. package/docs/reference.md +161 -0
  177. package/docs/release-handoff.md +41 -0
  178. package/docs/site-publication.md +85 -0
  179. package/docs/stability.md +53 -0
  180. package/docs/static-sites.md +141 -0
  181. package/docs/support-and-limitations.md +20 -0
  182. package/docs/surfaces.md +27 -0
  183. package/docs/upgrading-to-1.0.md +26 -0
  184. package/package.json +188 -4
  185. package/skill/agent-native/SKILL.md +54 -0
  186. package/skill/agent-native/references/adapter-decision.md +19 -0
  187. package/skill/agent-native/references/verification.md +25 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAEL,KAAK,iBAAiB,EAEtB,KAAK,eAAe,EAGrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAqB,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,CAChB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;KAAE,KACtC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5F;AAED,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG;IAChE,QAAQ,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,yBAAyB,CAAC;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,CACnB,UAAU,EAAE,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,KAC/C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAC/B,uBAAuB,GACvB,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EACX,oBAAoB,GACpB,2BAA2B,GAC3B,eAAe,GACf,eAAe,GACf,qBAAqB,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACjD,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,IAAI,CAAC,QAAQ,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChG,OAAO,IAAI,IAAI,CAAC;CACjB;AA2PD,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,mBAAmB,GAC5B,wBAAwB,CAM1B"}
@@ -0,0 +1,219 @@
1
+ import { assertNever } from './core/assert-never.js';
2
+ import { canonicalCapabilityId } from './core/contracts.js';
3
+ import { executeCapability, } from './core/executor.js';
4
+ import { evaluateCapabilityDiscovery, isDestructiveCapabilityExposed, } from './discovery.js';
5
+ let adapters = new WeakMap();
6
+ function defaultContext() {
7
+ return {
8
+ caller: { kind: 'anonymous' },
9
+ authorization: {
10
+ authorize: (request) => request.access.kind === 'public' && request.risk === 'read',
11
+ },
12
+ };
13
+ }
14
+ function toolName(definition) {
15
+ const namespace = definition.identity.namespace;
16
+ const name = definition.identity.name;
17
+ const result = 'uan.' +
18
+ namespace.length +
19
+ '.' +
20
+ namespace +
21
+ '.' +
22
+ name.length +
23
+ '.' +
24
+ name +
25
+ '.v' +
26
+ definition.identity.majorVersion;
27
+ if (result.length > 128 || !/^[A-Za-z0-9_.-]+$/.test(result))
28
+ return undefined;
29
+ return result;
30
+ }
31
+ function safeErrorMessage(reason) {
32
+ switch (reason) {
33
+ case 'invalid-input':
34
+ return 'Capability input is invalid.';
35
+ case 'unauthorized':
36
+ return 'Capability is not authorized.';
37
+ case 'deadline-exceeded':
38
+ return 'Capability execution was cancelled.';
39
+ case 'invalid-identity':
40
+ case 'capability-missing':
41
+ case 'binding-unavailable':
42
+ case 'binding-ambiguous':
43
+ case 'authorization-error':
44
+ case 'invalid-output':
45
+ case 'handler-failed':
46
+ return 'Capability execution is unavailable.';
47
+ default:
48
+ return assertNever(reason);
49
+ }
50
+ }
51
+ function safeError(reason) {
52
+ const error = safeErrorMessage(reason);
53
+ return { ok: false, error };
54
+ }
55
+ function linkAbortSignals(signals) {
56
+ let controller = new AbortController();
57
+ let listeners = [];
58
+ for (const signal of signals) {
59
+ const listener = () => controller.abort(signal.reason);
60
+ if (signal.aborted) {
61
+ listener();
62
+ break;
63
+ }
64
+ signal.addEventListener('abort', listener, { once: true });
65
+ listeners.push({ signal, listener });
66
+ }
67
+ return {
68
+ signal: controller.signal,
69
+ dispose() {
70
+ for (const { signal, listener } of listeners) {
71
+ signal.removeEventListener('abort', listener);
72
+ }
73
+ },
74
+ };
75
+ }
76
+ class BrowserAdapter {
77
+ document;
78
+ supported;
79
+ controller;
80
+ tail = Promise.resolve();
81
+ disposed = false;
82
+ onPageHide;
83
+ lifecycleTarget;
84
+ constructor(document) {
85
+ this.document = document;
86
+ this.supported = typeof document.modelContext?.registerTool === 'function';
87
+ this.lifecycleTarget = document.defaultView ?? undefined;
88
+ this.onPageHide = () => this.dispose();
89
+ this.lifecycleTarget?.addEventListener('pagehide', this.onPageHide, { once: true });
90
+ }
91
+ sync(registry, options = {}) {
92
+ if (this.disposed)
93
+ throw new Error('Browser capability adapter has been disposed.');
94
+ const modelContext = this.document.modelContext;
95
+ if (!this.supported || modelContext === undefined) {
96
+ return Promise.resolve({ supported: false, registered: [], skipped: [] });
97
+ }
98
+ this.controller?.abort();
99
+ let controller = new AbortController();
100
+ this.controller = controller;
101
+ const pending = this.tail.then(async () => {
102
+ if (this.disposed || this.controller !== controller) {
103
+ return { supported: true, registered: [], skipped: [] };
104
+ }
105
+ let registered = [];
106
+ let skipped = [];
107
+ for (const definition of registry.definitions) {
108
+ const capabilityId = canonicalCapabilityId(definition.identity);
109
+ const bindings = registry.bindings.filter((binding) => binding.capabilityId === capabilityId && binding.targets.includes('browser'));
110
+ if (bindings.length === 0) {
111
+ skipped.push({ capabilityId, reason: 'no-browser-binding' });
112
+ continue;
113
+ }
114
+ if (bindings.length !== 1) {
115
+ skipped.push({ capabilityId, reason: 'ambiguous-browser-binding' });
116
+ continue;
117
+ }
118
+ const binding = bindings[0];
119
+ if (binding === undefined)
120
+ continue;
121
+ const tool = toolName(definition);
122
+ if (tool === undefined) {
123
+ skipped.push({ capabilityId, reason: 'name-too-long' });
124
+ continue;
125
+ }
126
+ const discovery = await evaluateCapabilityDiscovery(definition, 'browser', options.surfaceExposure, options.canExpose);
127
+ const exposed = discovery.visible;
128
+ if (!exposed) {
129
+ skipped.push({ capabilityId, reason: 'policy-denied' });
130
+ continue;
131
+ }
132
+ try {
133
+ const inputSchema = definition.input.toJSONSchema();
134
+ await modelContext.registerTool({
135
+ name: tool,
136
+ title: capabilityId,
137
+ description: definition.description,
138
+ inputSchema,
139
+ annotations: {
140
+ readOnlyHint: definition.risk === 'read',
141
+ consequentialHint: definition.risk === 'destructive',
142
+ },
143
+ execute: async (input, execution) => {
144
+ const linked = linkAbortSignals([controller.signal, execution.signal]);
145
+ try {
146
+ if (linked.signal.aborted)
147
+ return safeError('deadline-exceeded');
148
+ if (!isDestructiveCapabilityExposed(definition, 'browser', options.surfaceExposure)) {
149
+ return safeError('unauthorized');
150
+ }
151
+ let context;
152
+ try {
153
+ context = (await options.resolveExecutionContext?.()) ?? defaultContext();
154
+ }
155
+ catch {
156
+ return safeError('authorization-error');
157
+ }
158
+ if (linked.signal.aborted)
159
+ return safeError('deadline-exceeded');
160
+ const result = await executeCapability(registry, {
161
+ identity: definition.identity,
162
+ runtime: 'browser',
163
+ bindingId: binding.id,
164
+ input,
165
+ caller: context.caller,
166
+ authorization: context.authorization,
167
+ signal: linked.signal,
168
+ });
169
+ if (result.kind === 'failure')
170
+ return safeError(result.reason);
171
+ return {
172
+ ok: true,
173
+ capabilityId: result.capabilityId,
174
+ value: result.value,
175
+ };
176
+ }
177
+ finally {
178
+ linked.dispose();
179
+ }
180
+ },
181
+ }, { signal: controller.signal });
182
+ registered.push(tool);
183
+ }
184
+ catch {
185
+ if (!controller.signal.aborted) {
186
+ skipped.push({ capabilityId, reason: 'registration-failed' });
187
+ }
188
+ break;
189
+ }
190
+ if (this.controller !== controller)
191
+ break;
192
+ }
193
+ if (this.controller !== controller) {
194
+ return { supported: true, registered: [], skipped: [] };
195
+ }
196
+ return { supported: true, registered, skipped };
197
+ });
198
+ this.tail = pending.then(() => undefined, () => undefined);
199
+ return pending;
200
+ }
201
+ dispose() {
202
+ if (this.disposed)
203
+ return;
204
+ this.disposed = true;
205
+ this.controller?.abort();
206
+ this.controller = undefined;
207
+ this.lifecycleTarget?.removeEventListener('pagehide', this.onPageHide);
208
+ adapters.delete(this.document);
209
+ }
210
+ }
211
+ export function createBrowserCapabilityAdapter(document) {
212
+ const current = adapters.get(document);
213
+ if (current !== undefined)
214
+ return current;
215
+ const adapter = new BrowserAdapter(document);
216
+ adapters.set(document, adapter);
217
+ return adapter;
218
+ }
219
+ //# sourceMappingURL=browser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAA6B,MAAM,qBAAqB,CAAC;AACvF,OAAO,EACL,iBAAiB,GAMlB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,2BAA2B,EAE3B,8BAA8B,GAE/B,MAAM,gBAAgB,CAAC;AAiExB,IAAI,QAAQ,GAA8C,IAAI,OAAO,EAAE,CAAC;AAExE,SAAS,cAAc;IACrB,OAAO;QACL,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;QAC7B,aAAa,EAAE;YACb,SAAS,EAAE,CAAC,OAA6B,EAAW,EAAE,CACpD,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;SAC9D;KACF,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,UAAkD;IAClE,MAAM,SAAS,GAAW,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;IACxD,MAAM,IAAI,GAAW,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC9C,MAAM,MAAM,GACV,MAAM;QACN,SAAS,CAAC,MAAM;QAChB,GAAG;QACH,SAAS;QACT,GAAG;QACH,IAAI,CAAC,MAAM;QACX,GAAG;QACH,IAAI;QACJ,IAAI;QACJ,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC;IACnC,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,MAA4B;IACpD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,eAAe;YAClB,OAAO,8BAA8B,CAAC;QACxC,KAAK,cAAc;YACjB,OAAO,+BAA+B,CAAC;QACzC,KAAK,mBAAmB;YACtB,OAAO,qCAAqC,CAAC;QAC/C,KAAK,kBAAkB,CAAC;QACxB,KAAK,oBAAoB,CAAC;QAC1B,KAAK,qBAAqB,CAAC;QAC3B,KAAK,mBAAmB,CAAC;QACzB,KAAK,qBAAqB,CAAC;QAC3B,KAAK,gBAAgB,CAAC;QACtB,KAAK,gBAAgB;YACnB,OAAO,sCAAsC,CAAC;QAChD;YACE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,MAA4B;IAC7C,MAAM,KAAK,GAAW,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,SAAS,gBAAgB,CAAC,OAA+B;IAIvD,IAAI,UAAU,GAAoB,IAAI,eAAe,EAAE,CAAC;IACxD,IAAI,SAAS,GAAoB,EAAE,CAAC;IACpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAe,GAAS,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,QAAQ,EAAE,CAAC;YACX,MAAM;QACR,CAAC;QACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,OAAO;YACL,KAAK,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,SAAS,EAAE,CAAC;gBAC7C,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,cAAc;IAUW,QAAQ;IAT5B,SAAS,CAAU;IACpB,UAAU,CAA8B;IACxC,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IACxC,QAAQ,GAAY,KAAK,CAAC;IACjB,UAAU,CAAgB;IAC1B,eAAe,CAElB;IAEd,YAA6B,QAA6B;wBAA7B,QAAQ;QACnC,IAAI,CAAC,SAAS,GAAG,OAAO,QAAQ,CAAC,YAAY,EAAE,YAAY,KAAK,UAAU,CAAC;QAC3E,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC,WAAW,IAAI,SAAS,CAAC;QACzD,IAAI,CAAC,UAAU,GAAG,GAAS,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7C,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,IAAI,CACF,QAA4B,EAC5B,OAAO,GAA0B,EAAE;QAEnC,IAAI,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACpF,MAAM,YAAY,GAAmC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAChF,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAClD,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;QACzB,IAAI,UAAU,GAAoB,IAAI,eAAe,EAAE,CAAC;QACxD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,MAAM,OAAO,GAA+B,IAAI,CAAC,IAAI,CAAC,IAAI,CACxD,KAAK,IAAgC,EAAE;YACrC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACpD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC1D,CAAC;YACD,IAAI,UAAU,GAAa,EAAE,CAAC;YAC9B,IAAI,OAAO,GAAyB,EAAE,CAAC;YACvC,KAAK,MAAM,UAAU,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAC9C,MAAM,YAAY,GAAW,qBAAqB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACxE,MAAM,QAAQ,GAAiC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CACrE,CAAC,OAA0B,EAAW,EAAE,CACtC,OAAO,CAAC,YAAY,KAAK,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAC/E,CAAC;gBACF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC1B,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;oBAC7D,SAAS;gBACX,CAAC;gBACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC1B,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC,CAAC;oBACpE,SAAS;gBACX,CAAC;gBACD,MAAM,OAAO,GAAkC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC3D,IAAI,OAAO,KAAK,SAAS;oBAAE,SAAS;gBAEpC,MAAM,IAAI,GAAuB,QAAQ,CAAC,UAAU,CAAC,CAAC;gBACtD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACvB,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;oBACxD,SAAS;gBACX,CAAC;gBAED,MAAM,SAAS,GAAsB,MAAM,2BAA2B,CACpE,UAAU,EACV,SAAS,EACT,OAAO,CAAC,eAAe,EACvB,OAAO,CAAC,SAAS,CAClB,CAAC;gBACF,MAAM,OAAO,GAAY,SAAS,CAAC,OAAO,CAAC;gBAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;oBACxD,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,WAAW,GAAsC,UAAU,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;oBACvF,MAAM,YAAY,CAAC,YAAY,CAC7B;wBACE,IAAI,EAAE,IAAI;wBACV,KAAK,EAAE,YAAY;wBACnB,WAAW,EAAE,UAAU,CAAC,WAAW;wBACnC,WAAW;wBACX,WAAW,EAAE;4BACX,YAAY,EAAE,UAAU,CAAC,IAAI,KAAK,MAAM;4BACxC,iBAAiB,EAAE,UAAU,CAAC,IAAI,KAAK,aAAa;yBACrD;wBACD,OAAO,EAAE,KAAK,EACZ,KAAc,EACd,SAA2C,EACN,EAAE;4BACvC,MAAM,MAAM,GACV,gBAAgB,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;4BAC1D,IAAI,CAAC;gCACH,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO;oCAAE,OAAO,SAAS,CAAC,mBAAmB,CAAC,CAAC;gCACjE,IACE,CAAC,8BAA8B,CAC7B,UAAU,EACV,SAAS,EACT,OAAO,CAAC,eAAe,CACxB,EACD,CAAC;oCACD,OAAO,SAAS,CAAC,cAAc,CAAC,CAAC;gCACnC,CAAC;gCACD,IAAI,OAAgC,CAAC;gCACrC,IAAI,CAAC;oCACH,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,uBAAuB,EAAE,EAAE,CAAC,IAAI,cAAc,EAAE,CAAC;gCAC5E,CAAC;gCAAC,MAAM,CAAC;oCACP,OAAO,SAAS,CAAC,qBAAqB,CAAC,CAAC;gCAC1C,CAAC;gCACD,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO;oCAAE,OAAO,SAAS,CAAC,mBAAmB,CAAC,CAAC;gCACjE,MAAM,MAAM,GAAoB,MAAM,iBAAiB,CAAC,QAAQ,EAAE;oCAChE,QAAQ,EAAE,UAAU,CAAC,QAAQ;oCAC7B,OAAO,EAAE,SAAS;oCAClB,SAAS,EAAE,OAAO,CAAC,EAAE;oCACrB,KAAK;oCACL,MAAM,EAAE,OAAO,CAAC,MAAM;oCACtB,aAAa,EAAE,OAAO,CAAC,aAAa;oCACpC,MAAM,EAAE,MAAM,CAAC,MAAM;iCACtB,CAAC,CAAC;gCACH,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;oCAAE,OAAO,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gCAC/D,OAAO;oCACL,EAAE,EAAE,IAAI;oCACR,YAAY,EAAE,MAAM,CAAC,YAAY;oCACjC,KAAK,EAAE,MAAM,CAAC,KAAK;iCACpB,CAAC;4BACJ,CAAC;oCAAS,CAAC;gCACT,MAAM,CAAC,OAAO,EAAE,CAAC;4BACnB,CAAC;wBACH,CAAC;qBACF,EACD,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAC9B,CAAC;oBACF,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACP,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;wBAC/B,OAAO,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;oBAChE,CAAC;oBACD,MAAM;gBACR,CAAC;gBACD,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU;oBAAE,MAAM;YAC5C,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACnC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC1D,CAAC;YACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;QAClD,CAAC,CACF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CACtB,GAAc,EAAE,CAAC,SAAS,EAC1B,GAAc,EAAE,CAAC,SAAS,CAC3B,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,eAAe,EAAE,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACvE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;CACF;AAED,MAAM,UAAU,8BAA8B,CAC5C,QAA6B;IAE7B,MAAM,OAAO,GAAyC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7E,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC1C,MAAM,OAAO,GAAmB,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC7D,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,OAAO,CAAC;AACjB,CAAC"}
package/dist/cli.d.ts ADDED
@@ -0,0 +1,80 @@
1
+ import { type CapabilityDefinition } from './core/contracts.js';
2
+ import type { AuthorizationPort, ExecutionCaller } from './core/executor.js';
3
+ import type { CapabilityRegistry } from './core/registry.js';
4
+ import { type CapabilitySurfaceExposure } from './discovery.js';
5
+ export declare const CLI_RESULT_SCHEMA_VERSION: 'uan.cli-result/v1';
6
+ export declare const CLI_RESULT_JSON_SCHEMA: {
7
+ readonly $schema: 'https://json-schema.org/draft/2020-12/schema';
8
+ readonly type: 'object';
9
+ readonly properties: {
10
+ readonly schemaVersion: {
11
+ readonly const: "uan.cli-result/v1";
12
+ };
13
+ readonly target: {
14
+ readonly type: 'object';
15
+ readonly properties: {
16
+ readonly mode: {
17
+ readonly enum: readonly ['local', 'remote'];
18
+ };
19
+ readonly capabilityId: {
20
+ readonly type: 'string';
21
+ };
22
+ readonly profile: {
23
+ readonly type: 'string';
24
+ };
25
+ };
26
+ readonly additionalProperties: false;
27
+ };
28
+ readonly result: {
29
+ readonly oneOf: readonly [{
30
+ readonly type: 'object';
31
+ readonly properties: {
32
+ readonly kind: {
33
+ readonly const: 'success';
34
+ };
35
+ readonly capabilityId: {
36
+ readonly type: 'string';
37
+ };
38
+ readonly value: {};
39
+ };
40
+ readonly required: readonly ['kind', 'capabilityId', 'value'];
41
+ readonly additionalProperties: false;
42
+ }, {
43
+ readonly type: 'object';
44
+ readonly properties: {
45
+ readonly kind: {
46
+ readonly const: 'failure';
47
+ };
48
+ readonly reason: {
49
+ readonly type: 'string';
50
+ };
51
+ };
52
+ readonly required: readonly ['kind', 'reason'];
53
+ readonly additionalProperties: false;
54
+ }];
55
+ };
56
+ };
57
+ readonly required: readonly ['schemaVersion', 'target', 'result'];
58
+ readonly additionalProperties: false;
59
+ };
60
+ export type CliCredentialProfile = {
61
+ readonly baseUrl: string;
62
+ readonly token: string;
63
+ };
64
+ export interface CliStreams {
65
+ writeStdout(value: string): void;
66
+ writeStderr(value: string): void;
67
+ readStdin?(): Promise<string>;
68
+ }
69
+ export type CapabilityCliOptions = {
70
+ readonly registry: CapabilityRegistry;
71
+ readonly authorization: AuthorizationPort;
72
+ readonly caller: ExecutionCaller;
73
+ readonly credentialProfiles?: Readonly<Record<string, CliCredentialProfile>>;
74
+ readonly packageVersion?: string;
75
+ readonly fetcher?: typeof fetch;
76
+ readonly surfaceExposure?: CapabilitySurfaceExposure;
77
+ readonly canDiscover?: (definition: CapabilityDefinition<unknown, unknown>) => boolean | Promise<boolean>;
78
+ };
79
+ export declare function runCapabilityCli(argv: readonly string[], options: CapabilityCliOptions, streams: CliStreams): Promise<number>;
80
+ //# sourceMappingURL=cli.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAmB,MAAM,oBAAoB,CAAC;AAE9F,OAAO,KAAK,EAAqB,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAIhF,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,yBAAyB,EAAE,mBAAyC,CAAC;AAElF,eAAO,MAAM,sBAAsB;aACjC,OAAO,EAAE,8CAA8C;aACvD,IAAI,EAAE,QAAQ;aACd,UAAU;iBACR,aAAa;qBAAI,KAAK;;iBACtB,MAAM;qBACJ,IAAI,EAAE,QAAQ;qBACd,UAAU;yBACR,IAAI;6BAAI,IAAI,YAAG,OAAO,EAAE,QAAQ;;yBAChC,YAAY;6BAAI,IAAI,EAAE,QAAQ;;yBAC9B,OAAO;6BAAI,IAAI,EAAE,QAAQ;;;qBAE3B,oBAAoB;;iBAEtB,MAAM;qBACJ,KAAK;yBAED,IAAI,EAAE,QAAQ;yBACd,UAAU;6BACR,IAAI;iCAAI,KAAK,EAAE,SAAS;;6BACxB,YAAY;iCAAI,IAAI,EAAE,QAAQ;;6BAC9B,KAAK;;yBAEP,QAAQ,YAAG,MAAM,EAAE,cAAc,EAAE,OAAO;yBAC1C,oBAAoB;;yBAGpB,IAAI,EAAE,QAAQ;yBACd,UAAU;6BACR,IAAI;iCAAI,KAAK,EAAE,SAAS;;6BACxB,MAAM;iCAAI,IAAI,EAAE,QAAQ;;;yBAE1B,QAAQ,YAAG,MAAM,EAAE,QAAQ;yBAC3B,oBAAoB;;;;aAK5B,QAAQ,YAAG,eAAe,EAAE,QAAQ,EAAE,QAAQ;aAC9C,oBAAoB;CACZ,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,yBAAyB,CAAC;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,CACrB,UAAU,EAAE,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,KAC/C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC,CAAC;AAwYF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,CAqJjB"}