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:
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
diff --git a/.github/workflows/update-mcp-coverage.yml b/.github/workflows/update-mcp-coverage.yml
index c28dba9e..4c487dfe 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.
+ # 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."
+ 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:"
+ 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; 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"
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/.stats.yml b/.stats.yml
index 4731cdc5..a4bdf76d 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1 +1 @@
-configured_endpoints: 179
+configured_endpoints: 189
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/api.md b/api.md
index 8b9c140d..026089bd 100644
--- a/api.md
+++ b/api.md
@@ -386,6 +386,55 @@ 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
+
+# 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/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/client.ts b/src/client.ts
index 7b86b4bc..6eda058f 100644
--- a/src/client.ts
+++ b/src/client.ts
@@ -143,6 +143,22 @@ import {
ProxyIPs,
ProxyIPsOffsetPagination,
} from './resources/proxy-ips';
+import {
+ Report,
+ ReportCreateParams,
+ ReportListParams,
+ Reports,
+ ReportsOffsetPagination,
+} from './resources/reports';
+import {
+ Task,
+ TaskCreateParams,
+ TaskLinkBrowsersParams,
+ TaskListParams,
+ TaskMetadata,
+ Tasks,
+ TasksOffsetPagination,
+} from './resources/tasks';
import {
VaultProviderConfig,
VaultProviderConfigCreateParams,
@@ -233,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,
@@ -1095,6 +1119,18 @@ 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);
+ /**
+ * 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);
/**
@@ -1148,6 +1184,9 @@ Kernel.Invocations = Invocations;
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;
@@ -1288,6 +1327,33 @@ 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 {
+ 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 828bb65c..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,
@@ -214,6 +229,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/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/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/src/resources/vaults/items.ts b/src/resources/vaults/items.ts
index fe5d4636..64330747 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;
@@ -4522,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/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
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',
+ });
+ });
+});
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'] });
+ });
+});
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,
});
});