:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
import { z } from 'zod'
import { DATAFRAME_NAME_REGEX } from './cellTags'
/** Mirrors MAX_VARIABLES_PER_NOTEBOOK in sql_v2_serializers.py, so the schema stops at the server's limit. */
export const MAX_NOTEBOOK_VARIABLES = 10
/** One notebook variable, as both notebooks-set-variables and notebooks-run accept it. */
export const NotebookVariableSchema = z
.object({
name: z
.string()
.regex(DATAFRAME_NAME_REGEX)
.describe(
"Identifier cells read: `{name}` in a SQL cell, a plain global in a Python cell. Letters, numbers, and underscores; must not start with a number, repeat another variable, or reuse a cell's dataframe_name."
),
type: z
.enum(['string', 'number', 'boolean', 'date'])
.describe(
"How the value binds: 'string', 'number', 'boolean', or 'date'. A 'date' is an absolute ISO 8601 date or datetime ('2025-01-31', '2025-01-31T09:00:00Z'); relative expressions like '-7d' are rejected, so compute the date first."
),
value: z
.union([z.string(), z.number(), z.boolean(), z.null()])
.optional()
.describe('The current value. Omit or pass null for a declared-but-unset variable.'),
})
.strict()
export type NotebookVariableInput = z.infer<typeof NotebookVariableSchema>