@caido/sdk-frontend 0.53.2-beta.0 → 0.53.2-beta.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caido/sdk-frontend",
-  "version": "0.53.2-beta.0",
+  "version": "0.53.2-beta.10",
   "description": "Typing for the Caido Frontend SDK",
   "author": "Caido Labs Inc. <dev@caido.io>",
   "repository": "https://github.com/caido/sdk-js/",
@@ -19,6 +19,6 @@
   },
   "peerDependenciesMeta": {},
   "scripts": {
-    "documentation": "typedoc"
+    "generate:doc": "typedoc"
   }
 }

package/src/types/__generated__/graphql-sdk.d.ts

@@ -3160,6 +3160,7 @@ export type Runtime = {
     logs: Scalars["Uri"]["output"];
     platform: Scalars["String"]["output"];
     version: Scalars["String"]["output"];
+    workspace?: Maybe<Workspace>;
 };
 export type Scope = {
     allowlist: Array<Scalars["String"]["output"]>;
@@ -3563,6 +3564,7 @@ export type SubscriptionRoot = {
     updatedAutomateTask: UpdatedAutomateTaskPayload;
     updatedBackup: UpdatedBackupPayload;
     updatedBrowser: UpdatedBrowserPayload;
+    updatedCloudStatus: UpdatedCloudStatusPayload;
     updatedDataExport: UpdatedDataExportPayload;
     updatedDeleteInterceptEntriesTask: UpdatedDeleteInterceptEntriesTaskPayload;
     updatedDnsRewrite: UpdatedDnsRewritePayload;
@@ -4438,6 +4440,9 @@ export type UpdatedBackupPayload = {
 export type UpdatedBrowserPayload = {
     browser: Browser;
 };
+export type UpdatedCloudStatusPayload = {
+    cloudStatus: CloudStatus;
+};
 export type UpdatedDnsRewritePayload = {
     rewrite: DnsRewrite;
 };
@@ -4682,6 +4687,11 @@ export type WorkflowUserError = UserError & {
     node?: Maybe<Scalars["String"]["output"]>;
     reason: WorkflowErrorReason;
 };
+export type Workspace = {
+    generation: Scalars["Int"]["output"];
+    id: Scalars["ID"]["output"];
+    name: Scalars["String"]["output"];
+};
 export type AssistantMessageFullFragment = {
     __typename: "AssistantMessage";
     id: string;
@@ -9603,7 +9613,7 @@ export type CreateFindingMutation = {
     };
 };
 export type DeleteFindingsMutationVariables = Exact<{
-    input: DeleteFindingsInput;
+    input?: InputMaybe<DeleteFindingsInput>;
 }>;
 export type DeleteFindingsMutation = {
     deleteFindings: {
@@ -23681,7 +23691,7 @@ export declare const CreatedFindingDocument = "\n    subscription createdFinding
 export declare const DeletedFindingsDocument = "\n    subscription deletedFindings {\n  deletedFindings {\n    deletedFindingIds\n    snapshot\n  }\n}\n    ";
 export declare const UpdatedFindingsDocument = "\n    subscription updatedFindings($order: FindingOrderInput) {\n  updatedFindings {\n    findings {\n      findingEdge(order: $order) {\n        ...findingEdgeMeta\n      }\n      snapshot\n    }\n  }\n}\n    \n    fragment findingEdgeMeta on FindingEdge {\n  cursor\n  node {\n    ...findingMeta\n  }\n}\n    \n\n    fragment findingMeta on Finding {\n  id\n  title\n  reporter\n  host\n  path\n  createdAt\n  request {\n    ...requestMeta\n  }\n}\n    \n\n    fragment requestMeta on Request {\n  __typename\n  id\n  host\n  port\n  path\n  query\n  method\n  edited\n  isTls\n  sni\n  length\n  alteration\n  metadata {\n    ...requestMetadataFull\n  }\n  fileExtension\n  source\n  createdAt\n  response {\n    ...responseMeta\n  }\n  stream {\n    id\n  }\n}\n    \n\n    fragment requestMetadataFull on RequestMetadata {\n  __typename\n  id\n  color\n}\n    \n\n    fragment responseMeta on Response {\n  __typename\n  id\n  statusCode\n  roundtripTime\n  length\n  createdAt\n  alteration\n  edited\n}\n    ";
 export declare const CreateFindingDocument = "\n    mutation createFinding($requestId: ID!, $input: CreateFindingInput!) {\n  createFinding(requestId: $requestId, input: $input) {\n    finding {\n      ...findingFull\n    }\n    error {\n      ... on OtherUserError {\n        ...otherUserErrorFull\n      }\n      ... on UnknownIdUserError {\n        ...unknownIdUserErrorFull\n      }\n    }\n  }\n}\n    \n    fragment findingFull on Finding {\n  ...findingMeta\n  description\n}\n    \n\n    fragment findingMeta on Finding {\n  id\n  title\n  reporter\n  host\n  path\n  createdAt\n  request {\n    ...requestMeta\n  }\n}\n    \n\n    fragment requestMeta on Request {\n  __typename\n  id\n  host\n  port\n  path\n  query\n  method\n  edited\n  isTls\n  sni\n  length\n  alteration\n  metadata {\n    ...requestMetadataFull\n  }\n  fileExtension\n  source\n  createdAt\n  response {\n    ...responseMeta\n  }\n  stream {\n    id\n  }\n}\n    \n\n    fragment requestMetadataFull on RequestMetadata {\n  __typename\n  id\n  color\n}\n    \n\n    fragment responseMeta on Response {\n  __typename\n  id\n  statusCode\n  roundtripTime\n  length\n  createdAt\n  alteration\n  edited\n}\n    \n\n    fragment otherUserErrorFull on OtherUserError {\n  ...userErrorFull\n}\n    \n\n    fragment userErrorFull on UserError {\n  __typename\n  code\n}\n    \n\n    fragment unknownIdUserErrorFull on UnknownIdUserError {\n  ...userErrorFull\n  id\n}\n    ";
-export declare const DeleteFindingsDocument = "\n    mutation deleteFindings($input: DeleteFindingsInput!) {\n  deleteFindings(input: $input) {\n    deletedIds\n  }\n}\n    ";
+export declare const DeleteFindingsDocument = "\n    mutation deleteFindings($input: DeleteFindingsInput) {\n  deleteFindings(input: $input) {\n    deletedIds\n  }\n}\n    ";
 export declare const UpdateFindingDocument = "\n    mutation updateFinding($id: ID!, $input: UpdateFindingInput!) {\n  updateFinding(id: $id, input: $input) {\n    finding {\n      ...findingMeta\n    }\n    error {\n      ... on OtherUserError {\n        ...otherUserErrorFull\n      }\n      ... on UnknownIdUserError {\n        ...unknownIdUserErrorFull\n      }\n    }\n  }\n}\n    \n    fragment findingMeta on Finding {\n  id\n  title\n  reporter\n  host\n  path\n  createdAt\n  request {\n    ...requestMeta\n  }\n}\n    \n\n    fragment requestMeta on Request {\n  __typename\n  id\n  host\n  port\n  path\n  query\n  method\n  edited\n  isTls\n  sni\n  length\n  alteration\n  metadata {\n    ...requestMetadataFull\n  }\n  fileExtension\n  source\n  createdAt\n  response {\n    ...responseMeta\n  }\n  stream {\n    id\n  }\n}\n    \n\n    fragment requestMetadataFull on RequestMetadata {\n  __typename\n  id\n  color\n}\n    \n\n    fragment responseMeta on Response {\n  __typename\n  id\n  statusCode\n  roundtripTime\n  length\n  createdAt\n  alteration\n  edited\n}\n    \n\n    fragment otherUserErrorFull on OtherUserError {\n  ...userErrorFull\n}\n    \n\n    fragment userErrorFull on UserError {\n  __typename\n  code\n}\n    \n\n    fragment unknownIdUserErrorFull on UnknownIdUserError {\n  ...userErrorFull\n  id\n}\n    ";
 export declare const ExportFindingsDocument = "\n    mutation exportFindings($input: ExportFindingsInput!) {\n  exportFindings(input: $input) {\n    export {\n      ...dataExportOnDemandMeta\n    }\n    error {\n      ... on OtherUserError {\n        ...otherUserErrorFull\n      }\n      ... on PermissionDeniedUserError {\n        ...permissionDeniedUserErrorFull\n      }\n    }\n  }\n}\n    \n    fragment dataExportOnDemandMeta on DataExportOnDemand {\n  downloadUri\n  id\n}\n    \n\n    fragment otherUserErrorFull on OtherUserError {\n  ...userErrorFull\n}\n    \n\n    fragment userErrorFull on UserError {\n  __typename\n  code\n}\n    \n\n    fragment permissionDeniedUserErrorFull on PermissionDeniedUserError {\n  ...userErrorFull\n  permissionDeniedReason: reason\n}\n    ";
 export declare const InterceptEntriesDocument = "\n    query interceptEntries($after: String, $first: Int, $before: String, $last: Int, $order: InterceptEntryOrderInput, $filter: HTTPQL, $scopeId: ID) {\n  interceptEntries(\n    after: $after\n    first: $first\n    before: $before\n    last: $last\n    order: $order\n    filter: $filter\n    scopeId: $scopeId\n  ) {\n    edges {\n      ...interceptEntryEdgeMeta\n    }\n    snapshot\n    pageInfo {\n      ...pageInfoFull\n    }\n  }\n}\n    \n    fragment interceptEntryEdgeMeta on InterceptEntryEdge {\n  __typename\n  cursor\n  node {\n    ...interceptEntryMeta\n  }\n}\n    \n\n    fragment interceptEntryMeta on InterceptEntry {\n  __typename\n  id\n  request {\n    ...requestMeta\n  }\n}\n    \n\n    fragment requestMeta on Request {\n  __typename\n  id\n  host\n  port\n  path\n  query\n  method\n  edited\n  isTls\n  sni\n  length\n  alteration\n  metadata {\n    ...requestMetadataFull\n  }\n  fileExtension\n  source\n  createdAt\n  response {\n    ...responseMeta\n  }\n  stream {\n    id\n  }\n}\n    \n\n    fragment requestMetadataFull on RequestMetadata {\n  __typename\n  id\n  color\n}\n    \n\n    fragment responseMeta on Response {\n  __typename\n  id\n  statusCode\n  roundtripTime\n  length\n  createdAt\n  alteration\n  edited\n}\n    \n\n    fragment pageInfoFull on PageInfo {\n  __typename\n  hasPreviousPage\n  hasNextPage\n  startCursor\n  endCursor\n}\n    ";
@@ -23990,7 +24000,7 @@ export declare function getSdk<C>(requester: Requester<C>): {
     deletedFindings(variables?: DeletedFindingsSubscriptionVariables, options?: C): AsyncIterable<DeletedFindingsSubscription>;
     updatedFindings(variables?: UpdatedFindingsSubscriptionVariables, options?: C): AsyncIterable<UpdatedFindingsSubscription>;
     createFinding(variables: CreateFindingMutationVariables, options?: C): Promise<CreateFindingMutation>;
-    deleteFindings(variables: DeleteFindingsMutationVariables, options?: C): Promise<DeleteFindingsMutation>;
+    deleteFindings(variables?: DeleteFindingsMutationVariables, options?: C): Promise<DeleteFindingsMutation>;
     updateFinding(variables: UpdateFindingMutationVariables, options?: C): Promise<UpdateFindingMutation>;
     exportFindings(variables: ExportFindingsMutationVariables, options?: C): Promise<ExportFindingsMutation>;
     interceptEntries(variables?: InterceptEntriesQueryVariables, options?: C): Promise<InterceptEntriesQuery>;

package/src/types/index.d.ts

@@ -2,19 +2,22 @@ export { FooterSlot, type FooterSlotContent } from "./types/footer";
 export type { DialogOptions } from "./types/window";
 export type { CommandContext, CommandContextRequest, CommandContextRequestRow, CommandContextResponse, CommandContextBase, } from "./types/commands";
 export type { MenuItem } from "./types/menu";
-export { type ReplayTab, type ReplaySession, type ReplayCollection, type SendRequestOptions, ReplaySlot, type ReplaySlotContent, type RequestSource, type CurrentReplaySessionChangeEvent, } from "./types/replay";
+export { type ReplayTab, type ReplaySession, type ReplayEntry, type ReplayCollection, type SendRequestOptions, ReplaySlot, type ReplaySlotContent, type RequestSource, type CurrentReplaySessionChangeEvent, } from "./types/replay";
+export { SearchSlot, type SearchSlotContent } from "./types/search";
 export type { HostedFile } from "./types/files";
-export type { Filter } from "./types/filter";
+export { FilterSlot, type Filter, type FilterSlotContent, type CurrentFilterChangeEvent, } from "./types/filter";
 export type { HTTPQL, ID, ComponentDefinition } from "./types/utils";
 export type { JSONValue, JSONCompatible } from "./types/json";
 export type { SlotContent, ButtonSlotContent, CustomSlotContent, CommandSlotContent, } from "./types/slots";
 export type { RequestViewModeOptions, RequestFull, RequestDraft, RequestMeta, } from "./types/request";
-export type { MatchReplaceRule, MatchReplaceCollection, MatchReplaceSection, MatchReplaceSectionRequestAll, MatchReplaceSectionRequestBody, MatchReplaceSectionRequestFirstLine, MatchReplaceSectionRequestHeader, MatchReplaceSectionRequestMethod, MatchReplaceSectionRequestPath, MatchReplaceSectionRequestQuery, MatchReplaceSectionRequestSNI, MatchReplaceSectionResponseAll, MatchReplaceSectionResponseBody, MatchReplaceSectionResponseFirstLine, MatchReplaceSectionResponseHeader, MatchReplaceSectionResponseStatusCode, MatchReplaceOperationStatusCode, MatchReplaceOperationStatusCodeUpdate, MatchReplaceOperationQuery, MatchReplaceOperationQueryRaw, MatchReplaceOperationQueryAdd, MatchReplaceOperationQueryRemove, MatchReplaceOperationQueryUpdate, MatchReplaceOperationPath, MatchReplaceOperationPathRaw, MatchReplaceOperationAll, MatchReplaceOperationAllRaw, MatchReplaceOperationMethod, MatchReplaceOperationMethodUpdate, MatchReplaceOperationHeader, MatchReplaceOperationHeaderRaw, MatchReplaceOperationHeaderAdd, MatchReplaceOperationHeaderRemove, MatchReplaceOperationHeaderUpdate, MatchReplaceOperationBody, MatchReplaceOperationBodyRaw, MatchReplaceOperationFirstLine, MatchReplaceOperationFirstLineRaw, MatchReplaceOperationSNI, MatchReplaceOperationSNIRaw, MatchReplaceReplacer, MatchReplaceReplacerTerm, MatchReplaceReplacerWorkflow, MatchReplaceMatcherName, MatchReplaceMatcherRaw, MatchReplaceMatcherRawFull, MatchReplaceMatcherRawRegex, MatchReplaceMatcherRawValue, } from "./types/matchReplace";
-export type { Scope } from "./types/scopes";
+export type { CurrentMatchReplaceRuleChangeEvent, MatchReplaceRule, MatchReplaceCollection, MatchReplaceSection, MatchReplaceSectionRequestAll, MatchReplaceSectionRequestBody, MatchReplaceSectionRequestFirstLine, MatchReplaceSectionRequestHeader, MatchReplaceSectionRequestMethod, MatchReplaceSectionRequestPath, MatchReplaceSectionRequestQuery, MatchReplaceSectionRequestSNI, MatchReplaceSectionResponseAll, MatchReplaceSectionResponseBody, MatchReplaceSectionResponseFirstLine, MatchReplaceSectionResponseHeader, MatchReplaceSectionResponseStatusCode, MatchReplaceOperationStatusCode, MatchReplaceOperationStatusCodeUpdate, MatchReplaceOperationQuery, MatchReplaceOperationQueryRaw, MatchReplaceOperationQueryAdd, MatchReplaceOperationQueryRemove, MatchReplaceOperationQueryUpdate, MatchReplaceOperationPath, MatchReplaceOperationPathRaw, MatchReplaceOperationAll, MatchReplaceOperationAllRaw, MatchReplaceOperationMethod, MatchReplaceOperationMethodUpdate, MatchReplaceOperationHeader, MatchReplaceOperationHeaderRaw, MatchReplaceOperationHeaderAdd, MatchReplaceOperationHeaderRemove, MatchReplaceOperationHeaderUpdate, MatchReplaceOperationBody, MatchReplaceOperationBodyRaw, MatchReplaceOperationFirstLine, MatchReplaceOperationFirstLineRaw, MatchReplaceOperationSNI, MatchReplaceOperationSNIRaw, MatchReplaceReplacer, MatchReplaceReplacerTerm, MatchReplaceReplacerWorkflow, MatchReplaceMatcherName, MatchReplaceMatcherRaw, MatchReplaceMatcherRawFull, MatchReplaceMatcherRawRegex, MatchReplaceMatcherRawValue, } from "./types/matchReplace";
+export { MatchReplaceSlot, type MatchReplaceSlotContent, } from "./types/matchReplace";
+export { ScopeSlot, type CurrentScopeChangeEvent, type Scope, type ScopeSlotContent, } from "./types/scopes";
+export { HTTPHistorySlot, type HTTPHistorySlotContent, } from "./types/httpHistory";
 export type { EnvironmentVariable } from "./types/environment";
 export type { Workflow, WorkflowKind, OnCreatedWorkflowCallback, OnUpdatedWorkflowCallback, OnDeletedWorkflowCallback, } from "./types/workflows";
 export type { ListenerHandle } from "./types/utils";
-export type { AIProvider } from "./types/ai";
+export type { AIProvider, AILanguageModelSettings, AIReasoningSettings, } from "./types/ai";
 export type { SelectedProjectChangeEvent } from "./types/projects";
 export type { CommandPaletteView } from "./sdks/commandPalette";
 export type { LogSDK } from "./sdks/log";

package/src/types/sdks/filters.d.ts

@@ -1,5 +1,6 @@
-import { type Filter } from "../types/filter";
-import type { HTTPQL, ID } from "../types/utils";
+import { type CurrentFilterChangeEvent, type Filter, type FilterSlotContent } from "../types/filter";
+import { type DefineAddToSlotFn } from "../types/slots";
+import type { HTTPQL, ID, ListenerHandle } from "../types/utils";
 /**
  * SDK for interacting with the Filters page.
  * @category Filters
@@ -45,4 +46,53 @@ export type FiltersSDK = {
      * @param id The ID of the filter to delete.
      */
     delete: (id: ID) => Promise<void>;
+    /**
+     * Get the currently selected filter.
+     * @returns The currently selected filter, or undefined if no filter is selected.
+     */
+    getCurrentFilter: () => Filter | undefined;
+    /**
+     * Subscribe to current filter changes.
+     * @param callback The callback to call when the selected filter changes.
+     * @returns An object with a `stop` method that can be called to stop listening to filter changes.
+     *
+     * @example
+     * ```ts
+     * const handler = sdk.filters.onCurrentFilterChange((event) => {
+     *   console.log(`Filter ${event.filterId} got selected!`);
+     * });
+     *
+     * // Later, stop listening
+     * handler.stop();
+     * ```
+     */
+    onCurrentFilterChange: (callback: (event: CurrentFilterChangeEvent) => void) => ListenerHandle;
+    /**
+     * Add a component to a slot.
+     * @param slot The slot to add the component to.
+     * @param content The content to add to the slot.
+     * @example
+     * ```ts
+     * sdk.filters.addToSlot(FilterSlot.UpdateHeader, {
+     *   type: "Button",
+     *   label: "My Button",
+     *   icon: "my-icon",
+     *   onClick: () => {
+     *     console.log("Button clicked");
+     *   },
+     * });
+     *
+     * sdk.filters.addToSlot(FilterSlot.CreateHeader, {
+     *   type: "Custom",
+     *   definition: MyComponent,
+     * });
+     *
+     * sdk.filters.addToSlot(FilterSlot.UpdateHeader, {
+     *   type: "Command",
+     *   commandId: "my-command",
+     *   icon: "my-icon",
+     * });
+     * ```
+     */
+    addToSlot: DefineAddToSlotFn<FilterSlotContent>;
 };

package/src/types/sdks/httpHistory.d.ts

@@ -1,5 +1,7 @@
 import type { Extension } from "@codemirror/state";
+import type { HTTPHistorySlotContent } from "../types/httpHistory";
 import type { RequestViewModeOptions } from "../types/request";
+import { type DefineAddToSlotFn } from "../types/slots";
 import type { HTTPQL, ID } from "../types/utils";
 /**
  * Utilities to interact with the HTTP History page.
@@ -46,4 +48,32 @@ export type HTTPHistorySDK = {
      * @param id The ID of the entry to scroll to.
      */
     scrollTo: (id: ID) => void;
+    /**
+     * Add a component to a slot.
+     * @param slot The slot to add the component to.
+     * @param content The content to add to the slot.
+     * @example
+     * ```ts
+     * sdk.httpHistory.addToSlot(HTTPHistorySlot.ToolbarPrimary, {
+     *   type: "Button",
+     *   label: "My Button",
+     *   icon: "my-icon",
+     *   onClick: () => {
+     *     console.log("Button clicked");
+     *   },
+     * });
+     *
+     * sdk.httpHistory.addToSlot(HTTPHistorySlot.ToolbarPrimary, {
+     *   type: "Custom",
+     *   definition: MyComponent,
+     * });
+     *
+     * sdk.httpHistory.addToSlot(HTTPHistorySlot.ToolbarPrimary, {
+     *   type: "Command",
+     *   commandId: "my-command",
+     *   icon: "my-icon",
+     * });
+     * ```
+     */
+    addToSlot: DefineAddToSlotFn<HTTPHistorySlotContent>;
 };

package/src/types/sdks/matchReplace.d.ts

@@ -1,5 +1,6 @@
-import { type MatchReplaceCollection, type MatchReplaceRule, type MatchReplaceSection, type Source } from "../types/matchReplace";
-import type { HTTPQL, ID } from "../types/utils";
+import { type CurrentMatchReplaceRuleChangeEvent, type MatchReplaceCollection, type MatchReplaceRule, type MatchReplaceSection, type MatchReplaceSlotContent, type Source } from "../types/matchReplace";
+import { type DefineAddToSlotFn } from "../types/slots";
+import type { HTTPQL, ID, ListenerHandle } from "../types/utils";
 /**
  * Utilities to interact with the Match and Replace page.
  * @category Match and Replace
@@ -47,6 +48,27 @@ export type MatchReplaceSDK = {
      * @param id - The ID of the rule, or undefined to clear the selection.
      */
     selectRule: (id: ID | undefined) => void;
+    /**
+     * Get the currently selected rule.
+     * @returns The currently selected rule, or undefined if no rule is selected.
+     */
+    getCurrentRule: () => MatchReplaceRule | undefined;
+    /**
+     * Subscribe to current rule changes.
+     * @param callback The callback to call when the selected rule changes.
+     * @returns An object with a `stop` method that can be called to stop listening to rule changes.
+     *
+     * @example
+     * ```ts
+     * const handler = sdk.matchReplace.onCurrentRuleChange((event) => {
+     *   console.log(`Rule ${event.ruleId} got selected!`);
+     * });
+     *
+     * // Later, stop listening
+     * handler.stop();
+     * ```
+     */
+    onCurrentRuleChange: (callback: (event: CurrentMatchReplaceRuleChangeEvent) => void) => ListenerHandle;
     /**
      * Create a rule.
      * @param options - The options for the rule.
@@ -88,4 +110,32 @@ export type MatchReplaceSDK = {
      * @param id - The ID of the rule.
      */
     deleteRule: (id: ID) => Promise<void>;
+    /**
+     * Add a component to a slot.
+     * @param slot The slot to add the component to.
+     * @param content The content to add to the slot.
+     * @example
+     * ```ts
+     * sdk.matchReplace.addToSlot(MatchReplaceSlot.UpdateHeader, {
+     *   type: "Button",
+     *   label: "My Button",
+     *   icon: "my-icon",
+     *   onClick: () => {
+     *     console.log("Button clicked");
+     *   },
+     * });
+     *
+     * sdk.matchReplace.addToSlot(MatchReplaceSlot.CreateHeader, {
+     *   type: "Custom",
+     *   definition: MyComponent,
+     * });
+     *
+     * sdk.matchReplace.addToSlot(MatchReplaceSlot.UpdateHeader, {
+     *   type: "Command",
+     *   commandId: "my-command",
+     *   icon: "my-icon",
+     * });
+     * ```
+     */
+    addToSlot: DefineAddToSlotFn<MatchReplaceSlotContent>;
 };

package/src/types/sdks/replay.d.ts

@@ -1,5 +1,5 @@
 import { type Extension } from "@codemirror/state";
-import { type CurrentReplaySessionChangeEvent, type OpenTabOptions, type ReplayCollection, type ReplaySession, type ReplaySlotContent, type ReplayTab, type RequestSource, type SendRequestOptions } from "../types/replay";
+import { type CurrentReplaySessionChangeEvent, type OpenTabOptions, type ReplayCollection, type ReplayCollectionCreatedEvent, type ReplayEntry, type ReplaySession, type ReplaySessionCreatedEvent, type ReplaySlotContent, type ReplayTab, type RequestSource, type SendRequestOptions } from "../types/replay";
 import type { RequestViewModeOptions } from "../types/request";
 import { type DefineAddToSlotFn } from "../types/slots";
 import type { ID, ListenerHandle } from "../types/utils";
@@ -29,6 +29,20 @@ export type ReplaySDK = {
      * @returns The list of all replay sessions.
      */
     getSessions: () => ReplaySession[];
+    /**
+     * Get the currently selected replay session.
+     * @returns The currently selected replay session, or undefined if no session is selected.
+     * @example
+     * ```ts
+     * const currentSession = sdk.replay.getCurrentSession();
+     * if (currentSession) {
+     *   console.log(`Current session: ${currentSession.name}`);
+     * } else {
+     *   console.log("No session is currently selected");
+     * }
+     * ```
+     */
+    getCurrentSession: () => ReplaySession | undefined;
     /**
      * Rename a session.
      * @param id The ID of the session to rename.
@@ -134,6 +148,34 @@ export type ReplaySDK = {
      * ```
      */
     sendRequest: (sessionId: ID, options: SendRequestOptions) => Promise<void>;
+    /**
+     * Show a specific entry in a replay session.
+     * This will open the session tab if not already open, set it as the selected session, and display the specified entry.
+     * @param sessionId The ID of the session containing the entry.
+     * @param entryId The ID of the entry to show.
+     * @param options The options for showing the entry.
+     * @param options.overwriteDraft Whether to overwrite the request draft. If true, the draft will be removed and the entry's raw request will be shown. If false, the draft will be kept.
+     * @example
+     * ```ts
+     * await sdk.replay.showEntry(sessionId, entryId, {
+     *   overwriteDraft: true,
+     * });
+     * ```
+     */
+    showEntry: (sessionId: ID, entryId: ID, options?: {
+        overwriteDraft?: boolean;
+    }) => Promise<void>;
+    /**
+     * Get a replay entry by its ID.
+     * @param entryId The ID of the entry to get.
+     * @returns The replay entry.
+     * @example
+     * ```ts
+     * const entry = await sdk.replay.getEntry(entryId);
+     * console.log(entry.id, entry.sessionId, entry.requestId);
+     * ```
+     */
+    getEntry: (entryId: ID) => ReplayEntry;
     /**
      * Subscribe to current replay session changes.
      * @param callback The callback to call when the selected session changes.
@@ -150,4 +192,36 @@ export type ReplaySDK = {
      * ```
      */
     onCurrentSessionChange: (callback: (event: CurrentReplaySessionChangeEvent) => void) => ListenerHandle;
+    /**
+     * Subscribe to replay session creation events.
+     * @param callback The callback to call when a session is created.
+     * @returns An object with a `stop` method that can be called to stop listening to session creation events.
+     *
+     * @example
+     * ```ts
+     * const handler = sdk.replay.onSessionCreate((event) => {
+     *   console.log(`Session ${event.session.id} was created!`);
+     * });
+     *
+     * // Later, stop listening
+     * handler.stop();
+     * ```
+     */
+    onSessionCreate: (callback: (event: ReplaySessionCreatedEvent) => void) => ListenerHandle;
+    /**
+     * Subscribe to replay collection creation events.
+     * @param callback The callback to call when a collection is created.
+     * @returns An object with a `stop` method that can be called to stop listening to collection creation events.
+     *
+     * @example
+     * ```ts
+     * const handler = sdk.replay.onCollectionCreate((event) => {
+     *   console.log(`Collection ${event.collection.id} was created!`);
+     * });
+     *
+     * // Later, stop listening
+     * handler.stop();
+     * ```
+     */
+    onCollectionCreate: (callback: (event: ReplayCollectionCreatedEvent) => void) => ListenerHandle;
 };

package/src/types/sdks/scopes.d.ts

@@ -1,5 +1,6 @@
-import { type Scope } from "../types/scopes";
-import type { ID } from "../types/utils";
+import { type CurrentScopeChangeEvent, type Scope, type ScopeSlotContent } from "../types/scopes";
+import { type DefineAddToSlotFn } from "../types/slots";
+import type { ID, ListenerHandle } from "../types/utils";
 /**
  * Utilities to interact with scopes
  * @category Scopes
@@ -52,4 +53,53 @@ export type ScopesSDK = {
      * @returns Whether the scope was deleted.
      */
     deleteScope: (id: ID) => Promise<boolean>;
+    /**
+     * Get the currently selected scope.
+     * @returns The currently selected scope, or undefined if no scope is selected.
+     */
+    getCurrentScope: () => Scope | undefined;
+    /**
+     * Subscribe to current scope changes.
+     * @param callback The callback to call when the selected scope changes.
+     * @returns An object with a `stop` method that can be called to stop listening to scope changes.
+     *
+     * @example
+     * ```ts
+     * const handler = sdk.scopes.onCurrentScopeChange((event) => {
+     *   console.log(`Scope ${event.scopeId} got selected!`);
+     * });
+     *
+     * // Later, stop listening
+     * handler.stop();
+     * ```
+     */
+    onCurrentScopeChange: (callback: (event: CurrentScopeChangeEvent) => void) => ListenerHandle;
+    /**
+     * Add a component to a slot.
+     * @param slot The slot to add the component to.
+     * @param content The content to add to the slot.
+     * @example
+     * ```ts
+     * sdk.scopes.addToSlot(ScopeSlot.UpdateHeader, {
+     *   type: "Button",
+     *   label: "My Button",
+     *   icon: "my-icon",
+     *   onClick: () => {
+     *     console.log("Button clicked");
+     *   },
+     * });
+     *
+     * sdk.scopes.addToSlot(ScopeSlot.CreateHeader, {
+     *   type: "Custom",
+     *   definition: MyComponent,
+     * });
+     *
+     * sdk.scopes.addToSlot(ScopeSlot.UpdateHeader, {
+     *   type: "Command",
+     *   commandId: "my-command",
+     *   icon: "my-icon",
+     * });
+     * ```
+     */
+    addToSlot: DefineAddToSlotFn<ScopeSlotContent>;
 };

package/src/types/sdks/search.d.ts

@@ -1,5 +1,6 @@
 import type { Extension } from "@codemirror/state";
 import type { RequestViewModeOptions } from "../types/request";
+import type { SearchSlot, SearchSlotContent } from "../types/search";
 import type { HTTPQL, ID } from "../types/utils";
 /**
  * Utilities to interact with the Search page.
@@ -41,4 +42,10 @@ export type SearchSDK = {
      * @param id The ID of the request to scroll to.
      */
     scrollTo: (id: ID) => void;
+    /**
+     * Add content to a slot in the Search UI.
+     * @param slot The slot to add content to.
+     * @param content The content to add.
+     */
+    addToSlot: <T extends SearchSlot>(slot: T, content: SearchSlotContent[T]) => void;
 };

package/src/types/types/ai.d.ts

@@ -1,6 +1,24 @@
 import { type LanguageModelV2, type ProviderV2 } from "@ai-sdk/provider";
+/**
+ * Settings for AI reasoning.
+ * @category AI
+ */
+export type AIReasoningSettings = {
+    effort: "low" | "medium" | "high";
+};
+/**
+ * Settings for AI language model.
+ * @category AI
+ */
+export type AILanguageModelSettings = {
+    reasoning?: AIReasoningSettings;
+    capabilities?: {
+        reasoning: boolean;
+        structured_output: boolean;
+    };
+};
 /**
  * Official AI Provider to be used by the [ai](https://ai-sdk.dev/) library.
  * @category AI
  */
-export type AIProvider = ProviderV2 & ((modelId: string) => LanguageModelV2);
+export type AIProvider = ProviderV2 & ((modelId: string, settings?: AILanguageModelSettings) => LanguageModelV2);

package/src/types/types/editor.d.ts

@@ -1,6 +1,7 @@
 import type { EditorView } from "@codemirror/view";
 /**
  * Generic editor interface.
+ * @category Editor
  */
 export type Editor = {
     /**
@@ -27,6 +28,10 @@ export type Editor = {
      */
     getEditorView: () => EditorView;
 };
+/**
+ * An HTTP request editor interface.
+ * @category Editor
+ */
 export type HTTPRequestEditor = {
     /**
      * Get the editor element.
@@ -40,6 +45,10 @@ export type HTTPRequestEditor = {
      */
     getEditorView: () => EditorView;
 };
+/**
+ * An HTTP response editor interface.
+ * @category Editor
+ */
 export type HTTPResponseEditor = {
     /**
      * Get the editor element.

package/src/types/types/environment.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Represents an environment variable.
+ * @category Environment
+ */
 export type EnvironmentVariable = {
     /**
      * The name of the environment variable.

package/src/types/types/filter.d.ts

@@ -1,3 +1,4 @@
+import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent } from "./slots";
 import { type HTTPQL, type ID } from "./utils";
 /**
  * Represents a filter.
@@ -22,3 +23,36 @@ export type Filter = {
      */
     query: HTTPQL;
 };
+/**
+ * The slots in the Filters UI.
+ * @category Filters
+ */
+export declare const FilterSlot: {
+    /**
+     * The header area of the preset form update component.
+     */
+    readonly UpdateHeader: "update-header";
+    /**
+     * The header area of the preset form create component.
+     */
+    readonly CreateHeader: "create-header";
+};
+export type FilterSlot = (typeof FilterSlot)[keyof typeof FilterSlot];
+/**
+ * Content that can be added to filter slots.
+ * @category Filter
+ */
+export type FilterSlotContent = {
+    [FilterSlot.UpdateHeader]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
+    [FilterSlot.CreateHeader]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
+};
+/**
+ * Event fired when the current filter changes.
+ * @category Filters
+ */
+export type CurrentFilterChangeEvent = {
+    /**
+     * The ID of the newly selected filter, or undefined if no filter is selected.
+     */
+    filterId: ID | undefined;
+};

package/src/types/types/footer.d.ts

@@ -1,9 +1,17 @@
 import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent } from "./slots";
+/**
+ * The slots in the Footer UI.
+ * @category Footer
+ */
 export declare const FooterSlot: {
     readonly FooterSlotPrimary: "footer-primary";
     readonly FooterSlotSecondary: "footer-secondary";
 };
 export type FooterSlot = (typeof FooterSlot)[keyof typeof FooterSlot];
+/**
+ * Content that can be added to footer slots.
+ * @category Footer
+ */
 export type FooterSlotContent = {
     [FooterSlot.FooterSlotPrimary]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
     [FooterSlot.FooterSlotSecondary]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;

package/src/types/types/httpHistory.d.ts

@@ -0,0 +1,15 @@
+import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent } from "./slots";
+/**
+ * The slots in the HTTP History UI.
+ * @category HTTP History
+ */
+export declare const HTTPHistorySlot: {
+    /**
+     * The toolbar.
+     */
+    readonly ToolbarPrimary: "toolbar-primary";
+};
+export type HTTPHistorySlot = (typeof HTTPHistorySlot)[keyof typeof HTTPHistorySlot];
+export type HTTPHistorySlotContent = {
+    [HTTPHistorySlot.ToolbarPrimary]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
+};

package/src/types/types/json.d.ts

@@ -1,8 +1,16 @@
 type JSONPrimitive = string | number | boolean | null | undefined;
+/**
+ * A JSON-serializable value.
+ * @category JSON
+ */
 export type JSONValue = JSONPrimitive | JSONValue[] | {
     [key: string]: JSONValue;
 };
 type NotAssignableToJson = bigint | symbol | Function;
+/**
+ * A type that ensures all properties of T are JSON-compatible.
+ * @category JSON
+ */
 export type JSONCompatible<T> = unknown extends T ? never : {
     [P in keyof T]: T[P] extends JSONValue ? T[P] : T[P] extends NotAssignableToJson ? never : JSONCompatible<T[P]>;
 };

package/src/types/types/matchReplace.d.ts

@@ -1,3 +1,4 @@
+import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent } from "./slots";
 import { type HTTPQL, type ID } from "./utils";
 /**
  * A rule in Match and Replace.
@@ -30,6 +31,10 @@ export type MatchReplaceRule = {
      */
     collectionId: ID;
 };
