savant-code 0.0.19 → 0.0.21

package/common/src/types/gravity-index.ts

@@ -1,170 +0,0 @@
-import z from 'zod/v4'
-
-import { jsonObjectSchema } from './json'
-
-// Shared field constraints reused by both the per-action schemas
-// (gravityIndexApiInputSchema) and the flat tool-facing schema below, so the
-// bounds and error messages stay in sync. Descriptions are applied per use
-// site because they differ between the two contexts (single-action vs. the
-// `For action "X":` prefixes the flat LLM schema needs).
-const queryField = z
-  .string()
-  .min(1, 'Query cannot be empty')
-  .max(1000, 'Query cannot exceed 1000 characters')
-const slugField = z.string().min(1, 'Slug cannot be empty')
-const integratedSlugField = z.string().min(1, 'integrated_slug cannot be empty')
-
-const searchInputSchema = z.object({
-  action: z.literal('search').describe('Search for the best service.'),
-  query: queryField.describe(
-    `What the user needs, including stack, constraints, and required capabilities when known. Example: "serverless database with branching for a Next.js app".`,
-  ),
-  search_id: z
-    .string()
-    .optional()
-    .describe('Continue a previous Gravity Index search as a follow-up.'),
-  context: jsonObjectSchema
-    .optional()
-    .describe(
-      'Optional structured JSON context about the project, stack, or constraints.',
-    ),
-})
-
-const browseInputSchema = z.object({
-  action: z
-    .literal('browse')
-    .describe('Browse catalog services by category and/or keyword.'),
-  category: z
-    .string()
-    .optional()
-    .describe(
-      'Optional category filter, e.g. Database, Auth, Payments, Hosting, Email, Cache, Monitoring, Analytics, AI, Storage, CMS, Search, Realtime, Background Jobs, Infrastructure, CRM, Support, Productivity, Commerce, Video, Webhooks, SMS.',
-    ),
-  q: z
-    .string()
-    .optional()
-    .describe('Optional keyword filter, e.g. sendgrid or postgres.'),
-})
-
-const listCategoriesInputSchema = z.object({
-  action: z
-    .literal('list_categories')
-    .describe('List every category with service counts.'),
-})
-
-const getServiceInputSchema = z.object({
-  action: z
-    .literal('get_service')
-    .describe('Fetch full detail for a single service by slug.'),
-  slug: slugField.describe('Service slug, e.g. supabase, stripe, sendgrid.'),
-})
-
-const reportIntegrationInputSchema = z.object({
-  action: z
-    .literal('report_integration')
-    .describe('Report that an integration from a prior search was done.'),
-  search_id: z
-    .string()
-    .min(1, 'search_id cannot be empty')
-    .describe('search_id from the earlier search result.'),
-  integrated_slug: integratedSlugField.describe(
-    'Slug of the service that was actually integrated.',
-  ),
-})
-
-const runtimeAttributionFields = {
-  external_session_id: z
-    .string()
-    .optional()
-    .describe(
-      'Stable SavantCode session ID for Gravity API key attribution. SavantCode usually fills this automatically.',
-    ),
-  // Raw, stable per-end-user identifier for Gravity attribution + payout
-  // matching. Surfaces that run under a shared service account (e.g. SavantFree
-  // Web) set this to the real end user so conversions don't all collapse onto
-  // the service account. The server hashes it before sending it to Gravity.
-  // SavantCode usually fills this automatically.
-  external_user_id: z
-    .string()
-    .optional()
-    .describe(
-      'Stable per-end-user identifier for Gravity attribution. SavantCode usually fills this automatically.',
-    ),
-  metadata: jsonObjectSchema
-    .optional()
-    .describe(
-      'Non-sensitive API key metadata for Gravity attribution and debugging. SavantCode usually fills this automatically.',
-    ),
-}
-
-// Tool-facing schema presented to the LLM provider. Native function-calling
-// providers require the top-level `parameters` to be a JSON Schema of
-// `type: "object"`, so this MUST be a flat `z.object` rather than a top-level
-// discriminated union (which serializes to `oneOf`/`anyOf` with no top-level
-// type). Per-action requiredness is enforced server-side by
-// `gravityIndexApiInputSchema` below.
-export const gravityIndexInputSchema = z
-  .object({
-    action: z
-      .enum([
-        'search',
-        'browse',
-        'list_categories',
-        'get_service',
-        'report_integration',
-      ])
-      .describe(
-        'Which Gravity Index operation to perform. search: recommend a provider; browse: list catalog services; list_categories: list categories with counts; get_service: full detail for a known slug; report_integration: report a completed integration.',
-      ),
-    query: queryField
-      .optional()
-      .describe(
-        `For action "search": what the user needs, including stack, constraints, and required capabilities when known. Example: "serverless database with branching for a Next.js app".`,
-      ),
-    search_id: z
-      .string()
-      .optional()
-      .describe(
-        'For action "search": continue a previous Gravity Index search as a follow-up. For action "report_integration": the search_id from the earlier search result (required).',
-      ),
-    context: jsonObjectSchema
-      .optional()
-      .describe(
-        'For action "search": optional structured JSON context about the project, stack, or constraints.',
-      ),
-    category: z
-      .string()
-      .optional()
-      .describe(
-        'For action "browse": optional category filter, e.g. Database, Auth, Payments, Hosting, Email, Cache, Monitoring, Analytics, AI, Storage, CMS, Search, Realtime, Background Jobs, Infrastructure, CRM, Support, Productivity, Commerce, Video, Webhooks, SMS.',
-      ),
-    q: z
-      .string()
-      .optional()
-      .describe(
-        'For action "browse": optional keyword filter, e.g. sendgrid or postgres.',
-      ),
-    slug: slugField
-      .optional()
-      .describe(
-        'For action "get_service": service slug, e.g. supabase, stripe, sendgrid (required).',
-      ),
-    integrated_slug: integratedSlugField
-      .optional()
-      .describe(
-        'For action "report_integration": slug of the service that was actually integrated (required).',
-      ),
-  })
-  .describe(`Use the Gravity Index tool discovery and install API.`)
-
-export const gravityIndexApiInputSchema = z
-  .discriminatedUnion('action', [
-    searchInputSchema.extend(runtimeAttributionFields),
-    browseInputSchema,
-    listCategoriesInputSchema,
-    getServiceInputSchema,
-    reportIntegrationInputSchema.extend(runtimeAttributionFields),
-  ])
-  .describe(`Use the Gravity Index tool discovery and install API.`)
-
-export type GravityIndexInput = z.infer<typeof gravityIndexApiInputSchema>

