@codori/client 0.0.6 → 0.0.8

package/shared/pending-user-request.ts

@@ -0,0 +1,374 @@
+import type { CodexRpcServerRequest } from './codex-rpc'
+
+const isObjectRecord = (value: unknown): value is Record<string, unknown> =>
+  typeof value === 'object' && value !== null && !Array.isArray(value)
+
+const asTrimmedString = (value: unknown) => {
+  if (typeof value !== 'string') {
+    return null
+  }
+
+  const trimmed = value.trim()
+  return trimmed.length > 0 ? trimmed : null
+}
+
+const asBoolean = (value: unknown) => value === true
+
+const asStringArray = (value: unknown) =>
+  Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === 'string') : []
+
+export type PendingRequestUserInputOption = {
+  label: string
+  description: string | null
+}
+
+export type PendingRequestUserInputQuestion = {
+  header: string | null
+  id: string
+  question: string
+  options: PendingRequestUserInputOption[]
+  isOther: boolean
+  isSecret: boolean
+}
+
+export type PendingRequestUserInput = {
+  kind: 'requestUserInput'
+  requestId: number
+  threadId: string | null
+  turnId: string | null
+  itemId: string | null
+  questions: PendingRequestUserInputQuestion[]
+}
+
+type BaseElicitationField = {
+  key: string
+  label: string
+  description: string | null
+  required: boolean
+}
+
+export type PendingElicitationStringField = BaseElicitationField & {
+  kind: 'string'
+  minLength: number | null
+  maxLength: number | null
+  format: 'email' | 'uri' | 'date' | 'date-time' | null
+  defaultValue: string | null
+}
+
+export type PendingElicitationNumberField = BaseElicitationField & {
+  kind: 'number'
+  numericType: 'number' | 'integer'
+  minimum: number | null
+  maximum: number | null
+  defaultValue: number | null
+}
+
+export type PendingElicitationBooleanField = BaseElicitationField & {
+  kind: 'boolean'
+  defaultValue: boolean
+}
+
+export type PendingElicitationEnumField = BaseElicitationField & {
+  kind: 'enum'
+  valueType: 'string' | 'number' | 'integer' | 'boolean'
+  options: Array<{
+    label: string
+    value: string | number | boolean
+  }>
+  defaultValue: string | number | boolean | null
+}
+
+export type PendingElicitationField =
+  | PendingElicitationStringField
+  | PendingElicitationNumberField
+  | PendingElicitationBooleanField
+  | PendingElicitationEnumField
+
+export type PendingMcpElicitationForm = {
+  kind: 'mcpElicitationForm'
+  requestId: number
+  threadId: string | null
+  message: string | null
+  fields: PendingElicitationField[]
+}
+
+export type PendingMcpElicitationUrl = {
+  kind: 'mcpElicitationUrl'
+  requestId: number
+  threadId: string | null
+  message: string | null
+  url: string
+  elicitationId: string | null
+}
+
+export type PendingUserRequest =
+  | PendingRequestUserInput
+  | PendingMcpElicitationForm
+  | PendingMcpElicitationUrl
+
+const parseRequestUserInputOption = (value: unknown): PendingRequestUserInputOption | null => {
+  if (!isObjectRecord(value)) {
+    return null
+  }
+
+  const label = asTrimmedString(value.label)
+  if (!label) {
+    return null
+  }
+
+  return {
+    label,
+    description: asTrimmedString(value.description)
+  }
+}
+
+const parseRequestUserInputQuestion = (value: unknown): PendingRequestUserInputQuestion | null => {
+  if (!isObjectRecord(value)) {
+    return null
+  }
+
+  const id = asTrimmedString(value.id)
+  const question = asTrimmedString(value.question)
+  if (!id || !question) {
+    return null
+  }
+
+  const options = Array.isArray(value.options)
+    ? value.options
+      .map(parseRequestUserInputOption)
+      .filter((option): option is PendingRequestUserInputOption => option !== null)
+    : []
+
+  return {
+    header: asTrimmedString(value.header),
+    id,
+    question,
+    options,
+    isOther: asBoolean(value.isOther),
+    isSecret: asBoolean(value.isSecret)
+  }
+}
+
+const parseNumber = (value: unknown) =>
+  typeof value === 'number' && Number.isFinite(value) ? value : null
+
+const parseEnumValueType = (values: Array<string | number | boolean>) => {
+  if (values.every(value => typeof value === 'string')) {
+    return 'string'
+  }
+
+  if (values.every(value => typeof value === 'boolean')) {
+    return 'boolean'
+  }
+
+  if (values.every(value => typeof value === 'number' && Number.isInteger(value))) {
+    return 'integer'
+  }
+
+  if (values.every(value => typeof value === 'number')) {
+    return 'number'
+  }
+
+  return null
+}
+
+const parseElicitationField = (
+  key: string,
+  value: unknown,
+  requiredKeys: Set<string>
+): PendingElicitationField | null => {
+  if (!isObjectRecord(value)) {
+    return null
+  }
+
+  const label = asTrimmedString(value.title) ?? key
+  const description = asTrimmedString(value.description)
+  const required = requiredKeys.has(key)
+  const enumValues = Array.isArray(value.enum)
+    ? value.enum.filter((entry): entry is string | number | boolean =>
+      typeof entry === 'string' || typeof entry === 'number' || typeof entry === 'boolean')
+    : []
+
+  if (enumValues.length > 0) {
+    const valueType = parseEnumValueType(enumValues)
+    if (!valueType) {
+      return null
+    }
+
+    const defaultValue = enumValues.includes(value.default as never)
+      ? value.default as string | number | boolean
+      : null
+
+    return {
+      kind: 'enum',
+      key,
+      label,
+      description,
+      required,
+      valueType,
+      defaultValue,
+      options: enumValues.map(option => ({
+        label: String(option),
+        value: option
+      }))
+    }
+  }
+
+  if (value.type === 'string') {
+    const format = value.format === 'email'
+      || value.format === 'uri'
+      || value.format === 'date'
+      || value.format === 'date-time'
+      ? value.format
+      : null
+
+    return {
+      kind: 'string',
+      key,
+      label,
+      description,
+      required,
+      minLength: parseNumber(value.minLength),
+      maxLength: parseNumber(value.maxLength),
+      format,
+      defaultValue: typeof value.default === 'string' ? value.default : null
+    }
+  }
+
+  if (value.type === 'number' || value.type === 'integer') {
+    return {
+      kind: 'number',
+      key,
+      label,
+      description,
+      required,
+      numericType: value.type,
+      minimum: parseNumber(value.minimum),
+      maximum: parseNumber(value.maximum),
+      defaultValue: typeof value.default === 'number' ? value.default : null
+    }
+  }
+
+  if (value.type === 'boolean') {
+    return {
+      kind: 'boolean',
+      key,
+      label,
+      description,
+      required,
+      defaultValue: value.default === true
+    }
+  }
+
+  return null
+}
+
+export const parsePendingUserRequest = (request: CodexRpcServerRequest): PendingUserRequest | null => {
+  const params = isObjectRecord(request.params) ? request.params : null
+
+  switch (request.method) {
+    case 'item/tool/requestUserInput': {
+      const questions = Array.isArray(params?.questions)
+        ? params.questions
+          .map(parseRequestUserInputQuestion)
+          .filter((question): question is PendingRequestUserInputQuestion => question !== null)
+        : []
+      if (questions.length === 0) {
+        return null
+      }
+
+      return {
+        kind: 'requestUserInput',
+        requestId: request.id,
+        threadId: asTrimmedString(params?.threadId),
+        turnId: asTrimmedString(params?.turnId),
+        itemId: asTrimmedString(params?.itemId),
+        questions
+      }
+    }
+    case 'mcpServer/elicitation/request': {
+      const mode = asTrimmedString(params?.mode)
+      if (mode === 'url') {
+        const url = asTrimmedString(params?.url)
+        if (!url) {
+          return null
+        }
+
+        return {
+          kind: 'mcpElicitationUrl',
+          requestId: request.id,
+          threadId: asTrimmedString(params?.threadId),
+          message: asTrimmedString(params?.message),
+          url,
+          elicitationId: asTrimmedString(params?.elicitationId)
+        }
+      }
+
+      if (mode !== 'form') {
+        return null
+      }
+
+      const requestedSchema = isObjectRecord(params?.requestedSchema) ? params.requestedSchema : null
+      if (!requestedSchema || requestedSchema.type !== 'object') {
+        return null
+      }
+
+      const properties = isObjectRecord(requestedSchema.properties) ? requestedSchema.properties : null
+      if (!properties) {
+        return null
+      }
+
+      const requiredKeys = new Set(asStringArray(requestedSchema.required))
+      const fields = Object.entries(properties)
+        .map(([key, value]) => parseElicitationField(key, value, requiredKeys))
+        .filter((field): field is PendingElicitationField => field !== null)
+      if (fields.length === 0) {
+        return null
+      }
+
+      return {
+        kind: 'mcpElicitationForm',
+        requestId: request.id,
+        threadId: asTrimmedString(params?.threadId),
+        message: asTrimmedString(params?.message),
+        fields
+      }
+    }
+    default:
+      return null
+  }
+}
+
+const sanitizeAnswerList = (answers: string[]) =>
+  answers
+    .map(answer => answer.trim())
+    .filter(answer => answer.length > 0)
+
+export const buildRequestUserInputResponse = (
+  answers: Record<string, string[]>
+) => ({
+  answers: Object.fromEntries(
+    Object.entries(answers).map(([questionId, questionAnswers]) => [questionId, sanitizeAnswerList(questionAnswers)])
+  )
+})
+
+export const buildMcpElicitationResponse = (
+  action: 'accept' | 'decline' | 'cancel',
+  content?: Record<string, string | number | boolean>
+) => {
+  if (action !== 'accept') {
+    return { action }
+  }
+
+  return content ? { action, content } : { action }
+}
+
+export const buildPendingUserRequestDismissResponse = (request: PendingUserRequest) => {
+  switch (request.kind) {
+    case 'requestUserInput':
+      return buildRequestUserInputResponse({})
+    case 'mcpElicitationForm':
+    case 'mcpElicitationUrl':
+      return buildMcpElicitationResponse('cancel')
+  }
+}

