Skip to content

Open source file-system and knowledge based agent template. Build AI agents that stay up to date with your knowledge base

init @savoir/sdk

Hugo Richardc87248572f50
diff --git a/apps/api/.gitignore b/apps/api/.gitignore
index d547d8a..0176ded 100644
--- a/apps/api/.gitignore
+++ b/apps/api/.gitignore
@@ -6,3 +6,5 @@ dist
.output
.env
.env.local
+.vercel
+.env*.local
diff --git a/apps/api/lib/sandbox/index.ts b/apps/api/lib/sandbox/index.ts
new file mode 100644
index 0000000..a899c2d
--- /dev/null
+++ b/apps/api/lib/sandbox/index.ts
@@ -0,0 +1,36 @@
+// Types
+export type {
+ ActiveSandbox,
+ FileContent,
+ SandboxManagerConfig,
+ SandboxSession,
+ SearchAndReadResult,
+ SearchResult,
+ SnapshotMetadata,
+} from './types'
+
+// Session management
+export {
+ deleteSession,
+ generateSessionId,
+ getSession,
+ setSession,
+ touchSession,
+} from './session'
+
+// Snapshot management
+export {
+ getCurrentSnapshot,
+ getSnapshotIdOrThrow,
+ hasSnapshot,
+ setCurrentSnapshot,
+} from './snapshot'
+
+// Sandbox operations
+export {
+ createSnapshotFromRepo,
+ getOrCreateSandbox,
+ read,
+ search,
+ searchAndRead,
+} from './manager'
diff --git a/apps/api/lib/sandbox/manager.ts b/apps/api/lib/sandbox/manager.ts
new file mode 100644
index 0000000..db6b4cc
--- /dev/null
+++ b/apps/api/lib/sandbox/manager.ts
@@ -0,0 +1,260 @@
+import { Sandbox } from '@vercel/sandbox'
+import { getLogger } from '@savoir/logger'
+import { useRuntimeConfig } from 'nitro/runtime-config'
+import type { ActiveSandbox, FileContent, SearchAndReadResult, SearchResult, SandboxManagerConfig } from './types'
+import { getSnapshotIdOrThrow } from './snapshot'
+import { deleteSession, generateSessionId, getSession, setSession, touchSession } from './session'
+
+const DEFAULT_SESSION_TTL_MS = 30 * 60 * 1000 // 30 minutes
+const SANDBOX_TIMEOUT_MS = 5 * 60 * 1000 // 5 minutes
+
+/**
+ * Get sandbox configuration from runtime config
+ */
+function getConfig(): SandboxManagerConfig {
+ const config = useRuntimeConfig()
+ return {
+ githubToken: config.githubToken as string | undefined,
+ snapshotRepo: config.snapshotRepo as string,
+ snapshotBranch: (config.snapshotBranch as string) || 'main',
+ sessionTtlMs: DEFAULT_SESSION_TTL_MS,
+ }
+}
+
+/**
+ * Build git source options with authentication for private repos
+ */
+function getGitSourceOptions(repoUrl: string, branch: string, githubToken?: string) {
+ const source: {
+ type: 'git'
+ url: string
+ revision?: string
+ username?: string
+ password?: string
+ } = {
+ type: 'git',
+ url: repoUrl,
+ revision: branch,
+ }
+
+ // Add GitHub credentials for private repos
+ if (githubToken) {
+ source.username = 'x-access-token'
+ source.password = githubToken
+ }
+
+ return source
+}
+
+/**
+ * Create a new sandbox from the current snapshot
+ */
+async function createSandboxFromSnapshot(snapshotId: string): Promise<Sandbox> {
+ const logger = getLogger()
+
+ logger.log('sandbox', `Creating sandbox from snapshot: ${snapshotId}`)
+
+ const sandbox = await Sandbox.create({
+ source: {
+ type: 'snapshot',
+ snapshotId,
+ },
+ timeout: SANDBOX_TIMEOUT_MS,
+ runtime: 'node24',
+ })
+
+ logger.log('sandbox', `Sandbox created: ${sandbox.sandboxId}`)
+ return sandbox
+}
+
+/**
+ * Get an existing sandbox by ID or return null if not available
+ */
+async function getSandboxById(sandboxId: string): Promise<Sandbox | null> {
+ try {
+ const sandbox = await Sandbox.get({ sandboxId })
+
+ if (sandbox.status !== 'running') {
+ return null
+ }
+
+ return sandbox
+ } catch {
+ return null
+ }
+}
+
+/**
+ * Get or create a sandbox for a session
+ * If sessionId is provided, will try to reuse an existing sandbox
+ */
+export async function getOrCreateSandbox(sessionId?: string): Promise<ActiveSandbox> {
+ const logger = getLogger()
+ const config = getConfig()
+
+ // If session ID provided, try to get existing sandbox
+ if (sessionId) {
+ const session = await getSession(sessionId)
+ if (session) {
+ const sandbox = await getSandboxById(session.sandboxId)
+ if (sandbox) {
+ logger.log('sandbox', `Reusing sandbox ${sandbox.sandboxId} for session ${sessionId}`)
+ await touchSession(sessionId, config.sessionTtlMs)
+ return { sandbox, session }
+ }
+ // Sandbox no longer available, clean up session
+ await deleteSession(sessionId)
+ }
+ }
+
+ // Create new sandbox
+ const snapshotId = await getSnapshotIdOrThrow()
+ const sandbox = await createSandboxFromSnapshot(snapshotId)
+
+ // Create session
+ const newSessionId = sessionId || generateSessionId()
+ const session = await setSession(
+ newSessionId,
+ {
+ sandboxId: sandbox.sandboxId,
+ snapshotId,
+ createdAt: Date.now(),
+ },
+ config.sessionTtlMs,
+ )
+
+ return { sandbox, session }
+}
+
+/**
+ * Search files in sandbox using ripgrep
+ */
+export async function search(
+ sandbox: Sandbox,
+ query: string,
+ limit: number = 20,
+): Promise<SearchResult[]> {
+ const logger = getLogger()
+ logger.log('sandbox', `Searching for: ${query}`)
+
+ // Use ripgrep for searching (installed by default in sandbox)
+ const result = await sandbox.runCommand({
+ cmd: 'rg',
+ args: [
+ '--json',
+ '--max-count',
+ String(limit),
+ '--type',
+ 'md',
+ '--type',
+ 'yaml',
+ '--type',
+ 'json',
+ query,
+ '/vercel/sandbox',
+ ],
+ cwd: '/vercel/sandbox',
+ })
+
+ const stdout = await result.stdout()
+ const lines = stdout.split('\n').filter(Boolean)
+
+ const results: SearchResult[] = []
+ for (const line of lines) {
+ try {
+ const json = JSON.parse(line)
+ if (json.type === 'match') {
+ results.push({
+ path: json.data.path.text.replace('/vercel/sandbox/', ''),
+ lineNumber: json.data.line_number,
+ content: json.data.lines.text.trim(),
+ })
+ }
+ } catch {
+ // Skip malformed lines
+ }
+ }
+
+ logger.log('sandbox', `Found ${results.length} matches`)
+ return results
+}
+
+/**
+ * Read files from sandbox
+ */
+export async function read(
+ sandbox: Sandbox,
+ paths: string[],
+): Promise<FileContent[]> {
+ const logger = getLogger()
+ logger.log('sandbox', `Reading ${paths.length} files`)
+
+ const files: FileContent[] = []
+
+ for (const path of paths) {
+ try {
+ const buffer = await sandbox.readFileToBuffer({
+ path,
+ cwd: '/vercel/sandbox',
+ })
+
+ if (buffer) {
+ files.push({
+ path,
+ content: buffer.toString('utf-8'),
+ })
+ }
+ } catch (error) {
+ logger.log('sandbox', `Failed to read file: ${path}`)
+ }
+ }
+
+ logger.log('sandbox', `Read ${files.length} files successfully`)
+ return files
+}
+
+/**
+ * Search and read files in a single operation
+ * Returns matching search results and full file contents for unique files
+ */
+export async function searchAndRead(
+ sandbox: Sandbox,
+ query: string,
+ limit: number = 20,
+): Promise<SearchAndReadResult> {
+ // Search for matches
+ const matches = await search(sandbox, query, limit)
+
+ // Get unique file paths
+ const uniquePaths = [...new Set(matches.map(m => m.path))]
+
+ // Read the unique files
+ const files = await read(sandbox, uniquePaths)
+
+ return { matches, files }
+}
+
+/**
+ * Create a new sandbox from a git repository and take a snapshot
+ * Supports private repos via GitHub token authentication
+ */
+export async function createSnapshotFromRepo(repoUrl: string, branch: string = 'main'): Promise<string> {
+ const config = getConfig()
+ const logger = getLogger()
+
+ logger.log('sandbox', `Creating sandbox from repo: ${repoUrl}#${branch}`)
+
+ const sandbox = await Sandbox.create({
+ source: getGitSourceOptions(repoUrl, branch, config.githubToken),
+ timeout: SANDBOX_TIMEOUT_MS,
+ runtime: 'node24',
+ })
+
+ logger.log('sandbox', `Sandbox created: ${sandbox.sandboxId}, taking snapshot...`)
+
+ // Take snapshot (this also stops the sandbox)
+ const snapshot = await sandbox.snapshot()
+
+ logger.log('sandbox', `Snapshot created: ${snapshot.snapshotId}`)
+ return snapshot.snapshotId
+}
diff --git a/apps/api/lib/sandbox/session.ts b/apps/api/lib/sandbox/session.ts
new file mode 100644
index 0000000..8bf0e88
--- /dev/null
+++ b/apps/api/lib/sandbox/session.ts
@@ -0,0 +1,82 @@
+import { useStorage } from 'nitro/storage'
+import type { SandboxSession } from './types'
+import { KV_KEYS } from './types'
+
+const DEFAULT_SESSION_TTL_MS = 30 * 60 * 1000 // 30 minutes
+
+/**
+ * Get a sandbox session from KV storage
+ */
+export async function getSession(sessionId: string): Promise<SandboxSession | null> {
+ const kv = useStorage('kv')
+ const session = await kv.getItem<SandboxSession>(KV_KEYS.session(sessionId))
+
+ if (!session) {
+ return null
+ }
+
+ // Check if session is expired
+ if (Date.now() > session.expiresAt) {
+ await kv.removeItem(KV_KEYS.session(sessionId))
+ return null
+ }
+
+ return session
+}
+
+/**
+ * Create or update a sandbox session in KV storage
+ */
+export async function setSession(
+ sessionId: string,
+ session: Omit<SandboxSession, 'lastAccessedAt' | 'expiresAt'>,
+ ttlMs: number = DEFAULT_SESSION_TTL_MS,
+): Promise<SandboxSession> {
+ const kv = useStorage('kv')
+ const now = Date.now()
+
+ const fullSession: SandboxSession = {
+ ...session,
+ lastAccessedAt: now,
+ expiresAt: now + ttlMs,
+ }
+
+ await kv.setItem(KV_KEYS.session(sessionId), fullSession)
+ return fullSession
+}
+
+/**
+ * Update the last accessed time for a session
+ */
+export async function touchSession(
+ sessionId: string,
+ ttlMs: number = DEFAULT_SESSION_TTL_MS,
+): Promise<SandboxSession | null> {
+ const session = await getSession(sessionId)
+ if (!session) {
+ return null
+ }
+
+ const now = Date.now()
+ session.lastAccessedAt = now
+ session.expiresAt = now + ttlMs
+
+ const kv = useStorage('kv')
+ await kv.setItem(KV_KEYS.session(sessionId), session)
+ return session
+}
+
+/**
+ * Delete a sandbox session from KV storage
+ */
+export async function deleteSession(sessionId: string): Promise<void> {
+ const kv = useStorage('kv')
+ await kv.removeItem(KV_KEYS.session(sessionId))
+}
+
+/**
+ * Generate a unique session ID
+ */
+export function generateSessionId(): string {
+ return `sess_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`
+}
diff --git a/apps/api/lib/sandbox/snapshot.ts b/apps/api/lib/sandbox/snapshot.ts
new file mode 100644
index 0000000..c1c6003
--- /dev/null
+++ b/apps/api/lib/sandbox/snapshot.ts
@@ -0,0 +1,38 @@
+import { useStorage } from 'nitro/storage'
+import type { SnapshotMetadata } from './types'
+import { KV_KEYS } from './types'
+
+/**
+ * Get the current snapshot metadata from KV storage
+ */
+export async function getCurrentSnapshot(): Promise<SnapshotMetadata | null> {
+ const kv = useStorage('kv')
+ return await kv.getItem<SnapshotMetadata>(KV_KEYS.CURRENT_SNAPSHOT)
+}
+
+/**
+ * Set the current snapshot metadata in KV storage
+ */
+export async function setCurrentSnapshot(metadata: SnapshotMetadata): Promise<void> {
+ const kv = useStorage('kv')
+ await kv.setItem(KV_KEYS.CURRENT_SNAPSHOT, metadata)
+}
+
+/**
+ * Check if a snapshot exists
+ */
+export async function hasSnapshot(): Promise<boolean> {
+ const snapshot = await getCurrentSnapshot()
+ return snapshot !== null
+}
+
+/**
+ * Get snapshot ID or throw if none exists
+ */
+export async function getSnapshotIdOrThrow(): Promise<string> {
+ const snapshot = await getCurrentSnapshot()
+ if (!snapshot) {
+ throw new Error('No snapshot available. Please create a snapshot first.')
+ }
+ return snapshot.snapshotId
+}
diff --git a/apps/api/lib/sandbox/types.ts b/apps/api/lib/sandbox/types.ts
new file mode 100644
index 0000000..c995102
--- /dev/null
+++ b/apps/api/lib/sandbox/types.ts
@@ -0,0 +1,76 @@
+import type { Sandbox } from '@vercel/sandbox'
+
+/**
+ * Sandbox session stored in KV
+ */
+export interface SandboxSession {
+ sandboxId: string
+ snapshotId: string
+ createdAt: number
+ lastAccessedAt: number
+ expiresAt: number
+}
+
+/**
+ * Snapshot metadata stored in KV
+ */
+export interface SnapshotMetadata {
+ snapshotId: string
+ createdAt: number
+ sourceRepo: string
+ commitSha?: string
+}
+
+/**
+ * Search result from ripgrep
+ */
+export interface SearchResult {
+ path: string
+ lineNumber: number
+ content: string
+}
+
+/**
+ * File content with path
+ */
+export interface FileContent {
+ path: string
+ content: string
+}
+
+/**
+ * Search and read combined result
+ */
+export interface SearchAndReadResult {
+ matches: SearchResult[]
+ files: FileContent[]
+}
+
+/**
+ * Sandbox manager configuration
+ * Uses Vercel OIDC token automatically.
+ */
+export interface SandboxManagerConfig {
+ // GitHub authentication for private repos
+ githubToken?: string
+ // Snapshot repository configuration
+ snapshotRepo: string
+ snapshotBranch?: string
+ sessionTtlMs?: number
+}
+
+/**
+ * Active sandbox instance with metadata
+ */
+export interface ActiveSandbox {
+ sandbox: Sandbox
+ session: SandboxSession
+}
+
+/**
+ * KV storage keys
+ */
+export const KV_KEYS = {
+ CURRENT_SNAPSHOT: 'snapshot:current',
+ session: (sessionId: string) => `session:${sessionId}`,
+} as const
diff --git a/apps/api/nitro.config.ts b/apps/api/nitro.config.ts
index daff730..767940a 100644
--- a/apps/api/nitro.config.ts
+++ b/apps/api/nitro.config.ts
@@ -5,6 +5,12 @@ export default defineConfig({
modules: ['workflow/nitro'],
+ storage: {
+ kv: {
+ driver: 'vercel-kv',
+ },
+ },
+
runtimeConfig: {
// GitHub token for API access
githubToken: process.env.GITHUB_TOKEN || '',
diff --git a/apps/api/package.json b/apps/api/package.json
index 3b09d3b..fa7523c 100644
--- a/apps/api/package.json
+++ b/apps/api/package.json
@@ -16,6 +16,8 @@
"@savoir/config": "workspace:*",
"@savoir/logger": "workspace:*",
"@types/node": "^25.0.9",
+ "@vercel/kv": "^3.0.0",
+ "@vercel/sandbox": "^1.2.0",
"giget": "^2.0.0",
"pathe": "^2.0.3",
"workflow": "^4.0.1-beta.48",
diff --git a/apps/api/routes/api/sandbox/read.post.ts b/apps/api/routes/api/sandbox/read.post.ts
new file mode 100644
index 0000000..9547e4a
--- /dev/null
+++ b/apps/api/routes/api/sandbox/read.post.ts
@@ -0,0 +1,40 @@
+import { defineHandler, readValidatedBody } from 'nitro/h3'
+import { z } from 'zod'
+import { getOrCreateSandbox, read } from '~/lib/sandbox'
+
+const bodySchema = z.object({
+ paths: z.array(z.string().min(1)).min(1).max(50),
+ sessionId: z.string().optional(),
+})
+
+/**
+ * POST /api/sandbox/read
+ * Read specific files by path.
+ *
+ * Body:
+ * - paths: string[] - File paths to read (max: 50)
+ * - sessionId: string - Optional session ID for sandbox reuse
+ */
+export default defineHandler(async (event) => {
+ const body = await readValidatedBody(event, bodySchema.parse)
+ const { log } = event.context
+
+ log.set({ pathCount: body.paths.length, sessionId: body.sessionId })
+
+ // Get or create sandbox
+ const { sandbox, session } = await getOrCreateSandbox(body.sessionId)
+
+ log.set({ sandboxId: sandbox.sandboxId })
+
+ // Read files
+ const files = await read(sandbox, body.paths)
+
+ log.set({ fileCount: files.length })
+
+ return {
+ sessionId: session.sandboxId.startsWith('sess_')
+ ? body.sessionId
+ : `sess_${session.sandboxId}`,
+ files,
+ }
+})
diff --git a/apps/api/routes/api/sandbox/search-and-read.post.ts b/apps/api/routes/api/sandbox/search-and-read.post.ts
new file mode 100644
index 0000000..a14607b
--- /dev/null
+++ b/apps/api/routes/api/sandbox/search-and-read.post.ts
@@ -0,0 +1,46 @@
+import { defineHandler, readValidatedBody } from 'nitro/h3'
+import { z } from 'zod'
+import { getOrCreateSandbox, searchAndRead } from '~/lib/sandbox'
+
+const bodySchema = z.object({
+ query: z.string().min(1).max(500),
+ limit: z.number().int().min(1).max(100).default(20),
+ sessionId: z.string().optional(),
+})
+
+/**
+ * POST /api/sandbox/search-and-read
+ * Search for content and return matching files.
+ *
+ * Body:
+ * - query: string - Search query (ripgrep pattern)
+ * - limit: number - Maximum results (default: 20, max: 100)
+ * - sessionId: string - Optional session ID for sandbox reuse
+ */
+export default defineHandler(async (event) => {
+ const body = await readValidatedBody(event, bodySchema.parse)
+ const { log } = event.context
+
+ log.set({ query: body.query, limit: body.limit, sessionId: body.sessionId })
+
+ // Get or create sandbox
+ const { sandbox, session } = await getOrCreateSandbox(body.sessionId)
+
+ log.set({ sandboxId: sandbox.sandboxId })
+
+ // Search and read files
+ const result = await searchAndRead(sandbox, body.query, body.limit)
+
+ log.set({
+ matchCount: result.matches.length,
+ fileCount: result.files.length,
+ })
+
+ return {
+ sessionId: session.sandboxId.startsWith('sess_')
+ ? body.sessionId
+ : `sess_${session.sandboxId}`,
+ matches: result.matches,
+ files: result.files,
+ }
+})
diff --git a/apps/api/routes/api/sandbox/search.post.ts b/apps/api/routes/api/sandbox/search.post.ts
new file mode 100644
index 0000000..d1d713a
--- /dev/null
+++ b/apps/api/routes/api/sandbox/search.post.ts
@@ -0,0 +1,42 @@
+import { defineHandler, readValidatedBody } from 'nitro/h3'
+import { z } from 'zod'
+import { getOrCreateSandbox, search } from '~/lib/sandbox'
+
+const bodySchema = z.object({
+ query: z.string().min(1).max(500),
+ limit: z.number().int().min(1).max(100).default(20),
+ sessionId: z.string().optional(),
+})
+
+/**
+ * POST /api/sandbox/search
+ * Search for content and return matching lines.
+ *
+ * Body:
+ * - query: string - Search query (ripgrep pattern)
+ * - limit: number - Maximum results (default: 20, max: 100)
+ * - sessionId: string - Optional session ID for sandbox reuse
+ */
+export default defineHandler(async (event) => {
+ const body = await readValidatedBody(event, bodySchema.parse)
+ const { log } = event.context
+
+ log.set({ query: body.query, limit: body.limit, sessionId: body.sessionId })
+
+ // Get or create sandbox
+ const { sandbox, session } = await getOrCreateSandbox(body.sessionId)
+
+ log.set({ sandboxId: sandbox.sandboxId })
+
+ // Search files
+ const matches = await search(sandbox, body.query, body.limit)
+
+ log.set({ matchCount: matches.length })
+
+ return {
+ sessionId: session.sandboxId.startsWith('sess_')
+ ? body.sessionId
+ : `sess_${session.sandboxId}`,
+ matches,
+ }
+})
diff --git a/apps/api/routes/api/sandbox/snapshot.post.ts b/apps/api/routes/api/sandbox/snapshot.post.ts
new file mode 100644
index 0000000..5ac897b
--- /dev/null
+++ b/apps/api/routes/api/sandbox/snapshot.post.ts
@@ -0,0 +1,33 @@
+import { start } from 'workflow/api'
+import { defineHandler } from 'nitro/h3'
+import { useRuntimeConfig } from 'nitro/runtime-config'
+import { createSnapshot } from '~/workflows/create-snapshot'
+
+/**
+ * POST /api/sandbox/snapshot
+ * Create a new sandbox snapshot from the documentation repository.
+ *
+ * This workflow:
+ * 1. Creates a sandbox from the GitHub snapshot repo
+ * 2. Takes a snapshot for instant startup
+ * 3. Stores the snapshot ID in KV storage
+ */
+export default defineHandler(async (event) => {
+ const config = useRuntimeConfig()
+ const { log } = event.context
+
+ const snapshotConfig = {
+ githubToken: config.githubToken, // For private repos
+ snapshotRepo: config.snapshotRepo,
+ snapshotBranch: config.snapshotBranch,
+ }
+
+ log.set({ snapshotRepo: config.snapshotRepo })
+
+ await start(createSnapshot, [snapshotConfig])
+
+ return {
+ status: 'started',
+ message: 'Snapshot workflow started. Use `pnpm workflow:web` to monitor.',
+ }
+})
diff --git a/apps/api/workflows/create-snapshot/index.ts b/apps/api/workflows/create-snapshot/index.ts
new file mode 100644
index 0000000..f2782de
--- /dev/null
+++ b/apps/api/workflows/create-snapshot/index.ts
@@ -0,0 +1 @@
+export { createSnapshot } from './workflow.js'
diff --git a/apps/api/workflows/create-snapshot/workflow.ts b/apps/api/workflows/create-snapshot/workflow.ts
new file mode 100644
index 0000000..a5162d1
--- /dev/null
+++ b/apps/api/workflows/create-snapshot/workflow.ts
@@ -0,0 +1,142 @@
+import { Sandbox } from '@vercel/sandbox'
+import { kv } from '@vercel/kv'
+import { getLogger } from '@savoir/logger'
+import { FatalError } from 'workflow'
+import type { SnapshotMetadata } from '../../lib/sandbox/types.js'
+
+interface SnapshotConfig {
+ // GitHub auth for private repos
+ githubToken?: string
+ // Snapshot repo config
+ snapshotRepo: string
+ snapshotBranch: string
+}
+
+interface SnapshotWorkflowResult {
+ success: boolean
+ snapshotId?: string
+ error?: string
+}
+
+/**
+ * Step: Create sandbox from GitHub repository
+ */
+async function createSandboxStep(config: SnapshotConfig): Promise<Sandbox> {
+ 'use step'
+
+ const logger = getLogger()
+ const repoUrl = `https://github.com/${config.snapshotRepo}.git`
+
+ logger.log('snapshot', `Creating sandbox from: ${repoUrl}#${config.snapshotBranch}`)
+
+ // Build git source with optional GitHub auth for private repos
+ const source: {
+ type: 'git'
+ url: string
+ revision: string
+ username?: string
+ password?: string
+ } = {
+ type: 'git',
+ url: repoUrl,
+ revision: config.snapshotBranch,
+ }
+
+ // Add GitHub credentials for private repos
+ if (config.githubToken) {
+ source.username = 'x-access-token'
+ source.password = config.githubToken
+ }
+
+ const sandbox = await Sandbox.create({
+ source,
+ timeout: 2 * 60 * 1000, // 2 minutes
+ runtime: 'node24',
+ })
+
+ logger.log('snapshot', `Sandbox created: ${sandbox.sandboxId}`)
+ return sandbox
+}
+
+/**
+ * Step: Take a snapshot of the sandbox
+ */
+async function takeSnapshotStep(sandbox: Sandbox): Promise<string> {
+ 'use step'
+
+ const logger = getLogger()
+ logger.log('snapshot', 'Taking snapshot...')
+
+ // This also stops the sandbox automatically
+ const snapshot = await sandbox.snapshot()
+
+ logger.log('snapshot', `Snapshot created: ${snapshot.snapshotId}`)
+ return snapshot.snapshotId
+}
+
+/**
+ * Step: Store snapshot metadata in KV
+ */
+async function storeSnapshotMetadataStep(
+ snapshotId: string,
+ sourceRepo: string,
+): Promise<void> {
+ 'use step'
+
+ const logger = getLogger()
+ logger.log('snapshot', 'Storing snapshot metadata in KV...')
+
+ const metadata: SnapshotMetadata = {
+ snapshotId,
+ createdAt: Date.now(),
+ sourceRepo,
+ }
+
+ await kv.set('snapshot:current', metadata)
+
+ logger.log('snapshot', 'Snapshot metadata stored successfully')
+}
+
+/**
+ * Workflow: Create a new snapshot from the documentation repository
+ * Uses Vercel OIDC token automatically.
+ * Supports private repos via GitHub token authentication.
+ */
+export async function createSnapshot(
+ config: SnapshotConfig,
+): Promise<SnapshotWorkflowResult> {
+ 'use workflow'
+
+ const logger = getLogger()
+
+ // Validate required configuration
+ if (!config.snapshotRepo) {
+ throw new FatalError('GITHUB_SNAPSHOT_REPO is not configured')
+ }
+
+ try {
+ // Step 1: Create sandbox from repository
+ const sandbox = await createSandboxStep(config)
+
+ // Step 2: Take snapshot (this also stops the sandbox)
+ const snapshotId = await takeSnapshotStep(sandbox)
+
+ // Step 3: Store snapshot metadata
+ await storeSnapshotMetadataStep(snapshotId, config.snapshotRepo)
+
+ logger.log('snapshot', `✓ Snapshot workflow completed: ${snapshotId}`)
+
+ return {
+ success: true,
+ snapshotId,
+ }
+ } catch (error) {
+ const errorMessage = error instanceof Error ? error.message : String(error)
+ logger.log('snapshot', `✗ Snapshot workflow failed: ${errorMessage}`)
+
+ return {
+ success: false,
+ error: errorMessage,
+ }
+ }
+}
diff --git a/apps/api/workflows/sync-docs/steps/index.ts b/apps/api/workflows/sync-docs/steps/index.ts
index 6a7bfd5..0152c7e 100644
--- a/apps/api/workflows/sync-docs/steps/index.ts
+++ b/apps/api/workflows/sync-docs/steps/index.ts
@@ -3,3 +3,4 @@ export { getSourcesToSync } from './get-sources.js'
export { syncSingleSource } from './sync-source.js'
export { pushToSnapshotStep } from './push-snapshot.js'
export { cleanupWorkspace } from './cleanup.js'
+export { triggerSnapshotStep } from './trigger-snapshot.js'
diff --git a/apps/api/workflows/sync-docs/steps/trigger-snapshot.ts b/apps/api/workflows/sync-docs/steps/trigger-snapshot.ts
new file mode 100644
index 0000000..2d65c12
--- /dev/null
+++ b/apps/api/workflows/sync-docs/steps/trigger-snapshot.ts
@@ -0,0 +1,23 @@
+import { getLogger } from '@savoir/logger'
+import { start } from 'workflow/api'
+import { createSnapshot } from '../../create-snapshot/index.js'
+
+interface SnapshotConfig {
+ // GitHub auth for private repos
+ githubToken?: string
+ // Snapshot repo config
+ snapshotRepo: string
+ snapshotBranch: string
+}
+
+export async function triggerSnapshotStep(config: SnapshotConfig): Promise<void> {
+ 'use step'
+
+ const logger = getLogger()
+ logger.log('sync', 'Triggering snapshot creation...')
+
+ // Start the snapshot workflow asynchronously
+ await start(createSnapshot, [config])
+
+ logger.log('sync', 'Snapshot workflow started')
+}
diff --git a/apps/api/workflows/sync-docs/workflow.ts b/apps/api/workflows/sync-docs/workflow.ts
index 8097a27..a5d602e 100644
--- a/apps/api/workflows/sync-docs/workflow.ts
+++ b/apps/api/workflows/sync-docs/workflow.ts
@@ -7,6 +7,7 @@ import {
syncSingleSource,
pushToSnapshotStep,
cleanupWorkspace,
+ triggerSnapshotStep,
} from './steps/index.js'
interface SyncWorkflowResult {
@@ -60,6 +61,15 @@ export async function syncDocumentation(
let pushResult = null
if (push && successCount > 0) {
pushResult = await pushToSnapshotStep(syncDir, config, successCount, totalFiles)
+
+ // Trigger sandbox snapshot creation after successful push
+ if (pushResult.success) {
+ await triggerSnapshotStep({
+ githubToken: config.githubToken, // For private repos
+ snapshotRepo: config.snapshotRepo,
+ snapshotBranch: config.snapshotBranch,
+ })
+ }
}
await cleanupWorkspace(syncDir)
diff --git a/packages/sdk/.gitkeep b/packages/sdk/.gitkeep
deleted file mode 100644
index e69de29..0000000
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
new file mode 100644
index 0000000..48092fa
--- /dev/null
+++ b/packages/sdk/package.json
@@ -0,0 +1,51 @@
+{
+ "name": "@savoir/sdk",
+ "version": "0.0.1",
+ "description": "SDK for Savoir documentation AI with AI SDK compatible tools",
+ "type": "module",
+ "exports": {
+ ".": {
+ "import": {
+ "types": "./dist/index.d.ts",
+ "default": "./dist/index.js"
+ },
+ "require": {
+ "types": "./dist/index.d.cts",
+ "default": "./dist/index.cjs"
+ }
+ }
+ },
+ "main": "./dist/index.cjs",
+ "module": "./dist/index.js",
+ "types": "./dist/index.d.ts",
+ "sideEffects": false,
+ "files": [
+ "dist"
+ ],
+ "scripts": {
+ "build": "tsdown",
+ "dev": "tsdown --watch",
+ "typecheck": "tsc --noEmit",
+ "lint": "eslint .",
+ "lint:fix": "eslint . --fix",
+ "prepublishOnly": "pnpm build"
+ },
+ "dependencies": {
+ "ai": "^4.3.16",
+ "zod": "^3.25.28"
+ },
+ "devDependencies": {
+ "@types/node": "^22.15.21",
+ "eslint": "^9.28.0",
+ "tsdown": "^0.12.4",
+ "typescript": "^5.8.3"
+ },
+ "peerDependencies": {
+ "ai": ">=4.0.0"
+ },
+ "peerDependenciesMeta": {
+ "ai": {
+ "optional": true
+ }
+ }
+}
diff --git a/packages/sdk/src/client.ts b/packages/sdk/src/client.ts
new file mode 100644
index 0000000..9e9dacf
--- /dev/null
+++ b/packages/sdk/src/client.ts
@@ -0,0 +1,125 @@
+import type {
+ ReadResponse,
+ SavoirConfig,
+ SearchAndReadResponse,
+ SearchResponse,
+} from './types'
+import { NetworkError, SavoirError } from './errors'
+
+const DEFAULT_API_URL = 'https://api.savoir.dev'
+
+/**
+ * HTTP client for the Savoir API
+ */
+export class SavoirClient {
+
+ private readonly apiUrl: string
+ private readonly apiKey: string
+ private sessionId?: string
+
+ constructor(config: SavoirConfig) {
+ this.apiUrl = config.apiUrl?.replace(/\/$/, '') || DEFAULT_API_URL
+ this.apiKey = config.apiKey
+ this.sessionId = config.sessionId
+ }
+
+ /**
+ * Get the current session ID
+ */
+ getSessionId(): string | undefined {
+ return this.sessionId
+ }
+
+ /**
+ * Set the session ID for subsequent requests
+ */
+ setSessionId(sessionId: string): void {
+ this.sessionId = sessionId
+ }
+
+ /**
+ * Make a request to the API
+ */
+ private async request<T>(
+ path: string,
+ body: Record<string, unknown>,
+ ): Promise<T> {
+ const url = `${this.apiUrl}${path}`
+
+ try {
+ const response = await fetch(url, {
+ method: 'POST',
+ headers: {
+ 'Content-Type': 'application/json',
+ 'Authorization': `Bearer ${this.apiKey}`,
+ },
+ body: JSON.stringify({
+ ...body,
+ sessionId: this.sessionId,
+ }),
+ })
+
+ const data = await response.json()
+
+ if (!response.ok) {
+ throw new SavoirError({
+ statusCode: response.status,
+ message: data.message || 'Unknown error',
+ error: data.error,
+ })
+ }
+
+ // Update session ID from response
+ if (data.sessionId) {
+ this.sessionId = data.sessionId
+ }
+
+ return data as T
+ } catch (error) {
+ if (error instanceof SavoirError) {
+ throw error
+ }
+
+ throw new NetworkError(
+ `Failed to connect to Savoir API: ${error instanceof Error ? error.message : 'Unknown error'}`,
+ error instanceof Error ? error : undefined,
+ )
+ }
+ }
+
+ /**
+ * Search for content and return matching files
+ */
+ async searchAndRead(
+ query: string,
+ limit: number = 20,
+ ): Promise<SearchAndReadResponse> {
+ return await this.request<SearchAndReadResponse>('/api/sandbox/search-and-read', {
+ query,
+ limit,
+ })
+ }
+
+ /**
+ * Search for content and return matching lines
+ */
+ async search(
+ query: string,
+ limit: number = 20,
+ ): Promise<SearchResponse> {
+ return await this.request<SearchResponse>('/api/sandbox/search', {
+ query,
+ limit,
+ })
+ }
+
+ /**
+ * Read specific files by path
+ */
+ async read(paths: string[]): Promise<ReadResponse> {
+ return await this.request<ReadResponse>('/api/sandbox/read', {
+ paths,
+ })
+ }
+
+}
diff --git a/packages/sdk/src/errors.ts b/packages/sdk/src/errors.ts
new file mode 100644
index 0000000..9d40aaa
--- /dev/null
+++ b/packages/sdk/src/errors.ts
@@ -0,0 +1,54 @@
+import type { ApiErrorResponse } from './types'
+
+/**
+ * Error class for Savoir API errors
+ */
+export class SavoirError extends Error {
+
+ readonly statusCode: number
+ readonly error?: string
+
+ constructor(response: ApiErrorResponse) {
+ super(response.message)
+ this.name = 'SavoirError'
+ this.statusCode = response.statusCode
+ this.error = response.error
+ }
+
+ /**
+ * Check if the error is due to invalid authentication
+ */
+ isAuthError(): boolean {
+ return this.statusCode === 401
+ }
+
+ /**
+ * Check if the error is due to rate limiting
+ */
+ isRateLimitError(): boolean {
+ return this.statusCode === 429
+ }
+
+ /**
+ * Check if the error is a server error
+ */
+ isServerError(): boolean {
+ return this.statusCode >= 500
+ }
+
+}
+
+/**
+ * Error class for network-related errors
+ */
+export class NetworkError extends Error {
+
+ readonly cause?: Error
+
+ constructor(message: string, cause?: Error) {
+ super(message)
+ this.name = 'NetworkError'
+ this.cause = cause
+ }
+
+}
diff --git a/packages/sdk/src/index.ts b/packages/sdk/src/index.ts
new file mode 100644
index 0000000..24d505a
--- /dev/null
+++ b/packages/sdk/src/index.ts
@@ -0,0 +1,71 @@
+import { SavoirClient } from './client'
+import { createReadTool, createSearchAndReadTool, createSearchTool } from './tools'
+import type { SavoirConfig } from './types'
+
+export type { SavoirConfig, SearchResult, FileContent, SearchAndReadResponse, SearchResponse, ReadResponse } from './types'
+export { SavoirError, NetworkError } from './errors'
+export { SavoirClient } from './client'
+
+/**
+ * Savoir instance with client and AI SDK tools
+ */
+export interface Savoir {
+ /**
+ * HTTP client for direct API access
+ */
+ client: SavoirClient
+
+ /**
+ * AI SDK compatible tools
+ */
+ tools: {
+ searchAndRead: ReturnType<typeof createSearchAndReadTool>
+ search: ReturnType<typeof createSearchTool>
+ read: ReturnType<typeof createReadTool>
+ }
+
+ /**
+ * Get the current session ID
+ */
+ getSessionId: () => string | undefined
+
+ /**
+ * Set the session ID for subsequent requests
+ */
+ setSessionId: (sessionId: string) => void
+}
+
+/**
+ * Create a Savoir instance with API client and AI SDK tools
+ *
+ * @example
+ * ```ts
+ * import { createSavoir } from '@savoir/sdk'
+ * import { generateText } from 'ai'
+ *
+ * const savoir = createSavoir({
+ * apiKey: process.env.SAVOIR_API_KEY!,
+ * sessionId: 'optional-session-id', // For sandbox reuse
+ * })
+ *
+ * const { text } = await generateText({
+ * model: 'google/gemini-3-flash',
+ * tools: savoir.tools,
+ * prompt: 'How to use useAsyncData in Nuxt?',
+ * })
+ * ```
+ */
+export function createSavoir(config: SavoirConfig): Savoir {
+ const client = new SavoirClient(config)
+
+ return {
+ client,
+ tools: {
+ searchAndRead: createSearchAndReadTool(client),
+ search: createSearchTool(client),
+ read: createReadTool(client),
+ },
+ getSessionId: () => client.getSessionId(),
+ setSessionId: (sessionId: string) => client.setSessionId(sessionId),
+ }
+}
diff --git a/packages/sdk/src/tools/index.ts b/packages/sdk/src/tools/index.ts
new file mode 100644
index 0000000..fbdd93f
--- /dev/null
+++ b/packages/sdk/src/tools/index.ts
@@ -0,0 +1,3 @@
+export { createSearchAndReadTool } from './search-and-read'
+export { createSearchTool } from './search'
+export { createReadTool } from './read'
diff --git a/packages/sdk/src/tools/read.ts b/packages/sdk/src/tools/read.ts
new file mode 100644
index 0000000..47f42e7
--- /dev/null
+++ b/packages/sdk/src/tools/read.ts
@@ -0,0 +1,28 @@
+import { tool } from 'ai'
+import { z } from 'zod'
+import type { SavoirClient } from '../client'
+
+/**
+ * Create the read tool for AI SDK
+ */
+export function createReadTool(client: SavoirClient) {
+ return tool({
+ description: `Read specific documentation files by their paths.
+Use this tool when you know the exact file paths you want to read.
+Returns the full content of each requested file.`,
+ parameters: z.object({
+ paths: z.array(z.string()).min(1).max(50).describe('Array of file paths to read'),
+ }),
+ execute: async ({ paths }) => {
+ const result = await client.read(paths)
+
+ return {
+ fileCount: result.files.length,
+ files: result.files.map(f => ({
+ path: f.path,
+ content: f.content,
+ })),
+ }
+ },
+ })
+}
diff --git a/packages/sdk/src/tools/search-and-read.ts b/packages/sdk/src/tools/search-and-read.ts
new file mode 100644
index 0000000..cdba636
--- /dev/null
+++ b/packages/sdk/src/tools/search-and-read.ts
@@ -0,0 +1,35 @@
+import { tool } from 'ai'
+import { z } from 'zod'
+import type { SavoirClient } from '../client'
+
+/**
+ * Create the searchAndRead tool for AI SDK
+ */
+export function createSearchAndReadTool(client: SavoirClient) {
+ return tool({
+ description: `Search the documentation for content matching a query and return the full file contents.
+Use this tool to find relevant documentation about a topic.
+Returns both the matching lines with context and the complete file contents for deeper understanding.`,
+ parameters: z.object({
+ query: z.string().describe('The search query (supports regex patterns)'),
+ limit: z.number().int().min(1).max(100).default(20).describe('Maximum number of results to return'),
+ }),
+ execute: async ({ query, limit }) => {
+ const result = await client.searchAndRead(query, limit)
+
+ return {
+ matchCount: result.matches.length,
+ fileCount: result.files.length,
+ matches: result.matches.map(m => ({
+ path: m.path,
+ line: m.lineNumber,
+ content: m.content,
+ })),
+ files: result.files.map(f => ({
+ path: f.path,
+ content: f.content,
+ })),
+ }
+ },
+ })
+}
diff --git a/packages/sdk/src/tools/search.ts b/packages/sdk/src/tools/search.ts
new file mode 100644
index 0000000..820acf9
--- /dev/null
+++ b/packages/sdk/src/tools/search.ts
@@ -0,0 +1,31 @@
+import { tool } from 'ai'
+import { z } from 'zod'
+import type { SavoirClient } from '../client'
+
+/**
+ * Create the search tool for AI SDK
+ */
+export function createSearchTool(client: SavoirClient) {
+ return tool({
+ description: `Search the documentation for content matching a query.
+Use this tool to find file paths and line numbers that match a search pattern.
+Returns the matching lines with their file paths and line numbers.
+For full file contents, use the read tool after finding relevant files.`,
+ parameters: z.object({
+ query: z.string().describe('The search query (supports regex patterns)'),
+ limit: z.number().int().min(1).max(100).default(20).describe('Maximum number of results to return'),
+ }),
+ execute: async ({ query, limit }) => {
+ const result = await client.search(query, limit)
+
+ return {
+ matchCount: result.matches.length,
+ matches: result.matches.map(m => ({
+ path: m.path,
+ line: m.lineNumber,
+ content: m.content,
+ })),
+ }
+ },
+ })
+}
diff --git a/packages/sdk/src/types.ts b/packages/sdk/src/types.ts
new file mode 100644
index 0000000..01fed8e
--- /dev/null
+++ b/packages/sdk/src/types.ts
@@ -0,0 +1,72 @@
+/**
+ * Configuration options for creating a Savoir client
+ */
+export interface SavoirConfig {
+ /**
+ * Base URL for the Savoir API
+ * @default 'https://api.savoir.dev'
+ */
+ apiUrl?: string
+
+ /**
+ * API key for authentication
+ */
+ apiKey: string
+
+ /**
+ * Optional session ID for sandbox reuse
+ * When provided, the same sandbox will be reused for multiple requests
+ */
+ sessionId?: string
+}
+
+/**
+ * Search result from the Savoir API
+ */
+export interface SearchResult {
+ path: string
+ lineNumber: number
+ content: string
+}
+
+/**
+ * File content from the Savoir API
+ */
+export interface FileContent {
+ path: string
+ content: string
+}
+
+/**
+ * Response from the search-and-read endpoint
+ */
+export interface SearchAndReadResponse {
+ sessionId: string
+ matches: SearchResult[]
+ files: FileContent[]
+}
+
+/**
+ * Response from the search endpoint
+ */
+export interface SearchResponse {
+ sessionId: string
+ matches: SearchResult[]
+}
+
+/**
+ * Response from the read endpoint
+ */
+export interface ReadResponse {
+ sessionId: string
+ files: FileContent[]
+}
+
+/**
+ * Error response from the Savoir API
+ */
+export interface ApiErrorResponse {
+ statusCode: number
+ message: string
+ error?: string
+}
diff --git a/packages/sdk/tsconfig.json b/packages/sdk/tsconfig.json
new file mode 100644
index 0000000..cb6ef60
--- /dev/null
+++ b/packages/sdk/tsconfig.json
@@ -0,0 +1,13 @@
+{
+ "compilerOptions": {
+ "target": "ES2022",
+ "module": "ESNext",
+ "moduleResolution": "Bundler",
+ "strict": true,
+ "declaration": true,
+ "esModuleInterop": true,
+ "skipLibCheck": true,
+ "noEmit": true
+ },
+ "include": ["src"]
+}
diff --git a/packages/sdk/tsdown.config.ts b/packages/sdk/tsdown.config.ts
new file mode 100644
index 0000000..03c2d29
--- /dev/null
+++ b/packages/sdk/tsdown.config.ts
@@ -0,0 +1,11 @@
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+ entry: ['src/index.ts'],
+ format: ['esm'],
+ dts: {
+ sourcemap: false,
+ },
+ clean: true,
+ hash: false,
+})
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 7eaf4e3..ed2b03d 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -29,6 +29,12 @@ importers:
'@types/node':
specifier: ^25.0.9
version: 25.0.9
+ '@vercel/kv':
+ specifier: ^3.0.0
+ version: 3.0.0
+ '@vercel/sandbox':
+ specifier: ^1.2.0
+ version: 1.2.0
giget:
specifier: ^2.0.0
version: 2.0.0
@@ -37,7 +43,7 @@ importers:
version: 2.0.3
workflow:
specifier: ^4.0.1-beta.48
zod:
specifier: ^4.3.5
version: 4.3.5
@@ -47,7 +53,7 @@ importers:
version: 9.39.2([email protected])
nitro:
specifier: latest
- version: 3.0.1-alpha.1(@vercel/[email protected](@aws-sdk/[email protected](@aws-sdk/[email protected])))([email protected])([email protected])
rolldown:
specifier: latest
version: 1.0.0-beta.60
@@ -92,8 +98,56 @@ importers:
specifier: ^5.8.3
version: 5.9.3
+ packages/sdk:
+ dependencies:
+ ai:
+ specifier: ^4.3.16
+ zod:
+ specifier: ^3.25.28
+ version: 3.25.76
+ devDependencies:
+ '@types/node':
+ specifier: ^22.15.21
+ version: 22.19.7
+ eslint:
+ specifier: ^9.28.0
+ version: 9.39.2([email protected])
+ tsdown:
+ specifier: ^0.12.4
+ version: 0.12.9([email protected])
+ typescript:
+ specifier: ^5.8.3
+ version: 5.9.3
+
packages:
+ '@ai-sdk/[email protected]':
+ resolution: {integrity: sha512-fqhG+4sCVv8x7nFzYnFo19ryhAa3w096Kmc3hWxMQfW/TubPOmt3A6tYZhl4mUfQWWQMsuSkLrtjlWuXBVSGQA==}
+ engines: {node: '>=18'}
+ peerDependencies:
+ zod: ^3.23.8
+
+ '@ai-sdk/[email protected]':
+ resolution: {integrity: sha512-qZMxYJ0qqX/RfnuIaab+zp8UAeJn/ygXXAffR5I4N0n1IrvA6qBsjc8hXLmBiMV2zoXlifkacF7sEFnYnjBcqg==}
+ engines: {node: '>=18'}
+
+ '@ai-sdk/[email protected]':
+ resolution: {integrity: sha512-jK1IZZ22evPZoQW3vlkZ7wvjYGYF+tRBKXtrcolduIkQ/m/sOAVcVeVDUDvh1T91xCnWCdUGCPZg2avZ90mv3g==}
+ engines: {node: '>=18'}
+ peerDependencies:
+ react: ^18 || ^19 || ^19.0.0-rc
+ zod: ^3.23.8
+ peerDependenciesMeta:
+ zod:
+ optional: true
+
+ '@ai-sdk/[email protected]':
+ resolution: {integrity: sha512-3zcwCc8ezzFlwp3ZD15wAPjf2Au4s3vAbKsXQVyhxODHcmu0iyPO2Eua6D/vicq/AUm/BAo60r97O6HU+EI0+w==}
+ engines: {node: '>=18'}
+ peerDependencies:
+ zod: ^3.23.8
+
'@altano/[email protected]':
resolution: {integrity: sha512-5vbUs2A98CC3g1AlOBdkBE0BMukkLjLIsMHAtuxg6Pt9dQXxYWdLKOf66v6c/vIqtNcgTMv0oGtddLdMuH9X6w==}
@@ -737,6 +791,10 @@ packages:
resolution: {integrity: sha512-o4xR98DEFf+VqY+M9B3ZooTm2T/mlGvyBHwHcnsPJCEnvzHqEA9xUlCUK4jm7FBXHhkppziMgCC2snsueLoIpQ==}
engines: {node: '>=18.0.0'}
+ '@opentelemetry/[email protected]':
+ resolution: {integrity: sha512-3giAOQvZiH5F9bMlMiv8+GSPMeqg0dbaeo58/0SlA9sxSqZhnUtxzX9/2FzyhS9sWQf5S0GJE0AKBrFqjpeYcg==}
+ engines: {node: '>=8.0.0'}
+
'@oxc-minify/[email protected]':
resolution: {integrity: sha512-lzeIEMu/v6Y+La5JSesq4hvyKtKBq84cgQpKYTYM/yGuNk2tfd5Ha31hnC+mTh48lp/5vZH+WBfjVUjjINCfug==}
engines: {node: ^20.19.0 || >=22.12.0}
@@ -1350,6 +1408,9 @@ packages:
resolution: {integrity: sha512-9tTaPJLSiejZKx+Bmog4uSubteqTvFrVrURwkmHixBo0G4seD0zUxp98E1DzUBJxLQ3NPwXrGKDiVjwx/DpPsg==}
+ '@types/[email protected]':
+ resolution: {integrity: sha512-xFdR6tkm0MWvBfO8xXCSsinYxHcqkQUlcHeSpMC2ukzOb6lwQAfDmW+Qt0AvlGd8HpsS28qKsB+oPeJn9I39jg==}
+
resolution: {integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==}
@@ -1519,6 +1580,9 @@ packages:
cpu: [x64]
os: [win32]
+ '@upstash/[email protected]':
+ resolution: {integrity: sha512-N6SjDcgXdOcTAF+7uNoY69o7hCspe9BcA7YjQdxVu5d25avljTwyLaHBW3krWjrP0FfocgMk94qyVtQbeDp39A==}
+
'@vercel/[email protected]':
resolution: {integrity: sha512-mLKK3H+v1XjzTiksYN7XV4sl/n8tqb0DeavoUzjFKRQMmx5x+vy1jIl24GY4C8D2dinQPV1ZuCSPhJptBeeE/A==}
engines: {node: '>= 20'}
@@ -1528,6 +1592,10 @@ packages:
'@aws-sdk/credential-provider-web-identity':
optional: true
+ '@vercel/[email protected]':
+ resolution: {integrity: sha512-pKT8fRnfyYk2MgvyB6fn6ipJPCdfZwiKDdw7vB+HL50rjboEBHDVBEcnwfkEpVSp2AjNtoaOUH7zG+bVC/rvSg==}
+ engines: {node: '>=14.6'}
+
'@vercel/[email protected]':
resolution: {integrity: sha512-fnYhv671l+eTTp48gB4zEsTW/YtRgRPnkI2nT7x6qw5rkI1Lq2hTmQIpHPgyThI0znLK+vX2n9XxKdXZ7BUbbw==}
engines: {node: '>= 20'}
@@ -1541,6 +1609,9 @@ packages:
engines: {node: '>=20.0.0'}
hasBin: true
+ '@vercel/[email protected]':
+ resolution: {integrity: sha512-oq0d2xQuiDq8LyoZOZW+i+QmNkMQ0/ddEGHMukBsF+cxX7ohBEXOV/a0+SopBwEsKCjq9j55QFP56G3MU/iEjA==}
+
'@workflow/[email protected]':
resolution: {integrity: sha512-xmnWGB2yZ+FVg0XqVhzOelEhQSLvUA9k8IX9MkPwWZo4oKDrHryBNtjwfxAPr1gnJNy3BsCRa88SOKKp7M06dw==}
@@ -1627,6 +1698,16 @@ packages:
engines: {node: '>=0.4.0'}
hasBin: true
+ resolution: {integrity: sha512-dIE2bfNpqHN3r6IINp9znguYdhIOheKW2LDigAMrgt/upT3B8eBGPSCblENvaZGoq+hxaN9fSMzjWpbqloP+7Q==}
+ engines: {node: '>=18'}
+ peerDependencies:
+ react: ^18 || ^19 || ^19.0.0-rc
+ zod: ^3.23.8
+ peerDependenciesMeta:
+ react:
+ optional: true
+
resolution: {integrity: sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==}
@@ -1680,6 +1761,9 @@ packages:
resolution: {integrity: sha512-m1Q/RaVOnTp9JxPX+F+Zn7IcLYMzM8kZofDImfsKZd8MbR+ikdOzTeztStWqfrqIxZnYWryyI9ePm3NGjnZgGw==}
engines: {node: '>=20.19.0'}
+ resolution: {integrity: sha512-wfr/jstw9xNi/0teMHrRW7dsz3Lt5ARhYNZ2ewpadnhaIp5mbALhOAP+EAdsC7t4Z6wqsDVv9+W6gm1Dk9mEyw==}
+
resolution: {integrity: sha512-tLRNUXati5MFePdAk8dw7Qt7DpxPB60ofAgn8WRhW6a2rcimZnYBP9oxHiv0OHy+Wz7kPMG+t4LGdt31+4EmGg==}
@@ -1690,9 +1774,25 @@ packages:
resolution: {integrity: sha512-9Gey0OG4gu2IzoLbwRj2fqyntJPbEFox/5KdOgg0zflkzq5lyOapWE324xYOvVdk9hgyjiMvDcT6XUPAIJhmag==}
hasBin: true
+ resolution: {integrity: sha512-5Q2mfq2WfGuFp3uS//0s6baOJLMoVduPYVeNmDYxu5OUA1/cBfvr2RIS7vi62LdNj/urk1hfmj867I3qt6uZ7Q==}
+ peerDependencies:
+ react-native-b4a: '*'
+ peerDependenciesMeta:
+ react-native-b4a:
+ optional: true
+
resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==}
+ resolution: {integrity: sha512-riJjyv1/mHLIPX4RwiK+oW9/4c3TEUeORHKefKAKnZ5kyslbN+HXowtbaVEqt4IMUB7OXlfixcs6gsFeo/jhiQ==}
+ peerDependencies:
+ bare-abort-controller: '*'
+ peerDependenciesMeta:
+ bare-abort-controller:
+ optional: true
+
resolution: {integrity: sha512-KrayHS5pBi69Xi9JmvoqrIgYGDkD6mcSe/i6YKi3w5kekCLzrX4+nawcXqrj2tIp50Kw/mT/s3p+GVK0A0sKxw==}
@@ -1906,6 +2006,10 @@ packages:
resolution: {integrity: sha512-mEQCMmwJu317oSz8CwdIOdwf3xMif1ttiM8LTufzc3g6kR+9Pe236twL8j3IYT1F7GfRgGcW6MWxzZjLIkuHIg==}
+ resolution: {integrity: sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==}
+ engines: {node: '>=6'}
+
resolution: {integrity: sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==}
@@ -1936,6 +2040,9 @@ packages:
resolution: {integrity: sha512-+yW4SNY7W2DOWe2Jx5H4c2qMTFbLGM6wIyoDPkAPy66X+sD1KfYjBPAIWPVsYqMxelflaMQCloZDudELIPhLqA==}
engines: {node: ^18.12.0 || >=20.9.0}
+ resolution: {integrity: sha512-IayShXAgj/QMXgB0IWmKx+rOPuGMhqm5w6jvFxmVenXKIzRqTAAsbBPT3kWQeGANj3jGgvcvv4yK6SxqYmikgw==}
+
resolution: {integrity: sha512-k1gCAXAsNgLwEL+Y8Wvl+M6oEFj5bgazfZULpS5CneoPPXRaCCW7dm+q21Ky2VEE5X+VeRDBVg1Pcvvsr4TtNQ==}
engines: {node: ^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0}
@@ -2143,6 +2250,9 @@ packages:
resolution: {integrity: sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==}
engines: {node: '>=0.10.0'}
+ resolution: {integrity: sha512-LUd5euvbMLpwOF8m6ivPCbhQeSiYVNb8Vs0fQ8QjXo0JTkEHpz8pxdQf0gStltaPpw0Cca8b39KxvK9cfKRiAw==}
+
resolution: {integrity: sha512-VO5fQUzZtI6C+vx4w/4BWJpg3s/5l+6pRQEHzFRM8WFi4XffSP1Z+4qi7GbjWbvRQEbdIco5mIMq+zX4rPuLrw==}
@@ -2152,6 +2262,9 @@ packages:
resolution: {integrity: sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==}
+ resolution: {integrity: sha512-/d9sfos4yxzpwkDkuN7k2SqFKtYNmCTzgfEpz82x34IM9/zc8KGxQoXg1liNC/izpRM/MBdt44Nmx41ZWqk+FQ==}
+
resolution: {integrity: sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==}
engines: {node: '>=8.6.0'}
@@ -2399,6 +2512,9 @@ packages:
resolution: {integrity: sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==}
+ resolution: {integrity: sha512-es94M3nTIfsEPisRafak+HDLfHXnKBhV3vU5eqPcS3flIWqcxJWgXHXiey3YrpaNsanY5ei1VoYEbOzijuq9BA==}
+
resolution: {integrity: sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==}
@@ -2411,9 +2527,17 @@ packages:
resolution: {integrity: sha512-1e4qoRgnn448pRuMvKGsFFymUCquZV0mpGgOyIKNgD3JVDTsVJyRBGH/Fm0tBb8WsWGgmB1mDe6/yJMQM37DUA==}
engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
+ resolution: {integrity: sha512-3QItJOXp2AP1uv7waBkao5nCvhEv+QmJAd38Ybq7wNI74Q+BBmnLn4EDKz6yI9xGAIQoUF87qHt+kc1IVxB4zQ==}
+ engines: {node: ^18.0.0 || >=20.0.0}
+ hasBin: true
+
resolution: {integrity: sha512-FGuPw30AdOIUTRMC2OMRtQV+jkVj2cfPqSeWXv1NEAJ1qZ5zb1X6z1mFhbfOB/iy3ssJCD+3KuZ8r8C3uVFlAg==}
+ resolution: {integrity: sha512-ekDrAGso79Cvf+dtm+mL8OBI2bmAOt3gssYs833De/C9NmIpWDWyUO4zPgB5x2/OhY366dkhgfPMYfwZF7yOZA==}
+
resolution: {integrity: sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==}
@@ -2751,6 +2875,10 @@ packages:
resolution: {integrity: sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA==}
engines: {node: '>=18'}
+ resolution: {integrity: sha512-XQBQ3I8W1Cge0Seh+6gjj03LbmRFWuoszgK9ooCpwYIrhhoO80pfq4cUkU5DkknwfOfFteRwlZ56PYOGYyFWdg==}
+ engines: {node: '>= 4'}
+
resolution: {integrity: sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==}
engines: {iojs: '>=1.0.0', node: '>=0.10.0'}
@@ -2792,6 +2920,9 @@ packages:
resolution: {integrity: sha512-6FtHJEvt+pVMIB9IBY+IcCJ6Z5f1iQnytgyfKMhDKgmzYG+TeH/wx1y3l27rshSbLiSanrR9ffZDrEsmjlQF2g==}
+ resolution: {integrity: sha512-6aU+Rwsezw7VR8/nyvKTx8QpWH9FrcYiXXlqC4z5d5XQBDRqtbfsRjnwGyqbi3gddNtWHuEk9OANUotL26qKUw==}
+
resolution: {integrity: sha512-8OwmbklUNzwezjGInmZ+2clQmExQPvomqjL7LFqOYqtmuxRgQYqOD3mHaU+MvZn5FLUeVxVfQjwLZW/n/JFuqg==}
@@ -2857,6 +2988,9 @@ packages:
resolution: {integrity: sha512-UhDfHmA92YAlNnCfhmq0VeNL5bDbiZGg7sZ2IvPsXubGkiNa9EC+tUTsjBRsYUAz87btI6/1wf4XoVvQ3uRnmQ==}
engines: {node: '>=18'}
+ resolution: {integrity: sha512-kn+e44esVfn2Fa/O0CPFcex27fjIL6MkVae0Mm6q+E6f0hWv578YCERbv+4m02cjxvDsPKLnmxral/rR6lBMAg==}
+
resolution: {integrity: sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==}
engines: {node: '>=8'}
@@ -2909,14 +3043,29 @@ packages:
resolution: {integrity: sha512-UKbpT93hN5Nr9go5UY7bopIB9YQlMz9nm/ct4IXt/irb5YRkn9WaqrOBJGZ5Pwvsd5FQzSVeYlGdXoCAPQZrPg==}
engines: {node: '>=20'}
+ resolution: {integrity: sha512-gaCPRVoMq8WGDcWj9p4YWzCMPHzE0WNl6W8ADIx9c3JBEIdMkJGMzW+uzXvxHMltwcYACr9jP+32H8/hgwMR7w==}
+ peerDependencies:
+ react: ^16.11.0 || ^17.0.0 || ^18.0.0 || ^19.0.0
+
resolution: {integrity: sha512-g9ljZiwki/LfxmQADO3dEY1CbpmXT5Hm2fJ+QaGKwSXUylMybePR7/67YW7jOrrvjEgL1Fmz5kzyAjWVWLlucg==}
engines: {node: '>=6'}
+ resolution: {integrity: sha512-qJj60CXt7IU1Ffyc3NJMjh6EkuCFej46zUqJ4J7pqYlThyd9bO0XBTmcOIhSzZJVWfsLks0+nle/j538YAW9RQ==}
+
resolution: {integrity: sha512-qFAy10MTMwjzjU8U16YS4YoZD+NQLHzLssFMNqgravjbvIPNiqkGFR4yjhJfmY9R5OFU7+yHxc6y+uGHkKwLRA==}
engines: {node: '>=20'}
+ resolution: {integrity: sha512-3/o9z3X0X0fTupwsYvR03pJ/DjWuqqrfwBgTQzdWDiQSm9KitAyz/9WqsT2JQW7KV2m+bC2ol/zqpW37NHxLaA==}
+
+ resolution: {integrity: sha512-nt6AMGKW1p/70DF/hGBdJB57B8Tspmbp5gfJ8ilhLnt7kkr2ye7hzD6NVG8GGErk2HWF34igrL2CXmNIkzKqKw==}
+ engines: {node: '>=18'}
+
resolution: {integrity: sha512-W/KYk+NFhkmsYpuHq5JykngiOCnxeVL8v8dFnqxSD8qEEdRfXk1SDM6JzNqcERbcGYj9tMrDQBYV9cjgnunFIg==}
engines: {node: '>=18'}
@@ -3032,6 +3181,9 @@ packages:
resolution: {integrity: sha512-nrMlWRQ1xdTjSnSUqvYqJzbTBFugoqHobQj58B2bc8qxHKBBHMNNsWQFP3Cd3/JZK907voM2geYPWqD4VK3MPQ==}
+ resolution: {integrity: sha512-Ql87qFHB3s/De2ClA9e0gsnS6zXG27SkTiSJwjCc9MebbfapQfuPzumMIUMi38ezPZVNFcHI9sUIepeQfw8J8Q==}
+
resolution: {integrity: sha512-p+Rz9x0R7X+CYDkT+Xg8/GhpcShTlU8n+cf9OtOEf7zEQsNcCZO1dPKNRDqvUTaq+P32PMMkxWHwfrxkqfqAYg==}
@@ -3148,6 +3300,11 @@ packages:
resolution: {integrity: sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==}
+ resolution: {integrity: sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w==}
+ peerDependencies:
+ react: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0
+
resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==}
@@ -3253,6 +3410,17 @@ packages:
resolution: {integrity: sha512-4LCcse/U2MHZ63HAJVE+v71o7yOdIe4cZ70Wpf8D/IyjDKYQLV5GD46B+hSTjJsvV5PztjvHoU580EftxjDZFQ==}
engines: {node: '>=12.20'}
+ resolution: {integrity: sha512-pM/SU9d3YAggzi6MtR4h7ruuQlqKtad8e9S0fmxcMi+ueAK5Korys/aWcV9LIIHTVbj01NdzxcnXSN+O74ZIVA==}
+ peerDependencies:
+ zod: ^3.25 || ^4
+
+ resolution: {integrity: sha512-OdqJE9UDRPwWsrHjLN2F8bPxvwJBK22EHLWtanu0LSYr5YqzsaaW3RMgmjwr8Rypg5k+meEJdSPXJZXE/yqOMg==}
+
+ resolution: {integrity: sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==}
+
resolution: {integrity: sha512-WPsqwxITS2tzx1bzhIKsEs19ABD5vmCVa4xBo2tq/SrV4RNZtfws1EnCWQXM6yh8bD08a1idvkB5MZSBiZsjwg==}
@@ -3261,6 +3429,34 @@ packages:
snapshots:
+ dependencies:
+ '@ai-sdk/provider': 1.1.3
+ nanoid: 3.3.11
+ secure-json-parse: 2.7.0
+ zod: 3.25.76
+
+ '@ai-sdk/[email protected]':
+ dependencies:
+ json-schema: 0.4.0
+
+ dependencies:
+ '@ai-sdk/provider-utils': 2.2.8([email protected])
+ '@ai-sdk/ui-utils': 1.2.11([email protected])
+ react: 19.2.3
+ swr: 2.3.8([email protected])
+ throttleit: 2.1.0
+ optionalDependencies:
+ zod: 3.25.76
+
+ dependencies:
+ '@ai-sdk/provider': 1.1.3
+ '@ai-sdk/provider-utils': 2.2.8([email protected])
+ zod: 3.25.76
+ zod-to-json-schema: 3.25.1([email protected])
+
'@altano/[email protected]': {}
'@aws-crypto/[email protected]':
@@ -4101,6 +4297,8 @@ snapshots:
transitivePeerDependencies:
- typescript
+ '@opentelemetry/[email protected]': {}
+
'@oxc-minify/[email protected]':
optional: true
@@ -4652,6 +4850,8 @@ snapshots:
tslib: 2.8.1
optional: true
+ '@types/[email protected]': {}
+
'@types/[email protected]': {}
'@types/[email protected]': {}
@@ -4816,12 +5016,20 @@ snapshots:
optional: true
+ '@upstash/[email protected]':
+ dependencies:
+ uncrypto: 0.1.3
+
dependencies:
'@vercel/oidc': 3.1.0
optionalDependencies:
'@aws-sdk/credential-provider-web-identity': 3.609.0(@aws-sdk/[email protected])
+ '@vercel/[email protected]':
+ dependencies:
+ '@upstash/redis': 1.36.1
+
'@vercel/[email protected]': {}
'@vercel/[email protected]': {}
@@ -4831,10 +5039,25 @@ snapshots:
'@vercel/oidc': 3.1.0
mixpart: 0.0.5-alpha.1
- '@workflow/[email protected](@aws-sdk/[email protected])':
+ '@vercel/[email protected]':
+ dependencies:
+ '@vercel/oidc': 3.1.0
+ async-retry: 1.3.3
+ jsonlines: 0.1.1
+ ms: 2.1.3
+ picocolors: 1.1.1
+ tar-stream: 3.1.7
+ undici: 7.18.2
+ xdg-app-paths: 5.1.0
+ zod: 3.24.4
+ transitivePeerDependencies:
+ - bare-abort-controller
+ - react-native-b4a
+
+ '@workflow/[email protected](@aws-sdk/[email protected])(@opentelemetry/[email protected])':
dependencies:
'@swc/core': 1.15.3
- '@workflow/builders': 4.0.1-beta.39(@aws-sdk/[email protected])
+ '@workflow/builders': 4.0.1-beta.39(@aws-sdk/[email protected])(@opentelemetry/[email protected])
'@workflow/rollup': 4.0.0-beta.7
'@workflow/swc-plugin': 4.0.1-beta.13(@swc/[email protected])
'@workflow/vite': 4.0.0-beta.2
@@ -4846,10 +5069,10 @@ snapshots:
- '@swc/helpers'
- supports-color
- '@workflow/[email protected](@aws-sdk/[email protected])':
+ '@workflow/[email protected](@aws-sdk/[email protected])(@opentelemetry/[email protected])':
dependencies:
'@swc/core': 1.15.3
- '@workflow/core': 4.0.1-beta.39(@aws-sdk/[email protected])
+ '@workflow/core': 4.0.1-beta.39(@aws-sdk/[email protected])(@opentelemetry/[email protected])
'@workflow/errors': 4.0.1-beta.13
'@workflow/swc-plugin': 4.0.1-beta.13(@swc/[email protected])
builtin-modules: 5.0.0
@@ -4865,19 +5088,19 @@ snapshots:
- '@swc/helpers'
- supports-color
dependencies:
'@oclif/core': 4.0.0([email protected])
'@oclif/plugin-help': 6.2.31([email protected])
'@swc/core': 1.15.3
- '@workflow/builders': 4.0.1-beta.39(@aws-sdk/[email protected])
- '@workflow/core': 4.0.1-beta.39(@aws-sdk/[email protected])
+ '@workflow/builders': 4.0.1-beta.39(@aws-sdk/[email protected])(@opentelemetry/[email protected])
+ '@workflow/core': 4.0.1-beta.39(@aws-sdk/[email protected])(@opentelemetry/[email protected])
'@workflow/errors': 4.0.1-beta.13
'@workflow/swc-plugin': 4.0.1-beta.13(@swc/[email protected])
'@workflow/utils': 4.0.1-beta.10
- '@workflow/web': 4.0.1-beta.28([email protected]([email protected]))([email protected])
+ '@workflow/web': 4.0.1-beta.28(@opentelemetry/[email protected])([email protected]([email protected]))([email protected])
'@workflow/world': 4.0.1-beta.13([email protected])
- '@workflow/world-local': 4.0.1-beta.26
+ '@workflow/world-local': 4.0.1-beta.26(@opentelemetry/[email protected])
'@workflow/world-vercel': 4.0.1-beta.27
boxen: 8.0.1
builtin-modules: 5.0.0
@@ -4910,7 +5133,7 @@ snapshots:
- supports-color
- typescript
- '@workflow/[email protected](@aws-sdk/[email protected])':
+ '@workflow/[email protected](@aws-sdk/[email protected])(@opentelemetry/[email protected])':
dependencies:
'@aws-sdk/credential-provider-web-identity': 3.609.0(@aws-sdk/[email protected])
'@jridgewell/trace-mapping': 0.3.31
@@ -4920,7 +5143,7 @@ snapshots:
'@workflow/errors': 4.0.1-beta.13
'@workflow/utils': 4.0.1-beta.10
'@workflow/world': 4.0.1-beta.13([email protected])
- '@workflow/world-local': 4.0.1-beta.26
+ '@workflow/world-local': 4.0.1-beta.26(@opentelemetry/[email protected])
'@workflow/world-vercel': 4.0.1-beta.27
debug: 4.4.3([email protected])
devalue: 5.6.0
@@ -4929,6 +5152,8 @@ snapshots:
seedrandom: 3.0.5
ulid: 3.0.1
zod: 4.1.11
+ optionalDependencies:
+ '@opentelemetry/api': 1.9.0
transitivePeerDependencies:
- '@aws-sdk/client-sts'
- supports-color
@@ -4938,27 +5163,27 @@ snapshots:
'@workflow/utils': 4.0.1-beta.10
ms: 2.1.3
dependencies:
'@swc/core': 1.15.3
- '@workflow/builders': 4.0.1-beta.39(@aws-sdk/[email protected])
- '@workflow/core': 4.0.1-beta.39(@aws-sdk/[email protected])
+ '@workflow/builders': 4.0.1-beta.39(@aws-sdk/[email protected])(@opentelemetry/[email protected])
+ '@workflow/core': 4.0.1-beta.39(@aws-sdk/[email protected])(@opentelemetry/[email protected])
'@workflow/swc-plugin': 4.0.1-beta.13(@swc/[email protected])
semver: 7.7.3
watchpack: 2.4.4
optionalDependencies:
transitivePeerDependencies:
- '@aws-sdk/client-sts'
- '@opentelemetry/api'
- '@swc/helpers'
- supports-color
- '@workflow/[email protected](@aws-sdk/[email protected])':
+ '@workflow/[email protected](@aws-sdk/[email protected])(@opentelemetry/[email protected])':
dependencies:
'@swc/core': 1.15.3
- '@workflow/builders': 4.0.1-beta.39(@aws-sdk/[email protected])
- '@workflow/core': 4.0.1-beta.39(@aws-sdk/[email protected])
+ '@workflow/builders': 4.0.1-beta.39(@aws-sdk/[email protected])(@opentelemetry/[email protected])
+ '@workflow/core': 4.0.1-beta.39(@aws-sdk/[email protected])(@opentelemetry/[email protected])
'@workflow/rollup': 4.0.0-beta.7
'@workflow/swc-plugin': 4.0.1-beta.13(@swc/[email protected])
'@workflow/vite': 4.0.0-beta.2
@@ -4970,10 +5195,10 @@ snapshots:
- '@swc/helpers'
- supports-color
- '@workflow/[email protected](@aws-sdk/[email protected])':
+ '@workflow/[email protected](@aws-sdk/[email protected])(@opentelemetry/[email protected])':
dependencies:
'@nuxt/kit': 4.2.0
- '@workflow/nitro': 4.0.1-beta.43(@aws-sdk/[email protected])
+ '@workflow/nitro': 4.0.1-beta.43(@aws-sdk/[email protected])(@opentelemetry/[email protected])
transitivePeerDependencies:
- '@aws-sdk/client-sts'
- '@opentelemetry/api'
@@ -4989,10 +5214,10 @@ snapshots:
transitivePeerDependencies:
- '@swc/helpers'
- '@workflow/[email protected](@aws-sdk/[email protected])':
+ '@workflow/[email protected](@aws-sdk/[email protected])(@opentelemetry/[email protected])':
dependencies:
'@swc/core': 1.15.3
- '@workflow/builders': 4.0.1-beta.39(@aws-sdk/[email protected])
+ '@workflow/builders': 4.0.1-beta.39(@aws-sdk/[email protected])(@opentelemetry/[email protected])
'@workflow/rollup': 4.0.0-beta.7
'@workflow/swc-plugin': 4.0.1-beta.13(@swc/[email protected])
'@workflow/vite': 4.0.0-beta.2
@@ -5019,9 +5244,9 @@ snapshots:
'@workflow/[email protected]': {}
dependencies:
transitivePeerDependencies:
- '@babel/core'
- '@opentelemetry/api'
@@ -5032,7 +5257,7 @@ snapshots:
- react-dom
- sass
- '@workflow/[email protected]':
+ '@workflow/[email protected](@opentelemetry/[email protected])':
dependencies:
'@vercel/queue': 0.0.0-alpha.33
'@workflow/errors': 4.0.1-beta.13
@@ -5042,6 +5267,8 @@ snapshots:
ulid: 3.0.1
undici: 6.22.0
zod: 4.1.11
+ optionalDependencies:
+ '@opentelemetry/api': 1.9.0
'@workflow/[email protected]':
dependencies:
@@ -5061,6 +5288,18 @@ snapshots:
+ dependencies:
+ '@ai-sdk/provider': 1.1.3
+ '@ai-sdk/provider-utils': 2.2.8([email protected])
+ '@ai-sdk/react': 1.2.12([email protected])([email protected])
+ '@ai-sdk/ui-utils': 1.2.11([email protected])
+ '@opentelemetry/api': 1.9.0
+ jsondiffpatch: 0.6.0
+ zod: 3.25.76
+ optionalDependencies:
+ react: 19.2.3
+
dependencies:
fast-deep-equal: 3.1.3
@@ -5105,6 +5344,10 @@ snapshots:
'@babel/parser': 7.28.6
pathe: 2.0.3
+ dependencies:
+ retry: 0.13.1
+
@@ -5131,8 +5374,12 @@ snapshots:
transitivePeerDependencies:
- magicast
+
+
@@ -5303,6 +5550,8 @@ snapshots:
+
@@ -5323,6 +5572,8 @@ snapshots:
fastest-levenshtein: 1.0.16
lodash.deburr: 4.1.0
+
@@ -5597,12 +5848,20 @@ snapshots:
+ dependencies:
+ bare-events: 2.8.2
+ transitivePeerDependencies:
+ - bare-abort-controller
+
+
dependencies:
'@nodelib/fs.stat': 2.0.5
@@ -5803,6 +6062,8 @@ snapshots:
+
@@ -5814,12 +6075,20 @@ snapshots:
espree: 9.6.1
semver: 7.7.3
+ dependencies:
+ '@types/diff-match-patch': 1.0.36
+ chalk: 5.6.2
+ diff-match-patch: 1.0.5
+
dependencies:
universalify: 2.0.1
optionalDependencies:
graceful-fs: 4.2.11
+
dependencies:
json-buffer: 3.0.1
@@ -5910,7 +6179,7 @@ snapshots:
dependencies:
'@next/env': 16.0.10
'@swc/helpers': 0.5.15
@@ -5928,6 +6197,7 @@ snapshots:
'@next/swc-linux-x64-musl': 16.0.10
'@next/swc-win32-arm64-msvc': 16.0.10
'@next/swc-win32-x64-msvc': 16.0.10
+ '@opentelemetry/api': 1.9.0
sharp: 0.34.5
transitivePeerDependencies:
- '@babel/core'
@@ -5935,7 +6205,7 @@ snapshots:
dependencies:
consola: 3.4.2
crossws: 0.4.3([email protected])
@@ -5950,7 +6220,7 @@ snapshots:
srvx: 0.9.8
undici: 7.18.2
unenv: 2.0.0-rc.24
optionalDependencies:
rolldown: 1.0.0-beta.60
transitivePeerDependencies:
@@ -6195,6 +6465,8 @@ snapshots:
onetime: 7.0.0
signal-exit: 4.1.0
+
@@ -6245,6 +6517,8 @@ snapshots:
+
@@ -6322,6 +6596,15 @@ snapshots:
+ dependencies:
+ events-universal: 1.0.1
+ fast-fifo: 1.3.2
+ text-decoder: 1.2.3
+ transitivePeerDependencies:
+ - bare-abort-controller
+ - react-native-b4a
+
dependencies:
emoji-regex: 8.0.0
@@ -6366,13 +6649,36 @@ snapshots:
has-flag: 5.0.1
supports-color: 10.2.2
+ dependencies:
+ dequal: 2.0.3
+ react: 19.2.3
+ use-sync-external-store: 1.6.0([email protected])
+
+ dependencies:
+ b4a: 1.7.3
+ fast-fifo: 1.3.2
+ streamx: 2.23.0
+ transitivePeerDependencies:
+ - bare-abort-controller
+ - react-native-b4a
+
dependencies:
ansi-escapes: 7.2.0
supports-hyperlinks: 4.4.0
+ dependencies:
+ b4a: 1.7.3
+ transitivePeerDependencies:
+ - react-native-b4a
+
+
@@ -6474,6 +6780,8 @@ snapshots:
quansync: 1.0.0
unconfig-core: 7.4.2
+
dependencies:
acorn: 8.15.0
@@ -6528,9 +6836,11 @@ snapshots:
'@unrs/resolver-binding-win32-ia32-msvc': 1.11.1
'@unrs/resolver-binding-win32-x64-msvc': 1.11.1
optionalDependencies:
+ '@upstash/redis': 1.36.1
'@vercel/functions': 3.3.6(@aws-sdk/[email protected](@aws-sdk/[email protected]))
+ '@vercel/kv': 3.0.0
chokidar: 5.0.0
db0: 0.3.4
ofetch: 2.0.0-alpha.3
@@ -6547,6 +6857,10 @@ snapshots:
dependencies:
punycode: 2.3.1
+ dependencies:
+ react: 19.2.3
+
@@ -6592,19 +6906,21 @@ snapshots:
dependencies:
- '@workflow/astro': 4.0.0-beta.22(@aws-sdk/[email protected])
- '@workflow/core': 4.0.1-beta.39(@aws-sdk/[email protected])
+ '@workflow/astro': 4.0.0-beta.22(@aws-sdk/[email protected])(@opentelemetry/[email protected])
+ '@workflow/core': 4.0.1-beta.39(@aws-sdk/[email protected])(@opentelemetry/[email protected])
'@workflow/errors': 4.0.1-beta.13
- '@workflow/nitro': 4.0.1-beta.43(@aws-sdk/[email protected])
- '@workflow/nuxt': 4.0.1-beta.32(@aws-sdk/[email protected])
+ '@workflow/next': 4.0.1-beta.44(@aws-sdk/[email protected])(@opentelemetry/[email protected])([email protected](@opentelemetry/[email protected])([email protected]([email protected]))([email protected]))
+ '@workflow/nitro': 4.0.1-beta.43(@aws-sdk/[email protected])(@opentelemetry/[email protected])
+ '@workflow/nuxt': 4.0.1-beta.32(@aws-sdk/[email protected])(@opentelemetry/[email protected])
'@workflow/rollup': 4.0.0-beta.7
- '@workflow/sveltekit': 4.0.0-beta.37(@aws-sdk/[email protected])
+ '@workflow/sveltekit': 4.0.0-beta.37(@aws-sdk/[email protected])(@opentelemetry/[email protected])
'@workflow/typescript-plugin': 4.0.1-beta.4([email protected])
ms: 2.1.3
+ optionalDependencies:
+ '@opentelemetry/api': 1.9.0
transitivePeerDependencies:
- '@aws-sdk/client-sts'
- '@babel/core'
@@ -6671,6 +6987,14 @@ snapshots:
+ dependencies:
+ zod: 3.25.76
+
+
+
diff --git a/turbo.json b/turbo.json
index a191e41..4457c4e 100644
--- a/turbo.json
+++ b/turbo.json
@@ -7,6 +7,9 @@
"env": [
"AI_GATEWAY_API_KEY",
"GITHUB_TOKEN",
+ "GITHUB_SNAPSHOT_REPO",
+ "GITHUB_SNAPSHOT_BRANCH",
+ "SAVOIR_SECRET_KEY",
"TURSO_DATABASE_URL",
"TURSO_AUTH_TOKEN",
"DATABASE_URL_UNPOOLED",