@the-open-engine/zeroshot 6.32.0 → 6.33.0

package/lib/hosted-target/adapter-request.mjs

@@ -1,8 +1,11 @@
 import { TargetProtocolError } from './errors.mjs';
 export function requestUrl(path, descriptor) {
-    const url = new globalThis.URL(path, descriptor.capsule.baseUrl);
-    if (url.origin !== descriptor.origin || url.hash ||
-        `${url.pathname}${url.search}` !== path) {
+    const baseUrl = new globalThis.URL(descriptor.capsule.baseUrl);
+    const requestPath = `${baseUrl.pathname.replace(/\/$/, '')}${path}`;
+    const url = new globalThis.URL(requestPath, baseUrl.origin);
+    if (url.origin !== descriptor.origin ||
+        url.hash ||
+        `${url.pathname}${url.search}` !== requestPath) {
         throw new TargetProtocolError('Capsule route changed during URL canonicalization');
     }
     return url;

package/lib/target/discovery-sections.cjs

@@ -12,6 +12,7 @@ exports.parseSession = parseSession;
 exports.parseTransport = parseTransport;
 const discovery_errors_js_1 = require("./discovery-errors.cjs");
 const discovery_validation_js_1 = require("./discovery-validation.cjs");
+const run_intent_discovery_js_1 = require("./run-intent-discovery.cjs");
 const route_template_js_1 = require("./route-template.cjs");
 function parseAdapter(discovery) {
     const adapter = (0, discovery_validation_js_1.closedRecord)(discovery.adapter, 'adapter', ['name', 'major_version']);
@@ -27,14 +28,16 @@ function parseAdapter(discovery) {
 function validateCachePolicy(discovery) {
     const cache = (0, discovery_validation_js_1.closedRecord)(discovery.cache_policy, 'cache_policy', ['control', 'discovery']);
     (0, discovery_validation_js_1.exact)(cache.control, 'no-store', 'cache_policy.control');
-    if (cache.discovery !== undefined && cache.discovery !== null &&
+    if (cache.discovery !== undefined &&
+        cache.discovery !== null &&
         typeof cache.discovery !== 'string') {
         throw new discovery_errors_js_1.TargetDiscoveryError('cache_policy.discovery must be a string or null');
     }
 }
 function parseSizes(discovery) {
     const sizes = (0, discovery_validation_js_1.closedRecord)(discovery.sizes, 'sizes', ['catalog', 'default']);
-    if (!Array.isArray(sizes.catalog) || sizes.catalog.length === 0 ||
+    if (!Array.isArray(sizes.catalog) ||
+        sizes.catalog.length === 0 ||
         new Set(sizes.catalog).size !== sizes.catalog.length ||
         sizes.catalog.some((size) => !['tiny', 'small', 'standard', 'large'].includes(String(size)))) {
         throw new discovery_errors_js_1.TargetDiscoveryError('sizes.catalog contains an unsupported size');
@@ -48,26 +51,32 @@ function parseSizes(discovery) {
     });
 }
 function parseExtensions(discovery, origin) {
-    if (discovery.extensions === undefined || discovery.extensions === null)
-        return null;
+    if (discovery.extensions === undefined || discovery.extensions === null) {
+        return Object.freeze({ credentialInstall: null, runIntent: null });
+    }
     const extensions = (0, discovery_validation_js_1.closedRecord)(discovery.extensions, 'extensions', [
-        'connections', 'credential_install',
+        'connections',
+        'credential_install',
+        'run_intent',
     ]);
     if (extensions.connections === undefined) {
         throw new discovery_errors_js_1.TargetDiscoveryError('extensions.connections is required');
     }
     const connections = (0, discovery_validation_js_1.closedRecord)(extensions.connections, 'extensions.connections', [
-        'kind', 'base_url', 'route_templates',
+        'kind',
+        'base_url',
+        'route_templates',
     ]);
     (0, discovery_validation_js_1.exact)(connections.kind, 'zerocloud.connections/v1', 'extensions.connections.kind');
     (0, discovery_validation_js_1.sameOriginUrl)(connections.base_url, 'extensions.connections.base_url', origin);
-    const routes = (0, discovery_validation_js_1.closedRecord)(connections.route_templates, 'extensions.connections.route_templates', [
-        'list', 'create', 'update',
-    ]);
+    const routes = (0, discovery_validation_js_1.closedRecord)(connections.route_templates, 'extensions.connections.route_templates', ['list', 'create', 'update']);
     (0, route_template_js_1.routeTemplate)(routes.list, 'extensions.connections.route_templates.list', []);
     (0, route_template_js_1.routeTemplate)(routes.create, 'extensions.connections.route_templates.create', []);
     (0, route_template_js_1.routeTemplate)(routes.update, 'extensions.connections.route_templates.update', ['connection_id']);
-    return (0, discovery_validation_js_1.parseCredentialInstall)(extensions.credential_install);
+    return Object.freeze({
+        credentialInstall: (0, discovery_validation_js_1.parseCredentialInstall)(extensions.credential_install),
+        runIntent: (0, run_intent_discovery_js_1.parseRunIntent)(extensions.run_intent, origin),
+    });
 }
 function validateOAuthMetadata(metadata, origin, expected) {
     const device = (0, discovery_validation_js_1.sameOriginUrl)(metadata.device_authorization_endpoint, 'OAuth metadata device_authorization_endpoint', origin);
@@ -85,7 +94,10 @@ function parseEndpoint(discovery, origin) {
     (0, discovery_validation_js_1.exact)(binding.scope, 'organization', 'binding.scope');
     (0, discovery_validation_js_1.exact)(binding.auth_location, 'authorization_header', 'binding.auth_location');
     const endpoint = (0, discovery_validation_js_1.closedRecord)(discovery.endpoint, 'endpoint', ['url', 'capabilities']);
-    const capabilities = (0, discovery_validation_js_1.exactStringSet)(endpoint.capabilities, 'endpoint.capabilities', ['exec', 'log_stream']);
+    const capabilities = (0, discovery_validation_js_1.exactStringSet)(endpoint.capabilities, 'endpoint.capabilities', [
+        'exec',
+        'log_stream',
+    ]);
     const pagination = (0, discovery_validation_js_1.closedRecord)(discovery.pagination, 'pagination', [
         'default_page_size',
         'max_page_size',
@@ -119,7 +131,14 @@ function parseCapsule(discovery, origin) {
     ]);
     (0, discovery_validation_js_1.exact)(capsule.name, 'openengine.capsules/v1', 'capsule_protocol.name');
     (0, discovery_validation_js_1.exact)(capsule.major_version, 1, 'capsule_protocol.major_version');
-    const routes = (0, discovery_validation_js_1.closedRecord)(capsule.route_templates, 'capsule_protocol.route_templates', ['allocate', 'list', 'inspect', 'terminate', 'limits', 'access']);
+    const routes = (0, discovery_validation_js_1.closedRecord)(capsule.route_templates, 'capsule_protocol.route_templates', [
+        'allocate',
+        'list',
+        'inspect',
+        'terminate',
+        'limits',
+        'access',
+    ]);
     const route = (name, variables) => (0, route_template_js_1.routeTemplate)(routes[name], `capsule_protocol.route_templates.${name}`, variables);
     return Object.freeze({
         baseUrl: (0, discovery_validation_js_1.sameOriginUrl)(capsule.base_url, 'capsule_protocol.base_url', origin),
@@ -145,7 +164,10 @@ function parseOAuth(discovery, origin) {
         'audience',
     ]);
     (0, discovery_validation_js_1.exact)(oauth.device_grant_type, 'urn:ietf:params:oauth:grant-type:device_code', 'oauth.device_grant_type');
-    (0, discovery_validation_js_1.exactStringSet)(oauth.device_exchange_fields, 'oauth.device_exchange_fields', ['device_token', 'device_label']);
+    (0, discovery_validation_js_1.exactStringSet)(oauth.device_exchange_fields, 'oauth.device_exchange_fields', [
+        'device_token',
+        'device_label',
+    ]);
     (0, discovery_validation_js_1.exact)(oauth.audience, 'capsule', 'oauth.audience');
     return Object.freeze({
         metadataUrl: (0, discovery_validation_js_1.sameOriginUrl)(oauth.metadata_url, 'oauth.metadata_url', origin),

package/lib/target/discovery-sections.d.cts

@@ -1,4 +1,5 @@
 import { type CredentialInstallDescriptor } from './discovery-validation.js';
+import { type RunIntentDescriptor } from './run-intent-discovery.js';
 export declare function parseAdapter(discovery: Record<string, unknown>): {
     readonly name: 'fargate' | 'docker' | 'local';
     readonly majorVersion: 1;
@@ -8,7 +9,10 @@ export declare function parseSizes(discovery: Record<string, unknown>): {
     readonly catalog: readonly ('tiny' | 'small' | 'standard' | 'large')[];
     readonly default: 'tiny' | 'small' | 'standard' | 'large';
 };
-export declare function parseExtensions(discovery: Record<string, unknown>, origin: string): CredentialInstallDescriptor | null;
+export declare function parseExtensions(discovery: Record<string, unknown>, origin: string): {
+    readonly credentialInstall: CredentialInstallDescriptor | null;
+    readonly runIntent: RunIntentDescriptor | null;
+};
 export declare function validateOAuthMetadata(metadata: Record<string, unknown>, origin: string, expected: readonly [string, string, string]): void;
 export declare function parseEndpoint(discovery: Record<string, unknown>, origin: string): Readonly<{
     url: string;

package/lib/target/discovery-sections.d.mts

@@ -1,4 +1,5 @@
 import { type CredentialInstallDescriptor } from './discovery-validation.js';
+import { type RunIntentDescriptor } from './run-intent-discovery.js';
 export declare function parseAdapter(discovery: Record<string, unknown>): {
     readonly name: 'fargate' | 'docker' | 'local';
     readonly majorVersion: 1;
@@ -8,7 +9,10 @@ export declare function parseSizes(discovery: Record<string, unknown>): {
     readonly catalog: readonly ('tiny' | 'small' | 'standard' | 'large')[];
     readonly default: 'tiny' | 'small' | 'standard' | 'large';
 };
-export declare function parseExtensions(discovery: Record<string, unknown>, origin: string): CredentialInstallDescriptor | null;
+export declare function parseExtensions(discovery: Record<string, unknown>, origin: string): {
+    readonly credentialInstall: CredentialInstallDescriptor | null;
+    readonly runIntent: RunIntentDescriptor | null;
+};
 export declare function validateOAuthMetadata(metadata: Record<string, unknown>, origin: string, expected: readonly [string, string, string]): void;
 export declare function parseEndpoint(discovery: Record<string, unknown>, origin: string): Readonly<{
     url: string;

package/lib/target/discovery-sections.d.ts

@@ -1,4 +1,5 @@
 import { type CredentialInstallDescriptor } from './discovery-validation.js';
+import { type RunIntentDescriptor } from './run-intent-discovery.js';
 export declare function parseAdapter(discovery: Record<string, unknown>): {
     readonly name: 'fargate' | 'docker' | 'local';
     readonly majorVersion: 1;
@@ -8,7 +9,10 @@ export declare function parseSizes(discovery: Record<string, unknown>): {
     readonly catalog: readonly ('tiny' | 'small' | 'standard' | 'large')[];
     readonly default: 'tiny' | 'small' | 'standard' | 'large';
 };
-export declare function parseExtensions(discovery: Record<string, unknown>, origin: string): CredentialInstallDescriptor | null;
+export declare function parseExtensions(discovery: Record<string, unknown>, origin: string): {
+    readonly credentialInstall: CredentialInstallDescriptor | null;
+    readonly runIntent: RunIntentDescriptor | null;
+};
 export declare function validateOAuthMetadata(metadata: Record<string, unknown>, origin: string, expected: readonly [string, string, string]): void;
 export declare function parseEndpoint(discovery: Record<string, unknown>, origin: string): Readonly<{
     url: string;

package/lib/target/discovery-sections.js

@@ -12,6 +12,7 @@ exports.parseSession = parseSession;
 exports.parseTransport = parseTransport;
 const discovery_errors_js_1 = require("./discovery-errors.js");
 const discovery_validation_js_1 = require("./discovery-validation.js");
+const run_intent_discovery_js_1 = require("./run-intent-discovery.js");
 const route_template_js_1 = require("./route-template.js");
 function parseAdapter(discovery) {
     const adapter = (0, discovery_validation_js_1.closedRecord)(discovery.adapter, 'adapter', ['name', 'major_version']);
@@ -27,14 +28,16 @@ function parseAdapter(discovery) {
 function validateCachePolicy(discovery) {
     const cache = (0, discovery_validation_js_1.closedRecord)(discovery.cache_policy, 'cache_policy', ['control', 'discovery']);
     (0, discovery_validation_js_1.exact)(cache.control, 'no-store', 'cache_policy.control');
-    if (cache.discovery !== undefined && cache.discovery !== null &&
+    if (cache.discovery !== undefined &&
+        cache.discovery !== null &&
         typeof cache.discovery !== 'string') {
         throw new discovery_errors_js_1.TargetDiscoveryError('cache_policy.discovery must be a string or null');
     }
 }
 function parseSizes(discovery) {
     const sizes = (0, discovery_validation_js_1.closedRecord)(discovery.sizes, 'sizes', ['catalog', 'default']);
-    if (!Array.isArray(sizes.catalog) || sizes.catalog.length === 0 ||
+    if (!Array.isArray(sizes.catalog) ||
+        sizes.catalog.length === 0 ||
         new Set(sizes.catalog).size !== sizes.catalog.length ||
         sizes.catalog.some((size) => !['tiny', 'small', 'standard', 'large'].includes(String(size)))) {
         throw new discovery_errors_js_1.TargetDiscoveryError('sizes.catalog contains an unsupported size');
@@ -48,26 +51,32 @@ function parseSizes(discovery) {
     });
 }
 function parseExtensions(discovery, origin) {
-    if (discovery.extensions === undefined || discovery.extensions === null)
-        return null;
+    if (discovery.extensions === undefined || discovery.extensions === null) {
+        return Object.freeze({ credentialInstall: null, runIntent: null });
+    }
     const extensions = (0, discovery_validation_js_1.closedRecord)(discovery.extensions, 'extensions', [
-        'connections', 'credential_install',
+        'connections',
+        'credential_install',
+        'run_intent',
     ]);
     if (extensions.connections === undefined) {
         throw new discovery_errors_js_1.TargetDiscoveryError('extensions.connections is required');
     }
     const connections = (0, discovery_validation_js_1.closedRecord)(extensions.connections, 'extensions.connections', [
-        'kind', 'base_url', 'route_templates',
+        'kind',
+        'base_url',
+        'route_templates',
     ]);
     (0, discovery_validation_js_1.exact)(connections.kind, 'zerocloud.connections/v1', 'extensions.connections.kind');
     (0, discovery_validation_js_1.sameOriginUrl)(connections.base_url, 'extensions.connections.base_url', origin);
-    const routes = (0, discovery_validation_js_1.closedRecord)(connections.route_templates, 'extensions.connections.route_templates', [
-        'list', 'create', 'update',
-    ]);
+    const routes = (0, discovery_validation_js_1.closedRecord)(connections.route_templates, 'extensions.connections.route_templates', ['list', 'create', 'update']);
     (0, route_template_js_1.routeTemplate)(routes.list, 'extensions.connections.route_templates.list', []);
     (0, route_template_js_1.routeTemplate)(routes.create, 'extensions.connections.route_templates.create', []);
     (0, route_template_js_1.routeTemplate)(routes.update, 'extensions.connections.route_templates.update', ['connection_id']);
-    return (0, discovery_validation_js_1.parseCredentialInstall)(extensions.credential_install);
+    return Object.freeze({
+        credentialInstall: (0, discovery_validation_js_1.parseCredentialInstall)(extensions.credential_install),
+        runIntent: (0, run_intent_discovery_js_1.parseRunIntent)(extensions.run_intent, origin),
+    });
 }
 function validateOAuthMetadata(metadata, origin, expected) {
     const device = (0, discovery_validation_js_1.sameOriginUrl)(metadata.device_authorization_endpoint, 'OAuth metadata device_authorization_endpoint', origin);
@@ -85,7 +94,10 @@ function parseEndpoint(discovery, origin) {
     (0, discovery_validation_js_1.exact)(binding.scope, 'organization', 'binding.scope');
     (0, discovery_validation_js_1.exact)(binding.auth_location, 'authorization_header', 'binding.auth_location');
     const endpoint = (0, discovery_validation_js_1.closedRecord)(discovery.endpoint, 'endpoint', ['url', 'capabilities']);
-    const capabilities = (0, discovery_validation_js_1.exactStringSet)(endpoint.capabilities, 'endpoint.capabilities', ['exec', 'log_stream']);
+    const capabilities = (0, discovery_validation_js_1.exactStringSet)(endpoint.capabilities, 'endpoint.capabilities', [
+        'exec',
+        'log_stream',
+    ]);
     const pagination = (0, discovery_validation_js_1.closedRecord)(discovery.pagination, 'pagination', [
         'default_page_size',
         'max_page_size',
@@ -119,7 +131,14 @@ function parseCapsule(discovery, origin) {
     ]);
     (0, discovery_validation_js_1.exact)(capsule.name, 'openengine.capsules/v1', 'capsule_protocol.name');
     (0, discovery_validation_js_1.exact)(capsule.major_version, 1, 'capsule_protocol.major_version');
-    const routes = (0, discovery_validation_js_1.closedRecord)(capsule.route_templates, 'capsule_protocol.route_templates', ['allocate', 'list', 'inspect', 'terminate', 'limits', 'access']);
+    const routes = (0, discovery_validation_js_1.closedRecord)(capsule.route_templates, 'capsule_protocol.route_templates', [
+        'allocate',
+        'list',
+        'inspect',
+        'terminate',
+        'limits',
+        'access',
+    ]);
     const route = (name, variables) => (0, route_template_js_1.routeTemplate)(routes[name], `capsule_protocol.route_templates.${name}`, variables);
     return Object.freeze({
         baseUrl: (0, discovery_validation_js_1.sameOriginUrl)(capsule.base_url, 'capsule_protocol.base_url', origin),
@@ -145,7 +164,10 @@ function parseOAuth(discovery, origin) {
         'audience',
     ]);
     (0, discovery_validation_js_1.exact)(oauth.device_grant_type, 'urn:ietf:params:oauth:grant-type:device_code', 'oauth.device_grant_type');
-    (0, discovery_validation_js_1.exactStringSet)(oauth.device_exchange_fields, 'oauth.device_exchange_fields', ['device_token', 'device_label']);
+    (0, discovery_validation_js_1.exactStringSet)(oauth.device_exchange_fields, 'oauth.device_exchange_fields', [
+        'device_token',
+        'device_label',
+    ]);
     (0, discovery_validation_js_1.exact)(oauth.audience, 'capsule', 'oauth.audience');
     return Object.freeze({
         metadataUrl: (0, discovery_validation_js_1.sameOriginUrl)(oauth.metadata_url, 'oauth.metadata_url', origin),

package/lib/target/discovery-sections.mjs

@@ -1,5 +1,6 @@
 import { TargetDiscoveryError } from './discovery-errors.mjs';
 import { closedRecord, exact, exactStringSet, integer, parseCredentialInstall, sameOriginUrl, stringField, } from './discovery-validation.mjs';
+import { parseRunIntent } from './run-intent-discovery.mjs';
 import { routeTemplate } from './route-template.mjs';
 export function parseAdapter(discovery) {
     const adapter = closedRecord(discovery.adapter, 'adapter', ['name', 'major_version']);
@@ -15,14 +16,16 @@ export function parseAdapter(discovery) {
 export function validateCachePolicy(discovery) {
     const cache = closedRecord(discovery.cache_policy, 'cache_policy', ['control', 'discovery']);
     exact(cache.control, 'no-store', 'cache_policy.control');
-    if (cache.discovery !== undefined && cache.discovery !== null &&
+    if (cache.discovery !== undefined &&
+        cache.discovery !== null &&
         typeof cache.discovery !== 'string') {
         throw new TargetDiscoveryError('cache_policy.discovery must be a string or null');
     }
 }
 export function parseSizes(discovery) {
     const sizes = closedRecord(discovery.sizes, 'sizes', ['catalog', 'default']);
-    if (!Array.isArray(sizes.catalog) || sizes.catalog.length === 0 ||
+    if (!Array.isArray(sizes.catalog) ||
+        sizes.catalog.length === 0 ||
         new Set(sizes.catalog).size !== sizes.catalog.length ||
         sizes.catalog.some((size) => !['tiny', 'small', 'standard', 'large'].includes(String(size)))) {
         throw new TargetDiscoveryError('sizes.catalog contains an unsupported size');
@@ -36,26 +39,32 @@ export function parseSizes(discovery) {
     });
 }
 export function parseExtensions(discovery, origin) {
-    if (discovery.extensions === undefined || discovery.extensions === null)
-        return null;
+    if (discovery.extensions === undefined || discovery.extensions === null) {
+        return Object.freeze({ credentialInstall: null, runIntent: null });
+    }
     const extensions = closedRecord(discovery.extensions, 'extensions', [
-        'connections', 'credential_install',
+        'connections',
+        'credential_install',
+        'run_intent',
     ]);
     if (extensions.connections === undefined) {
         throw new TargetDiscoveryError('extensions.connections is required');
     }
     const connections = closedRecord(extensions.connections, 'extensions.connections', [
-        'kind', 'base_url', 'route_templates',
+        'kind',
+        'base_url',
+        'route_templates',
     ]);
     exact(connections.kind, 'zerocloud.connections/v1', 'extensions.connections.kind');
     sameOriginUrl(connections.base_url, 'extensions.connections.base_url', origin);
-    const routes = closedRecord(connections.route_templates, 'extensions.connections.route_templates', [
-        'list', 'create', 'update',
-    ]);
+    const routes = closedRecord(connections.route_templates, 'extensions.connections.route_templates', ['list', 'create', 'update']);
     routeTemplate(routes.list, 'extensions.connections.route_templates.list', []);
     routeTemplate(routes.create, 'extensions.connections.route_templates.create', []);
     routeTemplate(routes.update, 'extensions.connections.route_templates.update', ['connection_id']);
-    return parseCredentialInstall(extensions.credential_install);
+    return Object.freeze({
+        credentialInstall: parseCredentialInstall(extensions.credential_install),
+        runIntent: parseRunIntent(extensions.run_intent, origin),
+    });
 }
 export function validateOAuthMetadata(metadata, origin, expected) {
     const device = sameOriginUrl(metadata.device_authorization_endpoint, 'OAuth metadata device_authorization_endpoint', origin);
@@ -73,7 +82,10 @@ export function parseEndpoint(discovery, origin) {
     exact(binding.scope, 'organization', 'binding.scope');
     exact(binding.auth_location, 'authorization_header', 'binding.auth_location');
     const endpoint = closedRecord(discovery.endpoint, 'endpoint', ['url', 'capabilities']);
-    const capabilities = exactStringSet(endpoint.capabilities, 'endpoint.capabilities', ['exec', 'log_stream']);
+    const capabilities = exactStringSet(endpoint.capabilities, 'endpoint.capabilities', [
+        'exec',
+        'log_stream',
+    ]);
     const pagination = closedRecord(discovery.pagination, 'pagination', [
         'default_page_size',
         'max_page_size',
@@ -107,7 +119,14 @@ export function parseCapsule(discovery, origin) {
     ]);
     exact(capsule.name, 'openengine.capsules/v1', 'capsule_protocol.name');
     exact(capsule.major_version, 1, 'capsule_protocol.major_version');
-    const routes = closedRecord(capsule.route_templates, 'capsule_protocol.route_templates', ['allocate', 'list', 'inspect', 'terminate', 'limits', 'access']);
+    const routes = closedRecord(capsule.route_templates, 'capsule_protocol.route_templates', [
+        'allocate',
+        'list',
+        'inspect',
+        'terminate',
+        'limits',
+        'access',
+    ]);
     const route = (name, variables) => routeTemplate(routes[name], `capsule_protocol.route_templates.${name}`, variables);
     return Object.freeze({
         baseUrl: sameOriginUrl(capsule.base_url, 'capsule_protocol.base_url', origin),
@@ -133,7 +152,10 @@ export function parseOAuth(discovery, origin) {
         'audience',
     ]);
     exact(oauth.device_grant_type, 'urn:ietf:params:oauth:grant-type:device_code', 'oauth.device_grant_type');
-    exactStringSet(oauth.device_exchange_fields, 'oauth.device_exchange_fields', ['device_token', 'device_label']);
+    exactStringSet(oauth.device_exchange_fields, 'oauth.device_exchange_fields', [
+        'device_token',
+        'device_label',
+    ]);
     exact(oauth.audience, 'capsule', 'oauth.audience');
     return Object.freeze({
         metadataUrl: sameOriginUrl(oauth.metadata_url, 'oauth.metadata_url', origin),

package/lib/target/discovery.cjs

@@ -33,52 +33,27 @@ const ROOT_FIELDS = [
     'transport',
     'extensions',
 ];
-async function readBoundedJson(response) {
-    return (0, bounded_response_js_1.readBoundedResponseJson)(response, MAX_DISCOVERY_BYTES, (kind) => new discovery_errors_js_1.TargetDiscoveryError(kind === 'size' ? 'response exceeds the size limit' : 'response is not valid UTF-8 JSON'));
-}
-async function fetchDocument(http, url) {
-    const response = await http.fetch(url, {
-        method: 'GET',
-        headers: { Accept: 'application/json' },
-        redirect: 'error',
-    });
-    if (response.url && new URL(response.url).href !== url) {
-        await response.body?.cancel().catch(() => undefined);
-        throw new discovery_errors_js_1.TargetDiscoveryError('request changed target route or authority');
-    }
-    if (!response.ok) {
-        await response.body?.cancel().catch(() => undefined);
-        throw new discovery_errors_js_1.TargetDiscoveryError(`request failed with status ${response.status}`);
-    }
-    return (0, discovery_validation_js_1.record)(await readBoundedJson(response), 'response');
-}
-async function discoverTarget(targetUrl, http) {
-    const target = new URL(targetUrl);
-    const origin = target.origin;
-    const discovery = await fetchDocument(http, new URL(DISCOVERY_PATH, target).href);
+const FLAGS = [
+    'capsule_allocate',
+    'capsule_read',
+    'capsule_terminate',
+    'capsule_access',
+    'connections_onboarding',
+];
+const SIZE_ERROR = 'response exceeds the size limit';
+const JSON_ERROR = 'response is not valid UTF-8 JSON';
+function parseDiscoveryDocument(discovery, origin) {
     (0, discovery_validation_js_1.exact)(discovery.kind, 'openengine.hosted-target/v1', 'kind');
     const adapter = (0, discovery_sections_js_1.parseAdapter)(discovery);
     const endpoint = (0, discovery_sections_js_1.parseEndpoint)(discovery, origin);
     const capsule = (0, discovery_sections_js_1.parseCapsule)(discovery, origin);
     const oauth = (0, discovery_sections_js_1.parseOAuth)(discovery, origin);
     (0, discovery_validation_js_1.exact)(discovery.organization_binding, 'device_approval', 'organization_binding');
-    const capabilityFlags = (0, discovery_validation_js_1.exactStringSet)(discovery.capability_flags, 'capability_flags', [
-        'capsule_allocate',
-        'capsule_read',
-        'capsule_terminate',
-        'capsule_access',
-        'connections_onboarding',
-    ]);
+    const capabilityFlags = (0, discovery_validation_js_1.exactStringSet)(discovery.capability_flags, 'capability_flags', FLAGS);
     const sizes = (0, discovery_sections_js_1.parseSizes)(discovery);
     const session = (0, discovery_sections_js_1.parseSession)(discovery);
     const transport = (0, discovery_sections_js_1.parseTransport)(discovery);
-    const credentialInstall = (0, discovery_sections_js_1.parseExtensions)(discovery, origin);
-    const metadata = await fetchDocument(http, oauth.metadataUrl);
-    (0, discovery_sections_js_1.validateOAuthMetadata)(metadata, origin, [
-        oauth.deviceAuthorizationEndpoint,
-        oauth.tokenEndpoint,
-        oauth.revocationEndpoint,
-    ]);
+    const extensions = (0, discovery_sections_js_1.parseExtensions)(discovery, origin);
     const additional = Object.freeze(Object.fromEntries(Object.entries(discovery).filter(([key]) => !ROOT_FIELDS.includes(key))));
     return Object.freeze({
         origin,
@@ -92,10 +67,24 @@ async function discoverTarget(targetUrl, http) {
         capsule,
         transport,
         capabilityFlags,
-        credentialInstall,
+        credentialInstall: extensions.credentialInstall,
+        runIntent: extensions.runIntent,
         additional,
     });
 }
+async function discoverTarget(targetUrl, http) {
+    const target = new URL(targetUrl);
+    const origin = target.origin;
+    const discovery = await fetchDocument(http, new URL(DISCOVERY_PATH, target).href);
+    const descriptor = parseDiscoveryDocument(discovery, origin);
+    const metadata = await fetchDocument(http, descriptor.oauth.metadataUrl);
+    (0, discovery_sections_js_1.validateOAuthMetadata)(metadata, origin, [
+        descriptor.oauth.deviceAuthorizationEndpoint,
+        descriptor.oauth.tokenEndpoint,
+        descriptor.oauth.revocationEndpoint,
+    ]);
+    return descriptor;
+}
 async function discoverTargetSessionEndpoints(targetUrl, http) {
     const descriptor = await discoverTarget(targetUrl, http);
     return Object.freeze({
@@ -110,3 +99,25 @@ async function discoverTargetSessionEndpoints(targetUrl, http) {
         descriptor,
     });
 }
+function boundedResponseError(kind) {
+    return new discovery_errors_js_1.TargetDiscoveryError(kind === 'size' ? SIZE_ERROR : JSON_ERROR);
+}
+async function readBoundedJson(response) {
+    return (0, bounded_response_js_1.readBoundedResponseJson)(response, MAX_DISCOVERY_BYTES, boundedResponseError);
+}
+async function fetchDocument(http, url) {
+    const response = await http.fetch(url, {
+        method: 'GET',
+        headers: { Accept: 'application/json' },
+        redirect: 'error',
+    });
+    if (response.url && new URL(response.url).href !== url) {
+        await response.body?.cancel().catch(() => undefined);
+        throw new discovery_errors_js_1.TargetDiscoveryError('request changed target route or authority');
+    }
+    if (!response.ok) {
+        await response.body?.cancel().catch(() => undefined);
+        throw new discovery_errors_js_1.TargetDiscoveryError(`request failed with status ${response.status}`);
+    }
+    return (0, discovery_validation_js_1.record)(await readBoundedJson(response), 'response');
+}

package/lib/target/discovery.d.cts

@@ -1,7 +1,9 @@
 import type { HttpTransport } from './device-flow.js';
 import type { RouteTemplate } from './route-template.js';
 import { type CredentialInstallDescriptor } from './discovery-validation.js';
+import type { RunIntentDescriptor } from './run-intent-discovery.js';
 export type { CredentialInstallDescriptor } from './discovery-validation.js';
+export type { RunIntentDescriptor } from './run-intent-discovery.js';
 export { TargetDiscoveryError } from './discovery-errors.js';
 export { expandRoute, type RouteTemplate } from './route-template.js';
 declare const DEVICE_GRANT = "urn:ietf:params:oauth:grant-type:device_code";
@@ -56,6 +58,7 @@ export interface TargetDiscoveryDescriptor {
     };
     readonly capabilityFlags: readonly string[];
     readonly credentialInstall: CredentialInstallDescriptor | null;
+    readonly runIntent: RunIntentDescriptor | null;
     readonly additional: Readonly<Record<string, unknown>>;
 }
 /** Compatibility projection. New callers should retain the complete descriptor. */

package/lib/target/discovery.d.mts

@@ -1,7 +1,9 @@
 import type { HttpTransport } from './device-flow.js';
 import type { RouteTemplate } from './route-template.js';
 import { type CredentialInstallDescriptor } from './discovery-validation.js';
+import type { RunIntentDescriptor } from './run-intent-discovery.js';
 export type { CredentialInstallDescriptor } from './discovery-validation.js';
+export type { RunIntentDescriptor } from './run-intent-discovery.js';
 export { TargetDiscoveryError } from './discovery-errors.js';
 export { expandRoute, type RouteTemplate } from './route-template.js';
 declare const DEVICE_GRANT = "urn:ietf:params:oauth:grant-type:device_code";
@@ -56,6 +58,7 @@ export interface TargetDiscoveryDescriptor {
     };
     readonly capabilityFlags: readonly string[];
     readonly credentialInstall: CredentialInstallDescriptor | null;
+    readonly runIntent: RunIntentDescriptor | null;
     readonly additional: Readonly<Record<string, unknown>>;
 }
 /** Compatibility projection. New callers should retain the complete descriptor. */

package/lib/target/discovery.d.ts

@@ -1,7 +1,9 @@
 import type { HttpTransport } from './device-flow.js';
 import type { RouteTemplate } from './route-template.js';
 import { type CredentialInstallDescriptor } from './discovery-validation.js';
+import type { RunIntentDescriptor } from './run-intent-discovery.js';
 export type { CredentialInstallDescriptor } from './discovery-validation.js';
+export type { RunIntentDescriptor } from './run-intent-discovery.js';
 export { TargetDiscoveryError } from './discovery-errors.js';
 export { expandRoute, type RouteTemplate } from './route-template.js';
 declare const DEVICE_GRANT = "urn:ietf:params:oauth:grant-type:device_code";
@@ -56,6 +58,7 @@ export interface TargetDiscoveryDescriptor {
     };
     readonly capabilityFlags: readonly string[];
     readonly credentialInstall: CredentialInstallDescriptor | null;
+    readonly runIntent: RunIntentDescriptor | null;
     readonly additional: Readonly<Record<string, unknown>>;
 }
 /** Compatibility projection. New callers should retain the complete descriptor. */