@anthropic-ai/sdk 0.93.0 → 0.95.0

package/src/resources/beta/webhooks.ts

@@ -0,0 +1,417 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { Webhook } from 'standardwebhooks';
+
+export class Webhooks extends APIResource {
+  unwrap(
+    body: string,
+    { headers, key }: { headers: Record<string, string>; key?: string },
+  ): UnwrapWebhookEvent {
+    if (headers !== undefined) {
+      const keyStr: string | null = key === undefined ? this._client.webhookKey : key;
+      if (keyStr === null) throw new Error('Webhook key must not be null in order to unwrap');
+      const wh = new Webhook(keyStr);
+      wh.verify(body, headers);
+    }
+    return JSON.parse(body) as UnwrapWebhookEvent;
+  }
+}
+
+export interface BetaWebhookEvent {
+  /**
+   * Unique event identifier for idempotency.
+   */
+  id: string;
+
+  /**
+   * RFC 3339 timestamp when the event occurred.
+   */
+  created_at: string;
+
+  data: BetaWebhookEventData;
+
+  /**
+   * Object type. Always `event` for webhook payloads.
+   */
+  type: 'event';
+}
+
+export type BetaWebhookEventData =
+  | BetaWebhookSessionCreatedEventData
+  | BetaWebhookSessionPendingEventData
+  | BetaWebhookSessionRunningEventData
+  | BetaWebhookSessionIdledEventData
+  | BetaWebhookSessionRequiresActionEventData
+  | BetaWebhookSessionArchivedEventData
+  | BetaWebhookSessionDeletedEventData
+  | BetaWebhookSessionStatusRescheduledEventData
+  | BetaWebhookSessionStatusRunStartedEventData
+  | BetaWebhookSessionStatusIdledEventData
+  | BetaWebhookSessionStatusTerminatedEventData
+  | BetaWebhookSessionThreadCreatedEventData
+  | BetaWebhookSessionThreadIdledEventData
+  | BetaWebhookSessionThreadTerminatedEventData
+  | BetaWebhookSessionOutcomeEvaluationEndedEventData
+  | BetaWebhookVaultCreatedEventData
+  | BetaWebhookVaultArchivedEventData
+  | BetaWebhookVaultDeletedEventData
+  | BetaWebhookVaultCredentialCreatedEventData
+  | BetaWebhookVaultCredentialArchivedEventData
+  | BetaWebhookVaultCredentialDeletedEventData
+  | BetaWebhookVaultCredentialRefreshFailedEventData;
+
+export interface BetaWebhookSessionArchivedEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.archived';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookSessionCreatedEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.created';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookSessionDeletedEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.deleted';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookSessionIdledEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.idled';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookSessionOutcomeEvaluationEndedEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.outcome_evaluation_ended';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookSessionPendingEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.pending';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookSessionRequiresActionEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.requires_action';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookSessionRunningEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.running';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookSessionStatusIdledEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.status_idled';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookSessionStatusRescheduledEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.status_rescheduled';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookSessionStatusRunStartedEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.status_run_started';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookSessionStatusTerminatedEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.status_terminated';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookSessionThreadCreatedEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.thread_created';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookSessionThreadIdledEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.thread_idled';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookSessionThreadTerminatedEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'session.thread_terminated';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookVaultArchivedEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'vault.archived';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookVaultCreatedEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'vault.created';
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookVaultCredentialArchivedEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'vault_credential.archived';
+
+  /**
+   * ID of the vault that owns this credential.
+   */
+  vault_id: string;
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookVaultCredentialCreatedEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'vault_credential.created';
+
+  /**
+   * ID of the vault that owns this credential.
+   */
+  vault_id: string;
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookVaultCredentialDeletedEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'vault_credential.deleted';
+
+  /**
+   * ID of the vault that owns this credential.
+   */
+  vault_id: string;
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookVaultCredentialRefreshFailedEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'vault_credential.refresh_failed';
+
+  /**
+   * ID of the vault that owns this credential.
+   */
+  vault_id: string;
+
+  workspace_id: string;
+}
+
+export interface BetaWebhookVaultDeletedEventData {
+  /**
+   * ID of the resource that triggered the event.
+   */
+  id: string;
+
+  organization_id: string;
+
+  type: 'vault.deleted';
+
+  workspace_id: string;
+}
+
+export interface UnwrapWebhookEvent {
+  /**
+   * Unique event identifier for idempotency.
+   */
+  id: string;
+
+  /**
+   * RFC 3339 timestamp when the event occurred.
+   */
+  created_at: string;
+
+  data: BetaWebhookEventData;
+
+  /**
+   * Object type. Always `event` for webhook payloads.
+   */
+  type: 'event';
+}
+
+export declare namespace Webhooks {
+  export {
+    type BetaWebhookEvent as BetaWebhookEvent,
+    type BetaWebhookEventData as BetaWebhookEventData,
+    type BetaWebhookSessionArchivedEventData as BetaWebhookSessionArchivedEventData,
+    type BetaWebhookSessionCreatedEventData as BetaWebhookSessionCreatedEventData,
+    type BetaWebhookSessionDeletedEventData as BetaWebhookSessionDeletedEventData,
+    type BetaWebhookSessionIdledEventData as BetaWebhookSessionIdledEventData,
+    type BetaWebhookSessionOutcomeEvaluationEndedEventData as BetaWebhookSessionOutcomeEvaluationEndedEventData,
+    type BetaWebhookSessionPendingEventData as BetaWebhookSessionPendingEventData,
+    type BetaWebhookSessionRequiresActionEventData as BetaWebhookSessionRequiresActionEventData,
+    type BetaWebhookSessionRunningEventData as BetaWebhookSessionRunningEventData,
+    type BetaWebhookSessionStatusIdledEventData as BetaWebhookSessionStatusIdledEventData,
+    type BetaWebhookSessionStatusRescheduledEventData as BetaWebhookSessionStatusRescheduledEventData,
+    type BetaWebhookSessionStatusRunStartedEventData as BetaWebhookSessionStatusRunStartedEventData,
+    type BetaWebhookSessionStatusTerminatedEventData as BetaWebhookSessionStatusTerminatedEventData,
+    type BetaWebhookSessionThreadCreatedEventData as BetaWebhookSessionThreadCreatedEventData,
+    type BetaWebhookSessionThreadIdledEventData as BetaWebhookSessionThreadIdledEventData,
+    type BetaWebhookSessionThreadTerminatedEventData as BetaWebhookSessionThreadTerminatedEventData,
+    type BetaWebhookVaultArchivedEventData as BetaWebhookVaultArchivedEventData,
+    type BetaWebhookVaultCreatedEventData as BetaWebhookVaultCreatedEventData,
+    type BetaWebhookVaultCredentialArchivedEventData as BetaWebhookVaultCredentialArchivedEventData,
+    type BetaWebhookVaultCredentialCreatedEventData as BetaWebhookVaultCredentialCreatedEventData,
+    type BetaWebhookVaultCredentialDeletedEventData as BetaWebhookVaultCredentialDeletedEventData,
+    type BetaWebhookVaultCredentialRefreshFailedEventData as BetaWebhookVaultCredentialRefreshFailedEventData,
+    type BetaWebhookVaultDeletedEventData as BetaWebhookVaultDeletedEventData,
+    type UnwrapWebhookEvent as UnwrapWebhookEvent,
+  };
+}