package/common/src/types/json.ts

@@ -1,26 +0,0 @@
-import z from 'zod/v4'
-
-export type JSONValue =
-  null | string | number | boolean | JSONObject | JSONArray
-export const jsonValueSchema: z.ZodType<JSONValue> = z.lazy(() =>
-  z.union([
-    z.null(),
-    z.string(),
-    z.number(),
-    z.boolean(),
-    jsonObjectSchema,
-    jsonArraySchema,
-  ]),
-)
-
-export const jsonObjectSchema: z.ZodType<JSONObject> = z.lazy(() =>
-  z.record(z.string(), jsonValueSchema),
-)
-export interface JSONObject {
-  [key: string]: JSONValue
-}
-
-export const jsonArraySchema: z.ZodType<JSONArray> = z.lazy(() =>
-  z.array(jsonValueSchema),
-)
-export interface JSONArray extends Array<JSONValue> {}

package/common/src/types/mcp.ts

@@ -1,26 +0,0 @@
-import { z } from 'zod/v4'
-
-export const mcpConfigStdioSchema = z.strictObject({
-  type: z.literal('stdio').default('stdio'),
-  command: z.string(),
-  args: z
-    .string()
-    .array()
-    .default(() => []),
-  env: z.record(z.string(), z.string()).default(() => ({})),
-  timeout: z.number().positive().optional(),
-})
-
-export const mcpConfigRemoteSchema = z.strictObject({
-  type: z.enum(['http', 'sse']).default('http'),
-  url: z.string(),
-  params: z.record(z.string(), z.string()).default(() => ({})),
-  headers: z.record(z.string(), z.string()).default(() => ({})),
-  timeout: z.number().positive().optional(),
-})
-
-export const mcpConfigSchema = z.union([
-  mcpConfigRemoteSchema,
-  mcpConfigStdioSchema,
-])
-export type MCPConfig = z.infer<typeof mcpConfigSchema>

package/common/src/types/messages/content-part.ts

