: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 type { Schemas } from '@/api/generated'
import { withPostHogUrl, type WithPostHogUrl } from '@/tools/tool-utils'
import type { Context, ToolBase } from '@/tools/types'
import { buildMarkdownNotebookContent } from './markdownDoc'
export const NotebooksCreateMarkdownSchema = z
.object({
title: z.string().min(1).max(256).describe('Notebook title. Becomes the leading `# heading` of the document.'),
markdown: z
.string()
.optional()
.describe(
'Optional initial markdown body below the title: the question and the plan, not results computed elsewhere. Do not include executable cells here — add them with notebooks-add-cell.'
),
})
.strict()
type CreateMarkdownResult = WithPostHogUrl<{ notebook_id: string; title: string }>
export const createMarkdownHandler: ToolBase<
typeof NotebooksCreateMarkdownSchema,
CreateMarkdownResult
>['handler'] = async (context: Context, params: z.infer<typeof NotebooksCreateMarkdownSchema>) => {
const projectId = await context.stateManager.getProjectId()
const body = params.markdown?.trim() ? `\n\n${params.markdown.trim()}` : ''
const markdown = `# ${params.title}${body}`
const notebook = await context.api.request<Schemas.Notebook>({
method: 'POST',
path: `/api/projects/${encodeURIComponent(projectId)}/notebooks/`,
body: {
title: params.title,
content: buildMarkdownNotebookContent(markdown),
text_content: markdown,
},
})
return await withPostHogUrl(
context,
{ notebook_id: notebook.short_id, title: params.title },
`/notebooks/${notebook.short_id}`
)
}
const tool = (): ToolBase<typeof NotebooksCreateMarkdownSchema, CreateMarkdownResult> => ({
name: 'notebooks-create-markdown',
schema: NotebooksCreateMarkdownSchema,
handler: createMarkdownHandler,
})
export default tool