From 08ee58d11561518781860639546e82e5edab6a4e Mon Sep 17 00:00:00 2001 From: masnwilliams <43387599+masnwilliams@users.noreply.github.com> Date: Thu, 12 Nov 2026 20:50:18 +0000 Subject: [PATCH 1/9] Audit regenerated MCP coverage from the branch's starting SDK version --- .github/workflows/update-mcp-coverage.yml | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/.github/workflows/update-mcp-coverage.yml b/.github/workflows/update-mcp-coverage.yml index c28dba9e..d3a1feb9 100644 --- a/.github/workflows/update-mcp-coverage.yml +++ b/.github/workflows/update-mcp-coverage.yml @@ -100,20 +100,27 @@ jobs: git config user.name 'kernel-internal[bot]' git config user.email '260533166+kernel-internal[bot]@users.noreply.github.com' echo "main_sha=$(git rev-parse origin/main)" >> "$GITHUB_OUTPUT" + baseline_ref=origin/main if git show-ref --verify --quiet "refs/remotes/origin/$UPDATE_BRANCH"; then echo "update_sha=$(git rev-parse "origin/$UPDATE_BRANCH")" >> "$GITHUB_OUTPUT" git switch --track "origin/$UPDATE_BRANCH" if ! git rebase origin/main; then + stopped_at=$(git log -1 --format='%h %s' REBASE_HEAD 2>/dev/null || true) + conflicts=$(git diff --name-only --diff-filter=U | paste -sd ' ' -) git rebase --abort - # The agent covers everything since main's SDK version, so a bot-only - # branch can be regenerated from main. Human commits must be kept. - if git log --no-merges --format=%ae "origin/main..origin/$UPDATE_BRANCH" \ - | grep -qvxF '260533166+kernel-internal[bot]@users.noreply.github.com'; then - echo "::error::$UPDATE_BRANCH has human commits that conflict with main. Resolve the conflicts on that branch, then rerun this workflow." + # A bot-only branch can be regenerated from main. Human commits must be kept. + human=$(git log --no-merges --format='%h %ae %s' "origin/main..origin/$UPDATE_BRANCH" \ + | awk '$2 != "260533166+kernel-internal[bot]@users.noreply.github.com"') + if [[ -n "$human" ]]; then + echo "::error::$UPDATE_BRANCH conflicts with main at $stopped_at ($conflicts) and has human commits, so it cannot be regenerated. Rebase it onto main by hand, keeping these commits, then rerun this workflow:" + printf '%s\n' "$human" exit 1 fi - echo "::warning::$UPDATE_BRANCH conflicts with main; regenerating it from main." + echo "::warning::$UPDATE_BRANCH conflicts with main at $stopped_at ($conflicts); regenerating it from main." git switch -C "$UPDATE_BRANCH" origin/main + # The dropped commits may cover SDK releases that main skipped when its + # SDK was bumped directly, so audit from where the branch started. + baseline_ref=$(git merge-base origin/main "origin/$UPDATE_BRANCH") else echo "rebased=true" >> "$GITHUB_OUTPUT" fi @@ -134,8 +141,8 @@ jobs: fi # The report replaces the PR description, so audit every release since - # main's SDK version, not only the ones since the last run. - old_version=$(git show origin/main:package.json | jq -er '.dependencies["@onkernel/sdk"]') + # the baseline's SDK version, not only the ones since the last run. + old_version=$(git show "$baseline_ref:package.json" | jq -er '.dependencies["@onkernel/sdk"]') if git -C ../sdk rev-parse --verify "refs/tags/v$old_version" >/dev/null 2>&1; then git -C ../sdk diff "refs/tags/v$old_version" "$SDK_SHA" \ -- api.md src/client.ts src/lib src/resources > "$RUNNER_TEMP/sdk-diff.patch" From c8c948b02f0859ccacad70ab05b69c1695542c40 Mon Sep 17 00:00:00 2001 From: masnwilliams <43387599+masnwilliams@users.noreply.github.com> Date: Thu, 12 Nov 2026 20:51:58 +0000 Subject: [PATCH 2/9] Keep the bot-author check the updater security test pins --- .github/workflows/update-mcp-coverage.yml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/.github/workflows/update-mcp-coverage.yml b/.github/workflows/update-mcp-coverage.yml index d3a1feb9..4c487dfe 100644 --- a/.github/workflows/update-mcp-coverage.yml +++ b/.github/workflows/update-mcp-coverage.yml @@ -109,11 +109,11 @@ jobs: conflicts=$(git diff --name-only --diff-filter=U | paste -sd ' ' -) git rebase --abort # A bot-only branch can be regenerated from main. Human commits must be kept. - human=$(git log --no-merges --format='%h %ae %s' "origin/main..origin/$UPDATE_BRANCH" \ - | awk '$2 != "260533166+kernel-internal[bot]@users.noreply.github.com"') - if [[ -n "$human" ]]; then + if git log --no-merges --format=%ae "origin/main..origin/$UPDATE_BRANCH" \ + | grep -qvxF '260533166+kernel-internal[bot]@users.noreply.github.com'; then echo "::error::$UPDATE_BRANCH conflicts with main at $stopped_at ($conflicts) and has human commits, so it cannot be regenerated. Rebase it onto main by hand, keeping these commits, then rerun this workflow:" - printf '%s\n' "$human" + git log --no-merges --format='%h %ae %s' "origin/main..origin/$UPDATE_BRANCH" \ + | grep -vF ' 260533166+kernel-internal[bot]@users.noreply.github.com ' exit 1 fi echo "::warning::$UPDATE_BRANCH conflicts with main at $stopped_at ($conflicts); regenerating it from main." From e9cc303d2b7e02e8292b6a79b969e8b086eef002 Mon Sep 17 00:00:00 2001 From: "kernel-internal[bot]" <260533166+kernel-internal[bot]@users.noreply.github.com> Date: Fri, 13 Nov 2026 00:42:51 +0000 Subject: [PATCH 3/9] Build SDK Stainless-Generated-From: ff07542209cb21ce43563832867d637031305c63 --- src/resources/vaults/items.ts | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/src/resources/vaults/items.ts b/src/resources/vaults/items.ts index fe5d4636..94eb901b 100644 --- a/src/resources/vaults/items.ts +++ b/src/resources/vaults/items.ts @@ -276,8 +276,19 @@ export interface AgentcardCheckoutAuthorization { */ amount?: string; - amount_authority?: 'display_only' | 'stripe_payment_intent'; + /** + * Source of the approved amount. `processor` is read from the processor request or + * payment; `agent` is the item's declared amount; `page` is the checkout page + * total; `none` means no amount was named. `display_only` appears only on + * authorizations recovered without a provider read. `agent` and `display_only` + * don't prove what the processor charged. + */ + amount_authority?: 'processor' | 'agent' | 'page' | 'none' | 'display_only'; + /** + * Whether the processor charged the approved amount. Absent when there was no + * charge to compare, including tokenization checkouts. + */ amount_verified?: boolean; approval_url?: string; @@ -287,10 +298,24 @@ export interface AgentcardCheckoutAuthorization { */ browser_id?: string; + /** + * Amount the processor reported collecting. Absent when the provider didn't + * observe a charge. + */ charged_amount_cents?: number; + /** + * Currency of `charged_amount_cents`. Absent when the provider didn't observe a + * charge. + */ charged_currency?: string; + /** + * What the processor collected. `none` means the checkout produced a token or + * payment method that the merchant charges later. Absent when the provider + * reported nothing, which is common for tokenization checkouts; use item events + * and the merchant's order record instead. + */ charged_kind?: 'captured' | 'authorized' | 'none'; expected_cents?: number; From 2ff77d88a805303c7b48b39d9525f4d1341f462e Mon Sep 17 00:00:00 2001 From: masnwilliams <43387599+masnwilliams@users.noreply.github.com> Date: Fri, 13 Nov 2026 19:16:32 +0000 Subject: [PATCH 4/9] Tell the MCP coverage updater where description text goes Keep tool descriptions to choosing an action, put input rules on parameters and post-call guidance in responses, respect the description size guard, and set destructiveHint from the tool's actions. --- .github/prompts/update-mcp-coverage.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/.github/prompts/update-mcp-coverage.md b/.github/prompts/update-mcp-coverage.md index cca9b22d..38384c61 100644 --- a/.github/prompts/update-mcp-coverage.md +++ b/.github/prompts/update-mcp-coverage.md @@ -60,6 +60,31 @@ things the SDK has. 4. Change only text whose meaning the spec change affects, or existing text the spec now shows to be wrong. Do not restyle unrelated descriptions. +## Where text goes + +- A tool description says what the tool is for and gives one short clause per action: + enough to choose the right action. Do not put per-action detail there. +- Rules for one action's inputs (formats, limits, defaults, which fields apply) go in + that parameter's `.describe()`. +- What happens after a call (next steps, retry rules, what a result means, recovery) + goes in the response: an existing response `note`, response guidance, or error note, + following nearby patterns. +- Keep each piece of text in one place, where the model reads it when it needs it; do + not repeat it across the tool description, parameters, and response guidance. +- `src/lib/mcp/tool-contract.test.ts` caps each tool description and the total + `tools/list` size. If an addition exceeds a cap, move detail out as above. Never raise + a cap, add an exception, or loosen that test. +- In the report, list every tool description you changed with its size in characters + before and after. + +## Annotations + +- `destructiveHint` is `false` only when every action is read-only or additive (create, + create-or-retrieve, list, get). A delete, remove, overwrite, revoke, or replace action + requires `true`. +- Change an existing tool's annotations only when this run changes its actions, and + explain the change in the report. + ## Validate and report Use Bun 1.3.3 for all MCP dependency and test commands. Run: From e15f4c52327bce55ca9a9375f31fdeab7c213dc6 Mon Sep 17 00:00:00 2001 From: Rafael Date: Fri, 13 Nov 2026 16:49:21 -0500 Subject: [PATCH 5/9] Lock workflow action dependencies with actions.lock (#19) Co-authored-by: rgarcia <72655+rgarcia@users.noreply.github.com> --- .github/workflows/actions.lock | 97 ++++++++++++++++++++++++++++ .github/workflows/release-please.yml | 2 +- 2 files changed, 98 insertions(+), 1 deletion(-) create mode 100644 .github/workflows/actions.lock diff --git a/.github/workflows/actions.lock b/.github/workflows/actions.lock new file mode 100644 index 00000000..01bf3e59 --- /dev/null +++ b/.github/workflows/actions.lock @@ -0,0 +1,97 @@ +# This file is machine-generated by `gh actions-lock`. +# Do not edit by hand; run `gh actions-lock` to update. +# Docs: https://gh.io/actions-lockfile +version: 'v0.0.3' +workflows: + '.github/workflows/ci.yml': + - 'actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5' + - 'actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd' + - 'actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd' + - 'actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020' + '.github/workflows/publish-npm.yml': + - 'actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd' + - 'actions/setup-node@3235b876344d2a9aa001b8d1453c930bba69e610' + '.github/workflows/release-doctor.yml': + - 'actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd' + '.github/workflows/release-please.yml': + - 'actions/create-github-app-token@d72941d797fd3113feb6b93fd0dec494b13a2547' + - 'actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020' + - 'pnpm/action-setup@b906affcce14559ad1aafd4ab0e942779e9f58b1' + '.github/workflows/semgrep.yml': [] + '.github/workflows/stlc-promote.yml': + - 'actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd' + - 'actions/create-github-app-token@d72941d797fd3113feb6b93fd0dec494b13a2547' + '.github/workflows/stlc-sync.yml': + - 'actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd' + '.github/workflows/update-docs.yml': + - 'actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5' + - 'actions/create-github-app-token@d72941d797fd3113feb6b93fd0dec494b13a2547' + - 'actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093' + - 'actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020' + - 'actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02' + - 'kernel/security-workflows@4144994f1d6977e07ef5a5832599ee4faaae9550' + '.github/workflows/update-mcp-coverage.yml': + - 'actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5' + - 'actions/create-github-app-token@d72941d797fd3113feb6b93fd0dec494b13a2547' + - 'actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093' + - 'actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020' + - 'actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02' + - 'kernel/security-workflows@4144994f1d6977e07ef5a5832599ee4faaae9550' + - 'oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6' + '.github/workflows/vuln-remediation.yml': [] +dependencies: + 'actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5': + ref: 'v4.3.1' + commit: 'sha1-34e114876b0b11c390a56381ad16ebd13914f8d5' + owner_id: 44036562 + repo_id: 197814629 + 'actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd': + ref: 'v6.0.2' + commit: 'sha1-de0fac2e4500dabe0009e67214ff5f5447ce83dd' + owner_id: 44036562 + repo_id: 197814629 + 'actions/create-github-app-token@d72941d797fd3113feb6b93fd0dec494b13a2547': + ref: 'v1.12.0' + commit: 'sha1-d72941d797fd3113feb6b93fd0dec494b13a2547' + owner_id: 44036562 + repo_id: 642580244 + 'actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093': + ref: 'v4.3.0' + commit: 'sha1-d3f86a106a0bac45b974a628896c90dbdf5c8093' + owner_id: 44036562 + repo_id: 192626254 + 'actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd': + ref: 'v8.0.0' + commit: 'sha1-ed597411d8f924073f98dfc5c65a23a2325f34cd' + owner_id: 44036562 + repo_id: 205262760 + 'actions/setup-node@3235b876344d2a9aa001b8d1453c930bba69e610': + ref: 'v3.9.1' + commit: 'sha1-3235b876344d2a9aa001b8d1453c930bba69e610' + owner_id: 44036562 + repo_id: 189476904 + 'actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020': + ref: 'v4.4.0' + commit: 'sha1-49933ea5288caeca8642d1e84afbd3f7d6820020' + owner_id: 44036562 + repo_id: 189476904 + 'actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02': + ref: 'v4.6.2' + commit: 'sha1-ea165f8d65b6e75b540449e92b4886f43607fa02' + owner_id: 44036562 + repo_id: 192625955 + 'kernel/security-workflows@4144994f1d6977e07ef5a5832599ee4faaae9550': + ref: 'main' + commit: 'sha1-4144994f1d6977e07ef5a5832599ee4faaae9550' + owner_id: 194616459 + repo_id: 1207196574 + 'oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6': + ref: 'v2.2.0' + commit: 'sha1-0c5077e51419868618aeaa5fe8019c62421857d6' + owner_id: 108928776 + repo_id: 512644635 + 'pnpm/action-setup@b906affcce14559ad1aafd4ab0e942779e9f58b1': + ref: 'v4.3.0' + commit: 'sha1-b906affcce14559ad1aafd4ab0e942779e9f58b1' + owner_id: 21320719 + repo_id: 262289747 diff --git a/.github/workflows/release-please.yml b/.github/workflows/release-please.yml index e69a7175..b77e1e4a 100644 --- a/.github/workflows/release-please.yml +++ b/.github/workflows/release-please.yml @@ -41,7 +41,7 @@ jobs: node-version: '22' - name: Set up pnpm - uses: pnpm/action-setup@f40ffcd9367d9f12939873eb1018b921a783ffaa # v4 + uses: pnpm/action-setup@b906affcce14559ad1aafd4ab0e942779e9f58b1 # v4 with: version: '9.11.0' run_install: false From 67da753f985726dd2600c8cd11275dc6820292cb Mon Sep 17 00:00:00 2001 From: "kernel-internal[bot]" <260533166+kernel-internal[bot]@users.noreply.github.com> Date: Mon, 16 Nov 2026 20:36:47 +0000 Subject: [PATCH 6/9] feat: Add tasks API: create, list, get, and link browsers Stainless-Generated-From: 368f79bc628ef39f4c4973db3fcb7ebb3c4c1b97 --- .stats.yml | 2 +- api.md | 14 +++ src/client.ts | 24 ++++ src/resources/index.ts | 9 ++ src/resources/tasks.ts | 183 ++++++++++++++++++++++++++++++ tests/api-resources/tasks.test.ts | 89 +++++++++++++++ 6 files changed, 320 insertions(+), 1 deletion(-) create mode 100644 src/resources/tasks.ts create mode 100644 tests/api-resources/tasks.test.ts diff --git a/.stats.yml b/.stats.yml index 4731cdc5..83b7ea96 100644 --- a/.stats.yml +++ b/.stats.yml @@ -1 +1 @@ -configured_endpoints: 179 +configured_endpoints: 183 diff --git a/api.md b/api.md index 8b9c140d..9cb138fd 100644 --- a/api.md +++ b/api.md @@ -386,6 +386,20 @@ Methods: - client.profiles.delete(idOrName) -> void - client.profiles.download(idOrName, { ...params }) -> Response +# Tasks + +Types: + +- Task +- TaskMetadata + +Methods: + +- client.tasks.create({ ...params }) -> Task +- client.tasks.retrieve(id) -> Task +- client.tasks.list({ ...params }) -> TasksOffsetPagination +- client.tasks.linkBrowsers(id, { ...params }) -> Task + # Auth ## Context diff --git a/src/client.ts b/src/client.ts index 7b86b4bc..2f869f98 100644 --- a/src/client.ts +++ b/src/client.ts @@ -143,6 +143,15 @@ import { ProxyIPs, ProxyIPsOffsetPagination, } from './resources/proxy-ips'; +import { + Task, + TaskCreateParams, + TaskLinkBrowsersParams, + TaskListParams, + TaskMetadata, + Tasks, + TasksOffsetPagination, +} from './resources/tasks'; import { VaultProviderConfig, VaultProviderConfigCreateParams, @@ -1095,6 +1104,10 @@ export class Kernel { * Create, list, retrieve, and delete browser profiles. */ profiles: API.Profiles = new API.Profiles(this); + /** + * Define tasks that agents work toward and link the browsers they use. + */ + tasks: API.Tasks = new API.Tasks(this); auth: API.Auth = new API.Auth(this); telemetry: API.Telemetry = new API.Telemetry(this); /** @@ -1148,6 +1161,7 @@ Kernel.Invocations = Invocations; Kernel.ConfigRegistry = ConfigRegistry; Kernel.Browsers = Browsers; Kernel.Profiles = Profiles; +Kernel.Tasks = Tasks; Kernel.Auth = Auth; Kernel.Telemetry = Telemetry; Kernel.Proxies = Proxies; @@ -1288,6 +1302,16 @@ export declare namespace Kernel { type ProfileDownloadParams as ProfileDownloadParams, }; + export { + Tasks as Tasks, + type Task as Task, + type TaskMetadata as TaskMetadata, + type TasksOffsetPagination as TasksOffsetPagination, + type TaskCreateParams as TaskCreateParams, + type TaskListParams as TaskListParams, + type TaskLinkBrowsersParams as TaskLinkBrowsersParams, + }; + export { Auth as Auth }; export { Telemetry as Telemetry }; diff --git a/src/resources/index.ts b/src/resources/index.ts index 828bb65c..990eda7d 100644 --- a/src/resources/index.ts +++ b/src/resources/index.ts @@ -214,6 +214,15 @@ export { type Warning, type SearchCreateParams, } from './search/search'; +export { + Tasks, + type Task, + type TaskMetadata, + type TaskCreateParams, + type TaskListParams, + type TaskLinkBrowsersParams, + type TasksOffsetPagination, +} from './tasks'; export { Telemetry } from './telemetry/telemetry'; export { VaultProviderConfigs, diff --git a/src/resources/tasks.ts b/src/resources/tasks.ts new file mode 100644 index 00000000..d61337f3 --- /dev/null +++ b/src/resources/tasks.ts @@ -0,0 +1,183 @@ +// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details. + +import { APIResource } from '../core/resource'; +import { APIPromise } from '../core/api-promise'; +import { OffsetPagination, type OffsetPaginationParams, PagePromise } from '../core/pagination'; +import { RequestOptions } from '../internal/request-options'; +import { path } from '../internal/utils/path'; + +/** + * Define tasks that agents work toward and link the browsers they use. + */ +export class Tasks extends APIResource { + /** + * Define a task before or while an agent works on it, optionally linking the + * browsers it uses. Submit reports against the returned task ID. + * + * @example + * ```ts + * const task = await client.tasks.create({ + * description: 'Book a hotel room for two nights', + * }); + * ``` + */ + create(body: TaskCreateParams, options?: RequestOptions): APIPromise { + return this._client.post('/tasks', { body, ...options }); + } + + /** + * Retrieve a task and the IDs of its linked browsers. + * + * @example + * ```ts + * const task = await client.tasks.retrieve('id'); + * ``` + */ + retrieve(id: string, options?: RequestOptions): APIPromise { + return this._client.get(path`/tasks/${id}`, options); + } + + /** + * List tasks in the request's project, newest first. + * + * @example + * ```ts + * // Automatically fetches more pages as needed. + * for await (const task of client.tasks.list()) { + * // ... + * } + * ``` + */ + list( + query: TaskListParams | null | undefined = {}, + options?: RequestOptions, + ): PagePromise { + return this._client.getAPIList('/tasks', OffsetPagination, { query, ...options }); + } + + /** + * Link browsers to an existing task. Linking a browser that is already linked has + * no effect, so the call is safe to retry. Returns the updated task. + * + * @example + * ```ts + * const task = await client.tasks.linkBrowsers('id', { + * session_ids: ['x'], + * }); + * ``` + */ + linkBrowsers(id: string, body: TaskLinkBrowsersParams, options?: RequestOptions): APIPromise { + return this._client.post(path`/tasks/${id}/browsers`, { body, ...options }); + } +} + +export type TasksOffsetPagination = OffsetPagination; + +/** + * A goal an agent works toward. Reports are submitted against a task, and browsers + * can be linked to it. Tasks are immutable apart from added browser links. + */ +export interface Task { + /** + * Unique identifier for the task + */ + id: string; + + /** + * When the task was created + */ + created_at: string; + + /** + * What the task is meant to accomplish + */ + description: string; + + /** + * Caller-defined string key-value pairs for grouping and filtering tasks, such as + * a user or thread ID. At most 20 keys; keys are 1-64 characters, values at most + * 256 characters, and keys and values together at most 4 KB. + */ + metadata: TaskMetadata; + + /** + * IDs of browsers linked to the task, oldest link first. Linked browsers may since + * have been deleted. + */ + session_ids: Array; + + /** + * When work on the task started + */ + started_at: string; + + /** + * Hostname of the website the task targets + */ + target_website?: string | null; +} + +/** + * Caller-defined string key-value pairs for grouping and filtering tasks, such as + * a user or thread ID. At most 20 keys; keys are 1-64 characters, values at most + * 256 characters, and keys and values together at most 4 KB. + */ +export type TaskMetadata = { [key: string]: string }; + +export interface TaskCreateParams { + /** + * What the task is meant to accomplish, at most 4 KB. + */ + description: string; + + /** + * Caller-defined string key-value pairs for grouping and filtering tasks, such as + * a user or thread ID. At most 20 keys; keys are 1-64 characters, values at most + * 256 characters, and keys and values together at most 4 KB. + */ + metadata?: TaskMetadata; + + /** + * IDs of browsers to link to the task. Each must belong to the request's project; + * deleted browsers can be linked. + */ + session_ids?: Array; + + /** + * When work on the task started. Defaults to the time the task is created. Must be + * no more than 5 minutes in the future or 30 days in the past. + */ + started_at?: string; + + /** + * Hostname of the website the task targets, without a scheme or path. + */ + target_website?: string; +} + +export interface TaskListParams extends OffsetPaginationParams { + /** + * Only return tasks linked to this browser ID. + */ + session_id?: string; +} + +export interface TaskLinkBrowsersParams { + /** + * IDs of browsers to link. Each must belong to the task's project; deleted + * browsers can be linked. Browsers already linked are ignored. A task can have at + * most 100 linked browsers. + */ + session_ids: Array; +} + +export declare namespace Tasks { + export { + type Task as Task, + type TaskMetadata as TaskMetadata, + type TasksOffsetPagination as TasksOffsetPagination, + type TaskCreateParams as TaskCreateParams, + type TaskListParams as TaskListParams, + type TaskLinkBrowsersParams as TaskLinkBrowsersParams, + }; +} diff --git a/tests/api-resources/tasks.test.ts b/tests/api-resources/tasks.test.ts new file mode 100644 index 00000000..0ff60b75 --- /dev/null +++ b/tests/api-resources/tasks.test.ts @@ -0,0 +1,89 @@ +// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details. + +import Kernel from '@onkernel/sdk'; + +const client = new Kernel({ + apiKey: 'My API Key', + baseURL: process.env['TEST_API_BASE_URL'] ?? 'http://127.0.0.1:4010', +}); + +describe('resource tasks', () => { + // Mock server tests are disabled + test.skip('create: only required params', async () => { + const responsePromise = client.tasks.create({ description: 'Book a hotel room for two nights' }); + 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); + }); + + // Mock server tests are disabled + test.skip('create: required and optional params', async () => { + const response = await client.tasks.create({ + description: 'Book a hotel room for two nights', + metadata: { user_id: 'user_123', thread_id: 'thread_456' }, + session_ids: ['x'], + started_at: '2019-12-27T18:11:19.117Z', + target_website: 'booking.com', + }); + }); + + // Mock server tests are disabled + test.skip('retrieve', async () => { + const responsePromise = client.tasks.retrieve('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); + }); + + // Mock server tests are disabled + test.skip('list', async () => { + const responsePromise = client.tasks.list(); + 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); + }); + + // Mock server tests are disabled + test.skip('list: 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.tasks.list( + { + limit: 1, + offset: 0, + session_id: 'session_id', + }, + { path: '/_stainless_unknown_path' }, + ), + ).rejects.toThrow(Kernel.NotFoundError); + }); + + // Mock server tests are disabled + test.skip('linkBrowsers: only required params', async () => { + const responsePromise = client.tasks.linkBrowsers('id', { session_ids: ['x'] }); + 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); + }); + + // Mock server tests are disabled + test.skip('linkBrowsers: required and optional params', async () => { + const response = await client.tasks.linkBrowsers('id', { session_ids: ['x'] }); + }); +}); From 73a9a6be92f7ea9692a25541ce767354760184d1 Mon Sep 17 00:00:00 2001 From: "kernel-internal[bot]" <260533166+kernel-internal[bot]@users.noreply.github.com> Date: Mon, 16 Nov 2026 22:24:28 +0000 Subject: [PATCH 7/9] feat: Add reports API and report type discovery Stainless-Generated-From: 7416198bc84673817c339be748d49936e6369e30 --- .stats.yml | 2 +- api.md | 35 ++++ src/client.ts | 42 +++++ src/resources/index.ts | 15 ++ src/resources/report-types.ts | 3 + src/resources/report-types/index.ts | 11 ++ src/resources/report-types/report-types.ts | 137 +++++++++++++++ src/resources/report-types/versions.ts | 61 +++++++ src/resources/reports.ts | 166 ++++++++++++++++++ .../report-types/report-types.test.ts | 43 +++++ .../report-types/versions.test.ts | 27 +++ tests/api-resources/reports.test.ts | 72 ++++++++ 12 files changed, 613 insertions(+), 1 deletion(-) create mode 100644 src/resources/report-types.ts create mode 100644 src/resources/report-types/index.ts create mode 100644 src/resources/report-types/report-types.ts create mode 100644 src/resources/report-types/versions.ts create mode 100644 src/resources/reports.ts create mode 100644 tests/api-resources/report-types/report-types.test.ts create mode 100644 tests/api-resources/report-types/versions.test.ts create mode 100644 tests/api-resources/reports.test.ts diff --git a/.stats.yml b/.stats.yml index 83b7ea96..a4bdf76d 100644 --- a/.stats.yml +++ b/.stats.yml @@ -1 +1 @@ -configured_endpoints: 183 +configured_endpoints: 189 diff --git a/api.md b/api.md index 9cb138fd..026089bd 100644 --- a/api.md +++ b/api.md @@ -400,6 +400,41 @@ Methods: - client.tasks.list({ ...params }) -> TasksOffsetPagination - client.tasks.linkBrowsers(id, { ...params }) -> Task +# Reports + +Types: + +- Report + +Methods: + +- client.reports.create({ ...params }) -> Report +- client.reports.retrieve(id) -> Report +- client.reports.list({ ...params }) -> ReportsOffsetPagination + +# ReportTypes + +Types: + +- ReportType +- ReportTypeSummary +- ReportTypeVersionSummary + +Methods: + +- client.reportTypes.retrieve(type) -> ReportType +- client.reportTypes.list({ ...params }) -> ReportTypeSummariesOffsetPagination + +## Versions + +Types: + +- ReportTypeVersion + +Methods: + +- client.reportTypes.versions.retrieve(version, { ...params }) -> ReportTypeVersion + # Auth ## Context diff --git a/src/client.ts b/src/client.ts index 2f869f98..6eda058f 100644 --- a/src/client.ts +++ b/src/client.ts @@ -143,6 +143,13 @@ import { ProxyIPs, ProxyIPsOffsetPagination, } from './resources/proxy-ips'; +import { + Report, + ReportCreateParams, + ReportListParams, + Reports, + ReportsOffsetPagination, +} from './resources/reports'; import { Task, TaskCreateParams, @@ -242,6 +249,14 @@ import { ProjectsOffsetPagination, UpdateProjectRequest, } from './resources/projects/projects'; +import { + ReportType, + ReportTypeListParams, + ReportTypeSummariesOffsetPagination, + ReportTypeSummary, + ReportTypeVersionSummary, + ReportTypes, +} from './resources/report-types/report-types'; import { Attempt, ProviderTarget, @@ -1108,6 +1123,14 @@ export class Kernel { * Define tasks that agents work toward and link the browsers they use. */ tasks: API.Tasks = new API.Tasks(this); + /** + * Discover report types and submit typed reports against tasks. + */ + reports: API.Reports = new API.Reports(this); + /** + * Discover report types and submit typed reports against tasks. + */ + reportTypes: API.ReportTypes = new API.ReportTypes(this); auth: API.Auth = new API.Auth(this); telemetry: API.Telemetry = new API.Telemetry(this); /** @@ -1162,6 +1185,8 @@ Kernel.ConfigRegistry = ConfigRegistry; Kernel.Browsers = Browsers; Kernel.Profiles = Profiles; Kernel.Tasks = Tasks; +Kernel.Reports = Reports; +Kernel.ReportTypes = ReportTypes; Kernel.Auth = Auth; Kernel.Telemetry = Telemetry; Kernel.Proxies = Proxies; @@ -1312,6 +1337,23 @@ export declare namespace Kernel { type TaskLinkBrowsersParams as TaskLinkBrowsersParams, }; + export { + Reports as Reports, + type Report as Report, + type ReportsOffsetPagination as ReportsOffsetPagination, + type ReportCreateParams as ReportCreateParams, + type ReportListParams as ReportListParams, + }; + + export { + ReportTypes as ReportTypes, + type ReportType as ReportType, + type ReportTypeSummary as ReportTypeSummary, + type ReportTypeVersionSummary as ReportTypeVersionSummary, + type ReportTypeSummariesOffsetPagination as ReportTypeSummariesOffsetPagination, + type ReportTypeListParams as ReportTypeListParams, + }; + export { Auth as Auth }; export { Telemetry as Telemetry }; diff --git a/src/resources/index.ts b/src/resources/index.ts index 990eda7d..f88960de 100644 --- a/src/resources/index.ts +++ b/src/resources/index.ts @@ -202,6 +202,21 @@ export { type ProxyIPListParams, type ProxyIPsOffsetPagination, } from './proxy-ips'; +export { + ReportTypes, + type ReportType, + type ReportTypeSummary, + type ReportTypeVersionSummary, + type ReportTypeListParams, + type ReportTypeSummariesOffsetPagination, +} from './report-types/report-types'; +export { + Reports, + type Report, + type ReportCreateParams, + type ReportListParams, + type ReportsOffsetPagination, +} from './reports'; export { SearchResource, type Attempt, diff --git a/src/resources/report-types.ts b/src/resources/report-types.ts new file mode 100644 index 00000000..61dd084f --- /dev/null +++ b/src/resources/report-types.ts @@ -0,0 +1,3 @@ +// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details. + +export * from './report-types/index'; diff --git a/src/resources/report-types/index.ts b/src/resources/report-types/index.ts new file mode 100644 index 00000000..49f60d2e --- /dev/null +++ b/src/resources/report-types/index.ts @@ -0,0 +1,11 @@ +// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details. + +export { + ReportTypes, + type ReportType, + type ReportTypeSummary, + type ReportTypeVersionSummary, + type ReportTypeListParams, + type ReportTypeSummariesOffsetPagination, +} from './report-types'; +export { Versions, type ReportTypeVersion, type VersionRetrieveParams } from './versions'; diff --git a/src/resources/report-types/report-types.ts b/src/resources/report-types/report-types.ts new file mode 100644 index 00000000..b59f691c --- /dev/null +++ b/src/resources/report-types/report-types.ts @@ -0,0 +1,137 @@ +// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details. + +import { APIResource } from '../../core/resource'; +import * as VersionsAPI from './versions'; +import { ReportTypeVersion, VersionRetrieveParams, Versions } from './versions'; +import { APIPromise } from '../../core/api-promise'; +import { OffsetPagination, type OffsetPaginationParams, PagePromise } from '../../core/pagination'; +import { RequestOptions } from '../../internal/request-options'; +import { path } from '../../internal/utils/path'; + +/** + * Discover report types and submit typed reports against tasks. + */ +export class ReportTypes extends APIResource { + versions: VersionsAPI.Versions = new VersionsAPI.Versions(this._client); + + /** + * Retrieve a report type, its versions, and the JSON Schema of its latest version. + */ + retrieve(type: string, options?: RequestOptions): APIPromise { + return this._client.get(path`/report_types/${type}`, options); + } + + /** + * List the report types agents can submit for a task. Retrieve a type for the JSON + * Schema of its data. + */ + list( + query: ReportTypeListParams, + options?: RequestOptions, + ): PagePromise { + return this._client.getAPIList('/report_types', OffsetPagination, { + query, + ...options, + }); + } +} + +export type ReportTypeSummariesOffsetPagination = OffsetPagination; + +/** + * A kind of report agents can submit against a task, with its versions and the + * JSON Schema of its latest version. A shipped version never changes; changes ship + * as new versions. + */ +export interface ReportType { + /** + * What the report type records and when to submit it + */ + description: string; + + /** + * Highest version that is not retired. A report submitted without a schema_version + * uses this version. It is 0 when every version is retired. + */ + latest_version: number; + + /** + * JSON Schema (draft 2020-12) of the latest version, which a report's data must + * match. Its field descriptions and examples describe what to send. Null when + * every version is retired. + */ + schema: { [key: string]: unknown } | null; + + /** + * Report type name, such as task.result + */ + type: string; + + /** + * Every version of the type, oldest first, including retired versions. + */ + versions: Array; +} + +/** + * A kind of report agents can submit against a task. Retrieve the type for the + * JSON Schema of its data. + */ +export interface ReportTypeSummary { + /** + * What the report type records and when to submit it + */ + description: string; + + /** + * Highest version that is not retired. A report submitted without a schema_version + * uses this version. It is 0 when every version is retired. + */ + latest_version: number; + + /** + * Report type name, such as task.result + */ + type: string; +} + +/** + * One schema version of a report type, without its schema. + */ +export interface ReportTypeVersionSummary { + /** + * Whether the version is retired. Retired versions are no longer accepted for new + * reports; existing reports keep them. + */ + retired: boolean; + + /** + * Schema version number, starting at 1. + */ + version: number; +} + +export interface ReportTypeListParams extends OffsetPaginationParams { + /** + * Task the agent is finding a report type for. + */ + task_id: string; +} + +ReportTypes.Versions = Versions; + +export declare namespace ReportTypes { + export { + type ReportType as ReportType, + type ReportTypeSummary as ReportTypeSummary, + type ReportTypeVersionSummary as ReportTypeVersionSummary, + type ReportTypeSummariesOffsetPagination as ReportTypeSummariesOffsetPagination, + type ReportTypeListParams as ReportTypeListParams, + }; + + export { + Versions as Versions, + type ReportTypeVersion as ReportTypeVersion, + type VersionRetrieveParams as VersionRetrieveParams, + }; +} diff --git a/src/resources/report-types/versions.ts b/src/resources/report-types/versions.ts new file mode 100644 index 00000000..b7832cb6 --- /dev/null +++ b/src/resources/report-types/versions.ts @@ -0,0 +1,61 @@ +// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details. + +import { APIResource } from '../../core/resource'; +import { APIPromise } from '../../core/api-promise'; +import { RequestOptions } from '../../internal/request-options'; +import { path } from '../../internal/utils/path'; + +/** + * Discover report types and submit typed reports against tasks. + */ +export class Versions extends APIResource { + /** + * Retrieve one schema version of a report type, including retired versions. + */ + retrieve( + version: number, + params: VersionRetrieveParams, + options?: RequestOptions, + ): APIPromise { + const { type } = params; + return this._client.get(path`/report_types/${type}/versions/${version}`, options); + } +} + +/** + * One immutable schema version of a report type. + */ +export interface ReportTypeVersion { + /** + * Whether the version is retired. Retired versions are no longer accepted for new + * reports; existing reports keep them. + */ + retired: boolean; + + /** + * JSON Schema (draft 2020-12) that a report's data must match. Its field + * descriptions and examples describe what to send. + */ + schema: { [key: string]: unknown }; + + /** + * Report type name, such as task.result + */ + type: string; + + /** + * Schema version number, starting at 1. + */ + version: number; +} + +export interface VersionRetrieveParams { + /** + * Report type name, such as task.result + */ + type: string; +} + +export declare namespace Versions { + export { type ReportTypeVersion as ReportTypeVersion, type VersionRetrieveParams as VersionRetrieveParams }; +} diff --git a/src/resources/reports.ts b/src/resources/reports.ts new file mode 100644 index 00000000..d446e8a6 --- /dev/null +++ b/src/resources/reports.ts @@ -0,0 +1,166 @@ +// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details. + +import { APIResource } from '../core/resource'; +import { APIPromise } from '../core/api-promise'; +import { OffsetPagination, type OffsetPaginationParams, PagePromise } from '../core/pagination'; +import { RequestOptions } from '../internal/request-options'; +import { path } from '../internal/utils/path'; + +/** + * Discover report types and submit typed reports against tasks. + */ +export class Reports extends APIResource { + /** + * Submit a typed report against a task. The data is validated against the report + * type's schema; a validation failure returns 400 with one detail per invalid + * field. A task can have at most 500 reports. + * + * @example + * ```ts + * const report = await client.reports.create({ + * data: { result: 'bar', evidence: 'bar' }, + * task_id: 'x', + * type: 'task.result', + * }); + * ``` + */ + create(body: ReportCreateParams, options?: RequestOptions): APIPromise { + return this._client.post('/reports', { body, ...options }); + } + + /** + * Retrieve a report. + * + * @example + * ```ts + * const report = await client.reports.retrieve('id'); + * ``` + */ + retrieve(id: string, options?: RequestOptions): APIPromise { + return this._client.get(path`/reports/${id}`, options); + } + + /** + * List a task's reports in the order they were submitted, oldest first. + * + * @example + * ```ts + * // Automatically fetches more pages as needed. + * for await (const report of client.reports.list({ + * task_id: 'task_id', + * })) { + * // ... + * } + * ``` + */ + list(query: ReportListParams, options?: RequestOptions): PagePromise { + return this._client.getAPIList('/reports', OffsetPagination, { query, ...options }); + } +} + +export type ReportsOffsetPagination = OffsetPagination; + +/** + * A typed, schema-validated report an agent submitted against a task. Reports are + * immutable. + */ +export interface Report { + /** + * Unique identifier for the report + */ + id: string; + + /** + * When the report was submitted + */ + created_at: string; + + /** + * Report data, matching the report type's schema + */ + data: { [key: string]: unknown }; + + /** + * When the reported event happened + */ + occurred_at: string; + + /** + * Version of the report type's schema that data was validated against + */ + schema_version: number; + + /** + * ID of the task the report belongs to + */ + task_id: string; + + /** + * Report type name + */ + type: string; + + /** + * ID of the browser the report was observed in, if any + */ + session_id?: string | null; +} + +export interface ReportCreateParams { + /** + * Report data. It must match the schema of the report type's version and encode to + * at most 16 KB of JSON. + */ + data: { [key: string]: unknown }; + + /** + * ID of the task to report against. + */ + task_id: string; + + /** + * Report type name. List report types to see the available types and their + * schemas. + */ + type: string; + + /** + * When the reported event happened. Defaults to the time the report is submitted. + * Must be no more than 5 minutes in the future or 30 days in the past. + */ + occurred_at?: string; + + /** + * Version of the report type's schema to validate data against. Defaults to the + * type's latest version, which the response returns. + */ + schema_version?: number; + + /** + * ID of the browser the report was observed in. It must belong to the task's + * project; deleted browsers are accepted. The browser is linked to the task if it + * is not already. + */ + session_id?: string; +} + +export interface ReportListParams extends OffsetPaginationParams { + /** + * Task whose reports to list. + */ + task_id: string; + + /** + * Only return reports of this type. + */ + type?: string; +} + +export declare namespace Reports { + export { + type Report as Report, + type ReportsOffsetPagination as ReportsOffsetPagination, + type ReportCreateParams as ReportCreateParams, + type ReportListParams as ReportListParams, + }; +} diff --git a/tests/api-resources/report-types/report-types.test.ts b/tests/api-resources/report-types/report-types.test.ts new file mode 100644 index 00000000..c04ee726 --- /dev/null +++ b/tests/api-resources/report-types/report-types.test.ts @@ -0,0 +1,43 @@ +// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details. + +import Kernel from '@onkernel/sdk'; + +const client = new Kernel({ + apiKey: 'My API Key', + baseURL: process.env['TEST_API_BASE_URL'] ?? 'http://127.0.0.1:4010', +}); + +describe('resource reportTypes', () => { + // Mock server tests are disabled + test.skip('retrieve', async () => { + const responsePromise = client.reportTypes.retrieve('type'); + 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); + }); + + // Mock server tests are disabled + test.skip('list: only required params', async () => { + const responsePromise = client.reportTypes.list({ task_id: 'task_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); + }); + + // Mock server tests are disabled + test.skip('list: required and optional params', async () => { + const response = await client.reportTypes.list({ + task_id: 'task_id', + limit: 1, + offset: 0, + }); + }); +}); diff --git a/tests/api-resources/report-types/versions.test.ts b/tests/api-resources/report-types/versions.test.ts new file mode 100644 index 00000000..315faf65 --- /dev/null +++ b/tests/api-resources/report-types/versions.test.ts @@ -0,0 +1,27 @@ +// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details. + +import Kernel from '@onkernel/sdk'; + +const client = new Kernel({ + apiKey: 'My API Key', + baseURL: process.env['TEST_API_BASE_URL'] ?? 'http://127.0.0.1:4010', +}); + +describe('resource versions', () => { + // Mock server tests are disabled + test.skip('retrieve: only required params', async () => { + const responsePromise = client.reportTypes.versions.retrieve(0, { type: 'type' }); + 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); + }); + + // Mock server tests are disabled + test.skip('retrieve: required and optional params', async () => { + const response = await client.reportTypes.versions.retrieve(0, { type: 'type' }); + }); +}); diff --git a/tests/api-resources/reports.test.ts b/tests/api-resources/reports.test.ts new file mode 100644 index 00000000..6be83399 --- /dev/null +++ b/tests/api-resources/reports.test.ts @@ -0,0 +1,72 @@ +// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details. + +import Kernel from '@onkernel/sdk'; + +const client = new Kernel({ + apiKey: 'My API Key', + baseURL: process.env['TEST_API_BASE_URL'] ?? 'http://127.0.0.1:4010', +}); + +describe('resource reports', () => { + // Mock server tests are disabled + test.skip('create: only required params', async () => { + const responsePromise = client.reports.create({ + data: { result: 'bar', evidence: 'bar' }, + task_id: 'x', + type: 'task.result', + }); + 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); + }); + + // Mock server tests are disabled + test.skip('create: required and optional params', async () => { + const response = await client.reports.create({ + data: { result: 'bar', evidence: 'bar' }, + task_id: 'x', + type: 'task.result', + occurred_at: '2019-12-27T18:11:19.117Z', + schema_version: 1, + session_id: 'x', + }); + }); + + // Mock server tests are disabled + test.skip('retrieve', async () => { + const responsePromise = client.reports.retrieve('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); + }); + + // Mock server tests are disabled + test.skip('list: only required params', async () => { + const responsePromise = client.reports.list({ task_id: 'task_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); + }); + + // Mock server tests are disabled + test.skip('list: required and optional params', async () => { + const response = await client.reports.list({ + task_id: 'task_id', + limit: 1, + offset: 0, + type: 'type', + }); + }); +}); From 908bc54b4c8559847abd9fee93ae7eade374bca7 Mon Sep 17 00:00:00 2001 From: "kernel-internal[bot]" <260533166+kernel-internal[bot]@users.noreply.github.com> Date: Mon, 16 Nov 2026 23:17:46 +0000 Subject: [PATCH 8/9] feat: Let vault item events be read after the item or vault is deleted Stainless-Generated-From: e77cbb586c0807968f04f179f0848b60456e7929 --- src/resources/vaults/items.ts | 9 +++++++++ tests/api-resources/vaults/items.test.ts | 1 + 2 files changed, 10 insertions(+) diff --git a/src/resources/vaults/items.ts b/src/resources/vaults/items.ts index 94eb901b..64330747 100644 --- a/src/resources/vaults/items.ts +++ b/src/resources/vaults/items.ts @@ -4547,6 +4547,15 @@ export interface ItemEventsParams { */ after?: string; + /** + * Query param: When true, also finds deleted items, and deleted vaults by ID only. + * `key` then also accepts an item ID, which takes precedence over a key with the + * same value; the lookup order is the item ID, then the live item with that key, + * then the most recently deleted one. `wait` is ignored for a deleted item or + * vault. + */ + include_deleted?: boolean; + /** * Query param: Long-poll for new events for up to this many seconds. */ diff --git a/tests/api-resources/vaults/items.test.ts b/tests/api-resources/vaults/items.test.ts index f2381ea9..af58fbdc 100644 --- a/tests/api-resources/vaults/items.test.ts +++ b/tests/api-resources/vaults/items.test.ts @@ -147,6 +147,7 @@ describe('resource items', () => { const response = await client.vaults.items.events('key', { id_or_name: 'id_or_name', after: 'after', + include_deleted: true, wait: 0, }); }); From 7d81c82992e8cbcd900445a941084e9e11b47205 Mon Sep 17 00:00:00 2001 From: "kernel-internal[bot]" <260533166+kernel-internal[bot]@users.noreply.github.com> Date: Mon, 16 Nov 2026 23:22:37 +0000 Subject: [PATCH 9/9] release: 0.149.0 --- .release-please-manifest.json | 2 +- CHANGELOG.md | 9 +++++++++ package.json | 2 +- src/version.ts | 2 +- 4 files changed, 12 insertions(+), 3 deletions(-) diff --git a/.release-please-manifest.json b/.release-please-manifest.json index 3350a097..3c870f54 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -1,3 +1,3 @@ { - ".": "0.148.0" + ".": "0.149.0" } diff --git a/CHANGELOG.md b/CHANGELOG.md index ab1e5aa0..911a8f22 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,14 @@ # Changelog +## [0.149.0](https://github.com/kernel/kernel-node-sdk/compare/v0.148.0...v0.149.0) (2026-11-16) + + +### Features + +* Add reports API and report type discovery ([73a9a6b](https://github.com/kernel/kernel-node-sdk/commit/73a9a6be92f7ea9692a25541ce767354760184d1)) +* Add tasks API: create, list, get, and link browsers ([67da753](https://github.com/kernel/kernel-node-sdk/commit/67da753f985726dd2600c8cd11275dc6820292cb)) +* Let vault item events be read after the item or vault is deleted ([908bc54](https://github.com/kernel/kernel-node-sdk/commit/908bc54b4c8559847abd9fee93ae7eade374bca7)) + ## [0.148.0](https://github.com/kernel/kernel-node-sdk/compare/v0.147.0...v0.148.0) (2026-11-12) diff --git a/package.json b/package.json index 73c014f3..a4e0c7b1 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@onkernel/sdk", - "version": "0.148.0", + "version": "0.149.0", "description": "The official TypeScript library for the Kernel API", "author": "Kernel <>", "types": "dist/index.d.ts", diff --git a/src/version.ts b/src/version.ts index 48acf2cd..0c7cc988 100644 --- a/src/version.ts +++ b/src/version.ts @@ -1 +1 @@ -export const VERSION = '0.148.0'; // x-release-please-version +export const VERSION = '0.149.0'; // x-release-please-version