@@ -1,59 +0,0 @@
-import z from 'zod/v4'
-
-import { providerMetadataSchema } from './provider-metadata'
-import { jsonValueSchema } from '../json'
-import { dataContentSchema } from './data-content'
-
-export const textPartSchema = z.object({
-  type: z.literal('text'),
-  text: z.string(),
-  providerOptions: providerMetadataSchema.optional(),
-})
-export type TextPart = z.infer<typeof textPartSchema>
-
-export const imagePartSchema = z.object({
-  type: z.literal('image'),
-  image: z.union([dataContentSchema, z.instanceof(URL)]),
-  mediaType: z.string().optional(),
-  providerOptions: providerMetadataSchema.optional(),
-})
-export type ImagePart = z.infer<typeof imagePartSchema>
-
-export const filePartSchema = z.object({
-  type: z.literal('file'),
-  data: z.union([dataContentSchema, z.instanceof(URL)]),
-  filename: z.string().optional(),
-  mediaType: z.string(),
-  providerOptions: providerMetadataSchema.optional(),
-})
-export type FilePart = z.infer<typeof filePartSchema>
-
-export const reasoningPartSchema = z.object({
-  type: z.literal('reasoning'),
-  text: z.string(),
-  providerOptions: providerMetadataSchema.optional(),
-})
-export type ReasoningPart = z.infer<typeof reasoningPartSchema>
-
-export const toolCallPartSchema = z.object({
-  type: z.literal('tool-call'),
-  toolCallId: z.string(),
-  toolName: z.string(),
-  input: z.record(z.string(), jsonValueSchema),
-  providerOptions: providerMetadataSchema.optional(),
-  providerExecuted: z.boolean().optional(),
-})
-export type ToolCallPart = z.infer<typeof toolCallPartSchema>
-
-export const toolResultOutputSchema = z.discriminatedUnion('type', [
-  z.object({
-    type: z.literal('json'),
-    value: jsonValueSchema,
-  }),
-  z.object({
-    type: z.literal('media'),
-    data: z.string(),
-    mediaType: z.string(),
-  }),
-])
-export type ToolResultOutput = z.infer<typeof toolResultOutputSchema>

package/common/src/types/messages/data-content.ts

@@ -1,14 +0,0 @@
-import z from 'zod/v4'
-
-export const dataContentSchema = z.union([
-  z.string(),
-  z.instanceof(Uint8Array),
-  z.instanceof(ArrayBuffer),
-  z.custom<Buffer>(
-    // Buffer might not be available in some environments such as CloudFlare:
-    (value: unknown): value is Buffer =>
-      globalThis.Buffer?.isBuffer(value) ?? false,
-    { message: 'Must be a Buffer' },
-  ),
-])
-export type DataContent = z.infer<typeof dataContentSchema>

package/common/src/types/messages/provider-metadata.ts

@@ -1,10 +0,0 @@
-import z from 'zod/v4'
-
-import { jsonValueSchema } from '../json'
-
-export const providerMetadataSchema = z.record(
-  z.string(),
-  z.record(z.string(), jsonValueSchema),
-)
-
-export type ProviderMetadata = z.infer<typeof providerMetadataSchema>

package/common/src/types/messages/savant-code-message.ts

@@ -1,55 +0,0 @@
-import type {
-  FilePart,
-  ImagePart,
-  ReasoningPart,
-  TextPart,
-  ToolCallPart,
-  ToolResultOutput,
-} from './content-part'
-import type { ProviderMetadata } from './provider-metadata'
-
-export type AuxiliaryMessageData = {
-  providerOptions?: ProviderMetadata
-  tags?: string[]
-
-  /**
-   * Unix timestamp (ms) when the message was added to history.
-   * Used to detect prompt cache expiry (>5 min gap = cache miss).
-   * This field is stripped before sending to the LLM.
-   */
-  sentAt?: number
-
-  // James: All the below is overly prescriptive for the framework.
-  // Instead, let's tag what the message is, and let the user decide time to live, keep during truncation, etc.
-  /** @deprecated Use tags instead. */
-  timeToLive?: 'agentStep' | 'userPrompt'
-  /** @deprecated Use tags instead. */
-  keepDuringTruncation?: boolean
-  /** @deprecated Use tags instead. */
-  keepLastTags?: string[]
-}
-
-export type SystemMessage = {
-  role: 'system'
-  content: TextPart[]
-} & AuxiliaryMessageData
-
-export type UserMessage = {
-  role: 'user'
-  content: (TextPart | ImagePart | FilePart)[]
-} & AuxiliaryMessageData
-
-export type AssistantMessage = {
-  role: 'assistant'
-  content: (TextPart | ReasoningPart | ToolCallPart)[]
-} & AuxiliaryMessageData
-
-export type ToolMessage = {
-  role: 'tool'
-  toolCallId: string
-  toolName: string
-  content: ToolResultOutput[]
-} & AuxiliaryMessageData
-
-export type Message =
-  SystemMessage | UserMessage | AssistantMessage | ToolMessage

