toolbox-browser-api-integration

星标12

分支9

更新时间2026年7月7日 14:51

Implementation patterns for the Vault Toolbox Browser Extension (Manifest V3).

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

来源

veeva

veeva/Vault-Toolbox

打开 GitHub 仓库查看创作者相关仓库

下载

Skill: toolbox-browser-api-integration

This skill provides the procedural knowledge for integrating Vault APIs within a Manifest V3 Chrome Extension.

1. Authentication Flow (Manifest V3)

Storage: Session ID is stored in an HTTP-only Chrome cookie (vaultToolboxSessionId) scoped to the vaultDNS.
Authorization: The request wrapper intercepts calls to query the cookie API (chrome.cookies.get) and inject the Authorization header.
Keep-Alive: Use useVaultSessionKeepAlive.ts to periodically ping the /keep-alive endpoint.

2. API Architecture

Facade Pattern: Centralized in src/app/services/ApiService.js.
VAPIL Entry (Default): Reusable APIs (Metadata, Query) MUST be added to src/app/services/vapil/.
Direct Fetch Forbidden: Never use window.fetch directly; use the request wrapper in VaultRequest.js.
Credentials: Always set credentials: 'omit' in the request wrapper.

3. Telemetry & Normalization

ApiService.js MUST normalize all errors and include telemetry:

{ 
  responseStatus: 'FAILURE', 
  errors: [{ type: 'ErrorType', message: 'Readable message' }],
  responseTelemetry: { responseSizeInKB, executionTimeInMS }
}

同仓库更多 Skills

同仓库

toolbox-browser-brainstormer

veeva/Vault-Toolbox

Specialized design challenges for the Vault Toolbox Browser Extension, focusing on VQL prototyping.

2026-07-0712

toolbox-browser-code-reviewer

veeva/Vault-Toolbox

Specialized audit for the Vault Toolbox Browser Extension, focusing on Island Architecture and UI visibility.

2026-07-0712

toolbox-browser-data-grid

veeva/Vault-Toolbox

Specialized data grid implementation for the Vault Toolbox Browser Extension using TanStack Table/Virtual.

2026-07-0712

toolbox-browser-feature-designer

veeva/Vault-Toolbox

Specialized design requirements for the Vault Toolbox Browser Extension, focusing on UI visibility.

2026-07-0712

toolbox-browser-testing

veeva/Vault-Toolbox

Specialized testing and dev-server protocol for the Vault Toolbox Browser Extension.

2026-07-0712

toolbox-browser-tool-builder

veeva/Vault-Toolbox

Specialized scaffolding and shell integration for the Vault Toolbox Browser Extension.

2026-07-0712

name	toolbox-browser-api-integration
description	Implementation patterns for the Vault Toolbox Browser Extension (Manifest V3).
applicable_apps	["toolbox-browser"]

Skill: toolbox-browser-api-integration

This skill provides the procedural knowledge for integrating Vault APIs within a Manifest V3 Chrome Extension.

1. Authentication Flow (Manifest V3)

Storage: Session ID is stored in an HTTP-only Chrome cookie (vaultToolboxSessionId) scoped to the vaultDNS.
Authorization: The request wrapper intercepts calls to query the cookie API (chrome.cookies.get) and inject the Authorization header.
Keep-Alive: Use useVaultSessionKeepAlive.ts to periodically ping the /keep-alive endpoint.

2. API Architecture

Facade Pattern: Centralized in src/app/services/ApiService.js.
VAPIL Entry (Default): Reusable APIs (Metadata, Query) MUST be added to src/app/services/vapil/.
Direct Fetch Forbidden: Never use window.fetch directly; use the request wrapper in VaultRequest.js.
Credentials: Always set credentials: 'omit' in the request wrapper.

3. Telemetry & Normalization

ApiService.js MUST normalize all errors and include telemetry:

{ 
  responseStatus: 'FAILURE', 
  errors: [{ type: 'ErrorType', message: 'Readable message' }],
  responseTelemetry: { responseSizeInKB, executionTimeInMS }
}