segmentation-studio

Spoke I/O (visual language v1)

Every toolbox spoke shares the same abstract choreography: typed inputs on the left, distilled verbs in the center, typed outputs on the right, and (when relevant) cross-spoke HTTP composition along the bottom rail. Source package: @people-analytics-toolbox/spoke-illustrations.

Try it now

Copy this curl. Paste in any terminal. POST endpoint — set TOOLBOX_SERVICE_KEY in your shell first.

curl -sS -X POST "https://people-analytics-toolbox.vercel.app/api/spokes/segmentation-studio/cohorts/resolve" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOOLBOX_SERVICE_KEY" \
  -d '{
  "tenantId": "demo",
  "criteria": {
    "any": [
      { "field": "function", "op": "eq", "value": "engineering" }
    ]
  }
}'

Vendor the contract

The Zod contract is the source of truth. Vendor a copy into your consumer app — you keep it; we don't break it underneath you. Re-vendor when the version bumps.

// In your consumer app:
import { z } from "zod";

// Vendor a copy of these contracts from the toolbox repo at:
//   src/spokes/segmentation-studio/contracts/types.ts

import {
  CanonicalFieldsListResponseSchema,
  HrisIngestRequestSchema,
  HrisIngestResponseSchema,
  ResolveCohortRequestSchema,
  ResolveCohortResponseSchema,
  PublishPackResponseSchema,
  CONTRACT_VERSION,
} from "./vendored/segmentation-studio/types";

// Then call the toolbox over HTTP or MCP.
// See docs/EXTERNAL-CONSUMERS.md for onboarding.

Source path: src/spokes/segmentation-studio/contracts/types.ts · GitHub