@alumbwe/anvil 1.0.20 → 1.0.22

package/vendor/@anvil/common/src/types/gravity-index.ts

@@ -0,0 +1,170 @@
+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 Anvil session ID for Gravity API key attribution. Anvil 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. Anvil
+  // 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.
+  // Anvil usually fills this automatically.
+  external_user_id: z
+    .string()
+    .optional()
+    .describe(
+      'Stable per-end-user identifier for Gravity attribution. Anvil usually fills this automatically.',
+    ),
+  metadata: jsonObjectSchema
+    .optional()
+    .describe(
+      'Non-sensitive API key metadata for Gravity attribution and debugging. Anvil 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/vendor/@anvil/common/src/types/json.ts

@@ -0,0 +1,29 @@
+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.optional()),
+)
+export type JSONObject = { [key in string]: JSONValue | undefined }
+
+export const jsonArraySchema: z.ZodType<JSONArray> = z.lazy(() =>
+  z.array(jsonValueSchema),
+)
+export type JSONArray = JSONValue[]

package/vendor/@anvil/common/src/types/mcp.ts

@@ -0,0 +1,24 @@
+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(() => ({})),
+})
+
+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(() => ({})),
+})
+
+export const mcpConfigSchema = z.union([
+  mcpConfigRemoteSchema,
+  mcpConfigStdioSchema,
+])
+export type MCPConfig = z.infer<typeof mcpConfigSchema>

package/vendor/@anvil/common/src/types/messages/anvil-message.ts

@@ -0,0 +1,58 @@
+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/vendor/@anvil/common/src/types/messages/content-part.ts

@@ -0,0 +1,59 @@
+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(), z.unknown()),
+  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/vendor/@anvil/common/src/types/messages/data-content.ts

@@ -0,0 +1,14 @@
+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/vendor/@anvil/common/src/types/messages/provider-metadata.ts

@@ -0,0 +1,13 @@
+import z from 'zod/v4'
+
+import { jsonValueSchema, type JSONValue } from '../json'
+
+export type ProviderMetadata = Record<
+  string,
+  Record<string, JSONValue | undefined>
+>
+
+export const providerMetadataSchema: z.ZodType<ProviderMetadata> = z.record(
+  z.string(),
+  z.record(z.string(), jsonValueSchema.optional()),
+)

package/vendor/@anvil/common/src/types/organization.ts

@@ -0,0 +1,118 @@
+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/vendor/@anvil/common/src/types/print-mode.ts

@@ -0,0 +1,121 @@
+import z from 'zod/v4'
+
+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(),
+  /** Auto-recovered stream endings ('stream-interrupted': connection cut
+   *  mid-response; 'output-limit': reasoning ended with no usable answer).
+   *  The agent loop is automatically taking another step; UIs show a
+   *  transient retrying indicator rather than a failure. */
+  source: z.enum(['stream-interrupted', 'output-limit']).optional(),
+})
+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(), z.any()),
+  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(), z.any()).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(), z.any()).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
+>
+
+export const printModeEventSchema = z.discriminatedUnion('type', [
+  printModeDownloadStatusSchema,
+  printModeErrorSchema,
+  printModeFinishSchema,
+  printModeStartSchema,
+  printModeSubagentFinishSchema,
+  printModeSubagentStartSchema,
+  printModeTextSchema,
+  printModeToolCallSchema,
+  printModeToolResultSchema,
+
+  printModeReasoningDeltaSchema,
+])
+
+export type PrintModeEvent = z.infer<typeof printModeEventSchema>

package/vendor/@anvil/common/src/types/publisher.ts

@@ -0,0 +1,67 @@
+import { z } from 'zod/v4'
+
+// Publisher ID validation schema - same restrictions as agent ID
+export const PublisherIdSchema = z
+  .string()
+  .regex(
+    /^[a-z0-9-]+$/,
+    'Publisher ID must contain only lowercase letters, numbers, and hyphens',
+  )
+
+// Publisher creation/update schema
+export const PublisherSchema = z.object({
+  id: PublisherIdSchema,
+  name: z.string().min(1, 'Publisher name is required'),
+  email: z.string().email().optional(),
+  bio: z.string().optional(),
+  avatar_url: z.string().url().optional(),
+})
+
+export type PublisherInput = z.infer<typeof PublisherSchema>
+
+export interface Publisher {
+  id: string
+  user_id: string | null
+  org_id: string | null
+  created_by: string
+  name: string
+  email: string | null
+  verified: boolean
+  bio: string | null
+  avatar_url: string | null
+  created_at: Date
+  updated_at: Date
+}
+
+export interface CreatePublisherRequest {
+  id: string
+  name: string
+  email?: string
+  bio?: string
+  avatar_url?: string
+  org_id?: string // Optional: if creating for an organization
+}
+
+export interface UpdatePublisherRequest {
+  name?: string
+  email?: string
+  bio?: string
+  avatar_url?: string
+}
+
+export interface PublisherProfileResponse {
+  id: string
+  user_id: string | null
+  org_id: string | null
+  created_by: string
+  name: string
+  email: string | null
+  verified: boolean
+  bio: string | null
+  avatar_url: string | null
+  created_at: Date
+  updated_at: Date
+  agentCount?: number
+  ownershipType: 'user' | 'organization'
+  organizationName?: string // If owned by org
+}