Building structured AI decision models
The documentation explains how to use TypeSafe AI's System One models with typed questions and state to generate structured, code-consumable decisions.
TypeSafe AI
https://docs.typesafe.aiTypeSafe AI documentation guides AI agents in building applications with System One models, developing with JavaScript and Python SDKs, and implementing advanced AI patterns. It covers structured AI decisions, automation cookbooks, and API error handling, enabling integration, troubleshooting, and research to build reliable AI applications that make structured decisions.
Works with
Use TypeSafe AI Documentation to complete source-specific tasks, make informed decisions, and follow evidence-backed workflows.
The documentation explains how to use TypeSafe AI's System One models with typed questions and state to generate structured, code-consumable decisions.
The JavaScript SDK documentation provides quickstart instructions and API references for installing the SDK, setting up the client, and making API calls.
The API reference details various error classes like APIConnectionError, providing insights into potential causes for request or response delivery failures.
The API reference for ChoiceQuestion and the choice() function explains how to define questions that select between named alternatives with specified criteria.
The "Structure recovery" cookbook details a two-pass pipeline using Noul questions to reconstruct Markdown from unformatted text without altering the original words.
The "Composite scoring" pattern guide explains how to break down complex judgments into atomic scores and combine them with weighted logic in code.
A quick look at the main areas Bulkgrid has indexed and keeps ready for AI search, MCP, extraction, and change detection.
/sdk
65 pages
Provides comprehensive documentation for both JavaScript and Python SDKs, offering quickstart guides, API references, and details on error handling to facilitate application development.
/sdk/javascript
52 pages
Documents the TypeSafe JavaScript and TypeScript SDK, providing detailed API references, error class definitions, and a changelog for tracking development updates.
/sdk/javascript/api
50 pages
Details the JavaScript SDK's API, covering core components like error handling, client usage, and structured question types such as ChoiceQuestion and Noul.
/cookbooks
18 pages
Offers practical guides and examples for applying TypeSafe AI to various automation tasks, including structure recovery, classification, and autoresearch feature discovery.
/sdk/javascript/api/interfaces
18 pages
Defines the interfaces for various TypeSafe AI components within the JavaScript SDK, including structured questions like ChoiceQuestion and NoulQuestion, along with their corresponding responses.
/sdk/javascript/api/classes
14 pages
Describes the classes available in the JavaScript SDK API, particularly focusing on various error types like APIConnectionError and the core TypeSafeClient for interacting with the AI.
/sdk/javascript/api/type-aliases
12 pages
Lists and explains the type aliases used within the JavaScript SDK API, facilitating understanding of data structures for questions, criteria, and other core components.
/sdk/python/api
8 pages
Details the Python SDK's API, covering client types, data structures for questions and responses, error handling, retry policies, and configuration constants for integration.
/concepts
4 pages
Explains the foundational concepts of TypeSafe AI, including the System One model, guidance on building with it, and various example use cases across different industries.
/patterns
4 pages
Explores advanced AI design patterns for TypeSafe AI, such as combining multiple scores, routing based on confidence, and speculative fan-out strategies for complex judgments.
/primitives
4 pages
Introduces the fundamental building blocks of TypeSafe AI, including structured question types like Choice, Noul, and Score, and how they handle JSON structures for advanced use.
Bulkgrid turns important websites into fresh, queryable, AI-ready sources without making teams maintain the infrastructure.
Retrieve the right source context instead of sending large pages, pasted docs, or noisy search results into every prompt.
Ground responses in current, source-backed evidence to reduce hallucinations and avoid relying on stale model memory.
Keep important websites automatically recrawled and updated so AI is not working from old content.
Search already-indexed source content immediately instead of crawling pages at question time.
Bulkgrid handles crawling, rendering, retries, storage, indexing, recrawls, and change detection.
See when pages are added, removed, updated, or fail so teams can react without checking manually.
Search and use knowledge from TypeSafe AI in ChatGPT, Claude, Cursor, and any MCP-compatible client.