package/shared/slash-commands.ts

@@ -0,0 +1,85 @@
+export type SlashCommandName = 'review'
+
+export type SlashCommandDefinition = {
+  name: SlashCommandName
+  description: string
+  supportsInlineArgs: boolean
+  completeOnSpace: boolean
+  executeOnEnter: boolean
+}
+
+export type ActiveSlashCommandMatch = {
+  start: number
+  end: number
+  raw: string
+  query: string
+}
+
+export type SubmittedSlashCommand = {
+  name: string
+  args: string
+  isBare: boolean
+}
+
+export const SLASH_COMMANDS: SlashCommandDefinition[] = [{
+  name: 'review',
+  description: 'Review current changes or compare against a base branch.',
+  supportsInlineArgs: false,
+  completeOnSpace: true,
+  executeOnEnter: true
+}]
+
+export const findActiveSlashCommand = (
+  input: string,
+  selectionStart: number | null | undefined,
+  selectionEnd: number | null | undefined
+): ActiveSlashCommandMatch | null => {
+  if (selectionStart == null || selectionEnd == null || selectionStart !== selectionEnd) {
+    return null
+  }
+
+  const caret = selectionStart
+  const lineStart = input.lastIndexOf('\n', Math.max(0, caret - 1)) + 1
+  const linePrefix = input.slice(lineStart, caret)
+  const match = /(?:^|\s)(\/[a-z-]*)$/i.exec(linePrefix)
+  if (!match) {
+    return null
+  }
+
+  const raw = match[1] ?? ''
+  if (!raw.startsWith('/')) {
+    return null
+  }
+
+  return {
+    start: caret - raw.length,
+    end: caret,
+    raw,
+    query: raw.slice(1).toLowerCase()
+  }
+}
+
+export const filterSlashCommands = (
+  commands: SlashCommandDefinition[],
+  query: string
+) => {
+  const normalizedQuery = query.trim().toLowerCase()
+  return commands.filter(command => command.name.startsWith(normalizedQuery))
+}
+
+export const parseSubmittedSlashCommand = (input: string): SubmittedSlashCommand | null => {
+  const trimmed = input.trim()
+  const match = /^\/([a-z-]+)(?:\s+(.*))?$/i.exec(trimmed)
+  if (!match) {
+    return null
+  }
+
+  return {
+    name: match[1]?.toLowerCase() ?? '',
+    args: match[2]?.trim() ?? '',
+    isBare: !(match[2]?.trim())
+  }
+}
+
+export const toSlashCommandCompletion = (command: Pick<SlashCommandDefinition, 'name'>) =>
+  `/${command.name} `