package/src/resources/messages/messages.ts

@@ -337,30 +337,66 @@ export interface CitationCharLocationParam {
 }
 
 export interface CitationContentBlockLocation {
+  /**
+   * The full text of the cited block range, concatenated.
+   *
+   * Always equals the contents of `content[start_block_index:end_block_index]`
+   * joined together. The text block is the minimal citable unit; this field is never
+   * a substring of a single block. Not counted toward output tokens, and not counted
+   * toward input tokens when sent back in subsequent turns.
+   */
   cited_text: string;
 
   document_index: number;
 
   document_title: string | null;
 
+  /**
+   * Exclusive 0-based end index of the cited block range in the source's `content`
+   * array.
+   *
+   * Always greater than `start_block_index`; a single-block citation has
+   * `end_block_index = start_block_index + 1`.
+   */
   end_block_index: number;
 
   file_id: string | null;
 
+  /**
+   * 0-based index of the first cited block in the source's `content` array.
+   */
   start_block_index: number;
 
   type: 'content_block_location';
 }
 
 export interface CitationContentBlockLocationParam {
+  /**
+   * The full text of the cited block range, concatenated.
+   *
+   * Always equals the contents of `content[start_block_index:end_block_index]`
+   * joined together. The text block is the minimal citable unit; this field is never
+   * a substring of a single block. Not counted toward output tokens, and not counted
+   * toward input tokens when sent back in subsequent turns.
+   */
   cited_text: string;
 
   document_index: number;
 
   document_title: string | null;
 
+  /**
+   * Exclusive 0-based end index of the cited block range in the source's `content`
+   * array.
+   *
+   * Always greater than `start_block_index`; a single-block citation has
+   * `end_block_index = start_block_index + 1`.
+   */
   end_block_index: number;
 
+  /**
+   * 0-based index of the first cited block in the source's `content` array.
+   */
   start_block_index: number;
 
   type: 'content_block_location';
@@ -397,14 +433,40 @@ export interface CitationPageLocationParam {
 }
 
 export interface CitationSearchResultLocationParam {
+  /**
+   * The full text of the cited block range, concatenated.
+   *
+   * Always equals the contents of `content[start_block_index:end_block_index]`
+   * joined together. The text block is the minimal citable unit; this field is never
+   * a substring of a single block. Not counted toward output tokens, and not counted
+   * toward input tokens when sent back in subsequent turns.
+   */
   cited_text: string;
 
+  /**
+   * Exclusive 0-based end index of the cited block range in the source's `content`
+   * array.
+   *
+   * Always greater than `start_block_index`; a single-block citation has
+   * `end_block_index = start_block_index + 1`.
+   */
   end_block_index: number;
 
+  /**
+   * 0-based index of the cited search result among all `search_result` content
+   * blocks in the request, in the order they appear across messages and tool
+   * results.
+   *
+   * Counted separately from `document_index`; server-side web search results are not
+   * included in this count.
+   */
   search_result_index: number;
 
   source: string;
 
+  /**
+   * 0-based index of the first cited block in the source's `content` array.
+   */
   start_block_index: number;
 
   title: string | null;
@@ -444,14 +506,40 @@ export interface CitationsDelta {
 }
 
 export interface CitationsSearchResultLocation {
+  /**
+   * The full text of the cited block range, concatenated.
+   *
+   * Always equals the contents of `content[start_block_index:end_block_index]`
+   * joined together. The text block is the minimal citable unit; this field is never
+   * a substring of a single block. Not counted toward output tokens, and not counted
+   * toward input tokens when sent back in subsequent turns.
+   */
   cited_text: string;
 
+  /**
+   * Exclusive 0-based end index of the cited block range in the source's `content`
+   * array.
+   *
+   * Always greater than `start_block_index`; a single-block citation has
+   * `end_block_index = start_block_index + 1`.
+   */
   end_block_index: number;
 
+  /**
+   * 0-based index of the cited search result among all `search_result` content
+   * blocks in the request, in the order they appear across messages and tool
+   * results.
+   *
+   * Counted separately from `document_index`; server-side web search results are not
+   * included in this count.
+   */
   search_result_index: number;
 
   source: string;
 
+  /**
+   * 0-based index of the first cited block in the source's `content` array.
+   */
   start_block_index: number;
 
   title: string | null;

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.93.0'; // x-release-please-version
+export const VERSION = '0.95.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.93.0";
+export declare const VERSION = "0.95.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.93.0";
+export declare const VERSION = "0.95.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.93.0'; // x-release-please-version
+exports.VERSION = '0.95.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.93.0'; // x-release-please-version
+export const VERSION = '0.95.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map