package/common/src/types/organization.ts

@@ -1,118 +0,0 @@
-export type OrganizationRole = 'owner' | 'admin' | 'member'
-
-export interface OrganizationMember {
-  organization_id: string
-  user_id: string
-  role: OrganizationRole
-  joined_at: Date
-}
-
-export interface Organization {
-  id: string
-  name: string
-  slug: string
-  description?: string
-  owner_id: string
-  stripe_customer_id?: string
-  created_at: Date
-  updated_at: Date
-}
-
-export interface OrganizationRepository {
-  id: string
-  organization_id: string
-  repository_url: string
-  repository_name: string
-  approved_by: string
-  approved_at: Date
-  is_active: boolean
-}
-
-export interface OrganizationUsage {
-  id: string
-  organization_id: string
-  user_id: string
-  repository_url: string
-  credits_used: number
-  message_id?: string
-  created_at: Date
-}
-
-export interface CreateOrganizationRequest {
-  name: string
-  slug?: string
-  description?: string
-}
-
-export interface ListOrganizationsResponse {
-  organizations: Array<{
-    id: string
-    name: string
-    slug: string
-    role: OrganizationRole
-    memberCount: number
-    repositoryCount: number
-  }>
-}
-
-export interface OrganizationDetailsResponse {
-  id: string
-  name: string
-  slug: string
-  description?: string
-  userRole: 'owner' | 'admin' | 'member'
-  memberCount: number
-  repositoryCount: number
-  creditBalance: number
-  hasStripeSubscription?: boolean
-  stripeSubscriptionId?: string
-}
-
-export interface InviteMemberRequest {
-  email: string
-  role: 'admin' | 'member'
-}
-
-export interface UpdateMemberRoleRequest {
-  role: 'admin' | 'member'
-}
-
-export interface AddRepositoryRequest {
-  repository_url: string
-  repository_name: string
-}
-
-export interface OrganizationUsageResponse {
-  currentBalance: number
-  usageThisCycle: number
-  cycleStartDate: string
-  cycleEndDate: string
-  topUsers: Array<{
-    user_id: string
-    user_name: string
-    user_email: string
-    credits_used: number
-  }>
-  recentUsage: Array<{
-    date: string
-    credits_used: number
-    repository_url: string
-    user_name: string
-  }>
-}
-
-export interface CreditDelegationResult {
-  useOrganization: boolean
-  organizationId?: string
-  requiresOverride: boolean
-  organizationBalance?: number
-  userBalance?: number
-}
-
-export interface CreditConsumptionWithDelegationResult {
-  success: boolean
-  consumed: number
-  fromOrganization: boolean
-  organizationId?: string
-  error?: string
-}

package/common/src/types/print-mode.ts