+/**
+ * The source of a match and replace rule.
+ * @category Match and Replace
+ */
 export declare const Source: {
     readonly Automate: "AUTOMATE";
     readonly Intercept: "INTERCEPT";
@@ -39,77 +44,165 @@ export declare const Source: {
     readonly Workflow: "WORKFLOW";
 };
 export type Source = (typeof Source)[keyof typeof Source];
+/**
+ * A discriminated union of all possible match and replace sections.
+ * @category Match and Replace
+ */
 export type MatchReplaceSection = MatchReplaceSectionRequestAll | MatchReplaceSectionRequestBody | MatchReplaceSectionRequestFirstLine | MatchReplaceSectionRequestHeader | MatchReplaceSectionRequestMethod | MatchReplaceSectionRequestPath | MatchReplaceSectionRequestQuery | MatchReplaceSectionRequestSNI | MatchReplaceSectionResponseAll | MatchReplaceSectionResponseBody | MatchReplaceSectionResponseFirstLine | MatchReplaceSectionResponseHeader | MatchReplaceSectionResponseStatusCode;
+/**
+ * A section for the entire request.
+ * @category Match and Replace
+ */
 export type MatchReplaceSectionRequestAll = {
     kind: "SectionRequestAll";
     operation: MatchReplaceOperationAll;
 };
+/**
+ * A section for the entire response.
+ * @category Match and Replace
+ */
 export type MatchReplaceSectionResponseAll = {
     kind: "SectionResponseAll";
     operation: MatchReplaceOperationAll;
 };
+/**
+ * An operation for the entire request/response section.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationAll = KeepOperation<MatchReplaceOperationAllRaw>;
+/**
+ * A raw operation for the entire request/response section.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationAllRaw = {
     kind: "OperationAllRaw";
     matcher: MatchReplaceMatcherRaw;
     replacer: MatchReplaceReplacer;
 };
+/**
+ * A section for the response status code.
+ * @category Match and Replace
+ */
 export type MatchReplaceSectionResponseStatusCode = {
     kind: "SectionResponseStatusCode";
     operation: MatchReplaceOperationStatusCode;
 };
+/**
+ * An operation for the response status code section.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationStatusCode = KeepOperation<MatchReplaceOperationStatusCodeUpdate>;
+/**
+ * An operation to update the response status code.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationStatusCodeUpdate = {
     kind: "OperationStatusCodeUpdate";
     replacer: MatchReplaceReplacer;
 };
+/**
+ * A section for the request query string.
+ * @category Match and Replace
+ */
 export type MatchReplaceSectionRequestQuery = {
     kind: "SectionRequestQuery";
     operation: MatchReplaceOperationQuery;
 };
+/**
+ * An operation for the request query section.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationQuery = MatchReplaceOperationQueryRaw | MatchReplaceOperationQueryAdd | MatchReplaceOperationQueryRemove | MatchReplaceOperationQueryUpdate;
+/**
+ * A raw operation for the request query section.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationQueryRaw = {
     kind: "OperationQueryRaw";
     matcher: MatchReplaceMatcherRaw;
     replacer: MatchReplaceReplacer;
 };
+/**
+ * An operation to add a query parameter.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationQueryAdd = {
     kind: "OperationQueryAdd";
     matcher: MatchReplaceMatcherName;
     replacer: MatchReplaceReplacer;
 };
+/**
+ * An operation to remove a query parameter.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationQueryRemove = {
     kind: "OperationQueryRemove";
     matcher: MatchReplaceMatcherName;
 };
+/**
+ * An operation to update a query parameter.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationQueryUpdate = {
     kind: "OperationQueryUpdate";
     matcher: MatchReplaceMatcherName;
     replacer: MatchReplaceReplacer;
 };
+/**
+ * A section for the request path.
+ * @category Match and Replace
+ */
 export type MatchReplaceSectionRequestPath = {
     kind: "SectionRequestPath";
     operation: MatchReplaceOperationPath;
 };
+/**
+ * An operation for the request path section.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationPath = KeepOperation<MatchReplaceOperationPathRaw>;
+/**
+ * A raw operation for the request path section.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationPathRaw = {
     kind: "OperationPathRaw";
     matcher: MatchReplaceMatcherRaw;
     replacer: MatchReplaceReplacer;
 };
+/**
+ * A section for the request method.
+ * @category Match and Replace
+ */
 export type MatchReplaceSectionRequestMethod = {
     kind: "SectionRequestMethod";
     operation: MatchReplaceOperationMethod;
 };
+/**
+ * An operation for the request method section.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationMethod = KeepOperation<MatchReplaceOperationMethodUpdate>;
+/**
+ * An operation to update the request method.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationMethodUpdate = {
     kind: "OperationMethodUpdate";
     replacer: MatchReplaceReplacer;
 };
+/**
+ * A section for the request headers.
+ * @category Match and Replace
+ */
 export type MatchReplaceSectionRequestHeader = {
     kind: "SectionRequestHeader";
     operation: MatchReplaceOperationHeader;
 };
+/**
+ * A section for the response headers.
+ * @category Match and Replace
+ */
 export type MatchReplaceSectionResponseHeader = {
     kind: "SectionResponseHeader";
     operation: MatchReplaceOperationHeader;
@@ -119,29 +212,53 @@ export type MatchReplaceSectionResponseHeader = {
  * @category Match and Replace
  */
 export type MatchReplaceOperationHeader = MatchReplaceOperationHeaderRaw | MatchReplaceOperationHeaderAdd | MatchReplaceOperationHeaderRemove | MatchReplaceOperationHeaderUpdate;
+/**
+ * A raw operation for the header section.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationHeaderRaw = {
     kind: "OperationHeaderRaw";
     matcher: MatchReplaceMatcherRaw;
     replacer: MatchReplaceReplacer;
 };
+/**
+ * An operation to add a header.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationHeaderAdd = {
     kind: "OperationHeaderAdd";
     matcher: MatchReplaceMatcherName;
     replacer: MatchReplaceReplacer;
 };
+/**
+ * An operation to remove a header.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationHeaderRemove = {
     kind: "OperationHeaderRemove";
     matcher: MatchReplaceMatcherName;
 };
+/**
+ * An operation to update a header.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationHeaderUpdate = {
     kind: "OperationHeaderUpdate";
     matcher: MatchReplaceMatcherName;
     replacer: MatchReplaceReplacer;
 };
+/**
+ * A section for the request body.
+ * @category Match and Replace
+ */
 export type MatchReplaceSectionRequestBody = {
     kind: "SectionRequestBody";
     operation: MatchReplaceOperationBody;
 };
+/**
+ * A section for the response body.
+ * @category Match and Replace
+ */
 export type MatchReplaceSectionResponseBody = {
     kind: "SectionResponseBody";
     operation: MatchReplaceOperationBody;
@@ -176,6 +293,10 @@ export type MatchReplaceSectionRequestSNI = {
     kind: "SectionRequestSNI";
     operation: MatchReplaceOperationSNI;
 };
+/**
+ * An operation for the request SNI section.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationSNI = KeepOperation<MatchReplaceOperationSNIRaw>;
 /**
  * A raw operation for the request SNI.
@@ -193,6 +314,10 @@ export type MatchReplaceSectionResponseFirstLine = {
     kind: "SectionResponseFirstLine";
     operation: MatchReplaceOperationFirstLine;
 };
+/**
+ * An operation for the first line section.
+ * @category Match and Replace
+ */
 export type MatchReplaceOperationFirstLine = KeepOperation<MatchReplaceOperationFirstLineRaw>;
 /**
  * A raw operation for the request first line.
@@ -203,6 +328,10 @@ export type MatchReplaceOperationFirstLineRaw = {
     matcher: MatchReplaceMatcherRaw;
     replacer: MatchReplaceReplacer;
 };
+/**
+ * A matcher that matches by name (for headers, query parameters, etc.).
+ * @category Match and Replace
+ */
 export type MatchReplaceMatcherName = {
     kind: "MatcherName";
     name: string;
@@ -270,4 +399,37 @@ export type MatchReplaceCollection = {
 type KeepOperation<T> = T & {
     __operation?: never;
 };
+/**
+ * The slots in the Match and Replace UI.
+ * @category Match and Replace
+ */
+export declare const MatchReplaceSlot: {
+    /**
+     * The header area of the rule form update component.
+     */
+    readonly UpdateHeader: "update-header";
+    /**
+     * The header area of the rule form create component.
+     */
+    readonly CreateHeader: "create-header";
+};
+export type MatchReplaceSlot = (typeof MatchReplaceSlot)[keyof typeof MatchReplaceSlot];
+/**
+ * Content that can be added to match and replace slots.
+ * @category Match and Replace
+ */
+export type MatchReplaceSlotContent = {
+    [MatchReplaceSlot.UpdateHeader]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
+    [MatchReplaceSlot.CreateHeader]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
+};
+/**
+ * Event fired when the current match and replace rule changes.
+ * @category Match and Replace
+ */
+export type CurrentMatchReplaceRuleChangeEvent = {
+    /**
+     * The ID of the newly selected rule, or undefined if no rule is selected.
+     */
+    ruleId: ID | undefined;
+};
 export {};

package/src/types/types/navigation.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Available route identifiers in Caido.
+ * @category Navigation
+ */
 export declare const Routes: {
     readonly Sitemap: "Sitemap";
     readonly Intercept: "Intercept";
@@ -23,6 +27,10 @@ export declare const Routes: {
     readonly Settings: "Settings";
 };
 export type Routes = (typeof Routes)[keyof typeof Routes];
+/**
+ * Event fired when the page changes.
+ * @category Navigation
+ */
 export type PageChangeEvent = {
     type: "Core";
     routeId: Routes;

package/src/types/types/replay.d.ts

@@ -62,6 +62,28 @@ export type ReplaySession = {
      * The ID of the collection the session belongs to.
      */
     collectionId: ID;
+    /**
+     * The IDs of all entries in this session.
+     */
+    entryIds: ID[];
+};
+/**
+ * A replay entry.
+ * @category Replay
+ */
+export type ReplayEntry = {
+    /**
+     * The ID of the entry.
+     */
+    id: ID;
+    /**
+     * The ID of the session this entry belongs to.
+     */
+    sessionId: ID;
+    /**
+     * The ID of the request associated with this entry, if any.
+     */
+    requestId?: ID;
 };
 /**
  * A collection in Replay.
@@ -176,3 +198,23 @@ export type CurrentReplaySessionChangeEvent = {
      */
     sessionId: ID | undefined;
 };
+/**
+ * Event fired when a replay session is created.
+ * @category Replay
+ */
+export type ReplaySessionCreatedEvent = {
+    /**
+     * The newly created replay session.
+     */
+    session: ReplaySession;
+};
+/**
+ * Event fired when a replay collection is created.
+ * @category Replay
+ */
+export type ReplayCollectionCreatedEvent = {
+    /**
+     * The newly created replay collection.
+     */
+    collection: ReplayCollection;
+};

package/src/types/types/request.d.ts

@@ -1,4 +1,8 @@
 import { type As, type ComponentDefinition, type ID, type Prettify } from "./utils";
+/**
+ * A draft request that has not yet been saved to the database.
+ * @category Request
+ */
 export type RequestDraft = Prettify<As<"RequestDraft"> & {
     host: string;
     port: number;
@@ -7,6 +11,10 @@ export type RequestDraft = Prettify<As<"RequestDraft"> & {
     isTls: boolean;
     raw: string;
 }>;
+/**
+ * Metadata about a request without the raw content.
+ * @category Request
+ */
 export type RequestMeta = Prettify<As<"RequestMeta"> & {
     id: ID;
     host: string;
@@ -16,6 +24,10 @@ export type RequestMeta = Prettify<As<"RequestMeta"> & {
     isTls: boolean;
     streamId: ID | undefined;
 }>;
+/**
+ * A complete request with all metadata and raw content.
+ * @category Request
+ */
 export type RequestFull = Prettify<As<"RequestFull"> & {
     id: ID;
     host: string;
@@ -26,6 +38,10 @@ export type RequestFull = Prettify<As<"RequestFull"> & {
     streamId: ID | undefined;
     raw: string;
 }>;
+/**
+ * Options for defining a custom request view mode.
+ * @category Request
+ */
 export type RequestViewModeOptions = {
     /**
      * The label of the view mode.

package/src/types/types/scopes.d.ts

@@ -1,3 +1,4 @@
+import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent } from "./slots";
 import { type ID } from "./utils";
 /**
  * Represents a scope.
@@ -21,3 +22,32 @@ export type Scope = {
      */
     denylist: string[];
 };
+/**
+ * The slots in the Scopes UI.
+ * @category Scopes
+ */
+export declare const ScopeSlot: {
+    /**
+     * The header area of the preset form update component, to the left of the ScopeTooltip.
+     */
+    readonly UpdateHeader: "update-header";
+    /**
+     * The header area of the preset form create component, to the left of the ScopeTooltip.
+     */
+    readonly CreateHeader: "create-header";
+};
+export type ScopeSlot = (typeof ScopeSlot)[keyof typeof ScopeSlot];
+export type ScopeSlotContent = {
+    [ScopeSlot.UpdateHeader]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
+    [ScopeSlot.CreateHeader]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
+};
+/**
+ * Event fired when the current scope changes.
+ * @category Scopes
+ */
+export type CurrentScopeChangeEvent = {
+    /**
+     * The ID of the newly selected scope, or undefined if no scope is selected.
+     */
+    scopeId: ID | undefined;
+};

package/src/types/types/search.d.ts

@@ -0,0 +1,15 @@
+import { type ButtonSlotContent, type CommandSlotContent, type CustomSlotContent } from "./slots";
+/**
+ * The slots in the Search UI.
+ * @category Search
+ */
+export declare const SearchSlot: {
+    /**
+     * The primary slot in the search toolbar.
+     */
+    readonly ToolbarPrimary: "search-toolbar-primary";
+};
+export type SearchSlot = (typeof SearchSlot)[keyof typeof SearchSlot];
+export type SearchSlotContent = {
+    [SearchSlot.ToolbarPrimary]: ButtonSlotContent | CustomSlotContent | CommandSlotContent;
+};

package/src/types/types/slots.d.ts

@@ -3,19 +3,39 @@ import { type ComponentDefinition, type Prettify } from "./utils";
 type DefineSlotContent<TType extends string, P extends Record<string, unknown>> = Prettify<{
     type: TType;
 } & P>;
+/**
+ * Content for a button slot.
+ * @category Slots
+ */
 export type ButtonSlotContent = DefineSlotContent<"Button", {
     label: string;
     icon?: string;
     onClick: () => void;
 }>;
+/**
+ * Content for a custom component slot.
+ * @category Slots
+ */
 export type CustomSlotContent = DefineSlotContent<"Custom", {
     definition: ComponentDefinition;
 }>;
+/**
+ * Content for a command slot.
+ * @category Slots
+ */
 export type CommandSlotContent = DefineSlotContent<"Command", {
     commandId: CommandID;
     icon?: string;
 }>;
+/**
+ * Union type of all possible slot content types.
+ * @category Slots
+ */
 export type SlotContent = ButtonSlotContent | CustomSlotContent | CommandSlotContent;
+/**
+ * A function type for adding content to slots.
+ * @category Slots
+ */
 export type DefineAddToSlotFn<TMap extends Record<string, DefineSlotContent<string, Record<string, unknown>>>> = {
     <K extends keyof TMap>(slot: K, spec: TMap[K]): void;
 };

package/src/types/types/utils.d.ts

@@ -1,6 +1,7 @@
 import { type Component as VueComponent } from "vue";
 /**
  * A unique Caido identifier per type.
+ * @category Utils
  */
 export type ID = string & {
     __id?: never;
@@ -8,6 +9,7 @@ export type ID = string & {
 /**
  * An HTTPQL expression.
  * @example `req.method.eq:"POST"`
+ * @category Utils
  */
 export type HTTPQL = string & {
     __httpql?: never;
@@ -15,22 +17,28 @@ export type HTTPQL = string & {
 /**
  * A {@link https://fontawesome.com/icons|FontAwesome} icon class.
  * @example "fas fa-rocket"
+ * @category Utils
  */
 export type Icon = string & {
     __icon?: never;
 };
 /**
  * A custom component that will be rendered in the UI.
- *
+ * @category Utils
  */
 export type ComponentDefinition = {
     component: VueComponent;
     props?: Record<string, unknown>;
     events?: Record<string, (...args: unknown[]) => void>;
 };
+/**
+ * Utility type for converting endpoint return types to promises.
+ * @category Utils
+ */
 export type PromisifiedReturnType<T extends (...args: unknown[]) => unknown> = ReturnType<T> extends Promise<infer U> ? Promise<U> : Promise<ReturnType<T>>;
 /**
  * A handle for a listener.
+ * @category Utils
  */
 export type ListenerHandle = {
     /**
@@ -38,9 +46,17 @@ export type ListenerHandle = {
      */
     stop: () => void;
 };
+/**
+ * Utility type that prettifies complex types for better IDE display.
+ * @category Utils
+ */
 export type Prettify<T> = {
     [K in keyof T]: T[K];
 } & {};
+/**
+ * Utility type that adds a type discriminator to a type.
+ * @category Utils
+ */
 export type As<TType extends string> = {
     type: TType;
 };

package/src/types/types/window.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Options for configuring a dialog.
+ * @category Window
+ */
 export type DialogOptions = {
     title?: string;
     draggable?: boolean;
@@ -6,6 +10,10 @@ export type DialogOptions = {
     modal?: boolean;
     position?: "left" | "right" | "top" | "bottom" | "center" | "topleft" | "topright" | "bottomleft" | "bottomright";
 };
+/**
+ * A dialog instance that can be closed programmatically.
+ * @category Window
+ */
 export type Dialog = {
     close: () => void;
 };

package/src/types/types/workflows.d.ts

@@ -14,12 +14,24 @@ export type Workflow = {
  * @category Workflows
  */
 export type WorkflowKind = "Convert" | "Active" | "Passive";
+/**
+ * Callback function called when a workflow is created.
+ * @category Workflows
+ */
 export type OnCreatedWorkflowCallback = (event: {
     workflow: Workflow;
 }) => void;
+/**
+ * Callback function called when a workflow is updated.
+ * @category Workflows
+ */
 export type OnUpdatedWorkflowCallback = (event: {
     workflow: Workflow;
 }) => void;
+/**
+ * Callback function called when a workflow is deleted.
+ * @category Workflows
+ */
 export type OnDeletedWorkflowCallback = (event: {
     id: ID;
 }) => void;