feat: Per Invocation Logs

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 50
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-d3a597bbbb25c131e2c06eb9b47d70932d14a97a6f916677a195a128e196f4db.yml
-openapi_spec_hash: c967b384624017eed0abff1b53a74530
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-5ee2116982adf46664acf84b8ba4b56ba65780983506c63d9b005dab49def757.yml
+openapi_spec_hash: 42a3a519301d0e2bb2b5a71018915b55
 config_hash: 0d150b61cae2dc57d3648ceae7784966

api.md

@@ -52,7 +52,7 @@ Methods:
 - <code title="get /invocations/{id}">client.invocations.<a href="./src/resources/invocations.ts">retrieve</a>(id) -> InvocationRetrieveResponse</code>
 - <code title="patch /invocations/{id}">client.invocations.<a href="./src/resources/invocations.ts">update</a>(id, { ...params }) -> InvocationUpdateResponse</code>
 - <code title="delete /invocations/{id}/browsers">client.invocations.<a href="./src/resources/invocations.ts">deleteBrowsers</a>(id) -> void</code>
-- <code title="get /invocations/{id}/events">client.invocations.<a href="./src/resources/invocations.ts">follow</a>(id) -> InvocationFollowResponse</code>
+- <code title="get /invocations/{id}/events">client.invocations.<a href="./src/resources/invocations.ts">follow</a>(id, { ...params }) -> InvocationFollowResponse</code>
 
 # Browsers
 

src/client.ts

@@ -35,6 +35,7 @@ import { KernelApp } from './core/app-framework';
 import {
   InvocationCreateParams,
   InvocationCreateResponse,
+  InvocationFollowParams,
   InvocationFollowResponse,
   InvocationRetrieveResponse,
   InvocationStateEvent,
@@ -870,6 +871,7 @@ export declare namespace Kernel {
     type InvocationFollowResponse as InvocationFollowResponse,
     type InvocationCreateParams as InvocationCreateParams,
     type InvocationUpdateParams as InvocationUpdateParams,
+    type InvocationFollowParams as InvocationFollowParams,
   };
 
   export {

src/resources/index.ts

@@ -33,6 +33,7 @@ export {
   type InvocationFollowResponse,
   type InvocationCreateParams,
   type InvocationUpdateParams,
+  type InvocationFollowParams,
 } from './invocations';
 export { Profiles, type ProfileListResponse, type ProfileCreateParams } from './profiles';
 export {

src/resources/invocations.ts

@@ -83,8 +83,13 @@ export class Invocations extends APIResource {
    * const response = await client.invocations.follow('id');
    * ```
    */
-  follow(id: string, options?: RequestOptions): APIPromise<Stream<InvocationFollowResponse>> {
+  follow(
+    id: string,
+    query: InvocationFollowParams | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<Stream<InvocationFollowResponse>> {
     return this._client.get(path`/invocations/${id}/events`, {
+      query,
       ...options,
       headers: buildHeaders([{ Accept: 'text/event-stream' }, options?.headers]),
       stream: true,
@@ -335,6 +340,13 @@ export interface InvocationUpdateParams {
   output?: string;
 }
 
+export interface InvocationFollowParams {
+  /**
+   * Show logs since the given time (RFC timestamps or durations like 5m).
+   */
+  since?: string;
+}
+
 export declare namespace Invocations {
   export {
     type InvocationStateEvent as InvocationStateEvent,
@@ -344,5 +356,6 @@ export declare namespace Invocations {
     type InvocationFollowResponse as InvocationFollowResponse,
     type InvocationCreateParams as InvocationCreateParams,
     type InvocationUpdateParams as InvocationUpdateParams,
+    type InvocationFollowParams as InvocationFollowParams,
   };
 }

tests/api-resources/invocations.test.ts

@@ -87,4 +87,16 @@ describe('resource invocations', () => {
     expect(dataAndResponse.data).toBe(response);
     expect(dataAndResponse.response).toBe(rawResponse);
   });
+
+  // Prism doesn't support text/event-stream responses
+  test.skip('follow: request options and params are passed correctly', async () => {
+    // ensure the request options are being passed correctly by passing an invalid HTTP method in order to cause an error
+    await expect(
+      client.invocations.follow(
+        'id',
+        { since: '2025-06-20T12:00:00Z' },
+        { path: '/_stainless_unknown_path' },
+      ),
+    ).rejects.toThrow(Kernel.NotFoundError);
+  });
 });