feat: Polish and publish the Config Registry API

Stainless-Generated-From: 3d8a50cc016bcb9c3bf48df787a8dcdd23acdebf

Author: kernel-internal[bot]

.stats.yml

@@ -1 +1 @@
-configured_endpoints: 163
+configured_endpoints: 164

api.md

@@ -93,6 +93,7 @@ Methods:
 
 - <code title="get /config-registry/analyses/{id}">client.configRegistry.analyses.<a href="./src/resources/config-registry/analyses.ts">retrieve</a>(id) -> ConfigRegistryResponse</code>
 - <code title="get /config-registry/analyses">client.configRegistry.analyses.<a href="./src/resources/config-registry/analyses.ts">list</a>({ ...params }) -> AnalysisSummariesOffsetPagination</code>
+- <code title="post /config-registry/analyses/{id}/cancel">client.configRegistry.analyses.<a href="./src/resources/config-registry/analyses.ts">cancel</a>(id) -> ConfigRegistryResponse</code>
 
 # Browsers
 

src/resources/config-registry/analyses.ts

@@ -47,6 +47,22 @@ export class Analyses extends APIResource {
       { query, ...options },
     );
   }
+
+  /**
+   * Requests cancellation of a running project-scoped analysis. Cancellation is
+   * asynchronous; poll the analysis until its status becomes canceled. Repeating the
+   * request after the analysis reaches a terminal state returns the existing
+   * outcome.
+   *
+   * @example
+   * ```ts
+   * const configRegistryResponse =
+   *   await client.configRegistry.analyses.cancel('id');
+   * ```
+   */
+  cancel(id: string, options?: RequestOptions): APIPromise<ConfigRegistryAPI.ConfigRegistryResponse> {
+    return this._client.post(path`/config-registry/analyses/${id}/cancel`, options);
+  }
 }
 
 export interface AnalysisListParams extends OffsetPaginationParams {

src/resources/config-registry/config-registry.ts

@@ -214,11 +214,11 @@ export interface Evidence {
   success_rate: number;
 
   /**
-   * Most recent contributing run where this config met the success threshold.
-   * Omitted for knowledge assembled from runs that did not independently meet the
-   * threshold.
+   * Most recent contributing run whose evidence supported recommending this
+   * configuration. Omitted when no individual run independently met the
+   * recommendation threshold.
    */
-  last_verified_at?: string | null;
+  last_supported_at?: string | null;
 }
 
 export interface LookupRequest {
@@ -459,7 +459,9 @@ export interface Recommendation {
   evidence: Evidence;
 
   /**
-   * Specificity of knowledge matched for this recommendation.
+   * Specificity of knowledge matched for this recommendation. Exact matches use
+   * knowledge for the requested target; host and domain matches use broader fallback
+   * knowledge.
    */
   match_scope: 'exact' | 'host' | 'domain';
 
@@ -474,13 +476,6 @@ export interface Recommendation {
   proxy: Proxy;
 
   type: 'recommendation';
-
-  /**
-   * Exact matches meet the evidence threshold; host and domain fallbacks are
-   * inferred. Check evidence.last_verified_at for successful verification age and
-   * last_observed_at for the latest evidence.
-   */
-  verification: 'verified' | 'inferred';
 }
 
 /**
@@ -548,8 +543,9 @@ export interface ResolveRequest {
    * any non-HTTPS destination as off-site and will not drive an http one. Kernel
    * uses it to drive the browser further into the site, where it can observe
    * protections that only appear once a session interacts. When this target already
-   * has a verified configuration, the run confirms that one instead of re-deriving
-   * the whole matrix, so supplying an intent narrows what can be recommended.
+   * has a recommended configuration, the run confirms that one instead of
+   * re-deriving the whole matrix, so supplying an intent narrows what can be
+   * recommended.
    */
   intent?: string;
 }
@@ -615,8 +611,9 @@ export interface ConfigRegistryResolveParams {
    * any non-HTTPS destination as off-site and will not drive an http one. Kernel
    * uses it to drive the browser further into the site, where it can observe
    * protections that only appear once a session interacts. When this target already
-   * has a verified configuration, the run confirms that one instead of re-deriving
-   * the whole matrix, so supplying an intent narrows what can be recommended.
+   * has a recommended configuration, the run confirms that one instead of
+   * re-deriving the whole matrix, so supplying an intent narrows what can be
+   * recommended.
    */
   intent?: string;
 }

tests/api-resources/config-registry/analyses.test.ts

@@ -46,4 +46,16 @@ describe('resource analyses', () => {
       ),
     ).rejects.toThrow(Kernel.NotFoundError);
   });
+
+  // Mock server tests are disabled
+  test.skip('cancel', async () => {
+    const responsePromise = client.configRegistry.analyses.cancel('id');
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
 });