@@ -1,167 +0,0 @@
-import z from 'zod/v4'
-
-import { jsonValueSchema } from './json'
-import { toolResultOutputSchema } from './messages/content-part'
-
-export const printModeStartSchema = z.object({
-  type: z.literal('start'),
-  agentId: z.string().optional(),
-  messageHistoryLength: z.number(),
-})
-export type PrintModeStart = z.infer<typeof printModeStartSchema>
-
-export const printModeErrorSchema = z.object({
-  type: z.literal('error'),
-  message: z.string(),
-})
-export type PrintModeError = z.infer<typeof printModeErrorSchema>
-
-export const printModeDownloadStatusSchema = z.object({
-  type: z.literal('download'),
-  version: z.string(),
-  status: z.enum(['complete', 'failed']),
-})
-export type PrintModeDownloadStatus = z.infer<
-  typeof printModeDownloadStatusSchema
->
-
-export const printModeToolCallSchema = z.object({
-  type: z.literal('tool_call'),
-  toolCallId: z.string(),
-  toolName: z.string(),
-  input: z.record(z.string(), jsonValueSchema),
-  agentId: z.string().optional(),
-  parentAgentId: z.string().optional(),
-  includeToolCall: z.boolean().optional(),
-})
-export type PrintModeToolCall = z.infer<typeof printModeToolCallSchema>
-
-export const printModeToolResultSchema = z.object({
-  type: z.literal('tool_result'),
-  toolCallId: z.string(),
-  toolName: z.string(),
-  output: toolResultOutputSchema.array(),
-  parentAgentId: z.string().optional(),
-})
-export type PrintModeToolResult = z.infer<typeof printModeToolResultSchema>
-
-export const printModeTextSchema = z.object({
-  type: z.literal('text'),
-  text: z.string(),
-  agentId: z.string().optional(),
-})
-export type PrintModeText = z.infer<typeof printModeTextSchema>
-
-export const printModeFinishSchema = z.object({
-  type: z.literal('finish'),
-  agentId: z.string().optional(),
-  totalCost: z.number(),
-})
-export type PrintModeFinish = z.infer<typeof printModeFinishSchema>
-
-export const printModeSubagentStartSchema = z.object({
-  type: z.literal('subagent_start'),
-  agentId: z.string(),
-  agentType: z.string(),
-  displayName: z.string(),
-  onlyChild: z.boolean(),
-  parentAgentId: z.string().optional(),
-  params: z.record(z.string(), jsonValueSchema).optional(),
-  prompt: z.string().optional(),
-})
-export type PrintModeSubagentStart = z.infer<
-  typeof printModeSubagentStartSchema
->
-
-export const printModeSubagentFinishSchema = z.object({
-  type: z.literal('subagent_finish'),
-  agentId: z.string(),
-  agentType: z.string(),
-  displayName: z.string(),
-  onlyChild: z.boolean(),
-  parentAgentId: z.string().optional(),
-  params: z.record(z.string(), jsonValueSchema).optional(),
-  prompt: z.string().optional(),
-})
-export type PrintModeSubagentFinish = z.infer<
-  typeof printModeSubagentFinishSchema
->
-
-export const printModeReasoningDeltaSchema = z.object({
-  type: z.literal('reasoning_delta'),
-  text: z.string(),
-  ancestorRunIds: z.string().array(),
-  runId: z.string(),
-  /** The reasoning agent's stable id (matches subagent_start/subagent_chunk
-   *  agentId), so consumers can attribute reasoning to the right agent. */
-  agentId: z.string(),
-})
-export type PrintModeReasoningDelta = z.infer<
-  typeof printModeReasoningDeltaSchema
->
-
-// FID-2026-0718-009 — runtime activity indicator (separate from fsmPhase).
-// The activity variant below is exported as a discriminated union so the SDK
-// handler can narrow `kind` at the type level without a runtime cast.
-// Fields marked required match AgentActivity's discriminated union shape;
-// optional fields stay optional. The runtime contract is that all writes go
-// through `setActivity()` which enforces the strict shape.
-const idleShape = { kind: 'idle' as const, since: 0 }
-const thinkingShape = { kind: 'thinking' as const, startedAt: 0 }
-const toolShape = { kind: 'tool' as const, toolName: '', startedAt: 0 }
-const subagentShape = { kind: 'subagent' as const, agentType: '', startedAt: 0 }
-const researchingShape = {
-  kind: 'researching' as const,
-  query: '',
-  startedAt: 0,
-  source: 'web' as const,
-}
-
-export const printModeActivitySchema = z.object({
-  type: z.literal('activity'),
-  activity: z.union([
-    z.object({ ...idleShape, since: z.number() }),
-    z.object({
-      ...thinkingShape,
-      startedAt: z.number(),
-      model: z.string().optional(),
-    }),
-    z.object({
-      ...toolShape,
-      startedAt: z.number(),
-      target: z.string().optional(),
-    }),
-    z.object({
-      ...subagentShape,
-      startedAt: z.number(),
-      prompt: z.string().optional(),
-    }),
-    z.object({
-      ...researchingShape,
-      startedAt: z.number(),
-      query: z.string(),
-      source: z.enum(['web', 'docs']),
-    }),
-  ]),
-  agentId: z.string().optional(),
-  parentAgentId: z.string().optional(),
-})
-export type PrintModeActivity = z.infer<typeof printModeActivitySchema>
-
-export const printModeEventSchema = z.discriminatedUnion('type', [
-  printModeDownloadStatusSchema,
-  printModeErrorSchema,
-  printModeFinishSchema,
-  printModeStartSchema,
-  printModeSubagentFinishSchema,
-  printModeSubagentStartSchema,
-  printModeTextSchema,
-  printModeToolCallSchema,
-  printModeToolResultSchema,
-
-  printModeReasoningDeltaSchema,
-
-  printModeActivitySchema,
-])
-
-export type PrintModeEvent = z.infer<typeof printModeEventSchema>