@outlit/pi

Pi package for Outlit customer intelligence tools.

Install

pi install npm:@outlit/pi

Set an Outlit API key before starting Pi:

export OUTLIT_API_KEY=ok_...
pi

Tools

The default extension registers the default customer intelligence tools from @outlit/tools:

• outlit_list_customers
• outlit_list_users
• outlit_get_customer
• outlit_get_timeline
• outlit_list_facts
• outlit_get_fact
• outlit_get_source
• outlit_search_customer_context
• outlit_send_notification

SQL tools are available from @outlit/tools, but they are not enabled by default. Notification action tools are included in the default Pi toolset, but they should only be used when the user explicitly asks to send, post, or notify a result. Integration-management commands are intentionally not part of this package.

For analytical agents that need cohorts, usage trends, revenue filters, activation gaps, or aggregate checks, import analyticalAgentToolNames. It combines the default customer intelligence tools with outlit_schema and outlit_query without exposing every customer tool:

import { analyticalAgentToolNames, createOutlitPiExtension } from "@outlit/pi"

export default createOutlitPiExtension({
  toolNames: analyticalAgentToolNames,
})

Skill

This package also ships an outlit Pi skill. Pi loads the skill when you install @outlit/pi as a Pi package:

pi install npm:@outlit/pi

The skill gives the model generic guidance for choosing between customer records, users, timelines, facts, search, sources, and SQL when SQL tools are enabled. It does not add CLI or MCP instructions; it assumes the Outlit tools registered by this package are the available interface.

The facts tool supports factTypes filters for narrowing structured customer-memory evidence. Anomaly detector fact types are not supported as public filters because customers may not have configured core actions, activation paths, or funnels.

Custom Toolsets

Create a small Pi extension when you want a narrower or broader toolset:

import { allCustomerToolNames, createOutlitPiExtension } from "@outlit/pi"

export default createOutlitPiExtension({
  toolNames: allCustomerToolNames,
})

You can also pass apiKey, baseUrl, and fetch directly to createOutlitPiExtension for embedded or test environments.

See examples/pi-agents for complete customer-signal Pi agents built on this package, including usage-decay churn, friction-to-churn, activation-failure, and expansion-readiness examples.